Command-Line Interface; Basic Setup - IBM Storwize V5010 Manual

Command-line interface

The IBM Storwize V5000 Gen2 system has a powerful CLI, which offers even more functions
than the graphical user interface (GUI). This section is not intended to be a detailed guide to
the CLI because that topic is beyond the scope of this book. The basic configuration of the
IBM Storwize V5000 Gen2 CLI is covered. Example commands are described. However, the
CLI commands are the same in the IBM SAN Volume Controller/Storwize family, and more
commands are available to manage internal storage. If a task completes in the GUI, the CLI
command is always displayed in the details, as shown throughout this book.
Detailed CLI information is available at the IBM Storwize V5000 Gen2 web page under the
command-line section, which is at the following address:
https://ibm.biz/BdjaWj

Basic setup

In the IBM Storwize V5000 Gen2 GUI, authentication is performed by using a user name and
password. The CLI uses a Secure Shell (SSH) to connect from the host to the IIBM Storwize
V5000 Gen2 system. Either a private and a public key pair or user name and password
combination is necessary. The following steps are required to enable CLI access with SSH
keys:
A public key and a private key are generated together as a pair.
A public key is uploaded to the IBM Storwize V5000 Gen2 system through the GUI.
A client SSH tool must be configured to authenticate with the private key.
A secure connection can be established between the client and the IBM Storwize V5000
Gen2.
Secure Shell is the communication vehicle between the management workstation and the
IBM Storwize V5000 Gen2 system. The SSH client provides a secure environment from
which to connect to a remote machine. It uses the principles of public and private keys for
authentication. The system supports up to 32 interactive SSH sessions on the management
IP address simultaneously. After 1 hour, a fixed SSH interactive session times out, which
means that the SSH session is automatically closed. This session timeout limit is not
configurable.
SSH keys are generated by the SSH client software. The SSH keys include a public key,
which is uploaded and maintained by the clustered system, and a private key, which is kept
private on the workstation that is running the SSH client. These keys authorize specific users
to access the administration and service functions on the system. Each key pair is associated
with a user-defined ID string that consists of up to 30 characters. Up to 100 keys can be
stored on the system. New IDs and keys can be added, and unwanted IDs and keys can be
deleted. To use the CLI, an SSH client must be installed on that system, the SSH key pair
must be generated on the client system, and the client's SSH public key must be stored on
the IBM Storwize V5000 Gen2.
The SSH client that is used in this book is PuTTY. Also, a PuTTY key generator can be used
to generate the private and public key pair. The PuTTY client can be downloaded from the
following address at no cost:
http://www.chiark.greenend.org.uk
Download the following tools:
PuTTY SSH client: putty.exe
PuTTY key generator: puttygen.exe
802
Implementing the IBM Storwize V5000 Gen2 with IBM Spectrum Virtualize V8.1