Skip to content

Commit bf9ff8c

Browse files
radhikapsebgoa
radhikap
authored and
sebgoa
committed
cloudstack-462
Signed-off-by: radhikap <radhika.puthiyetath@citrix.com> Signed-off-by: Sebastien Goasguen <runseb@gmail.com>
1 parent ac1b529 commit bf9ff8c

2 files changed

Lines changed: 53 additions & 18 deletions

File tree

‎docs/en-US/management-server-install-client.xml‎

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version='1.0' encoding='utf-8' ?>
2-
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
2+
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
33
<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
44
%BOOK_ENTITIES;
55
]>
@@ -11,9 +11,7 @@
1111
to you under the Apache License, Version 2.0 (the
1212
"License"); you may not use this file except in compliance
1313
with the License. You may obtain a copy of the License at
14-
1514
http://www.apache.org/licenses/LICENSE-2.0
16-
1715
Unless required by applicable law or agreed to in writing,
1816
software distributed under the License is distributed on an
1917
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -33,13 +31,14 @@
3331
packages will depend on everything you need to run the Management server.</para>
3432
<section id="vhd-util">
3533
<title>Downloading vhd-util</title>
36-
<para>This procedure is required only for installations where XenServer is installed on the hypervisor hosts.</para>
34+
<para>This procedure is required only for installations where XenServer is installed on the
35+
hypervisor hosts.</para>
3736
<para>Before setting up the Management Server, download vhd-util from <ulink
3837
url="http://download.cloud.com.s3.amazonaws.com/tools/vhd-util">vhd-util</ulink>.</para>
3938
<para>If the Management Server is RHEL or CentOS, copy vhd-util to
4039
/usr/lib64/cloud/common/scripts/vm/hypervisor/xenserver.</para>
4140
<para>If the Management Server is Ubuntu, copy vhd-util to
42-
/usr/lib/cloud/common/scripts/vm/hypervisor/xenserver/vhd-util.</para>
41+
/usr/lib/cloud/common/scripts/vm/hypervisor/xenserver.</para>
4342
</section>
4443
<section id="management-server-install-rhel">
4544
<title>Install on CentOS/RHEL</title>
@@ -50,4 +49,4 @@
5049
<title>Install on Ubuntu</title>
5150
<programlisting language="Bash">apt-get install cloud-client</programlisting>
5251
</section>
53-
</section>
52+
</section>

‎docs/en-US/management-server-install-db-local.xml‎

Lines changed: 48 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,7 @@
1111
to you under the Apache License, Version 2.0 (the
1212
"License"); you may not use this file except in compliance
1313
with the License. You may obtain a copy of the License at
14-
1514
http://www.apache.org/licenses/LICENSE-2.0
16-
1715
Unless required by applicable law or agreed to in writing,
1816
software distributed under the License is distributed on an
1917
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -29,19 +27,23 @@
2927
MySQL. See <xref linkend="management-server-install-db-external"/>.</para>
3028
<orderedlist>
3129
<listitem>
32-
<para>Install MySQL from the package repository from your distribution:</para>
30+
<para>Install MySQL from the package repository of your distribution:</para>
3331
<para condition="community">On RHEL or CentOS:</para>
3432
<programlisting language="Bash">yum install mysql-server</programlisting>
3533
<para condition="community">On Ubuntu:</para>
3634
<programlisting language="Bash">apt-get install mysql-server</programlisting>
3735
</listitem>
3836
<listitem>
39-
<para>Edit the MySQL configuration (/etc/my.cnf or /etc/mysql/my.cnf, depending on your OS)
40-
and insert the following lines in the [mysqld] section. You can put these lines below the
41-
datadir line. The max_connections parameter should be set to 350 multiplied by the number of
42-
Management Servers you are deploying. This example assumes one Management Server.</para>
37+
<para>Open the MySQL configuration file. The configuration file is <filename>/etc/my.cnf</filename> or
38+
<filename>/etc/mysql/my.cnf</filename>, depending on your OS.</para>
39+
</listitem>
40+
<listitem>
41+
<para>Insert the following lines in the [mysqld] section. </para>
42+
<para>You can put these lines below the datadir line. The max_connections parameter should be
43+
set to 350 multiplied by the number of Management Servers you are deploying. This example
44+
assumes one Management Server.</para>
4345
<note>
44-
<para>On Ubuntu, you can also create a file /etc/mysql/conf.d/cloudstack.cnf and add these
46+
<para>On Ubuntu, you can also create a file <filename>/etc/mysql/conf.d/cloudstack.cnf</filename> and add these
4547
directives there. Don't forget to add [mysqld] on the first line of the file.</para>
4648
</note>
4749
<programlisting language="Bash">innodb_rollback_on_timeout=1
@@ -68,6 +70,40 @@ binlog-format = 'ROW'</programlisting>
6870
questions.</para>
6971
<programlisting language="Bash">mysql_secure_installation</programlisting>
7072
</listitem>
73+
<listitem>
74+
<para>&PRODUCT; can be blocked by security mechanisms, such as SELinux. Disable SELinux to
75+
ensure + that the Agent has all the required permissions.</para>
76+
<para>Configure SELinux (RHEL and CentOS):</para>
77+
<orderedlist numeration="loweralpha">
78+
<listitem>
79+
<para>Check whether SELinux is installed on your machine. If not, you can skip this
80+
section.</para>
81+
<para>In RHEL or CentOS, SELinux is installed and enabled by default. You can verify this
82+
with:</para>
83+
<programlisting language="Bash"><command>$ rpm -qa | grep selinux</command></programlisting>
84+
</listitem>
85+
<listitem>
86+
<para>Set the SELINUX variable in <filename>/etc/selinux/config</filename> to
87+
"permissive". This ensures that the permissive setting will be maintained after a system
88+
reboot.</para>
89+
<para>In RHEL or CentOS:</para>
90+
<programlisting language="Bash">vi /etc/selinux/config</programlisting>
91+
<para>Change the following line</para>
92+
<programlisting>SELINUX=enforcing</programlisting>
93+
<para>to this:</para>
94+
<programlisting>SELINUX=permissive</programlisting>
95+
</listitem>
96+
<listitem>
97+
<para>Set SELinux to permissive starting immediately, without requiring a system
98+
reboot.</para>
99+
<programlisting language="Bash"><command>$ setenforce permissive</command></programlisting>
100+
</listitem>
101+
</orderedlist>
102+
</listitem>
103+
<listitem>
104+
<para>Set up &PRODUCT; Management Server setup:</para>
105+
<programlisting># cloud-setup-management</programlisting>
106+
</listitem>
71107
<listitem>
72108
<para>Set up the database. The following command creates the "cloud" user on the
73109
database.</para>
@@ -98,10 +134,10 @@ binlog-format = 'ROW'</programlisting>
98134
recommended that you replace this with a more secure value. See <xref
99135
linkend="about-password-encryption"/>.</para>
100136
</listitem>
101-
<listitem>
102-
<para>(Optional) For management_server_ip, you may explicitly specify cluster management
103-
server node IP. If not specified, the local IP address will be used.</para>
104-
</listitem>
137+
<listitem>
138+
<para>(Optional) For management_server_ip, you may explicitly specify cluster management
139+
server node IP. If not specified, the local IP address will be used.</para>
140+
</listitem>
105141
</itemizedlist>
106142
<programlisting language="Bash">cloud-setup-databases cloud:&lt;dbpassword&gt;@localhost \
107143
--deploy-as=root:&lt;password&gt; \

0 commit comments

Comments
 (0)