Logging in to the DS CLI

You must log in to the DS CLI to use any of the command modes.

Before you begin

You must ensure that you are in the directory where you installed the DS CLI, or use the full path name of the DS CLI. The following list provides the location of the default directory for each operating system:
AIX®
/opt/ibm/dscli
Linux
/opt/ibm/dscli
Oracle Solaris
/opt/ibm/dscli
Windows
(32-bit) C:\Program Files\IBM\dscli
(64-bit) C:\Program Files (x86)\IBM\dscli
IBM i
/ibm/dscli
z/OS
/opt/IBM/CSMDSCLI/dscli

About this task

To log in to the DS CLI, open a command prompt and enter dscli with the following information:
HMC1
Specify the primary management console.
Note: If you are using a 2105 machine type as part of your network and are going to use the Copy Services functions, you must specify the IP address of the primary or secondary domain control server where you installed the DS CLI.
User Name
Specify the name of the user account. The default user names for the first logins are admin and secadmin.
Password
Specify the user password. The default password for the administrator account is admin and the default password for the security administrator account is secadmin. However, these passwords are only good for the first login.
Note: Because the passwords for the administrator and security administrator accounts expire after you log in for the first time, you must change the password before you can perform any other DS CLI command function. Use the chuser command to change your password.
Each time you log in to the DS CLI, you can specify this information by using either of the following three methods:
  • You can log in to the DS CLI without specifying any of this information on the command line and the application prompts you to enter the information interactively. For example: /opt/ibm/dscli/dscli.
  • You can log in to the DS CLI by specifying this information on the command line. For example: dscli -hmc1 mtc032h.storage.tucson.nnn.com -user admin -passwd topn0t.
  • You can log in to the DS CLI by specifying this information on the command line, except for the password, by using the -pwfile parameter instead of the -passwd parameter. For example: dscli -hmc1 9.1.12.123 -user admin -pwfile /home/ming/dscli/security.dat, where "ming" is the user ID used to log in to the operating system. The security.dat file was created by using the DS CLI command managepwfile. See the DS CLI command managepwfile for more details.
Notes:
  1. Entering a DS CLI command at the dscli command prompt requires that you continue entering all the parameters and values until the command is complete. This can result in an automatic line wrap if your command has many parameters and values.
  2. You cannot force a line break or wrap by pressing the Enter key and then typing the rest of the command on a second line. The DS CLI interprets the use of the Enter key as an end to the function and begins to process whatever is contained on the line, ignoring the second line.
  3. The DS CLI command examples are often shown with line wraps that would not occur during your input. These examples are displayed for clarity and other formatting considerations.