You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by ra...@apache.org on 2014/01/23 07:35:56 UTC
[1/2] git commit: CLOUDSTACK-5103 DB HA doc
Updated Branches:
refs/heads/master 066b07e25 -> ef9c1de5f
CLOUDSTACK-5103 DB HA doc
Project: http://git-wip-us.apache.org/repos/asf/cloudstack-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cloudstack-docs/commit/fed6ae1b
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack-docs/tree/fed6ae1b
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack-docs/diff/fed6ae1b
Branch: refs/heads/master
Commit: fed6ae1bce0f853809ee84800ca50abe359b6d06
Parents: 066b07e
Author: radhikap <ra...@citrix.com>
Authored: Thu Jan 23 12:04:46 2014 +0530
Committer: radhikap <ra...@citrix.com>
Committed: Thu Jan 23 12:04:46 2014 +0530
----------------------------------------------------------------------
en-US/db-ha.xml | 90 +++++++++++++++++++++++++++++++++++
en-US/sys-reliability-and-ha.xml | 20 ++++----
2 files changed, 101 insertions(+), 9 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/fed6ae1b/en-US/db-ha.xml
----------------------------------------------------------------------
diff --git a/en-US/db-ha.xml b/en-US/db-ha.xml
new file mode 100644
index 0000000..ace1c10
--- /dev/null
+++ b/en-US/db-ha.xml
@@ -0,0 +1,90 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<section id="db-ha">
+ <title>Database High Availability</title>
+ <para>To help ensure high availability of the databases that store the internal data for &PRODUCT;,
+ you can set up database replication.
+ This covers both the main &PRODUCT; database and the Usage database.
+ Replication is achieved using the MySQL connector parameters and two-way replication. Tested with MySQL 5.1 and 5.5.
+ </para>
+ <section id="db-ha-howto">
+ <title>How to Set Up Database Replication</title>
+ <para>Database replication in &PRODUCT; is provided using the MySQL replication capabilities.
+ The steps to set up replication can be found in the MySQL documentation (links are provided below).
+ It is suggested that you set up two-way replication, which involves two database nodes.
+ In this case, for example, you might have node1 and node2.</para>
+ <para>You can also set up chain replication, which involves more than two nodes.
+ In this case, you would first set up two-way replication with node1 and node2.
+ Next, set up one-way replication from node2 to node3.
+ Then set up one-way replication from node3 to node4, and so on for all the additional nodes.</para>
+ <para>References:</para>
+ <itemizedlist>
+ <listitem><para><ulink url="http://dev.mysql.com/doc/refman/5.0/en/replication-howto.html">http://dev.mysql.com/doc/refman/5.0/en/replication-howto.html</ulink></para></listitem>
+ <listitem><para><ulink url="https://wikis.oracle.com/display/CommSuite/MySQL+High+Availability+and+Replication+Information+For+Calendar+Server">https://wikis.oracle.com/display/CommSuite/MySQL+High+Availability+and+Replication+Information+For+Calendar+Server</ulink></para></listitem>
+ </itemizedlist>
+ </section>
+ <section id="db-ha-configure">
+ <title>Configuring Database High Availability</title>
+ <para>To control the database high availability behavior, use the following configuration
+ settings in the file /etc/cloudstack/management/db.properties.</para>
+ <para><emphasis role="bold">Required Settings</emphasis></para>
+ <para>Be sure you have set the following in db.properties:</para>
+ <itemizedlist>
+ <listitem><para>db.ha.enabled: set to true if you want to use the replication feature.</para>
+ <para>Example: db.ha.enabled=true</para></listitem>
+ <listitem><para>db.cloud.slaves: set to a comma-delimited set of slave hosts for the cloud database. This is the list of nodes set up with replication.
+ The master node is not in the list, since it is already mentioned elsewhere in the properties file.</para>
+ <para>Example: db.cloud.slaves=node2,node3,node4</para></listitem>
+ <listitem><para>db.usage.slaves: set to a comma-delimited set of slave hosts for the usage database. This is the list of nodes set up with replication.
+ The master node is not in the list, since it is already mentioned elsewhere in the properties file.</para>
+ <para>Example: db.usage.slaves=node2,node3,node4</para></listitem>
+ </itemizedlist>
+ <para><emphasis role="bold">Optional Settings</emphasis></para>
+ <para>The following settings must be present in db.properties, but you are not required to change the default values unless you wish to do so for tuning purposes:</para>
+ <itemizedlist>
+ <listitem><para>db.cloud.secondsBeforeRetryMaster: The number of seconds the MySQL connector should wait before trying again to connect to the master
+ after the master went down. Default is 1 hour.
+ The retry might happen sooner if db.cloud.queriesBeforeRetryMaster is reached first.</para>
+ <para>Example: db.cloud.secondsBeforeRetryMaster=3600</para></listitem>
+ <listitem><para>db.cloud.queriesBeforeRetryMaster: The minimum number of queries to be sent to the database before trying again to connect to the master
+ after the master went down. Default is 5000.
+ The retry might happen sooner if db.cloud.secondsBeforeRetryMaster is reached first.</para>
+ <para>Example: db.cloud.queriesBeforeRetryMaster=5000</para></listitem>
+ <listitem><para>db.cloud.initialTimeout: Initial time the MySQL connector should wait before trying again to connect to the master.
+ Default is 3600.</para>
+ <para>Example: db.cloud.initialTimeout=3600</para></listitem>
+ </itemizedlist>
+ </section>
+ <section id="db-ha-limitations">
+ <title>Limitations on Database High Availability</title>
+ <para>The following limitations exist in the current implementation of this feature.</para>
+ <itemizedlist>
+ <listitem><para>Slave hosts can not be monitored through &PRODUCT;. You will need to have a separate means of monitoring.</para></listitem>
+ <listitem><para>Events from the database side are not integrated with the &PRODUCT; Management Server events system.</para></listitem>
+ <listitem><para>You must periodically perform manual clean-up of bin log files generated by replication on database nodes.
+ If you do not clean up the log files, the disk can become full.</para></listitem>
+ </itemizedlist>
+ </section>
+</section>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/fed6ae1b/en-US/sys-reliability-and-ha.xml
----------------------------------------------------------------------
diff --git a/en-US/sys-reliability-and-ha.xml b/en-US/sys-reliability-and-ha.xml
index e3c1cd9..ecba7d9 100644
--- a/en-US/sys-reliability-and-ha.xml
+++ b/en-US/sys-reliability-and-ha.xml
@@ -21,14 +21,16 @@
specific language governing permissions and limitations
under the License.
-->
-
<chapter id="sys-reliability-and-ha">
- <title>System Reliability and High Availability</title>
- <xi:include href="ha-management-server.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="management-server-lb.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
- <xi:include href="ha-enabled-vm.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="ha-for-hosts.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="primary-storage-outage-and-data-loss.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="secondary-storage-outage-and-data-loss.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="api-throttling.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <title>System Reliability and High Availability</title>
+ <xi:include href="ha-management-server.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ <xi:include href="management-server-lb.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ <xi:include href="ha-enabled-vm.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ <xi:include href="ha-for-hosts.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ <xi:include href="primary-storage-outage-and-data-loss.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ <xi:include href="secondary-storage-outage-and-data-loss.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ <xi:include href="db-ha.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ <xi:include href="api-throttling.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
</chapter>
[2/2] git commit: overview of 4.3 features in progress
Posted by ra...@apache.org.
overview of 4.3 features in progress
Project: http://git-wip-us.apache.org/repos/asf/cloudstack-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cloudstack-docs/commit/ef9c1de5
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack-docs/tree/ef9c1de5
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack-docs/diff/ef9c1de5
Branch: refs/heads/master
Commit: ef9c1de5f8bc1d3d44e7cee610e0e8b9c5a01628
Parents: fed6ae1
Author: radhikap <ra...@citrix.com>
Authored: Thu Jan 23 12:05:35 2014 +0530
Committer: radhikap <ra...@citrix.com>
Committed: Thu Jan 23 12:05:35 2014 +0530
----------------------------------------------------------------------
release-notes/en-US/Release_Notes.xml | 54 ++++++++++++++++++++++++++++--
1 file changed, 52 insertions(+), 2 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/ef9c1de5/release-notes/en-US/Release_Notes.xml
----------------------------------------------------------------------
diff --git a/release-notes/en-US/Release_Notes.xml b/release-notes/en-US/Release_Notes.xml
index 91eefed..a51657f 100644
--- a/release-notes/en-US/Release_Notes.xml
+++ b/release-notes/en-US/Release_Notes.xml
@@ -23,8 +23,8 @@ under the License.
<xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
<chapter id="welcome-4.3">
<title>Welcome to &PRODUCT; 4.3</title>
- <para>Welcome to the 4.3 release of &PRODUCT;. This version is the first defect fix release of
- &PRODUCT; in the 4.2.<emphasis role="italic">x</emphasis> line.</para>
+ <para>Welcome to the 4.3 release of &PRODUCT;. This version is the first feature release of
+ &PRODUCT; in the 4.3.<emphasis role="italic">x</emphasis> line.</para>
<para>This document contains information specific to this release of &PRODUCT;, including
upgrade instructions from prior releases, new features added to &PRODUCT;, API changes, and
issues fixed in the release. For installation instructions, please see the <ulink
@@ -437,6 +437,15 @@ under the License.
each hypervisor type. This feature is not supported in versions prior to XenServer
6.2.</para>
</section>
+ <section id="ha-db">
+ <title>Database High Availability</title>
+ <para>To help ensure high availability of the databases that store the internal data for
+ &PRODUCT;, you can set up database replication. This covers both the main &PRODUCT;
+ database and the Usage database. Replication is achieved using the MySQL connector
+ parameters and two-way replication. Tested with MySQL 5.1 and 5.5. Database replication in
+ &PRODUCT; is provided using the MySQL replication capabilities. The steps to set up
+ replication can be found in the MySQL documentation.</para>
+ </section>
<section id="new-ui">
<title>Enhanced &PRODUCT; UI</title>
<para>A complete UI makeover is implemented to enhance the usability and user experience in
@@ -445,6 +454,24 @@ under the License.
introduced to match with the Apache branding. </para>
<para>The current UI flow remains the same.</para>
</section>
+ <section id="alert-publish">
+ <title>Publishing Alert Using the Web ROOT Admin API</title>
+ <para>In previous releases of &PRODUCT; code alerts are generated for &PRODUCT; services
+ (Usage service)only if they run on the same host as the Management Server. A new API has
+ been introduced in 4.3 so that alerts are generated and published though the following
+ services run on a separate host:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Any new services added to &PRODUCT;.</para>
+ </listitem>
+ <listitem>
+ <para>Usage service when run on a separate storage host.</para>
+ </listitem>
+ <listitem>
+ <para>Console Proxy and Secondary Storage VM services.</para>
+ </listitem>
+ </itemizedlist>
+ </section>
</section>
<section id="issues-fixed-4.3">
<title>Issues Fixed in 4.3</title>
@@ -3453,6 +3480,29 @@ service cloudstack-agent start
</tgroup>
</informaltable>
</section>
+ <section id="alert-api">
+ <title>Reporting CPU Sockets</title>
+ <informaltable>
+ <tgroup cols="2" align="left" colsep="1" rowsep="1">
+ <colspec colwidth="1.0*" colname="1" colnum="1"/>
+ <colspec colwidth="9.87*" colname="2" colnum="2"/>
+ <thead>
+ <row>
+ <entry><para>API</para></entry>
+ <entry><para>Description</para></entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><para>generateAlert</para></entry>
+ <entry><para>A new API has been added to generate and publish alerts for usage
+ services. The usage services can be installed on a different host or the same host
+ where the Management Server is running.</para></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </section>
<section id="dynamic-compute">
<title>Dynamic Compute Offering</title>
<informaltable>