Child pages
  • Cloud-VMWare plugin

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 4.0


For each physical machine that should be able to run virtual images:

  • Install the latest VMWare Player and latest VMWare VIX API. The installed VMWare player and VMWare VIX should have corresponding versions (the same build number). You can usually download the VIX API from VMWare Player download page.
  • Download and unpack the TeamCity VMWare plugin client application: in the top right corner of the TeamCity web UI, click the arrow next to your username, and select My Settings and Tools.
    Wiki Markup


  • }{note}Use [] to download both VMWare Player and VMWare VIX at once{note}{hidden-data}
  • create a folder for virtual machines and create as many virtual machines as necessary
  • ensure each virtual machine has the latest VMWare tools installed
  • ensure each virtual machine has a TeamCity agent installed, and the agent is launched on the machine boot. See other agent requirements.
  • start each virtual machine to ensure that there are no dialog boxes shown by VMWare player while the machine is starting.
  • create the following configuration file for each machine named <something>-image-info.xml and put it into the directory containing vmware image directories:
    Code Block
      <!-- virtual machine unique id -->
      <!-- local path to .vmx file -->
      <!-- path to inside the virtual machine -->
      <!-- login/password for the virtual machine administrator account -->

    VMWare Player may fail with a cryptic error if the path to an image contains subst drive

  • start TeamCity VMWare client with:
    Code Block
    java -jar cloud-vmware-client.jar /server:<TeamCity URL> /vmrun:{path to vmrun.exe from VIX} /store:<path to *-image-info.xml containing folder> [/maxInstances:<number>}

By default it allows running only one VM on a host machine. Use /maxInstances:<number> to change the default value.