You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by se...@apache.org on 2013/02/25 20:13:48 UTC
git commit: refs/heads/4.1 - cloudstack-462
Updated Branches:
refs/heads/4.1 b97c3957c -> 1477acb56
cloudstack-462
Signed-off-by: radhikap <ra...@citrix.com>
Signed-off-by: Sebastien Goasguen <ru...@gmail.com>
Project: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/commit/1477acb5
Tree: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/tree/1477acb5
Diff: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/diff/1477acb5
Branch: refs/heads/4.1
Commit: 1477acb56d136f951728ed7128f67d2ee7c6e583
Parents: b97c395
Author: radhikap <ra...@citrix.com>
Authored: Mon Feb 25 16:49:39 2013 +0530
Committer: Sebastien Goasguen <ru...@gmail.com>
Committed: Mon Feb 25 14:13:40 2013 -0500
----------------------------------------------------------------------
docs/en-US/management-server-install-client.xml | 11 ++--
docs/en-US/management-server-install-db-local.xml | 60 ++++++++++++---
2 files changed, 53 insertions(+), 18 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/1477acb5/docs/en-US/management-server-install-client.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/management-server-install-client.xml b/docs/en-US/management-server-install-client.xml
index 7e81ec7..899e97c 100644
--- a/docs/en-US/management-server-install-client.xml
+++ b/docs/en-US/management-server-install-client.xml
@@ -1,5 +1,5 @@
<?xml version='1.0' encoding='utf-8' ?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!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;
]>
@@ -11,9 +11,7 @@
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
@@ -33,13 +31,14 @@
packages will depend on everything you need to run the Management server.</para>
<section id="vhd-util">
<title>Downloading vhd-util</title>
- <para>This procedure is required only for installations where XenServer is installed on the hypervisor hosts.</para>
+ <para>This procedure is required only for installations where XenServer is installed on the
+ hypervisor hosts.</para>
<para>Before setting up the Management Server, download vhd-util from <ulink
url="http://download.cloud.com.s3.amazonaws.com/tools/vhd-util">vhd-util</ulink>.</para>
<para>If the Management Server is RHEL or CentOS, copy vhd-util to
/usr/lib64/cloud/common/scripts/vm/hypervisor/xenserver.</para>
<para>If the Management Server is Ubuntu, copy vhd-util to
- /usr/lib/cloud/common/scripts/vm/hypervisor/xenserver/vhd-util.</para>
+ /usr/lib/cloud/common/scripts/vm/hypervisor/xenserver.</para>
</section>
<section id="management-server-install-rhel">
<title>Install on CentOS/RHEL</title>
@@ -50,4 +49,4 @@
<title>Install on Ubuntu</title>
<programlisting language="Bash">apt-get install cloud-client</programlisting>
</section>
-</section>
\ No newline at end of file
+</section>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/1477acb5/docs/en-US/management-server-install-db-local.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/management-server-install-db-local.xml b/docs/en-US/management-server-install-db-local.xml
index 2422490..00ea93b 100644
--- a/docs/en-US/management-server-install-db-local.xml
+++ b/docs/en-US/management-server-install-db-local.xml
@@ -11,9 +11,7 @@
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
@@ -29,19 +27,23 @@
MySQL. See <xref linkend="management-server-install-db-external"/>.</para>
<orderedlist>
<listitem>
- <para>Install MySQL from the package repository from your distribution:</para>
+ <para>Install MySQL from the package repository of your distribution:</para>
<para condition="community">On RHEL or CentOS:</para>
<programlisting language="Bash">yum install mysql-server</programlisting>
<para condition="community">On Ubuntu:</para>
<programlisting language="Bash">apt-get install mysql-server</programlisting>
</listitem>
<listitem>
- <para>Edit the MySQL configuration (/etc/my.cnf or /etc/mysql/my.cnf, depending on your OS)
- and insert the following lines in the [mysqld] section. You can put these lines below the
- datadir line. The max_connections parameter should be set to 350 multiplied by the number of
- Management Servers you are deploying. This example assumes one Management Server.</para>
+ <para>Open the MySQL configuration file. The configuration file is <filename>/etc/my.cnf</filename> or
+ <filename>/etc/mysql/my.cnf</filename>, depending on your OS.</para>
+ </listitem>
+ <listitem>
+ <para>Insert the following lines in the [mysqld] section. </para>
+ <para>You can put these lines below the datadir line. The max_connections parameter should be
+ set to 350 multiplied by the number of Management Servers you are deploying. This example
+ assumes one Management Server.</para>
<note>
- <para>On Ubuntu, you can also create a file /etc/mysql/conf.d/cloudstack.cnf and add these
+ <para>On Ubuntu, you can also create a file <filename>/etc/mysql/conf.d/cloudstack.cnf</filename> and add these
directives there. Don't forget to add [mysqld] on the first line of the file.</para>
</note>
<programlisting language="Bash">innodb_rollback_on_timeout=1
@@ -69,6 +71,40 @@ binlog-format = 'ROW'</programlisting>
<programlisting language="Bash">mysql_secure_installation</programlisting>
</listitem>
<listitem>
+ <para>&PRODUCT; can be blocked by security mechanisms, such as SELinux. Disable SELinux to
+ ensure + that the Agent has all the required permissions.</para>
+ <para>Configure SELinux (RHEL and CentOS):</para>
+ <orderedlist numeration="loweralpha">
+ <listitem>
+ <para>Check whether SELinux is installed on your machine. If not, you can skip this
+ section.</para>
+ <para>In RHEL or CentOS, SELinux is installed and enabled by default. You can verify this
+ with:</para>
+ <programlisting language="Bash"><command>$ rpm -qa | grep selinux</command></programlisting>
+ </listitem>
+ <listitem>
+ <para>Set the SELINUX variable in <filename>/etc/selinux/config</filename> to
+ "permissive". This ensures that the permissive setting will be maintained after a system
+ reboot.</para>
+ <para>In RHEL or CentOS:</para>
+ <programlisting language="Bash">vi /etc/selinux/config</programlisting>
+ <para>Change the following line</para>
+ <programlisting>SELINUX=enforcing</programlisting>
+ <para>to this:</para>
+ <programlisting>SELINUX=permissive</programlisting>
+ </listitem>
+ <listitem>
+ <para>Set SELinux to permissive starting immediately, without requiring a system
+ reboot.</para>
+ <programlisting language="Bash"><command>$ setenforce permissive</command></programlisting>
+ </listitem>
+ </orderedlist>
+ </listitem>
+ <listitem>
+ <para>Set up &PRODUCT; Management Server setup:</para>
+ <programlisting># cloud-setup-management</programlisting>
+ </listitem>
+ <listitem>
<para>Set up the database. The following command creates the "cloud" user on the
database.</para>
<itemizedlist>
@@ -98,10 +134,10 @@ binlog-format = 'ROW'</programlisting>
recommended that you replace this with a more secure value. See <xref
linkend="about-password-encryption"/>.</para>
</listitem>
- <listitem>
- <para>(Optional) For management_server_ip, you may explicitly specify cluster management
- server node IP. If not specified, the local IP address will be used.</para>
- </listitem>
+ <listitem>
+ <para>(Optional) For management_server_ip, you may explicitly specify cluster management
+ server node IP. If not specified, the local IP address will be used.</para>
+ </listitem>
</itemizedlist>
<programlisting language="Bash">cloud-setup-databases cloud:<dbpassword>@localhost \
--deploy-as=root:<password> \