APAR status
Closed as documentation error.
Error description
Running the "dsmc set password" command specifying a domain ID (domain\admin) does not work correctly due to the back slash "\" being removed. Example: dsmc set password -type=vmguest VMNAME domain\administrator Please enter password for user id "domainadministrator@VMNAME" Note the missing back slash. While the password will be accepted, the backups will fail due to the incorrect credentials being passed. The Linux manual should be updated to reflect this. Initial Impact: Medium Versions affected: 6.4, 7.1, 7.1.1 Linux only
Local fix
When using a domain account, put the domain ID in double quotes: dsmc set password -type=vmguest VMNAME "domain\administrator"
Problem summary
**************************************************************** * USERS AFFECTED: * * IBM Tivoli Storage Manager backup-archive client versions * * 6.2, 6.3, 6.4, and 7.1 UNIX and Linux Backup-Archive Clients * * Installation and User's Guide * * IBM Tivoli Storage Manager backup-archive client versions * * 6.2, 6.3, 6.4, and 7.1 Windows Backup-Archive Clients * * Installation and User's Guide * * In IBM KC: * * V7.1: * * https://www.ibm.com/support/knowledgecenter/SSGSG7_7.1.2/com * * .ibm.itsm.client.doc/r_cmd_setpassword.html * * V6.4: * * https://www.ibm.com/support/knowledgecenter/SSGSG7_6.4.0/com * * .ibm.itsm.client.doc/r_cmd_setpassword.html * * V6.3: * * https://www.ibm.com/support/knowledgecenter/SSGSG7_6.3.0/com * * .ibm.itsm.client.doc/r_cmd_setpassword.html * * V6.2: * * https://www.ibm.com/support/knowledgecenter/SSGSG7_6.2.0/com * * .ibm.itsm.client.doc/r_cmd_setpassword.html * **************************************************************** * PROBLEM DESCRIPTION: * * The documentation for the backup-archive clients does not * * provide accurate information. * **************************************************************** * RECOMMENDATION: * * This problem is currently projected to be fixed in * * documentation for level 7.1. Note that this is subject to * * change at the discretion of IBM. * **************************************************************** *
Problem conclusion
In UNIX and Linux Backup-Archive Clients Installation and User Guides and Windows Backup-Archive Clients Installation and User Guides and IBM Knowledge Center for level 7.1, the "Set password" topic is updated (Backup-archive client options and commands >Using commands>Set password). The "Set Password" documentation is updated to indicate that any command parameters that contain special characters must be enclosed in quotation marks. The "Set Password" topic is updated with the following text: ... Remember: On the command line, enclose all parameters that contains one or more special characters in quotation marks. Without quotation marks, the special characters can be interpreted as shell escape characters, file redirection characters, or other characters that have significance to the operating system. ...
Temporary fix
Comments
APAR Information
APAR number
IT08445
Reported component name
TSM CLIENT
Reported component ID
5698ISMCL
Reported release
71L
Status
CLOSED DOC
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2015-04-21
Closed date
2015-06-22
Last modified date
2015-06-22
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
SC23979105 | SC23979205 | SC23979106 | SC23979206 |
Fix information
Applicable component levels
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGSG7","label":"Tivoli Storage Manager"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"71L","Edition":"","Line of Business":{"code":"LOB26","label":"Storage"}}]
Document Information
Modified date:
22 June 2015