Installing ART on VMware ESX 3+

Option 1: Graphical install with VMware Converter

(We have a four-minute video showing this process, too.)

1. Download ART onto a machine with VMware Converter installed. If you have problems, make sure you have the latest Converter version (4.0).
2. Unzip the downloaded file to a working directory.
3. Convert the ART Virtual Machine to infrastructure format, and install on ESX server: 
   1. Open VMware Converter
   2. Pick "Convert Machine" to start the wizard.
   3. Choose source type "VMware Workstation or other VMware virtual machine" or "Other" (depending on your Converter version); click Next.
   4. Browse to the location of the art.vmx file; click Next.
   5. VMware converter may present a warning "Cannot configure the source image" -  this can be ignored.
   6. Navigate through the remaining prompts as appropriate for your site.
4. Start the ART Virtual Machine:
   1. open the VMware Infrastructure client
   2. Log into the ESX server where the ART VM was loaded.
   3. Click on ART in the Inventory column then click the green play button on the top menu bar.
   4. Click on the "Console" tab.  Boot messages appear, then a "Getting Started with ART" page.   Follow the instructions there.
5. If VMware complains about the number of CPUs (ART defaults to 2 for performance reasons, but this will fail on single-core servers), right-click on the VM name and choose "Edit Settings".  Click on "CPUs" and set the number to one.  Try to start ART again.
6. You can now delete original download file, and the working directory where you unzipped it.

Option 2: Command-line install with ESX Service Console

1. Download the ART archive onto a local system and unzip.
2. Log on to your ESX server (e.g. via ssh).
3. Make a new folder where you would like the VM to reside. If your target volume is "/vmfs/volumes/datastore1/", this could be "/vmfs/volumes/datastore1/ART".
4. Make a subdirectory called temp.
5. Copy vmdk files from the local machine into the temp directory and all others into the ART directory.
6. Convert the disks to an ESX-supported format. The zeroed-thick format is recommended for performance, but any supported format will work.
   • From the first directory you created (e.g. /vmfs/volumes/datastore1/ART) do:
   • vmkfstools -i temp/artdata.vmdk artdata.vmdk
   • vmkfstools -i temp/artsql.vmdk artsql.vmdk
   • vmkfstools -i temp/art.vmdk art.vmdk
7. Register the VM using the following command, substituting the appropriate path for your server.

   vmware-cmd -s register /vmfs/volumes/datastore1/ART/art.vmx

   On ESXi servers, you can run the previous command remotely from a host with rCLI tools, or directly from the ESXi server you can use the following command:

   vim-cmd solo/registervm /vmfs/volumes/datastore1/ART/art.vmx

8. If this command returns an error about the number of virtual CPUs, edit the .vmx file and change the "numvcpus" line to equal 1.
9. To check that the VM was added, run this command and see that the ART VM is on the list

   vmware-cmd -l

   For ESXi, use

   vim-cmd vmsvc/getallvms

10. Start the VM with

    vmware-cmd /vmfs/volumes/datastore1/ART start

    For ESXi, use

    vim-cmd vmsvc/power.on <ID>

    where ID is the VMID which you can see in output of the vmsvc/getallvms command from the previous step.
11. To ensure that the VM started correctly you can run

    vmware-cmd /vmfs/volumes/datastore1/ART getstatus

    For ESXi, use

    vim-cmd vmsvc/get.guest <ID>

    The latter will show you the IP address, and at the bottom it should say guestState = "running"
12. If the VM started successfully, you can point a browser at its IP address to get started using ART. If not, please contact TSMworks technical support for assistance.
13. Follow the "Getting Started with ART" instructions on the right side of the Console window.
14. You may now safely delete the temp directory (and the original vmdk's), archive file, and any other working files.