Search <book_title>...

Veritas NetBackup™ 8.0 Security and Encryption Guide

Last Published: 2017-07-25

Product(s): NetBackup (8.0)

Updating port settings for the Media Manager in the vm.conf file

The vm.conf file specifies Media Manager connection options. If you want to override the default connection options, you need to edit the vm.conf file. The NetBackup administration console does not provide a way to change these settings. The path to the vm.conf is as follows:

On Linux or UNIX, the path is as follows:
/usr/openv/volmgr/vm.conf
On Windows systems, the path is as follows:
install_path\volmgr\vm.conf

Table: Port usage-related Media Manager configuration settings shows the vm.conf file settings that affect ports.

Table: Port usage-related Media Manager configuration settings

Setting	Description
CLIENT_PORT_WINDOW	Specifies the range of source ports that can be used on outgoing Media Manager connections. The format is as follows: CLIENT_PORT_WINDOW = min max The min argument defines the lowest source port number. The max argument defines the highest source port number. For min and max, specify 0 (zero) or specify integers from 1024 to 65535. If min is 0 or if max is less than min, then the operating system determines the source port number. By default, CLIENT_PORT_WINDOW = 0 0. For example, the following setting defines a source port range from 3000 to 8000: CLIENT_PORT_WINDOW = 3000 8000
CONNECT_OPTIONS	Note: The CONNECT_OPTIONS setting affects only connections to hosts that run NetBackup 7.0. When NetBackup connects to hosts that run NetBackup 7.0.1 and later, NetBackup uses the veritas_pbx port. Specifies the destination port number that can be used to connect to the Media Manager services. The format is as follows: *CONNECT_OPTIONS = host* 0 0 0\|1\|2** This setting accepts four space-separated arguments. The arguments are as follows. For host, specify the name of the media server to which other computers need to connect. After the host name, type 0 0. The arguments in these positions are not used. After 0 0, type 0, 1, or 2 to specify the connection method to the Media Manager service on the target computer. The connection method specifications are as follows: If 0, the host uses the vnetd port. If that attempt fails, the hosts uses the legacy port number. If 1, the host uses only vnetd to connect to the server. If 2, the host uses the legacy Media Manager port. You can specify multiple CONNECT_OPTIONS settings in the vm.conf file. For NetBackup, if the `vm.conf` file does not contain any CONNECT_OPTIONS entries, the Media Manager selects the port based on the bp.conf file settings for DEFAULT_CONNECT_OPTIONS and CONNECT_OPTIONS. For example, the following settings specify that the Media Manager connections to server3 use vnetd as the destination port: CONNECT_OPTIONS = server3 0 0 1
RANDOM_PORTS	Specifies whether NetBackup chooses ports randomly or sequentially when it communicates with other NetBackup servers. The format is as follows: RANDOM_PORTS = YES \| NO If RANDOM_PORTS = YES, or if there is no RANDOM_PORT entry, NetBackup selects a random port from the range specified by the CLIENT_PORT_WINDOW setting in the vm.conf file. If RANDOM_PORTS = NO, the NetBackup attempts the connection with the highest source port number in the range. If the source port does not work, NetBackup tries the next highest source port number. The port number is chosen from the list until it finds a source port number that works.

Setting

Description

CLIENT_PORT_WINDOW

Specifies the range of source ports that can be used on outgoing Media Manager connections. The format is as follows:

CLIENT_PORT_WINDOW = min max

The min argument defines the lowest source port number.

The max argument defines the highest source port number.

For min and max, specify 0 (zero) or specify integers from 1024 to 65535. If min is 0 or if max is less than min, then the operating system determines the source port number.

By default, CLIENT_PORT_WINDOW = 0 0.

For example, the following setting defines a source port range from 3000 to 8000:

CLIENT_PORT_WINDOW = 3000 8000

CONNECT_OPTIONS

Note:

The CONNECT_OPTIONS setting affects only connections to hosts that run NetBackup 7.0. When NetBackup connects to hosts that run NetBackup 7.0.1 and later, NetBackup uses the veritas_pbx port.

Specifies the destination port number that can be used to connect to the Media Manager services. The format is as follows:

CONNECT_OPTIONS = host 0 0 0|1|2

This setting accepts four space-separated arguments. The arguments are as follows.

For host, specify the name of the media server to which other computers need to connect.

After the host name, type 0 0. The arguments in these positions are not used.

After 0 0, type 0, 1, or 2 to specify the connection method to the Media Manager service on the target computer. The connection method specifications are as follows:

If 0, the host uses the vnetd port. If that attempt fails, the hosts uses the legacy port number.
If 1, the host uses only vnetd to connect to the server.
If 2, the host uses the legacy Media Manager port.

You can specify multiple CONNECT_OPTIONS settings in the vm.conf file.

For NetBackup, if the vm.conf file does not contain any CONNECT_OPTIONS entries, the Media Manager selects the port based on the bp.conf file settings for DEFAULT_CONNECT_OPTIONS and CONNECT_OPTIONS.

For example, the following settings specify that the Media Manager connections to server3 use vnetd as the destination port:

CONNECT_OPTIONS = server3 0 0 1

RANDOM_PORTS

Specifies whether NetBackup chooses ports randomly or sequentially when it communicates with other NetBackup servers. The format is as follows:

RANDOM_PORTS = YES | NO

If RANDOM_PORTS = YES, or if there is no RANDOM_PORT entry, NetBackup selects a random port from the range specified by the CLIENT_PORT_WINDOW setting in the vm.conf file.

If RANDOM_PORTS = NO, the NetBackup attempts the connection with the highest source port number in the range. If the source port does not work, NetBackup tries the next highest source port number. The port number is chosen from the list until it finds a source port number that works.