Logging into the DS CLI application

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

You must ensure that you are in the directory where you installed the DS CLI application. The following list provides a reminder of the supported operating systems default directories where the DS CLI is installed if the directory designation is not changed:

AIX: /opt/ibm/dscli
HPUX: /opt/ibm/dscli
Linux: /opt/ibm/dscli
Sun Solaris: /opt/ibm/dscli
Windows: C:\Program Files\IBM\dscli
HP Tru64: /opt/ibm/dscli
iSeries: /ibm/dscli
Novell Netware: SYS:\dscli

When you log into the DS CLI application (type dscli at the command prompt), you must provide the following information:

HMC1: Specify the primary management console.
User Name: Specify the name of the user account. The default account for the first login is admin.
Password: Specify the user password. The default password for the admin account is admin. However, this password is only good for your first login.
Note: Because the password for the admin account expires 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.

The first time that you log in to the DS CLI, you can specify this information using either of the following two methods:

Ensure you are in the directory where you installed the DS CLI application and type the dscli command at the command prompt. Supply all the log in information with the command. For example: dscli -hmc1 mtc032h.storage.tucson.ibm.com -user admin -passwd topn0t.
Use this command when you use the single-shot mode for the first time and when the DS CLI application is not active on your system. In addition, when you use the single-shot mode, you must include the command that you want to process. For example, if you want to process the lssi command, if you have not activated the DS CLI application, and if you are using the single-shot mode, type: dscli -hmc1 mtc032h.storage.tucson.ibm.com -user admin -passwd topn0t lssi.
When you log into the DS CLI application (from the directory where you installed the DS CLI application) by typing dscli, you are prompted to supply the information for HMC1, user name, and password.

Notes:

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.
You cannot force a line break or wrap by hitting the Enter key and then entering the rest of the command on a second line. The DS CLI application 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.
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.