Configuring a data mover node for tagging support

When tagging support is enabled on a data mover node, administrators can apply data protection tags to inventory objects in the VMware vCenter.

Before you begin

Ensure that the following requirements are met:

  • VMware vCenter Server must be at Version 6.0 Update 1 or later.
  • In order for the Data Protection for VMware vSphere GUI to function correctly with tagging support, ensure that the following requirements are met during the installation of the GUI:
    • At least one data mover and the Data Protection for VMware vSphere GUI must be installed on the same server. This data mover node must be configured so that the vCenter server credentials are saved. You can save the credentials by running the configuration wizard to save the data mover node password, or by using the dsmc set password command on the data mover command line.

      If you use other data movers, running on virtual machines or physical machines as additional data movers, you can install them on other servers. For tagging support, all these data movers must also be configured with the VMTAGDATAMOVER YES option. These additional data movers do not require the Data Protection for VMware vSphere GUI to be installed on the same server in order for them to work correctly as tag-based data movers.

    • Linux operating systemsFor Linux data movers, ensure that you specify the data mover installation directory and the Java™ shared library libjvm.so in the LD_LIBRARY_PATH environment variable. The path to libjvm.so is used for tagging support when you enable the vmtagdatamover option on the data mover. For instructions, see Setting up the data mover nodes in a vSphere environment.
    • Linux operating systemsOn Linux operating systems, the Data Protection for VMware vSphere GUI must be installed by using the default user name (tdpvmware).
    • Linux operating systemsFor Linux data mover nodes, the default password file (/etc/adsm/TSM.PWD) must be used.

About this task

You can use data protection tags to configure the backup policy of virtual machines in VMware inventory objects. These data protection tags are presented as settings that can be changed in the IBM Spectrum Protect™ vSphere Client plug-in.

Procedure

Use one of the following methods:
Option Description
To configure a new data mover for tagging support on Windows or Linux by using the Data Protection for VMware vSphere GUI
  1. On the system where the Data Protection for VMware vSphere GUI is installed, start the GUI by opening a web browser and entering the GUI web server address. For example:
    https://<GUI web server address>:
    9081/TsmVMwareUI/
  2. Log on with the vCenter user ID and password.
  3. Go to the Configuration tab, and select the Edit IBM Spectrum Protect Configuration action.
  4. Go to the Data Mover Nodes page of the configuration notebook.
  5. Add a data mover node by completing the following steps:
    1. For the data mover node that you want to set up tagging support for, select Create Services. By default, Tag Based Node is selected to enable the data mover node for tagging support
    2. To designate the tag-based node as a default data mover node, select Default Data Mover. A default data mover node backs up any new VMs that are added to any container in the datacenter, if the container is already in a protection set. The default data mover also backs up any VMs in the protection set that are not assigned the Data Mover tag.
      Tip: For Linux systems, if you select a new data mover node as the default tagging node, then remove the vmtagdefaultdatamover line from any other data mover options file that is associated with that datacenter.
    3. Click OK to save your changes.

      The vmtagdatamover and vmtagdefaultdatamover (if set) options are added to the data mover options file (dsm.opt).

To configure an existing Windows data mover node for tagging support when the node is on a the same server as the Data Protection for VMware vSphere GUI
  1. Complete steps 1-3 in the preceding instructions for configuring a new data mover node for tagging support.
  2. On the Data Mover Nodes page, select Tag Based Node for the node that you want to enable tagging support for.
  3. Optional: To designate the tag-based node as a default data mover node, select Default Data Mover.
To configure an existing Linux data mover node for tagging support or an existing Windows data mover node that is on a different server than the Data Protection for VMware vSphere GUI
  1. Add the vmtagdatamover yes option in the data mover options file (dsm.sys for Linux and dsm.opt for Windows).
  2. Optional: To designate the tag-based node as a default data mover node, add the vmtagdefaultdatamover yes or vmtagdefaultdatamover dm_name option to the data mover options file.
    Tip: For Linux systems, if you select a new data mover node as the default tagging node, then remove the vmtagdefaultdatamover line from any other data mover options file that is associated with that datacenter.

Results

After the data mover node is enabled for tagging support, the data mover queries the VMware inventory for tagging information when it runs a backup. The data mover then backs up the virtual machines according to the data protection tags that are set. If the data mover node is not configured for tagging support, any data protection tags are ignored during a backup operation.