Logging into 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
HP-UX
/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
HP Tru64 UNIX
/opt/ibm/dscli
IBM i
/ibm/dscli
Novell NetWare
SYS:\IBM\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 have 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, either in the directory where you installed the DS CLI or using the full path name for the DS CLI, you can specify this information using either of the following three methods:
  • You may log in to the DS CLI without specifying any of this information on the command line and the application will prompt you to enter the information interactively. For example: /opt/ibm/dscli/dscli.
  • You may log in to the DS CLI by specifying this information on the command line. For example: dscli -hmc1 mtc032h.storage.tucson.ibm.com -user admin -passwd topn0t.
  • You may 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 into 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 that are provided in this guide are often shown with line wraps that would not occur during your input. These examples are displayed for clarity and other formatting considerations.