| <?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="hypervisor-host-install-prepare-os"> |
| <title>Prepare the Operating System</title> |
| <para>The OS of the Host must be prepared to host the &PRODUCT; Agent and run KVM instances.</para> |
| <orderedlist> |
| <listitem><para>Log in to your OS as root.</para></listitem> |
| <listitem> |
| <para>Check for a fully qualified hostname.</para> |
| <programlisting language="Bash"><command>$ hostname --fqdn</command></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>Make sure that the machine can reach the Internet.</para> |
| <programlisting language="Bash"><command>$ ping www.cloudstack.org</command></programlisting> |
| </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. Unsynchronized clocks can cause unexpected problems.</para></note> |
| <orderedlist numeration="loweralpha"> |
| <listitem><para>Install NTP</para> |
| <para condition="community">On RHEL or CentOS:</para> |
| <programlisting language="Bash"><command>$ yum install ntp</command></programlisting> |
| <para condition="community">On Ubuntu:</para> |
| <programlisting language="Bash"><command>$ apt-get install openntpd</command></programlisting> |
| </listitem> |
| </orderedlist> |
| </listitem> |
| <listitem><para>Repeat all of these steps on every hypervisor host.</para></listitem> |
| </orderedlist> |
| </section> |