isabella232 / cf-glazier

Repository containing scripts used for creating windows images.

Glazier

Summary

A collection of scripts used for building Windows images for Helion Open Stack. The output image can be configured based on a glazier-profile. Documentation can be found here.

Arguments

Syntax: create-glazier

Available options:
--windows-iso /path/to/windows_iso_kit		
	- specifies the location of the Windows iso image
    
--sql-server-iso /path/to/sqlserver_iso_kit	
	- specifies the location of the SQLServer iso image
    	
--virtio-iso /path/to/virtio_iso_kit		
	- specifies the path to the virtual drivers iso image

--hypervisor {kvm|esxi|kvmforesxi}
	- specifies which hypervisor to use. Valid options are "kvm", "esxi" or "kvmforesxi". By default it uses kvm
    	
--profile PATH					            
	- path to a glazier profile directory.Can be used multiple times. At leaset one profile is mandatory.
    	
--vm-path PATH					            
	- (optional) path to a directory where VBox files will be saved. The default is ~/.glazier
    
--with-sql-server {none|2012|2014}		
	- if this is set, you also have to set --sql-server-iso
    	
--product-key KEY				
	- Windows product key
    
--dry-run					
	- run but don't make any changes
    
--verbosity verbosity_level			
	- verbosity level is an interger between 1-3, with 1 being the least verbose and 3 being the most verbose
    
--use-colors {yes|no}				
	- should the script display colors or not

--os-network-id
	- network id used for building the OpenStack image

--os-key-name
	- name of the key used for building the OpenStack image

--os-security-group
	- security group used for building the OpenStack image

--os-flavor
	- name flavor used for buildig the OpenStack image

--help						
	- shows this message

Prerequisites

OSX

• Virtual box 4.3.26
• Windows 2012 R2 image
• Windows VirtIO Image 0.1.96
• VMware guest tools for ESXi hypervisor

Ubuntu

• Virtual box 4.3.10 or later
• Windows 2012 R2 image
• Windows VirtIO Image 0.1.96
• VMware guest tools for ESXi hypervisor

##Hypervisor support

###KVM

• KVM hypervisor is the virtualization layer in Kernel-based virtual machine. It is an open source hypervisor which can run multiple operating systems as guests, like : BSD, Solaris, Windows, Haiku, Plan9 and others
• This is the default hypervisor for glazier.
• Needs the --virtio-iso parameter to point to a supported virtio iso (https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/archive-virtio/virtio-win-0.1.96/virtio-win-0.1.96.iso)
• This will install the drivers found in virtio-win-VERSION.iso
• The generated Windows image format will be qcow2

###ESXi

• ESXi is a closed source hypervisor, made by VMware
• Need to specify "--hypervisor esxi" to create-glazier
• The parameter --virtio-iso needs to point to a VMware Guest Tools iso. You can download it here : https://packages.vmware.com/tools/esx/6.0p01/windows/x64/VMware-tools-windows-9.10.1-2791197.iso
• This will install the drivers found in VMware-tools-windows-VERSION.iso as well as VMware guest tools
• The generated Windows image format will be vmdk

###KVM for ESXi

• This is for advanced users only. It can be used to generate images compatible with both ESXi and KVM
• It installs the VMware drivers but no VMware guest tools. It also installs virtio drivers.
• The iso specified with --virtio-iso needs to be a combination of the content of virtio-win-VERSION.iso and VMware-tools-windows-VERSION.iso. The easyest way to do this, is to download both isos, mount them and then copy their content in an empty folder. You should make an iso with the content of that folder. Each operating system has its own tools to accomplish this.
• The generated Windows image format will be qcow2

Usage

To use the script you need to have the OpenStack environment variables set up:

• OS_TENANT_NAME
• OS_USERNAME
• OS_PASSWORD
• OS_REGION_NAME
• OS_TENANT_ID
• OS_REGION_NAME
• OS_AUTH_URL

Optionally, you can also point the environment variable OS_CACERT to a local file containing the SSL certificate. You need to set the value of the variable to the path of the certificate.

Clone the repository:

git clone [email protected]:hpcloud/cf-glazier.git

Run dry-run to check your parameters:

Step 1. Create the glazier Virtual Machine

cd cf-glazier
./create-glazier --windows-iso <path to windows iso> --virtio-iso <path to VirtIO iso> --product-key <Windows Product Key> --os-network-id <os network ID> --os-key-name <os region name> --os-security-group <os security group> --os-flavor <os flavor name> --profile <path to profile dir> --dry-run

Create the glazier Virtual Machine.

./create-glazier --windows-iso <path to windows iso> --virtio-iso <path to VirtIO iso> --product-key <Windows Product Key> --os-network-id <os network ID> --os-key-name <os region name> --os-security-group <os security group> --os-flavor <os flavor name> --profile <path to profile dir>

Step 2. Create the Image

On the glazier VM run the following command:

New-Image -name "myimage" -GlazierProfilePath "PROFILE"

Step 3. Initialize image

On the glazier VM run the following command:

Initialize-Image -Qcow2ImagePath "c:\workspace\<qcow filename>" -ImageName "my-windows-image"

The is printed after Step 2 is done.

Step 4. Push Resources

This step is only needed when the user wants to update the binaries of the profile.

On the glazier VM run the following command:

Push-Resources -GlazierProfilePath "PROFILE" -SnapshotImageName "my-windows-image"