This chapter describes how to port the existing VZAgent applications to Parallels Agent 4.0.0. VZAgent 3.0.3 applications will continue to work with Parallels Agent 4.0.0 without any changes. Earlier protocol versions are not officially supported so the existing applications using protocol version earlier than 3.0.3 may not work correctly and therefore should be either upgraded to version 3.0.3 or ported to version 4.0.0. To upgrade an existing application to version 3.0.3, all you have to do is to change the protocol version number in the headers of your XML messages. To port the existing applications to version 4.0.0, you should read this guide and follow the instructions provided.
If you are going to be using a version 3.0.3 application with Parallels Virtuozzo Containers 4.0, you should be aware that some of the old VZAgent functionality will not work with it. The following list describes the interfaces that are no longer supported:
snapshotm
interface is not supported. In the previous version, the interface allowed to create and manage Virtuozzo OS templates in the EZ Template format which was introduced in Virtuozzo 3.0. This functionality has been moved to the pkgm
interface in Parallels Agent 4.0.0.mailc
interface is not supported. The interface allowed to manage e-mail templates used for automatic system alert notifications. The format of the templates has changed, some of the variables have changed as well. This functionality has been moved to the new mailer
interface.nbh
interface is no longer supported. The name-based hosting functionality has been dropped in Virtuozzo Containers 4.0.global
interface is not supported. The interface allowed to set up and manage a Virtuozzo group (formerly Virtuozzo cluster) and to perform certain Hardware Node related tasks. This functionality has been moved to the new clusterm
interface in VZAgent 4.0.0.vzagent0
user inside this VE using the vzctl set command: # vzctl set 1 --ipadd public_IP_address --userpasswd vzagent0:**********