incubator-cloudstack-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ke4...@apache.org
Subject [14/15] git commit: refs/heads/4.0 - adding pot files for l10n
Date Mon, 18 Feb 2013 22:52:34 GMT
adding pot files for l10n


Project: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/commit/a352c442
Tree: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/tree/a352c442
Diff: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/diff/a352c442

Branch: refs/heads/4.0
Commit: a352c442b54b92489c258e78f9092e57278e5221
Parents: 43f680b
Author: David Nalley <david@gnsa.us>
Authored: Fri Feb 1 04:17:35 2013 -0500
Committer: David Nalley <david@gnsa.us>
Committed: Mon Feb 18 17:53:43 2013 -0500

----------------------------------------------------------------------
 docs/runbook/pot/Author_Group.pot     |   24 ++
 docs/runbook/pot/Book_Info.pot        |   34 +++
 docs/runbook/pot/Chapter.pot          |   49 ++++
 docs/runbook/pot/Environment.pot      |  396 ++++++++++++++++++++++++++++
 docs/runbook/pot/Management.pot       |  139 ++++++++++
 docs/runbook/pot/Overview.pot         |   79 ++++++
 docs/runbook/pot/Preface.pot          |   19 ++
 docs/runbook/pot/Revision_History.pot |   29 ++
 docs/runbook/pot/Runbook.pot          |   14 +
 docs/runbook/pot/config.pot           |  219 +++++++++++++++
 docs/runbook/pot/kvm.pot              |  229 ++++++++++++++++
 11 files changed, 1231 insertions(+), 0 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/a352c442/docs/runbook/pot/Author_Group.pot
----------------------------------------------------------------------
diff --git a/docs/runbook/pot/Author_Group.pot b/docs/runbook/pot/Author_Group.pot
new file mode 100644
index 0000000..ca13a2b
--- /dev/null
+++ b/docs/runbook/pot/Author_Group.pot
@@ -0,0 +1,24 @@
+# 
+# AUTHOR <EMAIL@ADDRESS>, 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: firstname
+#, no-c-format
+msgid "Apache"
+msgstr ""
+
+#. Tag: surname
+#, no-c-format
+msgid "CloudStack"
+msgstr ""
+

http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/a352c442/docs/runbook/pot/Book_Info.pot
----------------------------------------------------------------------
diff --git a/docs/runbook/pot/Book_Info.pot b/docs/runbook/pot/Book_Info.pot
new file mode 100644
index 0000000..a0e28de
--- /dev/null
+++ b/docs/runbook/pot/Book_Info.pot
@@ -0,0 +1,34 @@
+# 
+# AUTHOR <EMAIL@ADDRESS>, 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 "Runbook"
+msgstr ""
+
+#. Tag: subtitle
+#, no-c-format
+msgid "Prescriptive instructions for deploying Apache CloudStack"
+msgstr ""
+
+#. Tag: productname
+#, no-c-format
+msgid "Apache CloudStack"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "These runbooks are designed to provide a strict environment to guarantee a higher
degree of success in initial deployments of Apache CloudStack. All of the elements of the
environment will be provided to you. Apache CloudStack is capable of much more complex configurations,
but they are beyond the scope of this document."
+msgstr ""
+

http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/a352c442/docs/runbook/pot/Chapter.pot
----------------------------------------------------------------------
diff --git a/docs/runbook/pot/Chapter.pot b/docs/runbook/pot/Chapter.pot
new file mode 100644
index 0000000..1978a4a
--- /dev/null
+++ b/docs/runbook/pot/Chapter.pot
@@ -0,0 +1,49 @@
+# 
+# AUTHOR <EMAIL@ADDRESS>, 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 "Test Chapter"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "This is a test paragraph"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Test Section 1"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "This is a test paragraph in a section"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Test Section 2"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "This is a test paragraph in Section 2"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "listitem text"
+msgstr ""
+

http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/a352c442/docs/runbook/pot/Environment.pot
----------------------------------------------------------------------
diff --git a/docs/runbook/pot/Environment.pot b/docs/runbook/pot/Environment.pot
new file mode 100644
index 0000000..b8d1fa5
--- /dev/null
+++ b/docs/runbook/pot/Environment.pot
@@ -0,0 +1,396 @@
+# 
+# AUTHOR <EMAIL@ADDRESS>, 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 <filename>/etc/sysconfig/network-scripts/ifcfg-eth0</filename>,
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 <userinput><replaceable>172.16.10</replaceable>.2</userinput>
and because you might be using the 192.168.55.0/24 network you would use <userinput><replaceable>192.168.55</replaceable>.2</userinput>"
+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 "<prompt># </prompt><userinput><command>chkconfig</command>
network on</userinput>"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<prompt># </prompt><userinput><command>service</command>
network start</userinput>"
+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 "<prompt># </prompt><userinput>hostname --fqdn</userinput>"
+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 <filename>/etc/hosts</filename>
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 "<prompt># </prompt><userinput><command>service</command>
network restart</userinput>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Now recheck with the <command>hostname --fqdn</command> 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 "<prompt># </prompt><userinput><command>setenforce</command>
0</userinput>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To ensure that it remains in that state we need to configure the file <filename>/etc/selinux/config</filename>
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 "<prompt># </prompt><userinput><command>yum</command>
-y install ntp</userinput>"
+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 "<prompt># </prompt><userinput><command>chkconfig</command>
ntpd on</userinput>"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<prompt># </prompt><userinput><command>service</command>
ntpd start</userinput>"
+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 <filename>/etc/yum.repos.d/cloudstack.repo</filename>
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
<application>nfs-utils</application>."
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<prompt># </prompt><userinput><command>yum</command>
install nfs-utils</userinput>"
+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 <filename>/etc/exports</filename> 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"
+"<prompt># </prompt><userinput><command>mkdir</command> /primary</userinput>\n"
+"<prompt># </prompt><userinput><command>mkdir</command> /secondary</userinput>\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
<filename>/etc/idmapd.conf</filename> 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 <filename>/etc/sysconfig/nfs</filename>"
+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 <filename>/etc/sysconfig/iptables</filename>"
+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 "<prompt># </prompt><userinput><command>service</command>
iptables restart</userinput>"
+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"
+"<prompt># </prompt><userinput><command>service</command> rpcbind
start</userinput>\n"
+"<prompt># </prompt><userinput><command>service</command> nfs
start</userinput>\n"
+"<prompt># </prompt><userinput><command>chkconfig</command>
rpcbind on</userinput>\n"
+"<prompt># </prompt><userinput><command>chkconfig</command>
nfs on</userinput>\n"
+"    "
+msgstr ""
+

http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/a352c442/docs/runbook/pot/Management.pot
----------------------------------------------------------------------
diff --git a/docs/runbook/pot/Management.pot b/docs/runbook/pot/Management.pot
new file mode 100644
index 0000000..1fb74a3
--- /dev/null
+++ b/docs/runbook/pot/Management.pot
@@ -0,0 +1,139 @@
+# 
+# AUTHOR <EMAIL@ADDRESS>, 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 "Installation of the management server"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Now it is time to start installing CloudStack's management server and some of the
related components."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Database Installation and Configuration"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "We'll start out by installing <application>MySQL</application> and configuring
some options to ensure CloudStack runs well."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To install <application>MySQL</application> run the following command:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<prompt># </prompt><userinput><command>yum</command>
-y install mysql-server</userinput>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "With <application>MySQL</application> installed we need to make a few
configuration changes to <filename>/etc/my.cnf</filename>. Specifically we need
to add the following options to the [mysqld] section:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "\n"
+"innodb_rollback_on_timeout=1\n"
+"innodb_lock_wait_timeout=600\n"
+"max_connections=350\n"
+"log-bin=mysql-bin\n"
+"binlog-format = 'ROW' \n"
+"        "
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Now that <application>MySQL</application> is properly configured we can
start it and configure it to start on boot as follows:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "\n"
+"<prompt># </prompt><userinput><command>service</command> mysqld
start</userinput>\n"
+"<prompt># </prompt><userinput><command>chkconfig</command>
mysqld on</userinput>\n"
+"        "
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Installation"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "We are now going to install the management server. We do that by executing the following
command:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<prompt># </prompt><userinput><command>yum</command>
-y install cloud-client</userinput>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "With the application itself installed we can now setup the database, we'll do that
with the following command and options:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<prompt># </prompt><userinput><command>cloud-setup-databases</command>
cloud:<replaceable>password</replaceable>@localhost --deploy-as=root</userinput>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "When this process is finished, you should see a message like \"CloudStack has successfully
initialized the database.\""
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Now that the database has been created, we can take the final step in setting up the
management server by issuing the following command:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<prompt># </prompt><userinput><command>cloud-setup-management</command></userinput>"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "System Template Setup"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "CloudStack uses a number of system VMs to provide functionality for accessing the
console of virtual machines, providing various networking services, and managing various aspects
of storage. This step will acquire those system images ready for deployment when we bootstrap
your cloud."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Now we need to download the system VM template and deploy that to the share we just
mounted. The management server includes a script to properly manipulate the system VMs images."
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<prompt># </prompt><userinput><command>/usr/lib64/cloud/common/scripts/storage/secondary/cloud-install-sys-tmplt</command>
-m  /secondary -u http://download.cloud.com/templates/acton/acton-systemvm-02062012.qcow2.bz2
-h kvm -F</userinput>\n"
+"    "
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "That concludes our setup of the management server. We still need to configure CloudStack,
but we will do that after we get our hypervisor set up."
+msgstr ""
+

http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/a352c442/docs/runbook/pot/Overview.pot
----------------------------------------------------------------------
diff --git a/docs/runbook/pot/Overview.pot b/docs/runbook/pot/Overview.pot
new file mode 100644
index 0000000..6f7263e
--- /dev/null
+++ b/docs/runbook/pot/Overview.pot
@@ -0,0 +1,79 @@
+# 
+# AUTHOR <EMAIL@ADDRESS>, 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 "Overview"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Infrastructure-as-a-Service (IaaS) clouds can be a complex thing to build, and by
definition they have a plethora of options, which often lead to confusion for even experienced
admins who are newcomers to building cloud platforms. The goal for this runbook is to provide
a straightforward set of instructions to get you up and running with CloudStack with a minimum
amount of trouble."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "What exactly are we building?"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "This runbook will focus on building a CloudStack cloud using KVM with CentOS 6.3 with
NFS storage on a flat layer-2 network utilizing layer-3 network isolation (aka Security Groups),
and doing it all on a single piece of hardware."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "KVM, or Kernel-based Virtual Machine is a virtualization technology for the Linux
kernel. KVM supports native virtualization atop processors with hardware virtualization extensions."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Security Groups act as distributed firewalls that control access to a group of virtual
machines."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "High level overview of the process"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Before we actually get to installing CloudStack, we'll start with installing our base
operating system, and then configuring that to act as an NFS server for several types of storage.
We'll install the management server, download the systemVMs, and finally install the agent
software. Finally we'll spend a good deal of time configuring the entire cloud in the CloudStack
web interface."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Prerequisites"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To complete this runbook you'll need the following items:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "At least one computer which supports hardware virtualization."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <ulink url=\"http://mirrors.kernel.org/centos/6.3/isos/x86_64/CentOS-6.3-x86_64-minimal.iso\">
CentOS 6.3 x86_64 minimal install CD </ulink>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "A /24 network with the gateway being at xxx.xxx.xxx.1, no DHCP should be on this network
and none of the computers running CloudStack will have a dynamic address. Again this is done
for the sake of simplicity."
+msgstr ""
+

http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/a352c442/docs/runbook/pot/Preface.pot
----------------------------------------------------------------------
diff --git a/docs/runbook/pot/Preface.pot b/docs/runbook/pot/Preface.pot
new file mode 100644
index 0000000..0f66fc9
--- /dev/null
+++ b/docs/runbook/pot/Preface.pot
@@ -0,0 +1,19 @@
+# 
+# AUTHOR <EMAIL@ADDRESS>, 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 "Preface"
+msgstr ""
+

http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/a352c442/docs/runbook/pot/Revision_History.pot
----------------------------------------------------------------------
diff --git a/docs/runbook/pot/Revision_History.pot b/docs/runbook/pot/Revision_History.pot
new file mode 100644
index 0000000..ee9cb21
--- /dev/null
+++ b/docs/runbook/pot/Revision_History.pot
@@ -0,0 +1,29 @@
+# 
+# AUTHOR <EMAIL@ADDRESS>, 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 "Revision History"
+msgstr ""
+
+#. Tag: member
+#, no-c-format
+msgid "Updating for Apache CloudStack 4.0.1"
+msgstr ""
+
+#. Tag: member
+#, no-c-format
+msgid "Initial creation of book by publican"
+msgstr ""
+

http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/a352c442/docs/runbook/pot/Runbook.pot
----------------------------------------------------------------------
diff --git a/docs/runbook/pot/Runbook.pot b/docs/runbook/pot/Runbook.pot
new file mode 100644
index 0000000..4c57d37
--- /dev/null
+++ b/docs/runbook/pot/Runbook.pot
@@ -0,0 +1,14 @@
+# 
+# AUTHOR <EMAIL@ADDRESS>, 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"
+

http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/a352c442/docs/runbook/pot/config.pot
----------------------------------------------------------------------
diff --git a/docs/runbook/pot/config.pot b/docs/runbook/pot/config.pot
new file mode 100644
index 0000000..28cdb73
--- /dev/null
+++ b/docs/runbook/pot/config.pot
@@ -0,0 +1,219 @@
+# 
+# AUTHOR <EMAIL@ADDRESS>, 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 "Configuration"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "As we noted before we will be using security groups to provide isolation and by default
that implies that we'll be using a flat layer-2 network. It also means that the simplicity
of our setup means that we can use the quick installer."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "UI Access"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To get access to CloudStack's web interface, merely point your browser to http://<replaceable>172.16.10.</replaceable>2:8080/client
The default username is 'admin', and the default password is 'password'. You should see a
splash screen that allows you to choose several options for setting up CloudStack. You should
choose the <option>Continue with Basic Setup</option> option."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You should now see a prompt requiring you to change the password for the admin user.
Please do so."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Setting up a Zone"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "A zone is the largest organization entity in CloudStack - and we'll be creating one,
this should be the screen that you see in front of you now. And for us there are 5 pieces
of information that we need."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Name - we will set this to the ever-descriptive 'Zone1' for our cloud."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Public DNS 1 - we will set this to '8.8.8.8' for our cloud."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Public DNS 2 - we will set this to '8.8.4.4' for our cloud."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Internal DNS1 - we will also set this to '8.8.8.8' for our cloud."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Internal DNS2 - we will also set this to '8.8.8.4' for our cloud."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Notes about DNS settings"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "CloudStack distinguishes between internal and public DNS. Internal DNS is assumed
to be capable of resolving internal-only hostnames, such as your NFS server’s DNS name.
Public DNS is provided to the guest VMs to resolve public IP addresses. You can enter the
same DNS server for both types, but if you do so, you must make sure that both internal and
public IP addresses can route to the DNS server. In our specific case we will not use any
names for resources internally, and we have indeed them set to look to the same external resource
so as to not add a namerserver setup to our list of requirements."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Pod Configuration"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Now that we've added a Zone, the next step that comes up is a prompt for information
regading a pod. Which is looking for 4 items."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Name - We'll use Pod1 for our cloud."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Gateway - We'll use <replaceable>172.16.10</replaceable>.1 as our gateway"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Netmask - We'll use 255.255.255.0"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Start/end reserved system IPs - we will use 172.16.10.10-172.16.10.20"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Guest gateway - We'll use <replaceable>172.16.10</replaceable>.1"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Guest netmask - We'll use 255.255.255.0"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Guest start/end IP - We'll use <replaceable>172.16.10.</replaceable>30-<replaceable>172.16.10.</replaceable>200"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Cluster"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Now that we've added a Zone, we need only add a few more items for configuring the
cluster."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Name - We'll use Cluster1"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Hypervisor - Choose KVM"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You should be prompted to add the first host to your cluster at this point. Only a
few bits of information are needed."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Hostname - we'll use the IP address <replaceable>172.16.10.</replaceable>2
since we didn't set up a DNS server."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Username - we'll use 'root'"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Password - enter the operating system password for the root user"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Primary Storage"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "With your cluster now setup - you should be prompted for primary storage information.
Choose NFS as the storage type and then enter the following values in the fields:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Name - We'll use 'Primary1'"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Server - We'll be using the IP address <replaceable>172.16.10.</replaceable>2"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Path - Well define /primary as the path we are using"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Secondary Storage"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If this is a new zone, you'll be prompted for secondary storage information - populate
it as follows:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "NFS server - We'll use the IP address <replaceable>172.16.10.</replaceable>2"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Path - We'll use /secondary"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Now, click Launch and your cloud should begin setup - it may take several minutes
depending on your internet connection speed for setup to finalize."
+msgstr ""
+

http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/a352c442/docs/runbook/pot/kvm.pot
----------------------------------------------------------------------
diff --git a/docs/runbook/pot/kvm.pot b/docs/runbook/pot/kvm.pot
new file mode 100644
index 0000000..3f7c586
--- /dev/null
+++ b/docs/runbook/pot/kvm.pot
@@ -0,0 +1,229 @@
+# 
+# AUTHOR <EMAIL@ADDRESS>, 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 "KVM Setup and installation"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "KVM is the hypervisor we'll be using - we will recover the initial setup which has
already been done on the hypervisor host and cover installation of the agent software, you
can use the same steps to add additional KVM nodes to your CloudStack environment."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Prerequisites"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "We explicitly are using the management server as a compute node as well, which means
that we have already performed many of the prerequisite steps when setting up the management
server, but we will list them here for clarity. Those steps are:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<xref linkend=\"sect-Runbook-Environment-operatingsys-network\" />"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<xref linkend=\"sect-Runbook-Environment-operatingsys-hostname\" />"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<xref linkend=\"sect-Runbook-Environment-operatingsys-selinux\" />"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<xref linkend=\"sect-Runbook-Environment-operatingsys-ntp\" />"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "<xref linkend=\"sect-Runbook-Environment-operatingsys-repoconfig\" />"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You shouldn't need to do that for the management server, of course, but any additional
hosts will need for you to complete the above steps."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Installation"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Installation of the KVM agent is trivial with just a single command, but afterwards
we'll need to configure a few things."
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<prompt># </prompt><userinput><command>yum</command>
-y install cloud-agent</userinput>"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "KVM Configuration"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "We have two different parts of KVM to configure, libvirt, and QEMU."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "QEMU Configuration"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "KVM configuration is relatively simple at only a single item. We need to edit the
QEMU VNC configuration. This is done by editing <filename>/etc/libvirt/qemu.conf</filename>
and ensuring the following line is present and uncommented."
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "vnc_listen=0.0.0.0"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Libvirt Configuration"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "CloudStack uses libvirt for managing virtual machines. Therefore it is vital that
libvirt is configured correctly. Libvirt is a dependency of cloud-agent and should already
be installed."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "In order to have live migration working libvirt has to listen for unsecured TCP connections.
We also need to turn off libvirts attempt to use Multicast DNS advertising. Both of these
settings are in <filename>/etc/libvirt/libvirtd.conf</filename>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Set the following paramaters:"
+msgstr ""
+
+#. Tag: programlisting
+#, no-c-format
+msgid "listen_tls = 0"
+msgstr ""
+
+#. Tag: programlisting
+#, no-c-format
+msgid "listen_tcp = 1"
+msgstr ""
+
+#. Tag: programlisting
+#, no-c-format
+msgid "tcp_port = \"16059\""
+msgstr ""
+
+#. Tag: programlisting
+#, no-c-format
+msgid "auth_tcp = \"none\""
+msgstr ""
+
+#. Tag: programlisting
+#, no-c-format
+msgid "mdns_adv = 0"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Turning on \"listen_tcp\" in libvirtd.conf is not enough, we have to change the parameters
as well:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "On RHEL or CentOS modify <filename>/etc/sysconfig/libvirtd</filename>:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Uncomment the following line:"
+msgstr ""
+
+#. Tag: programlisting
+#, no-c-format
+msgid "#LIBVIRTD_ARGS=\"--listen\""
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "On Ubuntu: modify <filename>/etc/init/libvirt-bin.conf</filename>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Change the following line (at the end of the file):"
+msgstr ""
+
+#. Tag: programlisting
+#, no-c-format
+msgid "exec /usr/sbin/libvirtd -d"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "to (just add -l)"
+msgstr ""
+
+#. Tag: programlisting
+#, no-c-format
+msgid "exec /usr/sbin/libvirtd -d -l"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Restart libvirt"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "In RHEL or CentOS:"
+msgstr ""
+
+#. Tag: programlisting
+#, no-c-format
+msgid "<command>$ service libvirtd restart</command>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "In Ubuntu:"
+msgstr ""
+
+#. Tag: programlisting
+#, no-c-format
+msgid "<command>$ service libvirt-bin restart</command>"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "KVM configuration complete"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "That concludes our installation and configuration of KVM, and we'll now move to using
the CloudStack UI for the actual configuration of our cloud."
+msgstr ""
+


Mime
View raw message