Virtualnodename

The virtualnodename option specifies the node name of your workstation when you want to restore or retrieve files to a different workstation.

When you use the virtualnodename option in your client options file, or with a command:

  • Windows operating systemsYou must specify the name you specified with the nodename option in your client options file (dsm.opt). This name should be different from the name returned by the hostname command on your workstation.
  • AIX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsYou must specify the name you specified with the nodename option in your client system-options file (dsm.sys). This name should be different from the name returned by the hostname command on your workstation.
  • The client prompts for the password assigned to the node that you specify, if a password is required (even when the passwordaccess option is set to generate). If you enter the correct password, you have access to all backups and archives that originated from the specified node.

When connecting to a server, the client must identity itself to the server. This login identification is determined in the following ways:

  • If the nodename and virtualnodename options are not specified, or a virtual node name is not specified on the command line, the default login ID is the name returned by the hostname command.
  • If the nodename option is specified, the name specified with the nodename option overrides the name returned by the hostname command.
  • If the virtualnodename option is specified, or a virtual node name is specified on a command line, it cannot be the same name as the name returned by the hostname command.
Windows operating systemsNote: The client can use file space information when restoring files. The file space information can contain the name of the computer from which the files were backed up. If you restore from another client node and do not specify a destination for the restored files, the client uses the file space information to restore the files. In such a case, the client attempts to restore the files to the file system on the original computer. If the restoring computer has access to the file system of the original computer, you can restore files to the original file system. If the restoring computer can not access the file system of the original computer, the client can return a network error message. If you want to restore the original directory structure but on a different computer, specify only the target file system when you restore. This is true when restoring files from another node and when retrieving files from another node.
AIX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsWindows operating systems

Supported Clients

This option is valid for all clients.

Options File

Windows operating systemsPlace this option in the client options file (dsm.opt).

AIX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsPlace this option in the client user-options file (dsm.opt).

Syntax

Read syntax diagramSkip visual syntax diagram
>>-VIRTUALNodename-- --nodename--------------------------------><

Parameters

nodename
Specifies a 1- to 64-character name that identifies the node for which you want to request IBM Spectrum Protect™ services. There is no default.

Examples

Options file:
virtualnodename cougar
Command line:
-virtualn=banshee

This option is valid only on the initial command line. It is not valid in interactive mode.