mirror of
				https://github.com/apache/cloudstack.git
				synced 2025-11-02 20:02:29 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			73 lines
		
	
	
		
			4.0 KiB
		
	
	
	
		
			XML
		
	
	
	
	
	
			
		
		
	
	
			73 lines
		
	
	
		
			4.0 KiB
		
	
	
	
		
			XML
		
	
	
	
	
	
<?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-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 <xref linkend="about-password-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 <optional-management-server-secret-key> -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/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/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 <optional-management-server-secret-key> -F</programlisting>
 | 
						|
        </listitem>
 | 
						|
      </itemizedlist>
 | 
						|
      <para>On Ubuntu, use the following path instead:</para>
 | 
						|
      <programlisting># /usr/lib/cloud/common/scripts/storage/secondary/cloud-install-sys-tmplt</programlisting>
 | 
						|
    </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>
 |