HP Commands

PAN Manager Command Reference

Document Number 430-HP0085

May 2011

PM7.0.0

CopyrightCopyright © 2011 Egenera, Inc. All rights reserved.

This document, and the product described in it, is furnished under license and may only be used in accordance with the terms of such license. The content of this document is furnished for information purposes only and is subject to change without notice.

Egenera, Egenera stylized logos, BladeFrame, BladeLatch, BladeMate, BladePlane, cBlade, Control Blade, PAN Manager, pBlade, Processing Blade, sBlade, Switch Blade, PAN Controller, pNode, and vNode are either registered trademarks or trademarks of Egenera, Inc. in the United States and/or other countries.

AMD is a trademark of Advanced Micro Devices, Inc.

EMC, CLARiiON, and Symmetrix are registered trademarks of EMC Corporation.

Intel and Xeon are trademarks of the Intel Corporation in the United States and other countries.

Linux is a registered trademark of Linus Torvalds.

Microsoft and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. The virtual VGA console uses Microsoft Terminal Services Advanced Client (TSAC), which is a copyright of Microsoft Corporation.

MindTerm is copyright AppGate AB.

Red Hat is a registered trademark of Red Hat, Inc. in the United States and other countries.

Sun, Sun Microsystems, the Sun Logo, Solaris, and the Java logo are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.

SUSE is a registered trademark of SUSE LINUX Products GmbH, a Novell business.

VMware, Virtual SMP, and VMotion are registered trademarks or trademarks of VMware, Inc.

Xen, XenSource, XenServer, and XenEnterprise are either registered trademarks or trademarks of Citrix Systems, Inc. in the United States and/or other countries.

All other company and product names are trademarks or registered trademarks of their respective holders.

Printed in the United States of America.[110509:122519]

Egenera, Inc., 165 Forest Street, Marlboro, Massachusetts 01752.

PM7.0.0 i

Contents

Preface

Document Conventions ............................................................................................. iv

Chapter 1: PAN Manager Commands Overview

Using PAN Manager Commands ............................................................................ 1-2

Functional Groupings of PAN Manager Commands .............................................. 1-4

Command Parameter Guidelines ............................................................................. 1-8

The Man Page Format ........................................................................................... 1-11

Chapter 2: PAN Manager CommandsACCOUNT .............................................................................................................. 2-2CONSOLE ........................................................................................................... 2-7DOMAIN ................................................................................................................. 2-9EVENT ................................................................................................................. 2-15EVENTTYPE ....................................................................................................... 2-23INTNET .............................................................................................................. 2-28LICENSE ............................................................................................................. 2-34LPAN ................................................................................................................... 2-37MON .................................................................................................................... 2-49MONDEF ............................................................................................................. 2-55PAN ...................................................................................................................... 2-59PANMGR ............................................................................................................. 2-68PNODE .................................................................................................................. 2-73POOL .................................................................................................................... 2-80

Contents

PM7.0.0 ii

PORT ..................................................................................................................... 2-86PSERVER ............................................................................................................ 2-91ROLE .................................................................................................................. 2-108SMTP .................................................................................................................. 2-111SWITCH .............................................................................................................. 2-113UPLINK .............................................................................................................. 2-117USER ................................................................................................................. 2-122VERSION .......................................................................................................... 2-126VSWITCH ........................................................................................................... 2-129

PM7.0.0 iii

Preface

Welcome to PAN Manager PM7.0.0. The PAN Manager Command Reference is part of the PAN Manager documentation set. Its purpose is to describe how PAN Manager commands are grouped, and provides the command man pages in a print format.

Audience — PAN Manager Command Reference is for PAN Administrators and LPAN Administrators.

Topics — Read this book to learn about the following:

• Using PAN Manager Commands

• Functional Groupings of PAN Manager Commands

• The Man Page Format

• Detailed descriptions of each command

Preface

PM7.0.0 iv

Customer Support

For the latest support, downloads, release notes, and other information resources regarding PAN Manager software, please use the following contact information:

Egenera Global Technical Support

Document Conventions

Internet http://www.egenera.com/support-services-overview.htm

Telephone +1-866-301-3117

Convention Description

> Directory-level delimiter used to navigate the left pane of the PAN Manager GUI.

Example: Resources > Networking

Sans serif italics Variable text, such as a path, a filename, or an LPAN name.

Example: lpan -c lpanname

Sans serif Text that must be typed as shown.

Example: Type root at the login prompt.

Bold The name of a field or window element appearing in a GUI. It also highlights default values in PAN Manager man pages.

Example: In the Users page...


v PM7.0.0

Italics Text that is emphasized.

Example: Do not connect the power.

[text] Text that is optional to a command.

{text} A set of choices, one of which is required.

| Separation of mutually exclusive choices in syntax lines.

Example: lpan {-a|-r} -P pnodename lpanname

Note Information of importance or that may not fit in main text.

Caution Failure to heed a caution could result in loss of data.

Warning — Failure to heed a warning could result in physical harm to the user or the hardware.

Convention Description

!

PM7.0.0 1-1

Chapter 1PAN Manager Commands

Overview

This overview of the PAN Manager Command Reference includes the following topics:

• Using PAN Manager Commands

• Functional Groupings of PAN Manager Commands

• Command Parameter Guidelines

• The Man Page Format


1-2 PM7.0.0

Using PAN Manager Commands

PAN Manager provides a set of commands that you can use from the Linux command line or from scripts like any other Linux command. These commands are described in detail in the next chapter, and their documentation can also be accessed on-line as described below.

Using the PAN Manager Commands in Scripts

When you create scripts using PAN Manager, keep in mind the following guidelines:

Script Syntax

Each PAN Manager command is actually a subcommand of the PAN Manager shell (/home/panmgr/panmgr/bin/esh). If you use PAN Manager commands in a shell script, you must do one of the following:

• Use the entire esh pathname with each command. For example:# /opt/panmgr/bin/esh lpan -l

• Add /opt/panmgr/bin to your user PATH, then include the 'esh' prefix with each command. For example:# esh lpan -l

Before you use the scripts in your own environment, you need to gather all the information required for configuration. We also recommend that you create a logical diagram of your planned configuration. Before you create scripts specific to your site, you need the following information:

• Your domain name

• IP addresses of the POPSs, PAN Manager, and any external resources to which you plan to connect

PAN Manager Commands Overview

PM7.0.0 1-3

• Virtual Switches that communicate with the external network (through an uplink)

Scripting: Guidelines and Best Practices

Each PAN Manager command is a subcommand of the PAN Manager shell (/opt/panmgr/bin/esh). In the operating system on the PAN OPServers, each PAN Manager command is aliased in each user account’s login profile, by default:

alias account='esh account'alias app='esh app'alias domain='esh domain'...

You can use any of a number of scripting languages, including bash, perl, or csh in which to embed specific PAN Manager command lines.

Argument Placement

For PAN Manager commands that have add, create, edit, or modify options, the argument of those options must be placed at the end of the command string. For example, to add a user and specify the user’s email address, enter the following:

# user -a -E [email protected] username

Even though the option flag (-a) is at the beginning of the command, the argument (username) must be at the end of the command string. If the argument of one of these options is not the last string, a parsing error may occur, losing the user’s original intent.

Accessing PAN Manager man Pages

PAN Manager man pages are reference pages available for each PAN Manager command. PAN Manager man pages conform to the standard Red Hat Linux man page format.


1-4 PM7.0.0

You access PAN Manager man pages from the Linux prompt like any other man page, except that you must preface the command with an “egenera_” prefix. For example, to view the lpan man page, enter the following command at the Linux prompt:

# man egenera_lpan

Accessing PAN Manager Help

To display the options and appropriate syntax for each command, enter the following command, substituting the actual command name:

# help commandname

Functional Groupings of PAN Manager Commands

The following tables group PAN Manager commands according to commonly performed functions. See the PAN Manager Administrator’s Guide for a detailed understanding of how and when these functions are used while managing a PAN.

Getting Started PAN Administrators use the following commands to configure the basic settings for a PAN:

Table 1.1 Configuration Commands

Task Commands used

Rename the domain. DOMAIN

Configure the PAN administrative domain, including PAN Manager (which runs on the PAN OPServers.

PAN

PANMGR


PM7.0.0 1-5

Configuring Connectivity

PAN Administrators use the following commands to set up their PAN’s network communication:

Establishing Access Control

PAN Administrators use the following commands to set up user accounts for everyone who will work directly in their PAN:

Creating LPANS PAN Administrators use the following commands to create LPANs and add resources to them:

Table 1.2 Set-up Commands

Task Commands used

Display the ports on the converged switches. PORT

Configure Ethernet and Fibre Channel Uplinks. UPLINK

Configure private management network properties.

INTNET

Configure the Virtual Switches (vSwitches). VSWITCH

Table 1.3 Access Control Commands

Task Commands used

Create Linux accounts. ACCOUNT -a

Create Linux account passwords. ACCOUNT -m -P

Assign administrative roles to PAN Manager users.

USER -aR

Table 1.4 LPAN Commands

Task Commands used

Create a new LPAN. LPAN -c

Allocate Processing Nodes (pNodes) to an LPAN.

LPAN -aP


1-6 PM7.0.0

Creating pServers

After PAN Administrators have created LPANs, they or an LPAN Administrator can use the following commands to create pServers within the LPANs:

Allocate vSwitches to an LPAN. LPAN -aV

Assign administrative roles to users of the LPAN.

USER -aR

(Optional; an LPAN Administrator can also do this) Create a local pool of pNodes for use only in the LPAN.

POOL

Table 1.4 LPAN Commands (Continued)

Task Commands used

Table 1.5 pServer Commands

Task Commands used

Create a new pServer. PSERVER -c

Assign a pNode pool—local or global —as the primary blade for a pServer.

PSERVER -P

Assign a specific pNode, or a local or global pool as the pServer’s failover processing resource.

PSERVER -F

Add a resource to a pServer. PSERVER -a

Boot a pServer. PSERVER -b


PM7.0.0 1-7

Monitoring the PAN

PAN or LPAN Administrators use the following commands to display the status of or alter the various hardware and software monitors in their PAN or LPAN:

Table 1.6 Monitoring Commands

Task Commands used

List events that have been registered by the PAN Manager software.

EVENT

List the event types that the PAN Manager software monitors or modify a specific event type’s actions.

EVENTTYPE

(PAN Administrator only) List and modify the default trigger values for each monitor the PAN Manager software monitors.

MONDEF

List and modify the default trigger values for each system monitor of the PAN.

MON


1-8 PM7.0.0

Command Parameter Guidelines

Table 1.7 lists the formats required and guidelines to be aware of when specifying options and arguments with PAN Manager commands.

Table 1.7 Command Parameter Guidelines

Object Format Notes and Guidelines

Named Objects (general) Object names must begin with an alphanumeric character and are limited to a maximum of 32 characters with this limited character set: [a-z][A-Z][0-9][.][-][_][$]

Duplicate names in the same namespace are not allowed.

LPAN lpanname Maximum of 64 LPANs per PAN

pServer lpanname/pservername Maximum of 128 pServers per LPAN, and 1024 per PAN.

vNIC vnic Maximum of 6 vNICs per pServer

vHBA vhba Maximum of 2 vHBAs per pServer

Uplink uplinkname Maximum of 12 single-port uplinks per domain. (Note: For redundancy and best practices, you will likely prefer to create uplinks that contain multiple ports.)

vSwitch vswitchname Maximum of 64 management vSwitches per PAN (one per LPAN); maximum of 4000 (management and non-management) vSwitches per PAN.


PM7.0.0 1-9

VLANs vlan Maximum of 320 VLAN instances per PAN. A VLAN instance is: one VLAN per vSwitch per FlexFabric port. For example, if the PAN contains 5 vSwitches, each of which is associated with a single uplink that consists of 2 FlexFabric ports, the number of VLAN instances consumed is 5 x 2 = 10.

World Wide Name (WWN)

XX:XX:XX:XX:XX:XX:XX:XX or XXXXXXXXXXXXXXXX

where X is {0-9|A-F|a-f}. The string consists of 8 hexadecimal digit pairs separated by colons or 16 hexadecimal digits with no colons.

The leftmost hexadecimal digit must be 0 to 7.

MAC address XX:XX:XX:XX:XX:XX or XXXXXXXXXXXX

where X is {0-9|A-F |a-f}. The string consists of 6 hexadecimal digit pairs separated by colons or 12 hexadecimal digits with no colons.

Processing Nodes(pNodes)

pnodename (pN)

where N is the physical slot number of the pNode in the chassis

Maximum of 16 pNodes per chassis (enclosure)

pNode Pools lpanname/localpoolname, globalpoolname

20 (local) pools per LPAN20 global pools per PAN200 total (local and global) pools per PAN

Table 1.7 Command Parameter Guidelines (Continued)



1-10 PM7.0.0

Chassis c1 One chassis per domain

Domain name One domain per PAN

FlexFabric Switch s1, s2 Two FlexFabric Switches per chassis (enclosure)

Port portname (sX:Y)

where X is the number of the FlexFabric switch and Y is the port number on that switch

12 available ports in the domain: 6 on each FlexFabric switch

PAN Manager Role rolename Possible roles are:

• PAN-Administrator

• lpanname-LPAN-Administratorlpanname-LPAN-Operatorlpanname-LPAN-Monitor

Table 1.7 Command Parameter Guidelines (Continued)



PM7.0.0 1-11

The Man Page Format

PAN Manager man pages follow a format commonly seen in Linux man pages. The format for PAN Manager man pages can include the following items:

Table 1.8 Man Page Fields

Format Content

NAME The command name followed by a brief functional description.

SYNOPSIS A listing of syntax showing how to use each command option.

DESCRIPTION The details of command functionality and important technical details.

OPTIONS The descriptions of each command parameter.

EXAMPLES Specific uses of some or all of a command's arguments.

RETURN VALUES A description of the command's return value, a useful feature for scripting purposes.

SEE ALSO An alphabetical listing of other commands related to the task.

PM7.0.0 2-1

Chapter 2PAN Manager Commands

This chapter provides an alphabetical list of all PAN Manager commands, and is formatted to provide users with printed and HTML versions of the command manpages.

PAN Manager Command Syntax

For PAN Manager commands that have add, create, edit, or modify options, the argument of the option must be placed at the end of the command string. For example, to add a user and specify the user’s email address, enter:

user -a -E [email protected] username

Note: Even though the option flag (-a) is at the beginning of the command, the argument (username) comes at the end of the command string. If the argument of one of these options is not the last string, a parsing error may occur, losing the user’s original intent.

ACCOUNT

PM7.0.0 2-2

ACCOUNT

NAME account - Creates, lists, or modifies a user’s Linux account on a PAN OPServer

SYNOPSIS account [-l] [username]

account -a [-L "descriptive_label" -N groupname] username

account -r [-R] username

account -m [-U UID] [-P password] [-N groupname] [-L "descriptive_label"] [-H homedirectory] [-I groupID] [-S defaultshell] username

account [-lG]

account [-aG |-rG] groupname

DESCRIPTION The account command provides a Linux account tool for the PAN Manager software. Only PAN Administrators use the account command to add, remove, modify, or list user accounts on both PAN OPServers. PAN Manager creates Linux user accounts by duplicating the Linux account information on both PAN OPServers.

By default, PAN Manager is enabled to allow PAN Administrators to modify/create/remove user accounts on the Linux operating system on the PAN OPServers. Be sure to issue these accounts with discretion, as they have security implications.

To disable PAN Manager from managing the Linux user accounts on the PAN OPServer, specify 'pan -u no'. This means that you cannot use the PAN Manager account command to set up Linux user accounts. For additional information, see PAN Manager Administrator’s Guide.


2-3 PM7.0.0

PAN Manager Command Naming Conventions

Names must begin with either an alphanumeric character or a period (.) and are limited to a maximum of 32 characters with this limited character set: [a-z][A-Z][0-9][.][-][_][$]. Duplicate names in the same name space are not allowed.

Additional naming conventions for this command include:

username

Indicates the username PAN Manager uses to identify a PAN Manager user.

groupname

Indicates a Linux-recognized group that exists on the PAN OPServers.

OPTIONS -aG, --addgroup groupname

Creates a Linux-recognized group. To create a Linux user account and add that user to a group at the same time (using the -N (groupname) option), you must first use the -aG (addgroup) option to create the group.

-a, --add username

Creates a Linux user account. Use this option with the -L (description) or the -N (groupname) option. The username must be unique. We recommend that you add a user to group at the same time you create a Linux user account so you do not create a new GID in the /etc/group file with the same number as the UID created. See the Linux usermod man page for more information.

-H, --homedir homedirectory

Associates a login directory associated with the specified Linux user account. When an account is initially created, a default /home/username directory is created and assigned as the login directory for the user. If you use this option to change the login directory, the

ACCOUNT

PM7.0.0 2-4

directory must exist before the user can log in. This option is only valid with the -e (edit) option.

-I, --groupid groupID

Specifies a group ID number for a Linux user account.

-l, --long

Lists the Linux user accounts and displays the description, UID, groupname, GID, home directory, and default shell for each username. This option is only valid with the -l option. Using the command without an argument lists all the Linux user accounts by username only.

-L, --description "descriptive_label"

Adds a description to the information associated with the specified Linux user account. This option is valid with the -a (add) or -m (modify) options. If the text contains spaces, enclose it within double quotes. For example:

account -aN development -L "Development manager" cgable

-lG, --listgroup

Lists the current groupnames with their group ID.

-m, --modify username

Allows you to edit the information associated with the user account. With this option, you must specify any or all of the -U (UID), -N (group/GID), -L (description), or -H (home directory) options.

-N, --groupname groupname

Specifies a group that is recognized by Linux to which to add a user. Groups are created with the -aG (addgroup) option. This option is used with the -a (add) and -m (modify) options and requires a groupname as an argument. When you create a new Linux account, the default group is that user. For this reason, we recommend that you specify an existing group.


2-5 PM7.0.0

-P, --password "password"

Sets a Linux user password for a user account. You can create or modify a user password using this option with the -m (modify) option.

-r, --remove username

Removes a Linux user account. For complete removal of a user, add the -R (recursive) option to remove the home directory of the user as well.

-R, --recursive

Removes all traces of the Linux account, including the user’s default directory and the /etc/group and /etc/passwd listings for the specified user. This option is only valid with the -r (remove) option.

-rG, --removegroup groupname

Deletes a Linux-recognized group.

-S, --shell defaultshell

Specifies the Linux shell associated with the specified Linux user account. When an account is initially created, the default assignment is the bash shell. If you use this option to change a user’s shell, make sure that the shell file already exists before the user logs in. This option is only valid with the -m (modify) option.

-U, --uid UID

Specifies a user ID to use with the specified Linux user account. By default, when you add a user account, a UID is automatically generated. Use this option to change the default UID of the Linux user account. This option is only valid with the -m (modify) option.

EXAMPLES List user accounts by name, description, UID, groupname, GID, home directory, and default shell:

account -l

ACCOUNT

PM7.0.0 2-6

Create Linux user cgable and add him to the development group; also pick up GID, if it exists:

account -N development cgable

Edit a user’s home directory for login:

account -m -H /home/panmgr cgable

Delete user account cgable and remove the /home/cgable directory:

account -r -R cgable

Add the group called production:

account -aG production

Add user cgable to the production group:

account -m -N production cgable

RETURN VALUE On success, returns 0. On error, returns 1.

AUTHOR Egenera, Inc.

SEE ALSO ROLE

PAN

To view the man page for a PAN Manager command, enter the following (in all lowercase letters) at the Linux prompt: man egenera_commandname (for example, man egenera_pan).


2-7 PM7.0.0

CONSOLE

NAME console - opens a terminal session on a pServer

SYNOPSIS console [lpanname/pservername]

DESCRIPTION The console command opens a Linux console device on a pServer. Entering the console command without an argument displays a list of initialized or booted pServers to choose from; if you enter the console command with a valid pServer argument, the console opens immediately.

The PAN Manager console initiates a terminal session and sends standard input to the pServer console. The pServer console output is displayed as the standard output. A PAN Manager console normally translates the inputs for sigint (Control-C), sigquit (Control-/), and sigtstp (Control-z).

To abort a pServer console, press Enter once and type a tilde character (~) followed by a period (.). There is a one–second pause after typing the tilde character in which to type the period; if the "." is not typed within one second, the abort sequence is terminated. If both characters in the sequence (~.) are not typed within one second, the sequence is not sent to the pServer (thus not echoed) and the pServer connection is aborted.

Issues to be aware of when using the console command include:

• Once opened, a pServer console remains opened until it is aborted, even after the pServer is shut down.

• In the case of certain network communication errors, you may need to re-establish a pServer console. An administrator can open a console on a pServer to watch the pServer's output as it boots if it has been previously booted.

CONSOLE

PM7.0.0 2-8

• Opening a console on an uninitialized or unbooted pServer opens the console late which means you may miss the first few seconds of booting.

OPTIONS Without an argument, the console command displays a list of initialized or booted pServers to which you have permission to connect. To open a specific console, specify its corresponding number.



SEE ALSO PSERVER



2-9 PM7.0.0

DOMAIN

NAME domain - Lists hardware and configuration information about a specified domain (a collection of one or more chassis that share a common fabric and network resources)

SYNOPSIS domain --list-supported-types

domain [-l] [name]

domain [-n newname] [-L "location"] name

domain -a [-T typename] -I ipAddress {-U user -P passwd} [name]

domain -m -I ipAddress [-U user] [-P passwd] name

domain -r [-f] name

DESCRIPTION The domain command lists the status of all resources and configurations within the Processing Area Network (PAN), and manages the interactions between the PAN OPServers and the domain. (A domain is a collection of one or more chassis that share a common (stacked) fabric and have access to the same network and Input/Output resources.)

Administrators other than the PAN Administrator can use the domain command to display the status, processor configurations, pNodes, and current usage details of a domain.

When the PAN Administrator adds a domain to the PAN, PAN Manager automatically adds two ports, one from each physical switch, to the existing uplink called default. Later, when the PAN Administrator creates an LPAN, PAN Manager automatically creates a vSwitch (used for the private management network only), allocates it to the LPAN, and associates it with the default uplink.

For details about adding a domain to the PAN, see PAN Manager Configuration and Installation Guide.

DOMAIN

PM7.0.0 2-10




name

Specifies the name of a domain.

We recommend that you rename a domain to something specific to your application. This name is used in arguments when you issue the pan, pserver, and switch commands.

OPTIONS --list-supported-types

Lists the enclosure products that PAN Manager supports.

-a, --add

Adds a domain to the Processing Area Network (PAN), by using the -I option to specify the IP address that is already associated with the HP Virtual Connect FlexFabric domain.

Optionally, you can also specify the name of the domain when adding it to the PAN:

If you do not specify the name of the domain, PAN Manager uses the name you specified as part of the configuration steps in the HP Virtual Connect FlexFabric module.

If you do not specify the name of the domain, and you did not configure a name in the HP Virtual Connect FlexFabric module, PAN Manager uses a default name, such as domain1.


2-11 PM7.0.0

-f, --force

Used with the -r (remove) option, removes a domain from the PAN without a prompt.

-I, --ip-address {ipAddress}

Specifies the HP Virtual Connect FlexFabric IP Address you configured on the enclosure. (This is the IP address PAN Manager uses to contact the enclosure and its interconnects.)

-L, --location {“text”}

Specifies a helpful description of the physical location of the domain. (If the description contains spaces, enclose it within double quotes.)

-l, --long

Lists details about the domain and all pNodes and physical switches in the domain, including:

For the domain:

• The name of the domain and its management IP address

• Its domain type (c7000)

• An optional but useful description of the domain’s physical location

• The maximum possible number of pNodes (16)

For each pNode in the domain:

• full name

• power status (On/Off)

• current use (if any) in an LPAN and pServer

• number of sockets

• clock rate (in gigahertz)

• supported random access memory (RAM)

DOMAIN

PM7.0.0 2-12

• chip architecture

• whether it is currently marked as a selected pNode (using PAN Manager)

For each physical switch in the domain:

• the switch’s full name

• power status (On/Off)

• on which network fabric it is configured. (A fabric is a grouping of physical switches within the same domain that have common connectivity.)

• its Type (Converged). “Converged” means that the switch supports both Ethernet and Fibre Channel ports, and therefore external connectivity to Ethernet networks and Fibre Channel storage arrays.

• the number of physical non-stacking ports available (6)

-m, --modify

Realigns the PAN Manager settings with those of a domain whose settings have changed outside of PAN Manager control. In this situation, the domain is out of contact with PAN Manager: there is no need to modify the domain’s settings if the domain is still in contact with PAN Manager. An example: if some physical harm has come to the domain, and the IP address must be reset, or if there were a security related need to change the password on the domain.

-n, --rename newname [name]

Specifies a new name for the domain. (If there is only one domain in the PAN, you do not need to specify the domain’s current name (name)). This change takes effect immediately.

-P, --password {password}

Specifies the password you used in the VirtualConnect GUI when setting up the c7000 enclosure. For details, see PAN Manager Configuration and Installation Guide.


2-13 PM7.0.0

-r, --remove

Removes a domain from the Processing Area Network (PAN). To use this option, you must first remove the ports from any uplinks that are configured in the domain.

-T, --type {typename}

Specifies the type of domain product (c7000). You can only specify the domain’s type when adding (-a) the domain to the PAN.

-U, --username {username}

Specifies the username you specified in the VirtualConnect GUI when setting up the c7000 enclosure. For details, see PAN Manager Configuration and Installation Guide.

EXAMPLES List details about the domain and all pNodes and physical switches in the domain:

domain

Change the domain name from enclosure_b to my7000_unit_b:

domain -n my7000_unit_b enclosure_b



SEE ALSO EVENTTYPE

LPAN

PAN

PNODE

POOL

PSERVER

ROLE

DOMAIN

PM7.0.0 2-14



2-15 PM7.0.0

EVENT

NAME event - Lists the details of an instance of a triggered event in a PAN

SYNOPSIS event [-N [number]][[-V |-v severitylevel][-E |-I |-i eventid] [-T |-t timestamp][-M keyword][-L number]][-S {O|I|R}] [-b [domain:c1/]{pcN|pN} | -R type [targetName] ]

event -u -S {O|I|R} [-a]|[[-V |-v severitylevel][-I |-i eventid] [-T |-t timestamp][-M keyword][-L number]] [-b [domain:c1/]{pcN|pN} | -R type [targetName] ]

event -U eventid -S {O|I|R}

event -E eventid

DESCRIPTION The event command offers a filter for viewing an event or event listings in a PAN. The event command allows administrators to do the following:

• Display all events for a PAN sequentially by event ID by using the event command without an option or argument. Use the options and arguments to display more specific event information.

• Filter PAN, LPAN, pServer, or pNode event listings within the PAN or within an LPAN.

• Modify the status of events based on the event filter.

See the OPTIONS section in PAN Manager Administrator’s Guide for more information.



EVENT

PM7.0.0 2-16


domain/pn

Specifies an overall domain and a specific pNode within the chassis.

You must use a forward slash (/) between the domain name and the pNode name. For example, pNode 2 in the domain named domain3 would be referred to as domain3/p2.

pNodes are numbered from their slot locations, 1 through 16.

lpanname/pservername

Specifies a pServer. You must use a forward slash (/) between the LPAN name and the pServer name. For example, the pServer Web1 in the LPAN called production would be referred to as production/Web1.

OPTIONS -a, --all

Updates all events, used with the -u option.

-b, --bulk-update-status

Sets status of a number of events. Usually used to resolve a large number of events. Use the -S option to specify the event status to set. Use the -a option to set the specified status of all events or use a combination of filter options (-i -I -v -V -t -T -L) to specify a specific range of events.

-E, --eventid eventid

Specifies a single event listing by its event ID. Use this option if you are interested in the details of a single event and you know the event ID of the event.


2-17 PM7.0.0

-I, --id-after eventid

Filters events that occurred after the specified event. You can view all events after the specified event or combine this option with other option(s) to create a more specific filter.

-i, --id-before eventid

Filters events that occurred before the specified event. You can view all events before the specified event or combine this option with other option(s) to create a more specific filter.

-L, --last-events number

Filters events displaying only the last specified number of events, such as the last ten events. You can combine this option with other option(s) to create a more specific filter.

-M, --message-contain keyword(s)

Filters events using only a keyword or keywords that you know are part of the message printed for that type of event. For example, using "domainOne/p2" will return all events for this specific pNode that contain this text in the message, while using "core voltage" will return all events of this specific event type. Combining these strings, as in the example, "domainOne/p2 core voltage" returns only events on this specific pNode with this specific event type.

-N, --num-events number

Pauses the display of events after a specific number of events are printed. To display the next set of events, press the “Return” or “y” key. To stop a specific number of listings before it is complete, press the “q” key. This option can take a number argument to set a number of events to display at once; for example the command event –N 7 displays seven events and pauses until you press the “return” or “y” key.

Note: Without this option, all events that match your criteria are displayed at once. In the case of many events, you may not see the entire list of events you have asked for.

EVENT

PM7.0.0 2-18

-R, --type type [targetname]

Displays events that pertain only to a specific type of object, or optionally, to a specific instance (targetname) of that type. Supported type and targetname values are:

chassis [name]domain [domain]licenselpan [lpanname]panpnode [pN]pool [globalpoolname | lpanname/localpoolname]pserver [lpanname/pservername]uplink [uplinkname]vswitch [vswitchname]

-S, --status {O|I|R}

Specifies the status of an event, or list of events (Open, Investigating, or Resolved). Use this option to filter a list of events or modify a specific event status by combining this option with the -u (--update-status) or -b (--bulk-update-status) option.

-T, --time-after “mm/dd/yy hh:mm:ss”

Lists events that occurred after a specified date and time. You can view all events after this time or combine this option with other options to create a more specific filter. For example, you must follow the format: "mm/dd/yy hh:mm:ss".

-t, --time-before “mm/dd/yy hh:mm:ss”

Lists events that occurred before a specified date and time. You can view all events before this time or combine this option with other options to create a more specific filter. You must follow the format: "mm/dd/yy hh:mm:ss".

-u, --update-status eventid

Modifies the status of an event. You must use this option with the -S (status) option to specify a range of events.


2-19 PM7.0.0

-V, --severity-more-or-equal-to severity_number

Lists events with a severity greater than or equal to the specified number. You can view all events of equal or more severity than the specified number or combine this option with other option(s) to create a more specific filter.

-v, --severity-less-or-equal-to severity_number

Lists events with a severity less than or equal to the specified number. You can view all events of equal or less severity than the specified number or combine this option with other option(s) to create a more specific filter.

EXAMPLES View all events:

event

View all events after event 2200, ten at a time (on domain domainOne):

event -I 2200 -N 10 domainOne

View events 2200 to 2500, 5 at a time (on domain domainOne):

event -I 2200 -i 2500 -N 5 domainOne

View the last 8 events of severity 3 or less (3 to 6), 5 at a time:

event -L 8 -v 3 -N 5

View the last 8 events of severity 2 or greater (1 and 2), for a pServer named rivers/nile:

event -L 8 -V 2 rivers/nile

List all events that pertain to all pNodes in your PAN or LPAN:

event -R pnode

EVENT

PM7.0.0 2-20

Display all events that pertain to a specific pNode (such as p8):

event -R pnode p8

List all events that pertain to all pServers in your PAN (if you are a PAN Administrator) or LPAN (if you are an LPAN Administrator, LPAN Operator, or LPAN Monitor):

event -R pserver

List all events that pertain to a single pServer (such as pserver1 in the LPAN my_lpan):

event -R pserver my_lpan/pserver1

View all events of status “I” (Investigating) that are of severity 3 or greater (1 to 3), 12 at a time:

event -S I -V 3 -N 12

Change the status of an event, 2545, to resolved ("R"):

event -u 2545 -S R

Resolve all events that are of severity 4 and higher:

event -u -S R -V 4



SEE ALSO DOMAIN

EVENTTYPE

LPAN

MON

PAN


2-21 PM7.0.0


EVENT

PM7.0.0 2-22


2-23 PM7.0.0

EVENTTYPE

NAME eventtype - Lists or modifies event types monitored in a PAN

SYNOPSIS eventtype [-l][eventtypeID] [-R type targetname]

eventtype [-a |-r emailaddress][-e {default|custom}] -P eventtypeID

DESCRIPTION The eventtype command lists or modifies actions for a specified event type monitored in a PAN. The eventtype command allows administrators to do the following:

• List or modify event actions only within your PAN or LPAN by name and event type ID. The -l (list) option lists detailed information about each event type monitored within your PAN or LPAN.

• Customize event type actions for sending email notifications if certain events occur.

You can only use the eventtype command for an event type that is within your PAN or LPAN. Administrators use the appropriate command to set the default event actions for their PAN or LPAN (using the pan or lpan commands).




domain/pn

EVENTTYPE

PM7.0.0 2-24

PAN Manager naming conventions require you to use a forward slash (/) between the domain name and the pNode name. For example, pNode 6 on the domain named domain2 would be referred to as domain2/p6.

pNodes are numbered according to their slot locations, 1 through 16.

lpanname[/pservername]

Specifies a pServer. You must use a forward slash (/) between the LPAN name and the pServer name. For example, the pServer Web1 in the production LPAN would be referred to as production/Web1.

OPTIONS -a, --add-email email_address

Adds the address of a person to which PAN Manager sends an email notification when a specified event monitor is triggered. Use this option to modify the list of email addresses to include an email address not included in the PAN or LPAN default list and only for a specific event type.

-e, --enable-action {default|custom}

Specifies whether a default PAN or LPAN event action is activated for the specified event action or whether it has the customized setting activated.

PAN or LPAN administrators use the pan or lpan commands to set the default event actions for their PAN or LPAN. Customized settings are only permitted within a PAN or LPAN and do not override event actions for other LPANs.

After making the customized setting, the PAN or LPAN administrator must use the eventtype -e custom command to activate the customized setting.

To restore the event actions to the PAN or LPAN’s default values, use the eventtype -e default command. This option allows


2-25 PM7.0.0

customized settings to be activated and inactivated repeatedly without having to reset the event actions for the event type.

Using the eventtype command for an event type that is not within your PAN or LPAN is not permitted and returns an error.

-l, --long

Displays a list of specified event types, either for an entire domain or for one or a group of pServers or pNodes. Use the -l option with the -R type targetname option to display details about the event types that pertain to a specific component.

-P, --pan-domain

Specifies the PAN in which the event type ID's command action takes effect. Use this option with the -a (add email), -r (remove email), or -e (enable action) option to specify the PAN in which the command action takes effect.

-R, --type {type targetname}

Displays the categories of events that can be reported for a specific type of object and a specific instance (targetname) of that type. Supported type and targetname values are:

chassis [name]domain [domain]licenselpan [lpanname]panpnode [pN]pool [globalpoolname | lpanname/localpoolname]pserver [lpanname/pservername]uplink [uplinkname]vswitch [vswitchname]

-r, --remove-email email_address

Removes the address of a person the PAN or LPAN Administrator no longer wants to receive email notification.

EVENTTYPE

PM7.0.0 2-26

EXAMPLES List all the event types for the LPAN called forest:

eventtype -R lpan forest

List all the event types for the pServer owl in the LPAN forest:

eventtype -R pserver forest/owl

List the actions for a specific pNode (pNode 2):

eventtype -R pnode p2

Add [email protected] to the current list of email recipients for status changes for all event types:

eventtype -a [email protected] -e custom

Display a long listing of the event types for POPS 14:

eventtype -l -R pnode p14



SEE ALSO DOMAIN

EVENT

LPAN

MON

PAN



2-27 PM7.0.0

INTNET

PM7.0.0 2-28

INTNET

NAME intnet - Lists or modifies the private “internal” management network of the Processing Area Network (PAN)

SYNOPSIS intnet [-N network] [-I iface] [-U uplink] [{[-a]|-r} -V vlanMin-vlanMax] [-f]

intnet [-l]

DESCRIPTION The intnet command lists or modifies the properties for the management network of PAN, and for the PAN Manager application that runs on the PAN OPServer. This management network governs network connectivity between PAN Manager and the resources and configurations in the Processing Area Network (PAN).

Use the intnet command to modify the following settings for your domain’s management network configuration:

• The IP address of the management network

• The name of the network interface, on the PAN OPServers, for the management network

• The name of the uplink through which pServers communicate with the PAN OPServer

• The VLANs to be assigned to management vSwitches (vSwitches used exclusively by the management network). In order to create an LPAN, you must first allocate to the PAN, a range of VLANs for management use only.

Important: To ensure proper network connectivity between pServers on which the PAN Tools software is installed, and the PAN OPServers, you must enable multicast forwarding on the VLANs that are assigned to management vSwitches.


2-29 PM7.0.0

Caution: Before making any configuration changes with the intnet command, you must shut down all managed pServers in a domain to ensure that PAN Agents and Heartbeat agents restart properly.

When you create an LPAN, PAN Manager automatically creates a management vSwitch for exclusive use by all pServers in that LPAN. PAN Manager automatically assigns a VLAN to that vSwitch from the range of private management VLANs that you had allocated to the PAN (using intnet -aV).

When you create a pServer, PAN Manager automatically configures two network interfaces (vnic0 and vnic1) that connect the pServer to the management vSwitch. You can configure the two vNIC interfaces you use for management for other network I/O as well.

Important: If you change the interface (intnet –I) or uplink (intnet –U) of the private management network, you must issue lpan --reset-intnet in each LPAN in the PAN, then reinstall the PAN Tools software on each pServer on which it was installed before. (For more information about this procedure, see the LPAN man page; for more information about installing/reinstalling the PAN Tools software on pServers, see PAN Manager Administrator’s Guide.)

Important: If you use a pServer’s operating system to configure network bonding, do not use the vNICs that are used for the private management network in the bonded network interface. This can disrupt the domain’s private management network.

Without any options, the intnet command lists basic information about the management network:

• the IP addresses (subnet address, netmask, and broadcast address) of the management subnet. (This management subnet is a private network you must determine at your local site.)

• the interface name, on the PAN OPServers, of the management network

INTNET

PM7.0.0 2-30

• the name of the uplink used for Ethernet network traffic between the PAN OPServers and the domain

• the range of VLANs for management network use only (allocated to the PAN during the setup process)

OPTIONS -a, --add

Used with -V, adds a range of VLANs to the PAN. Each of these VLANs then becomes available to configure on a vSwitch that handles management network traffic.

(When adding a range of VLANs (-V), you can also omit the -a option altogether.)

-f, --force

Forces any modification without a prompt.

-I, --interface iface

Configures PAN Manager to use a specific interface for the management network. This interface must already exist, having been created during system setup, when the networking for the PAN OPServers was configured. (See PAN Manager Configuration and Installation Guide for details.) The default name for this interface is bond1.

-l, --long

In addition to basic information about the management network, lists management resources for each LPAN: its subnet IP address, the VLAN associated with the LPAN's management vSwitch, and the name of the management vSwitch.

-N, --network network

Sets the network IP address (also known as the subnet IP address) for the domain’s management network.Though the network IP address is set by default to 10.255.128.0, you can use any commonly accepted private network that complies with your data center’s network topology.


2-31 PM7.0.0

-r, --remove

Used with -V, removes a range of management VLANs that can be configured on a vSwitch to which pServer vNICs can connect.

-U, --uplink uplink

Names the uplink to be used for the management network. The default management network uplink is named default.

-V, --vlans vlanMin-vlanMax

Specifies a range of VLANs set aside for management of the domain. The maximum number of management network VLANs per domain is 64.

EXAMPLES Display the domain’s management network settings:

# intnet

Display the domain’s management network settings and details about each LPAN’s management settings:

# intnet -l

Import a range of 64 VLANs for use by management vSwitches.

# intnet -aV 3901-3964



SEE ALSO LPAN

PSERVER

UPLINK

VSWITCH

INTNET

PM7.0.0 2-32

To view the man page for a PAN Manager command, enter the following (in all lowercase letters) at the Linux prompt: man egenera_commandname (for example, man egenera_pserver).


2-33 PM7.0.0

PM7.0.0 2-34

LICENSE

NAME license - Adds, modifies, or lists PAN Manager licenses

SYNOPSIS license -a filename -d displayname

license

license -l [displayname]

license -k [-l] [displayname]

license -n newdisplayname -d existingdisplayname

license -r displayname

license -u filename -d existingdisplayname

DESCRIPTION PAN Manager provides the following types of licenses:

• PAN Virtualization and Management System (enables a pNode to boot)

• Server Portability and Failover (enables a pNode to fail over to another pNode)

You must assign display names to individual license files.

OPTIONS -a, --add-license filename

Adds new licenses to PAN Manager from a license file. Specify the full path to the location of the license file.

-d, --display-name displayname

Specifies the license file to be used. Must be used in conjunction with another option such as -a (add) or -n (new display name).

Using Licenses

2-35 PM7.0.0

-k, --list-keys [displayname]

For each installed PAN Manager license, lists the license key, the type of license, and how many pNode sockets the license supports.

-l, --long [displayname]

With no displayname argument, displays a detailed listing of all installed PAN Manager licenses and their files. If displayname is specified, displays a detailed listing of only that license file. Specifying license with no options displays summary information.

-n newdisplayname -d existingdisplayname

Changes the display name of a license file.

-r, --remove-license displayname

Removes a license file and its license keys from PAN Manager. (You should maintain backup copies of license files if there is any chance you will need to re-install them.)

-u, --update-license newfilename -d existingdisname

Updates existing licenses as specified by their display name from a new license file. Specify the full path to the new license file.

EXAMPLES Add a license file in /tmp named pmlicense to PAN Manager with a display name license1:

license -a /tmp/pmlicense -d license1

List all the licenses and a description of each license for the PAN:

license -l

List the details of license1:

license -l license1

PM7.0.0 2-36

Update (replace) the license1 keys with the keys in a new license file in /tmp named newpmlicense:

license -u /tmp/newpmlicense -d license1

Remove a license from PAN Manager and delete its associated license file:

license -r license1


SEE ALSO To view the man page for a PAN Manager command, enter the following (in all lowercase letters) at the Linux prompt: man egenera_commandname (for example, man egenera_pserver).


2-37 PM7.0.0

LPAN

NAME lpan - Creates, lists, or modifies an LPAN configuration

SYNOPSIS lpan [-l] [lpanname]

lpan {-c |-d [-f]} lpanname

lpan [-n new_name] [-D "text"] lpanname

lpan -e [{-a |-r} -E emailaddress] [-S {1-6}] lpanname

lpan -g globalpoolname {[-F {yes|no}] [-U {yes|no}]} lpanname

lpan {-a|-r} -I imagename lpanname

lpan {-a|-r} -P pnodename lpanname

lpan {-a|-r} -V vswitchname lpanname

lpan {-a|-r} {-M |-W} { minVal-maxVal | val1[,val2]…[,valN] | [minVal] –N number} lpanname

lpan -b [-w [-q]] lpanname

lpan -s [-f] [--time "min" -m "textmessage"][-w [-q]] lpanname

lpan [-x|-X] [-f] [--time "min" -m "textmessage"] [-w [-q]] lpanname

lpan --reset-intnet lpanname

DESCRIPTION The lpan command creates, lists, or modifies an LPAN configuration. LPAN Administrators use the lpan command to:

• Create, modify, or remove an LPAN configuration.

• List all the resources currently allocated to the LPAN(s) under their control.

• Boot, reboot, or shut down a specific LPAN and its currently active pServers.

• Configure default actions for LPAN events.

• Boot, shut down, reboot, or release resources for all the pServers in an LPAN.

LPAN

PM7.0.0 2-38

• Authorize LPAN access for global pools.

An LPAN is a set of logically isolated computing resources that includes processors, network connections, and storage allocated to an organization. PAN Manager software provides each organization the ability to exclusively manage its set of resources after the resources are allocated by a PAN Administrator. These resources include the following:

• pNode resources — Specify pNodes available to pServers within the LPAN, or authorize pServers to access a global pool of pNodes. Note that each global pool must explicitly be given access to LPANs (for example, lpan -F yes -g globalPool2 foo), pServers must be configured with a specific local pool (for example, pServer -F localPool2 foo/ps1), and local pools must be linked with accessible global pools (for example, pool -G globalPool2 foo/localPool2).

• Storage resources — Allocate World Wide Names (WWNs) that pServers can use to connect to Fibre Channel vSwitches that are uplinked to external storage arrays.

• Network resources — Allocate MAC addresses that pServers can use to connect to Ethernet network vSwitches that are uplinked to one or more physical switches on the external network.

• vSwitches — Allocate vSwitches that pServers can use to connect to internal and external networks.

• Media images — Allocate software media images, such as the PAN Tools software or operating system software, for the LPAN’s pServers to use.

After an LPAN has its resources, LPAN Administrators use the pserver command to create pServers, by assigning to them processing, network, and storage resources. LPAN Administrators may then use the lpan command to define an activation order for the pServers within their LPAN, boot their LPAN, and specify shutdown options for their LPAN.


2-39 PM7.0.0

When you create an LPAN, PAN Manager automatically creates a vSwitch (named “intnetN“ and used only for the private management network), allocates it to the LPAN, and associates it with the uplink configured for the private management network.

For more information about creating and modifying LPANs, see the OPTIONS section of this man page and PAN Manager Administrator’s Guide.




domain/pn


PAN Manager naming conventions require you to use a forward slash (/) between the domain name and the blade name. For example, pNode 2 in chassis 1 on the domain named production would be referred to as production:c1/p2. pNodes are numbered as follows:

• From their slot locations, 1 through 16.

vswitchname

Specifies a virtual switch (vSwitch). Use the vswitch command to create a vSwitch.

OPTIONS --reset-intnet

Changing the properties of the private management network of the PAN can adversely affect the network connectivity and failover

LPAN

PM7.0.0 2-40

behavior of existing LPANs and pServers. If you change the interface (intnet –I) or uplink (intnet –U) of the private management network, you must issue the lpan --reset-intnet command, then reinstall the PAN Tools software on each pServer on which it was installed before. (For more information about installing/reinstalling the PAN Tools software on pServers, see PAN Manager Administrator’s Guide.)

To use the lpan --reset-intnet command, you must first shut down all pServers in the LPAN, even those that are in Unmanaged mode.

Issuing the lpan --reset-intnet command performs the following operations:

• Sets pServers in Managed mode to Unmanaged mode.

• Sets each pServer's management IP addresses to null. (Management IP addresses that PAN Manager had assigned to the pServer are set to null; management IP addresses other than those PAN Manager had assigned to the pServer (“override” IP addresses) remain unaffected.)

• Unassigns the management vSwitch from each pServer.

• Removes the management vSwitch from the LPAN, and deletes the vSwitch.

• Creates a new management vSwitch and allocates it to the LPAN.

• Assigns two new management IP addresses to the pServer.

• Connects the pServer to the new management vSwitch.

• Sets previously managed pServers that previously had been in Managed mode to Managed mode.

After issuing the lpan --reset-intnet command, you must do the following for each pServer in the LPAN:

• For pServers on which PAN Tools were installed (those that were in Managed/Enhanced mode): re-install the PAN Tools software.


2-41 PM7.0.0

• For pServers on which PAN Tools were not installed (those that were in Managed/Basic mode), determine whether the pServer is using the management IP addresses that PAN Manager assigned to it, by specifying:

pserver –l lpanname/pservername

In the command output, in the section entitled Management IPs:

• if the column Intnet is labeled (currently active), then the pServer is using the management IP addresses that PAN Manager assigned to it. In this case, the lpan --reset-intnet command has already overwritten the old management IP addresses with new ones. You must now configure these new management IP addresses in the pServer's operating system.

• if the column User Override is labeled (currently active), then the pServer is using IP addresses other than the ones that PAN Manager assigned to it. In this case, no action is required: the "override" IP addresses you configured on the pServer will continue to function properly.

--time “min”

Specifies an interval of time (in minutes) before an LPAN shuts down. Use this option with the -s (shutdown), -x (reboot), or -X (reboot all) option.

-a, --add

Adds a resource to the LPAN.

Used with -e, configures the email alerts that result from PAN Manager events of specific severities.

Used with -I, adds a media image to the LPAN for pServers to use.

Used with -M (for MAC addresses), allocates to the LPAN specific network resources or a range of network resources that are not already allocated to any LPANs.

LPAN

PM7.0.0 2-42

Used with -P, adds a processing resource (a pNode) to the LPAN for pServers to use.

Used with -W (for World Wide Names), allocates to the LPAN specific storage resources or a range of storage resources that are not already allocated to any LPANs.

-aE, --add-email emailaddress

Adds a recipient to the list of addresses to which PAN Manager sends email notification of LPAN events. Combine this option with the -e (default-event-action) option to activate the setting. You set the severity criteria for email notification for PAN or LPAN events with the -S (severity) option.

-aI, --add-image {imagename}

Adds a media image to the LPAN for pServers to use.

-aM, --add-mac { minVal-maxVal | val1[,val2]…[,valN] | [minVal] –N number }

Allocates to the LPAN specific network resources (MAC addresses) or a range of network resources that are not already allocated to any LPANs, to assign to pServers in the LPAN. You can define a range by its minimum and maximum value, or as a number of MAC addresses starting with a specific minimum value.

-aP, --add-pnode {pnodename}

Specifies a pNode to be used as a processing resource for the pServer(s) of an LPAN.

-aV, --add-vswitch {vswitchName}

Allocates to the LPAN a Virtual Switch that was created by the PAN Administrator. An Ethernet vSwitch can provide one or more pServers with network connectivity; a Fibre Channel vSwitch can provide one or more pServers with connectivity to storage resources.


2-43 PM7.0.0

-aW, --add-wwn { minVal-maxVal | val1[,val2]…[,valN] | [minVal] –N number }

Allocates to the LPAN specific storage resources (World Wide Names) or a range of storage resources that are not already allocated to any LPANs, to assign to pServers in the LPAN. You can define a range by its minimum and maximum value, or as a number of WWNs starting with a specific minimum value.

-b, --boot

Boots an LPAN (that is, each pServer in the LPAN). To change the boot behavior of a specific pServer, use the pserver command.

Note: If an LPAN fails to boot, it is possible that one of the pServers was not able to boot with a configuration that prevented the LPAN boot process. See the pserver man page (specifically, its -o (optional) option) or PAN Manager Administrator’s Guide for more information.

-c, --create lpanname

Creates a new LPAN, within a PAN, named as the LPAN Administrator wishes. PAN Administrators use this command in consultation with each LPAN Administrator.

-D, --description {“text”}

Sets an identifying label for an LPAN. (If the text contains spaces, enclose it within double quotes.)

-d, --delete

Removes a specified LPAN. Use the -f (force) option to delete without prompting. All pServers in the LPAN must be shut down before this command succeeds.

-e, --default-event-action

Activates event type actions for all events in the LPAN. Use this option to set (-a) or remove (-r) the criteria and email recipients for notification of events.

LPAN

PM7.0.0 2-44

-F, --failover-only {yes|no}

Combined with the -g (global pool) option, provides (using yes) or denies (using no) all current and future pServers in the LPAN failover access to the pNodes in a global pool of failover pNodes. (To create a global pool of pNodes, see the pool command.)

Use the -U (unlimited) option to give pServers full boot access to the pNodes in the global pool.

-f, --force

Performs the specified command without prompting.

-g, --global-pool {globalpoolname}

Specifies the global pool of pNodes to which the LPAN is to have either failover (-F) access or unlimited (-U) boot access.

-l, --long

Displays comprehensive information about all configurations and resources in the LPAN.

-m, --message {“textmessage”}

Specifies an optional warning message to be printed before an LPAN is shut down. Use this option to provide details to LPAN operators and monitors of how long before a shutdown will occur. Use this option after the -s (shutdown), -x (reboot), or -X (reboot all) option. (If the text contains spaces, enclose it within double quotes.)

-N, --number {howMany}

When adding or removing resources from an LPAN (MAC addresses or World Wide Names), specifies the number of resources to add or remove. Used with minVal, specifies the number of resources to add or remove beginning with a specific value.

-n, --rename {newname}

Renames an LPAN. The change takes effect immediately (no reboots required).


2-45 PM7.0.0

-q, --quiet

Used with the -w (wait) option, suppresses console output when used with -b (boot), -x (reboot), or -X (reboot all) options.

-r, --remove

Removes a resource from the LPAN. Use this option in combination with other options to remove specific resources from the LPAN.

-rE, --remove-email {emailaddress}

Removes an email recipient of PAN Manager system alerts.

-rI, --remove-image {imagename}

Removes a media image from the LPAN.

-rM, --remove-mac { minVal-maxVal | val1[,val2]…[,valN] }

Removes from the LPAN individual MAC addresses, or a range of MAC addresses, that can be used for pServer network connectivity. This makes the MAC addresses you remove from the LPAN available to allocate to another LPAN.

-rP, --remove-pnode {pnodename}

Removes a pNode from the LPAN. This makes the pNode you remove from the LPAN available to allocate to another LPAN.

-rV, --remove-vswitch {vswitchname}

Removes a Virtual Switch from a specified LPAN. You can not remove a vSwitch from the LPAN if it is connected to any pServer vNICs or vHBAs. PAN Administrators use this option in consultation with each LPAN Administrator.

-rW, --remove-wwn { minVal-maxVal | val1[,val2]...[,valN] }

Specifies a World Wide Name (storage resource) to be removed from a specified LPAN. PAN Administrators use this command in consultation with each LPAN Administrator.

LPAN

PM7.0.0 2-46

-S, --email-severity integer

Sets the severity criteria for email notification for LPAN events. Use this option with the -e (default-event-action) option. By default, this value is 2.

-s, --shutdown lpanname

Halts the processing of an LPAN, including all of its pServers. The current LPAN configuration is saved for the next LPAN boot or reboot. To create a conditional shutdown, combine this option with the --time “min“, --message “textmessage“, or -w (wait) options.

-U, --unlimited {yes|no}

Combined with the -g (global pool) option, provides (using yes) or denies (using no) all current and future pServers in the LPAN full boot access to the pNodes in a global pool of pNodes. (To create a global pool of pNodes, see the pool command.)

Use the -F (failover) option to provide or deny pServers failover access to the pNodes in the global pool.

-w, --wait

Causes the lpan command to pause while a boot or shutdown process is underway and displays a progress indicator. Use this option with either the -b (boot), -s (shutdown), -x (reboot), or -X (reboot all) options in cases in which you would like to suspend command-line operations until the boot, reboot, or shutdown is completed, such as when using a script.

-X, --reboot-all lpanname

Reboots all pServers in an LPAN, including pServers that are shut down. Use the -f (force) option to reboot without prompting. To perform a conditional reboot, combine this option with the --time, -m (message), or -w (wait) options.

-x, --reboot lpanname

Reboots only pServers in the LPAN that are currently booted. Use the -f (force) option to reboot without prompting. To perform a


2-47 PM7.0.0

conditional reboot, combine this option with the --time, -m (message), or -w (wait) options.

EXAMPLES Create an LPAN named mygroup:

lpan -c mygroup

Allocate two pNodes to the LPAN mygroup:

lpan -a -P mydomain:c1/p2 -P mydomain:c1/p3 mygroup

Add a descriptive label to the LPAN mygroup:

lpan -D "Processing area for project" mygroup

Allocate a Virtual Switch named storage_vsw to this LPAN:

lpan -aV storage_vsw mygroup

Force the deletion of an LPAN named testlpan without a verification prompt:

lpan -d -f testlpan

List all pServers in an LPAN named doc:

lpan doc

Enable the LPAN lpan_qa to have failover access to the pNodes in global pool IA32:

lpan -g IA32 -F yes lpan_qa

Enable the LPAN lpan_dev to have boot access to the pNodes in global pool IA32:

lpan -g IA32 -U yes lpan_dev


LPAN

PM7.0.0 2-48


SEE ALSO DOMAIN

EVENTTYPE

MON

MONDEF

PAN

PNODE

POOL

PSERVER

UPLINK

To view the man page for a PAN Manager command, enter the following (in all lowercase letters) at the Linux prompt: man egenera_commandname (for example, man egenera_lpan).


2-49 PM7.0.0

MON

NAME mon - Lists or modifies the statistical monitors for system processes on pNodes, LPANs, or a domain

SYNOPSIS mon [-l][-R type targetname]

mon -M {monitor_name|monitor_id} -T trigger_number {[-H high_value][-L low_value][-D duration]}

DESCRIPTION The PAN Manager mon command lists or modifies the statistical monitors and their trigger values for processes on each pServer or across an LPAN. There are two sets of processes that you can monitor using PAN Manager software — system resources and hardware resources. Only the following system resource triggers can be modified:

• CPU (utilization, load average)

• Memory (current: physical and virtual)

• Network (packets, errors)

• Swap (available space)

• Paging (available space)

• Filesystem (available space)

The LPAN Administrator role is required to use the mon command to optionally configure any monitor trigger for a specified LPAN or pServer.



MON

PM7.0.0 2-50


domain/pn


Monitor Names and IDs

Each monitor has a unique name and ID and has settings that include its configurability as well as trigger number(s) and trigger values. To see the exact name and ID for the event monitors for a domain, LPAN, or pServer, use the mon -l -R command with the appropriate type and targetname arguments.

Trigger Numbers and Values

Each monitor has one or more trigger numbers that contain trigger value settings. Trigger numbers specify a set of trigger values specific to each event monitor and can number one or greater. Trigger values are the statistical values that create an event and are specific to the trigger number for an event monitor. Before modifying trigger values from the default values, determine the trigger number and the trigger values for the specific monitor using the mon -l -R command with the appropriate type and targetname arguments. High and low trigger values depend upon the resources monitored, while the duration value is used to calculate a timed average and must be greater than 120 seconds.

OPTIONS -D, --duration number_of_seconds

Specifies a duration, in seconds, used to calculate a timed average for monitoring over which a trigger value is monitored. For example, some triggers work by monitoring a system value and triggering an event the moment the system value exceeds a threshold value; others trigger an event when the system value is averaged over a timed duration and the averaged value exceeds a threshold value. The duration is used in the latter case. This input value must be greater than 120.


2-51 PM7.0.0

-H, --high-value high-value_integer

Specifies an upper-limit threshold trigger over which the event monitor triggers an event.

-L, --low-value low-value_integer

Specifies a lower-limit threshold trigger under which the event monitor triggers an event.

-l, --long

Lists setting information about all or specified event monitors. The display includes a monitor ID, its trigger types and trigger values, and the event actions for a specified pServer or LPAN. Not specifying an argument lists this information for all the monitors within the current LPAN for LPAN Administrators, or within a domain for PAN Administrators.

-M, --monitor {monitorname|monitor_ID}

Specifies an event monitor by its name or monitor ID. Use this option with the -l (long) option to display the settings for an event monitor by its name or monitor ID. (If the monitor name contains spaces, be sure to enclose it within double quotes.)

-R, --type {type targetName}

Displays monitors that pertain only to a specific type of object and a specific instance (targetname) of that type. Supported type and targetname values are:

chassis [domain:chassis]domain [domain]lpan [lpanname]pnode [pN]pserver [lpanname/pservername]uplink [uplinkname]

-T, --trigger triggernumber

Specifies an exact monitor trigger to be modified. Trigger numbers and their values are displayed for each monitor with the mon -l -M command. In general, triggers are numbered 1 or greater and some monitors have more than one trigger number. Use this option in combination with the -M (monitor-name) option to modify a

MON

PM7.0.0 2-52

specific monitor trigger value, followed by the -H (high-value), -L (low-value), or -D (duration) option.

EXAMPLES List the triggers for the monitors of the entire LPAN named Staging:

mon -l -R lpan Staging

List the triggers for the monitors of the pServer named Web1 in the Staging LPAN:

mon -l -R pserver Staging/Web1

Modify the monitor named “pServer rivers/nile Swap Utilization” so that it triggers events if Swap Utilization exceeds 90% or returns below 60% for a duration of 5 minutes:

mon -M "pServer rivers/nile Swap Utilization” -T 1 -H 90 -L 60 -D 300

Reset this monitor’s triggers by specifying its monitor ID number (1930) instead of its name:

mon -M 1930 -T 1 -H 90 -L 60 -D 300

This displays the new trigger values in parentheses:

Trigger 1 Criteria: Sent when pServer rivers/nile Swap Utilization exceeds (90)% or then returns below (60)% for (300) seconds

Display a long listing of the monitors for the LPAN named finance:

mon -l -R lpan finance



2-53 PM7.0.0


SEE ALSO EVENT

EVENTTYPE

INTNET

LPAN

MONDEF

PSERVER


MON

PM7.0.0 2-54


2-55 PM7.0.0

MONDEF

NAME mondef - Lists or modifies the default trigger values for statistic monitors for the PAN

SYNOPSIS mondef [-l] [monitor-name]

mondef [-H high-threshold] [-L low-threshold] [- D duration] -T trigger-type monitor-name

DESCRIPTION The PAN Manager mondef command lists or modifies the default trigger values for statistic monitors for the PAN domain. Default trigger values are inherited from the most current configuration; therefore the default values for LPANs come from the default values of the PAN domain.

PAN Administrators use the mondef command to list or modify the PAN domain default values, and the mondef -l command to see a list of the default trigger values for the PAN domain.

LPAN Administrators use the mon command to list or modify the set of statistical monitor trigger values within their LPAN.




MONDEF

PM7.0.0 2-56

Monitor Names and Trigger Types

Each monitor and its trigger type refers to either a threshold event trigger or a return event trigger that is used as an argument to the mon command. To see the exact name of each trigger type name for each monitor, use the mon -l lpanname/pservername or mon -l lpanname commands.

Trigger Values

The default values list thresholds as percentages of resources used and a duration used to calculate a timed average in seconds.

OPTIONS -D, --duration number_of_seconds

Sets the default time limit, in seconds, for a monitor trigger. A trigger duration must be at least 120 seconds.

-H, --high-threshold high-value_integer

Sets the default upper limit for a monitor trigger.

-l, --list

Lists information about all the monitors for the PAN domain. This option provides information such as the type and trigger values of each monitor.

-L, low-threshold low-value_integer

Sets the default lower limit for a monitor trigger.

-T, --trigger-type triggernumber

Identifies which trigger of the monitor you are modifying.

EXAMPLES List the trigger default values for the disk space monitors within the PAN domain:

mondef -l system threshold.remainingdiskspace


2-57 PM7.0.0

Modify default trigger values for CPU utilization and disk space monitors within the PAN domain. The high threshold event trigger for CPU utilization is set to 33, while the low threshold event trigger for disk space monitors is set to 10 and the duration for the low event trigger is extended to 300 seconds:

mondef -H 33 -T system.threshold.high system.threshold.memoryutiliz

mondef -L 10 -D 300 -T system.threshold.low system.threshold.remainingdiskspace

You do not need to reference the former trigger values since the new values overwrite the previous values.



SEE ALSO EVENT

INTNET

LPAN

MON

PSERVER


MONDEF

PM7.0.0 2-58


2-59 PM7.0.0

PAN

NAME pan - Lists and modifies the Processing Area Network configuration

SYNOPSIS pan [-l]

pan [-n newPanName] [-D "description"] [-O "owner"]

pan -u [yes|no]

pan -e [{-a|-r} -E emailaddress] [-S {1-6}]

pan --collect-save-state [--force] [--exclude-log-history] [--exclude-pan-trace]

pan --list-last-save-state

pan [-l] {-M|-W} [-F]

pan [-l] -V

pan {-a|-r} {-M|-W|-V} {minVal-maxVal | val1[,val2]…[,valN] | minVal -N number}

pan -i [-l] [image_name]

pan -a -I image_path [-A {yes|no}] [-D “description”] image_name

pan -m [-n new_image_name] [-A {yes|no}] [-D “description”] [-I image_path] [-f]] image_name

pan –r -I image_name

DESCRIPTION The pan command lists the status of the domains within a PAN and lets a PAN Administrator do the following:

• List configuration information for all resources in the PAN

• Manage globally unique MAC addresses World Wide Names (WWNs), including displaying which of these resources are available for assignment to LPANs, and which are in use by LPANs and pServers. (To assign MAC addresses and WWNs to LPANs, use the lpan command.)

PAN

PM7.0.0 2-60

• Manage pServer media images. You can configure one or more media images to be assigned automatically to a newly created LPAN, or set them to be unavailable to LPANs unless specifically allocated to them (using the lpan command).

• Configure PAN-wide values for user accounts and default actions for PAN Manager events.

• Collect save-state information for debugging purposes.

• Enable or disable the PAN Manager Linux user account tool.

Without any arguments, the pan command lists configuration information for all resources in the PAN.



OPTIONS --collect-save-state

Instructs PAN Manager to collect save state information from both PAN OPServers and generate a save state file (on the master POPS: /tmp/panname_save_states.tar). Combining this option with the -f (force) option overwrites the existing save state file without prompting.

--exclude-log-history

Used with --collect-save-state, omits information from expired event logs when creating the save state file

--exclude-pan-trace

Used with --collect-save-state, omits stack trace information when creating the save state file


2-61 PM7.0.0

If for some reason PAN Manager is not running, PAN Administrators can log on to either accessible POPS and run the save state script manually:

# /opt/egenera/bin/save_state pathname.tar.gz

where pathname is the full pathname of the resulting compressed tar file. This action gathers save state information only for the POPS to which you logged on.

--list-last-save-state

Displays the last save state that was created, including the date it was created, its location on the master POPS, its file size, and whether it includes expired logs or stack traces.

-A, --assign-all-lpans {yes|no}

Specifying -A yes makes the specified media image available to all LPANs (and therefore all pServers) in the PAN.

Specifying -A no makes the specified media image unavailable to future LPANs in the PAN, unless you then use the lpan command to give explicit access to individual LPANs. If an LPAN has access to a media image, all pServers within the LPAN can use the image.

-a, --add

Used with -e, configures the alerts that result from PAN Manager events of different severities.

Used with -I, adds a media image to the PAN for pServers to use. PAN Administrators must register any media image before multiple pServers use it.

Used with -M (for MAC addresses), -W (for World Wide Names), or -V (for VLANs), adds a range of values for the PAN Administrator to make available to one or more LPANs.

-aM, --add-mac

Adds (to the PAN) individual MAC addresses, or a range of MAC addresses, used for pServer network connectivity. You can then

PAN

PM7.0.0 2-62

make these resources available to one or more LPANs for the pServers in those LPANs to use.

-aV, --add-vlan

Adds (to the PAN) individual VLANs, or a range of VLANs, to be used only for pServers whose network connectivity is internal to the domain (that is, pServers connected by a non-uplinked vSwitch). You can then make these resources available to one or more LPANs for the pServers in those LPANs to use.

-aW, --add-wwn

Adds (to the PAN) individual World Wide Names (WWNs), or a range of WWNs, to be used for pServer storage connectivity. You can then make these resources available to one or more LPANs for the pServers in those LPANs to use.


Sets a helpful description of your choosing for the PAN. (If the text contains spaces, enclose it within double quotes.)

Combined with the -m (modify) option, changes the description of the PAN.

Combined with the -a and -I options, sets a description of the media image you are registering in the PAN.

-e, --event-action

Activates alerts in response to PAN Manager events in the PAN.

Combined with -E, specifies the email recipients to be notified about PAN Manager events.

Combined with -S, specifies the severity of PAN Manager event that triggers an alert. Severity ranges from 1 (most severe) to 6 (least severe).

For more information about configuring events and triggers, see PAN Manager Administrator’s Guide.


2-63 PM7.0.0

-E, --email

Specifies an email recipient to be notified about PAN Manager events.

-F, --free

Displays the specified type of resources (-M MAC addresses) or (-W World Wide Names) that are available to assign to LPANs.

-f, --force

Combined with the --collect-save-state option, automatically overwrites an existing save state file (if one already exists) without prompting.

Combined with -m (modify-image), changes the location of a media image without prompting.

-I, --image image_path

Specifies the full pathname, on either of the PAN OPServers, of a media image, such as /opt/panmgr/media_images/image_name.iso.

-i, --list-images

Lists the names of all available media images in the PAN. Combined with -l (long), displays detailed information about each image.

-l, --long

Displays comprehensive information about all configurations and resources in the PAN.

Combined with other options, such as -M (MAC addresses), -W (World Wide Names), or -i (media images), displays detailed information about those resources.

-M, --mac, --mac-address

Lists the ranges of MAC addresses in the PAN: those that are allocated to LPANs and those that are not.

PAN

PM7.0.0 2-64

Combined with -F (free), lists only the MAC address ranges that are not already allocated to LPANs.

-m, --modify-image

Modifies the configuration settings of a media image, in the following ways:

Combined with -n, renames a media image.

Combined with -A yes, allocates the media image to all current and future LPANs in the PAN; combined with -A no, does not allocate the media image to future LPANs, but allows any currently existing LPANs to maintain access to the media image.

-N, --number {howMany}

Specifies the number of consecutive MAC addresses (-M), World Wide Names (-W), or VLANs (-V) to add to (or remove from) the PAN, beginning with an explicit minimum value (minVal).

-n, --rename {newName}

Specifies a new PAN name, or when combined with -m, a new media image name.

-O, --owner {“text”}

Descriptive text of your choosing about the owner of the PAN. (If the text contains spaces, enclose it within double quotes.)

-r, --remove

Used with -e, removes the alerts that result from PAN Manager events of different severities.

Used with -I, removes a media image from the PAN.

Used with -M (for MAC addresses), -W (for World Wide Names), or -V (for VLANs), removes a range of values that the PAN Administrator can make available to LPANs.


2-65 PM7.0.0

-rM, --remove-mac

Removes from the PAN individual MAC addresses, or a range of MAC addresses used for pServer network connectivity.

-rV, --remove-vlan

Removes from the PAN individual VLANs, or a range of VLANs used for pServer network connectivity.

-rW, --remove-wwn

Removes from the PAN individual World Wide Names (WWNs), or a range of WWNs used for pServer storage connectivity.

-S, --event-severity {1-6}

Combined with -e, specifies the severity of PAN Manager event that triggers an alert. Severity ranges from 1 (most severe) to 6 (least severe). Specifying -S 2 causes events of severity 1 and 2 to trigger an alert.

-u, --user-account [yes|no]

Without arguments, shows whether PAN Manager is allowed to create and remove Linux user accounts.

Combined with the yes argument, allows PAN Manager to create and remove Linux user accounts. (This is the default setting and enables the account command.)

Combined with the no argument, disallows PAN Manager from creating or removing Linux user accounts. This makes the account command non-functional.

-V, --vlan, --network-vlan

Lists the ranges of VLANs in the PAN.

Combined with -F (free), lists only available VLANs.

-W, --wwn, --world-wide-name

Lists the ranges of World Wide Names (WWNs) in the PAN: those that are assigned to LPANs and those that are not.

PAN

PM7.0.0 2-66

Combined with -F (free), lists only available WWN ranges that are not already allocated to LPANs.

EXAMPLES List the current domains and their current state within the PAN domain:

pan

Display whether the PAN Manager user account tool is enabled for the PAN domain:

pan -u

List the display names of all media images in the PAN

pan -i

Display detailed information about these images:

pan -i -l

Allocate a media image to each current and future LPAN:

pan -a -I /tmp/RHEL6.0-20100922.1-Server-x86_64-DVD1.iso -A yes RHEL6_X64

Add a useful description of the PAN's owner and the PAN itself.

pan -O "Web Apps Group" -D "Production PAN"

Configure one event action: send an email for each event of Severity 2 or higher (1 or 2):

pan -e -a -E [email protected] -S 2

Add a range of MAC addresses (255) to the PAN (by specifying the first and last address of the range):

pan -a -M 04:04:56:81:01:01-04:04:56:81:01:ff


2-67 PM7.0.0

Add a range of MAC addresses (500) to the PAN (by specifying the first address in the range and the number of addresses you are adding):

pan -a -M 04:04:56:81:01:01 -N 500

Add a media image to the PAN with a brief description, and make it available to all LPANs:

pan -a -I /tmp/installApp.iso -D "App installer DVD image" appInstall

Add a media image to the PAN, but not to LPANs:

pan -a -I /tmp/my_new_image.iso -A no appsImage



SEE ALSO ACCOUNT

EVENTTYPE

LPAN

PSERVER


PANMGR

PM7.0.0 2-68

PANMGR

NAME panmgr - Configures and lists information about the PAN OPServers, and performs join/unjoin operations on them

SYNOPSIS panmgr [-l]

panmgr -G global-ip

panmgr --join master-ip

panmgr --unjoin slave-ip [-f]

panmgr --set-join-enable {yes|no}

panmgr -M multicast-ip

panmgr -P multicast-port

panmgr {-m|-s} -O oobm-ip -T oobm-type -U oobm-user -W oobm-password

DESCRIPTION The panmgr command lists information about the PAN OPServers and allows you to perform configuration tasks on them. These include:

• Enable each PAN OPServer to join together, to provide a redundant and secure way to manage the domain

• Join the PAN OPServers together

• Set a global IP address for PAN Manager that remains separate from the individual IP addresses of the PAN OPServers. This allows you to use a single IP address to manage the PAN, without relying on the availability of both PAN OPServers, or on the master/slave identity of either.

• Configure the same BMC/OOB IP addresses on the master PAN OPServer and slave PAN OPServer that you did when you installed PAN Manager on them. This allows each PAN OPServer to perform control operations on the other, as needed.


2-69 PM7.0.0

OPTIONS --join {master-ip}

Issued from the PAN OPServer that is to be the slave, combines both PAN OPServers into a single point of control for managing PAN resources and configurations. master-ip indicates the IP address of the PAN OPServer that is to be the master.

For this join operation to be successful, you must first run the --set-join-enable yes option on each PAN OPServer to prepare it for the join.

--set-join-enable {yes|no}

Issued on both PAN OPServers (the default is yes):

• Specifying --set-join-enable yes prepares the PAN OPServer for the join operation (--join) that will combine them into a single point of control for managing PAN sources and configurations.

• Specifying --set-join-enable no disables the PAN OPServer from being joined with another PAN OPServer.

--unjoin {slave-ip}

Issued from the master PAN OPServer, separates the PAN OPServers from being a single point of control for managing PAN resources and configurations. If you needed to replace either PAN OPServer, you would first issue the --unjoin option.

-f, --force

Combined with --unjoin, performs the unjoin operation without waiting for a confirmation prompt.

-G, --global-ip-addr {global-ip}

Sets the unique IP address for PAN Manager. This address is different from the IP address of either PAN OPServer, and provides a single unchanging target for logging onto PAN Manager, regardless of the availability of one or both PAN OPServers.

PANMGR

PM7.0.0 2-70

-l, --long

Displays details about components of the management environment, including the interface name of the management network, and IP address and port number of the management network’s multicast group, and the OOB management type each PAN OPServer is using.

-M, --multicast-group {group-ip}

Configures the IP address of the multicast subscription running on the PAN OPServers. This IP address provides a way for PANs on the same subnet to discover each other. This value is typically 224.224.224.224.

-m, --set-oobm-master

Establishes the domain’s master PAN OPServer as the out-of-band management master. If the PAN OPServers swap master/slave identities, the domain’s new master PAN OPServer becomes the new out-of-band management master.

-O, --oobm-ip-addr oobm-ip

Specifies the out-of-band (OOB) management IP address you specified (in the BIOS during system setup) for BMC on this PAN OPServer. This enables OOB management of the physical components in the PAN.

You must specify a different IP address for both the master PAN OPServer and the slave PAN OPServer. PAN Manager then passes these IP addresses to the VirtualConnect GUI running on the enclosure.) For details, see PAN Manager Configuration and Installation Guide.

-P, --multicast-port {port-no}

Specifies a software port on the PAN OPServers that allows the OOB management application to contact the components it is to manage. The default is 9000.


2-71 PM7.0.0

-s, --set-oobm-slave

Establishes the domain’s slave PAN OPServer as the out-of-band management slave. In the future, if the PAN OPServers swap master/slave identities, the domain’s new slave PAN OPServer becomes the new out-of-band management slave.

-T, --oobm-type {oobm-type}

Specifies the type out-of-band management interface (“IPMI”, specified in the BIOS during system setup) through which you can perform out of band management tasks on the hardware components in the chassis.

You must specify the same OOB type for both the master PAN OPServer and the slave PAN OPServer. PAN Manager then passes this value to the VirtualConnect GUI running on the enclosure.)

-U, --oobm-user {oobm-user}

Specifies the out-of-band management user name you specified in the BIOS during system setup.

You must specify the same OOB management user name for both the master PAN OPServer and the slave PAN OPServer. PAN Manager then passes this value to the VirtualConnect GUI running on the enclosure.)

-W, --oobm-password {oobm-password}

Specifies the out-of-band management password you specified in the BIOS during system setup.

You must specify the same OOB management password for both the master PAN OPServer and the slave PAN OPServer. PAN Manager then passes this IP address to the VirtualConnect GUI running on the enclosure.)

PANMGR

PM7.0.0 2-72

EXAMPLES List the PAN OPServers, including their master/slave status, their IP addresses, whether they are joinable to each other, and their current uptime:

panmgr

Enable a PAN OPServer to join the other:

panmgr --set-join-enable yes

Join the PAN OPServers:

panmgr --join 172.258.12.35

where 172.258.12.35 is the IP address of the master PAN OPServer.

Set the PAN Manager global IP address:

panmgr -G 172.48.261.28



SEE ALSO INTNET

LPAN

PAN


2-73 PM7.0.0

PNODE

NAME pnode - Lists or controls one or more specified pNodes

SYNOPSIS pnode [-l] pnodename

pnode -n pnodename

pnode -s [-w] [-f] pnodename

pnode --clear-hw-events pnodename

pnode --reset-bmc [-h] [-f] pnodename

pnode {--select|--unselect} pnodename

pnode {-i|-o} pnodename

pnode {-m|-u} pnodename

DESCRIPTION The pnode command lists information about a specified pNode and allows you to do the following:

• Power on or off any pNode in a domain.

• Diagnose problems associated with hardware or a system hang traced to a specific pNode.

• Place a pNode into or remove it from the maintenance LPAN (.maint).

Caution: Use of the pnode command can make a pNode unavailable to its LPAN. If the LPAN has failover actions defined for this pNode, those actions could be triggered, affecting applications and other pNodes running in that LPAN. We recommend notifying LPAN Administrators that a pNode in their LPAN is being diagnosed, so they are prepared when a specified pNode is shut down or marked Out Of Service.

PNODE

PM7.0.0 2-74




pnodename

Specifies a pNode based on its physical slot number within the chassis.


OPTIONS --clear-hw-events

Clears the System Event Log (SEL) of a pNode. This is useful if PAN Manager generates an "Event Log Full" event for the pNode. Clearing the event log reclaims space for storing subsequent events in the SEL.

--reset-bmc

Performs a soft reset of the Baseboard Management Controller (BMC) of a pNode. (The BMC is the processor that runs the pNode’s IPMI agent.) This is useful if you need to flush the Integrated Lights Out (ILO) settings of the pNode. If the pNode is powered off, this option resets the pNode immediately; if the pNode is powered on, you must either combine this option with the -f (force) option, or confirm the reset when the prompt appears. A BMC reset affects the status and statistical information about the pNode as reported through IPMI. Combining the --reset-bmc option with the -h (hard) option performs a hard reset of the pNode’s BMC.


2-75 PM7.0.0

Note: Resetting the BMC breaks any existing console connections (VGA or serial), and interrupts any media image access the pServer had in the VCD. After issuing the soft BMC reset, you must re-establish these sessions.--select

Causes the indicator light labeled UID on the front of the pNode to appear solid blue. This visual indicator helps locate the pNode within the chassis. If the UID indicator light is blinking, the pNode is in an unready state, and cannot be marked as “Selected”.

--unselect

Clears the visual indicator on the pNode.

-f, --force

Forces a pNode operation without a prompt. Used with the -s (shutdown) option, forces a pNode shutdown with no attempt to do it gracefully.

Used with the --reset-bmc option, the -f (force) option resets the BMC on the pNode even if the pNode is still powered on.

-h, --hard

Specifies a hard reset of the BMC of the pNode. In addition to the interruptions that occur when issuing a soft reset of the BMC, a hard reset affects the entire pServer. You must then boot the pServer.

-i, --in-service

Toggles a specified pNode’s status from Out of Service to In Service. Assigns In Service status to a specified pNode.

Placing a pNode In Service powers it on. In many cases this causes the pNode to boot automatically.

-l, --long

Lists information about a specified pNode or all pNodes in a domain. Information includes FRU data such as architecture, and BMC, BIOS, and CMOS revs.

PNODE

PM7.0.0 2-76

Note: A display of N/A or None means that the INFORMATION about the property is not available. The FUNCTIONALITY is available.-m, --set-maintenance

Marks the pNode for a maintenance task. This places the pNode in the maintenance LPAN (.maint), but does not remove the pNode from the LPAN and pServer, if any, in which it is already configured. This option assumes the pNode is currently in an Out of Service state (pnode -o).

-n, --nmi

Sends a non–maskable interrupt (NMI) to a specified pNode for diagnostic purposes. This NMI causes the pNode to behave as if it had a panic. By default, a panic causes a pNode to dump core memory. In order to issue an NMI, the pNode must be in a powered on state.

-o, --out-service

Indicates that you want to assign Out of Service status to a specified pNode. This option marks the specified pNode not to be used, even though it remains listed in its configuration definitions. Use this option when you want a specified pNode to be left idle, but you do not want to edit configuration definitions.

For example, if you have assigned a pNode to an LPAN, but the LPAN Administrator does not want to use the pNode, you can shut down the LPAN and mark the pNode Out of Service.

-s, --shutdown

Powers off the pNode. This is useful when the pNode is hung. A pNode must be in the Powered Off state when you boot the pServer on which it is configured.

-u, --unset-maintenance

Unmarks the pNode for a maintenance task. The pNode must not be configured on any pServers in the maintenance LPAN. This removes the pNode from the maintenance LPAN.


2-77 PM7.0.0

-w, --wait

Causes the pnode command to pause while a shutdown (power off) is underway, and displays a progress indicator. Use this option with the -s (shutdown) option when you would like to suspend command-line operations until the shutdown is completed.

EXAMPLES List the details for pNode p7 (in the domain called zeus):

pnode -l zeus/p7

Power off pNode p7 (in the domain zeus), which shuts down the pServer currently running:

pnode -s zeus/p7

Mark pNode 14 as In Service (in the domain DomainOne):

pnode -i DomainOne/p14

Set the indicator light to blink blue on pNode 1 (in the domain production):

pnode --select production/p1

Set the indicator light on pNode 1 to its normal meaning (on the domain called production):

pnode --unselect production/p1



SEE ALSO DOMAIN

PNODE

PM7.0.0 2-78



2-79 PM7.0.0

POOL

PM7.0.0 2-80

POOL

NAME pool - Creates, lists, or modifies a set of Processing Nodes (pNodes) for a local or global pool

SYNOPSIS pool [-l] [globalpoolname|lpanname/localpoolname]

pool {-c|-d} {globalpoolname|lpanname/localpoolname}

pool [-D "description"] [-n newname] {globalpoolname|lpanname/localpoolname}

pool [-G globalpoolname|-g] lpanname/localpoolname

pool {-a|-r} pnodename {globalpoolname|lpanname/localpoolname}

DESCRIPTION The pool command allows a PAN Administrator to create, list, or modify a global pool of pNodes, or an LPAN Administrator to configure an LPAN-wide “local” pool of pNodes to be used by pServers within a specific LPAN.

When you create an LPAN, PAN Manager automatically creates a local pool named pool, and allocates it to the LPAN.

Use the pool command to perform the following tasks:

• (PAN Administrators only) Create, list, or modify a global pool

• Create or remove a local pool

• Add a pNode to a pool

• Link a local pool to a global pool

Without any options, the pool command lists all global and local pools in the Processing Area Network (PAN), and the pNodes, if any, that they contain. (Local pools appear in the form lpanname/localpoolname.)


2-81 PM7.0.0

A local pool provides the pServers in an LPAN with access to a set of pNodes, for one or both of the following purposes:

• to obtain a primary pNode (for booting)

• to obtain a failover pNode if the pServer’s primary pNode becomes unavailable

A PAN Administrator can also create one or more “global” pools of pNodes, then link a specific local pool to a global pool, to provide the local pool access to additional pNodes. In this case, if a pServer tries to obtain a pNode from a local pool in which no pNodes were available, PAN Manager attempts to obtain a pNode from the global pool.

PAN Administrators can find it useful to add pNodes of a similar type or chip architecture to a global pool created for failover purposes. This can help ensure that the behavior of the failover pNode is consistent with the pServer’s previous pNode. Also, a pServer that requires a lot of memory or high processor speeds should have access to a pool of pNodes that meet those requirements.

PAN Manager enforces a limit on the total number of global pools and local LPAN pools that can be created: 20 global pools, 20 pools per LPAN, and 200 pools total.




pnodename


POOL

PM7.0.0 2-82


globalpoolname

Specifies a global pool name.

lpanname/localpoolname

Specifies a local pool name within an LPAN. More than one local pool can have the same name in the PAN domain as long as the locals pools are not in the same LPAN.

OPTIONS -a, --add-pnode pnodename

Allocates a specified pNode to a specified global or local pool.

-c, --create

Creates a specified global (PAN Administrator only) or local pool (LPAN Administrator only). PAN Manager enforces a limit on the total number of global pools and pools per LPAN that can be created: 20 global pools, 20 pools per LPAN, and 200 pools total.


Specifies a brief note about the pool’s contents or purpose. (If the text contains spaces, enclose it within double quotes.)

-d, --delete

Deletes a local or global pool.

-G, --set-global globalpoolname

Sets a link between a local pool lpanname/localpoolname and a global pool globalpoolname. PAN Manager allows the local pool to access only one global pool at a time. To allow a pServer to access more than one global pool of pNodes, LPAN Administrators must create a local pool for each global pool that they want pServers to access.


2-83 PM7.0.0

-g, --clear-global

Clears the link between the local pool lpanname/localpoolname and any global pool. (It is not necessary to specify the name of the global pool, because a local pool can only link to one global pool.)

-l, --list

Lists the current pNodes assigned to the specified global or local pool. With no argument, this option lists the settings and status of all local and global pools.

-n, --rename newpoolname

Renames the specified local or global pool.

-r, --remove-pnode pnodename

Removes the specified pNode from the specified global or local pool. Follow these guidelines:

• You cannot remove a pNode from a local pool if it is a pServer’s current pNode.

• You cannot remove a pNode from a global pool if it is a pServer’s current pNode, unless you are removing the pNode from the global pool and adding it to the LPAN in which that same pServer resides.

EXAMPLES List only the names of pNode pools (local and global) and their contents, to which you have access:

pool

Create a global pool named global_x86s:

pool -c global_x86s

Create a local pool named local_x86s in the LPAN DEPT7:

pool -c DEPT7/local_x86s

POOL

PM7.0.0 2-84

Link the local pool named local_x86s to global pool global_x86s:

pool -G global_x86s DEPT7/local_x86s

List all pNode pools (local and global) and their contents, to which you have access, including the local pools (if any) to which a global pool is linked, and the global pool (if any) to which a local pool is linked:

pool –l

Add pNode 1 in the domain called DEV_DOMAIN to the global pool global_x86s:

pool -a DEV_DOMAIN/p1 global_x86s

Add pNode 2 in domain DEV_DOMAIN to local pool local_x86s in the LPAN DEPT7 (the pNode must already be present in the LPAN in which the local pool resides):

pool -a DEV_DOMAIN/p2 DEPT7/local_x86s

Label the global pool global_x86s with a brief identifying description:

pool -D "This pool contains x86 blades for use in all LPANs that belong to the development group" global_x86s

In the domain system3, remove pNode 12 from a local pool called test_pool in the LPAN called accounting:

pool -r system3/p12 accounting/test_pool

In the domain system3, remove pNode 9 from a global pool called global_fo_pool:

pool -r system3/p9 global_fo_pool



2-85 PM7.0.0


SEE ALSO LPAN

PAN

PSERVER


PORT

PM7.0.0 2-86

PORT

NAME port - Lists information about network and storage ports that reside on the domain’s physical switches

SYNOPSIS port [-l] [-u uplinkname] [-i {yes|no}] [-L {yes|no}] [-t {fc|eth}] [portname]

DESCRIPTION The port command displays the current status and configuration of the physical ports on the domain’s physical converged FlexFabric switches. “Converged” means that the switch supports both Ethernet and Fibre Channel ports, and therefore external connectivity to Ethernet networks and Fibre Channel storage arrays.

You can select which ports to display, based on any combination of one or more of these characteristics:

• all ports in a single domain, a single chassis, or a single switch

• their type (Ethernet or Fibre Channel). Unused ports appear as Unknown.

• the fabric on which the port resides. (A fabric is a grouping of physical switches within the same domain that have common connectivity.)

The domain supports a single fabric: f1.

• the uplink, if any, to which the ports belong

• whether the ports are physically connected (“Up”) to an external switch (an Ethernet switch or a Fibre Channel switch)

The following ports (and their types) are available on each FlexFabric switch, where sN is the name of the switch (s1 or s2):

• sN:1 (Ethernet or Fibre Channel)


2-87 PM7.0.0




• sN:5 (Ethernet only)


(On each switch, Ports 7 and 8 are used for stacking and are neither available for configuration in PAN Manager, nor visible in the port command’s output.)




portname

which indicates a name that is unique across the PAN for a specific physical port on a FlexFabric switch, in the format:

domain:chassisname/switchname:portnumber

For example:

panther:c1/s1:5

indicates port 5 on FlexFabric switch s1 in chassis c1 on the domain panther.

If there is only one domain, then domain is optional. If there is only one chassis, then chassisname is optional. For example, if there is only one chassis in the PAN, you need only specify s1:5.

PORT

PM7.0.0 2-88

uplinkname

Indicates the name of an uplink

OPTIONS -i, --internal {yes|no}

Lists ports according to whether they are available to configure in an uplink. (A port can be used in only one uplink.) Specifying port -i yes lists all ports that are available; port -i no lists all ports that are already configured in an uplink.

-L, --linked {yes|no}

Lists whether the ports are (yes) or are not (no) physically connected to an external switch (an Ethernet switch or a Fibre Channel switch).

-l, --long

Displays port information in a per port format.

-t, --type {fc | eth}

Displays information about ports of a specific type, where fc indicates ports used for Fibre Channel storage, and eth indicates ports used for Ethernet network traffic.

-u, --uplink {uplinkname}

Displays port information that pertains to the uplink you specify.

EXAMPLES Display all information about the physical ports in the domain:

port

Display all ports that are being used for Fibre Channel storage:

port -t fc

Display all ports that are being used for Ethernet network I/O:

port -t eth


2-89 PM7.0.0

Display all ports that are part of the uplink called my_uplink:

port -u my_uplink

Display all ports that are available to configure in an uplink.

port -i yes

List ports that are physically connected to external switches.

port -L yes



SEE ALSO DOMAIN

PSERVER

SWITCH

UPLINK

VSWITCH


PORT

PM7.0.0 2-90


2-91 PM7.0.0

PSERVER

NAME pserver - Creates, lists, or modifies a pServer configuration within an LPAN

SYNOPSIS pserver [[-v]-l] [lpanname |lpanname/pservername]

pserver -c [-D description] [-A lpanorder] [-O [vcd][,vhba][,vnic]] lpanname/pservername

pserver [-n newname] [-D "description"] [-A lpanorder] [-O [vcd][,vhba][,vnic]] lpanname/pservername

pserver -d [-f] lpanname/pservername

pserver -o {yes|no} lpanname/pservername

pserver [-i {imagename}|-e] lpanname/pservername

pserver --managed {yes|no} lpanname/pservername

pserver --management-ip1 ipaddress

pserver --management-ip2 ipaddress

pserver -a -N vnicN [-V vswitchname1[,vsw2]...[,vswN]] [[-M {macaddress | local | generate}] [--iscsi-mac {macaddress | local | generate}] | -g] [-L {none|nGb[/required]}] [-B {yes|no}] lpanname/pservername

pserver -m -N vnicN [ [-a] -V vswitchname1[,vsw2]...[,vswN]] [-M {macaddress | local | generate}] [--iscsi-mac {macaddress | local | generate}] [-L {none|nGb[/required]}] [-B {yes|no}] lpanname/pservername

pserver -mN vnicN -r -V vswitchname1[,vsw2]...[,vswN] lpanname/pservername

pserver -mN vnicN -u {vswitchname|none} lpanname/pservername

pserver -rN vnicN lpanname/pservername

pserver -aS vhbaN [-t fc] [-V FCvswitchname] [-W portwwn] [-Y nodewwn] [-L {none|nGb[/required]}] [-B {yes|no}] [--boot-target targetwwn{/lunspec}] lpanname/pservername

pserver -mS vhbaN [-V vswitchname] [-L {none|nGb[/required]}] [-W nodewwn] [-Y portwwn] [-B {yes|no}] [--boot-target targetwwn[/lunspec]] lpanname/

PSERVER

PM7.0.0 2-92

pservername

pserver -mS vhbaN -r -V vswitchname lpanname/pservername

pserver -rS vhbaN lpanname/pservername

pserver {-P|-F} { pnodename |localpoolname |none} lpanname/pservername

pserver -b [-O [vcd][,vhba][,vnic] [-w [-q]] lpanname/pservername

pserver -x [-f] [-O [vcd][,vhba][,vnic] [-T min --message "mesg"] [-w [-q]] lpanname/pservername

pserver -s [-f] [-T min --message "message"] [-w [-q]] lpanname/pservername

DESCRIPTION The pserver command creates, lists, or modifies a pServer within an LPAN configuration. LPAN Administrators configure pServers by combining a primary Processing Node (pNode), a failover pNode, Ethernet network resources (MAC addresses), and Fibre Channel storage resources (World Wide Names), all of which are already allocated to the pServer’s LPAN.

LPAN Administrators use the pserver command to do the following:

• Create, modify, or remove a pServer

• Specify a boot order (of devices from which to boot) for a pServer

• Boot, shut down, or reboot a pServer

• Configure management network settings (override management IP addresses and define the degree to which PAN Manager manages/monitors the pServer)

Using the pserver command, LPAN Administrators configure the following pServer settings:

• pNode resources — Specify whether the pServer uses a particular pNode or obtains one from a pool of pNodes.

• Network vSwitches — Connect a pServer to internal communications and external networks.


2-93 PM7.0.0

• Storage vSwitches — Connect a pServer to Fibre Channel vSwitches that are uplinked to external storage arrays.

• Virtual CD-ROMs — Access a single virtual CD-ROM (VCD) attached to a pServer. When you create a pServer, PAN Manager automatically assigns a VCD device to it.





You must use a forward slash (/) between the LPAN name and the pServer name. For example, the pServer named Web1, in the LPAN named production is referred to as production/Web1. PAN Administrators use the lpan command to name LPANs, and LPAN Administrators use the pserver command to name pServers.

pnodename



vswitchname

Specifies a Virtual S

witch (vSwitch). (To create a vSwitch, use the vswitch command.)

vhbaN

PSERVER

PM7.0.0 2-94

Specifies the name of an interface that connects a pServer to a Fibre Channel Virtual Switch.

vnicN

Specifies the name of an interface that connects a pServer to an Ethernet Virtual Switch. PAN Manager uses vnic0 and vnic1 for the private management network that is internal to the PAN.

lpanname/localpoolname

Specifies a local pool within an LPAN. Within an LPAN, each local pool’s name must be unique. Within the entire PAN, local pool names need not be unique.

OPTIONS --boot-target {targetwwn[/lunspec]}

Specifies the World Wide Name of the storage target and the specific LUN number of the pServer’s boot device.

--boot-timeout {seconds}

The boot timeout value is only used during pServer failover. When a pServer is determined to be non-responsive, PAN Manager attempts to boot the pServer on its primary pNode. If this boot attempt does not succeed within the time specified by boot-timeout, PAN Manager attempts to boot the pServer on its failover pNode. If this boot attempt does not succeed within the time specified by boot-timeout, PAN Manager shuts down the pServer and issues an event.

--default-boot-lun {lunspec}

Of all devices (that is LUNs) that reside on a storage target, specifies the pServer’s network boot device. The default is zero (0).

--iscsi-mac {macaddress|local|generate}

Allows you to do one of the following:

• Specify a single iSCSI MAC address (macaddress) associated with a pServer Ethernet network interface (vNIC)


2-95 PM7.0.0

• Select an iSCSI MAC address (local) from the range of MAC addresses that are already allocated to the pServer’s LPAN, to use for iSCSI network traffic.

• Autogenerate (generate) a MAC address for iSCSI network traffic. (PAN Manager generates MAC addresses that are unique within the PAN.)

--managed {yes|no}

Specifies whether a pServer is to run in Managed mode (--managed yes) or Unmanaged mode (--managed no). The default is yes.

The PAN Tools user space components provide reliable PAN Manager health monitoring services. The PAN Tools software consists of:

• the PAN Agent, which allows you to use PAN Manager to perform a graceful shutdown of the pServer.

• the Heartbeat Client, which monitors the up/down state of the pServer, and indicates to PAN Manager when a pServer failover is necessary.

The PAN Tools software media image is registered on the PAN OPServers when you install PAN Manager. You can then install PAN Tools on one or more pServers. This provides the optimal level of failover protection for your pServers, and places them into Managed/Enhanced mode.

A pServer in Managed mode, can be at one of the following levels of management:

• Managed/Enhanced -- PAN Manager uses the PAN Tools heartbeat service to monitor pServer health. This service is aware of pServer shutdown and reboot events, so it is more robust and faster to execute failover.

• Managed/Basic -- provides a basic mode of failover protection for pServers. PAN Manager uses arp and ICMP pings as a heartbeat mechanism to monitor pServer health.

PSERVER

PM7.0.0 2-96

A pServer in Unmanaged mode:

• is not automatically failed over or restarted by PAN Manager under any circumstances

• does not fail over, even if its pNode is ejected

• requires you to use the operating system’s commands to shut down the pServer gracefully

• does not accept the --boot-timeout setting: no boot failure/restart is attempted by PAN Manager

For more information about Managed pServers, see PAN Manager Administrator’s Guide.

--management-ip1 {ipaddress}

--management-ip2 {ipaddress}

Specifies the two IP addresses that connect the pServer to the domain’s private management network.

If the PAN Tools software is installed on the pServer, two Management IP addresses are automatically configured on the running pServer.

If the PAN Tools software is not installed on the pServer, you can configure the IP addresses manually after the pServer is up and running.

You can choose to override these management IP addresses with any IP addresses of your choosing (see override-management-ips).

--message {“text”}

Provides a brief description about the upcoming pServer shutdown or reboot. (If the text contains spaces, enclose it within double quotes.)


2-97 PM7.0.0

--override-management-ips {yes|no}

Allows (yes) or disallows (no) the pServer to accept alternate IP "subnet" addresses that connect the pServer to the private management network of the PAN. (These IP addresses must be compliant with your data center, and must be pingable by the PAN OPServers.)

--shutdown-timeout {seconds}

Sets a time (in seconds) to wait during a shutdown attempt, before performing a pServer failover.

-A, --lpan-order {n}

Specifies the the order in which pServers boot when you boot the entire LPAN. If you do not specify the pServer’s LPAN order, it defaults to NONE.

-a, --add

Adds a resource to the pServer.

Used with -S (storage), configures a vHBA (virtual host bus adapter) interface, through which a pServer can access storage resources on the external network.

-aN,--add-network {vnicN}

Configures a vNIC (virtual network interface controller) interface, through which a pServer can access the domain’s private management network or the external network.

-aS, --add-storage {vhbaN}

Configures a vHBA (virtual host bus adapter) interface, through which a pServer can access storage resources on the external network.

-B, --boot-enabled {yes|no} default: no

Combined with -N (network), specifies that you do (yes) or do not (no) want a vNIC interface to be bootable. This is the means for performing a network (PXE) boot of the pServer.

PSERVER

PM7.0.0 2-98

Combined with -S (storage), specifies that you do (yes) or do not (no) want a vHBA interface to be bootable. For a vHBA interface to be bootable, it must have a target World Wide Name configured on it (see the --boot-target option).

-b, --boot

Boots the specified pServer. To boot a pServer, the pServer must first have a primary pNode (-P), and a boot device or media image (-i) assigned to it. To boot the pServer, the pServer’s primary pNode must be in a Powered Off state.

Used with -O (boot order), which specifies a sequence of devices (such as VCD, then a storage device, then a network mounted image) from which the pServer attempts to boot on a one-time basis. (To set a boot order permanently, use the -O option without the -b option.)

-c, --create

Creates a new pServer within an LPAN. When you create a pServer, PAN Manager automatically creates

• two network interfaces, vnic0 and vnic1, assigns them to the pServer, and connects them to the LPAN’s private management vSwitch

• a Virtual CD “drive” and assigns it to the pServer for the pServer’s exclusive use

To configure a fully functional pServer, you must also assign to it processing (-P), network (-N), and storage (-S) resources. (The pServer must be in a shutdown state to assign these resources to it.) You must also install a version of operating system software supported by PAN Manager (see PAN Manager Release Notes for information about supported pServer operating systems).


Provides a brief helpful description of the pServer and its purpose. (If the text contains spaces, enclose it within double quotes.)


2-99 PM7.0.0

-d, --delete

Deletes a pServer from the LPAN. To delete it, the pServer must be in a shutdown state.

-e, --eject-vcd

Ejects an image from the pServer’s Virtual CD drive. (When you create a pServer, PAN Manager automatically assigns the VCD drive to it.)

-F, --set-failover-pnode {pnodename|localpoolname|none}

Specifies whether a pServer uses a specified pNode (pnodename) or a pool of pNodes (localpoolname) as a backup if its primary pNode becomes disabled. By default, there is no failover assignment (none). The failover pNode you specify must already be allocated to the same LPAN in which the pServer resides.

To configure a local or global pNode pool, use the pool command.

-f, --force

When combined with the -d (delete) option, deletes a pServer without prompting. When combined with the -x (reboot) or -s (shutdown) option, performs the operation whether or not PAN Tools have been installed on the pServer.

-g, --generated

Used with the -N (network) option, instructs PAN Manager to generate automatically the requested MAC address for the vNIC interface (as opposed to selecting the MAC address from a pre-allocated range). PAN Manager generates MAC addresses that are unique within the PAN.

-i, --insert-vcd {imagename}

Inserts an image in the pServer’s Virtual CD drive. (When you create a pServer, PAN Manager automatically assigns the VCD drive to it.)

PSERVER

PM7.0.0 2-100

-L, --rate-limit none|{<n>Gb | <n>00Mb}[/required]

Combined with -N (network), sets an upper limit rate, if any, in gigabits (1 through 10) or hundreds of megabits per second (1 through 9), at which network traffic flows through a pServer Ethernet interface. You can specify the rate limit, or eliminate the rate limit (-L none) either when you create or modify the interface.

Combined with -S (storage), sets an upper limit rate, if any, in gigabits per second (1, 2, 4, 8, or 10), at which network traffic flows through a pServer storage interface. You can specify the rate limit, or eliminate the rate limit (-L none) either when you create or modify the interface.

Setting a rate limit for multiple pServers in an LPAN affects how each contends for network traffic. If you specify a value that is required (such as -L 4Gb/required), it means that the rate of network traffic is guaranteed not to exceed the limit you specify.

Note: Rate limiting is not supported by the Windows(TM) operating system.

-l, --long

Lists details of the pServer's status, including:

• its UUID

• its place in the LPAN's boot order for pServers

• its management IP addresses

• its configured primary and failover pNodes

• its Virtual CD ROM device and the display name of any media currently inserted in the VCD

• details about its network and storage interfaces

• boot parameters

• boot targets-M, --mac-address {macaddress|local|generate}

Specifies one of the following:


2-101 PM7.0.0

• A single MAC address (macaddress) associated with a pServer Ethernet network interface (vNIC)

• Selects a MAC address (local) from the range of MAC addresses that are already allocated to the pServer’s LPAN.

• Autogenerates (generate) a MAC address.

-m, --modify

Used with the -N option, modifies an existing Ethernet network interface (vNIC); used with the -S option. modifies an existing Fibre Channel storage interface (vHBA).

-mN, --modify-network vnicN

Modifies an existing Ethernet network interface (vNIC).

-mS, --modify-storage vhbaN

Modifies an existing Fibre Channel storage interface (vHBA).

-N, --network {vnicN}

Specifies an Ethernet network interface (a virtual network interface controller) on the pServer. Typically vNIC0 and vNIC1 are used by the PAN Manager private management network.

Important: If you use a pServer’s operating system to configure network bonding, do not include the vNICs that are used for the private management network in the bonded network interface. This can disrupt the private management network of the PAN.

-n, --rename newname

Specifies a new name for the pServer. This change takes effect immediately, without the need for a reboot.

-O, --boot-order {[vcd][,vhba][,vnic]}

Specifies a comma-separated sequence of devices (such as VCD, then a storage device, then a network mounted image) from which the pServer attempts to boot. If the first device you specify is not available, the pServer attempts to boot from the second device, and so on.

PSERVER

PM7.0.0 2-102

To set a boot order on a one-time basis, use the -b option; to set a boot order permanently, use the -x option.

-o, --optional {yes|no}

Specifies whether an LPAN can boot if the specified pServer does not boot. For example, if you set this to "no" for a specified pServer, you prevent the LPAN of the pServer from booting if this pServer does not boot.

-P, --set-primary-pnode {pnodename|localpoolname|none}

Specifies whether the primary pServer pNode for booting is a specific pNode, a pNode from a local pool, or unspecified. To specify a pNode (pnodename), that pNode must be allocated to the same LPAN in which the pServer is located. You can reconfigure the pServer’s primary pNode while the pServer is running, but the change does not take effect until the next reboot.

Specifying localpoolname configures the use of a pool of pNodes. PAN and LPAN Administrators use the pool command to set up global or local pools. See PAN Manager Administrator’s Guide for more information.

Note: For a pServer to have access to pNodes in a global pool, PAN Administrators first create the global pool using the pool command and then authorize an LPAN to access this pool using the lpan command. See the lpan command for details.

Specifying none removes the pServer's primary pNode. To change the assignment from a specific pNode to a local pool, or from a local pool to a specific pNode, you do not need to specify “none”: simply assign a specific pNode or pool to overwrite the previous setting.

-q, --quiet

Used with the -w (wait) option, suppresses any informational messages and the progress indicator during a pServer boot (-b), reboot (-x), or shutdown (-s).


2-103 PM7.0.0

-r, --remove

Removes a resource from the pServer.

Used with -S (storage), removes a vHBA (virtual host bus adapter) interface, through which a pServer can access storage resources on the external network.

-rN,--remove-network vnicN

Removes a vNIC (virtual network interface controller) interface, through which a pServer can access the domain’s private management network or the external network.

-rS, --remove-storage vhbaN

Removes a vHBA (virtual host bus adapter) interface, through which a pServer can access storage resources on the external network.

-S, --storage {vhbaN}

Specifies a storage interface (a virtual host bus adapter) on the pServer.

-s, --shutdown

Halts the processing of a pServer, allowing the current pServer configuration to be resumed at a later time.

You can combine this option with the -T (time) and --message options to create a conditional shutdown.

Combined with the -f (force) option, performs the shutdown whether or not PAN Tools have been installed on the pServer.

-T min

Combined with -x (reboot) or -s (shutdown), specifies a delay in seconds between the time you execute the command and the time the operation takes place.

PSERVER

PM7.0.0 2-104

-u, --untagged-vswitch {vswitchname|none}

Configures an Ethernet network interface (vNIC) on the pServer to send and receive network packets that are not tagged with a specific VLAN ID. To configure this setting between the interface and a specific vSwitch, specify vswitchname; to configure the interface not to send or receive any untagged network traffic, specify none.

You can configure a maximum of one untagged vSwitch on each vNIC interface.

-V, --vswitch-name vswitchname

Specifies a Virtual Switch to which you can connect a pServer in order to configure Ethernet network connectivity, or Fibre Channel storage connectivity. A vNIC interface connects a pServer to a network vSwitch; a vHBA connects a pServer to a Fibre Channel vSwitch.

-v, --verbose

Used with -l (long), provides additional details about the pServer:

• iSCSI MAC addresses

• Node WWNs

• WWN usage: includes the WWN and its type (such as port WWN, node WWN, or Boot Target) and on which vHBA the WWN is configured

-W, --port-wwname wwname

Configures on a Fibre Channel interface (vHBA) on a pServer, a World Wide Name that represents a single port on the pServer’s pNode.

-w, --wait

Causes the pserver command to pause while a boot, reboot, or shutdown process is underway and display a progress indicator. Use this option with the -b (boot), -s (shutdown), or -x (reboot) option in cases in which you would like to suspend command-line operations until the boot, reboot, or shutdown process is complete.


2-105 PM7.0.0

-x, --reboot

Reboots a pServer. Combined with the -f (force) option, performs the reboot whether or not PAN Tools have been installed on the pServer.

The most current configuration of a pServer is rebooted, which means the exact pNode a pServer reboots on depends upon its configuration. If a pServer is configured to run on a pNode from a local pool, or if a pServer failed over to a pNode pool, the pServer will reboot on the first available pNode within that pool.

-Y, --node-wwname wwname

Configures on a Fibre Channel interface (vHBA) on a pServer, a World Wide Name that represents all ports on the pServer’s pNode.

EXAMPLES Specify a primary pNode for a pServer in the development LPAN (on domain domainOne and chassis c1). This pNode cannot be assigned to a pool by a PAN Administrator:

pserver -P domainOne:c1/p3 development/webdev1

Configure three pServers in the production LPAN using a local pool of pNodes named webpool for the primary pNode for each:

pserver -P webpool production/web1pserver -P webpool production/web2pserver -P webpool production/web3

Here there is no need to use the -F (failover) option, because in the case of pServer failover, the failed pServer gets an available pNode from a local pool. If none is available, PAN Manager looks to see if the local pool is linked to a global pool. If it is linked and the LPAN has access to this linked global pool (the PAN Administrator uses the lpan -F -g globalpoolname command), the failed pServer gets an available pNode from the linked global pool. If none are available, the pServer fails.

PSERVER

PM7.0.0 2-106

Utilize a local pool of pNodes named pool2 for pServer webdev1 in the development LPAN:

pserver -F pool2 development/webdev1

Failover works the same for this pServer. The difference between pServers web1 and webdev1 appears when failover occurs and the original pNode is repaired. With web1 failover, a repaired pNode is returned to the pool after the PAN Manager recognizes it, making it immediately available to all the pServers in the LPAN. With webdev1 failover, the pNode remains inaccessible until you shut it down and reboot webdev1.

Specify a boot-order of devices (VCD first, then disk) for the pServer mylpan/win2003:

pserver -b -O vcd,vhba mylpan/win2003

Modify the boot-order of devices (network, then disk, then VCD) for the pServer mylpan/win2003:

pserver -b -O vnic,vhba,vcd mylpan/win2003

Assign the pServer webdev1 the second among all pServers within the development LPAN to boot:

pserver -A 2 development/webdev1



SEE ALSO CONSOLE

DOMAIN

EVENTTYPE

LPAN

MON


2-107 PM7.0.0

PAN

PNODE

POOL

VSWITCH


ROLE

PM7.0.0 2-108

ROLE

NAME role - Lists the roles within the PAN or LPAN

SYNOPSIS role [-l] [rolename]

role [-l] [-L lpanname]

role [-l] -U rolename

DESCRIPTION The role command lists the roles within a domain for which the user has administrative privileges. PAN Administrators use the role command to list the exact name of roles they use as arguments for the user command when assigning roles to PAN Manager users.

To see all the roles within the PAN domain, use the role command without options or arguments.

OPTIONS -L, --lpanname lpanname

Lists all roles associated with the specified LPAN.

-l, --long

Adds a description for each role within the PAN domain.

-U, --users rolename

Lists the PAN Manager users for a specified role.

EXAMPLES Lists all the roles and a description of each role for the PAN:

role -l

List the users with the role of PAN Administrator:

role -U PAN-Administrator


2-109 PM7.0.0

List the users with the Operator role for the development LPAN:

role -U development-LPAN-Operator


SEE ALSO ACCOUNT

USER


ROLE

PM7.0.0 2-110


2-111 PM7.0.0

SMTP

NAME smtp - Lists and modifies the PAN configuration for the Simple Mail Transport Protocol (SMTP) server at your site

SYNOPSIS smtp [-l]

smtp [-i ipaddress] [-p port] [-U {user|none}] [-P password] [-s send-address]

DESCRIPTION The smtp command lists and modifies the configuration to allow a PAN to communicate with the Simple Mail Transport Protocol (SMTP) server at your site. PAN Administrators use the smtp command to allow a PAN to send email messages from its SMTP server as well as set up the sender address of the PAN Manager mail gateway.

Though it is possible to have more than one PAN Administrator enabled to configure the SMTP server of the PAN, PAN Administrators can only configure one mail gateway for the PAN.

Only PAN Administrators can use the smtp command.

OPTIONS -i, --ipaddress ipaddress

Modifies the IP address to match your SMTP server. To clear the setting, specify an empty string (““) for ipaddress. If this configuration is empty, PAN Manager cannot send any email notifications.

-l, --list

Displays the current configuration for your SMTP server and the PAN Manager mail gateway.

-p, --port port_number

Modifies the port number to match your SMTP server.

SMTP

PM7.0.0 2-112

-P, --password "text"

Modifies the password associated with the account designated with the -U (user) option. (If the text contains spaces, enclose it within double quotes.)

-s, --send-address emailaddress

Modifies the sender of the PAN Manager mail gateway. There can only be one ‘send’ address for the PAN. This email address must match an existing account on your SMTP server.

-U, --user username

Modifies the Linux account name of the PAN Administrator(s) you designate as the sender. Only accounts that have PAN Administrator roles are valid.

EXAMPLES Display information about the SMTP server for the PAN:

smtp

Specify the sending email address on your site’s SMTP server, and the SMTP server’s port number:

smtp -p 90 -s [email protected]



SEE ALSO PAN



2-113 PM7.0.0

SWITCH

NAME switch - Lists information about the domain’s physical FlexFabric switches

SYNOPSIS switch [-l] switchname

DESCRIPTION The switch command displays information about the physical switch devices in the domain.

Without arguments, the command lists:

• all switches in the Processing Area Network (PAN)

• their ON/OFF power status

• on which fabric they reside. (A fabric is a grouping of physical switches within the same domain that have common connectivity.)

The domain supports a single fabric: f1.

• their type (Converged). “Converged” means that the switch supports both Ethernet and Fibre Channel ports, and therefore external connectivity to Ethernet networks and Fibre Channel storage arrays.

• the number of uplinks in the PAN. (Each working uplink is composed of one or more physical ports on a FlexFabric switch.)

The following ports (and their types) reside on each FlexFabric switch, where sN is the name of the switch (s1 or s2):




SWITCH

PM7.0.0 2-114




(On each switch, Ports 7 and 8 are used for stacking and are neither available for configuration in PAN Manager, nor visible in the switch command’s output.)




switchname

which indicates a name that is unique across the PAN for a specific physical FlexFabric switch, in the format:

domain:chassisname/switchname

For example:

panther:c1/s1

FlexFabric switch s1 in chassis c1 on the domain panther.

If there is only one domain, then domain is optional. If there is only one chassis, then chassisname is optional. For example, if there is only one chassis in the PAN, you need only specify s1.


2-115 PM7.0.0

OPTIONS -l, --long

Displays details about the physical switches in the PAN, including details about the switches’ ports.

EXAMPLES Display overview information about FlexFabric switches in the PAN:

switch

Display detailed information about all switches (and their ports) in the PAN:

switch -l

Display detailed information about switch 2 on chassis 1 on the domain kodiak:

switch -l kodiak:c1/s2



SEE ALSO DOMAIN

PORT

UPLINK

VSWITCH


SWITCH

PM7.0.0 2-116


2-117 PM7.0.0

UPLINK

NAME uplink - Creates, lists, modifies, or deletes an Ethernet or Fibre Channel uplink

SYNOPSIS uplink -c {-E|-F} [portname...] uplinkname

uplink {-a|-r} portname [portname...] uplinkname

uplink -n newname uplinkname

uplink -d [-f] uplinkname

uplink [-l] [uplinkname]

DESCRIPTION The uplink command creates, configures, lists, and deletes uplinks. Each uplink combines one or more switch ports that are entirely under PAN Manager control into a single entity that connects a domain or domains to one or more external Ethernet switches or Fibre Channel switches.

Some guidelines:

• When you create the uplink, you must specify the uplink's type. Possible types are Ethernet, Fibre Channel, and Unknown (usually indicates the ports are unused).

• After it is created, you cannot change an uplink's type.

• You can add only Ethernet ports to an Ethernet uplink. Likewise, you can add only Fibre Channel ports to a Fibre Channel uplink.

• You cannot configure ports of different types (Fibre Channel and Ethernet) in the same uplink.

• You cannot configure a specific port in multiple uplinks.

• You can have a maximum of twelve uplinks in a domain. (This number derives from the presence of six available ports on each of the domain’s two FlexFabric switches.)

UPLINK

PM7.0.0 2-118

• When you configure a domain, PAN Manager automatically creates an uplink called default. Later, when you create an LPAN, PAN Manager automatically creates a vSwitch (used only for the private management network), allocates it to the LPAN, and associates it with the default uplink.

The following ports (and their types) reside on each FlexFabric switch, where sN is the name of the switch (s1 or s2):







(On each switch, Ports 7 and 8 are used for stacking and are neither available for configuration in PAN Manager, nor visible in the switch command’s output.)




portname

which indicates a name that is unique across the PAN for a specific physical port on a FlexFabric switch, in the format:

domain:chassisname/switchname:portnumber

For example:


2-119 PM7.0.0

panther:c1/s1:5

indicates port 5 on FlexFabric switch s1 in chassis c1 on the domain panther.

If there is only one domain, then domain is optional. If there is only one chassis, then chassisname is optional. For example, if there is only one chassis in the PAN, you need only specify s1:5.

OPTIONS -a, --add-ports

Adds one or more ports to an existing uplink.

-c, --create

Creates an uplink in the PAN. You must also specify the type of uplink you are creating: -E for Ethernet or -F for Fibre Channel storage.

Attempting to create an uplink with ports of an incompatible type causes those ports not to be added to the new uplink.

-d, --delete

Deletes an uplink from the PAN.

-E, --ethernet

Specifies that the uplink is to be used for connectivity to one or more Ethernet networks.

-F, --fibre-channel

Specifies that the uplink is to be used for connectivity to one or more Fibre Channel storage networks.

-f, --force

Combined with the -d (delete) option, removes the uplink from the PAN, even if the uplink setting appears to persist in the HP Virtual Connect FlexFabric.

UPLINK

PM7.0.0 2-120

-l, --long

Displays details about one or more uplinks, including the ports each contains and the fabric it is using. (A fabric is a grouping of physical switches within the same domain that have common connectivity.)

-n, --rename newname

Renames the uplink without changing the number or type of ports it contains.

-r, --remove-ports

Removes one or more ports from an existing uplink.

EXAMPLES List all uplinks in the PAN.

uplink

List all uplinks in the PAN, including the fabric each is using and the ports it contains.

uplink -l

Create an uplink that consists of two (fully qualified) Ethernet ports. (If you configure two Ethernet ports in the uplink, it is a best practice to be sure the ports reside on different FlexFabric switches: one on s1 and one on s2.)

uplink -c -E s1:1 s2:1 uplinkgroup8

Create an uplink that consists of two Fibre Channel storage ports. (If you configure multiple Fibre Channel ports in the uplink, be sure the ports reside on the same FlexFabric switch: either s1 or s2. In this example, both ports reside on s1.)

uplink -c -F s1:3 s1:4 uplinkstor5

Add two ports to an uplink:

uplink -a s1:1 s1:2 uplinkstor5


2-121 PM7.0.0

(You can add only Fibre Channel ports to a Fibre Channel uplink, or Ethernet ports to an Ethernet uplink.)



SEE ALSO DOMAIN

LPAN

PNODE

PORT

SWITCH

VSWITCH


USER

PM7.0.0 2-122

USER

NAME user - Creates or modifies attributes, including role assignments, for each PAN Manager software user

SYNOPSIS user {-a |-m} [-N fullname][-T title][-E emailaddress][-D deptname] username

user -r [-f] username

user [-l] [username]

user [-l] [-O |-S |-L lpanname]

user [-aR |-rR] rolename username

DESCRIPTION The user command creates or modifies attributes, including role assignments, for each PAN Manager software user. PAN Administrators can create PAN Manager users with the same username on the PAN OPServers using either the account command or another Linux account management tool.

PAN Manager users require a Linux user account created with the PAN Manager command, account, for PAN OPServer access. You should create PAN Manager accounts for those administrators who will use PAN Manager to manage a PAN or an LPAN. PAN Manager users with only a PAN Manager user account cannot access the PAN OPServers directly.

Using the user -l command without an argument displays a list of current users.




2-123 PM7.0.0


username

Reference to the username PAN Manager uses to identify a PAN Manager user.

OPTIONS -a, --add username

Adds a specified Linux account user as a PAN Manager user.

-aR, --assign rolename username

Assigns a role to a user. Specify role -l to display a complete list and description of current roles.

-D, --deptname "deptname”

Specifies a user’s department. (If the text contains spaces, enclose it within double quotes.)

-E, --email emailaddress

Specifies the email address for a user.

-f, --force

Forces a user command operation without displaying a prompt.

-L, --lpanusers lpanname

Displays a list of users in a specified LPAN. Use this option in combination with the -l (list) option.

-l, --long

Lists information about current users. Without an additional argument, the list option displays the roles, full name, title, email, and department name for all users. You can use this option in combination with the -S (sysadmins) and -O (roles) options to display a filtered list of users.

-m, --modify username

Modifies the settings for a specified PAN Manager user.

USER

PM7.0.0 2-124

-N, --fullname fullname

Specifies the full name of a user, if needed. (If the text contains spaces, enclose it within double quotes.)

-O, --roles

Lists all the users by username, and the roles they have been assigned. Use this option in combination with the -l (long) option.

-r, --remove username

Removes a specified PAN Manager user.

-rR, --un-assign rolename username

Removes a role from a PAN Manager user.

-S, --sysadmins

Lists all the users assigned the role of PAN Administrator. Use this option in combination with the -l (long) option.

-T, --title "title"

Specifies the title of a user, if needed. (If the text contains spaces, enclose it within double quotes.)

EXAMPLES Add a full name and an email address to the user cgable:

user -m -N Clark_Gable -E [email protected] cgable

List the users that have the LPAN Administrator role in the LPAN development:

user -l development-LPAN-Administrator

Give user cgable an LPAN Administrator role in the development LPAN:

user -aR development-LPAN-Administrator cgable


2-125 PM7.0.0



SEE ALSO ACCOUNT

ROLE

To view the man page for a PAN Manager command, enter the following (in all lowercase letters) at the Linux prompt: man egenera_commandname (for example, man egenera_role).

VERSION

PM7.0.0 2-126

VERSION

NAME version - Lists versions of software packages installed on a PAN OPServer or pServer

SYNOPSIS version [{-e|-c|-p|-k|-g|-r}] [panname/pmN]

version [{-e|-c|-p|-k|-g|-r|-b}] -s lpanname/pservername

DESCRIPTION The version command lists versions of PAN Manager software installed on a domain. Specific revision information for software running on the PAN OPServers includes:

• PAN Manager

• the PAN Manager Help system

• the PAN Tools software (for managing pServers)

• the installation history of all RPMs on the PAN OPServers

Specific revision information for software running on a specified pServer includes:

• the PAN Agent (installed using the PAN Tools utility, the PAN Agent is an optional service that allows you to gracefully shutdown a pServer from PAN Manager and provides additional health monitors for a pServer)

• the Heartbeat Client (installed using the PAN Tools utility, the Heartbeat Client is a service that monitors pServer health)

• the version of the operating system software

• (For Linux pServers only) the installation history of all RPMs installed on the pServer


2-127 PM7.0.0

All users can use the version command without arguments to display a list of all version information for the domain. The specified PAN OPServer or pServer you are interested in must be currently booted for the information to be updated or displayed.




panname/pmN

Specifies the name of the PAN and a specific PAN OPServeron which PAN Manager is running.


Specifies a pServer. You must use a forward slash (/) between the LPAN name and the pServer name. For example, the pServer, Web1, to be designated as a MON server in the production LPAN, would be referred to as production/Web1. PAN Administrators use the lpan command to name LPANs, and LPAN Administrators use the pserver command to name pServers.

OPTIONS -b, --heartbeat-version

Combined with the -s (pServer) option, displays version information about the Heartbeat client daemon running on the pServer.

-c, --cd-version

Displays the release and build number of the installation media for PAN Manager. When combined with the -s (pServer) option, displays information about the version of PAN Tools software that is running on the pServer.

VERSION

PM7.0.0 2-128

-e, --everything

Displays revision information about all PAN software installed, including PAN Manager, the PAN Manager Help system, the PAN Tools software (for managing pServers), and the installation history of all RPMs on the PAN OPServers

-g, --revision-log

Displays a revision history of the RPMs installed on the PAN OPServers.

-k, --kernel

Displays the version of the Linux kernel that is running on the PAN OPServers.

-p, --pan-version

Displays information about the software currently installed on the PAN OPServer. For PAN Manager: version number, build number, and date the software was created.

-r, --rpm-list

Displays the RPMs of the PAN software installed on the PAN OPServers.

-s, --pserver {lpanname/pservername}

Specifies a pServer’s version information. This requires that the PAN Agent software is running on the pServer.

SEE ALSO To view the man page for a PAN Manager command, enter the following (in all lowercase letters) at the Linux prompt: man egenera_commandname (for example, man egenera_lpan).


2-129 PM7.0.0

VSWITCH

NAME vswitch - Creates, modifies, lists, or deletes a Virtual Switch (vSwitch)

SYNOPSIS vswitch -c -E [-U uplinkname] [-V vlan_id] vswitchname

vswitch -c -F [-U uplinkname] vswitchname

vswitch [-U [uplinkname | none]] vswitchname

vswitch -n newname vswitchname

vswitch -d [-f] vswitchname

vswitch [-l] [vswitchname]

DESCRIPTION The vswitch command creates, modifies, lists, or deletes a virtual switch in the Processing Area Network (PAN). When you create a vSwitch, you must specify its type: an Ethernet vSwitch (for network connectivity) or a Fibre Channel vSwitch (for storage connectivity). After a vSwitch is created, you cannot change its type.

When you create an Ethernet vSwitch, you must specify either the VLAN in which it will operate, or allow PAN Manager to select a VLAN from the range of VLANs already defined using the pan command.

Important: To ensure proper network connectivity between pServers on which PAN Tools are installed and the PAN OPServers, you must enable multicast forwarding on the VLANs that are assigned to private management vSwitches.

You do not specify a VLAN when creating a Fibre Channel vSwitch.

VSWITCH

PM7.0.0 2-130

To connect the vSwitch to an external network, you can specify an uplink, either at creation time or later. To have the vSwitch remain only in the management network, either set its uplink to none or do not specify an uplink at all.




vswitchname

Specifies the name of a PAN Manager virtual switch.

uplinkname

Specifies an uplink (created using the uplink command)

vlan_id

Specifies a VLAN ID configured using either the pan command (for external networks) or the intnet command (strictly for use by a private management network).

OPTIONS -c, --create vswitchname

Creates a vSwitch.

-d, --delete vswitchname

Deletes the specified vSwitch. Before you can delete a vSwitch, you must remove it from any LPAN to which it is allocated.

-E, --ethernet

Used with -c, creates an Ethernet vSwitch (for network connectivity).


2-131 PM7.0.0

-F, --fibre-channel

Used with -c, creates a Fibre Channel vSwitch (for storage connectivity).

-f, --force

Combined with the -d (delete) option, removes the vSwitch from the PAN, even if the vSwitch setting appears to persist in the HP Virtual Connect FlexFabric.

-l, --long

Lists all information about current vSwitches, including the VLAN (if any) to which the vSwitch is uplinked, and the fabric the vSwitch is using. (A fabric is a grouping of physical switches within the same domain that have common connectivity.)

-n, --rename newname vswitchname

Renames the specified existing vSwitch.

-U, --uplink uplinkname | none

Associates a vSwitch either with a specified uplink or with no uplink (none). (Use the uplink command to display the available uplinks.) Specifying -U none clears any uplinks on an existing vSwitch.

-V, --vlan-id VLAN_ID

Associates an Ethernet vSwitch with a specified VLAN. Valid VLAN numbers range from 1 to 4094. When creating an Ethernet vSwitch, you must do one of the following:

• Use -V to specify a VLAN

• Omit the -V option. This allows PAN Manager to select an available VLAN from a range of VLANs defined using the pan -a -V command. (A VLAN is available if it is not already associated with a vSwitch.)

VSWITCH

PM7.0.0 2-132

EXAMPLES Create an Ethernet vSwitch, ext_sw, and associate it with Ethernet uplink uplink36 and VLAN 630.

vswitch -c -E -U uplink36 -V 630 ext_sw

Create an Ethernet vSwitch, my_vswitch1, and associate it with the Ethernet uplink uplk_eth5. (Omitting -V causes PAN Manager to autoselect for the vSwitch a VLAN from a range of valid and available VLANs.)

vswitch -c -E -U uplk_eth5 my_vswitch1

Create an Ethernet vSwitch that has no uplink. (This is useful for connecting pServers that can communicate with each other, but do not need to communicate with the external network.)

vswitch -c -E -V 335 internal_sw

Create a Fibre Channel vSwitch, fibre_sw, and associate it with the Fibre Channel uplink uplink_stor.

vswitch -c -F -U uplink_stor fibre_sw

Change the uplink with which a vSwitch is associated.

vswitch -U uplink25 ext_sw

Delete the vSwitch my_vswitch_int2.

vswitch -d my_vswitch_int2



SEE ALSO LPAN

PAN

PORT


2-133 PM7.0.0

PSERVER

SWITCH

UPLINK


Documents

HP Commands