mirror of
https://github.com/apache/cloudstack.git
synced 2025-10-26 08:42:29 +01:00
92 lines
6.9 KiB
XML
92 lines
6.9 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="add-iso">
|
|
<title>Adding an ISO</title>
|
|
<para>To make additional operating system or other software available for use with guest VMs, you can add an ISO. The ISO is typically thought of as an operating system image, but you can also add ISOs for other types of software, such as desktop applications that you want to be installed as part of a template.</para>
|
|
<orderedlist>
|
|
<listitem><para>Log in to the &PRODUCT; UI as an administrator or end user.</para></listitem>
|
|
<listitem><para>In the left navigation bar, click Templates.</para></listitem>
|
|
<listitem><para>In Select View, choose ISOs.</para></listitem>
|
|
<listitem><para>Click Add ISO.</para></listitem>
|
|
<listitem><para>In the Add ISO screen, provide the following:</para>
|
|
<itemizedlist>
|
|
<listitem><para>Name. Short name for the ISO image. (E.g. CentOS 6.2 64 bit).</para></listitem>
|
|
<listitem><para>Description. Display test for the ISO image. (E.g. CentOS 6.2 64 bit).</para></listitem>
|
|
<listitem><para>URL. The URL that hosts the ISO image. The Management Server must be able to access this location via HTTP. If needed you can place the ISO image directly on the Management Server</para></listitem>
|
|
<listitem><para>Zone. Choose the zone where you want the ISO to be available, or All Zones to make it available throughout &PRODUCT;.</para></listitem>
|
|
<listitem><para>Bootable. Whether or not a guest could boot off this ISO image. For example, a CentOS ISO is bootable, a Microsoft Office ISO is not bootable.</para></listitem>
|
|
<listitem><para>OS Type. This helps &PRODUCT; and the hypervisor perform certain operations and make assumptions that improve the performance of the guest. Select one of the following.</para>
|
|
<itemizedlist>
|
|
<listitem><para>If the operating system of your desired ISO image is listed, choose it.</para></listitem>
|
|
<listitem><para>If the OS Type of the ISO is not listed or if the ISO is not bootable, choose Other.</para></listitem>
|
|
<listitem><para>(XenServer only) If you want to boot from this ISO in PV mode, choose Other PV (32-bit) or Other PV (64-bit)</para></listitem>
|
|
<listitem><para>(KVM only) If you choose an OS that is PV-enabled, the VMs created from this ISO will have a SCSI (virtio) root disk. If the OS is not PV-enabled, the VMs will have an IDE root disk. The PV-enabled types are:</para>
|
|
<informaltable>
|
|
<tgroup cols="3" align="left" colsep="1" rowsep="1">
|
|
<tbody>
|
|
<row>
|
|
<entry><para>Fedora 13</para></entry>
|
|
<entry><para>Fedora 12</para></entry>
|
|
<entry><para>Fedora 11</para></entry>
|
|
|
|
</row>
|
|
<row>
|
|
<entry><para>Fedora 10</para></entry>
|
|
<entry><para>Fedora 9</para></entry>
|
|
<entry><para>Other PV</para></entry>
|
|
|
|
</row>
|
|
<row>
|
|
<entry><para>Debian GNU/Linux</para></entry>
|
|
<entry><para>CentOS 5.3</para></entry>
|
|
<entry><para>CentOS 5.4</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para>CentOS 5.5</para></entry>
|
|
<entry><para>Red Hat Enterprise Linux 5.3</para></entry>
|
|
<entry><para>Red Hat Enterprise Linux 5.4</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para>Red Hat Enterprise Linux 5.5</para></entry>
|
|
<entry><para>Red Hat Enterprise Linux 6</para></entry>
|
|
<entry></entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable></listitem>
|
|
</itemizedlist>
|
|
<note><para>Note: It is not recommended to choose an older version of the OS than the version in the image. For example, choosing CentOS 5.4 to support a CentOS 6.2 image will usually not work. In these cases, choose Other.</para></note>
|
|
</listitem>
|
|
<listitem><para>Extractable. Choose Yes if the ISO should be available for extraction.</para></listitem>
|
|
<listitem><para>Public. Choose Yes if this ISO should be available to other users.</para></listitem>
|
|
<listitem><para>Featured. Choose Yes if you would like this ISO to be more prominent for users to select. The ISO will appear in the Featured ISOs list. Only an administrator can make an ISO Featured.</para></listitem>
|
|
</itemizedlist></listitem>
|
|
<listitem><para>Click OK.</para>
|
|
<para>The Management Server will download the ISO. Depending on the size of the ISO, this may take a long time. The ISO status column will display Ready once it has been successfully downloaded into secondary storage. Clicking Refresh updates the download percentage.</para>
|
|
</listitem>
|
|
<listitem><para><emphasis role="bold">Important</emphasis>: Wait for the ISO to finish downloading. If you move on to the next task and try to use the ISO right away, it will appear to fail. The entire ISO must be available before &PRODUCT; can work with it</para></listitem>
|
|
</orderedlist>
|
|
</section>
|