mirror of
https://github.com/apache/cloudstack.git
synced 2025-10-26 08:42:29 +01:00
107 lines
6.4 KiB
XML
107 lines
6.4 KiB
XML
<?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="prepare_os">
|
|
<title>Prepare the Operating System</title>
|
|
<para>The OS must be prepared to host the Management Server using the following steps. These steps must be performed on each Management Server node.</para>
|
|
<orderedlist>
|
|
<listitem><para>Log in to your OS as root.</para></listitem>
|
|
<listitem><para>Check for a fully qualified hostname.</para>
|
|
<programlisting># hostname --fqdn</programlisting>
|
|
<para>This should return a fully qualified hostname such as "kvm1.lab.example.org". If it does not, edit /etc/hosts so that it does.</para>
|
|
</listitem>
|
|
<listitem><para>Set SELinux to be permissive by default.</para>
|
|
<orderedlist numeration="loweralpha">
|
|
<listitem><para>Check to see whether SELinux is installed on your machine. If not, you can skip to step 4.</para>
|
|
<para>In RHEL or CentOS, SELinux are installed and enabled by default. You can verify this with:</para>
|
|
<programlisting># rpm -qa | grep selinux</programlisting>
|
|
<para>In Ubuntu, SELinux is not installed by default. You can verify this with:</para>
|
|
<programlisting># dpkg --list 'selinux'</programlisting>
|
|
</listitem>
|
|
<listitem><para>Set the SELINUX variable in /etc/selinux/config to “permissive”. This ensures that the permissive setting will be maintained after a system reboot.</para>
|
|
<para>In RHEL or CentOS:</para>
|
|
<programlisting># vi /etc/selinux/config</programlisting>
|
|
<para>In Ubuntu (do this step only if SELinux was found on the machine in the previous step):</para>
|
|
<programlisting># selinux-config-enforcing permissive</programlisting>
|
|
</listitem>
|
|
<listitem><para>Then set SELinux to permissive starting immediately, without requiring a system reboot.</para>
|
|
<para>In CentOS:</para>
|
|
<programlisting># setenforce permissive</programlisting>
|
|
<para>In RHEL:</para>
|
|
<programlisting># setenforce 0</programlisting>
|
|
<para>In Ubuntu (do this step only if SELinux was found on the machine):</para>
|
|
<programlisting># setenforce permissive</programlisting>
|
|
</listitem>
|
|
</orderedlist>
|
|
</listitem>
|
|
<listitem><para>Make sure that the Management Server can reach the Internet.</para>
|
|
<programlisting># ping www.google.com</programlisting>
|
|
</listitem>
|
|
<listitem><para>(RHEL 6.2) If you do not have a Red Hat Network account, you need to prepare a local Yum repository.</para>
|
|
<orderedlist numeration="loweralpha">
|
|
<listitem><para>If you are working with a physical host, insert the RHEL 6.2 installation CD. If you are using a VM, attach the RHEL6 ISO.</para></listitem>
|
|
<listitem><para>Mount the CDROM to /media.</para></listitem>
|
|
<listitem><para>Create a repo file at /etc/yum.repos.d/rhel6.repo. In the file, insert the following lines:</para>
|
|
<programlisting>
|
|
[rhel]
|
|
name=rhel6
|
|
baseurl=file:///media
|
|
enabled=1
|
|
gpgcheck=0
|
|
</programlisting>
|
|
</listitem>
|
|
</orderedlist>
|
|
</listitem>
|
|
<listitem><para>Turn on NTP for time synchronization.</para>
|
|
<note><para>NTP is required to synchronize the clocks of the servers in your cloud.</para></note>
|
|
<orderedlist numeration="loweralpha">
|
|
<listitem><para>Install NTP.</para>
|
|
<para>On RHEL or CentOS:</para>
|
|
<programlisting># yum install ntp</programlisting>
|
|
<para>On Ubuntu:</para>
|
|
<programlisting># apt-get install ntp</programlisting>
|
|
</listitem>
|
|
<listitem><para>Edit the NTP configuration file to point to your NTP server.</para>
|
|
<programlisting># vi /etc/ntp.conf</programlisting>
|
|
<para>For example, you can use one of the following:</para>
|
|
<programlisting>0.xenserver.pool.ntp.org
|
|
1.xenserver.pool.ntp.org
|
|
2.xenserver.pool.ntp.org
|
|
3.xenserver.pool.ntp.org
|
|
</programlisting>
|
|
</listitem>
|
|
<listitem><para>Restart the NTP client.</para>
|
|
<programlisting># service ntpd restart</programlisting>
|
|
</listitem>
|
|
<listitem><para>Make sure NTP will start again upon reboot.</para>
|
|
<para>On RHEL or CentOS:</para>
|
|
<programlisting># chkconfig ntpd on</programlisting>
|
|
<para>On Ubuntu:</para>
|
|
<programlisting># chkconfig ntp on</programlisting>
|
|
</listitem>
|
|
</orderedlist>
|
|
</listitem>
|
|
</orderedlist>
|
|
</section>
|