




Set Password
The set password command changes the IBM Spectrum® Protect password for your workstation, or sets the credentials that are used to access another server.
If you omit the old and new passwords when you enter the set password command, you are prompted once for the old password and twice for the new password.
Passwords can be up to 63 character in length. Password constraints vary, depending on where the passwords are stored and managed, and depending on the version of the IBM Spectrum Protect server that your client connects to.
- If your IBM Spectrum Protect server is at version 6.3.3 or later, and if you use an LDAP directory server to authenticate passwords
- Use any of the following characters to create a
password:
a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 . ! @ # $ % ^ & * _ - + = ` ( ) | { } [ ] : ; < > , ? / ~
Passwords are case-sensitive and are subject to more restrictions that can be imposed by LDAP policies.
- If your IBM Spectrum Protect server is at version 6.3.3 or later, and if you do not use an LDAP directory server to authenticate passwords
- Use any of the following characters to create a
password:
a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 . ! @ # $ % ^ & * _ - + = ` ( ) | { } [ ] : ; < > , ? / ~
Passwords are stored in the IBM Spectrum Protect server database. Starting with IBM Spectrum Protect 8.1.16, passwords are case-sensitive if SESSIONSECURITY=STRICT. The passwords are not case-sensitive if SESSIONSECURITY=TRANSITIONAL.
On the command line, enclose all parameters that contain 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.

- On Windows systems:
- Enclose the command parameters in quotation marks (").
- Command-line example:
dsmc set password "t67@#$%^&" "pass2><w0rd"



- On AIX®, Linux®, and Solaris systems:
- Enclose the command parameters in single quotation marks (').
- Command-line example:
dsmc set password -type=vmguest 'Win 2012 SQL' 'tsml2dag\administrator' '7@#$%^&7'
Quotation marks are not required when you type a password with special characters in an options file.



For more information on FIPS support, see technote 2007756.
Supported Clients
This command is valid for all clients.
TYPE=DOMAIN
TYPE=VM
TYPE=VMGUEST
Syntax
Parameters
- oldpw
- Specifies the current password for your workstation.
- newpw
- Specifies the new password for your workstation.
- other_server other_user_id other_password
- These three parameters
specify the attributes that the client uses to access another server, such as a filer or an ESXi host.
- other_server
- Specifies the host name or IP address of the server that the client can access to protect files.
- other_user_id
- The user ID of an account on the server that the client uses to log on to the other server. The account must have the privileges that are necessary to perform the operations that are run after the user is logged on to the other server.
- other_password
- The password that is associated with the user ID on the other server.
- TYPE
- Specifies whether this password is for the backup-archive client or for another type of server.
Examples
The following examples use the set password command.
Task
Change your password from
osecret
tonsecret
.set password osecret nsecret
Task
Set up a user ID and password for the root user on the file server
myFiler.example.com
.dsmc set password -type=filer myFiler.example.com root
Please enter password for user id "root@myFiler.example.com": ******** Re-enter the password for verification:******** ANS0302I Successfully done.
Task
Set up a user ID and password for the root user on the file server
myFiler.example.com
.dsmc set password -type=filer myFiler.example.com root secret
Task
Set up a user ID and password for the FastBack server
myFastBackServer
. Use the -fbserver option in the archive fastback and backup fastback commands for the server name.dsmc set password -type=FASTBack myFastBackServer myUserId 'pa$sword'
dsmc set password -type=FASTBack myFastBackServer myUserId "pa$sword"
Important:- The
dsmc set password -type=fastback
command must be repeated on a dedicated client proxy workstation once for each FastBack repository where the backup-archive client is expected to connect. - For network share repositories, issue the
dsmc set password -type=fastback
command in this format:dsmc set password -type=fastback myFBServer domainName:userId password
.The server name that is specified, which is
myFBServer
in this example, must match the name that you specify on the -fbserver option on a backup fastback or archive fastback command. - For the FastBack server or the FastBack Disaster Recovery Hub, the user ID and password that are specified
must have FastBack administrator privileges.
You must issue the
dsmc set password -type=fastback
command once for each FastBack Server branch repository on the FastBack DR Hub that the backup-archive client is expected to connect to.
- The
Task
The backup-archive client is connecting to the FastBack server repository whose short host name is
myFBServer
.user ID
is the FastBack network user ID that has read/write access to the repository share.DOMAIN
is the domain to which the user ID belongs.myNetworkPass
is the corresponding password for the user ID.dsmc set password -type=fastback myFbServer DOMAIN:USERID myNetworkPass
Task
The backup-archive client is connecting to a repository on a DR Hub machine whose short host name is
myFbDrHub
. The user ID is the Windows administrator ID.DOMAIN
is the domain to which the DR Hub machine belongs.myNetworkPass
is the corresponding password for the administrator ID.dsmc set password -type=fastback myFbDrHub DOMAIN:administrator adminPasswd
Task
Set up the Windows domain administrator credentials that are necessary for users to log in to the file restore interface and save the Windows domain credentials. In this example, the Windows domain in which all user accounts are registered is called
example_domain
.Kev_the_admin
is the Windows domain administrator ID andpas$word!
is the corresponding password for the administrator.dsmc set password -type=domain -val "example_domain\Kev_the_admin" "pas$word!"