cloudstack/docs/tmp/en-US/html/working-with-iso.html

126 lines
10 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>10.11. Working with ISOs</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Apache_CloudStack-Admin_Guide-4.0.0-incubating-en-US-1-" /><link rel="home" href="index.html" title="CloudStack Administrator's Guide" /><link rel="up" href="virtual-machines.html" title="Chapter 10. Working With Virtual Machines" /><link rel="prev" href="deleting-vms.html" title="10.10. Deleting VMs" /><link rel="next" href="working-with-hosts.html" title="Chapter 11. Working With Hosts" /></head><body><p id="title"><a class="left" href="http://cloudstack.org"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="http://docs.cloudstack.org"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="deleting-vms.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="working-with-hosts.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="working-with-iso" lang="en-US"><div class="titlepage"><div><div><h2 class="title" id="working-with-iso">10.11. Working with ISOs</h2></div></div></div><div class="para">
CloudStack supports ISOs and their attachment to guest VMs. An ISO is a read-only file that has an ISO/CD-ROM style file system. Users can upload their own ISOs and mount them on their guest VMs.
</div><div class="para">
ISOs are uploaded based on a URL. HTTP is the supported protocol. Once the ISO is available via HTTP specify an upload URL such as http://my.web.server/filename.iso.
</div><div class="para">
ISOs may be public or private, like templates.ISOs are not hypervisor-specific. That is, a guest on vSphere can mount the exact same image that a guest on KVM can mount.
</div><div class="para">
ISO images may be stored in the system and made available with a privacy level similar to templates. ISO images are classified as either bootable or not bootable. A bootable ISO image is one that contains an OS image. CloudStack allows a user to boot a guest VM off of an ISO image. Users can also attach ISO images to guest VMs. For example, this enables installing PV drivers into Windows. ISO images are not hypervisor-specific.
</div><div xml:lang="en-US" class="section" id="add-iso" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="add-iso">10.11.1. Adding an ISO</h3></div></div></div><div class="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.
</div><div class="orderedlist"><ol><li class="listitem"><div class="para">
Log in to the CloudStack UI as an administrator or end user.
</div></li><li class="listitem"><div class="para">
In the left navigation bar, click Templates.
</div></li><li class="listitem"><div class="para">
In Select View, choose ISOs.
</div></li><li class="listitem"><div class="para">
Click Add ISO.
</div></li><li class="listitem"><div class="para">
In the Add ISO screen, provide the following:
</div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
<span class="bold bold"><strong>Name</strong></span>: Short name for the ISO image. For example, CentOS 6.2 64-bit.
</div></li><li class="listitem"><div class="para">
<span class="bold bold"><strong>Description</strong></span>: Display test for the ISO image. For example, CentOS 6.2 64-bit.
</div></li><li class="listitem"><div class="para">
<span class="bold bold"><strong>URL</strong></span>: 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
</div></li><li class="listitem"><div class="para">
<span class="bold bold"><strong>Zone</strong></span>: Choose the zone where you want the ISO to be available, or All Zones to make it available throughout CloudStack.
</div></li><li class="listitem"><div class="para">
<span class="bold bold"><strong>Bootable</strong></span>: 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.
</div></li><li class="listitem"><div class="para">
<span class="bold bold"><strong>OS Type</strong></span>: This helps CloudStack and the hypervisor perform certain operations and make assumptions that improve the performance of the guest. Select one of the following.
</div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
If the operating system of your desired ISO image is listed, choose it.
</div></li><li class="listitem"><div class="para">
If the OS Type of the ISO is not listed or if the ISO is not bootable, choose Other.
</div></li><li class="listitem"><div class="para">
(XenServer only) If you want to boot from this ISO in PV mode, choose Other PV (32-bit) or Other PV (64-bit)
</div></li><li class="listitem"><div class="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:
</div><div class="informaltable"><table border="1"><colgroup><col width="33%" /><col width="33%" /><col width="33%" /></colgroup><tbody><tr><td align="left">
<div class="para">
Fedora 13
</div>
</td><td align="left">
<div class="para">
Fedora 12
</div>
</td><td align="left">
<div class="para">
Fedora 11
</div>
</td></tr><tr><td align="left">
<div class="para">
Fedora 10
</div>
</td><td align="left">
<div class="para">
Fedora 9
</div>
</td><td align="left">
<div class="para">
Other PV
</div>
</td></tr><tr><td align="left">
<div class="para">
Debian GNU/Linux
</div>
</td><td align="left">
<div class="para">
CentOS 5.3
</div>
</td><td align="left">
<div class="para">
CentOS 5.4
</div>
</td></tr><tr><td align="left">
<div class="para">
CentOS 5.5
</div>
</td><td align="left">
<div class="para">
Red Hat Enterprise Linux 5.3
</div>
</td><td align="left">
<div class="para">
Red Hat Enterprise Linux 5.4
</div>
</td></tr><tr><td align="left">
<div class="para">
Red Hat Enterprise Linux 5.5
</div>
</td><td align="left">
<div class="para">
Red Hat Enterprise Linux 6
</div>
</td><td align="left">
</td></tr></tbody></table></div></li></ul></div><div class="note"><div class="admonition_header"><h2>Note</h2></div><div class="admonition"><div class="para">
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.
</div></div></div></li><li class="listitem"><div class="para">
<span class="bold bold"><strong>Extractable</strong></span>: Choose Yes if the ISO should be available for extraction.
</div></li><li class="listitem"><div class="para">
<span class="bold bold"><strong>Public</strong></span>: Choose Yes if this ISO should be available to other users.
</div></li><li class="listitem"><div class="para">
<span class="bold bold"><strong>Featured</strong></span>: 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.
</div></li></ul></div></li><li class="listitem"><div class="para">
Click OK.
</div><div class="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.
</div></li><li class="listitem"><div class="para">
<span class="bold bold"><strong>Important</strong></span>: 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 CloudStack can work with it.
</div></li></ol></div></div><div xml:lang="en-US" class="section" id="attach-iso-to-vm" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="attach-iso-to-vm">10.11.2. Attaching an ISO to a VM</h3></div></div></div><div class="orderedlist"><ol><li class="listitem"><div class="para">
In the left navigation, click Instances.
</div></li><li class="listitem"><div class="para">
Choose the virtual machine you want to work with.
</div></li><li class="listitem"><div class="para">
Click the Attach ISO button
<span class="inlinemediaobject"><img src="./images/iso-icon.png" alt="iso.png: Depicts adding an iso image" /></span>
</div></li><li class="listitem"><div class="para">
In the Attach ISO dialog box, select the desired ISO.
</div></li><li class="listitem"><div class="para">
Click OK
</div></li></ol></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="deleting-vms.html"><strong>Prev</strong>10.10. Deleting VMs</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="working-with-hosts.html"><strong>Next</strong>Chapter 11. Working With Hosts</a></li></ul></body></html>