Azul Command Line Interface Guidestaff.ii.pw.edu.pl/azul/Azul_Command_Line... · About This Guide...
Embed Size (px)
Transcript of 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

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]
http://support.azulsystems.com
Azul Command Line Interface Guide, Version 6 | ix

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

Command Line Interface Reference
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).
Azul Command Line Interface Guide, Version 6 | 3

Command Line Interface Reference
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.
4 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
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
Sample Command Output
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
Azul Command Line Interface Guide, Version 6 | 5

Command Line Interface Reference
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 :
6 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
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.
Azul Command Line Interface Guide, Version 6 | 7

Command Line Interface Reference
Example 1-4 install Command – In-band, DHCP Address Assignment
admin@localhost#install
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]
8 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
Example 1-5 install Command – Out-of-band, DHCP for Management, DHCP for Data
admin@localhost#install
Appliance Name : qa1605
Appliance Management network type :
1) In-Band 2) Out-of-Band
Select : [1] 2
Mgmt IP Address Assignment Setup
1) DHCP 2) Manual/Static
Select : [1]
Data IP Address Assignment Setup
1) DHCP 2) Manual/Static
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
Do you want to continue [y/n]
Azul Command Line Interface Guide, Version 6 | 9

Command Line Interface Reference
Example 1-6 install Command – Out-of-band, DHCP for Management, Static for Data
admin@localhost#install
Appliance Name : qa1605
Appliance Management network type :
1) In-Band 2) Out-of-Band
Select : [1] 2
Mgmt IP Address Assignment Setup
1) DHCP 2) Manual/Static
Select : [1]
Data IP Address Assignment Setup
1) DHCP 2) Manual/Static
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
10 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
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
link status : Port 0 up, Port 1 up
Do you want to continue [y/n]
Example 1-7 install Command – Out-of-band, Static for Management, DHCP for Data
admin@localhost#install
Appliance Name : qa1605
Appliance Management network type :
1) In-Band 2) Out-of-Band
Select : [1] 2Mgmt IP Address Assignment Setup
1) DHCP 2) Manual/Static
Select : [1] 2
Data IP Address Assignment Setup
1) DHCP 2) Manual/Static
Select : [1]
Azul Command Line Interface Guide, Version 6 | 11

Command Line Interface Reference
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
For Network Processor 1 hostname : qa1605_1 10/100 Ethernet Mgmt IP address : 10.10.212.59 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
Do you want to continue [y/n]
Example 1-8 install Command – Out-of-band, Static for Management, Static for Data
admin@localhost#install
Appliance Name : qa1605
Appliance Management network type :
1) In-Band 2) Out-of-Band
Select : [1] 2
12 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
Mgmt IP Address Assignment Setup
1) DHCP 2) Manual/Static
Select : [1] 2
Data IP Address Assignment Setup
1) DHCP 2) Manual/Static
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
For Network Processor 0 hostname : qa1605_0 10/100 Ethernet Mgmt IP address : 10.10.202.45 netmask : 255.255.255.0 gateway : 10.10.202.1 link status : Port 0 up
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
Azul Command Line Interface Guide, Version 6 | 13

Command Line Interface Reference
For Network Processor 1 hostname : qa1605_1 10/100 Ethernet Mgmt IP address : 10.10.202.46 netmask : 255.255.255.0 gateway : 10.10.202.1 link status : Port 0 up
GbEthernet Data IP address : 10.10.212.59 netmask : 255.255.252.0 gateway : 10.10.212.1
link status : Port 0 up, Port 1 up
Do you want to continue [y/n]
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
Mgmt IP Address Assignment Setup
1) DHCP 2) Manual/Static
Select : [1] 2
Data IP Address Assignment Setup
1) DHCP 2) Manual/Static
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
14 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
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.
Azul Command Line Interface Guide, Version 6 | 15

Command Line Interface Reference
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.
Sample Command Output
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.
16 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
quit
Syntaxquit
Description
Ends the CLI session. This command does not affect the operation of the compute appliance.
Options
None
Sample Command Output
Example 1-12 quit Command
admin@localhost# quitConnection closed by foreign host.
Usage Guidelines
None
Related Commands
None
Azul Command Line Interface Guide, Version 6 | 17

Command Line Interface Reference
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
Sample Command Output
Example 1-13 reboot Command
admin@localhost# reboot
This will reboot both Network Processors.
Do you want to continue [y/n] y
Usage Guidelines
Use this command when the compute appliance must be rebooted and power cycled.
Related Commands
See reset on page 19.
18 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
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).
Sample Command Output
Example 1-14 reset Command
admin@localhost# reset np0
This will reboot the Network Processor 0.
Do you want to continue [y/n] y
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
Azul Command Line Interface Guide, Version 6 | 19

Command Line Interface Reference
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'
20 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
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.
Azul Command Line Interface Guide, Version 6 | 21

Command Line Interface Reference
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.
Sample Command Output
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#
22 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
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.
Azul Command Line Interface Guide, Version 6 | 23

Command Line Interface Reference
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.
24 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
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.
Sample Command Output
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.
Azul Command Line Interface Guide, Version 6 | 25

Command Line Interface Reference
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
Sample Command Output
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.
26 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
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.
Enter the following at the prompts:
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.
Azul Command Line Interface Guide, Version 6 | 27

Command Line Interface Reference
admin user password (required)
Enter the password for the username specified in the command line options.
Sample Command Output
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.
28 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
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
Sample Command Output
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
Azul Command Line Interface Guide, Version 6 | 29

Command Line Interface Reference
show clock
Syntaxshow clock
Description
Displays the compute appliance time and date for each network processor board.
Options
None
Sample Command Output
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
30 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
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
Sample Command Output
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
Azul Command Line Interface Guide, Version 6 | 31

Command Line Interface Reference
show deconfig
Syntaxshow deconfig
Description
Displays a list of deconfigured components on the compute appliance.
Options
None
Sample Command Output
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
32 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
show dns
Syntaxshow dns
Description
Displays information about the DNS server currently configured for the domain.
Options
None
Sample Command Output
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
Azul Command Line Interface Guide, Version 6 | 33

Command Line Interface Reference
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
Sample Command Output
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
34 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
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
AP1 : board = 25.000 Processor Chip 0 : board = 27.000, cpu = 38.000 Processor Chip 1 : board = 31.000, cpu = 39.000
AP2 : board = 27.000 Processor Chip 0 : board = 28.000, cpu = 38.000 Processor Chip 1 : board = 33.000, cpu = 39.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
Azul Command Line Interface Guide, Version 6 | 35

Command Line Interface Reference
show hostname
Syntaxshow hostname
Description
Displays the name of the compute appliance, appended by the network processor board number.
Options
None
Sample Command Output
Example 1-32 show hostname Command
admin@localhost# show hostnameswx1008_0
admin@localhost#
Related Commands
None
36 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
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
Sample Command Output
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
Azul Command Line Interface Guide, Version 6 | 37

Command Line Interface Reference
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
Sample Command Output
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
38 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
show route
Syntaxshow route
Description
Displays the IP routing table entries.
Options
None
Sample Command Output
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
Azul Command Line Interface Guide, Version 6 | 39

Command Line Interface Reference
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
Sample Command Output
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
40 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
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
Sample Command Output
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
Azul Command Line Interface Guide, Version 6 | 41

Command Line Interface Reference
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
42 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
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.
Azul Command Line Interface Guide, Version 6 | 43

Command Line Interface Reference
show syslog
Syntaxshow syslog
Description
Displays the configured Syslog server IP address and indicates whether the Syslog server is reachable.
Options
None
Sample Command Output
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
44 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
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
Sample Command Output
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
Azul Command Line Interface Guide, Version 6 | 45

Command Line Interface Reference
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
46 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
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.
Azul Command Line Interface Guide, Version 6 | 47

Command Line Interface Reference
show useraccounts
Syntaxshow useraccounts
Description
Displays a list of configured user accounts.
Options
None
Sample Command Output
Example 1-44 show useraccounts Command
admin@localhost# show useraccounts
User Name : User Type
admin : Administrator
admin@localhost#
Related Commands
None
48 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
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
Sample Command Output
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.
Azul Command Line Interface Guide, Version 6 | 49

Command Line Interface Reference
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
Enter the following at the prompts:
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
Sample Command Output
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
50 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
user: adminpassword: *********path: /azul/upgradesSoftware package(s): cpm_2.4.0.0-13,avx_2.4.0.0-11
Do you want to continue [y/n] y
Related Commands
See show version on page 49.
Azul Command Line Interface Guide, Version 6 | 51

Command Line Interface Reference
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
Sample Command Output
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
52 | Azul Command Line Interface Guide, Version 6

Command Line Interface Reference
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
Azul Command Line Interface Guide, Version 6 | 53

Command Line Interface Reference
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.
54 | Azul Command Line Interface Guide, Version 6

Notes
55 | Azul Command Line Interface Guide, Version 6
Command Line Interface Reference

Command Line Interface Reference
56 | Azul Command Line Interface Guide, Version 6

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
Azul Command Line Interface Guide, Version 6 | 57

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
58 | Azul Command Line Interface Guide, Version 6

Azul Command Line Interface Guide, Version 6 | 59
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.