# 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. # # AUTHOR , YEAR. # msgid "" msgstr "" "Project-Id-Version: 0\n" "POT-Creation-Date: 2013-02-01T09:17:06\n" "PO-Revision-Date: 2013-02-01T09:17:06\n" "Last-Translator: Automatically generated\n" "Language-Team: None\n" "MIME-Version: 1.0\n" "Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title #, no-c-format msgid "Environment" msgstr "" #. Tag: para #, no-c-format msgid "Before you begin, you need to prepare the environment before you install CloudStack. We will go over the steps to prepare now." msgstr "" #. Tag: title #, no-c-format msgid "Operating System" msgstr "" #. Tag: para #, no-c-format msgid "Using the CentOS 6.3 x86_64 minimal install ISO, you'll need to install CentOS on your hardware. The defaults will generally be acceptable for this installation." msgstr "" #. Tag: para #, no-c-format msgid "Once this installation is complete, you'll want to connect to your freshly installed machine via SSH as the root user. Note that you should not allow root logins in a production environment, so be sure to turn off remote logins once you have finished the installation and configuration." msgstr "" #. Tag: title #, no-c-format msgid "Configuring the network" msgstr "" #. Tag: para #, no-c-format msgid "By default the network will not come up on your hardware and you will need to configure it to work in your environment. Since we specified that there will be no DHCP server in this environment we will be manually configuring your network interface. We will assume, for the purposes of this exercise, that eth0 is the only network interface that will be connected and used." msgstr "" #. Tag: para #, no-c-format msgid "Connecting via the console you should login as root. Check the file /etc/sysconfig/network-scripts/ifcfg-eth0, it will look like this by default:" msgstr "" #. Tag: screen #, no-c-format msgid "\n" "DEVICE=\"eth0\"\n" "HWADDR=\"52:54:00:B9:A6:C0\"\n" "NM_CONTROLLED=\"yes\"\n" "ONBOOT=\"no\"\n" " " msgstr "" #. Tag: para #, no-c-format msgid "Unfortunately, this configuration will not permit you to connect to the network, and is also unsuitable for our purposes with CloudStack. We want to configure that file so that it specifies the IP address, netmask, etc., as shown in the following example:" msgstr "" #. Tag: title #, no-c-format msgid "Hardware Addresses" msgstr "" #. Tag: para #, no-c-format msgid "You should not use the hardware address (aka MAC address) from our example for your configuration. It is network interface specific, so you should keep the address already provided in the HWADDR directive." msgstr "" #. Tag: screen #, no-c-format msgid "\n" "DEVICE=eth0\n" "HWADDR=52:54:00:B9:A6:C0\n" "NM_CONTROLLED=no\n" "ONBOOT=yes\n" "BOOTPROTO=none\n" "IPADDR=172.16.10.2\n" "NETMASK=255.255.255.0\n" "GATEWAY=172.16.10.1\n" "DNS1=8.8.8.8\n" "DNS2=8.8.4.4\n" " " msgstr "" #. Tag: title #, no-c-format msgid "IP Addressing" msgstr "" #. Tag: para #, no-c-format msgid "Throughout this document we are assuming that you will have a /24 network for your CloudStack implementation. This can be any RFC 1918 network. However, we are assuming that you will match the machine address that we are using. Thus we may use 172.16.10.2 and because you might be using the 192.168.55.0/24 network you would use 192.168.55.2" msgstr "" #. Tag: para #, no-c-format msgid "Now that we have the configuration files properly set up, we need to run a few commands to start up the network" msgstr "" #. Tag: screen #, no-c-format msgid "# chkconfig network on" msgstr "" #. Tag: screen #, no-c-format msgid "# service network start" msgstr "" #. Tag: title #, no-c-format msgid "Hostname" msgstr "" #. Tag: para #, no-c-format msgid "Cloudstack requires that the hostname be properly set. If you used the default options in the installation, then your hostname is currently set to localhost.localdomain. To test this we will run:" msgstr "" #. Tag: screen #, no-c-format msgid "# hostname --fqdn" msgstr "" #. Tag: para #, no-c-format msgid "At this point it will likely return:" msgstr "" #. Tag: screen #, no-c-format msgid "localhost" msgstr "" #. Tag: para #, no-c-format msgid "To rectify this situation - we'll set the hostname by editing the /etc/hosts file so that it follows a similar format to this example:" msgstr "" #. Tag: screen #, no-c-format msgid "\n" "127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4\n" "172.16.10.2 srvr1.cloud.priv\n" "" msgstr "" #. Tag: para #, no-c-format msgid "After you've modified that file, go ahead and restart the network using:" msgstr "" #. Tag: screen #, no-c-format msgid "# service network restart" msgstr "" #. Tag: para #, no-c-format msgid "Now recheck with the hostname --fqdn command and ensure that it returns a FQDN response" msgstr "" #. Tag: title #, no-c-format msgid "SELinux" msgstr "" #. Tag: para #, no-c-format msgid "At the moment, for CloudStack to work properly SELinux must be set to permissive. We want to both configure this for future boots and modify it in the current running system." msgstr "" #. Tag: para #, no-c-format msgid "To configure SELinux to be permissive in the running system we need to run the following command:" msgstr "" #. Tag: screen #, no-c-format msgid "# setenforce 0" msgstr "" #. Tag: para #, no-c-format msgid "To ensure that it remains in that state we need to configure the file /etc/selinux/config to reflect the permissive state, as shown in this example:" msgstr "" #. Tag: screen #, no-c-format msgid "\n" "\n" "# This file controls the state of SELinux on the system.\n" "# SELINUX= can take one of these three values:\n" "# enforcing - SELinux security policy is enforced.\n" "# permissive - SELinux prints warnings instead of enforcing.\n" "# disabled - No SELinux policy is loaded.\n" "SELINUX=permissive\n" "# SELINUXTYPE= can take one of these two values:\n" "# targeted - Targeted processes are protected,\n" "# mls - Multi Level Security protection.\n" "SELINUXTYPE=targeted\n" " " msgstr "" #. Tag: title #, no-c-format msgid "NTP" msgstr "" #. Tag: para #, no-c-format msgid "NTP configuration is a necessity for keeping all of the clocks in your cloud servers in sync. However, NTP is not installed by default. So we'll install and and configure NTP at this stage. Installation is accomplished as follows:" msgstr "" #. Tag: screen #, no-c-format msgid "# yum -y install ntp" msgstr "" #. Tag: para #, no-c-format msgid "The actual default configuration is fine for our purposes, so we merely need to enable it and set it to start on boot as follows:" msgstr "" #. Tag: screen #, no-c-format msgid "# chkconfig ntpd on" msgstr "" #. Tag: screen #, no-c-format msgid "# service ntpd start" msgstr "" #. Tag: title #, no-c-format msgid "Configuring the CloudStack Package Repository" msgstr "" #. Tag: para #, no-c-format msgid "We need to configure the machine to use a CloudStack package repository." msgstr "" #. Tag: title #, no-c-format msgid "The below repository is not an official Apache CloudStack project repository" msgstr "" #. Tag: para #, no-c-format msgid "The Apache CloudStack official releases are source code. As such there are no 'official' binaries available. The full installation guide describes how to take the source release and generate RPMs and and yum repository. This guide attempts to keep things as simple as possible, and thus we are using one of the community-provided yum repositories." msgstr "" #. Tag: para #, no-c-format msgid "To add the CloudStack repository, create /etc/yum.repos.d/cloudstack.repo and insert the following information." msgstr "" #. Tag: programlisting #, no-c-format msgid "\n" "[cloudstack]\n" "name=cloudstack\n" "baseurl=http://cloudstack.apt-get.eu/rhel/4.0/\n" "enabled=1\n" "gpgcheck=0\n" " " msgstr "" #. Tag: title #, no-c-format msgid "NFS" msgstr "" #. Tag: para #, no-c-format msgid "Our configuration is going to use NFS for both primary and secondary storage. We are going to go ahead and setup two NFS shares for those purposes. We'll start out by installing nfs-utils." msgstr "" #. Tag: screen #, no-c-format msgid "# yum install nfs-utils" msgstr "" #. Tag: para #, no-c-format msgid "We now need to configure NFS to serve up two different shares. This is handled comparatively easily in the /etc/exports file. You should ensure that it has the following content:" msgstr "" #. Tag: screen #, no-c-format msgid "\n" "/secondary *(rw,async,no_root_squash)\n" "/primary *(rw,async,no_root_squash)\n" " " msgstr "" #. Tag: para #, no-c-format msgid "You will note that we specified two directories that don't exist (yet) on the system. We'll go ahead and create those directories and set permissions appropriately on them with the following commands:" msgstr "" #. Tag: screen #, no-c-format msgid "\n" "# mkdir /primary\n" "# mkdir /secondary\n" " " msgstr "" #. Tag: para #, no-c-format msgid "CentOS 6.x releases use NFSv4 by default. NFSv4 requires that domain setting matches on all clients. In our case, the domain is cloud.priv, so ensure that the domain setting in /etc/idmapd.conf is uncommented and set as follows:" msgstr "" #. Tag: screen #, no-c-format msgid "Domain = cloud.priv" msgstr "" #. Tag: para #, no-c-format msgid "Now you'll need uncomment the configuration values in the file /etc/sysconfig/nfs" msgstr "" #. Tag: screen #, no-c-format msgid "\n" "LOCKD_TCPPORT=32803\n" "LOCKD_UDPPORT=32769\n" "MOUNTD_PORT=892\n" "RQUOTAD_PORT=875\n" "STATD_PORT=662\n" "STATD_OUTGOING_PORT=2020\n" " " msgstr "" #. Tag: para #, no-c-format msgid "Now we need to configure the firewall to permit incoming NFS connections. Edit the file /etc/sysconfig/iptables" msgstr "" #. Tag: screen #, no-c-format msgid "\n" "-A INPUT -s 172.16.10.0/24 -m state --state NEW -p udp --dport 111 -j ACCEPT\n" "-A INPUT -s 172.16.10.0/24 -m state --state NEW -p tcp --dport 111 -j ACCEPT\n" "-A INPUT -s 172.16.10.0/24 -m state --state NEW -p tcp --dport 2049 -j ACCEPT\n" "-A INPUT -s 172.16.10.0/24 -m state --state NEW -p tcp --dport 32803 -j ACCEPT\n" "-A INPUT -s 172.16.10.0/24 -m state --state NEW -p udp --dport 32769 -j ACCEPT\n" "-A INPUT -s 172.16.10.0/24 -m state --state NEW -p tcp --dport 892 -j ACCEPT\n" "-A INPUT -s 172.16.10.0/24 -m state --state NEW -p udp --dport 892 -j ACCEPT\n" "-A INPUT -s 172.16.10.0/24 -m state --state NEW -p tcp --dport 875 -j ACCEPT\n" "-A INPUT -s 172.16.10.0/24 -m state --state NEW -p udp --dport 875 -j ACCEPT\n" "-A INPUT -s 172.16.10.0/24 -m state --state NEW -p tcp --dport 662 -j ACCEPT\n" "-A INPUT -s 172.16.10.0/24 -m state --state NEW -p udp --dport 662 -j ACCEPT\n" " " msgstr "" #. Tag: para #, no-c-format msgid "Now you can restart the iptables service with the following command:" msgstr "" #. Tag: screen #, no-c-format msgid "# service iptables restart" msgstr "" #. Tag: para #, no-c-format msgid "We now need to configure nfs service to start on boot and actually start it on the host by executing the following commands:" msgstr "" #. Tag: screen #, no-c-format msgid "\n" "# service rpcbind start\n" "# service nfs start\n" "# chkconfig rpcbind on\n" "# chkconfig nfs on\n" " " msgstr ""