You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@vcl.apache.org by bu...@apache.org on 2012/12/11 20:33:26 UTC

svn commit: r841766 - in /websites/staging/vcl/trunk/content: ./ docs/baseimagecreation.html

Author: buildbot
Date: Tue Dec 11 19:33:26 2012
New Revision: 841766

Log:
Staging update by buildbot for vcl

Added:
    websites/staging/vcl/trunk/content/docs/baseimagecreation.html
Modified:
    websites/staging/vcl/trunk/content/   (props changed)

Propchange: websites/staging/vcl/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Dec 11 19:33:26 2012
@@ -1 +1 @@
-1420310
+1420353

Added: websites/staging/vcl/trunk/content/docs/baseimagecreation.html
==============================================================================
--- websites/staging/vcl/trunk/content/docs/baseimagecreation.html (added)
+++ websites/staging/vcl/trunk/content/docs/baseimagecreation.html Tue Dec 11 19:33:26 2012
@@ -0,0 +1,219 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+    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.
+-->
+
+  <link href="/css/vcl.css" rel="stylesheet" type="text/css">
+  <link href="/css/code.css" rel="stylesheet" type="text/css">
+  <title>Apache VCL - Creating Base Images from an ISO</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+</head>
+
+<body>
+  <div id="sitetitle">
+    <table width="100%" border="0" cellspacing="0" cellpadding="5">
+      <tr>
+         <td><a href="/index.html"><img src="/img/vcl-logo.png" height="100" align="left" alt="Apache VCL logo"></a></td>
+         <td><a href="http://www.apache.org"><img src="/img/asf-logo.png" align="right" alt="Apache Software Foundation logo"></a></td>
+      </tr>
+    </table>
+  </div>
+
+  <div id="navigation"> 
+  <ul>
+<li>Information<ul>
+<li><a href="/info/about.html">What is VCL?</a></li>
+<li><a href="/info/features.html">Features</a></li>
+<li><a href="/info/architecture.html">Architecture</a></li>
+<li><a href="/info/use-cases.html">Use Cases</a></li>
+<li><a href="/downloads/download.cgi">Download</a></li>
+<li><a href="http://www.apache.org/licenses/LICENSE-2.0.html">License</a></li>
+<li><a href="/info/faq.html">FAQ</a></li>
+</ul>
+</li>
+<li><a href="/docs/index.html">Documentation</a><ul>
+<li><a href="/docs/using-vcl.html">Using VCL</a></li>
+<li><a href="/docs/image-creation.html">Image Creation</a></li>
+<li><a href="/docs/administration.html">Administration</a></li>
+<li><a href="/docs/installation.html">Installation</a></li>
+<li><a href="/docs/deployment-planning.html">Deployment Planning</a></li>
+</ul>
+</li>
+<li><a href="/comm/index.html">Community</a><ul>
+<li><a href="/comm/index.html#getInvolved">Getting Involved</a></li>
+<li><a href="/comm/index.html#mail-list">Mailing Lists</a></li>
+<li><a href="/comm/index.html#how-do-i-join-the-project">How can I Join</a></li>
+<li><a href="/comm/wiki.html">Wiki</a></li>
+<li><a href="/dev/index.html">Development</a><ul>
+<li><a href="/dev/jira.html">Issue Tracking</a></li>
+<li><a href="/dev/code-documentation.html">Code Documentation</a></li>
+<li><a href="/dev/roadmap.html">Roadmap</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="http://www.apache.org">Apache Software Foundation</a><ul>
+<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+<li><a href="http://www.apache.org/foundation/sponsorship.html">Become a Sponsor</a></li>
+</ul>
+</li>
+</ul>
+  </div>
+  
+  <div id="content">
+    <h1 class="title">Creating Base Images from an ISO</h1>
+    <p>This page describes how to create a base image from an install media. These instructions are broken up into specific provisioning modules for (xCAT, VMware, and KVM).</p>
+<div class="toc">
+<ul>
+<li><a href="#requirements">Requirements</a></li>
+</ul>
+</div>
+<h3 id="requirements">Requirements</h3>
+<p>You will need the following:</p>
+<ul>
+<li>A working VCL web,database, and management node</li>
+<li>A Hypervisor either VMWare or KVM</li>
+<li>Install media</li>
+<li>Appropriate licensing for Windows or RedHat</li>
+</ul>
+<p>The following must be done before an image can be captured:</p>
+<ul>
+<li>A computer for the machine being captured has already been added to the VCL database</li>
+<li>VMware or KVM:<ul>
+<li>A VM host computer on which the guest is running as been added to the VCL database</li>
+<li>The guest VM has been assigned to the VM host via the Virtual Hosts link on the VCL website</li>
+</ul>
+</li>
+</ul>
+<p>These instructions assume you have root access and are using a bash shell.</p>
+<h1 id="VMware ESXi 4.x"><strong>VMware ESXi 4.x</strong></h1>
+<p>The instructions assume that VMware has been configured with the following bridged networks:</p>
+<ul>
+<li><strong>Private</strong>: bridged to private interface: eth0</li>
+<li>
+<p><strong>Public</strong>: bridged to public interface: eth1</p>
+</li>
+<li>
+<p>Launch the vSphere Client, connect to the ESXi host and login</p>
+</li>
+<li>Click File &gt; New &gt; Virtual Machine</li>
+<li>Configuration: <strong>Custom</strong></li>
+<li>Name: (doesn't matter)</li>
+<li>Select a datastore where the VM will reside</li>
+<li>Virtual Machine Version: <strong>7</strong></li>
+<li>Select the appropriate guest OS</li>
+<li>Number of virtual processors: 1</li>
+<li>Memory: 1GB</li>
+<li>How many NICs: 2<ul>
+<li>NIC 1: <strong>Private</strong>, E1000</li>
+<li>NIC 2: <strong>Public</strong>, E1000</li>
+</ul>
+</li>
+<li>SCSI controller: LSI Logic Parallel</li>
+<li>Create a new virtual disk<ul>
+<li>Disk Size: at least 30 GB</li>
+<li>Allocate and commit space on demand (Thin Provisioning): Yes</li>
+<li>Location: Store with the virtual machine</li>
+<li>Virtual Device Node: SCSI (0:0)</li>
+<li>Mode: Independent, Persistent</li>
+</ul>
+</li>
+<li>Edit the virtual machine settings before completion: Yes</li>
+<li>Select the CD/DVD device<ul>
+<li>Device Type: Datastore ISO File</li>
+<li>Click Browse and browse to an ISO file that has previously been copied to the datastore</li>
+<li>Connect at power on: Yes</li>
+</ul>
+</li>
+<li>Click Finish</li>
+</ul>
+<h1 id="VMware Server 2.x"><strong>VMware Server 2.x</strong></h1>
+<ul>
+<li>Open the VMware Infrastructure Web Access page:
+         https://<IP address or hostname>:8333</li>
+<li>Click the <strong>Virtual Machine</strong> menu</li>
+<li>Select Create <strong>Virtual Machine</strong></li>
+<li>Name and Location<ul>
+<li>Name: <strong>Windows XP Base</strong></li>
+<li>Datastore: <strong>standard</strong> (This causes the VM to be created under /var/lib/vmware/Virtual Machines)</li>
+</ul>
+</li>
+<li>Guest Operating System<ul>
+<li>Operating System: <strong>Windows operating system</strong></li>
+<li>Version: <strong>Microsoft Windows XP Professional (32-bit)</strong></li>
+<li>Product Compatibility: <strong>4</strong> (Optional - the hardware version can be set to the default value of 7 if you do not have any older VMware Server 1.x hosts in your environment)</li>
+</ul>
+</li>
+<li>Memory and Processors<ul>
+<li>Memory Size: <strong>1024 MB</strong></li>
+<li>Processor Count: <strong>1</strong></li>
+</ul>
+</li>
+<li>Hard Disk<ul>
+<li>Click <strong>Create a New Virtual</strong><ul>
+<li>Capacity: at least <strong>20 GB</strong> (This value can be adjusted to suit the size of the VMware host's disk. It is best to create the base image with a large enough hard drive to accomodate your largest image. The hard drive of a VM can be expanded but it is a manual, time-consuming process.)</li>
+<li>File Options
+         - Allocate all disk space now: no
+         - Split disk into 2 GB files: yes</li>
+<li>Disk Mode: <strong>Independent/Persistent</strong></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>Network Adapter<ul>
+<li>Click <strong>Add a Network Adapter</strong>
+        - Network Connection: select the name of your <strong>private</strong> network</li>
+</ul>
+</li>
+<li>CD/DVD Drive<ul>
+<li>Click <strong>Use an ISO</strong><ul>
+<li>Select the Windows ISO image you copied to the host. The ISO file must reside in <strong>/var/lib/vmware/Virtual Machines</strong> in order to be able to select it from this interface.</li>
+</ul>
+</li>
+</ul>
+</li>
+<li>Don't Add a Floppy Drive</li>
+<li>Don't Add a USB</li>
+<li>Click <strong>Finish</strong></li>
+<li>Select the VM from the Inventory pane</li>
+<li>Click <strong>Add Hardware</strong> on the right side of the page</li>
+<li>Select <strong>Network Adapter</strong><ul>
+<li>Network Connection: select the name of your <strong>public</strong> network</li>
+</ul>
+</li>
+<li>Click Next &gt; <strong>Finish</strong></li>
+</ul>
+<h1 id="KVM "><strong>KVM</strong></h1>
+<h1 id="xCAT"><strong>Bare Metal via xCAT</strong></h1>
+<p>The requirement in this section is to have a working xCAT system.</p>
+  </div>
+  
+  <div id="footer">
+    <div class="copyright">
+      <p>
+        Copyright &copy; 2012 The Apache Software Foundation, Licensed under 
+        the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+        <br />
+        Apache and the Apache feather logo are trademarks of The Apache Software Foundation.
+      </p>
+    </div>
+  </div>
+  
+</body>
+</html>