SPARC® Enterprise M4000/M5000/M8000/M9000 Servers XSCF Reference Manual XSCF Control Package (XCP) 104x Manual Code C120-E333-03EN Part No.
Copyright 2007 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. and FUJITSU LIMITED, 1-1, Kamikodanaka 4-chome, Nakahara-ku, Kawasaki-shi, Kanagawa-ken 211-8588, Japan. All rights reserved. Sun Microsystems, Inc.
Copyright 2007 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. et FUJITSU LIMITED, 1-1, Kamikodanaka 4chome, Nakahara-ku, Kawasaki-shi, Kanagawa-ken 211-8588, Japon. Tous droits réservés. Sun Microsystems, Inc. et Fujitsu Limited détiennent et contrôlent toutes deux des droits de propriété intellectuelle relatifs aux produits et technologies décrits dans ce document.
Contents Preface Intro ix 1 addboard 7 addcodlicense addfru 11 13 adduser 15 applynetwork cfgdevice 21 clockboard console 17 27 29 deleteboard 31 deletecodlicense deletefru 37 deleteuser 39 disableuser 41 enableuser 43 exit 45 flashupdate fmadm 47 51 fmdump fmstat 53 61 ioxadm man 35 65 75 v
moveboard 77 nslookup 81 password 83 poweroff 87 poweron 91 prtfru 95 rebootxscf 99 replacefru 101 reset 103 resetdateoffset 107 sendbreak 109 setaltitude 111 setarchiving setaudit 113 117 setautologout setcod 125 setdate setdcl 123 127 131 setdomainmode setdomparam setdscp 137 141 143 setdualpowerfeed setemailreport sethostname 149 153 sethttps 155 setldap 159 setlocale 163 setlocator 165 setlookup 167 setnameserver setnetwork setntp 169 171 175 setpasswor
setprivileges setroute 185 189 setshutdowndelay setsmtp 195 setsnmp 199 setsnmpusm 205 setsnmpvacm setssh 193 209 213 settelnet 219 settimezone setupfru 221 227 showaltitude 229 showarchiving showaudit 231 235 showautologout showboards showcod 239 241 245 showcodlicense 247 showcodusage 249 showconsolepath showdate showdcl 255 257 259 showdevices 265 showdomainmode 271 showdomainstatus 273 showdscp 275 showdualpowerfeed showemailreport 281 showenvironment showfru
showlocale 301 showlocator showlogs 303 305 showlookup 319 showmonitorlog 321 shownameserver 323 shownetwork shownotice showntp 325 331 333 showpasswordpolicy 335 showpowerupdelay showresult 339 showroute 341 337 showshutdowndelay showsmtp 347 showsnmp 349 showsnmpusm 351 showsnmpvacm showssh 353 355 showstatus 359 showtelnet 361 showtimezone showuser 363 367 snapshot 369 switchscf 377 testsb 379 unlockmaintenance version 385 viewaudit who viii 345 389 395 XS
Preface This manual describes how to use the shell command which can be executed in the eXtended System Control Facility (hereinafter referred to as XSCF) environment in SPARC Enterprise M4000/M5000/M8000/M9000 servers. The shell command is hereinafter referred to as XSCF shell command. XSCF is a system monitoring facility to conduct monitoring, control, operation, or maintenance of main unit and domains of SPARC Enterprise M4000/M5000/M8000/ M9000 servers.
Audience This manual is intended for users, who administrate SPARC Enterprise M4000/ M5000/M8000/M9000 servers (hereinafter referred to as XSCF user). The XSCF user is required to have the following knowledge: ■ ■ SolarisTM Operating System and Unix command SPARC Enterprise M4000/M5000/M8000/M9000 servers and basic knowledge of XSCF Notation of This Manual Here describes the notation used in this manual. Intro(8) provides the XSCF shell commands and the brief description of them in the alphabetical order.
Each XSCF shell command is described in the order of sections below. When there's no relevant description provided, the section itself is omitted. Section Description NAME This section gives the names of the XSCF shell commands, followed by a brief description of what they do. SYNOPSIS This section gives the syntax of commands. The use of font style complies with the following rule. bold Enters the command name or the constants as displayed.
Section Description OPERANDS This section gives the meaning of and how to specify the OPERANDS. The OPERANDS which follows the OPTIONS are described in "OPTIONS." EXTENDED DESCRIPTION This section gives the description in case the supplementary explanation required in addition to the content written in "DESCRIPTION." Also used to divide the description prolonged in "DESCRIPTION." EXAMPLES This section gives the examples of command execution.
Book Titles Manual Codes SPARC Enterprise M8000/M9000 Servers Safety and Compliance Guide C120-E326 SPARC Enterprise M4000 Server Unpacking Guide C120-E349 SPARC Enterprise M5000 Server Unpacking Guide C120-E350 SPARC Enterprise M8000/M9000 Servers Unpacking Guide C120-E327 SPARC Enterprise M4000/M5000 Servers Installation Guide C120-E351 SPARC Enterprise M8000/M9000 Servers Installation Guide C120-E328 SPARC Enterprise M4000/M5000 Servers Service Manual C120-E352 SPARC Enterprise M8000/M900
Note – Product Notes is available on the website only. Please check for the recent update on your product. 2. Documentation CD For the Documentation CD, please contact your local sales representative. ■ ■ SPARC Enterprise M4000/M5000 Servers Documentation CD (C120-E365) SPARC Enterprise M8000/M9000 Servers Documentation CD (C120-E364) 3. Manual included on the Enhanced Support Facility x.
c. Fault Management MIB (SUN-FM-MIB) definition file http://src.opensolaris.org/source/xref/innv/onnv-gate/usr/ src/lib/fm/libfmd_snmp/mibs/ d. Solaris Operating System Related Manuals http://docs.sun.com/ 6. Provided in firmware program CD (For maintenance service ) a. Firmware program file (XSCF Control Package (XCP) file) b. XSCF extension MIB definition file 7. Information on Using the RCI function The manual does not contain an explanation of the RCI build procedure.
Abbreviated Title Full Title Administration Guide SPARC Enterprise M4000/M5000/M8000/M9000 Servers Administration Guide XSCF User’s Guide SPARC Enterprise M4000/M5000/M8000/M9000 Servers XSCF User’s Guide Dynamic Reconfiguration User’s Guide SPARC Enterprise M4000/M5000/M8000/M9000 Servers Dynamic Reconfiguration (DR) User’s Guide Models The model names used in this manual are as follows.
Shell Prompt Notations Bourne shell and Korn shell $ Bourne shell and Korn shell super user # OpenBoot PROM ok Software License The function to explain in this manual uses the softwares of GPL,LGPL and others. For the information of the license, see Appendix E, "Software License Condition" in SPARC Enterprise M4000/M5000/M8000/M9000 Servers XSCF User’s Guide. Fujitsu Welcomes Your Comments We would appreciate your comments and suggestions to improve this document.
xviii XSCF Reference Manual • April 2007
Reader's Comment Form Preface xix
FOLD AND TAPE NO POSTAGE NECESSARY IF MAILED IN THE UNITED STATES BUSINESS REPLY MAIL FIRST-CLASS MAIL PERMIT NO 741 SUNNYVALE CA POSTAGE WILL BE PAID BY ADDRESSEE FUJITSU COMPUTER SYSTEMS AT TENTION ENGINEERING OPS M/S 249 1250 EAST ARQUES AVENUE P O BOX 3470 SUNNYVALE CA 94088-3470 FOLD AND TAPE xx XSCF Reference Manual • April 2007
Intro(8) NAME DESCRIPTION LIST OF COMMANDS Intro - eXtended System Control Facility (XSCF) man pages This manual contains XSCF man pages.
Intro(8) 2 moveboard move an eXtended System Board (XSB) from the current domain to another nslookup refer to the DNS server for the host password manage user passwords and expiration settings poweroff turn off the power to the specified domain poweron turn on the power to the specified domain prtfru display FRUID data on the system and External I/O Expansion Unit rebootxscf reset the XSCF replacefru replace a field replaceable unit (FRU) reset reset the specified domain resetdateoffset
Intro(8) setlocale set the default locale of the XSCF setlocator control the blinking of the CHECK LED on the operator panel setlookup enable or disable the use of the Lightweight Directory Access Protocol (LDAP) server for authentication and privilege lookup setnameserver set the domain name system (DNS) servers used in the XSCF network setnetwork configure a network interface using by XSCF setntp set the NTP servers used in the XSCF network setpasswordpolicy manage the system password policy
Intro(8) showcod display Capacity on Demand (COD) configuration information showcodlicense display the current Capacity on Demand (COD) right-touse (RTU) licenses stored in the COD license database showcodusage display the current usage statistics for Capacity on Demand (COD) resources showconsolepath display information on the domain console that is currently connected showdate show the date and time of XSCF showdcl display the current domain component list (DCL) showdevices display current i
Intro(8) showmonitorlog display the contents of monitoring messages in real time shownameserver display the registered domain name system (DNS) servers specified on the XSCF network shownetwork display information of network interfaces for XSCF shownotice display copyright and license information for the eXtended System Control Facility (XSCF) Control Package (XCP) showntp display the NTP servers currently set for the XSCF network showpasswordpolicy display the current password settings showpower
Intro(8) testsb perform an initial diagnosis of the specified physical system board (PSB) unlockmaintenance forcibly release the locked status of XSCF 6 version display firmware version viewaudit display audit records who display a list of the user accounts who are logged in to the XSCF XSCF Reference Manual • Last Revised January 2007
addboard(8) NAME SYNOPSIS addboard - configure an eXtended System Board(XSB) into the domain configuration or assign it to the domain configuration addboard [ [-q] -{y|n}] [-f] [-v] [-c configure] -d domain_id xsb [ xsb...] addboard [ [-q] -{y|n}] [-f] [-v] -c assign -d domain_id xsb [ xsb...] addboard [ [-q] -{y|n}] [-f] [-v] -c reserve -d domain_id xsb [ xsb...
addboard(8) Forcibly incorporates into a domain an XSB. -f Note – If the -f option is used to forcibly add a system board to a domain, all the added hardware resources may not work normally. For this reason, use of the -f option is not recommended in normal operation. If the -f option must be specified, verify the status of every added system board and device. OPERANDS -h Displays usage statement. When used with other options or operands, an error occurs.
addboard(8) See the setdcl(8) and showdcl(8) commands for DCL. ■ EXAMPLES EXAMPLE 1 Configures XSB#00-0, #01-0, #02-0, and #03-0 into domain ID 0. XSCF> addboard -y -c assign -d 0 00-0 01-0 02-0 03-0 EXAMPLE 2 Configures XSB#00-0, #01-0, #02-0, and #03-0 forcibly into domain ID 2. XSCF> addboard -f -d 2 00-0 01-0 02-0 03-0 EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
addboard(8) 10 XSCF Reference Manual • Last Revised January 2007
addcodlicense(8) NAME SYNOPSIS addcodlicense - add a Capacity on Demand (COD) right-to-use (RTU) license key to the COD license database addcodlicense license-signature addcodlicense -h DESCRIPTION addcodlicense(8) adds the COD RTU specified license key to the COD license database on the Service Processor. When the license key is added, the quantity of headroom is reduced by the quantity provided by the license key. The quantity of headroom cannot be lower than 0.
addcodlicense(8) SEE ALSO 12 deletecodlicense(8), setcod(8), showcod(8), showcodlicense(8), showcodusage(8) XSCF Reference Manual • Last Revised January 2007
addfru(8) NAME SYNOPSIS addfru - add a Field Replaceable Unit (FRU) addfru addfru -h DESCRIPTION The addfru(8) command adds an FRU. The addfru(8) command enables the user to make the settings that are required for FRU addition and related to selecting, confirming, and mounting FRUs, interactively using menus.
addfru(8) 14 XSCF Reference Manual • Last Revised January 2007
adduser(8) NAME SYNOPSIS adduser - create an XSCF user account adduser [-u UID] user adduser -h DESCRIPTION adduser(8) creates a new local XSCF user account. This account is used to configure, operate, manage and administrate the XSCF firmware. Initially, this account has no password. It cannot be used for login until either the password is set (using password(8)) or Secure Shell (SSH) public key authentication is set for the user. The new account will be locked but not disabled.
adduser(8) EXIT STATUS SEE ALSO 16 The following exit values are returned: 0 Successful completion. >0 An error occurred.
applynetwork(8) NAME SYNOPSIS applynetwork - reset XSCF to reflect information that has been set for the XSCF network applynetwork [ [-q] -{y|n}] [-M] applynetwork -h DESCRIPTION applynetwork(8) resets XSCF to reflect network information that has been set for an XSCF unit. When setting one of the following, XSCF should be reset to reflect network information using the applynetwork(8) command.
applynetwork(8) EXTENDED DESCRIPTION EXAMPLES ■ When the command is executed, a prompt to confirm execution of the command with the specified options is displayed. Enter "y" to execute the command or "n" to cancel the command. ■ Unless all of the host name, DNS domain name, IP address, net mask, and routing settings have been made, it results in errors. Please execute the sethostname(8), setnetwork(8), and setroute(8) command to set all items, then reexecute the applynetwork(8) command.
applynetwork(8) On a high-end server: The case of high-end server. XSCF> applynetwork The following network settings will be applied: xscf#0 hostname :hostname-0 xscf#1 hostname :hostname-1 DNS domain name :example.com nameserver :10.23.4.3 interface status IP address netmask route :xscf#0-lan#0 :up :10.24.144.214 :255.255.255.0 : -n 0.0.0.0 -m 0.0.0.0 -g 10.24.144.1 interface status IP address netmask route :xscf#0-lan#1 :down : : : interface status IP address netmask route :xscf#0-if :down :10.24.
applynetwork(8) EXAMPLE 2 On the midrange server, resets XSCF to reflect the information that has been set for the XSCF network. Automatically answers "y" to all prompts. XSCF> applynetwork -y The following network settings will be applied: xscf#0 hostname :hostname-0 DNS domain name :example.com nameserver :10.23.4.3 interface status IP address netmask route :xscf#0-lan#0 :up :10.24.144.214 :255.255.255.0 :-n 0.0.0.0 -m 0.0.0.0 -g 10.24.144.
cfgdevice(8) NAME SYNOPSIS cfgdevice - connect a DVD/TAPE drive to the port, disconnect it from the port, or display the status of the drive cfgdevice [ [-q] -{y|n}] -c attach -p port_no cfgdevice [ [-q] -{y|n}] -c detach -p port_no cfgdevice -l [-M] cfgdevice -h DESCRIPTION The cfgdevice(8) connects a DVD/TAPE drive to the specified port, disconnects it from the domain, or displays the current status of the DVD/TAPE drive.
cfgdevice(8) The current status of the drive that is displayed with this command includes the following types of status information: port_no Port number of the port where the IOUA is installed and that can be connected to a DVD/TAPE drive. It is displayed in the "IOU number-PCI slot number" format. IOU/SAS-status Connection status between IOUA and built-in switching unit. It is changed by specifying "attach" or "detach.
cfgdevice(8) OPTIONS EXTENDED DESCRIPTION The following options are supported: -c attach Connects a DVD/TAPE drive to the specified port. -c detach Disconnects the DVD/TAPE drive from the specified port. -h Displays usage statement. When used with other options or operands, an error occurs. -l Displays the current status of the DVD/TAPE drive currently set up. -M Displays text by page. This option provides a function that is the same as that of the more command.
cfgdevice(8) ■ A DVD/TAPE drive is mounted in each of the base and expansion cabinets in a high-end server that has the expansion cabinet. In such cases, each DVD/TAPE drive can be connected only to a domain within the cabinet in which the drive is mounted. Settings for connection must be made for both the base cabinet and expansion cabinet. XSCF> cfgdevice -l Current connection for DVD/DAT: Main chassis: port 0-0 Expansion chassis: port 8-0 Expander status Port No.
cfgdevice(8) EXAMPLE 4 Displays the status of individual DVD/TAPE drives set (without the expansion cabinet). XSCF> cfgdevice -l Current connection for DVD/DAT: port 0-0 Expander status Port No. IOU/SAS-status SAS-status ----------------------------------0-0 enable up enable up 0-2 disable up enable up EXAMPLE 5 Displays the status of individual DVD/TAPE drives set (with the expansion cabinet). XSCF> cfgdevice -l Current connection for DVD/DAT: port 0-0 Expander status Port No.
cfgdevice(8) 26 XSCF Reference Manual • Last Revised January 2007
clockboard(8) NAME SYNOPSIS clockboard - Set or display the clock control unit used at system startup clockboard -c display clockboard -c set -s CLKU_B-number clockboard -h DESCRIPTION The clockboard(8) command specifies the clock control unit used when the system power is turned on, or it displays the clock control unit that is currently used and the clock control unit used at the next system startup. The number 0 or 1 is used to specify or display a clock control unit.
clockboard(8) 28 XSCF Reference Manual • Last Revised January 2007
console(8) NAME SYNOPSIS console - connect to a domain console console [ [-q] -{y|n}] -d domain_id [-f | -r] [-s escapeChar] console -h DESCRIPTION The console(8) command connects the XSCF shell console to the console of the specified domain (domain console). Domain consoles include a writable console and read-only console. Only one writable console and multiple read-only consoles can be connected to one domain.
console(8) -n Automatically answers 'n' (no) to all prompts. -q Suppresses all messages to stdout, including prompts. -r Sets up a connection to a read-only console. -s escapeChar Specifies an escape character. The default is ’#’ (sharp). The character specified for escapeChar must be enclosed in double quotation (" "). The following symbols can be specified for escapeChar: ’#’, ’@’, ’^’, ’&’, ’?’, ’*’, ’=’, ’.
deleteboard(8) NAME SYNOPSIS deleteboard - disconnect an eXtended System Board (XSB) from the domain configuration deleteboard [ [-q] -{y|n}] [-f] [-v] [-c disconnect] xsb [ xsb...] deleteboard [ [-q] -{y|n}] [-f] [-v] -c unassign xsb [ xsb...] deleteboard [ [-q] -{y|n}] [-f] [-v] -c reserve xsb [ xsb...] deleteboard -h DESCRIPTION The deleteboard(8) command disconnects an XSB from the domain configuration in which it has been configured.
deleteboard(8) OPTIONS The following options are supported. -c disconnect Detaches the XSB from the domain configuration and keeps it assigned. If the -c option is omitted, "-c disconnect" is used. -c reset Reserves disconnect of an XSB. If the -c option is omitted, "-c disconnect" is used. -c unassign Disconnects the XSB completely from the domain configuration and puts it in the system board pool. If the -c option is omitted, "-c disconnect" is used. -f Forcibly detaches the specified XSB.
deleteboard(8) EXAMPLES ■ If "-c disconnect" is specified when either the domain power has been turned off or the XSB is already disconnected from the domain configuration, no operation is performed. If domain power-on or power-off is in progress, the command results in an error. ■ If "-c unassign" is specified when either the domain power has been turned off or the XSB is already disconnected from the domain configuration, the XSB is switched from the assigned state to a system board pool.
deleteboard(8) 34 XSCF Reference Manual • Last Revised January 2007
deletecodlicense(8) NAME SYNOPSIS deletecodlicense - remove a Capacity on Demand (COD) right-to-use (RTU) license key from the COD license database deletecodlicense [-f] license-signature deletecodlicense -h DESCRIPTION The deletecodlicense(8) command removes the specified COD RTU license key from the COD license database on the Service Processor. For further information about COD RTU license keys, refer to the OPL Administration Guide.
deletecodlicense(8) SEE ALSO 36 addcodlicense(8), setcod(8), showcod(8), showcodlicense(8), showcodusage(8) XSCF Reference Manual • Last Revised January 2007
deletefru(8) NAME SYNOPSIS deletefru - delete a Field Replaceable Unit (FRU) deletefru deletefru -h DESCRIPTION The deletefru(8) command deletes a FRU. The deletefru(8) command allows the user to make the settings that are required for FRU deletion and related to selecting, confirming, and removing FRUs interactively using menus. The following FRUs can be deleted: Privileges ■ CPU memory unit (CMU) ■ I/O unit (IOU) You must have fieldeng privileges to run this command.
deletefru(8) 38 XSCF Reference Manual • Last Revised January 2007
deleteuser(8) NAME SYNOPSIS deleteuser - delete an XSCF user account deleteuser user deleteuser -h DESCRIPTION deleteuser(8) deletes a local XSCF user account. All local account data associated with the user account is deleted including password and Secure Shell (SSH) keys. The local user’s currently running XSCF shell and browser sessions are terminated at once. The user’s account is removed from the system and they cannot log back in. You cannot delete your own account.
deleteuser(8) 40 XSCF Reference Manual • Last Revised January 2007
disableuser(8) NAME SYNOPSIS disableuser - disable an XSCF user account disableuser user disableuser -h DESCRIPTION disableuser(8) disables a local XSCF user account for subsequent logins. Current sessions are not affected. When an account is disabled, it cannot be used for login. This applies to console (serial) and telnet connections, as well as the Secure Shell (SSH). XSCF Web login is also disabled. All local XSCF account data associated with the user remains on the system.
disableuser(8) 42 XSCF Reference Manual • Last Revised January 2007
enableuser(8) NAME SYNOPSIS enableuser - enable an XSCF user account enableuser user enableuser -h DESCRIPTION Privileges enableuser(8) enables a local XSCF user account. An enabled account can be used for login at the console, using Secure Shell (SSH). Using this command, you can reenable accounts disabled by disableuser. You must have useradm privileges to run this command. Refer to setprivileges(8) for more information. OPTIONS The following option is supported. -h Displays usage statement.
enableuser(8) 44 XSCF Reference Manual • Last Revised January 2007
exit(1) NAME SYNOPSIS exit - exit the XSCF shell exit exit -h DESCRIPTION Privileges The exit(1) command exits and closes the XSCF shell. No privileges are required to run this command. Refer to setprivileges(8) for more information. OPTIONS The following options are supported: -h Displays usage statement.
exit(1) 46 XSCF Reference Manual • Last Revised January 2007
flashupdate(8) NAME SYNOPSIS flashupdate - update the firmware flashupdate -c check -m xcp -s version flashupdate [ [-q] -{y|n}] -c update -m xcp -s version flashupdate -c sync flashupdate -h DESCRIPTION The flashupdate(8) command updates the firmware that is provided for the SPARC Enterprise M4000/M5000/M8000/M9000 servers. The entire firmware shown below is updated. Whether update can be performed can be checked beforehand.
flashupdate(8) -q Suppresses all messages to stdout, including prompts. -s version Specifies a XCP comprehensive firmware version. For version, specify a major version, minor version and micro version continuously. The XCP version number appears as xyyz by four digits, where: EXAMPLES Major firmware release number yy Minor release number z Micro release number Automatically answers 'y' (yes) to all prompts.
flashupdate(8) EXAMPLE 2 Updates the entire firmware to version from 1010 to 1020. XSCF> flashupdate -c update -m xcp -s 1020 The XSCF will be reset.
flashupdate(8) 50 XSCF Reference Manual • Last Revised January 2007
fmadm(8) NAME SYNOPSIS fmadm - fault management configuration tool fmadm [-q] config fmadm -h DESCRIPTION fmadm (8) can be used to view system configuration parameters related to fault management. fmadm can be used to: View the set of diagnosis engines and agents that are currently participating in fault management View the list of system components that have been diagnosed as faulty The Fault Manager attempts to automate as many activities as possible, so use of fmadm is typically not required.
fmadm(8) EXAMPLES EXAMPLE 1 Displaying the Fault Manager Configuration XSCF> fmadm config MODULE VERSION STATUS DESCRIPTION case-close 1.0 active Case-Close Agent fmd-self-diagnosis 1.0 active Fault Manager SelfDiagnosis sysevent-transport 1.0 active SysEvent Transport Agent syslog-msgs 1.0 active Syslog Messaging Agent EXIT STATUS SEE ALSO 52 The following exit values are returned: 0 Successful completion. >0 An error occurred.
fmdump(8) NAME SYNOPSIS fmdump - view fault management logs fmdump fmdump [-e] [-f] [-M] [-v] [-V] [-c class] [-t time] [-T time] [-u uuid] fmdump -m [-M] [-t time] [-T time] fmdump -h DESCRIPTION The fmdump utility displays the contents of any of the logs associated with the Fault Manager (fault manager daemon). The Fault Manager runs in the background on each server.
fmdump(8) filter option is present on the command-line, the like options combine to display any events selected by the logical OR of the options. You can use the -m option to display the Fault Manager syslog contents. Privileges You must have platop, platadm, or fieldeng privileges to run this command. Refer to setprivileges(8) for more information. OPTIONS The following options are supported. -c class Selects events that match the specified class.
fmdump(8) -u uuid Selects fault diagnosis events that exactly match the specified uuid. Each diagnosis is associated with a Universal Unique Identifier (UUID) for identification purposes. The -u option can be combined with other options such as -v to show all of the details associated with a particular diagnosis. If the -e option and -u option are specified at the same time, fmdump displays the relevant error events. -v Displays verbose event detail.
fmdump(8) Time Format Description yyyy-mm-dd[T hh:mm[:ss]] Year, month, day, and optional hour in 24-hour format, minute, and second, where T is an integer value specified in base 10. The second, or hour, minute, and second, can be optionally omitted. ddMonyy 12:00:00AM on the specified day, month name, and year. hh:mm:ss Hour in 24-hour format, minute, and second of the current day. hh:mm Hour in 24-hour format and minute of the current day.
fmdump(8) EXAMPLES EXAMPLE 1 Default fmdump Display XSCF> fmdump TIME Aug 12 16:12:13.2811 Aug 12 16:12:13.2985 Sep 01 16:06:57.5839 Sep 01 16:06:57.6278 Sep 06 09:37:05.0983 Sep 06 09:38:10.8584 Sep 06 09:57:44.6502 Sep 06 12:40:59.2801 Sep 06 12:41:10.1076 Sep 06 13:01:49.1462 Sep 06 15:42:56.6132 Sep 06 16:07:14.4652 Sep 06 16:08:16.3755 Sep 29 14:49:27.8452 Sep 29 15:02:00.3039 Sep 29 15:09:25.4335 Sep 29 15:10:09.
fmdump(8) EXAMPLE 4 Displaying the Full Fault Report for the Specified UUID XSCF> fmdump -V -u 5f88d7d5-a107-4435-99c9-7c59479d22ed TIME UUID MSG-ID Sep 29 15:10:09.6151 5f88d7d5-a107-4435-99c9-7c59479d22ed FMD-8000-58 TIME CLASS ENA Sep 29 15:10:09.5652 ereport.io.iox.cp.seeprom0.nresp 0x921b650000000001 nvlist version: 0 version = 0x0 class = list.
fmdump(8) EXAMPLE 5 Displaying Contents of the Fault Manager syslog Message XSCF> fmdump -m -M MSG-ID: FMD-8000-11, TYPE: Defect, VER: 1, SEVERITY: Minor EVENT-TIME: Tue Nov 7 07:01:44 PST 2006 PLATFORM: SUNW,SPARC-Enterprise, CSN: 7860000764, HOSTNAME: san-ff2-20-0 SOURCE: sde, REV: 1.5 EVENT-ID: 2daddee0-2f42-47ee-b5b2-57ae6a41bfc0 DESC: A Solaris Fault Manager component generated a diagnosis for which no message summary exists. Refer to http://www.sun.com/msg/FMD-8000-11 for more information.
fmdump(8) 60 XSCF Reference Manual • Last Revised January 2007
fmstat(8) NAME SYNOPSIS fmstat - report fault management module statistics fmstat fmstat [-a] [ [-s] [-z] [-m module]] [ interval [ count]] fmstat -h DESCRIPTION The fmstat utility can be used by administrators and service personnel to report statistics associated with the Fault Manager (fault manager daemon), and its associated set of modules. The Fault Manager runs in the background on each OPL system.
fmstat(8) Privileges solve The total number of cases solved by this module since it was loaded. memsz The amount of dynamic memory currently allocated by this module. bufsz The amount of persistent buffer space currently allocated by this module. You must have platadm, platop, or fieldeng privileges to run this command. Refer to setprivileges(8) for more information. OPTIONS The following options are supported. -a Prints the default global statistics for the Fault Manager or a module.
fmstat(8) OPERANDS The following operands are supported: count Print only count reports, and then exit. interval Print a new report every interval seconds. If neither count nor interval is specified, a single report is printed and fmstat exits. If an interval is specified but no count is specified, fmstat prints reports every interval seconds indefinitely until the command is interrupted by Control-C.
fmstat(8) XSCF> fmstat module ev_recv ev_acpt bufsz case-close 0 0 fmd-self-diagnosis 1 1 sysevent-transport 0 0 syslog-msgs 0 0 EXAMPLE 2 wait svc_t 0.0 0.0 0.0 0.2 0.0 573.2 0.0 0.
ioxadm(8) NAME SYNOPSIS ioxadm - manage External I/O Expansion Units ioxadm [-f] [-p] [-v] [-M] env [-e] [-l] [-t] [ target [ sensors]] ioxadm [-f] [-p] [-v] [-M] list [ target] ioxadm [-f] [-p] [-v] [-M] locator [on|off] [ target] ioxadm [-f] [-p] [-v] [-M] poweroff target ioxadm [-f] [-p] [-v] [-M] poweron target ioxadm [-f] [-p] [-v] [-M] reset target ioxadm [-f] [-p] [-v] [-M] setled [ on|off|slow|fast] target led_type ioxadm -h DESCRIPTION ioxadm(8) manages External I/O Expansion Units and link card
ioxadm(8) OPERANDS -M Displays text by page. This option provides a function that is the same as that of the more command. -p Parsable output. Suppresses headers in display output. Fields are separated by single tabs. -v Specifies verbose output. Refer to specific operands for details.
ioxadm(8) Displays a summary of an External I/O Expansion Unit or link card’s environmental state. ■ -e Displays electrical states: measured voltage, current, fan speed, switch settings. ■ -l Displays LED states. ■ -t Displays thermal readings. If no target is specified, env displays a list of all sensors for all External I/O Expansion Units. If target specifies a box_id, env displays a list of sensor readings for all frus in the specified External I/O Expansion Unit and the attached downlink cards.
ioxadm(8) Fields containing a dash (–) indicate an unsupported setting. For example, there may be no minimum temperature alarm threshold. led_type Used with the setled operand, specifies a software-controlled FRU LED. The following table indicates which LED states can be controlled using the setled operand with the off, on, fast, and slow LED state settings. Y (yes) indicates that the LED can be controlled, N (no) indicates that it cannot be controlled.
ioxadm(8) Sets or queries the state of the locator indicator (LED). Without options, locator reports the current state of the LED on the specified FRU. If no target is specified, locator returns the current state of all locator LEDs. A target argument is required when using the option fields: on Turns the LED on. off Turns the LED off. The chassis locator is a white LED. If a FRU is specified, the FRU yellow service LED is used along with the chassis (locator) LED.
ioxadm(8) Reinitializes FRU components used to monitor External I/O Expansion Unit environmentals. If a boat or link card is specified, the bridge controllers in the link cards are reset and re-initialized. If a box is specified, the fan controller and demux in the box are reset and re-initialized along with all bridge controllers associated with the External I/O Expansion Unit. setled [on|off|slow|fast] target led_type Sets LED state: off Off. on On. fast Fast blink. slow Slow blink.
ioxadm(8) Specifies the target device which can be a downlink card in a host slot, an External I/O Expansion Unit, or a FRU in an External I/O Expansion Unit. The downlink card is identified by the hostpath to the card. hostpath is platform dependent and indicates the path to the slot on the host system which contains the downlink card.
ioxadm(8) EXAMPLES EXAMPLE 1 Displaying Temperature, Voltage, Current, and Fanspeed Sensor Readings XSCF> ioxadm env -te iox@A3B5 Location Sensor IOX@A3B5/PS0 T_AMBIENT IOX@A3B5/PS0 T_CHIP IOX@A3B5/PS0 T_HOTSPOT IOX@A3B5/PS0 SWITCH IOX@A3B5/PS0 V_12V_ANODE IOX@A3B5/PS0 V_12V_CATHODE IOX@A3B5/PS0 V_ISHARE IOX@A3B5/PS0 I_DC IOX@A3B5/PS0 S_FAN_ACTUAL IOX@A3B5/PS0 S_FAN_SET IOX@A3B5/PS1 T_AMBIENT IOX@A3B5/PS1 T_CHIP IOX@A3B5/PS1 T_HOTSPOT IOX@A3B5/PS1 SWITCH IOX@A3B5/PS1 V_12V_ANODE IOX@A3B5/PS1 V_12V_CATHOD
ioxadm(8) In EXAMPLE 3, the list command is used to display the connections between External I/O Expansion Units and downlink cards in the host. IOX@0033 (which includes boats, uplink cards, and power supplies) is connected to the host through two downlink cards. The Link 0 column shows which host downlink card is attached to boat0. The Link 1 column shows which host downlink card is attached to boat1. IOX@12B4 is connected to the host through one downlink card. This card is connected to boat1.
ioxadm(8) EXAMPLE 9 Enabling the Indicator for Power Supply 0 When Power Supply 0 Has a Fault Indication XSCF> ioxadm XSCF> ioxadm Location IOX@X031 XSCF> ioxadm Location IOX@X031/PS1 locator on iox@x031/ps1 locator Sensor LOCATE Value Resolution Units Fast - LED env -1 iox@x031/ps1 SERVICE Sensor SERVICE Value Resolution Units On - LED The External I/O Expansion Unit chassis white LED has an integrated push button.
man(1) NAME SYNOPSIS man - display manual pages of specified XSCF shell command man command_name ... man -h DESCRIPTION Privileges man(1) displays manual pages of specified XSCF shell command. No privileges are required to run this command. Refer to setprivileges(8) for more information. OPTIONS The following option is supported; Displays usage statement. When used with other options or operands, an error occurs.
man(1) EXIT STATUS 76 The following exit values are returned: 0 Successful completion >0 An error occurred.
moveboard(8) NAME SYNOPSIS moveboard - move an eXtended System Board (XSB) from the current domain to another moveboard [ [-q] -{y|n}] [-f] [-v] [-c configure] -d domain_id xsb [ xsb...] moveboard [ [-q] -{y|n}] [-f] [-v] -c assign -d domain_id xsb [ xsb...] moveboard [ [-q] -{y|n}] [-f] [-v] -c reserve -d domain_id xsb [ xsb...
moveboard(8) OPTIONS The following options are supported: -c assign Disconnects a configured XSB from its domain configuration and assigns it to the domain configuration of the move destination. If the -c option is omitted, '-c configure' is used. -c configure Disconnects a configured XSB from its domain configuration and configures it in the domain configuration of the move destination. If the -c option is omitted, '-c configure' is used.
moveboard(8) OPERANDS The following operand is supported: xsb Specifies the XSB number to be moved. Multiple xsb operands are permitted, separated by spaces. The following xsb form is accepted: x–y where: EXTENDED DESCRIPTION An integer from 00–15. y An integer from 0–3. ■ When the command is executed, a prompt to confirm execution of the command with the specified options is displayed. Enter "y" to execute the command or "n" to cancel the command.
moveboard(8) EXAMPLE 2 Reserves assignment of the XSB#00-0 to the domain ID 1. XSCF> moveboard -d 1 -c reserve 00-0 EXIT STATUS SEE ALSO 80 The following exit values are returned: 0 Successful completion. >0 An error occurred.
nslookup(8) NAME SYNOPSIS nslookup - refer to the DNS server for the host nslookup hostname nslookup -h DESCRIPTION nslookup(8) refers to the DNS server for the host.
nslookup(8) 82 XSCF Reference Manual • Last Revised January 2007
password(8) NAME SYNOPSIS password - manage user passwords and expiration settings password password [-e days| date|Never] [-i inactive] [-M maxdays] [-n mindays] [-w warn] [ user] password -h DESCRIPTION password (8) changes a user’s password and password expiration settings. When invoked with one or more options, password will make changes to the expiration settings of the account. See setpasswordpolicy(8) for a description of default values.
password(8) OPTIONS The following options are supported -e days|date|Never Sets the number of days, starting from today, during which the XSCF account is enabled. Otherwise, it sets the date when the account expires. The date format can be yyyy-mm-dd. Never (or its equivalent in the language of the system locale) means an account will never expire. It is case insensitive. Displays usage statement. -h When used with other options or operands, an error occurs.
password(8) EXAMPLES EXAMPLE 1 Enabling Password Until February 2, 2008 XSCF> password -e 2008-02-02 EXAMPLE 2 Set Password Lock 10 Days After Password Expiration XSCF> password -i 10 EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
password(8) 86 XSCF Reference Manual • Last Revised January 2007
poweroff(8) NAME SYNOPSIS poweroff - turn off the power to the specified domain poweroff [ [-q] -{y|n}] [-f] [-M] -d domain_id poweroff [ [-q] -{y|n}] -a [-M] poweroff -h DESCRIPTION The poweroff(8) command turns off the power to the specified domain. The command can turn off the power to the specified domain or to all domains. After ordinary shutdown processing for the operating system is executed, the power is turned off.
poweroff(8) ■ If the operating system of the target domain is running, the poweroff(8) command processing is equivalent to that of the shutdown(1M) command with the "-i5" option specified. ■ A domain cannot be powered off while the operating system of the domain is booting. Execute the poweroff(8) command again after the booting is completed. ■ A domain cannot be powered off by the poweroff(8) command while the operating system of the domain is running in single-user mode.
poweroff(8) EXAMPLE 3 Turns off power to domains with domain IDs 1. An error occurs because the user has no control privilege. XSCF> poweroff -d 1 DomainIDs to power off:01 Continue? [y|n]:y 01:Not powering off:Permission denied. *Note* This command only issues the instruction to power-off. The result of the instruction can be checked by the "showlogs power". EXAMPLE 4 Forcibly turns off power to domains with domain IDs 0.
poweroff(8) EXAMPLE 9 Cancels the poweroff(8) command execution that is in progress. Automatically replies with 'n' without displaying the prompt. XSCF>poweroff -q -n -d 3 EXIT STATUS SEE ALSO 90 The following exit values are returned: 0 Successful completion. >0 An error occurred.
poweron(8) NAME SYNOPSIS poweron - turn on the power to the specified domain poweron [ [-q] -{y|n}] [-M] -d domain_id poweron [ [-q] -{y|n}] [-M] -a poweron -h DESCRIPTION The poweron(8) command turns on the power to the specified domain. The command can turn on the power to the specified domain or to all domains. Privileges You must have one of the following privileges to run this command: platadm, fieldeng Can run this command for all domains.
poweron(8) ■ Powering on The power was turned on normally. Not Powering on An error occurred, and the power could not be turned on. An error message is displayed with Not Powering on. ■ EXAMPLES When the poweron(8) command is executed, power-on results for each of the specified domains are displayed in the following format: The showdomainstatus(8) command can be used to check whether the system power is on. EXAMPLE 1 Turns on power to all domains.
poweron(8) EXAMPLE 5 Cancels the poweron(8) command execution that is in progress. XSCF> poweron -d 1 DomainIDs to power on:01 Continue? [y|n]:n EXAMPLE 6 Cancels the poweron(8) command execution that is in progress. Automati- cally replies with 'n' to the prompt. XSCF> poweron -n -d 1 DomainIDs to power on:01 Continue? [y|n]:n EXAMPLE 7 Cancels the poweron(8) command execution that is in progress. Automati- cally replies with 'n' without displaying the prompt.
poweron(8) 94 XSCF Reference Manual • Last Revised January 2007
prtfru(8) NAME SYNOPSIS prtfru - display FRUID data on the system and External I/O Expansion Unit prtfru prtfru [-c] [-l] [-M] [-x] [ container] prtfru -h DESCRIPTION prtfru is used to obtain FRUID (Field-Replaceable Unit Identifier) data from the system. Its output is a tree structure, echoing the path in the FRU tree to each container. When a container is found, the data from that container is printed in a tree structure as well.
prtfru(8) EXAMPLES EXAMPLE 1 Displaying FRU Tree Hierarchy XSCF> prtfru -l ...
prtfru(8) EXAMPLE 4 Displaying Power Supply FRU ID Data XSCF> prtfru -l power-supply /frutree/chassis/PS0?Label=PS0/power-supply (container) EXAMPLE 5 Displaying Memory Module FRU ID Data XSCF> prtfru -l mem-module /frutree/chassis/C0?Label=C0/system-board/P0?Label=P0/cpu/B0?Label=B0/ bank/D0?Label=D0/mem-module (container) EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
prtfru(8) 98 XSCF Reference Manual • Last Revised January 2007
rebootxscf(8) NAME SYNOPSIS rebootxscf - reset the XSCF rebootxscf [ [-q] -{y|n}] rebootxscf -h DESCRIPTION Privileges The rebootxscf(8) command resets the XSCF. You must have platadm or fieldeng privilege to run this command. Refer to setprivileges(8) for more information. OPTIONS EXTENDED DESCRIPTION EXAMPLES The following options are supported: -h Displays usage statement. When used with other options or operands, an error occurs. -n Automatically answers 'n' (no) to all prompts.
rebootxscf(8) EXIT STATUS SEE ALSO 100 The following exit values are returned: 0 Successful completion. >0 An error occurred.
replacefru(8) NAME SYNOPSIS replacefru - replace a field replaceable unit (FRU) replacefru replacefru -h DESCRIPTION The replacefru(8) command replaces a FRU. The command allows the user to select, confirm, and replace the FRU interactively using menus. The following FRUs can be replaced using the replacefru(8) command. Privileges ■ CPU memory unit (CMU) ■ I/O unit (IOU) ■ FAN unit (FANU) ■ Power supply unit (PSU) ■ XSCF unit (XSCFU) You must have fieldeng privileges to run this command.
replacefru(8) 102 XSCF Reference Manual • Last Revised January 2007
reset(8) NAME SYNOPSIS reset - reset the specified domain reset [ [-q] -{y|n}] -d domain_id level reset -h DESCRIPTION Note – Since the reset(8) command forcibly resets the system, this command may cause a failure in a hard disk drive or other components. Use this command only for the purpose of recovery, such as if the operating system hangs, and for other limited purposes. The reset(8) command resets the specified domain.
reset(8) OPERANDS The following operand is supported: level EXTENDED DESCRIPTION EXAMPLES Specifies the level of resetting. One of the following can be specified. This operand cannot be omitted. por Resets the domain system. request Instructs the domain operating system to generate a panic. xir Resets the domain CPU. ■ When the command is executed, a prompt to confirm execution of the command with the specified options is displayed. Enter "y" to execute the command or "n" to cancel the command.
reset(8) EXAMPLE 4 Cancels the reset command execution that is in progress. XSCF> reset -d 0 panic DomainID to panic:00 Continue? [y|n]:n EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
reset(8) 106 XSCF Reference Manual • Last Revised January 2007
resetdateoffset(8) NAME SYNOPSIS resetdateoffset - reset the time subtraction between XSCF and the domain resetdateoffset resetdateoffset -h DESCRIPTION The resetdateoffset(8) command resets the time subtraction between XSCF and the domain, which stored in XSCF. Usually, the time of the domain is synchronized with the time of XSCF.
resetdateoffset(8) 108 XSCF Reference Manual • Last Revised January 2007
sendbreak(8) NAME SYNOPSIS sendbreak - send a break signal to the specified domain sendbreak -d domain_id sendbreak -h DESCRIPTION The sendbreak(8) command sends a break signal to the specified domain. When a break signal is sent from the domain console to the domain operating system, control is transferred from the operating system to OpenBoot PROM and the OpenBoot PROM prompt "ok>" is displayed.
sendbreak(8) 110 XSCF Reference Manual • Last Revised January 2007
setaltitude(8) NAME SYNOPSIS setaltitude - set the altitude of the system setaltitude -s key=value setaltitude -h DESCRIPTION The setaltitude(8) command sets the altitude of the system. The specified value becomes valid when the circuit breakers of the system are switched on again. Privileges You must have platadm or fieldeng privileges to run this command. Refer to setprivileges(8) for more information. OPTIONS The following options are supported: -h Displays usage statement.
setaltitude(8) EXAMPLE 2 Sets the altitude of the system to 200 m. The specified value is rounded up to the nearest hundred meters. XSCF> setaltitude -s altitude=157 200m EXIT STATUS SEE ALSO 112 The following exit values are returned: 0 Successful completion. >0 An error occurred.
setarchiving(8) NAME SYNOPSIS setarchiving - configure the log archiving functionality setarchiving [-k host-key] [-l audit-limit,non-audit-limit] [-p password|-r] [-t user@host:directory] [-v] [-y|-n] setarchiving enable|disable setarchiving -h DESCRIPTION setarchiving(8) manages the log archiving configuration. Persistent storage space on the Service Processor is limited. Some logs may grow to the point where old log entries must be overwritten or deleted.
setarchiving(8) OPTIONS The following options are supported: Displays usage statement. -h When used with other options or operands, an error occurs. -k host-key Sets the public key that XSCF uses to verify the identity of the host. Possible values for the host-key are shown here: none This literal value specifies that a public key should not be used to authenticate the archive host. If an archive host public key was previously configured, it is deleted.
setarchiving(8) -l audit-limit,non-audit-limit Sets the space limits for log archives in megabytes. The option argument must consist of two values separated by a comma. The audit-limit value specifies the archive space limit for audit logs. It must be either 0 (zero), unlimited or an integer in the range of 500–50000. If you do not use the -l option to modify the value of audit-limit, the initial archive space limit for audit logs is unlimited.
setarchiving(8) OPERANDS EXAMPLES The following operands are supported: enable Activates the log archiving feature. Cannot be used with any options. disable De-activates the log archiving feature. Cannot be used with any options. EXAMPLE 1 Setting the Archiving Target and Password XSCF> setarchiving -t jsmith@somehost.company.com:/home/jsmith/ logs -r Enter ssh password for jsmith@somehost.company.
setaudit(8) NAME SYNOPSIS setaudit - manage the system auditing functionality setaudit enable|disable|archive|delete setaudit [-p count|suspend] [ -m mailaddr] [-a users=enable|disable|default] [-c classes= {enable|disable }]... [-e events=enable|disable ]... [-g {enable|disable }] [-t percents] setaudit -h DESCRIPTION Privileges setaudit(8) manages the collection of data on the use of system resources. Audit data provides a record of security-related system events.
setaudit(8) OPTIONS The following options are supported. -a users=enable|disable|default Sets the audit record generation policy for the specified users. users is a comma-separated list of valid user names. When set to enable or disable, audit record generation for the users is turned on or off respectively. This setting overrides the global policy for the specified user. When set to default, the policy for the users is set to follow the global policy.
setaudit(8) Changes the audit record generation policy for the specified audit events. events is a comma-separated list of audit events. An event may be specified by its numeric value or its name. The AEV_ prefix may be omitted. For example, the event for SSH login can be expressed as AEV_LOGIN_SSH, LOGIN_SSH or 0. See showaudit -e all for a list of valid events. This option may be specified multiple times. Multiple specification are processed together with an -c options in the order listed. See EXAMPLE 3.
setaudit(8) -t percents Sets thresholds at which to issue a warning about local audit storage usage. percents is a comma-separated list of percentages of available space used. At most two values may be set. For example, a value of 50, 75 would cause warnings to be issued when 50% and 75%, respectively, of the available storage for audit records is consumed. The default value is 80%. Warnings are issued as a message to the console and optionally to an administrator using email. See -m mailaddr.
setaudit(8) EXAMPLE 4 Changing Classes and Enabling an Event XSCF> setaudit -c 1=enable -e 5=disable Auditing is enabled for all of Class 1 (CONFIG) except for event 5 (LOGOUT) is disabled. EXAMPLE 5 Enabling Auditing XSCF> setaudit enable Turns on writing of the audit records for the audit trail. EXAMPLE 6 Enabling Warnings XSCF> setaudit -t 50,75 Warnings will be sent at 50% capacity and 75% capacity. EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion.
setaudit(8) 122 XSCF Reference Manual • Last Revised January 2007
setautologout(8) NAME SYNOPSIS setautologout - set the session timeout time of the XSCF shell setautologout -s timeout setautologout -h DESCRIPTION The setautologout(8) command sets the session timeout time of the XSCF shell. The default of the session timeout time is 10 minutes. Privileges You must have platadm or fieldeng privileges to run this command. Refer to setprivileges(8) for more information.
setautologout(8) 124 XSCF Reference Manual • Last Revised January 2007
setcod(8) NAME SYNOPSIS setcod - set up the Capacity on Demand (COD) resources used for domains setcod setcod [-v] headroom setcod [-v] -d domain_id [ proc-rtus] setcod -h DESCRIPTION setcod(8) sets up the COD resources to be used for domains. License keys must be installed (see addcodlicense(8)) before COD boards in a domain can be utilized. You can also enable headroom and reserve licenses for some domains with setcod(8).
setcod(8) COD information, the maximum values allowed are displayed within parentheses () and default values are displayed within brackets []. setcod enables COD headroom (processors to be used on demand). Use the -d domain_id to specify the number of domain COD RTU licenses to be reserved.
setdate(8) NAME SYNOPSIS setdate - set the date and time of XSCF setdate [ [-q] -{y|n}] [-u] -s date setdate -h DESCRIPTION The setdate(8) command sets the date and time of XSCF. If the local date and time are specified, they are set following conversion to coordinated universal time (UTC). When date and time are set, the set date and time are reflected after XSCF is reset. Privileges You must have platadm or fieldeng privileges to run this command. Refer to setprivileges(8) for more information.
setdate(8) EXAMPLES ■ The ntpdate(1M) command is executed in the domain. ■ Rebooting the domain ■ The setdate(8) command needs to be executed in the system power-off status. ■ In case an NTP server set to XSCF, the time set by the setdate(8) command becomes invalid. Whether an NTP server set to XSCF or not can be checked by using the showntp(8) command. ■ To check the currently set XSCF date and time, execute the showdate(8) command.
setdate(8) EXAMPLE 4 Sets "January 27 16:59:00 2006" of the local time (JST) as the current time. Automatically replies with 'y' without displaying the prompt. XSCF> setdate -q -y -s 012716592006.00 Broadcast message from root (pts/4) (Fri Jan 27 16:59:10 2006): The system is going down for reboot NOW! The reset continues after this point. EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
setdate(8) 130 XSCF Reference Manual • Last Revised January 2007
setdcl(8) NAME SYNOPSIS setdcl - set a domain component list (DCL) setdcl -d domain_id -s policy=value setdcl -d domain_id -s option=value lsb [ lsb...] setdcl -d domain_id -a lsb=xsb [ lsb=xsb...] setdcl -d domain_id -r lsb [ lsb...] setdcl -h DESCRIPTION The setdcl(8) command sets a domain component list (DCL). A DCL is hardware resource information that can be set for a domain or the logical system boards (LSBs) that are components of a domain.
setdcl(8) ■ Whether to set a priority for the specified LSB as a floating board, relative to other boards (float) The user can specify whether to set a priority for the specified LSB as a floating board, relative to other boards. A floating board is used for dynamic reconfiguration (DR) for purposes such as changing the domain configuration, while minimizing effect of DR on the operating system. Privileges You must have platadm privileges to run this command.
setdcl(8) -r Clears the XSB number associated with an LSB number in the specified domain. -s option=value Makes settings regarding hardware resources of the XSB associated with an LSB. An item to be set is specified for option, and a value corresponding to option is specified for value. option and value are specified only once in a format using an equal sign (=) to delimit the specified values. The space character must not be inserted immediately before and after "=".
setdcl(8) If no-io is specified for option, either of the following can be specified for value: true Omits the use of I/O devices on a domain. false Does not omit the use of I/O devices on a domain (default). If float is specified for option, either of the following can be specified for value: OPERANDS EXAMPLES Gives a higher priority regarding floating boards. false Does not give a higher priority regarding floating boards (default).
setdcl(8) EXAMPLE 4 Clear the XSBs associated with LSB#00 and #01 of domain ID 0. XSCF> setdcl -d 0 -r 00 01 EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
setdcl(8) 136 XSCF Reference Manual • Last Revised January 2007
setdomainmode(8) NAME SYNOPSIS setdomainmode - set a domain mode setdomainmode [ [-q] -{y|n}] -d domain_id -m function=mode setdomainmode -h DESCRIPTION setdomainmode(8) sets a domain mode for the specified domain. The domain mode of each domain can be set. The domain mode includes the following settings: ■ OpenBoot PROM diagnostic levels (Diagnostics Level) ■ Whether to enable or disable the host watchdog and suppress break signal reception (Secure Mode).
setdomainmode(8) OPTIONS The following options are supported: -d domain_id Specifies the domain ID to be set. domain_id can be 0–23 depending on the system configuration. -h Displays usage statement. When used with other options or operands, an error occurs. -m function=mode Sets the domain mode and specifies its values. Use function to set the domain mode. One of the following can be specified: diag Specifies the OpenBoot PROM diagnostic level.
setdomainmode(8) EXAMPLES ■ value specified with '-m diag' is applied to the diag level of the addboard(8) command and moveboard(8) command. ■ The settings of the current domain mode can be checked by using the showdomainmode(8) command. EXAMPLE 1 The setting of the diagnostic level for domain ID 0 is none. XSCF> setdomainmode -d 0 -m diag=none Diagnostic Level :min -> none Secure Mode :on -> Autoboot :on -> The specified modes will be changed. Continue? [y|n]:y configured.
setdomainmode(8) EXIT STATUS SEE ALSO 140 The following exit values are returned: 0 Successful completion. >0 An error occurred.
setdomparam(8) NAME SYNOPSIS setdomparam - forcibly rewrite OpenBoot PROM environment variables setdomparam [ [-q] -{y|n}] -d domain_id use-nvramrc setdomparam [ [-q] -{y|n}] -d domain_id security-mode setdomparam [ [-q] -{y|n}] -d domain_id set-defaults setdomparam -h DESCRIPTION The setdomparam(8) command rewrites OpenBoot PROM environment variables. This command can rewrite variables of a specified domain or all the domains. The following OpenBoot PROM environment variables can be specified.
setdomparam(8) OPERANDS The following operands are supported: use-nvramrc Sets false for theuse-nvramrc? environment variable. security-mode Sets none to the security-mode? environment variable. set-defaults EXTENDED DESCRIPTION EXAMPLES Restores the OpenBoot PROM environment variables to the settings at the time of shipment from the factory When the command is executed, a prompt to confirm execution of the command with the specified options is displayed.
setdscp(8) NAME SYNOPSIS setdscp - set the IP address assignments for the Domain to Service Processor Communications Protocol (DSCP) setdscp [-v] setdscp [-f] [-v] [ [-q] -{y|n}] -i address -m netmask setdscp [-f] [-v] [ [-q] -{y|n}] -s -i address setdscp [-f] [-v] [ [-q] -{y|n}] -d domain_id -i address setdscp -h DESCRIPTION setdscp(8) assigns IP addresses to the DSCP links. setdscp is intended for initial configuration only. Domains should not be powered on when running this command.
setdscp(8) Note – The -y and -n options can be used (with or without the -q option) when running setdscp in interactive mode. Privileges You must have platadm or fieldeng privileges to run this command. Refer to setprivileges(8) for more information. OPTIONS The following options are supported: -d domain_id Domain identifier. Must be used with -i address option. domain_id can be 0–23 depending on the system configuration.
setdscp(8) EXAMPLE 1 Assigning All DSCP Addresses XSCF> setdscp -y -i 10.1.1.0 -m 255.255.255.0 Commit these changes to the database? [y|n] : y EXAMPLE 2 Assigning an Alternative IP address to Domain 1 XSCF> setdscp -d 1 -i 10.1.1.26 Commit these changes to the database? [y|n] : y EXAMPLE 3 Specifying a Netmask Address With -q and -y Options XSCF> setdscp -q -y -i 10.1.1.0 -m 255.255.255.
setdscp(8) EXIT STATUS SEE ALSO 146 The following exit values are returned: 0 Successful completion. >0 An error occurred.
setdualpowerfeed(8) NAME SYNOPSIS setdualpowerfeed - set dual power feed mode setdualpowerfeed -s key setdualpowerfeed -h DESCRIPTION The setdualpowerfeed(8) command specifies dual power feed mode in the system. The setdualpowerfeed(8) command is valid in a midrange server only. In a highend server, when the power cabinet for dual power feed connected, it automatically configures the dual power feed mode.
setdualpowerfeed(8) EXAMPLE 2 Enables dual power feed mode in the system. Before rebooting the system, a message is displayed. XSCF> setdualpowerfeed -s enable disable -> enable NOTE: Dual power feed will be enabled the next time the platform is powered on. EXIT STATUS SEE ALSO 148 The following exit values are returned: 0 Successful completion. >0 An error occurred.
setemailreport(8) NAME SYNOPSIS setemailreport - set up the email report configuration data setemailreport setemailreport [-v] [-t] setemailreport [-s variable= value]... setemailreport -h DESCRIPTION setemailreport(8) sets up email reporting configuration data for remote maintenance. Once the the configuration data is set up, it is used by the fault management daemon to send email reports as required.
setemailreport(8) OPTIONS The following options are supported: Displays usage statement. -h When used with other options or operands, an error occurs. -s variable=value Configures email reporting. Valid entries for variable are: enable recipient Valid value entries for enable are: yes no Valid value entries for recipient are: Any valid company email account EXAMPLES -t Sends test email. -v Specifies verbose output.
setemailreport(8) EXAMPLE 5 Sending Test Email XSCF> setemailreport -t ....Sending test email to useradm@company.com [Email contents shown below] Host Name: jupiter Send Timestamp: 04-20-2006 16:31:45 PST Mail Server: 10.4.1.1 EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
setemailreport(8) 152 XSCF Reference Manual • Last Revised January 2007
sethostname(8) NAME SYNOPSIS sethostname - set a host name and a DNS domain name for an XSCF unit sethostname xscfu hostname sethostname -d domainname sethostname -h DESCRIPTION sethostname(8) command sets a host name and a DNS domain name for an XSCF unit. When the XSCF unit is duplicated configuration, the DNS domain name becomes common to XSCF units. The host name can be specified for each XSCF unit. Privileges You must have platadm privileges to run this command.
sethostname(8) OPERANDS EXTENDED DESCRIPTION EXAMPLES The following operands are supported: domainname Specifies a DNS domain name to be set for the XSCF unit. The domainname is specified as up to 64 characters, with label elements delimited by a period (.). If a domain name exceeding 64 characters is specified, an error occurs. A label element can contain alphanumeric characters and hyphens (-). Each label element must always begin with an alphabetic character and end with an alphanumeric character.
sethttps(8) NAME SYNOPSIS sethttps - start or stop the HTTPS service, which is used in the XSCF network. This command also performs authentication-related settings.
sethttps(8) OPTIONS The following options are supported: -c {enable|disable} Specify whether to enable the HTTPS service. One of the following values can be specified. If none of them is specified, an error occurs. OPERANDS enable Starts the HTTPS service. disable Stops the HTTPS service. -c gencsr Creates a CSR. -c genserverkey Creates the private key of the web server. -c importca Imports a web server certificate signed by the certification authority to the XSCF.
sethttps(8) EXAMPLES ■ When the HTTPS server starts, the XSCF is reset. ■ The CSR is overwritten. ■ In case the XSCF unit is duplicated configuration, the setting automatically reflected to the standby XSCF. When there's a defect on the standby XSCF, it leads to an error. ■ The details of the current HTTPS service can be checked by using the showhttps(8) command. EXAMPLE 1 Starts the HTTPS service. XSCF> sethttps -c enable The XSCF will be reset.
sethttps(8) EXAMPLE 6 Creates the private key of the web server. Automatically replies with 'y' to the prompt. XSCF> sethttps -c genserverkey Server key already exists. Do you still wish to update? [y|n] :y Enter passphrase: Verifying - Enter passphrase: EXAMPLE 7 Creates the private key of the web server. Automatically replies with 'y' without displaying the prompt. XSCF> sethttps -c genserverkey -q -y Enter passphrase: Verifying - Enter passphrase: EXAMPLE 8 Imports the web server certificate.
setldap(8) NAME SYNOPSIS setldap - configure the Service Processor as a Lightweight Directory Access Protocol (LDAP) client setldap {-b bind} {-B baseDN} {-c certchain} {-p } {-s servers} {-t user} -T timeout setldap -h DESCRIPTION setldap(8) allows you to configure the Service Processor as an LDAP client. Note – The LDAP client supports passwords only in the CRYPT format; UNIX Crypt or MD5. Therefore the passwords on the LDAP server must support it as well.
setldap(8) EXAMPLES -s servers Sets the primary and secondary LDAP servers and ports. servers is a comma-separated list of server:port. Ports are specified numerically and servers can be specified either by name or IP address in the dotted decimal format. For example, 10.8.31.14.636,company:636. The first server in the list is the primary. Server names must be resolvable. Maximum name length is 128 characters. -t user Tests connections to all configured LDAP servers.
setldap(8) EXAMPLE 4 Setting the LDAP Server XSCF> setldap -s ldap://company.com,ldaps://company2.com XSCF> showldap Bind Name: user Base Distinguished Name: ou=people,dc=company,dc=com LDAP Search Timeout: 60 Bind Password: Set LDAP Servers: ldap://company.com:389 ldaps://company2.com:636 CERTS: None EXAMPLE 5 Importing a Certificate XSCF> setldap -c user@remote.machine:/path/to/cacert.
setldap(8) 162 XSCF Reference Manual • Last Revised January 2007
setlocale(8) NAME SYNOPSIS setlocale - set the default locale of the XSCF setlocale -s locale setlocale -h DESCRIPTION The setlocale(8) command sets the default locale of the XSCF. The locale that can be set is English or Japanese. Privileges You must have platadm privileges to run this command. Refer to setprivileges(8) for more information. OPTIONS EXTENDED DESCRIPTION EXAMPLES The following options are supported: -h Displays usage statement.
setlocale(8) 164 XSCF Reference Manual • Last Revised January 2007
setlocator(8) NAME SYNOPSIS setlocator - control the blinking of the CHECK LED on the operator panel setlocator value setlocator -h DESCRIPTION setlocator(8) command controls the blink state of the CHECK LED on the operator panel. The following states can be set: Privileges Start blinking Makes the CHECK LED blink. Stop blinking Stops the blinking of the CHECK LED. You must have platadm or fieldeng privileges to run this command. Refer to setprivileges(8) for more information.
setlocator(8) EXIT STATUS SEE ALSO 166 The following exit values are returned: 0 Successful completion. >0 An error occurred.
setlookup(8) NAME SYNOPSIS setlookup - enable or disable the use of the Lightweight Directory Access Protocol (LDAP) server for authentication and privilege lookup setlookup -a {local|ldap} setlookup -p {local|ldap} setlookup -h DESCRIPTION Privileges setlookup(8) sets whether authentication and privileges data are looked up in LDAP or not. You must have useradm privileges to run this command. Refer to setprivileges(8) for more information.
setlookup(8) 168 XSCF Reference Manual • Last Revised January 2007
setnameserver(8) NAME SYNOPSIS setnameserver - set the domain name system (DNS) servers used in the XSCF network setnameserver [-c add] address ... setnameserver -c del address ... setnameserver -c del -a setnameserver -h DESCRIPTION setnameserver(8) command specifies the DNS servers used in the XSCF network. Up to three DNS servers can be registered for XSCF. Any attempt to register four or more DNS servers causes an error. Privileges You must have platadm privileges to run this command.
setnameserver(8) EXTENDED DESCRIPTION EXAMPLES ■ If multiple DNS servers are specified, names are solved in the order specified. ■ The currently set DNS server can be checked by using the shownameserver(8) command. EXAMPLE 1 Adds the hosts with the IP addresses 192.168.1.2, 10.18.108.10, and 10.24.1.2 as DNS server. Names are solved in the order specified. XSCF> setnameserver 192.168.1.2 10.18.108.10 10.24.1.2 EXAMPLE 2 Deletes the host with the IP address 10.18.108.10 from the DNS server.
setnetwork(8) NAME SYNOPSIS setnetwork - configure a network interface using by XSCF setnetwork [-m addr] interface address setnetwork -c {up | down} interface setnetwork -h DESCRIPTION setnetwork(8) command configures a network interface using by XSCF. The following settings can be made for the specified network interface: ■ Whether to enable or disable the network interface. ■ IP address ■ Net mask An IP address and net mask become valid immediately after being set.
setnetwork(8) OPERANDS The following operands are supported: interface Specifies the network interface to be configured.
setnetwork(8) To reflect information on the specified network interface, execute the applynetwork(8) command and reset XSCF. ■ EXAMPLES EXAMPLE 1 Sets the IP address 192.168.10.10 and net mask 255.255.255.0 for XSCFLAN#0 on XSCF unit 0. XSCF> setnetwork xscf#0-lan#0 -m 255.255.255.0 192.168.10.10 EXAMPLE 2 Sets the IP address 192.168.10.10 and net mask 255.255.255.0 for XSCFLAN#0 on XSCF unit 0 in the midrange system. XSCF> setnetwork lan#0 -m 255.255.255.0 192.168.10.
setnetwork(8) 174 XSCF Reference Manual • Last Revised January 2007
setntp(8) NAME SYNOPSIS setntp - set the NTP servers used in the XSCF network setntp [-c add] address ... setntp -c del address ... setntp -c del -a setntp -h DESCRIPTION setntp(8) command specifies the NTP servers used in the XSCF network. Up to three NTP servers can be registered for XSCF. Any attempt to register four or more servers causes an error. Privileges You must have platadm privileges to run this command. Refer to setprivileges(8) for more information.
setntp(8) OPERANDS The following operands are supported: address Specifies the IP address or host name of an NTP server to be added or deleted. Up to three IP addresses or XSCF host names can be specified by delimited the spaces. A specified IP address is a set of four integer values delimited by the period(.). The following address form is accepted: xxx.xxx.xxx.xxx xxx An integer from 0–255. Zero suppression can be used to specify the integer.
setntp(8) EXAMPLE 3 Adds the two NTP servers ntp1.examples.com and ntp2.example.com. XSCF> setntp ntp1.example.com ntp2.example.com Please reset the XSCF by rebootxscf to reflect the ntp settings. EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
setntp(8) 178 XSCF Reference Manual • Last Revised January 2007
setpasswordpolicy(8) NAME SYNOPSIS setpasswordpolicy - manage the system password policy setpasswordpolicy [-d dcredit] [ -e expiry] [-i inactive] [-k difok] [-l lcredit] [ -M maxdays] [-m minlen] [-n mindays] [-o ocredit] [-r remember] [-u ucredit] [-w warn] [-y retry] setpasswordpolicy -h DESCRIPTION setpasswordpolicy(8) allows an administrator to change the the system password policy. These policies are enforced by XSCF on the Service Processor.
setpasswordpolicy(8) -l lcredit Sets the maximum credit for lower case letters in a password. The minimum acceptable password length is decreased by one for each digit in the password, up to lcredit digits. Valid values are integers with value of zero or greater. The initial setting is 1. -M maxdays Sets the maximum number of days that a password is valid. This value is assigned to new user accounts when they are created.The intial value is 999999. Valid values are integers with value of zero or greater.
setpasswordpolicy(8) -u ucredit Sets the maximum credit for uppercase letters in a password. The minimum acceptable password length is decreased by one for each digit in the password, up to ucredit digits. The initial setting is 1. -w warn Sets the default number of days before password expiration at which to start warning the user. This value is assigned to new user accounts when they are created. The initial value is 7. Valid values are integers with value of zero or greater.
setpasswordpolicy(8) 182 XSCF Reference Manual • Last Revised January 2007
setpowerupdelay(8) NAME SYNOPSIS setpowerupdelay - set the warm-up time of the system and wait time before system startup setpowerupdelay -c warmup -s time setpowerupdelay -c wait -s time setpowerupdelay -h DESCRIPTION The setpowerupdelay(8) command sets the warm-up time of the system and wait time before system startup.
setpowerupdelay(8) EXIT STATUS SEE ALSO 184 The following exit values are returned: 0 Successful completion. >0 An error occurred.
setprivileges(8) NAME SYNOPSIS setprivileges - assign user privileges setprivileges user [ privileges] [ domainprivilege@ domains] setprivileges -h DESCRIPTION setprivileges(8) assigns privileges to an XSCF user. setprivileges modifies only local privileges data. Multiple privileges are separated by one or more spaces. There is a maximum of 100 users to whom privileges can be assigned. A list of privileges can be found in the OPERANDS section.
setprivileges(8) OPERANDS The following operands are supported: domainprivilege@domains Specifies domainadm, domainmgr, or domainop privileges for a specific domain or domains. The following are valid values for domainprivilege, each of which must be used with @domains: domainadm Can perform all operations and view status on the hardware assigned to the domains on which this privilege is held (assign, unassign, power, and so on). Can perform all operations on domains on which this privilege is held.
setprivileges(8) The following are valid values for privileges: auditadm Can configure auditing. Can delete audit trail. auditop Can view all audit state and audit trail. fieldeng Can perform all operations reserved for field engineers and authorized service personnel. none Cannot perform any operations on the Service Processor that require privilege, even if privileges are set for the user in LDAP.
setprivileges(8) 188 XSCF Reference Manual • Last Revised January 2007
setroute(8) NAME SYNOPSIS setroute - set routing information for an XSCF network interface setroute -c {add | del} -n address [-m address] [-g address] interface setroute -h DESCRIPTION setroute(8) command sets routing information for an XSCF network interface. Up to eight routing information items can be registered for each network interface. Any attempt to register more than eight items causes an error. Privileges You must have platadm privilege to run this command.
setroute(8) -h Displays usage statement. When used with other options or operands, an error occurs. -m address Specifies the netmask to which routing information is forwarded. The specified value is a set of four integer values delimited by the period (.). The following address form is accepted: xxx.xxx.xxx.xxx xxx An integer from 0–255. Zero suppression can be used to specify the integer.
setroute(8) OPERANDS The following operand is supported: interface Specifies the network interface to be set with routing information.
setroute(8) EXAMPLE 4 Adds the routing of destination 192.168.1.0 and default net mask (255.255.255.0) for XSCF-LAN#1 on XSCF unit 0. XSCF> setroute -c add -n 192.168.1.0 xscf#0-lan#1 EXAMPLE 5 Deletes the routing of destination 192.168.1.0 and default net mask (255.255.255.0) from XSCF-LAN#1 on XSCF unit 0. XSCF> setroute -c del -n 192.168.1.0 xscf#0-lan#1 EXAMPLE 6 Adds the routing of destination 192.168.1. 4 for XSCF-LAN#1 on XSCF unit 0. XSCF> setroute -c add -n 192.168.1.
setshutdowndelay(8) NAME SYNOPSIS setshutdowndelay - set the shutdown wait time at power interruption of the uninterruptible power supply (UPS) setshutdowndelay -s time setshutdowndelay -h DESCRIPTION The setshutdowndelay(8) command sets the wait time before the start of system shutdown for when power interruption occurs in a system connected to the UPS. The start of system shutdown can be delayed until the specified time.
setshutdowndelay(8) 194 XSCF Reference Manual • Last Revised January 2007
setsmtp(8) NAME SYNOPSIS setsmtp - set up the SMTP settings setsmtp setsmtp [-v] setsmtp [-s variable= value]... setsmtp -h DESCRIPTION setsmtp(8) sets up the SMTP configuration values. When used without options, you will be prompted to provide the name of the SMTP email server to be used. You will also be prompted for the port and the Reply-To address to be used on outgoing email. Make sure that a valid email address is specified here. You can set up SMTP settings noninteractively using the -s option.
setsmtp(8) OPTIONS The following options are supported: Displays usage statement. -h When used with other options or operands, an error occurs. -s variable=value Sets SMTP. Valid entries for variable are: mailserver port auth user password replyaddress Where: auth is the authentication mechanism. user/password are the smtp mail server authentication. Valid auth entries are: none pop smtp-auth Specifies verbose output.
setsmtp(8) EXAMPLE 4 Setting Up Mailserver With Invalid Authentication Mechanism XSCF> setsmtp Mail Server [10.4.1.1]: Port [25]: Authentication Mechanism [none]: ? Invalid value ’?’. Valid authentication mechanism are: none pop smtp-auth Authentication Mechanism [none]: Reply Address [useradm@company.com]: EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
setsmtp(8) 198 XSCF Reference Manual • Last Revised January 2007
setsnmp(8) NAME SYNOPSIS setsnmp - manage the SNMP agent setsnmp enable [ mib_name] setsnmp disable [ mib_name] setsnmp addtraphost -t type -s community-string [-p trap-port] traphost setsnmp remtraphost -t type traphost setsnmp addv3traphost -u username -r authentication-protocol {-n engine_id|-i} [ -a authentication-password] [ -e encryption-password] [-p trap-port ] traphost setsnmp remv3traphost -u username traphost setsnmp enablev1v2c read-only-community-string setsnmp disablev1v2c setsnmp [-l system-
setsnmp(8) OPERANDS The following operands are supported: addtraphost Enables the SNMP agent to send the chosen type of trap to the desired host. If no trap-port is provided, the default is 162. A community string is mandatory. addtraphost takes the following options and operand: -p trap-port ID of the trap port. Default value is 162. -s community-string Acts like a password to control access to the SNMP v1 and v2 agents. It is a clear text string which can be intercepted.
setsnmp(8) addv3traphost Enables the SNMP agent to send SNMPv3 traps or informs to the desired host. An authentication protocol must be chosen. Valid protocols are: MD5 = Uses the MD5 algorithm for authentication SHA = Uses SHA (Secure Hash Algorithm) for authentication The encryption protocol used in all communication is DES (Data Encryption Standard). If the password option is not used, you will be prompted for a password. Passwords will be read but not echoed to the screen.
setsnmp(8) disable When used alone, stops the SNMP agent. When used with the value ALL for the optional mib_name, stops the SNMP agent. When used with a value other than ALL for the optional mib_name, removes support for the targeted MIB module. If support remains for another MIB module, the SNMP agent remains enabled. If support for both MIB modules is removed, the SNMP agent is disabled and, therefore, stops. You can specify only one value at a time for mib_name.
setsnmp(8) remtraphost Disables the SNMP agent from sending the chosen type of trap to the desired host. -t type Type of trap. Valid trap types are: v1 = The agent will send SNMPv1 traps v2 = The agent will send SNMPv2 traps inform = The agent will send inform notifications traphost Host name of the trap host. remv3traphost Disables the SNMP agent from sending SNMPv3 traps to the desired host. traphost Host name of the trap host. -u username Specifies a valid user name.
setsnmp(8) SEE ALSO 204 showsnmp(8) XSCF Reference Manual • Last Revised January 2007
setsnmpusm(8) NAME SYNOPSIS setsnmpusm - specify the SNMPv3 agent’s User-based Security Model (USM) configuration setsnmpusm create -a authentication_protocol [-p authentication_password] [ -e encyrption_password] user setsnmpusm delete user setsnmpusm clone -u clone_user user setsnmpusm passwd [-c { auth|encrypt}] [ -o old_password] [ -n new_password] user setsnmpusm -h DESCRIPTION Privileges setsnmpusm(8) modifies the SNMP Agent’s USM configuration.
setsnmpusm(8) OPERANDS The following operands are supported: clone 206 Makes the supplied user known to the agent for subsequent SNMP communication with the identical settings as the specified clone_user. -u clone_user Specifies a valid user name of the user settings to be cloned. user Specifies a different user name for the clone of clone_user.
setsnmpusm(8) create Makes the supplied user known to the agent for subsequent SNMP communication. When used without the -a or -p options, create displays a prompt for passwords and reads them without echoing them to the screen. The encryption protocol used in all SNMP communication is Data Encryption Standard (DES). An authentication protocol must be chosen for SNMP comunication. Possible values are MD5 Alogorithm and Secure Hash Algorithm (SHA). user Specifies a valid user name.
setsnmpusm(8) EXAMPLES EXAMPLE 1 Adding a User With Password Options XSCF> setsnmpusm create -a SHA -p xxxxxxxx -e yyyyyyyy jsmith EXAMPLE 2 Adding a User Without Specifying Password Options XSCF> setsnmpusm create -a SHA bob Authetication Password: Encryption Password: EXAMPLE 3 Cloning a User XSCF> setsnmpusm clone -u sue joe Authentication Password: Encryption Password: EXAMPLE 4 Deleting a User XSCF> setsnmpusm delete joe EXIT STATUS SEE ALSO 208 The following exit values are returned: 0
setsnmpvacm(8) NAME SYNOPSIS setsnmpvacm - modify the SNMPv3 agent’s View-based Access Control Model (VACM) configuration setsnmpvacm creategroup -u username groupname setsnmpvacm deletegroup -u username groupname setsnmpvacm createview -s OID_subtree [-e] [-m OID_Mask] viewname setsnmpvacm deleteview -s OID_subtree viewname setsnmpvacm createaccess -r read_viewname groupname setsnmpvacm deleteaccess groupname setsnmpvacm -h DESCRIPTION Privileges setsnmpvacm(8) modifies the SNMP Agent’s VACM configur
setsnmpvacm(8) OPERANDS The following operands are supported: createaccess Sets access to a MIB view for the specified group. creategroup createview -r read_viewname Specifies an SNMP Agent view. groupname Specifies a valid group name. Sets up a group for the specified user for view access. -u username Specifies a valid user name. groupname Specifies a valid group name. Sets up a view of the SNMP Agent exported MIB information. View access is limited to read-only for this Agent.
setsnmpvacm(8) EXAMPLE 2 Create a View of the Entire MIB XSCF> setsnmpvacm createview -s .1 all_view EXAMPLE 3 Create a View Where the Subtree Is Excluded XSCF> setsnmpvacm createview -e -s .1.3.6.1.2.1.1 -m fe excl_view EXAMPLE 4 Create Access XSCF> setsnmpvacm createaccess -r all admin EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
setsnmpvacm(8) 212 XSCF Reference Manual • Last Revised January 2007
setssh(8) NAME SYNOPSIS setssh - set the SSH service used in the XSCF network. Also, generate the host public key, and register or delete the user public key, which are necessary for the SSH service. setssh [ [-q] -{y|n}] -c enable setssh -c disable setssh -c addpubkey [-u user_name] setssh -c delpubkey {-a | -s line } [-u user_name] setssh [ [-q] -{y|n}] -c genhostkey setssh -h DESCRIPTION setssh(8) command starts or stops the SSH service used in the XSCF network.
setssh(8) -c {enable|disable} Specifies whether to enable the SSH service. One of the following values can be specified: OPERANDS 214 Starts the SSH2 service. disable Stops the SSH2 service. -c genhostkey Generates a host public key for SSH2. -h Displays usage statement. When used with other options or operands, an error occurs. -n Automatically answers 'n' (no) to all prompts. -q Suppresses all messages to stdout, including prompts. -s line Specifies the user public key number to delete.
setssh(8) EXAMPLES EXAMPLE 1 Starts the SSH service. XSCF> setssh -c enable The XSCF will be reset. Continue? [y|n] :y Broadcast message from root (pts/4) (Jan 27 16:59:10 2006): The system is going down for reboot NOW! The reset continues after this point. EXAMPLE 2 Starts the SSH service. Automatically replies with 'y' to the prompt. XSCF> setssh -y -c enable The XSCF will be reset.
setssh(8) EXAMPLE 6 Generates a host public key for SSH. Automatically replies with 'y' to the prompt. XSCF> setssh -c genhostkey -y Host key already exists. The key will be updated and the XSCF will be reset. Continue? [y|n] :y Broadcast message from root (pts/4) (Jan 27 16:59:10 2006): The system is going down for reboot NOW! The reset continues after this point. EXAMPLE 7 Generates a host public key for SSH. Automatically replies with 'y' without displaying the prompt.
setssh(8) EXAMPLE 11 Registers the user public key by specifying the user name. Finish the input of public key by pressing Enter and then pressing Ctrl+D. XSCF> setssh -c addpubkey -u efgh Please input a public key: ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAzFh95SohrDgpnN7zFCJCVNy+jaZPTjNDxcid QGbihYDCBttI4151Y0Sv85FJwDpSNHNKoVLMYLjtBmUMPbGgGVB61qskSv/ FeV44hefNCZMiXGItIIpK P0nBK4XJpCFoFbPXNUHDw1rTD9icD5U/wRFGSRRxFI+Ub5oLRxN8+A8=abcd@example.
setssh(8) 218 XSCF Reference Manual • Last Revised January 2007
settelnet(8) NAME SYNOPSIS settelnet - start or stop the Telnet service used in the XSCF network settelnet -c {enable | disable} settelnet -h DESCRIPTION Privileges settelnet(8) command starts or stops the Telnet service used in the XSCF network. You must have platadm privileges to run this command. Refer to setprivileges(8) for more information. OPTIONS The following options are supported: -c {enable|disable} Specify whether to start the Telnet service. One of the following values can be specified.
settelnet(8) 220 XSCF Reference Manual • Last Revised January 2007
settimezone(8) NAME SYNOPSIS settimezone - set the time zone and Daylight Saving Time of XSCF settimezone -c settz -s timezone settimezone -c settz -a [-M] settimezone -c adddst -b std -o offset -d dst [-p offset] -f date [ /time] -t date [ /time] settimezone -c deldst -b std -o offset settimezone -h DESCRIPTION The settimezone(8) command sets the time zone and Daylight Saving Time of XSCF. The time zone is pursuant to POSIX standard.
settimezone(8) -f date [/time] Specifies the starting time of Daylight Saving Time. You can specify date in any of the following formats. Mm.w.d Mm: Specifies the month to start Daylight Saving Time. For m, you can specify any integer from 1 to 12. w: Specifies the week to start Daylight Saving Time. You can specify the integer from 1 to 5, "1" for the first week and "5" for the last week in the month. d: Specifies the day of the week to start Daylight Saving Time.
settimezone(8) -o offset Specifies the offset of time zone and Greenwich mean time (GMT). You can specify offset in the following format. GMT{+|–}hh[:mm[:ss]] GMT Greenwich mean time {+|–} Specifies "–" to set the standard time to the time which is ahead of GMT. (To adjust to the local time east to Greenwich, the offset is a negative value.)Specifies "+" to set the standard time to the time which is behind the GMT. (To adjust to the local tome west to Greenwich, the offset is a positive value.
settimezone(8) -p offset Specifies the offset of Daylight Saving Time and Greenwich mean time (GMT). You can specify offset in the following format. In case omitted, it is 1 hour before the specified time. GMT{+|–}hh[:mm[:ss]] -s timezone 224 GMT Greenwich mean time {+|–} Specifies "–" to set the standard time to the time which is ahead of GMT. (To adjust to the local time east to Greenwich, the offset is a negative value.)Specifies "+" to set the standard time to the time which is behind the GMT.
settimezone(8) -t date [/time] Specifies the termination time of Daylight Saving Time. You can specify date in any of the following formats. Mm.w.d Mm: Specifies the month to terminate Daylight Saving Time. For m, you can specify any integer from 1 to 12. w: Specifies the week to terminate Daylight Saving Time. You can specify the integer from 1 to 5, "1" for the first week and "5" for the last week in the month. d: Specifies the day of the week to terminate Daylight Saving Time.
settimezone(8) EXAMPLE 2 Lists the time zones that can be set. XSCF> settimezone -c settz -a Africa/Abidjan Africa/Accra Africa/Addis_Ababa Africa/Algiers Africa/Asmera Africa/Bamako Africa/Bangui . . EXAMPLE 3 Sets the Daylight Saving Time information as follows: abbreviation of time zone is JST, the offset from GMT is +9, the name of Daylight Saving Time is JDT, Daylight Saving Time is 1 hour ahead, and the time period is from the last Monday of March 2:00 to the last Sunday of October 2:00.
setupfru(8) NAME SYNOPSIS setupfru - set up device hardware setupfru [-m {y | n}] [-x {1 | 4}] device location setupfru -h DESCRIPTION The setupfru(8) command makes hardware settings for the specified device. Only a physical system board (PSB) can be specified as a device. After a PSB is added, the following settings can be specified for PSB: Privileges XSB type To use an added PSB in the system, hardware resources on the PSB must be logically divided and reconfigured as eXtended System Boards (XSBs).
setupfru(8) OPERANDS EXTENDED DESCRIPTION The following operands are supported: device Specifies the device to be set up. Only the following device can be specified: sb Physical system board (PSB) location Specifies the location of the device. sb Integer from 0–15. Specify only one location. ■ In a high-end server, the Quad-XSB configuration cannot be set in memory mirror mode.
showaltitude(8) NAME SYNOPSIS showaltitude - display the altitude state of the system showaltitude showaltitude -h DESCRIPTION The showaltitude(8) command displays the current settings for the altitude state of the system. The displayed altitude value is a multiple of 100 meters. Privileges You must have platadm or fieldeng privileges to run this command. Refer to setprivileges(8) for more information. OPTIONS The following option is supported: Displays usage statement.
showaltitude(8) 230 XSCF Reference Manual • Last Revised January 2007
showarchiving(8) NAME SYNOPSIS showarchiving - display log archiving configuration and status showarchiving showarchiving [-e] [-v] showarchiving -h DESCRIPTION Privileges showarchiving(8) displays the status and configuration information for log archiving on the Service Processor. You must have platadm, platop or fieldeng privileges to run this command. Refer to setprivileges(8) for more information.
showarchiving(8) Username for ssh login User name which the Service Processor uses to login to the archive host. Initial value is Not configured. Archive host public key The public key which the Service Processor uses to verify the identity of the archive host. This field is not displayed unless the -v option is specified. Archive host fingerprint The md5 fingerprint of the public key which the Service Processor uses to verify the identity of the archive host. 2.
showarchiving(8) EXAMPLES EXAMPLE 1 Viewing Status and Configuration Data XSCF> showarchiving *** Archiving Configuration *** Archiving state ---------- Disabled Archive host ------------- Not configured Archive directory -------- Not configured User name for ssh login -- Not configured Archive host fingerprint - Server authentication disabled *** Connection to Archive Host *** Latest communication ----- None Connection status -------- None Archive space limit Archive space used Total archiving failures
showarchiving(8) 234 XSCF Reference Manual • Last Revised January 2007
showaudit(8) NAME SYNOPSIS showaudit - display the current auditing system state showaudit showaudit [all] showaudit [-a users] [-c classes] [-e events] [-g] [-m] [-p] [-s] [-t] showaudit -h DESCRIPTION Privileges showaudit(8) displays the current state of system auditing. When invoked without options showaudit displays whether the writing of audit records is enabled or disabled. You must have auditadm or auditop privileges to run this command. Refer to setprivileges(8) for more information.
showaudit(8) Displays usage statement. -h When used with other options or operands, an error occurs. -m Displays the address to which email is sent when the local audit storage space usages reaches a threshold. -p Displays the policy to follow when the audit trail reaches full capacity. -s Displays the following auditing states: ■ Free space remaining for local audit records ■ Number of audit records dropped (since the last boot) since the audit trail reached full capacity.
showaudit(8) EXAMPLE 3 Displaying All Event Information XSCF> showaudit -e all Events: AEV_AUDIT_START AEV_AUDIT_STOP AEV_ENTER_MODE AEV_EXIT_MODE AEV_LOGIN_BUI AEV_LOGIN_CONSOLE AEV_LOGIN_SSH AEV_LOGIN_TELNET AEV_LOGOUT AEV_AUTHENTICATE AEV_PASSWORD_CHANGE AEV_addboard AEV_addcodlicense AEV_addfru [...] EXIT STATUS SEE ALSO enabled enabled enabled enabled enabled enabled enabled enabled enabled enabled enabled enabled enabled enabled The following exit values are returned: 0 Successful completion.
showaudit(8) 238 XSCF Reference Manual • Last Revised January 2007
showautologout(8) NAME SYNOPSIS showautologout - display the session timeout time of the XSCF shell showautologout showautologout -h DESCRIPTION The showautologout(8) command displays the session timeout time of the XSCF shell. The session timeout time is displayed in units of minutes. If the session timeout time has not been specified with the setautologout(8) command, a time of 10 minutes is set by default.
showautologout(8) 240 XSCF Reference Manual • Last Revised January 2007
showboards(8) NAME SYNOPSIS showboards - display information on an extended system board (XSB) showboards [-v] -a [-c sp] showboards [-v] -d domain_id [-c sp] showboards [-v] xsb showboards -h DESCRIPTION The showboards(8) command displays information on XSBs. This command displays information on XSBs currently configured in or assigned to a domain and information on all mounted XSBs.
showboards(8) Pwr Power status of the XSB n Power is off. y Power is on. Conn Status of the XSB connection to the domain configuration n The XSB is not connected to the domain, or it is located in the system board pool. y The XSB is connected to the domain. Conf Incorporation state of XSB hardware resources into the operating system n The resources are not connected to the operating system. y The resources are incorporated in the operating system.
showboards(8) Privileges You must have one of the following privileges to run this command: platadm, platop, fieldeng Can execute the command for all domains. domainadm, domainmgr, domainop Can execute the command only for accessible domains. Refer to setprivileges(8) for more information. OPTIONS OPERANDS The following options are supported: -a Displays the state of XSBs configured in or assigned to a domain and the state of all mounted XSBs.
showboards(8) EXAMPLE 2 Displays detailed information on all mounted system boards. XSCF> showboards -v -a XSB R DID(LSB) Assignment ---- - -------- ----------00-0 00(00) Assigned 00-1 * 00(01) Assigned 00-2 SP Available 00-3 02(00) Unavailable EXAMPLE 3 Pwr ---y y y y Conn ---y y n n Conf ---y y n n Test ------Passed Passed Passed Unknown Fault -------Normal Normal Normal Normal COD --n n n n Displays information on XSB#00-0.
showcod(8) NAME SYNOPSIS showcod - display Capacity on Demand (COD) configuration information showcod showcod [-v] [-d domain_id] showcod -h DESCRIPTION Privileges showcod(8) displays the COD information which includes the headroom amount, number of installed COD right-to-use (RTU) licenses, the number of COD RTU licenses reserved for domains, and the Chassis Hostid. When used without arguments it displays the current COD information.
showcod(8) EXAMPLE 2 Displaying All COD Information The output shown is what you would see if you had platform privileges.
showcodlicense(8) NAME SYNOPSIS showcodlicense - display the current Capacity on Demand (COD) right-to-use (RTU) licenses stored in the COD license database showcodlicense showcodlicense [-r] [-v] showcodlicense -h DESCRIPTION Privileges showcodlicense(8) displays COD license information stored in the COD license database. When used without options it displays the current licenses. You must have platadm or platop privileges to run this command. Refer to setprivileges(8) for more information.
showcodlicense(8) EXAMPLE 1 Displaying Formatted License Data XSCF> showcodlicense -v Description Ver Expiration Count Status ----------- --- ----------- ----- ------PROC 01 NONE 16 GOOD 01:84000000:000000001:0301010100:16:00000000:xxxxxxxxxxxxxxxxxxxxxx EXAMPLE 2 Displaying Raw License Data XSCF> showcodlicense -r 01:84000000:104:0301010100:3:00000000:xxxxxxxxxxxxxxx EXIT STATUS SEE ALSO 248 The following exit values are returned: 0 Successful completion. >0 An error occurred.
showcodusage(8) NAME SYNOPSIS showcodusage - display the current usage statistics for Capacity on Demand (COD) resources showcodusage showcodusage [-v] [-M] [-p resource|domain|all ] showcodusage -h DESCRIPTION Privileges showcodusage(8) shows current information about COD right-to-use (RTU) licenses in use. By default, this command displays a summary of COD RTU licenses used and installed, along with the current state of each resource. When used without options, it displays the current usage.
showcodusage(8) EXTENDED DESCRIPTION The showcodusage -p resource command displays the following COD usage information for the system: Resource Identifies the type of COD resources available (processors). In Use Specifies the number of COD CPUs currently used in the system. Installed Specifies the number of COD CPUs installed in the system. License Specifies the number of COD RTU licenses installed.
showcodusage(8) EXAMPLES Installed Specifies the number of COD CPU resources installed in the domain. Reserved Specifies the number of COD RTU licenses allocated to the domain. Status Contains one of the following when the -v option is specified: Licensed The domain COD CPU has a COD RTU license and is in use. Unlicensed A COD RTU license for the domain COD CPU could not be obtained and it is not in use. Unused The COD CPU is not in use.
showcodusage(8) EXAMPLE 3 Displaying COD Usage by Resource and Domain: M8000 Server With CMU00 Quad-XSB, CMU02 Uni-XSB XSCF> showcodusage -v Resource In Use Installed Licensed Status -------- ------ --------- -------- -----PROC 0 8 0 OK: 0 available Headroom: 2 Domain/Resource In Use Installed Reserved Status --------------- ------ --------- -------- -----0 - PROC 0 8 0 00-0 - PROC 0 1 CMU00-CPU0 Unused 00-1 - PROC 0 1 CMU00-CPU1 Unused 00-2 - PROC 0 1 CMU00-CPU2 Unused 00-3 - PROC 0 1 CMU00-CPU3 Unused 0
showcodusage(8) EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
showcodusage(8) 254 XSCF Reference Manual • Last Revised January 2007
showconsolepath(8) NAME SYNOPSIS showconsolepath - displays information on the domain console that is currently connected showconsolepath -a showconsolepath -d domain_id showconsolepath -h DESCRIPTION The showconsolepath(8) command displays information on the domain console that is currently connected.
showconsolepath(8) EXTENDED DESCRIPTION EXAMPLES Only one writable console and one or more read-only consoles can be connected to one domain. EXAMPLE 1 Displays console information on all domains that can be accessed.
showdate(8) NAME SYNOPSIS showdate - display the date and time of XSCF showdate [-u] showdate -h DESCRIPTION The showdate(8) command displays the date and time of XSCF. If showdate(8) command is executed with no options, date and time currently set is displayed. If the local date and time are specified, they are set following conversion to coordinated universal time (UTC). After date and time are set, the prompt to confirm the reset of XSCF is displayed.
showdate(8) EXAMPLE 2 Displays the current time in UTC. XSCF> showdate -u Mon Jan 23 05:56:15 UTC 2006 EXIT STATUS SEE ALSO 258 The following exit values are returned: 0 Successful completion. >0 An error occurred.
showdcl(8) NAME SYNOPSIS showdcl - display the current domain component list (DCL) showdcl [-v] -a showdcl [-v] -d domain_id [-l lsb...] showdcl -h DESCRIPTION The showdcl(8) command displays the DCL that has been set by the setdcl(8) command. The DCL is hardware resource information that can be set for a domain or the logical system boards (LSBs) that are components of a domain. An LSB is a board unit recognized by an operating system in a domain.
showdcl(8) LSB LSB number. The displayed number is an integer ranging from 00 to 15. XSB XSB number corresponding to the LSB. The displayed number has the following format: x–y where: x y Status An integer from 00–15. An integer from 0–3. Domain status. One of the following status is displayed: Powered Off Power is off. Panic State A panic occurred, and the domain is in the reset state. Shutdown Started The power-off process is starting.
showdcl(8) If the -v option is specified, the following information is added: Privileges Cfg-policy Degradation range applicable for an error detected during an initial diagnosis of hardware. Any of the following is displayed: FRU Degradation of a component (default) XSB Degradation of an XSB. System Degradation of a domain No-Mem Whether to omit the use of memory on a domain. Either of the following is displayed: True Omits the use of memory on a domain.
showdcl(8) OPTIONS EXTENDED DESCRIPTION EXAMPLES The following options are supported:. -a Displays information that is set for all domains. -d domain_id Specifies the ID of the domain for which information is to be displayed. The domain_id can be 0–23 depending on the system configuration. -h Displays usage statement. When used with other options or operands, an error occurs. -l lsb Specifies the LSB number whose information is to be displayed.
showdcl(8) EXAMPLE 2 Displays details in the domain component list that is set for domain ID 0.
showdcl(8) EXAMPLE 3 Displays details in the domain component lists that are set for all domains.
showdevices(8) NAME SYNOPSIS showdevices - display current information on an eXtended System Board (XSB) showdevices [-v] [-p bydevice | byboard | query | force] xsb showdevices [-v] [-p bydevice | byboard] -d domain_id showdevices -h DESCRIPTION The showdevices(8) command displays the information of the physical devices configured on XSB and their available resources of these devices. The information of available resources can be obtained for the devices managed by the operating system.
showdevices(8) When memory is being disconnected, the following items are displayed: target XSB XSB number at the move destination deleted mem Size of memory which was already deleted (MB) remaining mem Size of remaining memory to be deleted (MB) I/O devices: Privileges device Instance name of I/O device resource Managed resource name usage Description of the instance using resources query Results of an off-line inquiry about resources You must have one of the following privileges to run this
showdevices(8) OPERANDS -p force Predicts system resources deleted from the operating system when a system board is forcibly disconnected by "deleteboard -f" command. If the -p option is omitted, "-p bydevice" is used. -p query Predicts system resources deleted from the operating system when a system board is disconnected by deleteboard command. If the -p option is omitted, "-p bydevice" is used. -v Displays information on all I/O devices, including those that are not management targets.
showdevices(8) EXAMPLES Displays the information of the physical devices configured on the XSB#00-0 and their available resources.
showdevices(8) EXAMPLE 2 Displays detail information of the physical devices and their available resources in domain ID 0.
showdevices(8) 270 XSCF Reference Manual • Last Revised January 2007
showdomainmode(8) NAME SYNOPSIS showdomainmode - display the domain mode showdomainmode -d domain_id showdomainmode -h DESCRIPTION showdomainmode(8) command displays the domain mode that is set for the specified domain. The following states are displayed: Host ID HOST-ID Diagnostic Level Displays the OpenBoot PROM diagnostic level.
showdomainmode(8) EXTENDED DESCRIPTION If the Mode switch on the operator panel is set to"Service", the settings have the following values regardless of the domain mode displayed by the showdomainmode(8) command: ■ Diagnostics Level: operates as the showdomainmode(8) command display ■ Secure Mode: off ■ Autoboot: off The setdomainmode(8) command sets a domain mode. ■ EXAMPLES ■ EXAMPLE 1 Displays the current state of the operation mode for domain ID 0.
showdomainstatus(8) NAME SYNOPSIS showdomainstatus - display the current domain component list (DCL) showdomainstatus -d domain_id showdomainstatus -a showdomainstatus -h DESCRIPTION The showdomainstatus(8) command displays the current status of the specified domain. One of the following states is displayed for each domain: Powered Off Power is off. Panic State A panic occurred, and the domain is in the reset state. Shutdown Started The power-off process is starting.
showdomainstatus(8) Refer to setprivileges(8) for more information. OPTIONS EXAMPLES The following options are supported. -a Displays status information on all domains that can be accessed. -d domain_id Specifies only one ID of the domain to be powered on. domain_id can be 0–23 depending on the system configuration. -h Displays usage statement. When used with other options or operands, an error occurs. EXAMPLE 1 Displays status information on all domains.
showdscp(8) NAME SYNOPSIS showdscp - display the IP addresses assigned to the Domain to Service Processor Communications Protocol (DSCP) showdscp showdscp [-v] [-p] showdscp [-v] [-p] -d domain_id showdscp [-v] [-p] -s showdscp -h DESCRIPTION showdscp(8) displays the IP addresses assigned for DSCP usage, the IP addresses for an individual domain, the Service Processor, or for the entire system. When used without options, it displays current IP data.
showdscp(8) OPTIONS The following options are supported: -d domain_id Displays an individual domain’s IP address. -h Displays usage statement. When used with other options or operands, an error occurs. EXAMPLES -p Generates parsable output. -s Displays the Service Processor’s IP address. -v Specifies verbose output. Prints additional information about internal progress of the program’s operations to the screen. Caution – The IP addresses shown in the following examples are examples only.
showdscp(8) EXAMPLE 1 XSCF> Displaying a Table of All DSCP IP Addresses showdscp DSCP Configuration Network: 10.1.1.0 Netmask: 255.255.255.0 Location ---------XSCF Domain #00 Domain #01 Domain #02 Domain #03 Domain #04 Domain #05 Domain #06 Domain #07 Domain #08 Domain #09 Domain #10 Domain #11 Domain #12 Domain #13 Domain #14 Domain #15 Domain #16 Domain #17 Domain #18 Domain #19 Domain #20 Domain #21 Domain #22 Domain #23 EXAMPLE 2 Address --------10.1.1.1 10.1.1.2 10.1.1.3 10.1.1.4 10.1.1.5 10.1.1.
showdscp(8) EXAMPLE 4 Displaying All DSCP Address Information In a Parsable Form XSCF> showdscp -p Network 10.1.1.0 Netmask 255.255.255.0 XSCF 10.1.1.1 Domain[0] 10.1.1.2 Domain[1] 10.1.1.3 Domain[2] 10.1.1.4 Domain[3] 10.1.1.5 Domain[4] 10.1.1.6 Domain[5] 10.1.1.7 Domain[6] 10.1.1.8 Domain[7] 10.1.1.9 Domain[8] 10.1.1.10 Domain[9] 10.1.1.11 ... EXIT STATUS SEE ALSO 278 The following exit values are returned: 0 Successful completion. >0 An error occurred.
showdualpowerfeed(8) NAME SYNOPSIS showdualpowerfeed - display the current setting of dual power feed mode showdualpowerfeed showdualpowerfeed -h DESCRIPTION The showdualpowerfeed(8) command displays the current setting of dual power feed mode in the system. The showdualpowerfeed(8) command is valid in a midrange server only. The dual power feed mode can be set by the setdualpowerfeed(8) command.
showdualpowerfeed(8) 280 XSCF Reference Manual • Last Revised January 2007
showemailreport(8) NAME SYNOPSIS showemailreport - display the email report configuration data showemailreport [-v ] showemailreport -h DESCRIPTION Privileges showemailreport(8) displays the email reporting configuration data. When used without options, it displays current email report configuration data. You must have platadm or platop privileges to run this command. Refer to setprivileges(8) for more information. OPTIONS The following options are supported: -h Displays usage statement.
showemailreport(8) 282 XSCF Reference Manual • Last Revised January 2007
showenvironment(8) NAME SYNOPSIS showenvironment - display the intake air temperature and humidity, temperature sensor information, voltage sensor information, and fan rotation information about the system showenvironment [-M] [ type] showenvironment -h DESCRIPTION showenvironment(8) command displays the information listed below.
showenvironment(8) EXTENDED DESCRIPTION EXAMPLES For some systems, voltage margin is set for each entire system. In such a case, the voltage margin is displayed along with the value of the voltage sensor. EXAMPLE 1 Displays the intake temperature and humidity of the system. XSCF> showenvironment Temperature:30.71C Humidity:90.05% EXAMPLE 2 Displays temperature information about the system and each component. XSCF> showenvironment temp Temperature:30.71C CMU#0:30.71C CPUM#0-CHIP#0:30.
showenvironment(8) EXAMPLE 3 Displays voltage information about each component. XSCF> showenvironment volt MBU_A 1.0V Power Supply Group:1.010V 1.8V Power Supply Group:1.700V CPUM#0-CHIP#0 1.0V Power Supply Group:1.000V CPUM#1-CHIP#0 1.0V Power Supply Group:1.000V MEMB#0 1.2V Power Supply Group:1.200V 1.8V Power Supply Group:1.700V 2.5V Power Supply Group:2.500V MEMB#1 1.2V Power Supply Group:1.200V 1.8V Power Supply Group:1.700V 2.5V Power Supply Group:2.500V MEMB#2 1.2V Power Supply Group:1.200V 1.
showenvironment(8) EXAMPLE 5 Displays fan rotation information. XSCF> showenvironment Fan FAN_A#0:Low speed #0 1234rpm FAN_A#1:Low speed #0 1234rpm FAN_B#0:High speed #0 5678rpm FAN_B#1:High speed #0 5678rpm PSU#0 fan:High speed #0 1234rpm #1 1234rpm PSU#1 fan:High speed #0 1234rpm #1 1234rpm EXIT STATUS 286 The following exit values are returned: 0 Successful completion. >0 An error occurred.
showfru(8) NAME SYNOPSIS showfru - display the hardware settings of specified device showfru device location showfru -a device showfru -h DESCRIPTION The showfru(8) command displays the hardware settings of specified device by the setupfru(8) command. The command can display the settings of the specified device or of all devices. Only the physical system board (PSB) can be specified as a device. The following settings are displayed: Device Specified device name. Only sb is displayed.
showfru(8) OPERANDS The following operands are supported: device Specifies the device to display. Currently, only the following device can be specified: Physical system board (PSB) sb location EXTENDED DESCRIPTION EXAMPLES Specifies the location of device. If the device is ‘sb’, an integer ranging from 00 to 15 can be specified. The setupfru(8) command makes hardware settings for a device. EXAMPLE 1 Displays the settings of all PSBs.
showhardconf(8) NAME SYNOPSIS showhardconf - display information about field replaceable unit (FRU) installed in the system showhardconf [-u] [-M] showhardconf -h DESCRIPTION showhardconf(8) command displays information about each FRU.
showhardconf(8) EXTENDED DESCRIPTION EXAMPLES When the configuration and status information regarding FRUs and domain information are displayed, for any failed or degraded unit, an asterisk (*) indicating an abnormal unit is displayed along with any of the following states: Status Description Faulted The component is faulty and is not operating Degraded The component is operating. However, either an error has been detected or the component is faulty.
showhardconf(8) + Type:1B; Size:1 GB; MEM#1B Status:Normal; + Code:c1000000000000004572T128000HR3.7A 252b-04123b25; + Type:1B; Size:1 GB; MEM#2A Status:Normal; + Code:c1000000000000004572T128000HR3.7A 252b-04123e20; + Type:1B; Size:1 GB; MEM#2B Status:Normal; + Code:c1000000000000004572T128000HR3.7A 252b-04123822; + Type:1B; Size:1 GB; MEM#3A Status:Normal; + Code:c1000000000000004572T128000HR3.7A 252b-04123724; + Type:1B; Size:1 GB; MEM#3B Status:Normal; + Code:c1000000000000004572T128000HR3.
showhardconf(8) + FRU-Part-Number:CF00300-1701 04 /300-1701-04 PCI#4 Name_Property:; + Ver:16h; Serial:XF019N; Type:Optic; + Connection:IOX@X06M/IOB0; + FRU-Part-Number:CF00501-7040 03 /501-7040-03 ; IOX@X06M Serial:XCX06M; IOB0 Serial:XX00CP; Type:PCI-X; + FRU-Part-Number:CF00501-6938 04 /501-6938-04 LINK Ver:16h; Serial:XF0191; Type:Optic; + FRU-Part-Number:CF00501-7040 03 /501-7040-03 PS0 Serial:DD0250; + FRU-Part-Number:CF00300-1701 04 /300-1701-04 PS1 Serial:DD0166; + FRU-Part-Number:CF00300-1701 04 /3
showhardconf(8) | SWBP | 2 | | MEDBP | 2 | +-----------------------------------+------------+ EXIT STATUS The following exit values are returned: 0 Successful completion. >0 An error occurred.
showhardconf(8) 294 XSCF Reference Manual • Last Revised January 2007
showhostname(8) NAME SYNOPSIS showhostname - display the current host name for the XSCF unit showhostname {-a | xscfu} showhostname -h DESCRIPTION showhostname(8) command displays the current host name for the XSCF unit. The host name is displayed in Fully Qualified Domain Name (FQDN) format. Privileges You must have one of the following privileges to run this command: useradm, platadm, platop, auditadm, auditop, domainadm, domainmgr, domainop, fieldeng Refer to setprivileges(8) for more information.
showhostname(8) EXAMPLE 2 Displays the host name for XSCF unit 0. XSCF> showhostname xscf#0 xscf#0: scf0_hostname.example.com EXIT STATUS SEE ALSO 296 The following exit values are returned: 0 Successful completion. >0 An error occurred.
showhttps(8) NAME SYNOPSIS showhttps - display the status of the HTTPS service set for the XSCF network showhttps showhttps -h DESCRIPTION The showhttps(8) command displays the status of the HTTPS service currently set for the XSCF network. With this command, whether the HTTPS service is operating and the installation status of the information that is necessary for authentication can be checked. If it is installed, the installation date is also displayed.
showhttps(8) EXAMPLES EXAMPLE 1 Displays the status of the HTTPS service.
showldap(8) NAME SYNOPSIS showldap - display the Lightweight Directory Access Protocol (LDAP) configuration for the Service Processor showldap showldap [-c ] showldap -h DESCRIPTION Privileges showldap(8) displays the Service Processor LDAP configuration. When invoked without options, showldap displays all LDAP configuration except for the certificate chain and the password used when binding to the LDAP server. You must have useradm privileges to run this command.
showldap(8) 300 XSCF Reference Manual • Last Revised January 2007
showlocale(8) NAME SYNOPSIS showlocale - display the current setting for the XSCF locale showlocale showlocale -h DESCRIPTION The showlocale(8) command displays the current setting for the XSCF locale. Either of the following is displayed: Privileges C English ja_JP.UTF-8 Japanese You must have one of the following privileges to run this command: useradm, platadm, platop, auditadm, auditop, domainadm, domainmgr, domainop Refer to setprivileges(8) for more information.
showlocale(8) 302 XSCF Reference Manual • Last Revised January 2007
showlocator(8) NAME SYNOPSIS showlocator - display the state of the CHECK LED on the operator panel showlocator showlocator -h DESCRIPTION showlocator(8) command displays the blink state of the CHECK LED on the operator panel. The one of the following state is displayed: Privileges Off Indicates normal operation, which means either the circuit breaker is off or power is not being supplied. Blinking Indicates that the unit is a maintenance target.
showlocator(8) 304 XSCF Reference Manual • Last Revised January 2007
showlogs(8) NAME SYNOPSIS showlogs - display the specified log showlogs [-t time [-T time] | -p timestamp] [-v | -V | -S] [-r] [-M] error showlogs [-t time [-T time] | -p timestamp] [-v] [-r] [-M] event showlogs [-t time [-T time]] [-r] [-M] {power | env} showlogs [-r] [-M] monitor showlogs -d domain_id [-t time [-T time]] [-r] [-M] {console | ipl | panic} showlogs -h DESCRIPTION The showlogs(8) command displays the specified log.
showlogs(8) OPTIONS The following options are supported: -d domain_id Specifies the number of a domain to be displayed. This option can be specified for domain specific log. domain_id can be 0–23 depending on the system configuration. -h Displays usage statement. When used with other options or operands, an error occurs. -M Displays text by page. This option provides a function that is the same as that of the more command. -p timestamp Specifies a timestamp in a log when one log is to be displayed.
showlogs(8) -t time Specifies the start date and time of the display range for log data. It is specified in one of the following formats: yyyy-mm-dd,hh:mm The timestamp is specified in the ’year-month-day, hour:minute’ format. mm/dd/yy,hh:mm The timestamp is specified in the ’month/day/year, hour:minute’ format. Monddhh:mmyyyy The timestamp is specified in the ’month-name, day, hour:minute, year’ format. yyyy-mm-dd,hh:mm:ss The timestamp is specified in the ’year-month-day, hour:minute:second’ format.
showlogs(8) -T time Specifies the end date and time of the display range for log data. It is specified in one of the following formats: yyyy-mm-dd,hh:mm The timestamp is specified in the ’year-month-day, hour:minute’ format. mm/dd/yy,hh:mm The timestamp is specified in the ’month/day/year, hour:minute’ format. Monddhh:mmyyyy The timestamp is specified in the ’month-name, day, hour:minute, year’ format. yyyy-mm-dd,hh:mm:ss The timestamp is specified in the ’year-month-day, hour:minute:second’ format.
showlogs(8) OPERANDS EXTENDED DESCRIPTION The following operands are supported: error Displays the error log. (sometimes includes scan log) power Displays the power log. event Displays the event log. env Displays the temperature and humidity record. monitor Displays the monitoring message log. console Displays the console message log. panic Displays the panic message log. ipl Displays the IPL message log.
showlogs(8) Case where the -V option is specified Date: Mar 30 17:45:31 JST 2005 Code: xxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxx Status: Alarm Occurred: Mar 30 17:45:31.
showlogs(8) Error status Status: Either of the following is displayed: Warning Partial degradation of the unit or warning about the FRU Alarm FRU failure or error Suspected faulty unit FRU: The suspected faulty units that are displayed and delimited by a comma (,) are the units most likely and second most likely to be faulty. If there are three suspected faulty units, asterisk (*) is displayed next to the unit third most likely to be faulty.
showlogs(8) Date: Log collection date and time (month day hour:minute:second time-zone year) The displayed time is the local time. Event: Power status One of the following states is displayed: Cause: Domain Power On The domain power is on. Domain Power Off The domain power is off. System Power On The main unit power is on. System Power Off The main unit power is off. SCF Reset XSCF is in the reset state. Domain Reset XSCF is in the reset state. XIR XSCF is in the reset state.
showlogs(8) Case where the -v option is specified Date Message Mar 30 17:45:31 JST 2005 System power on Switch= Service RCIaddr=000105ff Code=xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx Date: Log collection date and time (month day hour:minute:second time-zone year) The displayed time is the local time.
showlogs(8) Date: Log collection date and time (month day hour:minute:second time-zone year) The displayed time is the local time. Temperature: Intake air temperature Decimal numbers are displayed to two decimal places. The unit is degree Celsius ( C). Humidity: Humidity The displayed numbers are percentages (%). However, nothing is displayed for the midrange server. Power: Power state of the main unit Either of the following states is displayed: ■ Main Line Switch ON The main unit power is on.
showlogs(8) The time in the displayed log collection date and time (month day hour:minute:second time-zone year) is the local time. ■ Panic message log <> Date: Mar 30 18:45:31 JST 2005 DomainID: 00 Mar 30 17:45:31 JST 2005 panic message Mar 30 17:55:31 JST 2005 panic message : [Second line] Date: Panic occurrence date and time (month day hour:minute:second time-zone year) The displayed time is the local time. DomainID: Domain ID domain_id can be 0–23 depending on the system configuration.
showlogs(8) The time in the displayed log collection date and time (month day hour:minute:second time-zone year) is the local time. EXAMPLES EXAMPLE 1 Displays an error log. XSCF> showlogs error Date: Mar 30 12:45:31 JST 2005 Code: 00112233-44556677-8899aabbcceeff0 Status: Alarm Occurred: Mar 30 17:45:31.000 JST 2005 FRU: IOU#0/PCI#3 Msg: offline(vendor=FUJITSU, product=MAJ3182MC) Date: Mar 30 15:45:31 JST 2005 Code: 00112233-44556677-8899aabbcceeff0 Status: Warning Occurred: Mar 30 17:45:31.
showlogs(8) EXAMPLE 4 Displays a power log.
showlogs(8) Note: The codes or messages shown here may differ from those actually displayed. EXIT STATUS 318 The following exit values are returned: 0 Successful completion. >0 An error occurred.
showlookup(8) NAME SYNOPSIS showlookup - display the configuration for authentication and privileges lookup showlookup showlookup -h DESCRIPTION Privileges showlookup(8) displays configuration settings for authentication and privileges. You must have useradm privileges to run this command. Refer to setprivileges(8) for more information. OPTIONS The following option is supported: Displays usage statement.
showlookup(8) 320 XSCF Reference Manual • Last Revised January 2007
showmonitorlog(8) NAME SYNOPSIS showmonitorlog - display the contents of monitoring messages in real time showmonitorlog showmonitorlog -h DESCRIPTION The showmonitorlog(8) command displays the contents of monitoring messages in real time. When the showmonitorlog(8) command is executed, the XSCF shell is occupied for the display of monitoring messages. When a monitoring message is registered, the contents of the message are displayed. To stop the real-time display, press the Ctrl + C key combination.
showmonitorlog(8) 322 XSCF Reference Manual • Last Revised January 2007
shownameserver(8) NAME SYNOPSIS shownameserver - display the registered domain name system (DNS) servers specified on the XSCF network shownameserver shownameserver -h DESCRIPTION Privileges shownameserver(8) command displays the registered DNS servers in the XSCF network. You must have one of the following privileges to run this command: useradm, platadm, platop, auditadm, auditop, domainadm, domainmgr, domainop, fieldeng Refer to setprivileges(8) for more information.
shownameserver(8) 324 XSCF Reference Manual • Last Revised January 2007
shownetwork(8) NAME SYNOPSIS shownetwork - display information of network interfaces for XSCF shownetwork [-M] {-a | -i | interface} shownetwork -h DESCRIPTION shownetwork(8) command displays current information of network interfaces for XSCF. Information on the specified network interface or all the network interfaces can be displayed.
shownetwork(8) OPERANDS The following operand is supported: interface Specifies the network interface whose information is to be displayed. One of the following values can be specified, depending on the system configuration. If this operand is specified with the -a option, the operand is ignored.
shownetwork(8) EXAMPLE 2 Displays the information for XSCF-LAN#1 on XSCF unit 0 in the midrange server. XSCF> shownetwork lan#1 xscf#0-lan#1 Link encap:Ethernet HWaddr 00:00:00:12:34:56 inet addr:192.168.10.11 Bcast: 192.168.10.255 Mask:255.255.255.0 UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:54424 errors:0 dropped:0 overruns:0 frame:0 TX packets:14369 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:20241827 (19.3 MiB) TX bytes:2089769 (1.
shownetwork(8) EXAMPLE 6 Displays the current settings of XSCF network. XSCF> shownetwork -i Active Internet connections (without servers) Proto Recv-Q Send-Q Local Address Foreign Address tcp 0 0 xx.xx.xx.xx:telnet xxxx:1617 EXAMPLE 7 State ESTABLISHED Displays the information for XSCF unit 0 and XSCF unit 1 in the high-end server. XSCF> shownetwork -a xscf#0-lan#0 Link encap:Ethernet HWaddr 00:00:00:12:34:56 inet addr: 192.168.11.10 Bcast: 192.168.11.255 Mask:255.255.255.
shownetwork(8) SEE ALSO applynetwork(8), setnetwork(8) System Administration 329
shownetwork(8) 330 XSCF Reference Manual • Last Revised January 2007
shownotice(8) NAME SYNOPSIS shownotice - display copyright and license information for the eXtended System Control Facility (XSCF) Control Package (XCP) shownotice [-c {copyright|license}] shownotice -h DESCRIPTION Privileges The shownotice(8) command displays by page the copyright and, if available, license files for the XCP. When used without an option, shownotice displays copyright information and any available license information.
shownotice(8) 332 XSCF Reference Manual • Last Revised January 2007
showntp(8) NAME SYNOPSIS showntp - display the NTP servers currently set for the XSCF network showntp {-l | -a | address} showntp -h DESCRIPTION The showntp(8) command displays the NTP servers currently set for the XSCF network.
showntp(8) EXAMPLES EXAMPLE 1 Displays all NTP servers being currently set. XSCF> showntp -a server ntp1.example.com prefer # [1] ntp server name server ntp2.example.com # [2] ntp server name EXAMPLE 2 Confirms synchronization with an NTP server and displays the results. XSCF> showntp -l remote refid st t when poll reach delay offset jitter ======================================================================== *192.168.0.27 192.168.1.56 2 u 27 64 377 12.929 -2.756 1.993 +192.168.0.57 192.168.1.
showpasswordpolicy(8) NAME SYNOPSIS showpasswordpolicy - display the current password settings showpasswordpolicy showpasswordpolicy -h DESCRIPTION Privileges showpasswordpolicy(8) displays the password policy settings. These include default password expiration settings for new accounts, pam_cracklib parameters, and the number of passwords to keep in password history for each user. You must have useradm privileges to run this command. Refer to setprivileges(8) for more information.
showpasswordpolicy(8) 336 XSCF Reference Manual • Last Revised January 2007
showpowerupdelay(8) NAME SYNOPSIS showpowerupdelay - display the current settings for the warm-up time of the system and wait time before system startup showpowerupdelay showpowerupdelay -h DESCRIPTION The showpowerupdelay(8) command displays the current settings for the warmup time of the system and wait time before system startup.
showpowerupdelay(8) 338 XSCF Reference Manual • Last Revised January 2007
showresult(8) NAME SYNOPSIS showresult - display the exit status of the most recently executed command showresult showresult -h DESCRIPTION showresult(8) command displays the exit status of the most recently executed. showresult(8) is convenient for a remote control program to confirm whether the most recently executed command is successfully completed. Privileges No privileges are required to run this command. Refer to setprivileges(8) for more information.
showresult(8) 340 XSCF Reference Manual • Last Revised January 2007
showroute(8) NAME SYNOPSIS showroute - display routing information for an XSCF network interface showroute [-M] [-n] -a | interface showroute -h DESCRIPTION showroute(8) command displays the current routing information for an XSCF network interface. Routing information for the specified network interface or all the network interfaces can be displayed.
showroute(8) OPERANDS The following operand is supported: interface Specifies the network interface whose information is to be displayed. One of the following values can be specified, depending on the system configuration. If this operand is specified with the -a option, the operand is ignored.
showroute(8) EXAMPLE 2 Displays routing information for XSCF-LAN#0 on XSCF unit 0 without the name resolution of host name. XSCF> showroute -n xscf#0-lan#0 Destination Gateway Netmask 192.168.10.0 * 255.255.255.0 default 192.168.10.1 0.0.0.0 EXAMPLE 3 Displays all routing information for XSCF unit 0 and XSCF unit 1 in the highend server. XSCF> showroute -a Kernel IP routing table Destination Gateway 192.168.10.0 * default 192.168.10.
showroute(8) 344 XSCF Reference Manual • Last Revised January 2007
showshutdowndelay(8) NAME SYNOPSIS showshutdowndelay - display the shutdown wait time at power interruption of the uninterruptible power supply (UPS) showshutdowndelay showshutdowndelay -h DESCRIPTION The showshutdowndelay(8) command displays the wait time before the start of system shutdown for when power interruption occurs in a system connected to the UPS. The time set by the setshutdowndelay(8) command is displayed. The default time set is 10 seconds.
showshutdowndelay(8) 346 XSCF Reference Manual • Last Revised January 2007
showsmtp(8) NAME SYNOPSIS showsmtp - display the SMTP configuration information showsmtp showsmtp [ -v ] showsmtp -h DESCRIPTION Privileges showsmtp(8) displays the SMTP configuration. When used without options, it displays current SMTP configuration data. You must have platadm or platop privileges to run this command. Refer to setprivileges(8) for more information. OPTIONS The following options are supported: Displays usage statement. -h When used with other options or operands, an error occurs.
showsmtp(8) 348 XSCF Reference Manual • Last Revised January 2007
showsnmp(8) NAME SYNOPSIS showsnmp - display the configuration information and current status of the SNMP agent showsnmp showsnmp -h DESCRIPTION Privileges showsnmp(8) displays the configuration and information and current status of the SNMP agent. This includes: agent status, port, system location, contact and description, traphosts, SNMP version, and any enabled MIB modules. You must have platadm or platop privileges to run this command. Refer to setprivileges(8) for more information.
showsnmp(8) EXAMPLE 3 XSCF> Displaying SNMP Information for a Enabled System Set Up With SNMPv1/v2c Trap Host showsnmp Agent Status: Agent Port: System Location: System Contact: System Description: Trap Hosts: Hostname -------host1 host2 host3 Port ---162 162 162 Enabled 161 SanDiego jsmith@jupiter.
showsnmpusm(8) NAME SYNOPSIS showsnmpusm - display the current User-based Security Model (USM) information for the SNMP agent showsnmpusm showsnmpusm -h DESCRIPTION Privileges showsnmpusm(8) displays the current USM information for the SNMP agent. You must have platadm or platop privileges to run this command. Refer to setprivileges(8) for more information. OPTIONS The following option is supported: -h EXAMPLES EXAMPLE 1 Displays usage statement.
showsnmpusm(8) 352 XSCF Reference Manual • Last Revised January 2007
showsnmpvacm(8) NAME SYNOPSIS showsnmpvacm - display the current View-based Access Control Access (VACM) information for the SNMP agent showsnmpvacm showsnmpvacm -h DESCRIPTION Privileges showsnmpvacm(8) displays the current VACM information for the SNMP agent. You must have platadm or platop privileges to run this command. Refer to setprivileges(8) for more information. OPTIONS The following option is supported: -h EXAMPLES EXAMPLE 1 Displays usage statement.
showsnmpvacm(8) 354 XSCF Reference Manual • Last Revised January 2007
showssh(8) NAME SYNOPSIS showssh - display the status, host public keys, fingerprint, or user public keys of the SSH service configured for the XSCF network showssh [-c hostkey] [-M] showssh -c pubkey [-u user_name] [-M] showssh -h DESCRIPTION showssh(8) command displays the status, host public keys, fingerprint, or user public keys of the SSH service configured for the XSCF network.
showssh(8) EXTENDED DESCRIPTION EXAMPLES -h Displays usage statement. When used with other options or operands, an error occurs. -M Displays text by page. This option provides a function that is the same as that of the more command. -u user_name Specify the user account name to display the user public key. Should be specified with "-c pubkey." When the -u option omitted, the user public key of the current login user account will be displayed.
showssh(8) EXAMPLE 2 Displays the user public key of the current login user account. XSCF> showssh -c pubkey Public key: 1 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAzFh95SohrDgpnN7zFCJCVNy+jaZPTjNDxcid QGbihYDCBttI4151Y0Sv85FJwDpSNHNKoVLMYLjtBmUMPbGgGVB61qskSv/ FeV44hefNCZMiXGItIIpK P0nBK4XJpCFoFbPXNUHDw1rTD9icD5U/wRFGSRRxFI+Ub5oLRxN8+A8=abcd@example.
showssh(8) 358 XSCF Reference Manual • Last Revised January 2007
showstatus(8) NAME SYNOPSIS showstatus - display the degraded Field Replaceable Units (FRUs) showstatus [-M] showstatus -h DESCRIPTION Privileges showstatus(8) command displays information about degraded units that are among the FRUs composing the system. You must have one of the following privileges to run this command: useradm, platadm, platop, domainadm, domainmgr, domainop, fieldeng Refer to setprivileges(8) for more information.
showstatus(8) EXAMPLE 2 Displays the degraded units. In this example, a memory module on a memory board is degraded because of an error. XSCF> showstatus MBU_B; MEMB#0; * MEM#0A Status:Faulted; EXAMPLE 3 Displays the degraded units. In this example, a CPU memory unit and memory module on a motherboard unit are degraded because of an error. XSCF> showstatus MBU_B Status:Normal; * MEMB#1 Status:Deconfigured; * MEM#3B Status:Deconfigured; EXAMPLE 4 Displays the degraded units.
showtelnet(8) NAME SYNOPSIS showtelnet - display the current status of the Telnet service for the XSCF network showtelnet showtelnet -h DESCRIPTION showtelnet(8) command displays the current status of the Telnet service for the XSCF network. One of the following states is displayed: Privileges enable The Telnet service is enabled. disable The Telnet service is disabled.
showtelnet(8) 362 XSCF Reference Manual • Last Revised January 2007
showtimezone(8) NAME SYNOPSIS showtimezone - display the XSCF time zone and Daylight Saving Time information of current settings showtimezone -c tz showtimezone -c dst showtimezone -h DESCRIPTION The showtimezone(8) command displays the XSCF time zone and Daylight Saving Time information of current settings. It is displayed in the following format. std offset dst[offset2] [from-date[/time] to-date[/time] ] std Abbreviations of time zone. offset Offset time of time zone and Greenwich mean time (GMT).
showtimezone(8) offset2 Offset time of Daylight Saving Time and Greenwich mean time (GMT). Displayed in minus "–" in case the offset is plus, and displayed in plus "+" in case the offset is minus. from-date[/time] The starting time of Daylight Saving Time. Any of the following formats displays from-date. Mm.w.d Mm: Shows the month when Daylight Saving Time starts. Any numeric from 1 to 12 comes in m. w: Shows the week when Daylight Saving Time starts.
showtimezone(8) to-date[/time] The termination time of Daylight Saving Time. Any of the following formats displays to-date. Mm.w.d Mm: Shows the month when Daylight Saving Time terminates. Any numeric from 1 to 12 comes in m. w: Shows the week when Daylight Saving Time terminates. Any numeric from 1 to 5 comes in, "1" for the first week and "5" for the last week in the month. d: Shows the day of the week when start Daylight Saving Time terminates.
showtimezone(8) EXTENDED DESCRIPTION EXAMPLES The settimezone(8) command sets the time zone of the XSCF. EXAMPLE 1 Displays the time zone. XSCF> showtimezone -c tz Asia/Tokyo EXAMPLE 2 Displays the Daylight Saving Time information as follows: the abbreviation of time zone is JST, the offset from GMT is +9, the name of Daylight Saving Time is JDT, Daylight Saving Time is 1 hour ahead, and the time period is from the last Sunday of March 2:00 to the last Sunday of October 2:00.
showuser(8) NAME SYNOPSIS showuser - display user account information showuser showuser [ [-a] [-M] [-p] [-u] [ user]] showuser [ [-a] [-l] [-M] [-p] [-u]] showuser -h DESCRIPTION showuser (8) displays XSCF user account information. If the user argument is specified, showuser displays account information for the specified user. If the user argument is not specified, then showuser displays account information for the current user.
showuser(8) EXAMPLES EXAMPLE 1 Displays Password and Account Validity Information XSCF> showuser -a User Name: jsmith Status: Enabled Minimum: 0 Maximum: 99999 Warning: 7 Inactive: -1 Last Change: Aug 22, 2005 Password Expires: Never Password Inactive: Never Account Expires: Never EXAMPLE 2 Displays Privileges Information XSCF> showuser -p User Name: jsmith Privileges: domainadm@1,3-6,8,9 platadm EXIT STATUS SEE ALSO 368 The following exit values are returned: 0 Successful completion.
snapshot(8) NAME SYNOPSIS snapshot - collect and transfer environment, log, error, and FRUID data snapshot -d device [-r] [-e [-P -{y|n}] [-S time [-E time]] password]] [-L {F|I|R}] [-l] [-v] [ [-q] snapshot -t user@host: directory [-e [-P password]] [-k host-key] [-l] [-L {F|I|R}] [-p password] [-v] [ [-q] -{y|n}] [-S time [-E time]] snapshot -T [-D directory] [-e [-P password]] [-k host-key] [-l] [-L {F|I|R}] [-v] [ [-q] -{y|n}] [-S time [-E time]] snapshot -h DESCRIPTION The snapshot(8) command provi
snapshot(8) Every .zip archive generated by snapshot includes two files generated by snapshot itself. The first file, called README, contains the original name of the .zip archive, the name of the configuration file on the Service Processor used to create the .zip archive, the version of snapshot and whether log-only mode (the -l flag) was used to generate the archive. The second file, called CONFIG, is a copy of the actual configuration file used by snapshot to generate the archive.
snapshot(8) -k host-key Used with the -t or -T option, sets the public key that the Service Processor uses to log in to the network host. This option is not valid with the -d option. Possible values for host-key are as follows: none This literal value specifies that a public key should not be used to authenticate the network host.
snapshot(8) -p password Specifies the user password used to log in to the host using SSH. This option is valid with the -t option, not with the -d or -T options. -q Suppresses all messages to stdout, including prompts. -S time Specifies the start time for the time period for which data is collected. Used with the -E time option for the end time, defines the period of time for which log messages are collected by snapshot.
snapshot(8) connection from the Service Processor to the specified target (after appropriate authentication) and sends the zip data archive through the SSH connection to the target host. The transmission encryption in this mode is provided by SSH. The second mode is USB Device Mode. The data collector is run in this mode when it is invoked with the -d flag. In this mode, the data collector’s output (which is the zip archive) is saved in a file on the USB device.
snapshot(8) EXAMPLE 5 Downloading Using Encryption With Provided Password and No Public Key XSCF> snapshot -t bob@mars.east:/home/bob/logs/x -k none -e -P password Output data will be encrypted. Enter ssh password for user ’bob’ on host ’mars.east’ Setting up ssh connection to remote host... Collecting data into joe@jupiter.west:/home/joe/logs/x/archive.zip Data collection complete. EXAMPLE 6 Downloading Using No Key to Invalid Directory XSCF> snapshot -t sue@saturn.
snapshot(8) EXAMPLE 10 Downloading to External Media Device XSCF> snapshot -d usb0 -r Testing writability of USB device....SUCCESS Ready to remove all files from device ‘usb0’ Are you sure (yes/no) yes Collecting data into /media/usb_msd/jupiter_10.1.1.1_2006-04-17T22-4151.zip Data collection complete. EXAMPLE 11 Limiting Data Collection for Certain Logs to a Date Range XSCF> snapshot -d usb0 -S 2007-01-01,01:00:00 -E 2007-01-31_14- 00-00 Testing writability of USB device....
snapshot(8) 376 XSCF Reference Manual • Last Revised January 2007
switchscf(8) NAME SYNOPSIS switchscf - switch the XSCF unit between the active and standby states switchscf -t {Active | Standby} [-f] switchscf -h DESCRIPTION The switchscf(8) command switches the XSCF unit that the user is currently logged in to, between the active and standby states. If the XSCF unit is duplicated configuration, the switchscf(8) command can be executed.
switchscf(8) EXIT STATUS 378 The following exit values are returned: 0 Successful completion. >0 An error occurred.
testsb(8) NAME SYNOPSIS testsb - perform an initial diagnosis of the specified physical system board (PSB) testsb [ [-q] -{y|n}] [-m diag=mode] location testsb -v [ -y|-n] [-m diag=mode] location testsb -h DESCRIPTION testsb(8) command performs an initial diagnosis of the specified PSB. The configuration of the PSB and operation of each device mounted on the PSB are checked. After the diagnostics, the result is displayed.
testsb(8) ■ ■ XSB is installed in the domain and this domain is in OpenBoot PROM (ok> prompt) status. ■ XSB is installed in the domain and this domain is power ON status, power OFF status, or reset status. ■ The addboard(8), deleteboard(8), or moveboard(8) command is executed for XSB. The displayed diagnostic results of the testsb(8) command are as follows: XSB XSB numbers belonging to the specified PSBs.
testsb(8) EXAMPLE 2 Performs an initial diagnosis of PSB#01 with detailed messages displayed. XSCF> testsb -v 1 Initial diagnosis is about to start. Continue? [y|n] : y SB#01 powered on sequence started. : : XSB Test Fault ---- ------- -------01-0 Passed Normal EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
testsb(8) 382 XSCF Reference Manual • Last Revised January 2007
unlockmaintenance(8) NAME SYNOPSIS unlockmaintenance - forcibly release the locked status of XSCF unlockmaintenance [ [-q] -{y|n}] unlockmaintenance -h DESCRIPTION unlockmaintenance(8) command releases the locked status of XSCF forcibly. Normally, while the maintenance command addfru(8), deletefru(8), or replacefru(8) is in execution, XSCF is in the locked status. After the command complete, the lock is released.
unlockmaintenance(8) EXAMPLE 2 Unlocks the maintenance lock status. Automatically answers "y" to all prompts. XSCF> unlockmaintenance -y This command unlocks the maintenance lock which prevents the multiple execution of maintenance commands. *Never* use this command, except when the lock state remains by some reason. Careless execution of this command causes serious situation because it interrupts the running command and XSCF might not be able to recognize the parts.
version(8) NAME SYNOPSIS version - display firmware version version -c xcp [-v] [-t] version -c {cmu | xscf} [-v] version -h DESCRIPTION The version(8) command displays firmware version. The following versions can be displayed: Privileges xcp The comprehensive version of the XSCF control package (XCP) firmware currently applied to the system. cmu The version of OpenBoot PROM firmware. xscf The version of XSCF firmware. You must have platadm or fieldeng privileges to run this command.
version(8) EXAMPLE 2 Displays the details of the XCP version. XSCF> version -c xcp -v XSCF#0 (Active) XCP0 (Current): 1020 OpenBoot PROM : 01.01.0001 SCF : 01.01.0001 XCP1 (Reserve): 1020 OpenBoot PROM : 01.01.0001 OpenBoot PROM BACKUP #0: 01.01.0001 #1: 01.02.0001 XSCF#1 (Standby) XCP0 (Current): 1020 OpenBoot PROM : 01.01.0001 SCF : 01.01.0001 XCP1 (Reserve): 1020 OpenBoot PROM : 01.01.0001 SCF : 01.01.0001 OpenBoot PROM BACKUP #0: 01.01.0001 #1: 01.02.
version(8) EXAMPLE 6 Displays the detailed version of OpenBoot PROM firmware. XSCF> version -c cmu -v DomainID 00 : 01.01.0001 DomainID 01 : 01.01.0001 DomainID 02 : 01.01.0001 DomainID 03 : 01.01.0001 : DomainID 23: 01.01.0001 XSB#00-0 XSB#00-1 XSB#00-2 XSB#00-3 : XSB#15-3 EXAMPLE 7 : : : : 01.01.0001 01.01.0001 01.01.0001 01.01.0001 (Current), (Reserve), (Current), (Current), 01.01.0001 01.01.0001 01.01.0001 01.01.0001 (Reserve) (Current) (Reserve) (Reserve) : 01.01.0001 (Current), 01.01.
version(8) 388 XSCF Reference Manual • Last Revised January 2007
viewaudit(8) NAME SYNOPSIS viewaudit - display audit records viewaudit viewaudit [-A date-time] [ -B date-time ] [ -c classes] [ -D date-time] [-e events ] [ -i audit-ids] [-l] [ -m del] [ -n] [ -p privilege-results] [ -r return-values ] [ -u users] [-x] viewaudit -h DESCRIPTION Privileges viewaudit(8) displays audit records. When invoked without options, viewaudit displays all current local audit records. When invoked with options, viewaudit displays only the selected records.
viewaudit(8) -B date-time Selects records that occurred before date-time. The datetime argument is in local time. the -A and -B options can be used together to form a range.
viewaudit(8) -c classes Selects records in indicated classes. classes is a commaseparated list of audit classes. A class may be specified by its numeric value or its name. The ACS_ prefix may be omitted. For example, the class of audit related events can be expressed as ACS_AUDIT, AUDIT or 2. The following are valid classes: all Denotes all classes.
viewaudit(8) -i audit-ids Selects records of the indicated audit session identifier. If you become interested in activity reflected in a particular audit record, you might wish to view all the audit records for that session. An audit-id is not persistent and can be reassigned across reboots of the Service Processor. auditids is a comma-separated list of audit session identifiers. The audit-id is the number following the label subject in an audit file.
viewaudit(8) EXAMPLE 2 Displaying User Audit Records XSCF> viewaudit -u jsmith file,1,2006-01-11 10:52:30.391 -05:00,20060111155230.0000000000.jupiter header,37,1,login - telnet,jupiter,2006-01-11 11:31:09.659 -05:00 subject,1,jsmith,normal,ssh 45880 jupiter command,showuser platform access,granted return,0 EXAMPLE 3 Displaying Audit Records for Privileges XSCF> viewaudit -p granted file,1,2006-01-11 10:52:30.391 -05:00,20060111155230.0000000000.
viewaudit(8) EXAMPLE 5 Displaying Audit Records Within a Range of Two Days XSCF> viewaudit -A 20060125 -B +2d file,1,2006-01-26 16:11:52.785 05:00,20060126211152.0000000000.jupiter.west.company.com subject,1,jsmith,normal,ssh 51409 jupiter.west header,56,1,command - showldap,jupiter.west,2006-01-27 21:15:12.416 05:00 subject,4,jblake,normal,telnet 51409 sr1.company.com command,showldap platform access,granted return,0 subject,7,bob,normal,ssh 40952 mars.com header,57,1,command - viewaudit,mars.company.
who(1) NAME SYNOPSIS who - display a list of the user accounts who are logged in to the XSCF who who -h DESCRIPTION who(1) displays a list of the user accounts who are logged in to the XSCF. The following information is displayed: Privileges ■ XSCF user account name ■ Terminal used ■ Idle time ■ Login time ■ Remote host name No privileges are required to run this command. Refer to setprivileges(8) for more information.
who(1) 396 XSCF Reference Manual • Last Revised January 2007
