A P P E N D I X A |
Command-Line Interface Reference |
This appendix contains the following sections:
This appendix contains the most common embedded lights out manager commands used to administer your Sun server from the command-line interface (CLI).
Text that you type into the computer. Type it in exactly as shown. |
||
Text separated by a vertical bar represents the only available values. Select one. |
show -display [targets|properties|all]
|
Change network properties for the ELOM. Changing certain network properties, like the IP address, will disconnect your active session. |
|
This section provides reference information about the CLI commands.
Use the cd command to navigate the namespace. When you cd to a target location, that location then becomes the default target for all other commands.
Using the - default option with no target returns you to the top of the namespace. Entering just cd displays your current location in the namespace. Entering help targets displays a list of all targets in the entire namespace.
[-d|default] [-e|examine] [-h|help]
Any location in the namespace.
To create a user named sally, cd to /SP/User, then execute the create command with /SP/User as the default target.
To find your location, enter cd.
Use the create command to set up an object in the namespace. Unless you specify properties with the create command, they are empty.
create [options] target [propertyname=value]
[-d|default] [-e|examine] [-h|help]
-> create /SP/User/susan role=administrator
Use the delete command to remove an object from the namespace. You will be prompted to confirm a delete command.
Eliminate this prompt by using the -script option.
delete [options] [-script] target
[-x|examine] [-f|force] [-h|help] [-script]
-> delete /SP/AgentInfo/SNMP/users/john
Use the exit command to terminate a session to the CLI.
Use the help command to display Help information about commands and targets. Using the -output terse option displays usage information only. The -output verbose option displays usage, description, and additional information including examples of command usage. If you do not use the -output option, usage information and a brief description of the command are displayed.
Specifying command targets displays a complete list of valid targets for that command from the fixed targets in /SP. Fixed targets are targets that cannot be created by a user.
Specifying command targets legal displays copyright information and product use rights.
help [options] command [targets ]
[-x|examine] [-h|help] [-output terse|verbose]
cd, create, delete, exit, help, load, reset, set, show, start, stop, version
The load command is used to transfer a file from a server to a target.
Usage: load -source URL [target]
-source : specific the location to get a file
The reset command is used to reset a target.
Usage: reset [-script] [target]
Available options for this command:
-script : do not prompt for yes/no confirmation and act as if yes was specified..
Use the set command to specify the properties of the target.
set [options] [-default] target [propertyname=value]
-> set /SP/User/susan Permission=administrator
Use the show command to display information about targets and properties.
Using the -display option determines the type of information shown. If you specify -display targets, then all targets in the namespace below the current target are shown. If you specify -display properties, all property names and values for the target are shown. With this option you can specify certain property names, and only those values are shown. If you specify -display all, all targets in the namespace below the current target are shown, and the properties of the specified target are shown. If you do not specify a -display option, the show command acts as if -display all were specified.
The -level option controls the depth of the show command, and it applies to all modes of the -display option. Specifying -level 1 displays the level of the namespace where the object exists. Values greater than 1 return information for the target's current level in the namespace and the <specified value> levels below. If the argument is -level all, it applies to the current level in the namespace and everything below.
show [options] [-display targets|properties|all] [-level value|all] target propertyname
[-d|-display] [-e|examine] [-l|level]
show -display properties /SP/User/susan
/SP/User/susan Targets: Properties: Status=enable Permission= Administrator Password=(Cannot show property) |
Use the start command to turn on the target or to initiate a connection to the host console.
[-x|examine] [-h|help] [-state]
Use the stop command to shut down the target or to terminate another user's connection to the host console. You will be prompted to confirm a stop command. Eliminate this prompt by using the -script option.
stop [options] [-script] target
Use the version command to display the ELOM version information.
Copyright © 2009 Sun Microsystems, Inc. All rights reserved.