Previous Topic: HyperThreading and AppLogicNext Topic: MAC Addresses - How Applogic Generates Them


Importing VMware OVA files into an AppLogic Grid

Utilities Used: ovfexport.sh and image2class

Machines Utilized: Backbone Fabric Controller and Grid Controller

  1. Download and install the latest OVF Linux VMWare Utility onto the BFC.
    http://www.vmware.com/resources/techresources/1013
    
  2. Make sure there is enough space on the BFC before running the next command. An additional drive or more space may need to be added to the BFC depending on the size of the machine being exported.
  3. Run the following command on the BFC:
    /opt/bfc/applogic_versions/3.0.30/ovfexport.sh vi://192.168.32.130/INFRA01 INFRA01
    

    The address in the URL is the address of the ESX or vCenter host, and INFRA01 is the name of the machine as listed in ESX or vCenter; in this case it is an ESX host. The last INFRA01 is the name of the resultant .ova file which will be INFRA01.ova.

    The following is an additional example utilizing a copy of a VMware machine copied to the BFC:

    root@BFC media2# /opt/bfc/applogic_versions/3.0.30/ovfexport.sh ITDCA01/ITDCA01.vmx ITDCA01
    

    Notice that the current working directory is the /media2 directory as shown on the bash shell prompt.

    Note: Another directory cannot be specified to place the resultant .ova file in because the utility expects the file to be in the current working directory i.e. root@BFC media2#. If another directory is specified, the utility will successfully create the .ova file; however, when the image2class utility is invoked to import the .ova file it will fail because the ovfexport.sh file wraps the files one directory too deep; i.e. it wraps the files in the /OVA/media2 directory if the /media2 folder is specified in the filename. The files need to be wrapped in the root of the /OVA directory in order for image2class to process them properly. By using the current working directory and not specifying another directory, ovfexport.sh properly places the files in the .ova file wrapped in the /OVA directory. Bottom line, run the command from the current working directory and all will be well when trying to import the .ova file on the Grid using the image2class utility.

  4. Once the ovfexport.sh utility completes, copy the created .ova file to the _impex volume on the Grid Controller with the following command:
    scp INFRA01.ova root@192.168.32.211:/vol/_impex/INFRA01.ova
    
  5. Run the image2class utility on the Grid Controller using the following command:
    3t util image2class INFRA01:INFRA01 INFRA01.ova --unmanaged
    

    Where INFRA01:INFRA01 = Application Name as listed on the Grid:Class Name of the resultant Singleton which will be created on the Grid.

  6. Once step 5 is complete, follow the instructions to install the Windows APK and make the newly imported Singleton a fully managed AppLogic Appliance:
    http://doc.3tera.com/AppLogic30/en/Developer_Guide/DistInstallInstallGuideWindows_1.html
    

    Note: The CygWin utility must be downloaded and installed first and the apk-x.x.xx-windows.tar.gz file must downloaded and copied to the ** c:\cygwin\tmp folder after CygWin has been installed. To get access to both downloads, run ipconfig /all from a command prompt within the newly imported Singleton’s Gui Console and locate the DHCP server address. Once located plug it into the following URL within IE on the Singleton: http://x.x.x.x:8080/download; CygWin will be listed as “Server_Windows-x.x.x-x.msi” and the APK will be listed as “apk-x.x.xx-windows.tar.gz”. Also note that the instructions say to un-pack the APK file with gtar, use tar with the same parameters if gtar does not work.

  7. Once the imported machine has been verified, the apk has been installed, and if the name of the machine is not expected to change, i.e. INFRA01, INFRA02, etc., add an applogic_init file to the /cygwin/etc/sysconfig directory with the following parameter set:
    APK_HOSTNAME_UPDATE=No
    

    This will stop AppLogic from renaming the system once it has been added to the catalog.

  8. If desired, add the newly imported singleton to the Catalog.

Support Wiki Comment

This is a real case that customer converted win2000/2003 VM from VMware to Applogic 3.1(win2000 is not supported by image2class at all)

We refer to the above instruction to complete the conversion without error but win2000/2003 appliance fail to boot and display BSOD on screen.

The problem are eventually fixed in the following way

win2003 BSOD is fixed as below

Download MergeIDE and execute it in win2003 VMware VM first, then convert it to appliance using image2class, then win 2003 appliance can be booted up without error(win 2003 appliance PCI driver in device manager has question mark, but it seems not a big problem)

Here is MergeIDE download link

https://www.virtualbox.org/wiki/Migrate_Windows

win200 BSOD is fixed as below

Basically, refer to below document with slight modification. The MS KB suggest to attach the hard disk to another computer then modify registry , what customer preformed is to remove related registry from win2000 before export it from VMware

http://support.microsoft.com/kb/822052

Here is customer modification procedure:

  1. Execute MergeIDE on win2000 VMware VM
  2. Delete the value "[HKEY_LOCAL_MACHINE] ->[SYSTEM] -> [ControlSet XXX ] -> [Services] -> [dmio] -> [Boot Info] " from registry
  3. Follow the standard procedure to convert VMWare VM to AppLogic appliance