<title>Install the Management Server on the First Host</title>

<para>The first step in installation, whether you are installing the Management Server on one host

or many, is to install the software on a single node. </para>

<note>

<para>If you are planning to install the Management Server on multiple nodes for high

availability, do not proceed to the additional nodes yet. That step will come later.</para>

</note>

<para>The &PRODUCT; Management server can be installed using either RPM or DEB packages. These

packages will depend on everything you need to run the Management server.</para>

<section id="vhd-util">

<title>Downloading vhd-util</title>

<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>

</section>

<section id="management-server-install-rhel">

<title>Install on CentOS/RHEL</title>

<para>We start by installing the required packages:</para>

<programlisting language="Bash">yum install cloud-client</programlisting>

</section>

<section id="management-server-install-ubuntu">

<title>Install on Ubuntu</title>

<programlisting language="Bash">apt-get install cloud-client</programlisting>

</section>

<title>Prepare and Start Additional Management Servers</title>

<para>For your second and subsequent Management Servers, you will install the Management Server

software, connect it to the database, and set up the OS for the Management Server. </para>

<orderedlist>

<listitem>

<para> Perform the steps in <xref linkend="prepare-os"/> and <xref

linkend="sect-source-buildrpm"/> or <xref linkend="sect-source-builddebs"/> as

appropriate. </para>

</listitem>

<listitem>

<para>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>

</listitem>

<listitem>

<para> Ensure that necessary services are started and set to start on boot.

<programlisting><prompt>#</prompt> <command>service</command> rpcbind start

<prompt>#</prompt> <command>chkconfig</command> rpcbind on </programlisting>

</para>

</listitem>

<listitem>

<para> Configure the database client. Note the absence of the --deploy-as argument in this

case. (For more details about the arguments to this command, see <xref

linkend="management-server-install-db-external"/>.) </para>

<programlisting><prompt>#</prompt> <command>cloud-setup-databases</command> cloud:<replaceable>dbpassword</replaceable>@<replaceable>dbhost</replaceable> -e <replaceable>encryption_type</replaceable> -m <replaceable>management_server_key</replaceable> -k <replaceable>database_key</replaceable> </programlisting>

</listitem>

<listitem>

<para>Configure the OS and start the Management Server:</para>

<programlisting><prompt>#</prompt> <command>cloud-setup-management</command></programlisting>

<para>The Management Server on this node should now be running.</para>

</listitem>

<listitem>

<para>Repeat these steps on each additional Management Server. </para>

</listitem>

<listitem>

<para>Be sure to configure a load balancer for the Management Servers. See Management Server

Load Balancing.</para>

</listitem>

</orderedlist>

<listitem>

<para>Prepare the Operating System</para>

</listitem>

<listitem>

<para>Download and install vhd-util.</para>

</listitem>

<title>Prepare the System VM Template</title>

<para>Secondary storage must be seeded with a template that is used for &PRODUCT; system

VMs.</para>

<note>

<para>When copying and pasting a command, be sure the command has pasted as a single line before

executing. Some document viewers may introduce unwanted line breaks in copied text.</para>

</note>

<orderedlist>

<listitem>

<para>On the Management Server, run one or more of the following cloud-install-sys-tmplt

commands to retrieve and decompress the system VM template. Run the command for each

hypervisor type that you expect end users to run in this Zone.</para>

<para>If your secondary storage mount point is not named /mnt/secondary, substitute your own

mount point name.</para>

<para>If you set the &PRODUCT; database encryption type to "web" when you set up the database,

you must now add the parameter -s &lt;management-server-secret-key&gt;. See About Password

and Key Encryption.</para>

<para>This process will require approximately 5 GB of free space on the local file system and

up to 30 minutes each time it runs.</para>

<itemizedlist>

<listitem>

<para>For XenServer:</para>

<programlisting># /usr/lib64/cloud/common/scripts/storage/secondary/cloud-install-sys-tmplt -m /mnt/secondary -u http://download.cloud.com/templates/acton/acton-systemvm-02062012.vhd.bz2 -h xenserver -s &lt;optional-management-server-secret-key&gt; -F</programlisting>

</listitem>

<listitem>

<para>For vSphere:</para>

<programlisting># /usr/lib64/cloud/common/scripts/storage/secondary/cloud-install-sys-tmplt -m /mnt/secondary -u http://download.cloud.com/templates/acton/acton-systemvm-02062012.ova -h vmware -s &lt;optional-management-server-secret-key&gt; -F</programlisting>

</listitem>

<listitem>

<para>For KVM:</para>

<programlisting># /usr/lib64/cloud/common/scripts/storage/secondary/cloud-install-sys-tmplt -m /mnt/secondary -u http://download.cloud.com/templates/acton/acton-systemvm-02062012.qcow2.bz2 -h kvm -s &lt;optional-management-server-secret-key&gt; -F</programlisting>

</listitem>

</itemizedlist>

</listitem>

<listitem>

<para>If you are using a separate NFS server, perform this step. If you are using the

Management Server as the NFS server, you MUST NOT perform this step.</para>

<para>When the script has finished, unmount secondary storage and remove the created

directory.</para>

<programlisting># umount /mnt/secondary

# rmdir /mnt/secondary</programlisting>

</listitem>

<listitem>

<para>Repeat these steps for each secondary storage server.</para>

</listitem>

</orderedlist>