2.6 Installing the Orchestrate VM Client

The PlateSpin Orchestrate VM Client program is installed on your Windows or Linux administration machines. The interface is an Eclipse-based rich client environment designed to allow you to create and manage virtual machines (VMs).

To install the VM Client, first fulfill the minimum requirements, then select the installation platform:

2.6.1 Minimum Installation Requirements

To install the PlateSpin Orchestrate VM Client software, you must meet the following requirements:

Host Servers for VM Repositories

PlateSpin Orchestrate VM Client operates in conjunction with the PlateSpin Orchestrate Server software, which provides the grid environment for creating, storing, and using VMs. For information on installing PlateSpin Orchestrate Development Client for management of Orchestrate Servers, see Section 2.5, Installing the Orchestrate Development Client Only.

Workstations for Running the VM Client Software

The following table contains a list of operating system, hardware requirements, and installation file paths for PlateSpin Orchestrate VM Client. The installed program execution file is found in the ISO in the indicated folder.

Table 2-3 Workstation Installation Constraints

Operating System

Recommended Hardware

Installation File

Windows XP, Windows Vista, and Windows 7

  • i386 (32-bit) and 64-bit

  • 240 MB of free space

cd_image\Windows\vmclient_install.exe

where cd_image is one of the following images:

  • PlateSpin_Orchestrate-2.5.0-SLE10.i386.iso

  • PlateSpin_Orchestrate-2.5.0-SLE10.x86_64.iso

  • PlateSpin_Orchestrate-2.5.0-SLE11.i386.iso

  • PlateSpin_Orchestrate-2.5.0-SLE11.x86_64.iso

SLED/SLES 10 SP3

  • i386 (32-bit) and 64-bit

  • 257 MB of free space

cd_image/SLE10/vmclient_install

where cd_image is one of the following images:

  • PlateSpin_Orchestrate-2.5.0-SLE10.i386.iso

  • PlateSpin_Orchestrate-2.5.0-SLE10.x86_64.iso

SLED/SLES 11

  • i386 (32-bit) and 64-bit

  • 257 MB of free space

cd_image/SLE11/vmclient_install

where cd_image is one of the following images:

  • PlateSpin_Orchestrate-2.5.0-SLE11.i386.iso

  • PlateSpin_Orchestrate-2.5.0-SLE11.x86_64.iso

Uninstallation of Previous Versions of the Client

You must uninstall the previous version of VM Client before installing version 2.5:

  • Windows: On the Windows machine where the client is installed, click Start > Settings > Control Panel > Add or Remove Programs, select PlateSpin Orchestrate VM Client 2.0.2, then click Remove.

  • Linux: Run the following command:

    /opt/novell/zenworks/vmmanagement/Uninstall_ZENworks_VMM/Uninstall_Novell_ZENworks_VM_Manager_2.0.2

    This opens the InstallAnyWhere utility to uninstall VM Client.

2.6.2 Installing the Orchestrate VM Client on the Windows Operating System

These installation steps apply only to Windows 7, Windows Vista, and Windows XP.

  1. Copy the vmclient_install.exe file from the \Windows folder (see Table 2-3) to a location on your management Windows workstation.

  2. Double-click the vmclient_install.exe file to start the installation program:

    VM Client Installation Wizard - Introduction Page

  3. Click Next on the Introduction page to display the License Agreement page:

    VM Client Installation Wizard - License Agreement Page

  4. Read the terms of the license agreement; if you agree to abide by the terms, select the I accept the terms of the License Agreement option, then click Next to display the Important Information page; otherwise, click Cancel to exit the installation:

    VM Client Installation Wizard - Important Information Page

  5. After reviewing the third-party licenses, if you agree with them, click Next to display the Choose Install Folder page; otherwise, click Cancel to exit the installation:

    VM Client Installation Wizard - Choose Install Folder Page

  6. Select your installation folder, then click Next to display the Choose Shortcut Folder page:

    VM Client Installation Wizard - Choose Shortcut Folder Page

  7. Select a shortcut folder and any other options and groupings you want for the control of this interface, then click Next to display the Supported Hardware Platforms page:

    VM Client Installation Wizard - Supported Hardware Platforms Page

  8. Click Next to display the Pre-Installation Summary page:

    VM Client Installation Wizard - Pre-Installation Summary Page

  9. Verify the information and click Previous as necessary to make changes.

  10. When ready, click Install to begin the installation:

    VM Client Installation Wizard - Installing Page

    When the installation has completed, the Install Complete page is displayed:

    VM Client Installation Wizard - Install Complete Page

  11. Click Done to finish the installation.

    If you selected to place the shortcut icon on your desktop, this is what it looks like:

    VM Client Desktop Icon

  12. For some necessary setup tasks, continue with Managing Virtual Machines in the PlateSpin Orchestrate 2.5 VM Client Guide and Reference.

2.6.3 Installing Orchestrate VM Client in a Linux Environment

  1. Copy the PlateSpin Orchestrate 2.5 product ISO file to your management Linux workstation.

  2. Open a terminal on the workstation and log in as root.

  3. Mount the PlateSpin Orchestrate 2.5 product ISO file to a temporary directory.

    For example, if you copied the 32-bit version of the SLES 11 ISO file to Desktop, enter the following commands:

    • mkdir /mnt/iso
    • cd /Desktop
    • mount -o loop PlateSpin_Orchestrate-2.5.0-SLE11.i386.iso /mnt/iso
    • cd /mnt/iso/SLE11

  4. From the /mnt/iso/SLE11 directory, enter ./vmclient_install to launch the installer:

    VM Client Installation Wizard - Introduction Page

  5. Click Next on the Introduction page to display the License Agreement page:

    VM Client Installation Wizard - License Agreement Page

  6. Read the terms of the license agreement; if you agree to abide by the terms, select the I accept the terms of the License Agreement option, then click Next to display the Important Information page; otherwise, click Cancel to exit the installation:

    VM Client Installation Wizard - Important Information Page

  7. After reviewing the third-party licenses, if you agree with them, click Next to display the Choose Install Folder page; otherwise, click Cancel to exit the installation:

    VM Client Installation Wizard - Choose Install Folder Page

  8. Select your installation folder, then click Next to display the Choose Desktop Launcher Folder page:

    VM Client Installation Wizard - Choose Desktop Launcher Folder Page

  9. Select a shortcut folder and any other options and groupings you want for the control of this interface, then click Next to display the Supported Hardware Platforms page:

    VM Client Installation Wizard - Supported Hardware Platforms Page

  10. Click Next to display the Pre-Installation Summary page:

    VM Client Installation Wizard - Pre-Installation Summary Page

  11. Verify the information and click Previous as necessary to make changes.

  12. When ready, click Install to begin the installation:

    VM Client Installation Wizard - Installing Page

    When the installation has completed, the Install Complete page is displayed:

    VM Client Installation Wizard - Install Complete Page

  13. Click Done to finish the installation.

    If you selected to place the launcher icon on your desktop, this is what it looks like:

    VM Client Desktop Icon

  14. For some necessary setup tasks, continue with Managing Virtual Machines in the PlateSpin Orchestrate 2.5 VM Client Guide and Reference.