You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by wi...@apache.org on 2012/08/24 16:45:21 UTC
[2/2] docs: Add more Hypervisor and Management installation
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/342481e6/docs/en-US/management-server-installation-overview.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/management-server-installation-overview.xml b/docs/en-US/management-server-installation-overview.xml
deleted file mode 100644
index 3ccbdcc..0000000
--- a/docs/en-US/management-server-installation-overview.xml
+++ /dev/null
@@ -1,45 +0,0 @@
-<?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" [
-<!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="management-server-installation-overview">
- <title>Management Server Installation Overview</title>
- <para>This section describes installing the Management Server. There are two slightly different installation flows, depending on how many Management Server nodes will be in your cloud:</para>
- <itemizedlist>
- <listitem><para>A single Management Server node, with MySQL on the same node.</para></listitem>
- <listitem><para>Multiple Management Server nodes, with MySQL on a node separate from the Management Servers.</para></listitem>
- </itemizedlist>
- <para>In either case, each machine must meet the system requirements described in System Requirements.</para>
- <warning><para>For the sake of security, be sure the public Internet can not access port 8096 or port 8250 on the Management Server.</para></warning>
- <para>
- The procedure for installing the Management Server is:
- </para>
- <orderedlist>
- <listitem><para>Prepare the Operating System</para></listitem>
- <listitem><para>Install the First Management Server</para></listitem>
- <listitem><para>Install and Configure the Database</para></listitem>
- <listitem><para>Prepare NFS Shares</para></listitem>
- <listitem><para>Prepare and Start Additional Management Servers (optional)</para></listitem>
- <listitem><para>Prepare the System VM Template</para></listitem>
- </orderedlist>
- </section>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/342481e6/docs/en-US/management_server_multi_node_install.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/management_server_multi_node_install.xml b/docs/en-US/management_server_multi_node_install.xml
deleted file mode 100644
index 30f6af9..0000000
--- a/docs/en-US/management_server_multi_node_install.xml
+++ /dev/null
@@ -1,30 +0,0 @@
-<?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" [
-<!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.
--->
-
-<chapter id="management_server_multi_node_install">
- <title>Management Server Multi-Node Installation</title>
- <xi:include href="multi_node_overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="prepare_os.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="first_ms_node_install.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-</chapter>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/342481e6/docs/en-US/management_server_overview.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/management_server_overview.xml b/docs/en-US/management_server_overview.xml
deleted file mode 100644
index b5d74f3..0000000
--- a/docs/en-US/management_server_overview.xml
+++ /dev/null
@@ -1,53 +0,0 @@
-<?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="management_server_overview">
- <title>Management Server Overview</title>
- <para>The Management Server is the &PRODUCT; software that manages cloud resources. By interacting with the Management Server through its UI or API, you can configure and manage your cloud infrastructure.</para>
- <para>The Management Server runs on a dedicated server or VM. It controls allocation of virtual machines to hosts and assigns storage and IP addresses to the virtual machine instances. The &PRODUCT; Management Server runs in a Tomcat container and requires a MySQL database for persistence.</para>
- <para>The machine must meet the system requirements described in System Requirements.</para>
- <para>The Management Server:</para>
- <itemizedlist>
- <listitem>
- <para>Provides the web user interface for the administrator and a reference user interface for end users.</para>
- </listitem>
- <listitem>
- <para>Provides the APIs for the &PRODUCT; platform.</para>
- </listitem>
- <listitem>
- <para>Manages the assignment of guest VMs to particular hosts.</para>
- </listitem>
- <listitem>
- <para>Manages the assignment of public and private IP addresses to particular accounts.</para>
- </listitem>
- <listitem>
- <para>Manages the allocation of storage to guests as virtual disks.</para>
- </listitem>
- <listitem>
- <para>Manages snapshots, templates, and ISO images, possibly replicating them across data centers.</para>
- </listitem>
- <listitem>
- <para>Provides a single point of configuration for the cloud.</para>
- </listitem>
- </itemizedlist>
- </section>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/342481e6/docs/en-US/prepare-nfs-shares.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/prepare-nfs-shares.xml b/docs/en-US/prepare-nfs-shares.xml
deleted file mode 100644
index 28e3fa3..0000000
--- a/docs/en-US/prepare-nfs-shares.xml
+++ /dev/null
@@ -1,38 +0,0 @@
-<?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" [
-<!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-nfs-shares">
- <title>Prepare NFS Shares</title>
- <para>&PRODUCT; needs a place to keep primary and secondary storage (see Cloud Infrastructure Overview). Both of these can be NFS shares. This section tells how to set up the NFS shares before adding the storage to &PRODUCT;.</para>
- <para>For primary storage, you can use iSCSI instead.</para>
- <para>The requirements for primary and secondary storage are described in:</para>
- <itemizedlist>
- <listitem><para>About Primary Storage</para></listitem>
- <listitem><para>About Secondary Storage</para></listitem>
- </itemizedlist>
- <para>A production installation typically uses a separate NFS server. See <xref linkend="nfs-shares-on-separate-server"/>.</para>
- <para>You can also use the Management Server node as the NFS server. This is more typical of a trial installation, but is technically possible in a larger deployment. See <xref linkend="nfs-shares-on-management-server"/>.</para>
- <xi:include href="nfs-shares-on-separate-server.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="nfs-shares-on-management-server.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-</section>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/342481e6/docs/en-US/prepare-os.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/prepare-os.xml b/docs/en-US/prepare-os.xml
deleted file mode 100644
index 677ae43..0000000
--- a/docs/en-US/prepare-os.xml
+++ /dev/null
@@ -1,110 +0,0 @@
-<?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 is installed and enabled by default. You can verify this with:</para>
- <programlisting># rpm -qa | grep selinux</programlisting>
- <para condition="community">In Ubuntu, SELinux is not installed by default. You can verify this with:</para>
- <programlisting condition="community"># 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 condition="community">In RHEL or CentOS:</para>
- <programlisting># vi /etc/selinux/config</programlisting>
- <para condition="community">In Ubuntu (do this step only if SELinux was found on the machine in the previous step):</para>
- <programlisting condition="community"># 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 condition="community">In Ubuntu (do this step only if SELinux was found on the machine):</para>
- <programlisting condition="community"># setenforce permissive</programlisting>
- </listitem>
- </orderedlist>
- </listitem>
- <listitem><para>Make sure that the machine 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 condition="community">On RHEL or CentOS:</para>
- <programlisting># yum install ntp</programlisting>
- <para condition="community">On Ubuntu:</para>
- <programlisting condition="community"># 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>Add one or more server lines in this file with the names of the NTP servers
- you want to use. For example:</para>
- <programlisting>server 0.xenserver.pool.ntp.org
-server 1.xenserver.pool.ntp.org
-server 2.xenserver.pool.ntp.org
-server 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 condition="community">On RHEL or CentOS:</para>
- <programlisting># chkconfig ntpd on</programlisting>
- <para condition="community">On Ubuntu:</para>
- <programlisting># chkconfig ntp on</programlisting>
- </listitem>
- </orderedlist>
- </listitem>
- <listitem><para>Repeat all of these steps on every host where the Management Server will be installed.</para></listitem>
- </orderedlist>
- </section>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/342481e6/docs/en-US/prepare-system-vm-template.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/prepare-system-vm-template.xml b/docs/en-US/prepare-system-vm-template.xml
deleted file mode 100644
index c2c1212..0000000
--- a/docs/en-US/prepare-system-vm-template.xml
+++ /dev/null
@@ -1,56 +0,0 @@
-<?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" [
-<!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-system-vm-template">
- <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 <management-server-secret-key>. 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/agent/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 <optional-management-server-secret-key> -F</programlisting>
- </listitem>
- <listitem><para>For vSphere:</para>
- <programlisting># /usr/lib64/cloud/agent/scripts/storage/secondary/cloud-install-sys-tmplt -m /mnt/secondary -u http://download.cloud.com/templates/burbank/burbank-systemvm-08012012.ova -h vmware -s <optional-management-server-secret-key> -F</programlisting>
- </listitem>
- <listitem><para>For KVM:</para>
- <programlisting># /usr/lib64/cloud/agent/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 <optional-management-server-secret-key> -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>
-</section>