Author: buildbot
Date: Tue Dec 11 20:41:05 2012
New Revision: 841777
Log:
Staging update by buildbot for vcl
Modified:
websites/staging/vcl/trunk/content/ (props changed)
websites/staging/vcl/trunk/content/docs/windowsbaseimagecreation.html
Propchange: websites/staging/vcl/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Dec 11 20:41:05 2012
@@ -1 +1 @@
-1420367
+1420392
Modified: websites/staging/vcl/trunk/content/docs/windowsbaseimagecreation.html
==============================================================================
--- websites/staging/vcl/trunk/content/docs/windowsbaseimagecreation.html
(original)
+++ websites/staging/vcl/trunk/content/docs/windowsbaseimagecreation.html Tue
Dec 11 20:41:05 2012
@@ -21,7 +21,7 @@
<link href="/css/vcl.css" rel="stylesheet" type="text/css">
<link href="/css/code.css" rel="stylesheet" type="text/css">
- <title>Apache VCL - Create a Windows Base Image</title>
+ <title>Apache VCL - Install a Windows Base Image</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
@@ -77,193 +77,106 @@
</div>
<div id="content">
- <h1 class="title">Create a Windows Base Image</h1>
- <p>This page describes how to create a Windows base image.These
instructions should work regardless of the provisioning engine being used
(xCAT, VMware, etc.). Ignore the VMware Only sections if you are attempting to
create an image using xCAT or some other bare metal provisioning engine.</p>
-<h3 id="requirements">Requirements</h3>
-<p>You will need the following:</p>
-<ul>
-<li>Windows installation ISO file</li>
-<li>Windows product key or KMS server address</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 Only:<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>
-<h4 id="vmware-only-create-a-virtual-machine">VMware Only: Create a Virtual
Machine</h4>
-<p><strong>Create a Virtual Machine</strong></p>
-<p><strong>VMware ESXi 4.x</strong></p>
-<p>The instructions assume that VMware has been configured with the following
bridged networks:</p>
-<ul>
-<li>Private: bridged to private interface: eth0</li>
-<li>Public: bridged to public interface: eth1</li>
-<li>Launch the vSphere Client, connect to the ESXi host and login</li>
-<li>Click File > New > Virtual Machine</li>
-<li>Configuration: Custom</li>
-<li>Name: (doesn't matter)</li>
-<li>Select a datastore where the VM will reside</li>
-<li>Virtual Machine Version: 7</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: Private, E1000</li>
-<li>NIC 2: Public, 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 <br />
-</li>
-<li>Connect at power on: Yes</li>
-</ul>
-</li>
-<li>Click Finish</li>
-</ul>
-<p><strong>VMware Server 2.x</strong></p>
-<ul>
-<li>
-<p>Open the VMware Infrastructure Web Access page:</p>
-<ul>
-<li>https://<IP address or hostname>:8333</li>
-</ul>
-</li>
-<li>
-<p>Click the Virtual Machine menu</p>
-</li>
-<li>Select Create Virtual Machine</li>
-<li>Name and Location<ul>
-<li>Name: Windows XP Base</li>
-<li>Datastore: standard (This causes the VM to be created under
/var/lib/vmware/Virtual Machines)</li>
-</ul>
-</li>
-<li>Guest Operating System<ul>
-<li>Operating System: Windows operating system</li>
-<li>Version: Microsoft Windows XP Professional (32-bit)</li>
-<li>Product Compatibility: 4 (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: 1024 MB</li>
-<li>Processor Count: 1</li>
-</ul>
-</li>
-<li>Hard Disk<ul>
-<li>Click Create a New Virtual</li>
-<li>Capacity: at least 20 GB (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<ul>
-<li>Allocate all disk space now: no</li>
-<li>Split disk into 2 GB files: yes </li>
-</ul>
-</li>
-<li>Disk Mode: Independent/Persistent</li>
-</ul>
-</li>
-<li>Network Adapter<ul>
-<li>Click Add a Network Adapter<ul>
-<li>Network Connection: select the name of your private network</li>
-</ul>
-</li>
-</ul>
-</li>
-<li>CD/DVD Drive<ul>
-<li>Click Use an ISO<ul>
-<li>Select the Windows ISO image you copied to the host. The ISO file must
reside in /var/lib/vmware/Virtual Machines 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 Finish</li>
-<li>Select the VM from the Inventory pane</li>
-<li>Click Add Hardware on the right side of the page</li>
-<li>Select Network Adapter<ul>
-<li>Network Connection: select the name of your public network</li>
-</ul>
-</li>
-<li>Click Next > Finish</li>
-</ul>
-<h4 id="install-windows">Install Windows</h4>
-<p><strong>VMware Only: Install VMware Tools</strong></p>
-<ul>
-<li>Power on the VM if it is not already powered on</li>
-<li>Install VMWare Tools (Note: you must have a CD-ROM drive configured for
the VM in order to install VMware Tools)<ul>
-<li>Click on the VM menu and select "Install VMWare Tools"</li>
-<li>Select Typical and proceed through the setup pages accepting the
defaults</li>
-<li>Reboot the VM when installation is complete</li>
+ <h1 class="title">Install a Windows Base Image</h1>
+ <p>This page describes how to mount the Windows installation media and
install Windows for a base image.</p>
+<p><strong>Mount the Installation Media</strong></p>
+<p>The Windows installation media needs to be mounted as a drive on the
computer. The method to do this varies widely based on the provisioning engine
being used and resources available. The following lists some ways to mount the
installation media:</p>
+<p><strong>VMware - Configure the VM to mount the ISO image as a CD-ROM
drive</strong></p>
+<p>Note: these instructions assume a VM has already been created</p>
+<ol>
+<li>Copy the Windows installation ISO file to the VMware host server </li>
+<li>Add a CD-ROM drive which mounts the Windows installation ISO image by
+ editing the virtual machine settings:<ul>
+<li>Connection: <strong>Use ISO image</strong>:</li>
+<li>Browse to path of Windows installation ISO image </li>
+<li>Save the VM configuration</li>
</ul>
</li>
-</ul>
-<h4 id="install-cygwin-sshd">Install Cygwin SSHD</h4>
-<p>Follow the steps: Install & Configure Cygwin SSHD</p>
-<p><strong>Run vcld -setup</strong></p>
+</ol>
+<p><strong>xCAT using IBM Advanced Management Module</strong></p>
<ol>
-<li>
-<p>Run the following command on the management node:</p>
-<p>/usr/local/vcl/bin/vcld -setup</p>
-</li>
-<li>
-<p>Navigate the menu options</p>
-<ul>
-<li>(Note: the names and numbers of the menu items may not match your
installation):</li>
-<li>Select a module to configure: VCL Image State Module</li>
-<li>Choose an operation: Capture Base Image</li>
-<li>Enter the VCL login name or ID of the user who will own the image:</li>
-<li>Enter your VCL user ID or the user ID of the user you want to own the
image. Pressing Enter without entering a user login ID will cause admin to be
the owner of the new base image.</li>
-<li>Enter the hostname or IP address of the computer to be captured:</li>
-<li>Enter the name or private IP address of the computer which has already
added to the VCL database.</li>
-<li>Select the OS to be captured:<ol>
-<li>VMware Linux</li>
-<li>VMware Windows 2003 Server</li>
-<li>VMware Windows 7</li>
-<li>VMware Windows Server 2008</li>
-<li>VMware Windows Vista</li>
-<li>VMware Windows XP</li>
+<li>Copy the Windows installation ISO file to the management node</li>
+<li>Determine the IP address or hostname of the IBM Advanced Management Module
(AMM) for the BladeCenter chassis which contains the blade you are
installing</li>
+<li>Open a web browser and enter the AMM's address</li>
+<li>Log in to the AMM</li>
+<li>Select Inactive session timeout value: no timeout</li>
+<li>Click Start New Session</li>
+<li>Click Remote Control</li>
+<li>Click Start Remote Control</li>
+<li>Set the Media Tray and KVM dropdown menus to the blade you are
installing</li>
+<li>Click Select Image and click the arrow button to the right of it</li>
+<li>Navigate to the Windows installation ISO file which was saved to the
management node and click Open
+ 12 . Click Mount All</li>
</ol>
-</li>
-<li>Image architecture:<ol>
-<li>x86</li>
-<li>x86_64</li>
+<p><strong>Boot to the Windows Installation CD or DVD</strong></p>
+<ol>
+<li>Power on the computer</li>
+<li>Press the key to display the boot menu as soon as the computer's POST
screen is displayed (usually F12 for bare metal blades or ESC for VMware)</li>
+<li>Boot from the CD-ROM drive</li>
+<li>Press a key to boot from the CD (this may be displayed at bottom of screen
as soon as the computer begins to boot)</li>
</ol>
-</li>
-<li>Use Sysprep:<ol>
-<li>Yes</li>
-<li>No</li>
-<li>Sysprep is usually only required if the image will be loaded on bare metal
computers with varying different hardware.</li>
+<p><strong>Install Windows</strong></p>
+<p>The Windows installation sequence varies by version. The next 2 sections
describe the recommended answers for Windows XP and Windows 7.</p>
+<p><strong>Windows XP Installation</strong></p>
+<ol>
+<li>Press Enter to setup up Windows XP now</li>
+<li>Press F8 to agree to the license agreement</li>
+<li>Configure the Windows partition
+ Press Enter to set up Windows XP on the selected item (should be
called "Unpartitioned space")
+ Format the partition using the NTFS file system (Quick)</li>
+<li>Region and Language Options - click Next</li>
+<li>Name: VCL</li>
+<li>Organization: Apache.org</li>
+<li>Enter your Windows XP product key</li>
+<li>Computer name: (doesn't matter)</li>
+<li>Administrator password: (doesn't matter, but it's recommended that
password should match the WINDOWS_ROOT_PASSWORD setting in
/etc/vcl/vcld.conf)</li>
+<li>Select the timezone</li>
+<li>Networking settings: Typical</li>
+<li>Member of a domain: No, leave default workgroup settings</li>
+<li>Automatic updates: Not right now</li>
+<li>Connect to Internet: Skip</li>
+<li>Register: no</li>
+<li>User name: root
+ Windows XP setup should finish and the root account created during
installation should automatically log on</li>
+<li>Once the desktop appears, set root's password via the Windows GUI or by
executing the following command from a command prompt:
+net user root <password></li>
</ol>
-</li>
-<li>Enter the name of the image to be captured: <ul>
-<li>The name you enter is the name that will be displayed in the list of
environments. It may contain spaces but including other special characters is
not recommended.</li>
-</ul>
-</li>
-</ul>
-</li>
+<p><strong>Windows 7 Installation</strong></p>
+<ol>
+<li>Enter the regional information:
+Language to install: English
+Time and currency format: English (United States)
+Keyboard or input method: US</li>
+<li>Click Next</li>
+<li>Click Install now
+ Setup is starting...</li>
+<li>Click the checkbox next to "I accept the license terms"</li>
+<li>Click Next</li>
+<li>Click Custom (advanced)</li>
+<li>On the "Where do you want to install Windows?" page, delete all existing
partitions and create a new partition using all of the available space:
+ Click Drive options (advanced)
+ Click Delete, then click OK to confirm
+ Click New
+ Click Apply (the size should be set to the maximum amount available
+ To ensure that all Windows features work correctly, Windows might create
additional partitions for system files.
+ Click OK</li>
+<li>Click Next
+ Installing Windows...
+ Windows restarts
+ Starting Windows
+ Setup is updating registry settings</li>
+<li>A screen titled "Set Up Windows" appears:
+ Type a user name: root
+ Type a computer name: it's best to name the computer after the OS
(Example: win7sp1-ent)</li>
+<li>Enter a password, password hint, and click Next</li>
+<li>Help protect your computer and improve Windows automatically: Ask me
later</li>
+<li>Select a time zone, set the correct time, and click Next
+ Windows is finalizing your settings
+ Preparing your desktop
+ Desktop appears</li>
+<li>If asked to set a network location, choose Work network
+ <em>The root account logs in...</em></li>
</ol>
-<p>The following happens once you enter an image name and press enter:</p>
-<ul>
-<li>A new image is added to the VCL database</li>
-<li>An imaging request is added to the VCL database</li>
-<li>The vcld -setup automatically initiates 'tail -f /var/log/vcld.log' to
monitor the vcld log file. The output should be displayed on the screen.</li>
-</ul>
-<p>Watch the vcld logfile output to determine if the image capture process is
successful or terminated because a problem occurred. When the capture process
terminates, there will either be a message near the end of the output saying
"image capture successful" or there will be several WARNING messages, the last
of which says something to the effect "image failed to be captured". Further
troubleshooting is required if the image fails to be captured.</p>
-<h4 id="add-the-base-image-to-an-image-group">Add the Base Image to an Image
Group</h4>
-<p>The vcld -setup utility does not add the new base image to any image
groups. You must add the image to an image group using the VCL website after
the image capture process is complete. Reservations for the image cannot be
made until this is done. To add the image to an image group, browse to the VCL
website and select Manage Images > Edit Image Grouping.</p>
</div>
<div id="footer">
