|
| 1 | +<?xml version='1.0' encoding='utf-8' ?> |
| 2 | +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "file:///C:/Program%20Files%20(x86)/Publican/DocBook_DTD/docbookx.dtd" [ |
| 3 | +<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> |
| 4 | +%BOOK_ENTITIES; |
| 5 | +]> |
| 6 | + |
| 7 | +<!-- Licensed to the Apache Software Foundation (ASF) under one |
| 8 | + or more contributor license agreements. See the NOTICE file |
| 9 | + distributed with this work for additional information |
| 10 | + regarding copyright ownership. The ASF licenses this file |
| 11 | + to you under the Apache License, Version 2.0 (the |
| 12 | + "License"); you may not use this file except in compliance |
| 13 | + with the License. You may obtain a copy of the License at |
| 14 | + |
| 15 | + http://www.apache.org/licenses/LICENSE-2.0 |
| 16 | + |
| 17 | + Unless required by applicable law or agreed to in writing, |
| 18 | + software distributed under the License is distributed on an |
| 19 | + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| 20 | + KIND, either express or implied. See the License for the |
| 21 | + specific language governing permissions and limitations |
| 22 | + under the License. |
| 23 | +--> |
| 24 | + |
| 25 | +<section id="prepare-system-vm-template"> |
| 26 | + <title>Prepare the System VM Template</title> |
| 27 | + <para>Secondary storage must be seeded with a template that is used for &PRODUCT; system VMs.</para> |
| 28 | + <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> |
| 29 | + <orderedlist> |
| 30 | + <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> |
| 31 | + <para>If your secondary storage mount point is not named /mnt/secondary, substitute your own mount point name.</para> |
| 32 | + <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> |
| 33 | + <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> |
| 34 | + <itemizedlist> |
| 35 | + <listitem><para>For XenServer:</para> |
| 36 | + <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> |
| 37 | + </listitem> |
| 38 | + <listitem><para>For vSphere:</para> |
| 39 | + <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.ova -h vmware -s <optional-management-server-secret-key> -F</programlisting> |
| 40 | + </listitem> |
| 41 | + <listitem><para>For KVM:</para> |
| 42 | + <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> |
| 43 | + </listitem> |
| 44 | + </itemizedlist> |
| 45 | + </listitem> |
| 46 | + <listitem><para>If you are using a separate NFS server, perform this step. If you are using the Management |
| 47 | + Server as the NFS server, you MUST NOT perform this step.</para> |
| 48 | + <para>When the script has finished, unmount secondary storage and remove the created directory.</para> |
| 49 | + <programlisting> |
| 50 | +# umount /mnt/secondary |
| 51 | +# rmdir /mnt/secondary |
| 52 | + </programlisting> |
| 53 | + </listitem> |
| 54 | + <listitem><para>Repeat these steps for each secondary storage server.</para> |
| 55 | + </listitem> |
| 56 | + </orderedlist> |
| 57 | +</section> |
0 commit comments