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 21:41:06 UTC

svn commit: r841777 - in /websites/staging/vcl/trunk/content: ./ docs/windowsbaseimagecreation.html

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 &gt; New &gt; 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 &gt; 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 &amp; 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 &gt; Edit Image Grouping.</p>
   </div>
   
   <div id="footer">