HP StorageWorks SAN Virtualization Services
Platform Data Path Module User Guide
This guide provides information about accessing and using the graphical user interface (GUI) and the command
line interface (CLI) of the HP StorageWorks SAN Virtualization Services Platform (SVSP) Data Path Module
(DPM).
Part Number: 5697–0772
Fourth edition: November 2010
Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211
and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items
are licensed to the U.S. Government under vendor's standard commercial license.
The information contained herein is subject to change without notice. The only warranties for HP products and services are set
forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as
constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
Java is a U.S. trademark of Sun Microsystems, Inc.
Microsoft and Windows are U.S. registered trademarks of Microsoft Corporation.
Contents
1 Data Path Module management interface options ................................... 9
2 Using the command line interface ...................................................... 11
There are two ways to interface with the Data Path Module (DPM):
• Over a serial connection using the DPM management command line interface (CLI)
• Over an IP connection using the DPM management graphical user interface (GUI)
Most activity with the DPM GUI occurs during initial configuration and debugging (when requested
by HP Support). Therefore, under normal operation, the DPM GUI is seldom used. Of the two interface
methods, using the serial connection is the preferred method because it more secure than using the
Internet.
This document describes the two interface methods beginning with the CLI.
HP StorageWorks SAN Virtualization Services Platform Data Path Module User Guide9
Data Path Module management interface options10
2 Using the command line interface
This chapter describes the use of the HP StorageWorks SAN Virtualization Services Platform Data
Path Module (DPM) command line interface (CLI). You can configure and manage the DPM with these
common command sets that provide the same functions as the DPM GUI.
CLI overview
The DPM provides a command line user interface through serial, telnet, and ssh connections with
serial being the preferred default. All configuration, maintenance, and monitoring of the DPM is
performed through the CLI.
Command quick reference by object
Table 1 shows which commands are available for the major object types.
Table 1 Commands by object type
PageCommandObject type
22Disable eth command
eths
ports
users22Delete user command
27Enable eth command
36Modify eth command
47Set eth command
54Show eth command
55Show eths command
24Disable port command
29Enable port command
38Modify port command
39Modify ports command
44Reset port command
59Show port command
60Show ports command
19Create user command
26Disable user command
HP StorageWorks SAN Virtualization Services Platform Data Path Module User Guide11
PageCommandObject type
32Enable user command
65Show user command
65Show users command
19Create snmp command
25Disable snmp command
snmp
date/timezone41Modify timezone command
fans
groups
therms
ps
30Enable snmp command
40Modify snmp command
62Show snmp command
36Modify date command
51Show date command
55Show fan command
56Show fans command
57Show group command
57Show groups command
64Show therm command
64Show therms command
61Show ps command
61Show pss command
voltages
Command syntax and command completion
The CLI command syntax is as follows:
command
keyword [value]
keyword [value1] [value2]
The command is followed by one or more keywords. Consider the following rules and conventions:
• Commands and keywords are case sensitive.
• Required keyword values appear in standard font: [value]. Optional keyword values are shown
in italics: [value].
Using the command line interface12
66Show voltage command
66Show voltages command
This CLI provides command completion to minimize the typing needed to run commands. This feature
enables you to press the completion key (the Tab key) to complete a partially typed command line.
If the command line fragment is unambiguous, it is completed with the remainder of the command
line.
If there is more than one possible match for a command line fragment, continue pressing the Tab key
to see each of the possible matches. You then type enough of the command line to distinguish it from
the other possible matches.
In addition, you can get a list of legal fields at any point in the command line. For example, if you
type set debug p, and then press the Tab key, a list of valid debug options beginning with the
letter p is returned.
The completion feature in the CLI also validates previously typed input. If there is an error in the
command line prior to the point where you have requested completion, an error is printed and the
cursor is set to the point where the command line breaks the defined syntax rules.
Online help
The CLI for the DPM includes online help. Type part of a command, and press Enter, to view the help
information, such as a list of arguments or the proper syntax.
Help commands
For information about getting a list of commands, see “Help commands” on page 33. For information
about getting help with a particular command, see “Help command” on page 32.
Example 1.
Typing modify and pressing Enter returns these results:
required arg not present
one of [eth, ntp, snmp, factory, chassis, therm, port, ports, date, timezone,
user, san '?'] required
Example 2.
Typing show use and pressing Enter returns these results:
admin@k-> show use
show user <user name>
show users
“use” is ambiguous, must differentiate between: [user, users]
Please refer to command syntax for detail.
Accessing the CLI
The DPM management (MGMT) port is configured when the HP StorageWorks SAN Virtualization
Service Platform solution is installed on site. The following procedure describes how to use the serial
port with PuTTYtel to access the DPM CLI on the VSM server. The PuTTYtel terminal emulator is provided
on the open source CD in your media kit.
HP StorageWorks SAN Virtualization Services Platform Data Path Module User Guide13
1.With a serial cable between the VSM server and the DPM, open a PuTTYtel session.
Figure 1 PuTTYtel Configuration screen
.
2.Ensure a speed of 9600 is used with a Serial connection type, and click Open. A login screen
appears.
Figure 2 PuTTYtel session login screen
.
Using the command line interface14
3.Log in to the DPM with the default login and password.
NOTE:
HP recommends that you change the default password. If you have not already done so,
run the “Modify user command” on page 42 to change the password.
login: admin
password: password
The following menu options are displayed (see Figure 3).
Figure 3 PuTTYtel console menu options
.
4.Enter commands from the command line to begin managing the DPM with the CLI commands.
Users and groups
The DPM provides two built-in users and two built-in groups: admin is a member of the Administrator
group, and kmonitor is a member of the Monitor group.
Table 2 shows the default password for both accounts. See “Modify user command” on page 42 for
information about changing the password.
NOTE:
The default passwords may have been changed prior to your installation of the DPM. See the records
of the installation for details.
Users in the Monitor group are limited to commands that only view system configuration and status;
Monitor users cannot change the system configuration. See the show commands, such as “Show user
command” on page 65, “Show port command” on page 59, and so on, for more information.
Users in the Administrator group can create and delete users, and they can also modify users, eths,
ports, and perform all of the other commands listed in this document. See “Create user
command” on page 19, “Delete user command” on page 22, “Modify user command” on page 42,
HP StorageWorks SAN Virtualization Services Platform Data Path Module User Guide15
“Modify eth command” on page 36, “Modify port command” on page 38, and “Modify ports
command” on page 39 for more information.
Table 2 summarizes the features of the built-in groups.
Table 2 Built-in users and groups
Built-in groupsBuilt-in users
Default password
View system configuration and status
Create/delete users and
modify
eths/ports/users/...
yesyespasswordadminadmin
noyeskahunaMonitorkmonitor
Using the command line interface16
3 CLI commands
Activate command
Makes sure that the DPM is active (init 3 is up, and all SOAP modules are loaded).
Syntax
activate
Add license command
Adds a new license.
Syntax
add license [key]
Keyword values
[key]
License key to be added.
Notes
Only users belonging to the Administrator group can add or delete licenses.
See also
“Delete license command” on page 20
“Show license command” on page 58
Add syslog command
Adds a remote logging server.
Syntax
add syslog server [host]
port [port number]
socket [socket-protocol]
HP StorageWorks SAN Virtualization Services Platform Data Path Module User Guide17
Keyword values
[host]
Host name of the remote logging server.
[port-number]
IP port number to which the host connects.
[socket-protocol]
Socket protocol (either TCP or UDP, with default being TCP).
Notes
Only users belonging to the Administrator group can add or delete syslog servers.
See also
“Add syslog command” on page 21
“Disable syslog command” on page 26
“Enable syslog command” on page 31
“Show syslog command” on page 63
Clear command
Clears the screen of text.
Syntax
clear
Create debug command
Creates a save state file; erasing any old save state files.
Syntax
create debug dump
See also
“Load debug command” on page 34
“Reset debug command” on page 43
“Save debug command” on page 46
“Set debug command” on page 46
“Show debug command” on page 51
“Watch debug command” on page 67
CLI commands18
Create snmp command
Creates an SNMP receiver.
Syntax
create snmp receiver [name]
Keyword values
[name]
Name of the SNMP trap receiver.
See also
“Delete snmp command” on page 21
“Disable snmp command” on page 25
“Enable snmp command” on page 30
“Modify snmp command” on page 40
“Show snmp command” on page 62
Create user command
Creates a new user in the specified group, or views user settings. The groups defined for the DPM
are Administrator and Monitor. When new users are added, they get the same permissions as the
existing admin or kmonitor users, depending on the group specified in the command. When you issue
this command, you must enter a password for the newly created user that is at least eight characters
in length.
Syntax
create user [user name] group [group name]
Keyword values
[user name]
Name of the new user
[group name]
Name of the group to which the user will belong: Administrator or Monitor.
Notes
Only users belonging to the Administrator group can add, delete, and disable/enable users, and the
current user cannot be disabled or deleted.
See also
“Delete user command” on page 22
HP StorageWorks SAN Virtualization Services Platform Data Path Module User Guide19
“Disable user command” on page 26
“Enable user command” on page 32
“Show user command” on page 65
“Show users command” on page 65
Delete config command
Removes a configuration that was saved by the save config command.
Syntax
delete config [configuration file]
Keyword values
[configuration file]
Configuration file name.
See also
“Load config command” on page 34
“Save config command” on page 46
“Show configs command” on page 50
Delete license command
Removes a license.
Syntax
delete license [key]
Keyword values
[key]
License key to be deleted.
Notes
Only users belonging to the Administrator group can add or delete licenses.
See also
“Add license command” on page 17
“Show license command” on page 58
CLI commands20
Delete snmp command
Removes an SNMP receiver.
Syntax
delete snmp receiver [name]
Keyword values
[name]
Name of SNMP trap receiver.
See also
“Create snmp command” on page 19
“Disable snmp command” on page 25
“Enable snmp command” on page 30
“Modify snmp command” on page 40
“Show snmp command” on page 62
Delete syslog command
Removes a remote logging server.
Syntax
delete syslog server [host]
Keyword values
[host]
Host name of the remote logging server.
Notes
Only users belonging to the Administrator group can add or delete syslog servers.
See also
“Add syslog command” on page 17
“Disable syslog command” on page 26
“Enable syslog command” on page 31
“Show syslog command” on page 63
HP StorageWorks SAN Virtualization Services Platform Data Path Module User Guide21
Delete user command
Removes the specified user from the list of administrators who can access the DPM.
Syntax
delete user [user name]
Keyword values
[user name]
Name of the user that you are removing from the system.
Notes
Only users belonging to the Administrator group can add, delete, and disable/enable users, and the
current user cannot be disabled or deleted.
See also
“Create user command” on page 19
“Disable user command” on page 26
“Enable user command” on page 32
“Show user command” on page 65
“Show users command” on page 65
Disable eth command
The DPM includes four Ethernet interfaces: MGMT, GE1, GE2, and GE3. This command disables the
specified Ethernet interface so that it cannot send or receive network traffic.
This command is used for tightened security purposes. Once you disable the MGMT Ethernet interface
using this command, you can access the CLI and administer the DPM only from the serial console.
Syntax
disable eth [interface name]
Keyword values
[interface name]
Name of the Ethernet interface that you are disabling: MGMT, GE1, GE2, or GE3.
IPv4 or IPv6
Notes
If you are connected through the management port, disabling the MGMT Ethernet terminates any
active network GUI and CLI sessions, requiring a re-login through the serial console. If you are using
the CLI on the serial console, the connection is not be disrupted.
CLI commands22
See also
“Enable eth command” on page 27
“Modify eth command” on page 36
“Set eth command” on page 47
“Show eth command” on page 54
“Show eths command” on page 55
Disable ftp command
Disables use of the File Transfer Protocol (FTP) program to copy files onto the DPM.
Syntax
disable ftp
See also
“Enable ftp command” on page 28
“Show ftp command” on page 56
Disable http command
Disables use of the http protocol and DPM network management interfaces. Disables the use of the
DPM GUI and other remote management tools.
Syntax
disable http
See also
“Enable http command” on page 28
“Show http command” on page 57
Disable insecure command (oboslete)
NOTE:
This command is obsolete and has been removed from the current version of the CLI.
Disables permissions on plain-text transmissions.
Syntax
disable insecure [permission]
HP StorageWorks SAN Virtualization Services Platform Data Path Module User Guide23
Keyword values
[permission]
Either read, write, or all.
See also
“Enable insecure command” on page 28
“Show security command” on page 62
Disable ntp command
Disables use of the ntp protocol on the DPM.
Syntax
disable ntp
See also
“Enable ntp command” on page 29
“Modify ntp command” on page 38
“Restart ntp command” on page 45
“Show ntp command” on page 59
Disable port command
Disables the specified Fibre Channel port number so that it cannot send and receive Fibre Channel
traffic.
Syntax
disable port
[port number]
*
Keyword values
[port number]
Port number is an integer 0–15 to indicate the DPM Fibre Channel port to be disabled.
* indicates all Fibre Channel ports.
See also
“Enable port command” on page 29
“Modify port command” on page 38
“Modify ports command” on page 39
CLI commands24
“Show port command” on page 59
“Show ports command” on page 60
Disable secure command (obsolete)
NOTE:
This command is obsolete and has been removed from the current version of the CLI.
Disables permissions on SSL-encrypted transmissions.
Syntax
disable secure [permission]
Keyword values
[permission]
Either read, write, or all.
See also
“Enable secure command” on page 30
“Show security command” on page 62
Disable snmp command
Disables the specified Simple Network Management Protocol component. By default, the system runs
SNMP version 2. Disabling v3 means that SNMP v3 is turned off, but does not affect SNMP v2.
Syntax
disable snmp [component]
Keyword values
[component]
Either v2, v3, or daemon. Disabling the daemon disables SNMP.
See also
“Create snmp command” on page 19
“Delete snmp command” on page 21
“Enable snmp command” on page 30
“Modify snmp command” on page 40
“Show snmp command” on page 62
HP StorageWorks SAN Virtualization Services Platform Data Path Module User Guide25
Disable ssh command
Disables use of the secure shell (ssh) application to connect to the DPM CLI.
Syntax
disable ssh
See also
“Enable ssh command” on page 31
Disable syslog command
Stops logging to the specified remote logging server. Returns to the local logging mode.
Syntax
disable syslog [host]
Keyword values
[host]
Host name of the remote logging server.
See also
“Add syslog command” on page 17
“Add syslog command” on page 21
“Enable syslog command” on page 31
“Show syslog command” on page 63
Disable telnet command
Disables use of the telnet application to connect to the DPM CLI.
Syntax
disable telnet
See also
“Enable telnet command” on page 31
Disable user command
Temporarily disables the user account without deleting it. The account can later be enabled using the
Enable user command.
CLI commands26
Syntax
disable user [user name]
Keyword values
[user name]
Name of the user account that you are disabling.
See also
“Create user command” on page 19
“Delete user command” on page 22
“Enable user command” on page 32
“Modify user command” on page 42
“Show user command” on page 65
“Show users command” on page 65
Enable bootset command
Set the active bootset.
Syntax
enable bootset [number]
Keyword values
[number]
The number 1 or 2.
Notes
Since there are only two bootsets, enabling one bootset effectively disables the other. Therefore, there
is no “disable bootset” command.
See also
“Show bootset command” on page 48
“Show bootsets command” on page 49
Enable eth command
The DPM includes four Ethernet interfaces: MGMT, GE1, GE2, and GE3. This command enables the
specific Ethernet interface so that it can send or receive network traffic.
Syntax
enable eth [interface name]
HP StorageWorks SAN Virtualization Services Platform Data Path Module User Guide27
Keyword values
[interface name]
Name of the Ethernet interface that you are enabling: MGMT, GE1, GE2, or GE3.
See also
“Disable eth command” on page 22
“Modify eth command” on page 36
“Set eth command” on page 47
“Show eth command” on page 54
“Show eths command” on page 55
Enable ftp command
Enables use of the File Transfer Protocol (FTP) program to copy files onto the DPM.
Syntax
enable ftp
See also
“Disable ftp command” on page 23
“Show ftp command” on page 56
Enable http command
Enables the use of the http protocol and DPM network management interfaces. Enables the use of the
DPM GUI and other remote management tools.
Syntax
enable http
See also
“Disable http command” on page 23
“Show http command” on page 57
Enable insecure command (obsolete)
NOTE:
This command is obsolete and has been removed from the current version of the CLI.
Enables permissions on plain-text transmissions.
CLI commands28
Syntax
enable insecure [permission]
Keyword values
[permission]
Either read, write, or all.
See also
“Disable insecure command” on page 23
“Show security command” on page 62
Enable ntp command
Enables use of the ntp protocol on the DPM.
Syntax
enable ntp
See also
“Disable ntp command” on page 24
“Modify ntp command” on page 38
“Restart ntp command” on page 45
“Show ntp command” on page 59
Enable port command
Enables the specified Fibre Channel port number so that it can send and receive Fibre Channel traffic.
Syntax
enable port
[port number]
*
Keyword values
port number
Port number is an integer 0–15 to indicate the DPM Fibre Channel port to be enabled.
* indicates all Fibre Channel ports.
See also
“Disable port command” on page 24
HP StorageWorks SAN Virtualization Services Platform Data Path Module User Guide29
Loading...
+ 65 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.