Azul Command Line Interface Guidestaff.ii.pw.edu.pl/azul/Azul_Command_Line... · About This Guide...

Copyright © 2008 Azul Systems, Inc. All rights reserved.

510-00251

Version 6

Azul Software Compatibility

This product guide is compatible with AVX distribution 2.6. For more information on obtaining other versions of Azul documentation, see the Azul Systems Support Site section of this guide.

Azul Command Line Interface Guide

ii | Azul Command Line Interface Guide, Version 6

Azul Command Line Interface Guide, Version 6Printed in the U.S.A.510-00251March 2008

Notice of Rights

No part of this guide may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Azul Systems. Please note that the content in this guide is protected under copyright law even if it is not distributed with software that includes an end user license agreement.

Notice of Liability

Azul Systems reserves the right to make changes, without notice. The content of this guide is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Azul Systems. Azul Systems assumes no responsibility or liability for any errors or inaccuracies that may appear in the informational content contained in this guide.

Trademarks

Copyright © 2004–2008, Azul Systems®, Inc. All rights reserved. Azul and Azul Systems are registered trademarks of Azul Systems, Inc. in the United States and other countries. The Azul arch logo, Compute Pool Manager, and Vega are trademarks of Azul Systems, Inc. in the United States and other countries.

BEA and WebLogic are registered trademarks of BEA Systems, Inc. in the United States and other countries.

IBM and WebSphere are trademarks of International Business Machines Corporation in the United States and other countries.

JBoss is a registered trademark of JBoss Inc.

Linux is a registered trademark of Linus Torvalds. RedHat is the property of Red Hat, Inc. Sun, Sun Microsystems, Solaris, J2EE, J2SE, Java and all Java based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.

Other marks are the property of their respective owners and are used here only for identification purposes. Products and specifications discussed in this document may reflect future versions and are subject to change by Azul Systems without notice.

Contents

List of Tables...............................................................................................................................................iv

List of Examples ..........................................................................................................................................iv

Purpose ..................................................................................................................................................... viiAudience ................................................................................................................................................... viiOrganization ............................................................................................................................................ viiiRelated Documentation ........................................................................................................................... viiiConventions............................................................................................................................................. viiiAzul Systems Support Site ........................................................................................................................ viiiContact Azul Systems................................................................................................................................. ix

Chapter 1: Command Line Interface Reference........................................................................................... 1

Using the CLI ............................................................................................................................................. 1Character Case Sensitivity in the CLI................................................................................................... 1Special Keys ......................................................................................................................................... 1CLI Usage Tips.................................................................................................................................... 2

CLI Command Help................................................................................................................................... 2Command Error Messages........................................................................................................................... 2Starting a CLI Management Session............................................................................................................ 3

SSH Client Sessions ............................................................................................................................. 3Serial Connection Sessions ................................................................................................................... 3CLI Opening Welcome Display........................................................................................................... 3

Command Description, Syntax, and Examples............................................................................................ 3history.................................................................................................................................................. 4install ................................................................................................................................................... 5ping ................................................................................................................................................... 16quit .................................................................................................................................................... 17reboot ................................................................................................................................................ 18reset ................................................................................................................................................... 19set cpm .............................................................................................................................................. 22set domain create ............................................................................................................................... 24set domain join .................................................................................................................................. 25set domain keys.................................................................................................................................. 26set domain preregister ........................................................................................................................ 27show auth .......................................................................................................................................... 29

Azul Command Line Interface Guide, Version 6 | iii

List of Tables

show clock ......................................................................................................................................... 30show cpm........................................................................................................................................... 31show deconfig .................................................................................................................................... 32show dns ............................................................................................................................................ 33show env ............................................................................................................................................ 34show hostname .................................................................................................................................. 36show interface .................................................................................................................................... 37show ntp ............................................................................................................................................ 38show route ......................................................................................................................................... 39show snmp......................................................................................................................................... 40show status......................................................................................................................................... 41show syslog ........................................................................................................................................ 44show system ....................................................................................................................................... 45show useraccounts.............................................................................................................................. 48show version ...................................................................................................................................... 49upgrade software ................................................................................................................................ 50upload................................................................................................................................................ 52

Command Summary................................................................................................................................. 54

Index ......................................................................................................................................................... 57

List of TablesTable 1-1: Special Keys ................................................................................................................................... 2Table 1-2: Out-of-band IP Address Assignment.............................................................................................. 5Table 1-3: CLI Commands........................................................................................................................... 54

List of ExamplesExample 1-1: Welcome Message ..................................................................................................................... 3Example 1-2: history Command ..................................................................................................................... 4Example 1-3: install Command – In-band, Static Address Assignment ........................................................... 5Example 1-4: install Command – In-band, DHCP Address Assignment......................................................... 8Example 1-5: install Command – Out-of-band, DHCP for Management, DHCP for Data ........................... 9Example 1-6: install Command – Out-of-band, DHCP for Management, Static for Data............................ 10Example 1-7: install Command – Out-of-band, Static for Management, DHCP for Data............................ 11Example 1-8: install Command – Out-of-band, Static for Management, Static for Data............................... 12Example 1-9: install Command – Out-of-band 10G NICs ........................................................................... 14Example 1-10: ping Command—Successful Connection.............................................................................. 16Example 1-11: ping Command—No Connection ........................................................................................ 16Example 1-12: quit Command...................................................................................................................... 17Example 1-13: reboot Command.................................................................................................................. 18Example 1-14: reset Command..................................................................................................................... 19

iv | Azul Command Line Interface Guide, Version 6

List of Examples

Example 1-15: reset clearall Command ......................................................................................................... 19Example 1-16: reset diagmode Command..................................................................................................... 20Example 1-17: reset localauth Command...................................................................................................... 20Example 1-18: set cpm enable Command ..................................................................................................... 22Example 1-19: set cpm disable Command .................................................................................................... 22Example 1-20: set cpm start Command ........................................................................................................ 22Example 1-21: set cpm stop Command ........................................................................................................ 23Example 1-22: set domain create Command – Establish a New Domain Named cpm01.............................. 24Example 1-23: set domain join Command.................................................................................................... 25Example 1-24: set domain keys Command ................................................................................................... 26Example 1-25: set domain preregister Command – Pre-register the Appliance into the ‘Common’ Pool....... 28Example 1-26: show auth Command............................................................................................................ 29Example 1-27: show clock Command........................................................................................................... 30Example 1-28: show cpm Command ............................................................................................................ 31Example 1-29: show deconfig Command...................................................................................................... 32Example 1-30: show dns Command ............................................................................................................. 33Example 1-31: show env Command ............................................................................................................. 34Example 1-32: show hostname Command.................................................................................................... 36Example 1-33: show interface Command...................................................................................................... 37Example 1-34: show ntp Command.............................................................................................................. 38Example 1-35: show route Command........................................................................................................... 39Example 1-36: show snmp Command .......................................................................................................... 40Example 1-37: show status reset Command .................................................................................................. 41Example 1-38: show status install Command................................................................................................ 42Example 1-39: show status upgrade Command............................................................................................. 42Example 1-40: show syslog Command.......................................................................................................... 44Example 1-41: show system Command......................................................................................................... 45Example 1-42: show system Command with 10G NICs ............................................................................... 46Example 1-43: show system Command—1G Interface, No NICs ................................................................ 47Example 1-44: show useraccounts Command ............................................................................................... 48Example 1-45: show version Command........................................................................................................ 49Example 1-46: upgrade software Command.................................................................................................. 50Example 1-47: upload cores ftp Command ................................................................................................... 52Example 1-48: upload logs ftp Command..................................................................................................... 52

Azul Command Line Interface Guide, Version 6 | v

Notes

vi | Azul Command Line Interface Guide, Version 6

List of Examples

About This Guide

This chapter provides an overview of the Azul Command Line Interface Guide. It covers the following topics:

Purpose

Audience

Organization

Related Documentation

Conventions

Azul Systems Support Site

Contact Azul Systems

PurposeThe Azul Command Line Interface Guide describes how to access the Azul command line interface and provides a command reference.

AudienceThis guide is intended for system administrators who install and maintain Azul Systems Compute Appliances.

Azul Command Line Interface Guide, Version 6 | vii

About This Guide

OrganizationThe Azul Command Line Interface Guide is organized as follows:

Chapter 1, “Command Line Interface Reference”—describes the basic features of the Azul Systems command line interface (CLI) and how to use the commands, and presents a summary table of all CLI commands.

Related DocumentationCompute Appliance Installation and Maintenance Guide

Compute Pool Manager Guide

Compute Pool Manager Installation and Upgrade Guide

Azul Virtual Machine Guide

ConventionsThe following conventions are used in this guide:

Azul Systems Support SiteAzul documentation is available to registered customers through Azul Systems support sites. To access your Azul support site, go to: http://support.azulsystems.com.

This password-protected site requires a user name and login. To obtain a password, contact Azul Systems at 1.800.258.4199. If you do not have a login, contact your designated Azul representative, or send a request to [email protected].

WARNING Means danger. This situation could cause bodily injury. Before working on any equipment, be aware of the hazards involved and familiar with standard practices for preventing accidents.

!CAUTION Means be careful. In this situation, something is being done that could result in equipment damage or loss of

data.

GO TO Points to related topics or reference documentation.

TIP Provides additional information to help solve a problem.

NOTE Provides additional information or exceptions to rules.

viii | Azul Command Line Interface Guide, Version 6

mailto: [email protected]

http://support.azulsystems.com

About This Guide

Contact Azul SystemsAddress Phone Fax Email/WWW

General Azul Systems, Inc.1600 Plymouth StreetMountain View, CA 94043

650.230.6500 650.230.6600 [email protected]

http://www.azulsystems.com

Support Services

Azul Systems, Inc.1600 Plymouth StreetMountain View, CA 94043

1.800.258.4199 650.230.6600 [email protected]


Azul Command Line Interface Guide, Version 6 | ix

mailto:[email protected]

http://www.azulsystems.com


Notes

x | Azul Command Line Interface Guide, Version 6

About This Guide

Chapter 1

Command Line InterfaceReference

This chapter describes the basic features of the Azul Systems command line interface (CLI) and how to use the commands. This chapter describes the following topics:

Using the CLI

CLI Command Help

Command Error Messages

Starting a CLI Management Session

Command Description, Syntax, and Examples

Command Summary

Azul Compute Appliances can also be managed using the Azul Systems browser-based Compute Pool Manager console. For more information on issuing commands using CPM, see the Compute Pool Manager Guide.

The CLI is accessible by serial port or an SSH session over the network.

Using the CLIThis section describes CLI case-sensitivity requirements, CLI special characters, and CLI usage tips.

Character Case Sensitivity in the CLICLI commands, keywords, and reserved words are case sensitive. Enter commands and keywords in lower case.

User-defined strings are case-sensitive and may consist of both uppercase and lowercase characters characters. Case for user-defined strings is preserved in the configuration.

Special KeysThe CLI supports the use of special keyboard keys. Table 1-1 lists and describes the special keys functionality.

NOTE The administrator can perform limited configuration on the compute appliance using the command line interface. Any changes made in the Compute Pool Manager console overwrite the CLI configuration.

Azul Command Line Interface Guide, Version 6 | 1

Command Line Interface Reference

CLI Usage TipsThe CLI provides command-completion functionality. Press the Tab key to complete the current command word at any point after it is unique.

CLI commands take effect immediately after input, and changes to the system configuration are saved automatically.

Lists and short descriptions of available commands: Information about available commands is provided at each level of the CLI command hierarchy. Type a question mark (?) at any level to display a list of available commands and a short description of each command.

CLI Command HelpYou can access CLI help by entering a question mark character (“?”) after the command name. If no command matches your query, the help list is empty. Delete characters until entering a question mark displays available options.

Two types of CLI help are provided:

Full help is available by entering a command argument, followed by “?”. For example, show? displays a complete description for all show arguments.

Abridged help is accessed by typing an abbreviated argument with the command, followed by “?”. For example, show ca? only displays show command arguments that begin with “ca.”

Command Error MessagesThe CLI displays one of the following messages to indicate when a command is unsuccessful or is entered incorrectly:

Unknown command: The command entered is not supported, or is not available at the user’s privilege level.

Invalid parameter: The command entered is correct, but the parameter after the command is invalid. To access help on command parameters, enter the command name followed by a question mark.

Missing parameter: The command requires a parameter for successful completion, but the user did not supply a valid parameter.

Table 1-1 Special Keys

Key Description

? List choices

Backspace Delete character backwards

Tab Command word completion

Ctrl-A Go to the beginning of the line

Ctrl-D Exit the console

Ctrl-E Go to the end of the line

Right Arrow Go forward one character

Down Arrow Go to the next line in the history buffer

Up Arrow Go to the previous line in the history buffer

2 | Azul Command Line Interface Guide, Version 6


Starting a CLI Management SessionThis section describes how to start a CLI management session through an SSH client or a serial connection.

SSH Client SessionsTo access the CLI using an SSH client, perform the following procedure:

Step 1 Start the SSH client.

Step 2 Use the following parameters to connect to the compute appliance:

Enter the host name or session name to match the compute appliance IP address or host name of NP0

Configure the port to the default SSH port, 22

Configure the terminal type as VT100 or ANSI

Step 3 Enter the admin user ID and password at the login prompt.

Serial Connection SessionsRefer to the Compute Appliance Installation and Reference Guide for information on connecting a serial console to the compute appliance.

Step 1 Follow the procedure described in the documentation for your terminal emulation software to connect to the compute appliance.

Step 2 Enter the admin user ID and password at the login prompt.

CLI Opening Welcome DisplayWhen you log in, the CLI displays a welcome message and command prompt:

Example 1-1 Welcome Message

Trying 127.0.0.1...Connected to localhost.localdomainEscape character is 'off'.Azul Appliance <hostname> CLIadmin@localhost#

Command Description, Syntax, and ExamplesThe following sections list all available commands, command descriptions, syntax, examples, and usage guidelines or related commands.

NOTE

Configuration commands can only be performed from Network Processor 0 (NP0).



history

Syntaxhistory

Description

Displays the last 500 commands the user issued during the current CLI session.

Options

None

Sample Command Output

Example 1-2 history Command

admin@localhost# history

1 show env all 2 show version 3 show route 4 show env temperature 5 show env fan 6 show env power 7 history

admin@localhost#

Usage Guidelines

None

Related Commands

None

NOTE

This command displays only the commands issued in the current CLI session.



install

Syntaxinstall

Description

Configures network settings for the compute appliance. This command launches an installation wizard to gather input for the appliance name, and the management and/or data network address assignments. This command can be performed only by a user with domain management or appliance administrator permissions.

For in-band configurations, IP address assignment can be static or DHCP (see Note 1 below) for the combined data/management network.

For out-of-band configurations, IP address assignment can be as shown in Table 1-2

Options

None


Example 1-3 install Command – In-band, Static Address Assignment

admin@localhost#install

Appliance Name : hwlab66 Appliance Management network type : 1) In-Band 2) Out-of-Band Select : [1] IP Address Assignment Setup 1) DHCP 2) Manual/Static Select : [1] 2

Table 1-2 Out-of-band IP Address Assignment

Data Network Management Network

Static Static

Static DHCP

DHCP1

Note 1. Use fixed address assignment for DHCP for data or combined data/management networks toprevent application failure when DHCP leases are renewed.

Static

DHCP1 DHCP



For Network Processor 0 Mgmt/Data IP address : 10.10.202.66 netmask : [255.255.255.0] gateway : [10.10.202.1] For Network Processor 1 Mgmt/Data IP address : 10.10.202.67 Summary of settings entered Appliance Name : hwlab66 Mgmt Network Type : In-Band Management IP Address Assignment : Manual/Static For Network Processor 0 hostname : hwlab66_0 Mgmt/Data IP address : 10.10.202.66 netmask : 255.255.255.0 gateway : 10.10.202.1 link status : Port 0 up, Port 1 down For Network Processor 1 hostname : hwlab66_1 Mgmt/Data IP address : 10.10.202.67 netmask : 255.255.255.0 gateway : 10.10.202.1 link status : Port 0 up, Port 1 downDo you want to continue [y/n] y

Successfully executed configuration command. Appliance Name : hwlab66 Model Number : 1920B Serial Number : 0104-0093-CM2-00 Installed Processor cores : 192Operational Processor cores : 192Committable Processor cores : 96 Next Boot Processor cores : 192 Operational Memory In GB : 64 Committable Memory In GB : 55 Next Boot Memory In GB : 64 Mgmt Network Type : In-Band Management IP Address Assignment : Manual/Static NTP Server :



Syslog host : System time : Thu Mar 6 15:30:08 PST 2008 System uptime : 18:14 minutes Network Processor 0 (Primary) Hostname : hwlab66_0 MAC Address : 00:0F:51:00:00:B0 Mgmt/Data Address : 10.10.202.66 Netmask : 255.255.255.0 Gateway : 10.10.202.1 Network Processor 1 Hostname : hwlab66_1 MAC Address : 00:0F:51:FF:F1:4C Mgmt/Data Address : 10.10.202.67 Netmask : 255.255.255.0 Gateway : 10.10.202.1 Compute Pool Manager Information Domain Name : none Management VIP : N/A Policy VIP : N/A CPM Status : on NP0: disabled, on NP1: disabled Restarting the system.It may take several minutes. Please wait ...

Generating keys ...doneStopping system applications ...donePreparing system ...doneStarting RAS agent ...doneStarting System agent ...doneStarting Appliance manager ...doneStarting Trust manager ...doneStarting Event manager ...doneStarting AP ...doneStarting Proxyinit ...doneStarting Compute Pool Manager ...doneStarting SNMP agent ...doneStarting Monitoring agent ...doneRestarting OpenBSD Secure Shell server: sshd.System restart complete.



Example 1-4 install Command – In-band, DHCP Address Assignment


Appliance Name : qa1605

Appliance Management network type :

1) In-Band 2) Out-of-Band

Select : [1]IP Address Assignment Setup

1) DHCP 2) Manual/Static

Select : [1]

Summary of settings entered Appliance Name : qa1605 Mgmt Network Type : In-Band Management IP Address Assignment : DHCP

For Network Processor 0 hostname : qa1605_0 GbEthernet Mgmt/Data IP address : [Getting using DHCP] link status : Port 0 up, Port 1 up

For Network Processor 1 hostname : qa1605_1 GbEthernet Mgmt/Data IP address : [Getting using DHCP] link status : Port 0 up, Port 1 up

Do you want to continue [y/n]



Example 1-5 install Command – Out-of-band, DHCP for Management, DHCP for Data





Select : [1] 2

Mgmt IP Address Assignment Setup


Select : [1]

Data IP Address Assignment Setup


Select : [1]

Summary of settings enteredAppliance Name : qa1605

Mgmt Network Type : Out-of-Band ManagementMgmt IP Address Assignment : DHCPData IP Address Assignment : DHCP

For Network Processor 0hostname : qa1605_0

10/100 Ethernet Mgmt IP address : [Getting using DHCP]GbEthernet Data IP address : [Getting using DHCP]

link status : Port 0 up, Port 1 up

For Network Processor 1 hostname : qa1605_1 10/100 Ethernet Mgmt IP address : [Getting using DHCP] GbEthernet Data IP address : [Getting using DHCP] link status : Port 0 up, Port 1 up




Example 1-6 install Command – Out-of-band, DHCP for Management, Static for Data





Select : [1] 2



Select : [1]



Select : [1] 2For Network Processor 0

GbEthernet Data IP address : 10.10.212.58 netmask : [255.255.255.0] 255.255.252.0 gateway : [10.10.212.1]

For Network Processor 1

GbEthernet Data IP address : 10.10.212.59

Summary of settings entered Appliance Name : qa1605 Mgmt Network Type : Out-of-Band Management Mgmt IP Address Assignment : DHCP Data IP Address Assignment : Manual/Static



For Network Processor 0 hostname : qa1605_0 10/100 Ethernet Mgmt IP address : [Getting using DHCP]

GbEthernet Data IP address : 10.10.212.58 netmask : 255.255.252.0 gateway : 10.10.212.1 link status : Port 0 up, Port 1 up

For Network Processor 1 hostname : qa0805_1 10/100 Ethernet Mgmt IP address : [Getting using DHCP]

GbEthernet Data IP address : 10.10.212.59 netmask : 255.255.252.0 gateway : 10.10.212.1



Example 1-7 install Command – Out-of-band, Static for Management, DHCP for Data





Select : [1] 2Mgmt IP Address Assignment Setup


Select : [1] 2



Select : [1]



For Network Processor 0 10/100 Ethernet Mgmt IP Address : 10.10.212.58 netmask : [255.255.255.0] 255.255.252.0 gateway : [10.10.212.1]

For Network Processor 1 10/100 Ethernet Mgmt IP Address : 10.10.212.59

Summary of settings entered Appliance Name : qa1605 Mgmt Network Type : Out-of-Band Management Mgmt IP Address Assignment : Manual/Static Data IP Address Assignment : DHCP

For Network Processor 0 hostname : qa1605_0 10/100 Ethernet Mgmt IP address : 10.10.212.58 netmask : 255.255.252.0 gateway : 10.10.212.1 link status : Port 0 up

GbEthernet Data IP address : [Getting using DHCP] link status : Port 0 up, Port 1 up


GbEthernet Data IP address : [Getting using DHCP]link status : Port 0 up, Port 1 up


Example 1-8 install Command – Out-of-band, Static for Management, Static for Data





Select : [1] 2





Select : [1] 2



Select : [1] 2

For Network Processor 0 10/100 Ethernet Mgmt IP Address : 10.10.202.45 netmask : [255.255.255.0] gateway : [10.10.202.1] GbEthernet Data IP address : 10.10.212.58 netmask : [255.255.255.0] 255.255.252.0 gateway : [10.10.212.1]

For Network Processor 1 10/100 Ethernet Mgmt IP Address : 10.10.202.46 GbEthernet Data IP address : 10.10.212.59

Summary of settings entered Appliance Name : qa1605 Mgmt Network Type : Out-of-Band Management Mgmt IP Address Assignment : Manual/Static Data IP Address Assignment : Manual/Static


GbEthernet Data IP address : 10.10.212.58 netmask : 255.255.252.0 gateway : 10.10.212.1 link status : Port 0 up, Port 1 up




GbEthernet Data IP address : 10.10.212.59 netmask : 255.255.252.0 gateway : 10.10.212.1



Example 1-9 install Command – Out-of-band 10G NICs

10G Network Interface Cards (NICs) detected. Select data network interface type :

1) 10G Network Interface Cards (Out-of-Band only configuration) 2) 1G Network Processor interfaces (In-Band or Out-of-Band configuration)

Select : [1]

10G NICs with Out-of-Band management configuration selected



Select : [1] 2



Select : [1] 2

For Network Processor 0 Mgmt IP Address : 10.10.210.120 netmask : [255.255.255.0] 255.255.254.0 gateway : [10.10.210.1] Data IP address : 10.10.212.236



netmask : [255.255.255.0] 255.255.252.0 gateway : [10.10.212.1]

For Network Processor 1 Mgmt IP Address : 10.10.210.121 Data IP address : 10.10.212.237

Summary of settings entered Appliance Name : az10120 Mgmt Network Type : Out-of-Band Management Mgmt IP Address Assignment : Manual/Static Data IP Address Assignment : Manual/Static

For Network Processor 0 hostname : az10120_0 Mgmt IP address : 10.10.210.120 netmask : 255.255.254.0 gateway : 10.10.210.1 link status : Port 0 up

Data IP address : 10.10.212.236 netmask : 255.255.252.0 gateway : 10.10.212.1

For Network Processor 1 hostname : az10120_1 Mgmt IP address : 10.10.210.121 netmask : 255.255.254.0 gateway : 10.10.210.1 link status : Port 0 up

Data IP address : 10.10.212.237 netmask : 255.255.252.0 gateway : 10.10.212.1

Do you want to continue [y/n] y

Usage Guidelines

The install command can only be performed on a compute appliance that has not yet been configured. Further management and configuration required using the CLI and the Compute Pool Manager browser interface.

Related Commands

See set domain create on page 24, set domain keys on page 26, set domain join on page 25, and set domain preregister on page 27.



ping

Syntaxping <target_IP_address>

Description

Tests the accessibility of a host/node using ICMP echo requests and ICMP echo replies to determine if a remote host is active and is available.

The ping command requires an IP address and not a hostname.

Options

target_IP_address: IP address of the remote host.


Example 1-10 ping Command—Successful Connection

admin@localhost# ping 10.10.130.19PING 10.10.130.19 (10.10.130.19) from 10.10.130.19 : 56(84) bytes of data.764 bytes from 10.10.130.19: icmp_seq=1 ttl=64 time=0.017 ms764 bytes from 10.10.130.19: icmp_seq=2 ttl=64 time=0.008 ms764 bytes from 10.10.130.19: icmp_seq=3 ttl=64 time=0.006 ms--- 10.10.130.19 ping statistics ---3 packets transmitted, 3 received, 0% loss, time 1998msrtt min/avg/max/mdev = 0.006/0.010/0.017/0.005 msadmin@localhost#

Successful output includes transmit and receive packets, and round-trip time data.

Example 1-11 ping Command—No Connection

admin@localhost# ping 10.10.130.19PING 10.10.130.19 (10.10.130.19) from 10.10.130.19 : 56(84) bytes of data.Request timed out.Request timed out.Request timed out.admin@localhost#

A timed out or failed message indicates the connection was unsuccessful.

Usage Guidelines

None

Related Commands

See show hostname on page 36.



quit

Syntaxquit

Description

Ends the CLI session. This command does not affect the operation of the compute appliance.

Options

None


Example 1-12 quit Command

admin@localhost# quitConnection closed by foreign host.

Usage Guidelines

None

Related Commands

None



reboot

Syntaxreboot

Description

Reboots the compute appliance. This commands terminates any virtual machines and associated application instances running on the compute appliance. Note that it takes approximately 15 minutes for the compute appliance to reboot.

Options

None


Example 1-13 reboot Command

admin@localhost# reboot

This will reboot both Network Processors.


Usage Guidelines

Use this command when the compute appliance must be rebooted and power cycled.

Related Commands

See reset on page 19.



reset

Syntaxreset <reset_type>

Description

Resets the run state or configuration parameters of a compute appliance.

Options

reset_type: indicates which system resource to reset. Valid values are:

np0: resets all processes on Network Processor Board 0. On dual NP appliances, running applications are not affected.

np1: resets all processes on Network Processor Board 1. Running applications are not affected.

cpm: resets all processes associated with the Compute Pool Manager. Failover of CPM processes occurs if the appliance is the primary management server or the primary policy server.

clearall: resets the compute appliance to factory default configuration. This command option causes the appliance to reboot and restart all processes. Running applicatons are terminated.

diagmode: turns off diagnostic mode enabled during diagnostic tasks. When diagnostic mode is detected, enter this command to remove the caution message displayed in CPM.

localauth: changes authentication search order to local first, then external. This command must be executed from the serial port of NP0 on the appliance currently hosting the primary instance of the CPM management server (MS).


Example 1-14 reset Command

admin@localhost# reset np0

This will reboot the Network Processor 0.


Example 1-15 reset clearall Command

admin@localhost# reset clearall

Warning: This will erase ALL configuration data. It also disables currentnetwork settings the next time this appliance is started. Re-configurationusing the Install command is required.Do you want to continue [y/n] y Resetting configuration is in progress.It will take several minutes. Please wait ...Factory default started: 2008-03-06_15:27:04Preparing package repository ...doneStopping system applications ....done



Resetting external auth config ...doneRemoving automounter ...doneRemoving network information system ...doneResetting miscellaneous configuration ....doneResetting program list ...doneRemoving any core dumps from system ...doneResetting virtual IP information ...doneResetting DHCP lease information ...doneResetting CPM domain configuration settings ...doneResetting CPM appliance configuration settings ...doneResetting NTP settings ...restarting NTP ...doneResetting kernel driver list ...doneResetting timezone ...doneResetting roles ...doneResetting CPM settings ...doneResetting ssh generated keys ....doneResetting ssh config ...doneResetting user data ...doneResetting hostname ...doneResetting mgmtsvcs ...doneResetting DNS configuration ...doneResetting IP configuration ...doneResetting host configuration ...doneResetting generated keys ...doneResetting development keys ...doneResetting syslog configuration ....doneResetting filesystem configuration ...donePreparing package repository ...doneResetting static routes ....Starting system services ...doneCompute appliance has been successfully reverted to factory defaults. Reset on local NP completed. Getting status from the remote NP. Please wait ...

Reset on remote NP completed with status SUCCESS

Example 1-16 reset diagmode Command

admin@localhost# reset diagmode

Do you want to continue [y/n] yadmin@localhost#

Example 1-17 reset localauth Command

admin@localhost# reset localauth

Authentication search order reset to 'local first'



Usage Guidelines

Use this command to reset the system software and network processor boards, without power cycling the compute appliance. All processes running on the specified system resource are restarted.

reset clearall is only to be used to reset the compute appliance to the factory default configuration. After performing this command, the configuration will be reset to factory defaults and the compute appliance will log you out. However, the compute appliance does retain some networking configuration data until the next reboot occurs.

admin@localhost#show interface mgmt Not configured data Link encap:Ethernet HWaddr 00:0F:51:FF:F1:5A inet addr:10.10.202.68 Bcast:10.255.255.255 Mask:255.255.255.0 inet6 addr: fe80::20f:51ff:feff:f15a/64 Scope:Link UP BROADCAST RUNNING MASTER MULTICAST MTU:1500 Metric:1 RX packets:18533 errors:0 dropped:0 overruns:0 frame:0 TX packets:9585 errors:0 dropped:0 overruns:0 carrier:0

collisions:0 txqueuelen:0 RX bytes:13604971 (12.9 MiB) TX bytes:1526241 (1.4 MiB)

If the compute appliance performs a reboot, connections to the appliance can only be made through the serial console until an install command is performed. Perform an install command to complete the process of resetting the compute appliance to factory defaults, removing the remaining networking configuration, and reconfiguring the appliance.

Refer to the Compute Pool Manager Guide for information on configuring the compute appliance.

Related Commands

See reboot on page 18.



set cpm

Syntaxset cpm <cpm_options>

Description

Allows the administrator to manually stop, start, disable, or enable CPM processes on a compute appliance.

Options

cpm_options: indicates which CPM option to use. Valid values are:

enable: configures CPM to run automatically each time the appliance starts up. If CPM processes are not already running, it does not start them. This command reconfigures CPM for normal use after it was disabled.

disable: configures the appliance to prevent CPM processes from starting when the appliance starts up. Running CPM processes are not stopped.

stop: stops currently running CPM processes, but leaves CPM configured to automatically restart the processes when the appliance restarts.

start: starts CPM processes stopped earlier. There may be a several minute delay as the CPM processes complete startup.


Example 1-18 set cpm enable Command

admin@localhost# set cpm enable

Activated CPM to run

admin@localhost#

Example 1-19 set cpm disable Command

admin@localhost#set cpm disable

Deactivated CPM to run

admin@localhost#

Example 1-20 set cpm start Command

admin@localhost#set cpm start

Starting CPM. Please wait ...

Successfully started CPM

admin@localhost#



Example 1-21 set cpm stop Command

admin@localhost#set cpm stop

Stopping CPM. Please wait ...

Successfully stopped CPM

admin@localhost#

Usage Guidelines

None

Related Commands

See show cpm on page 31.



set domain create

Syntaxset domain create <name> <MSVIP> <PSVIP>

Description

Initializes a new CPM domain and joins this compute appliance to the domain as the first appliance in the domain.

Options

name = (required) the name of the domain

MSVIP = (required) the virtual IP address used to access to all management functions PSVIP = (required) the virtual IP address used to access the CPM Policy Server

The following prompt displays:

"Enter new password for admin user:"

Enter a new strongly formatted admin user password. The following are strong password requirements:

must be a minimum of eight characters; a maximum of 16must be a combination of uppercase and lowercase letters, numbers, and any of the following symbols:! @ # $ % ^ & * ( ) [ ] { } < > ?must contain no spaces

The following prompt displays:"Confirm new password for admin user:"

Re-enter the new strong admin user password

Sample Command OutputExample 1-22 set domain create Command – Establish a New Domain Named cpm01admin@localhost#set domain create cpm01 10.10.214.70 10.10.214.71

Enter new password for admin user: ******** Confirm new password for admin user: ********

Creating domain configuration is in progress.It will take several minutes. Please wait ...

Setting new admin password completed successfully. Create domain completed successfully.Pre-register appliance completed successfully.Join appliance completed successfully.Info: Domain creation succeeded.

Related Commands

See set domain join on page 25, and set domain keys on page 26.

!CAUTION

Ensure that the domain name assigned is unique within this network.



set domain join

Syntaxset domain join {secure | insecure} <MSVIP>

Description

Joins a new compute appliance to an existing domain. The joining appliance must be configured, pre-registered, and have a valid license loaded into the domain.

Options

secure | insecure = (required) designation for how Certificate Authority information retrieval from the CPM domain is handled (default: none)

secure: requires a PEM-format trusted CA certificate for validation of the certificate presented by the CPM domain

insecure: accepts the CPM domain certificate without verification

When using a trusted CA certificate, in Secure mode do the following:

1. Use a browser to go to https://MSVIP/azul/downloadDomainCertificate.

After the page loads, a File Download - Security Warning dialog displays.

2. Click Save.

A Save As dialog displays.

3. Browse to a directory and save the CPM domain certificate file.

4. Open the certificate file in a text editor and copy the contents to the clipboard.

5. Paste the contents in the response dialog when prompted for the certificate.

6. Press Ctrl+D.

MSVIP = IP address for the Management Server VIP of the CPM domain

Enter the following at the prompts:

appliance shared key (required)

Enter the shared key password set during the set domain preregister command.


Example 1-23 set domain join Command

admin@localhost#set domain join insecure 10.10.214.70

Enter appliance shared key password : ******

Setting the domain parameters. Please wait... Join appliance to domain completed successfully.

Related Commands

See set domain preregister on page 27.


https://MSVIP/azul/downloadDomainCertificate


set domain keys

Syntaxset domain keys {add}

Description

Initializes a unique set of authentication keys for the newly created CPM domain. It is executed only on the first appliance used to create the new domain.

Options

add: Specifies to add new encryption keys to the domain


Example 1-24 set domain keys Command

admin@localhost#set domain keys add

Info: Starting domain internal key creation.Creating domain internal CA and certificate.Configuring domain.Info: Domain internal key creation succeeded.

Related Commands

See set domain create on page 24.



set domain preregister

Syntaxset domain preregister {secure | insecure} <MSVIP> <pool_name> <username> [appliance_name]

Description

Pre-registers a new appliance before adding it to an existing CPM domain. The appliance can also be pre-registered using the CPM browser-based GUI.

Options

secure | insecure = (required) designation for how Certificate Authority information retrieval from the CPM domain is handled (no default value)

secure: requires a PEM-format trusted CA certificate for validation of the certificate presented by the CPM domain

insecure: accepts the CPM domain certificate without verification

When using a trusted CA certificate, do the following in Secure mode:

1. Use a browser to go to https://MSVIP/azul/downloadDomainCertificate.

After the page loads, a File Download - Security Warning dialog displays.

2. Click Save.

A Save As dialog displays.

3. Browse to a directory and save the CPM domain certificate file.

4. Open the certificate file in a text editor and copy the contents to the clipboard.

5. Paste the contents in the response dialog when prompted for the certificate.

6. Press Ctrl+D.

MSVIP = (required) IP address for the Management Server VIP of the CPM domain

pool_name = (required; case sensitive) name of the pool in the existing domain to which to assign this appliance

username = (required) user ID of the user authorized to perform Domain Management activities within CPM

appliance_name (optional) = name of the appliance being registered in the CPM domain. If not specified, the current appliance name is used.


appliance shared key (required)

Enter a unique password to associate with the appliance. The required format is any combination of alpha and numeric characters, and the following symbols:

! @ # $ % ^ & * (,) _ + [ ] { } < > ? - .

Maximum length is 256 characters.

The password is used to verify the identity of the appliance added to the domain using the set domain join command.


https://MSVIP/azul/downloadDomainCertificate


admin user password (required)

Enter the password for the username specified in the command line options.


Example 1-25 set domain preregister Command – Pre-register the Appliance into the ‘Common’ Pool

Note that the appliance name defaults to the name of the appliance where this command is executed.

admin@localhost#set domain preregister insecure 10.10.214.70 Common admin

Enter appliance shared key password : ****** Enter admin user password : ********

Setting the domain parameters. Please wait... Pre-register appliance to domain completed successfully

Related Commands

See set domain join on page 25.



show auth

Syntaxshow auth

Description

Displays the configured authorization method for the compute appliance. Available settings are local database, external RADIUS server, or external LDAP server.

If an external RADIUS server or external LDAP server is configured, the IP address and port number of the server display.

Options

None


Example 1-26 show auth Command

admin@localhost# show auth

Authorization scheme: Local Db External Radius server: not configured External LDAP server: not configured

admin@localhost#

Related Commands

None



show clock

Syntaxshow clock

Description

Displays the compute appliance time and date for each network processor board.

Options

None


Example 1-27 show clock Command

admin@localhost# show clock

Clock information for NP-0

Current Time : Thu Dec 15 10:03:53 PDT 2005

Clock information for NP-1

Current Time : Thu Dec 15 10:04:09 PDT 2005

admin@localhost#

Related Commands

None



show cpm

Syntaxshow cpm

Description

Displays the configuration data for the compute pool domain, including the domain name, management virtual IP address (VIP), data VIP, and the status of CPM on the network processor boards.

If the management VIP (or policy VIP) is labeled as claimed, this indicates that the management VIP (or policy VIP) on this compute appliance is the primary management VIP (or policy VIP) for the domain. If labeled as not claimed, this indicates that the management VIP (or policy VIP) on this compute appliance is not the primary management VIP (or policy VIP) for the domain.

Options

None


Example 1-28 show cpm Command

admin@localhost# show cpm Domain Name : hwlab85 Management VIP : 10.10.214.68 (CLAIMED) Policy VIP : 10.10.214.69 (CLAIMED) CPM Status : on np0: enabled, on np1: disabledadmin@localhost#

Related Commands

None



show deconfig

Syntaxshow deconfig

Description

Displays a list of deconfigured components on the compute appliance.

Options

None


Example 1-29 show deconfig Command

admin@localhost# show deconfig

Entry: CC 1: 0: 99: G833551_00_0089_12012005000328Note: This indicates a deconfigured cache cluster 0 on Vega 1 Processor.

Entry: VE 2: 2: 99: G833551_00_0110_12012005004514

Note: This indicates a deconfigured Vega 2 Processor.

Entry: PA 3: 1234: 99: G833551_00_0107_12012005003925

Note: This indicates a deconfigured memory page (1 MB) at page 1234, with the source of the problem found on Vega 3 Processor.

Entry: TX 3: 8: 606: G83355.1_00_0107_12012005003925Note: This indicates a deconfigured Processor Core 3.

Entry: XL 2: 5: 405: G83355.1_00_0110_12012005004514Entry: XL 1: 1: 405: G83355.1_00_0089_12012005000328Note: These indicate deconfigured Xlinks 1 and 2.

admin@localhost#

Usage Guidelines

Refer to the notes in the example output for explanation of typical deconfiguration messages.

The value in the entry after “99”, “405” or “606” is the src_id value. The final string is chip_id, which is a combination of the lot, wafer, serial number, and date and time. This string verifies the validity of the entry against the installed hardware.

Related Commands

None



show dns

Syntaxshow dns

Description

Displays information about the DNS server currently configured for the domain.

Options

None


Example 1-30 show dns Command

admin@localhost#show dnsDomain: abc_company.comNameserver: 10.10.130.10Querying domain: abc_company.comNameservers in domain abc_company.com: delphi.abc_company.com wendell.abc_company.com chief-wiggums.abc_company.com bc001.abc_company.com marge.abc_company.comQuerying nameserver: 10.10.130.10Server 10.10.130.10 in domain abc_company.com has 1925 entries.

Related Commands

None



show env

Syntaxshow env <envtype>

Description

Displays information on compute appliance environmental conditions. Perform this command on initial boot up to verify correct system operation.

Options

envtype: The environmental information to display. Valid values are:

all

temperature

fan

power


Example 1-31 show env Command

admin@localhost# show env all FAN0 : Status OK Tachometer : 3612 2336 2431 2306 Temperature : 33.000 Voltages : v12 = 12.625, v3_3 = 3.298, vccp = 1.641 Modulation(PWM) : 0.338

FAN1 : Status OK Tachometer : 2481 2273 2462 2283 Temperature : 33.000 Voltages : v12 = 12.625, v3_3 = 3.298, vccp = 1.641 Modulation(PWM) : 0.348

FAN2 : Status OK Tachometer : 2554 2447 2589 2412 Temperature : 31.000 Voltages : v12 = 12.687, v3_3 = 3.298, vccp = 1.641 Modulation(PWM) : 0.343

PSU0 : Status OK, A/C OK Appliance supported A/C Range : 90-132 VAC Appliance measured A/C Range : 90-132 VAC

PSU1 : Status OK, A/C OK Appliance supported A/C Range : 90-132 VAC Appliance measured A/C Range : 90-132 VAC



PSU2 : Status NOT OK, A/C NOT OK Appliance supported A/C Range : 90-132 VAC Appliance measured A/C Range : 90-132 VAC

Network Processors

NP0 : board = 37.000, cpu = 30.000 NP1 : board = 36.000, cpu = 22.000

Application Processors

AP0 : board = 24.000 Processor Chip 0 : board = 26.000, cpu = 40.000 Processor Chip 1 : board = 31.000, cpu = 41.000



AP3 : board = 25.000

Processor Chip 0 : board = 27.000, cpu = 38.000 Processor Chip 1 : board = 31.000, cpu = 38.000

Fans FAN0 : board = 33.000 FAN1 : board = 33.000 FAN2 : board = 31.000

admin@localhost#

Related Commands

None



show hostname

Syntaxshow hostname

Description

Displays the name of the compute appliance, appended by the network processor board number.

Options

None


Example 1-32 show hostname Command

admin@localhost# show hostnameswx1008_0

admin@localhost#

Related Commands

None



show interface

Syntaxshow interface <ifname>

Description

Displays information about the specified interfaces or about all interfaces configured in the compute appliance. Interface information displays for both NP boards.

Options

ifname (optional): the interface information to display. If ifname is not specified, information about all the interfaces in the compute appliance displays. Valid values are:

mgmt: displays information about the 10/100 Ethernet management ports

data: displays information about the 10/100/1000 Gigabit Ethernet ports


Example 1-33 show interface Command

admin@localhost# show interface

Interface information for NP-0 mgmt Not configured

data Link encap:Ethernet HWaddr 00:0F:51:00:00:22 inet addr:10.10.212.64 Bcast:10.255.255.255 Mask:255.255.252.0 inet6 addr: fe80::20f:51ff:fe00:22/64 Scope:Link UP BROADCAST RUNNING MASTER MULTICAST MTU:1500 Metric:1 RX packets:846165 errors:0 dropped:0 overruns:0 frame:0 TX packets:462494 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:0 RX bytes:716075856 (682.9 MiB) TX bytes:156944827 (149.6 MiB)

Interface information for NP-1 mgmt Not configured

data Link encap:Ethernet HWaddr 00:0F:51:00:01:26 inet addr:10.10.212.65 Bcast:10.255.255.255 Mask:255.255.252.0 inet6 addr: fe80::20f:51ff:fe00:126/64 Scope:Link UP BROADCAST RUNNING MASTER MULTICAST MTU:1500 Metric:1 RX packets:356160 errors:0 dropped:0 overruns:0 frame:0 TX packets:52208 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:0 RX bytes:354940088 (338.4 MiB) TX bytes:6793907 (6.4 MiB) admin@localhost#

Related Commands

None



show ntp

Syntaxshow ntp

Description

Displays information about the configured Network Time Protocol (NTP) server(s). This information includes the primary NTP server, the secondary NTP server (if configured), and the address for the local clock (127.127.1.0).

Options

None


Example 1-34 show ntp Command

admin@localhost# show ntpNTP information for NP-0Host(10.10.200.127) specified is reachableSystem Time :Mon Sep 12 15:28:29 PDT 2005Hardware Clock :Mon Sep 2 15:28:29 2005 -0.016849 seconds

remote refid st t when poll reach delay offset jitter========================================================================10.10.200.127 10.10.130.10 3 u 43 64 17 0.185 15.691 14.89510.10.130.10 192.12.19.20 2 u 35 64 17 0.305 29.876 15.702127.127.1.0 LOCAL(0) 13 l 35 64 17 0.000 0.000 0.001

NTP information for NP-1Host(10.10.200.127) specified is reachableSystem Time :Mon Sep 12 15:28:29 PDT 2005Hardware Clock :Mon Sep 2 15:28:29 2005 -0.016849 seconds

remote refid st t when poll reach delay offset jitter========================================================================10.10.200.127 10.10.130.10 3 u 43 64 17 0.185 15.691 14.89510.10.130.10 192.12.19.20 2 u 35 64 17 0.305 29.876 15.702127.127.1.0 LOCAL(0) 13 l 35 64 17 0.000 0.000 0.001

admin@localhost#

Related Commands

None



show route

Syntaxshow route

Description

Displays the IP routing table entries.

Options

None


Example 1-35 show route Command

admin@localhost# show routeKernel IP routing table for NP-0

Kernel IP routing table for NP-1

admin@localhost#

Related Commands

See show hostname on page 36.

Destination Gateway Genmask Flags Metric Ref Use Iface10.10.130.0 * 255.255.255.0 U 0 0 0 eth0127.0.0.0 * 255.0.0.0 U 0 0 0 eth0default 10.10.130.1 0.0.0.0 UG 0 0 0 eth0

Destination Gateway Genmask Flags Metric Ref Use Iface10.10.130.0 * 255.255.255.0 U 0 0 0 eth0127.0.0.0 * 255.0.0.0 U 0 0 0 lodefault 10.10.130.1 0.0.0.0 UG 0 0 0 eth0



show snmp

Syntaxshow snmp

Description

Displays the Simple Network Management Protocol (SNMP) agent configuration. Up to three SNMP managers can be configured in CPM.

Options

None


Example 1-36 show snmp Command

admin@localhost# show snmp

Community String: publicLocation: Mountain View, CA, USContact: John Smith

Trap Configuration Id Version Host 1 1 192.33.51.13 2 2c 142.113.32.121 3 1 192.33.56.1

Related Commands

None



show status

Syntaxshow status {reset|install|upgrade}

Description

Displays a record of the command output since the last reset, install or upgrade sofware command was performed. This allows a review of command execution.

Options

None


Example 1-37 show status reset Command

admin@localhost#show status reset Reset Status for NP-0

Preparing package repository ...donePreparing system applications ....doneResetting database ...ps from system ...doneResetting virtual IP information ...doneResetting DHCP lease information ...doneResetting CPM domain configuration settings ...doneResetting CPM appliance configuration settings ...doneResetting NTP settings ...doneResetting kernel driver list ...doneResetting timezone ...doneResetting roles ...doneResetting CPM settings ...doneResetting ssh config ...doneResetting user data ....doneResetting hostname ...doneResetting DNS configuration ...doneResetting IP configuration ...doneResetting host configuration ...doneResetting generated keys ...doneResetting development keys ...doneResetting system log configuration ...doneResetting filesystem configuration ...doneCompute appliance has been successfully reset to factory defaults.Reset completed.

Reset Status for NP-1

Preparing package repository ...donePreparing system applications ....done



Resetting database ...ps from system ...doneResetting virtual IP information ...doneResetting DHCP lease information ...doneResetting CPM domain configuration settings ...doneResetting CPM appliance configuration settings ...doneResetting NTP settings ...doneResetting kernel driver list ...doneResetting timezone ...doneResetting roles ...doneResetting CPM settings ...doneResetting ssh config ...doneResetting user data ....doneResetting hostname ...doneResetting DNS configuration ...doneResetting IP configuration ...doneResetting host configuration ...doneResetting generated keys ...doneResetting development keys ...doneResetting system log configuration ...doneResetting filesystem configuration ...doneCompute appliance has been successfully reset to factory defaults.Reset completed.

Example 1-38 show status install Command

admin@localhost#show status install Installation Report for NP-0Appliance install begin : Thu Sep 15 09:24:35 PDT 2005

Installation Report for NP-1

Install begin Wed Sep 14 03:50:48 PDT 2005 Installing Configuration for slot 0 Preparing network interface file Updating configuration properties file for slot 0 Installing Configuration for slot 1 Preparing network interface file Bring down the interface and up again Updating configuration properties file for slot 1

Setting backend to reset Wed Sep 14 03:50:49 PDT 2005Appliance install end, restarting the system

Example 1-39 show status upgrade Command

admin@localhost#show status upgrade Upgrade Report for NP-0Thu Sep 15 02:50:24 PDT 2005



Current version of the cpm software = 0.0.0.0-636Current version of the avx software = 0.0.0.0-636Upgrading software ALL on appliance to 0.0.0.0-636Getting image from 10.10.200.102 using shilpak path = /home/buildmaster/nightly/main-dev/in_progress/main-dev-636/sandbox/azul_repository/, file = avx-distrib_0.0.0.0-636.tar.gzTransferring new AVX/CPM software image ...WGET_RETURN_CODE 0Getting software completedMD5_CHECK_RETURN_CODE 0Verfied MD5 ChecksumDecompressing AVX/CPM software image ...Installing AVX/CPM software ...Installing AVX/CPM software completedSoftware update completed successfullyChecking whether to reboot the systemRebooting system is requiredRebooting the systemThu Sep 15 02:56:01 PDT 2005

Upgrade Report for NP-1Thu Sep 15 02:50:20 PDT 2005Current version of the cpm software = 0.0.0.0-636Current version of the avx software = 0.0.0.0-636Upgrading software ALL on appliance to 0.0.0.0-636Getting image from 10.10.200.102 using shilpak path = /home/buildmaster/nightly/main-dev/in_progress/main-dev-636/sandbox/azul_repository/, file = avx-distrib_0.0.0.0-636.tar.gzTransferring new AVX/CPM software image ...WGET_RETURN_CODE 0Getting software completedMD5_CHECK_RETURN_CODE 0Verfied MD5 ChecksumDecompressing AVX/CPM software image ...Installing AVX/CPM software ...Installing AVX/CPM software completedSoftware update completed successfullyChecking whether to reboot the systemRebooting system is requiredRebooting the systemThu Sep 15 02:54:54 PDT 2005

Usage Guidelines

Perform this command following a reset, install, or upgrade software command to ensure that the command executed properly.

Related Commands

See install on page 5, reset on page 19, and upgrade software on page 50.



show syslog

Syntaxshow syslog

Description

Displays the configured Syslog server IP address and indicates whether the Syslog server is reachable.

Options

None


Example 1-40 show syslog Command

admin@localhost# show syslogSyslog information for NP-0Host (10.10.130.10) specified is reachable

Syslog information for NP-1Host (10.10.130.10) specified is reachable

admin@localhost#

Related Commands

None



show system

Syntaxshow system

Description

Displays information about the compute appliance host name, MAC address, management, and IP addresses for both NP boards.

Options

None


Example 1-41 show system Command

admin@localhost#show system

Appliance Name : qa0801 Model Number : 1920B Installed Processor cores : 192Operational Processor cores : 192Committable Processor cores : 96 Next Boot Processor cores : 192 Operational Memory In GB : 64 Committable Memory In GB : 55 Next Boot Memory In GB : 64

Mgmt Network Type : Out-of-Band Management Mgmt IP Address Assignment : DHCP Data IP Address Assignment : Manual/Static NTP Server : 10.10.130.10 Syslog host : 10.10.200.189 System time : Sat Nov 18 18:47:30 PST 2006

Network Processor 0 (Primary) Hostname : qa0801_0 MAC Address : 00:0F:51:00:03:88 Mgmt Address : 10.10.202.252 Netmask : 255.255.255.0 Gateway : 10.10.202.1 Data Address : 10.10.212.60 Netmask : 255.255.252.0 Gateway : 10.10.212.1 NTP Server : 10.10.130.10 Syslog host : 10.10.200.189

Network Processor 1 Hostname : qa0801_1 MAC Address : 00:0F:51:00:06:70 Mgmt Address : 10.10.202.254 Netmask : 255.255.255.0 Gateway : 10.10.202.1 Data Address : 10.10.212.61



Netmask : 255.255.252.0 Gateway : 10.10.212.1 NTP Server : 10.10.130.10 Syslog host : 10.10.200.189

Compute Pool Manager Information Domain Name : qa0801only Management VIP : 10.10.202.164 (CLAIMED) Policy VIP : 10.10.214.61 (CLAIMED) CPM Status : on NP0: enabled, on NP1: disabled

admin@localhost#

Example 1-42 show system Command with 10G NICs

admin@localhost#show systemNetwork Processor 0 (Primary) Hostname : qa0404_0 MAC Address : 00:0F:51:00:08:0C Mgmt Address : 10.10.212.68 Netmask : 255.255.252.0 Gateway : 10.10.212.1Network Adapter 0 Data Address : 192.168.202.68 Netmask : 255.255.255.0 Gateway : 192.168.202.1

Network Processor 1 Hostname : qa0404_1 MAC Address : 00:0F:51:00:08:04 Mgmt Address : 10.10.212.69 Netmask : 255.255.252.0 Gateway : 10.10.212.1Network Adapter 1 Data Address : 192.168.202.69 Netmask : 255.255.255.0 Gateway : 192.168.202.1

Compute Pool Manager Information Domain Name : ha Management VIP : 10.10.214.64 (NOT CLAIMED) Policy VIP : 192.168.202.70 (NOT CLAIMED) CPM Status : on NP0: enabled, on NP1: disabled



Example 1-43 show system Command—1G Interface, No NICs

admin@localhost#show system

Appliance Name : hwlab66 Model Number : 1920B Serial Number : 0104-0093-CM2-00 Installed Processor cores : 192Operational Processor cores : 192Committable Processor cores : 96 Next Boot Processor cores : 192 Operational Memory In GB : 64 Committable Memory In GB : 55 Next Boot Memory In GB : 64

Mgmt Network Type : In-Band Management IP Address Assignment : Manual/Static NTP Server : Syslog host : System time : Wed Feb 13 15:45:02 PST 2008 System uptime : 01:35:45

Network Processor 0 Hostname : hwlab66_0 MAC Address : 00:0F:51:00:00:B0 Mgmt/Data Address : 10.10.202.66 Netmask : 255.255.255.0 Gateway : 10.10.202.1

Network Processor 1 (Primary) Hostname : hwlab66_1 MAC Address : 00:0F:51:FF:F1:4C Mgmt/Data Address : 10.10.202.67 Netmask : 255.255.255.0 Gateway : 10.10.202.1

Compute Pool Manager Information Domain Name : none Management VIP : N/A Policy VIP : N/A CPM Status : on NP0: enabled, on NP1: disabled

Related Commands

See show version on page 49.



show useraccounts

Syntaxshow useraccounts

Description

Displays a list of configured user accounts.

Options

None


Example 1-44 show useraccounts Command

admin@localhost# show useraccounts

User Name : User Type

admin : Administrator

admin@localhost#

Related Commands

None



show version

Syntaxshow version

Description

Displays the AVX system software, CPM, and failsafe software versions on the compute appliance. The failsafe version refers to the failsafe kernal that boots the compute appliance in the event of an unsuccessful software upgrade.

Options

None


Example 1-45 show version Command

admin@localhost# show versionVersion information for NP-0

AVX : 2.2.0.0-62 CPM : 2.2.0.0-62 FAILSAFE : 2.6.7az1-main-dev-330

Version information for NP-1

AVX : 2.2.0.0-62 CPM : 2.2.0.0-62 FAILSAFE : 2.6.7az1-main-dev-330

Related Commands

See upgrade software on page 50.



upgrade software

Syntaxupgrade software <upgrade_method>

Description

Performs an upgrade of the compute appliance software using File Transfer Protocol (FTP) or Hypertext Transfer Protocol (HTTP).

Prompts display requesting the IP address of the FTP/HTTP repository host, the FTP or HTTP user name and password, the path where the upgrade package package files are stored, and the names of the upgrade package(s) to use.

When performing a simultaneous AVX and CPM upgrade, enter the names of the two upgrade packages separated by a comma. The versions of AVX and CPM software contained within the two specified packages must be compatible.

The specified repository host (FTP/HTTP server address) must be an IP address and not a host name.

Options

upgrade_method: The method for performing the software upgrade. The following are valid values:

ftp: Performs a software upgrade using FTP on both NP boards

http: Performs the software upgrade using HTTP on both NP boards


repository host: IP address of the file storage host

user name: User ID for the FTP or HTTP server

password: User password for the FTP or HTTP server

path: Path to the upgrade package files

Software package(s): Name of AVX and/or CPM upgrade package files


Example 1-46 upgrade software Command

user@appliance_name# upgrade software ftp

repository host: 10.10.200.102user name: adminpassword: *********path: /azul/upgradesSoftware package(s): cpm_2.4.0.0-13,avx_2.4.0.0-11

You have enteredrepository host: 10.10.200.102



user: adminpassword: *********path: /azul/upgradesSoftware package(s): cpm_2.4.0.0-13,avx_2.4.0.0-11


Related Commands

See show version on page 49.



upload

Syntaxupload <filetype> <transfer mechanism>

Description

Performs a transfer of log or core files from the compute appliance to a server using FTP. The target host, path, version, user, and password prompts display. When prompted for the target host, enter an IP address, and not a host name.

Options

filetype: the type of file to transfer. Valid values are:

logs: log files

cores: core dump files

transfer mechanism: The method of transferring the files. Valid values are:

ftp: File Transfer Protocol


Example 1-47 upload cores ftp Command

admin@localhost#upload cores ftp

target host: 10.10.200.127target path: /home/appliance16user name: appliance16password: ******

You have entered

target host: 10.10.200.127target path: /home/appliance16user: appliance16password: ******Do you want to continue [y/n] y

Uploading cores. Please wait. Uploading cores completed.

admin@localhost#

Example 1-48 upload logs ftp Command

admin@localhost#upload logs ftp

target host: 10.10.200.127target path: /home/appliance16



user name: appliance16password: ******

You have entered target host: 10.10.200.127target path: /home/appliance16user: appliance16password: ******Do you want to continue [y/n] y

Uploading logs. Please wait. Uploading logs completed.

admin@localhost#

Related Commands

None



Command SummaryTable 1-3 summarizes all compute appliance CLI commands:

Table 1-3 CLI Commands

Command Description

history Displays recently executed CLI commands.

install Runs the install wizard to guide you through required system parameter configuration.

ping Sends a ping request to the destination node and reports the result.

quit Logs out from the command line interface.

reboot Reboots the compute appliance.

resetreset clearall

Resets the system, including the system software and network processor boards, or resets the compute appliance to factory default configuration.

reset diagmode Turns off ‘diagnostic mode’ that may have been left on after Azul personnel were performing diagnostic tasks. Clears the caution message that is displayed in CPM when diagnostic mode is detected.

set cpm Allows the administrator to manually stop, start, disable, or enable CPM processes on a compute appliance.

set domain create Initializes a new CPM domain and joins this compute appliance to the domain as the first appliance in the domain.

set domain join Joins a new compute appliance to an existing domain.

set domain keys Initializes a unique set of authentication keys for the newly created CPM domain. It is executed only on the first appliance that was used to create the new domain.

set domain preregister Pre-registers a new appliance prior to adding it to an existing CPM domain.

show auth Displays the type of authorization scheme configured on the compute appliance: internal or external (RADIUS or LDAP user authentication).

show clock Displays the compute appliance time and date, and information about the NTP server, if configured.

show cpm Displays the compute pool domain configuration settings.

show deconfig Displays the list of deconfigured components on the compute appliance.

show dns Displays information about the DNS server currently configured for the domain.

show env Displays information on compute appliance environmental conditions.

show hostname Displays the compute appliance host name.

show interface Displays information about the compute appliance interfaces.

show ntp Displays information about the configured Network Time Protocol (NTP) server.

show route Displays the IP routing table entries.

show snmp Displays the SNMP agent configuration.

show status Displays a record of the command output since the last time a reset, install, or upgrade software command was performed.

show syslog Displays the configured Syslog server IP address and indicates if the Syslog server is available.

show system Displays the compute appliance hostname, MAC address, management type, and IP addresses.

show useraccounts Displays the list of configured CLI users.

show version Displays the version of the system software and available versions of software for upgrade.

upgrade software Performs a software upgrade on the compute appliance.

upload Performs a transfer of log or core files from the compute appliance to a server using FTP.


Notes





Index

Numerics10G NICs

install 14show system 46

1G interface show system 47

Aaccounts 48authentication keys 26, 27authorization method 29AVX version 49

CCLI commands

history 4install 5install for 10G NICs 14ping 16quit 17reboot 18reset 19reset_type option 19set cpm 22set domain create 24set domain join 25set domain keys 26set domain preregister 27show auth 29show clock 30show cpm 31show deconfig 32show dns 33show env 34show hostname 36show interface 37show ntp 38show route 39show snmp 40show status 41

show syslog 44show system 45show system for 10G NICs 46show system for 1G interface 47show useraccounts 48show version 49summary of 54upgrade software 50upload 52

clock local 38command execution 41command line interface (CLI) 1

case sensitivity 1display all commands for current session 4end session 17error messages 2help in 2serial console 3sessions 3special keys 1SSH client 3summary of commands 54tips 2

compute appliancesauthorization method 29clock display 30deconfigured components 32environment condition display 34environmental conditions 34failsafe software 49host name 36, 45initializing 5IP address 45joining to domain 25MAC address 45reboot command 18register in the domain 27software upgrade 50

compute pool 31


core files 52CPM status 31CPM version 49

Ddata port 37data VIP 31DNS server 33domain 31domain initialization 24

Eerror messages

command line interface 2Ffailsafe software version 49

Hhost name 45

IICMP echo requests and replies 16initializing compute appliances 5installation wizard 5IP address 45

pinging 16validation 5

IP routing table 39

Llog files 52

MMAC address 45management port 37management VIP address 31

Nnetwork processor boards

number 36port configuration, displaying 37

Network Time Protocol (NTP) server 38

Pports

data 37displaying configuration of 37management 37

RRADIUS server 29rebooting compute appliances 18

SSimple Network Management Protocol (SNMP)agent configuration 40software upgrades 50syslog server 44system software

resetting 19

Uupgrading software 50user accounts 48



Notes

1600 Plymouth Street, Mountain View, CA 94043 | T 650.230.6500 | F 650.230.6600 | www.azulsystems.com

Copyright © 2005–2008, Azul Systems, Inc. All rights reserved. Azul Systems, Azul, the Azul arch logo, unbound compute, and Vega are trademarks of Azul Systems Inc. in the United States and other countries. Linux is a registered trademark of Linus Torvalds. RedHat is the property of Red Hat, Inc. Sun, Sun Microsystems, Solaris, J2EE, J2SE, Java and all Java based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. Microsoft and Windows are registered trademarks of Microsoft Corporation in the United States and/or other countries. Other marks are the property of their respective owners and are used here only for identification purposes. Products and specifications discussed in this document may reflect future versions and are subject to change by Azul Systems without notice.

ABOUT AZUL SYSTEMS

Azul Systems has pioneered the industry’s first network attached processing solution

designed to enable unbound compute™ resources for Java and J2EE based enterprise

applications. Azul Compute Appliances eliminate capacity planning at the application

level and much of the cost and complexity associated with the conventional delivery of

computing resources. More information about Azul Systems can be found at

www.azulsystems.com.

Date post:	21-Sep-2020
Category:	Documents
Upload:	others
View:	4 times
Download:	0 times

Azul Command Line Interface Guidestaff.ii.pw.edu.pl/azul/Azul_Command_Line... · About This Guide...

Documents