Configuring the Linux mount proxy for file restore operations

To prepare a Linux guest virtual machine (VM) for file restore operations, you must configure the Linux mount proxy.

Before you begin

Ensure that you complete the following tasks:

Run the Data Protection for Microsoft Hyper-V configuration wizard on the Hyper-V host or cluster and enable the file restore feature. For instructions, see Configuring Data Protection for Microsoft Hyper-V with the wizard.
Install the mount proxy on a Linux system. For instructions, see Installing the mount proxy feature on Linux systems.

About this task

When you enable the file store feature with the configuration wizard, the mount proxy node pair for a stand-alone host or for each host in a cluster is automatically registered with the IBM Spectrum Protect™ server, along with the definition of proxy relationships. To enable the guest VM for file restore operations, you must configure the Linux mount proxy by adding the Linux mount proxy options that are provided by the configuration wizard to the dsm.sys file.

The following procedure sets up the mount proxy node by updating the mount proxy node options and verifying connectivity to the IBM Spectrum Protect server.

Procedure

Complete the following steps on the Linux mount proxy system:

If the client-user options file (dsm.opt) is not in the installation directory (opt/tivoli/tsm/client/ba/bin), create the file with a text editor.
Open the dsm.opt file with a text editor and add the following statement to the file:
```
servername MPNODE_hostname_HV_MP_LNX
```
where hostname is the name of the Windows Hyper-V host.
Ensure that this statement is the only statement in the file. Save your updates and close the file.
Open the dsm.sys file with a text editor. Copy the mount proxy options from the Linux Mount Proxy Options window of the configuration wizard and paste them into the file.
For example, paste the following stanza to the dsm.sys file:
```
SERVERNAME           MPNODE_hostname_HV_MP_LNX
NODename             hostname_HV_MP_LNX
PASSWORDAccess       generate
TCPServeraddress     backup_server_addess
TCPPort              1500
HTTPPort             1581	** Must be unique for each node
COMMMethod           tcpip
ERRORLOGName         dsmerror.hostname_HV_MP_LNX.log
```
where hostname is the name of the Hyper-V host and backup_server_address is the host name or IP address of the IBM Spectrum Protect server where VMs are backed up.
Save your changes and close the dsm.sys file.
Start a command-line session on the mount proxy system with the -asnodename and -optfile command-line parameters:
```
dsmc -asnodename=hyperv_target_node -optfile=dsm.opt
```
where hyperv_target_node is the Hyper-V node name under which your VM backups are stored. The Hyper-V target node has the following naming convention:
- For a stand-alone host environment: hostname_HV_TGT
- For a cluster environment: clustername_HV_TGT
During the initial sign-on, you are prompted for a user ID and password. Enter your IBM Spectrum Protect server administrator ID and password.

After the initial sign-on, a new password is generated and stored so that you will not be prompted for the password again.

To ensure that you are not prompted for the password, run the dsmc command again. If you are prompted for the password, ensure that the passwordaccess generate option is set in the dsm.sys file, and repeat Step 4 again.
Verify the connection to the IBM Spectrum Protect server by issuing the following command:
```
dsmc query session
```
This command shows information about your session, including the current node name, the session start time, server information, and server connection information.
Set up the client acceptor service (CAD) by taking the following actions:
1. Set the following environment variable in the /etc/init.d/dsmcad file:
```
export LD_LIBRARY_PATH=/opt/tivoli/tsm/client/ba/bin
```
2. The installation program creates a startup script for the client acceptor (dsmcad) in the /etc/init.d directory. The client acceptor must be started before it can manage scheduler tasks.
  Ensure that you are logged in with the root user ID, and then use the following command to start the client acceptor:
```
export LD_LIBRARY_PATH=/opt/tivoli/tsm/client/ba/bin
```
```
service dsmcad start
```
  To enable the client acceptor to start automatically after a system restart, add the service as follows, at a shell prompt:
```
# chkconfig --add dsmcad
```

What to do next

Verify that the Linux mount proxy node is set up correctly:

Start the Data Protection for Microsoft Hyper-V Management Console on the Hyper-V host or cluster.
Select a Linux VM, and click File Restore in the Actions pane to go to the file restore interface.
Verify that you can run file restore operations for the Linux guest VM.

If you configured Data Protection for Microsoft Hyper-V with the file restore feature enabled and you ran the configuration wizard again after the initial configuration, the Linux mount proxy node password must be reset. To reset the password, use one of the following methods:

Method 1

On the Linux mount proxy, the IBM Spectrum Protect administrator runs the dsmc command and enters the IBM Spectrum Protect administrator user ID and password when prompted.

Method 2

Complete the following steps:

The IBM Spectrum Protect administrator resets the Linux mount proxy node password by running the UPDATE NODE server command on the IBM Spectrum Protect server console.
The Linux mount proxy node owner runs the dsmc command on the Linux mount proxy. When prompted, the owner enters the default Linux mount proxy node ID and new Linux mount proxy node password (obtained from the IBM Spectrum Protect server administrator).