Search for:

Available article translations:

How to set preferred IP address for PVA Agent communications

Article ID: 112904, created on Nov 28, 2011, last review on Dec 8, 2014

  • Parallels Cloud Server 6.0
  • Parallels Virtuozzo Containers
  • Parallels Server
  • Parallels Virtual Automation


If a Hardware Node has several IP addresses, PVA uses the first one on the list for its communications.

If virtualization nodes has both frontnet and backnet IPs, PVA Agent on one node may fail to communicate with other nodes unless preferred IP is set, e.g.:

1391441908: can not read reply from destination node
1391441908: can't connect to source node ($IP_ADDRESS) : can not read reply from destination node

This article describes how to configure PVA Agent to use a particular IP address for communications via XML API.


To make PVA Agent use a particular IP address for Backup, Restore or other types of PVA Agent internal traffic, follow the below steps.

Determine the IP address to be used as the primary PVA Agent IP address, e.g.:

[hwnode@03:51:08][~]# ip a l
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 16436 qdisc noqueue state UNKNOWN
    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
    inet scope host lo
    inet6 ::1/128 scope host
       valid_lft forever preferred_lft forever
2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UNKNOWN qlen 1000
    link/ether 20:cf:30:1d:46:2e brd ff:ff:ff:ff:ff:ff
    inet brd scope global eth0
    inet brd scope global eth0:0
    inet6 fe80::22cf:30ff:fe1d:462e/64 scope link
       valid_lft forever preferred_lft forever

Locate PVA Agent configuration file (/var/opt/pva/agent/etc/vzagent.conf or /vz/pva/agent/etc/vzagent.conf)

Replace primary_address section in vzagent.conf with the desired IP address, e.g., for Linux nodes:

[hwnode@04:20:23][~]# sed '/<primary_address>/s~>.*.<\/~><\/~' -i /var/opt/pva/agent/etc/vzagent.conf

Restart PVA Agent:

# pvaagent restart

NOTE: The resulting section of "vzagent.conf" should look similar to this:


NOTE2: This example describes PVA Agent configuration on a Linux node, but the solution applies to Windows nodes as well.

For more information regarding PVA Agent troubleshooting on Windows and Linux, refer to this article: PVA troubleshooting

Related topics

1457 I cannot migrate a VE to another node. How do I fix this?

Search words:

failed to check client configuration

Task that performs VPS migration failed

can not read reply from destination node can not read reply from destination node can't connect to source node (xx.xx.xx.xx : can not read reply from destination node

primary IP address

main IP address

destination failed

909d99074e442b52ce54cc7b31cf065d de15ebe36a547439f84e5981418f36c7 2897d76d56d2010f4e3a28f864d69223 ca05eaf5b843fbd53589c90d7228a6df bf1c3a170005eae151f49ba2720abde9 3d9560cc94370f9e1bd9256d230e5ee8

Was this article helpful?
Tell us how we may improve it.
Yes No
Server Virtualization
- Parallels Cloud Server
- Parallels Containers for Windows 6.0
- Parallels Virtuozzo Containers
- Parallels Automation
- Parallels Automation for Cloud Infrastructure
- Parallels Business Automation Standard
- Parallels Virtual Automation
- Parallels Plesk Panel Suite
- Web Presence Builder
- Parallels Plesk Automation
- Parallels Small Business Panel
- Value-added Services for Hosters
- Parallels Partner Storefront
Services & Resources
- Cloud Acceleration Services
- Professional Services
- Support Services
- Training & Certification