Article ID: 111220, created on May 3, 2011, last review on Jun 17, 2016

  • Applies to:
  • Odin Business Automation Standard 4.5
  • Virtuozzo 6.0
  • Virtuozzo containers for Linux 4.7
  • Virtuozzo containers for Linux 4.6
  • Virtual Automation 6.0

General notes

Virtual Automation (VA) has different API ports depending on the version and type of the VA host.

Virtual Automation 4.0 (PIM, Parallels Infrastructure Manager, VZAgent):

  • 4433 - non-SSL XML API service
  • 4434 - SSL XML API service
  • 4646 - SOAP API service

Virtual Automation Management Node 4.5, 4.6 and 6.0 (Replacement for 4.0 PIM Master Node):

  • 4533 - non-SSL XML API service
  • 4534 - SSL XML API service

* Virtual Automation Agent 4.5, 4.6* and 6.0 (Replacement for VZAgent 3.0 and 4.0 on Slave Nodes in PIM group. The VA Agent is installed directly onto the host when Containers or Virtuozzo is installed):

  • 4433 - non-SSL XML API service
  • 4434 - SSL XML API service
  • 4646 - SOAP API service

The VA API service can work in compatibility mode with previous versions, which is why the API version is typically set to 4.0.0. However, this setting can be changed if required.

In order to use a previous version of the VA API, you must follow the corresponding API guide and set the appropriate API protocol version in the XML header. For example:

<packet id="1" version="4.0.0"> or <packet id="1" version="4.5.0">

Find the references for each version of the XML API protocol in the corresponding manual:

VZAgent 3.0 XML API Reference

PIM 4.0 XML API Reference

VA 6.0 XML API Reference, PDF

Ways to send an XML API request

An XML API request can be sent to VA XML API service in several different ways:

  1. API requests to a local VA Agent can be sent using the vzlcon tool:

    • On Windows:

    • On Linux\Bare Metal:


    NOTE: Packets are separated by a ctrl+shift+2 combination:

    [root@myserver ~]# /opt/pva/agent/bin/vzlcon
    <packet xmlns:xsi="" id="0" priority="0" version="4.5.0">
    <packet version="4.0.0"><data><system><get_version/></system></data></packet>
    ^@  <==Here CTRL+SHIFT+2 was pressed
    <packet xmlns:ns1="" xmlns:ns2="" xmlns:xsi="" priority="0" version="4.0.0">
  2. Using the openssl tool:

    ~# echo -ne '<packet id="1" version="4.0.0"><data><system><login><name>BASE 64 ENCRYPTED USER NAME</name><realm>00000000-0000-0000-0000-000000000000</realm><password>BASE64 ENCRYPTED PASSWORD</password></login></system></data></packet>\0<packet id="2" version="4.0.0">YOUR XML API REQUEST</packet>\0' | openssl s_client -connect HOSTNAME:4434 -cipher ADH-AES256-SHA -quiet

    In this example, you need to specify the base64 encrypted login and password to authenticate to the XML API service. This can be done using perl:

    ~# perl -MMIME::Base64 -e "print(encode_base64('YOUR PLAIN TEXT PASSWORD'))"

    Your XML API request goes in the second packet. You can send several packets in a sequence terminated by '\0' after the authentication packet.

  3. Using the Perl client attached to this article:

    ~# ./ -name=root -password='PASSWORD' -host=HOSTNAME -packet='<packet version="4.0.0"><data><system><get_version/></system></data></packet>'
    <packet xmlns:ns1="" xmlns:ns2="" xmlns:xsi="" priority="0" version="4.0.0">

    Use the same script to send a long packet by specifying a file in the command line or redirecting the standard input:

    ~# ./ -name=root -password='PASSWORD' -host=HOSTNAME long_package.xml
    ~# ./ -name=root -password='PASSWORD' -host=HOSTNAME < long_package.xml

    The script can be used to send packets to VA MN, and it works via SSL connection by default:

    # ./ 
    Usage: -name=LOGIN -password=PASSWD -host=HOST [-nossl] [-mn] [-packet=PACKET | packet.xml]
    If -packet is omitted, it is read from the standard input.
    By default, the connection is done to VA Agent via SSL.
    Specify -nossl to turn off SSL, -mn to connect to PVA MN.
  4. Using a custom XML API client.

Additional information

Related articles:

6981 VA troubleshooting.

111223 How to find XML API requests sent to VA Agent by the VA Management Node or Power Panel

9216 VZagent API compatibility (Windows)

111821 VZagent API compatibility (Linux)

NOTE: More information about VA API versions, changes, and switching client applications can be found at the Parallels Developers Network site:

Search Words

Only welcome message is receiving whatever XML request I send

change ctid through api

connection vzagent closed



api calls


pstat slow

XML API setting interface


319940068c5fa20655215d590b7be29b c9ea6ca1b35b3385431f406f1be737be 2897d76d56d2010f4e3a28f864d69223 0889ab60fa6494de107aa7338c3c38b6 e8e50b42231236b82df27684e7ec0beb d02f9caf3e11b191a38179103495106f 400e18f6ede9f8be5575a475d2d6b0a6 caea8340e2d186a540518d08602aa065 0c05f0c76fec3dd785e9feafce1099a9 0dd5b9380c7d4884d77587f3eb0fa8ef 624ca542e40215e6f1d39170d8e7ec75 70a5401e8b9354cd1d64d0346f2c4a3e c62e8726973f80975db0531f1ed5c6a2 36627b12981f68a16405a79233409a5e

Email subscription for changes to this article
Save as PDF