Version 7.1
Installation
Cookbook
December 13, 2013
Art Roy
IBM Tivoli Storage SW Advanced Technology/SWAT [email protected]
current product documentation. It is not meant to cover every aspect of the product but only to get the customer up and running as quickly as possible. The document assumes that the customer will use the TSM for VE Web
Browser GUI or vCenter plug-in as well as the configuration wizard to configure the TSM for VE environment.
1. Verify Prerequisites
2. Install the TSM for VE software on the Primary vStorage Backup Server. 3. Configuration using the TSM for VE Web Browser GUI.
4. Adding a datamover
a. Adding a datamover to the original vStorage Backup Server. b. Adding a datamover to a secondary vStorage Backup Server. c. Installation of the TSM for VE software on the secondary server. d. Configuration of the datamover option file and services.
e. Adding a Second (or more) datamover to a vStorage Backup Server.
Before beginning installation, please verify that the following ports are open on the vStorage Backup Server and not blocked by a firewall. TSM for VE ports
443 – inbound and outbound 902 – outbound
1527 – inbound and outbound 9080 – inbound 9081 – inbound Standard TSM ports 1500 – outbound 1501 – inbound 1581 – inbound
Accept the license terms and Click Install.
No Input Required
Click Next
Click OK.
Click Finish.
TSM for VE requires automount to be disabled and the SAN policy set to OnlineAll. The TSM for VE installation process will set these automatically but the settings should be verified after installation is complete.
C:\>diskpart
DISKPART> automount DISKPART> san
Verify the Automount and SAN Policy Settings If the settings are incorrect, set them as follows:
C:\>diskpart
If you chose to enable access to the GUI via a web browser, the web browser will be automatically invoked after completion of the installation.
If you wish to use the web GUI, click ‘Continue to this website (not
Click on Tivoli Data Protection for VMware.
Launching the GUI for the first time will automatically launch the Configuration Wizard.
Enter the DNS name or IP address for the TSM Server.
Modify the TSM Server port number if required. The default is 1500.
Enter a TSM server Admin ID and Password.
Check the box to save the ID and password.
Click Next.
Enter a prefix for the TSM node names that will be generated.
Note: The wizard will automatically place an
underscore between what you type here and the rest of the node name.
Verify the Policy domain to be used.
Click Next.
TDP for VMware requires several nodes to be defined on the TSM server. The configuration wizard will create the nodes. This screen gives the option to
Create the vCenter Node in TSM.
This field will be pre-filled with a node name for the vCenter node in TSM. It consists of the node prefix if specified earlier
followed by ‘_VC’ followed by the vCenter name as shown in the vCenter. In this example it results in the name of
VE7_VCVSPHERE-SRV. Your name will differ. You may modify the name if desired or use the generated default name.
Check the ‘Register Node’ box and enter a password for the new node. The new node will be registered in TSM with the
Create the VMCLI Node.
This field will be pre-filled with a node name for the VMCLI node in TSM. It consists of the node prefix, if specified earlier, followed by ‘_VMCLI’. In this example it results in the name of VE7_VMCLI. Your name will differ depending on the prefix you entered. You may modify the name if desired or use the generated default name.
Check the ‘Register Node’ box and enter a password for the new node. The new node will be registered in TSM with the
Select the VMware Datacenters to be managed.
In this example only one
Create the Datacenter Node and Initial TSM Data Mover Node
TSM node names for the datacenter and Data Mover are generated.
The datacenter node name consists of the specified prefix followed by an underscore followed by the datacenter name.
Set the TSM node passwords for the Datacenter and Data Mover nodes
Note that the passwords for each node have not been set.
Set the TSM node passwords for the Datacenter and Data Mover nodes
Repeat the Set Password process for the other node(s) until all nodes show ‘Change’ in the Password column.
Do NOT click Next yet.
Decide whether to allow the wizard to create the Data Mover services.
When the ‘Create Services’ box is checked for a particular Data Mover, the wizard will create the required option file and TSM client services for the Data Mover node. This is optional. You may still create the option files and services manually. IMPORTANT NOTE: At this time, this checkbox should only be used for Data Movers that reside on the server where the Web Browser GUI was installed. If you are adding a secondary vStorage backup server, the Data Mover option file and services must be created manually. If you leave the ‘Create Services’ box checked when creating the additional Data Mover node definition, the option file and services will be created on the original vStorage backup server rather than on the new server.
Decide whether to allow the wizard to create the Data Mover services.
This is the first vStorage backup server so the box will be left checked.
vCenter Node Name VMCLI Node Name Datacenter Node Name Data Mover Node Name
The Summary page shows the Node Names that will be created in TSM.
This screen will monitor and show the results of the configuration wizard tasks
When all tasks complete successfully, click Close. If you receive a failure on the ‘Verify Data Mover nodes’ task, it is likely due to the creation of the TSM services not yet being
completed. Verification of the Data Mover node requires an active Client Acceptor service for the node.
See the following pages to retry the verification.
Retrying the Data Mover verify.
If you receive a failure on the ‘Verify Data Mover nodes’ task, the Datacenter will show a warning icon.
Click on the Datacenter Name.
Open a windows command prompt on the vStorage backup server.
CD to the baclient folder.
Issue the dir *.opt command to list the .opt files.
Invoke the BA Client GUI using the correct .opt file.
12/13/2013
Update the Vmware Virtual Center User and Password. Click OK.
Retrying the Data Mover verify.
Retrying the Data Mover verify.
If the connection to the Client Acceptor service is successful, then the validation will be
successful. The yellow warning symbol on the Datacenter will no longer appear and Host Name, Host Address, and Port will
A query node command on the TSM server shows the TSM nodes created by the configuration wizard.
A client option file will be created with the naming
Copy the generated file to a file called dsm.opt. This the default option file used by the BA Client GUI and command line interfaces.
This will allow the BA Client GUI and command line
interfaces to be used for VM guest backup and full VM restore.
There are two places where Data Movers can be added. The first is on the original vStorage Backup Server where the Web Browser GUI has been installed. The second is any additional vStorage Backup Server.
The Web Browser GUI allows you to create and configure the option file and TSM Client services required for the new Data Mover by using the ‘Create Services’ checkbox on the ‘Data Mover Nodes’ section of the Configuration Editor. Optionally you may elect to uncheck this box and create the option file and services manually. The ‘Create Services’ checkbox should not be
checked for Data Movers being added to secondary vStorage Backup servers.
Optionally change the name of the datamover by clicking on the name or by highlighting the line and clicking ‘Edit Node Name’.
Leave the Register Node box checked.
Note: If you are using the vCenter plugin, you will be requested to enter the
dsm.VE7_DATACENTER-1_DM1.opt (option file for datamover node VE7_DATACENTER-1_DM1)
NODename VE7_DATACENTER-1_DM
PASSWORDAccess generate
VMCHost 192.168.2.195
MANAGEDServices schedule webclient
TCPServeraddress 192.168.2.246
TCPPort 1500
HTTPPORT 1581
COMMMethod tcpip
ERRORLOGName "C:\Program Files\Tivoli\TSM\baclient\dsmerror.VE7_DATACENTER-1_DM.log"
SCHEDLOGName "C:\Program Files\Tivoli\TSM\baclient\dsmsched.VE7_DATACENTER-1_DM.log"
VMMAXParallel 4
VMCUSER administrator
dsm.VE7_DATACENTER-1_DM2.opt (option file for datamover node VE7_DATACENTER-1_DM2)
NODename VE7_DATACENTER-1_DM2
PASSWORDAccess generate
VMCHost 192.168.2.195
MANAGEDServices schedule webclient
TCPServeraddress 192.168.2.246
schedmode of polling. If you prefer to use prompted, add the SCHEDMODE parameter as well as TCPCLIENTADDRESS and TCPCLIENTPORT. Be sure to specify a unique TCPCLIENTPORT port number for each datamover that resides on the same vStorage backup server. You may also wish to add the VMCTLMC option to direct the control files to a disk-based storage pool.
Note that the HTTPPORT port
Adding a Data Mover to a Secondary
vStorage Backup Server
Uncheck the ‘Create Services’ box. Leaving this box checked will create the
option file and services on the server where the GUI is installed. Click OK.
Adding a Data Mover to a Secondary
vStorage Backup Server
If not already completed, install the software on the secondary server. Use the same TSM for VE installation package to install the required software on secondary vStorage Backup Servers. Installing the Datamover Only is the equivalent of installing the TSM BA Client software as well as the TSM for VE enablement file. This version of TSM for VE includes the TSM Client software within the install package.
Click Next
Click ‘Install the Data Mover only’.
Accept the license terms and Click Install.
No input required.
Click Next.
Select your Protection requirement and click Next.
Optionally you can install the Recovery Agent.
Click Install.
This question is only displayed if the
installation was
modified to include the Recovery Agent.
Click Install.
This information is only displayed if the
installation was
modified to include the Recovery Agent.
Click Finish.
This request is only displayed if the
installation was
modified to include the Recovery Agent.
Click Yes to Reboot.
TSM for VE requires automount to be disabled and the SAN policy set to OnlineAll. The TSM for VE 7.1 installation process will set these automatically but the settings should be verified after installation is complete.
C:\>diskpart
DISKPART> automount DISKPART> san
Verify the Automount and SAN Policy Settings If the settings are incorrect, set them as follows:
C:\>diskpart
Adding a Data Mover to a Secondary
vStorage Backup Server
Configuration of the Datamover Option Files and Services
Once the datamover (BA Client) software is installed the datamover node can be configured.
This section shows how to build the option file for a Data Mover using the configuration wizard and Client Preferences Editor. You may also build the file manually using wordpad or notepad.
A TSM Backup-Archive Client option file does not yet exist so the TSM Client Configuration Wizard is invoked automatically.
Enter the TSM node name for the Data Mover that was registered using the web GUI
Click Next
Enter the TSM password for the Data Mover node that was entered in the web GUI. Click Login.
The Node Name field should be automatically filled. If not, wait for it to appear before continuing.
In the “As Node Name” field, enter the node name for the datacenter that was created during the web GUI wizard.
Click the Scheduler tab.
Select Prompted
Enter the DNS name or IP address of the client. This is the server you are currently on.
Click the Authorization tab.
Select Password Generate
Click the Web Client tab.
Click Both
Click the VM Backup tab.
Enter the vCenter Server Address, User, and Password
Go to the C:\Program Files\Tivoli\TSM\baclient folder.
Make a copy of the dsm.opt file, appending the Data Mover node name to the new file name. You should end up with two files.
For example: dsm.opt
Edit the new file and remove the ASNODENAME line. Save and exit from the file.
Do not remove the line from the dsm.opt file.
Start the TSM Backup-Archive Client GUI.
Check the boxes to configure the TSM Web Client and the TSM Client Scheduler.
The Web GUI and vCenter Plug-in communicate with the Data Mover via the “TSM Web Client” (“TSM Client Acceptor” service).
Click Next
Change the Option File Name to the dsm.opt.nodename file that you created earlier by copying the dsm.opt file.
Click Next
Enter the TSM
Click Next Select Automatically
Click Next
Add the Data Mover node name after ‘TSM Client Scheduler’
Check this box
Validate that the correct Client Acceptor is used.
Click Next Uncheck this box
Return to the web GUI or vCenter Plug-in
Adding a Second (or more) Data Mover to a
vStorage Backup Server
Configuration of the Datamover Option Files and Services
1) Define the datamover using the ‘Edit Configuration’ task of the Web GUI. 2) Copy an existing datamover dsm.opt.datamover file to create an option
file for the new datamover.
3) Update the new dsm.opt.datamover file, modifying the NODENAME, ERRORLOGNAME, and SCHEDLOGNAME parameters with the new datamover name.
4) Update the HTTPPORT and TCPCLIENTPORT port numbers so they are unique from the other datamovers on this server.
5) Open a Windows command prompt. 6) CD \program files\tivoli\tsm\baclient
7) Invoke the BA Client GUI using the newly created option file: ‘dsm -optfile=dsm.opt.datamover’
7) Enter the node password for the new datamover.
8) Create the TSM Client services per earlier instructions.
Click the Backup tab in the web GUI or vCenter Plug-in to start scheduling backups.
