SPARC Enterprise™ M3000/M4000/M5000/M8000/M9000 Servers XSCF Reference Manual XSCF Control Package (XCP) 109x Manual Code C120-E606-02EN Part No.
2009, 2010, Oracle and/or its affiliates and FUJITSU LIMITED. All rights reserved. Oracle and/or its affiliates and Fujitsu Limited each own or control intellectual property rights relating to products and technology described in this document, and such products, technology and this document are protected by copyright laws, patents, and other intellectual property laws and international treaties.
Avis de non-responsabilité : les seules garanties octroyées par Oracle et Fujitsu Limited et/ou toute société affiliée de l’une ou l’autre entité en rapport avec ce document ou tout produit ou toute technologie décrits dans les présentes correspondent aux garanties expressément stipulées dans le contrat de licence régissant le produit ou la technologie fournis.
Contents Preface Intro vii 1 addboard 9 addcodactivation addcodlicense addfru 15 17 adduser 19 applynetwork cfgdevice 21 29 clockboard console 13 35 37 deleteboard 39 deletecodactivation deletecodlicense deletefru 45 47 deleteuser 49 disableuser 51 dumpconfig enableuser exit 43 53 59 61 flashupdate fmadm fmdump 63 67 69 Contents i
fmstat 77 getflashimage ioxadm man 81 87 97 moveboard 99 nslookup 103 password 105 ping 109 poweroff 111 poweron 115 prtfru 119 rebootxscf 123 replacefru 125 reset 127 resetdateoffset restoreconfig 131 133 restoredefaults sendbreak setad 147 149 setaltitude 157 setarchiving setaudit 141 159 163 setautologout setcod setdate setdcl 169 171 175 179 setdomainmode setdomparam setdscp 185 193 197 setdualpowerfeed setemailreport sethostname ii sethttps 211 setldap 21
setldapssl 221 setlocale 229 setlocator 231 setloginlockout setlookup 233 235 setnameserver setnetwork setntp 237 241 247 setpacketfilters 251 setpasswordpolicy 257 setpowerupdelay setprivileges setroute 261 263 267 setshutdowndelay setsmtp 275 setsnmp 279 setsnmpusm 285 setsnmpvacm setssh 273 289 293 setsunmc settelnet 299 301 settimezone setupfru 303 311 setupplatform showad 313 319 showaltitude 323 showarchiving showaudit 325 329 showautologout showboards showc
showconsolepath showdate 353 355 showdateoffset showdcl 357 361 showdevices 367 showdomainmode 373 showdomainstatus 377 showdscp 379 showdualpowerfeed showemailreport 383 385 showenvironment showfru 387 393 showhardconf 395 showhostname 409 showhttps 411 showldap 413 showldapssl 415 showlocale 419 showlocator 421 showloginlockout showlogs 423 425 showlookup 441 showmonitorlog 443 shownameserver 445 shownetwork shownotice showntp 447 453 455 showpacketfilters 45
showsnmp 475 showsnmpusm 479 showsnmpvacm showssh 483 showstatus 487 showsunmc 489 showtelnet 491 showtimezone showuser 497 snapshot 499 switchscf 507 testsb 481 493 509 traceroute 515 unlockmaintenance version 521 viewaudit who 519 525 533 Contents v
Preface This manual describes how to use the shell command which can be executed in the XSCF environment in SPARC Enterprise M3000/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 M3000/M4000/M5000/M8000/M9000 servers. It is mounted as a firmware on the service processor which is independent from the processor of the system.
Note – Once an XCP version newer than the XCP version supported by this manual is released, only the manuals related to the new XCP version are subsequently updated. You must therefore check the manuals for the latest XCP version in addition to those related to the XCP version you are using. Global Site http://www.fujitsu.com/sparcenterprise/manual/ Japanese Site http://primeserver.fujitsu.com/sparcenterprise/manual/ North American Site https://download.computers.us.fujitsu.
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.
Section Description OPTIONS This section gives the meaning of and how to specify the OPTIONS. In case the OPERANDS required for the OPTIONS, it is described here. To specify multiple 1-character OPTIONS, you may specify the first OPTION followed by the alphabetic part of the second. e.g. fmadm -a -i fmadm -ai OPERANDS This section gives the meaning of and how to specify the OPERANDS. The OPERANDS which follows the OPTIONS are described in "OPTIONS.
Book Titles Manual Codes SPARC Enterprise M4000/M5000 Servers Getting Started Guide C120-E345 SPARC Enterprise M8000/M9000 Servers Getting Started Guide C120-E323 SPARC Enterprise M3000 Server Overview Guide C120-E537 SPARC Enterprise M4000/M5000 Servers Overview Guide C120-E346 SPARC Enterprise M8000/M9000 Servers Overview Guide C120-E324 Important Safety Information for Hardware Systems C120-E391 SPARC Enterprise M3000 Server Safety and Compliance Guide C120-E538 SPARC Enterprise M4000/M50
Book Titles Manual Codes SPARC Enterprise M4000/M5000/M8000/M9000 Servers Capacity on Demand (COD) User’s Guide C120-E336 SPARC Enterprise M3000/M4000/M5000/M8000/M9000 Servers RCI User’s Guide C120-E360 SPARC Enterprise M3000 Server Product Notes Go to the Web SPARC Enterprise M4000/M5000 Servers Product Notes Go to the Web SPARC Enterprise M8000/M9000 Servers Product Notes Go to the Web External I/O Expansion Unit Product Notes C120-E456 SPARC Enterprise M3000/M4000/M5000/M8000/M9000 Servers
■ Remote maintenance Service Book Title Manual Code Enhanced Support Facility User’s Guide for REMCS C112-B067 4. Manual (man page) provided in the system XSCF man page Note – The man page can be referenced on the XSCF Shell, and it provides the same content as the SPARC Enterprise M3000/M4000/M5000/M8000/M9000 Servers XSCF Reference Manual. 5. Documentation and Support on the Web The latest information about other documents and the support for your server are provided on the websites. a.
c. Fault Management MIB (SUN-FM-MIB) definition file http://src.opensolaris.org/source/xref/onnv/onnvgate/usr/src/lib/fm/libfmd_snmp/mibs/ 6. Sun Oracle Software (for Oracle Solaris OS, and so on) Related Manuals http://docs.sun.com 7. Provided in firmware program CD (For maintenance service ) a. Firmware program file (XSCF Control Package (XCP) file) b. XSCF extension MIB (OPL-SP-MIB) definition file 8.
Abbreviated References to Other Documents In this manual, the following abbreviated titles may be used when referring to a systems manual. The following table lists the abbreviations used in this manual.
Models The model names used in this manual are as follows. Server class Model name Entry-level SPARC Enterprise M3000 Midrange SPARC Enterprise M4000 SPARC Enterprise M5000 High-end SPARC Enterprise M8000 SPARC Enterprise M9000 Prompt Notations The following prompt notations are used in the manual.
Software License Some software functions explained in this manual are licensed under public licenses (GNU Public License (GPL), GNU Lesser Public License (LGPL), and others). See Appendix E, "Software License Condition" in SPARC Enterprise M3000/M4000/M5000/ M8000/M9000 Servers XSCF User’s Guide.
xviii SPARC Enterprise Mx000 Servers XSCF Reference Manual • July 2010
Intro(8) NAME DESCRIPTION Intro - list the commands provided by the XSCF firmware Intro(8) command lists the commands provided by the XSCF firmware of the SPARC Enterprise M3000/M4000/M5000/M8000/M9000 servers. Some commands are used in a different way or not supported on your server. For details, refer to the pages of each command.
Intro(8) 2 exit exit the XSCF shell flashupdate update the firmware fmadm fault management configuration tool fmdump view fault management logs fmstat report fault management module statistics getflashimage download a firmware image file ioxadm manage External I/O Expansion Units and add-in cards that contain Energy Storage Modules and are attached to the host system man display manual pages of specified XSCF shell command moveboard move an eXtended System Board (XSB) from the current dom
Intro(8) setarchiving configure the log archiving functionality setaudit manage the system auditing functionality setautologout set the session timeout time of the XSCF shell setcod set up the Capacity on Demand (COD) resources used for domains setdate set the date and time of XSCF setdcl set a domain component list (DCL) setdomainmode set a domain mode setdomparam forcibly rewrite OpenBoot PROM environment variables setdscp set the IP address assignments for the Domain to Service Processo
Intro(8) setpacketfilters set the IP packet filtering rules to be used in the XSCF network setpasswordpolicy manage the system password policy setpowerupdelay set the warm-up time of the system and wait time before system startup setprivileges assign user privileges setroute set routing information for an XSCF network interface setshutdowndelay set the shutdown wait time at power interruption of the uninterruptible power supply (UPS) setsmtp set up the Simple Mail Transfer Protocol (SMTP) settin
Intro(8) 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 showdateoffset display differences between system time and domain times showdcl display the current domain component list (DCL) showdevices display curr
Intro(8) showlookup display the configuration for authentication and privileges lookup showmonitorlog display the contents of monitoring messages in real time shownameserver display the registered domain name system (DNS) servers and the DNS search paths specified on the XSCF network shownetwork display information of network interfaces for XSCF shownotice display copyright and license information for the copyright information for eXtended System Control Facility (XSCF) Control Package (XCP) show
Intro(8) showtimezone display the XSCF time zone and Daylight Saving Time information of current settings showuser display user account information snapshot collect and transfer environment, log, error, and FRUID data switchscf switch the XSCF unit between the active and standby states testsb perform an initial diagnosis of the specified physical system board (PSB) traceroute display the route packets take to the specified network host or the network device unlockmaintenance forcibly release th
Intro(8) 8 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010
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) -d domain_id Specifies the ID of the domain in which an XSB is to be configured or to which it is to be assigned. domain_id can be 0–23 depending on the system configuration. -f Forcibly incorporates into a domain an XSB. Caution – If the -f option is used to forcibly add an XSB 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.
addboard(8) 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. ■ If "-c configure" is specified when either the domain power has been turned off or the Solaris OS is not running, an error occurs. ■ When "-c configure" is specified, hardware diagnosis is performed on the XSB before it is incorporated into the domain. Therefore, command execution may take time.
addboard(8) 12 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009
addcodactivation(8) NAME SYNOPSIS addcodactivation - add a Capacity on Demand (COD) activation key to the COD Hardware Activation database addcodactivation key_signature addcodactivation -h DESCRIPTION addcodactivation(8) adds the specified COD activation key to the COD Hardware Activation database on the Service Processor. This command is not available on the M3000 server. When the key is added, the quantity of headroom is reduced by the quantity provided by the key.
addcodactivation(8) 14 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010
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. The addcodlicense(8) command is not available on the M3000 server. When the license key is added, the quantity of headroom is reduced by the quantity provided by the license key.
addcodlicense(8) SEE ALSO 16 SPARC Enterprise M4000/M5000/M8000/M9000 Servers Capacity on Demand (COD) User’s Guide SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010
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) 18 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008
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 administer 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) EXAMPLES EXAMPLE 1 Creating a New User XSCF> adduser -u 359 jsmith EXIT STATUS SEE ALSO 20 The following exit values are returned: 0 Successful completion. >0 An error occurred.
applynetwork(8) NAME SYNOPSIS applynetwork - apply XSCF network information to the XSCF applynetwork [ [-q] -{y|n}] [-M] applynetwork -h DESCRIPTION applynetwork(8) command applies XSCF network information that has been set to the XSCF. Setting network information on XSCF is a three-step process: 1.
applynetwork(8) EXAMPLES ■ XSCF host name (sethostname(8)) ■ DNS domain name (sethostname(8)) ■ IP address and netmask of XSCF network interface (setnetwork(8)) ■ On M8000/M9000 servers, use the sethostname(8) command to set host names to both xscf#0 and xscf#1. ■ On M3000/M4000/M5000 servers, use the setnetwork(8) command to set xscf#0-lan#0 and xscf#0-lan#1 so that at least one is up. If both are up, they must use different subnets.
applynetwork(8) status :up IP address :10.24.144.214 netmask :255.255.255.0 route :-n 0.0.0.0 -m 0.0.0.0 -g 10.24.144.1 interface :xscf#0-lan#1 status :down IP address : netmask : route : Continue? [y|n] :y Please reset the XSCF by rebootxscf to apply the network settings. Please confirm that the settings have been applied by executing showhostname, shownetwork, showroute and shownameserver after rebooting the XSCF.
applynetwork(8) 24 IP address : netmask : route : interface :xscf#0-if status :down IP address :10.24.100.1 netmask :255.255.255.0 interface :lan#0 status :down IP address : netmask : interface :xscf#1-lan#0 status :up IP address :10.24.144.215 netmask :255.255.255.0 route : -n 0.0.0.0 -m 0.0.0.0 -g 10.24.144.1 interface :xscf#1-lan#1 status :down IP address : netmask : route : interface :xscf#1-if status :down IP address :10.24.100.2 netmask :255.255.255.
applynetwork(8) IP address : netmask : Continue? [y|n] :y Please reset the XSCF by rebootxscf to apply the network settings. Please confirm that the settings have been applied by executing showhostname, shownetwork, showroute and shownameserver after rebooting the XSCF. EXAMPLE 2 Applies the information that has been set for the XSCF network, on M3000/ M4000/M5000 servers. Automatically answers "y" to all prompts.
applynetwork(8) Please confirm that the settings have been applied by executing showhostname, shownetwork, showroute and shownameserver after rebooting the XSCF. EXAMPLE 3 Applies the information that has been set for the XSCF network. Suppresses prompts, and automatically answers "y" to all prompts. XSCF> applynetwork -q -y EXAMPLE 4 Sets the name server and the search path and then applies the XSCF network settings.
applynetwork(8) Continue? [y|n] :y Please reset the XSCF by rebootxscf to apply the network settings. Please confirm that the settings have been applied by executing showhostname, shownetwork, showroute and shownameserver after rebooting the XSCF. EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
applynetwork(8) 28 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010
cfgdevice(8) NAME SYNOPSIS cfgdevice - connect the CD-RW/DVD-RW drive unit and the tape drive unit 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 the CD-RW/DVD-RW drive unit and the tape drive unit to the specified port, disconnects it from the domain, or displays the current status.
cfgdevice(8) SAS-status Connection status between I/O unit and the system. ■ enable/disable: Connection setting between I/O unit and the system. When starting a domain with no I/O unit, the "disable" may be displayed. enable: Yes disable: No ■ up/down: Logical connection between I/O unit and the system. up: Connected. down: Not connected. Privileges You must have platadm or fieldeng privileges to run this command. Refer to setprivileges(8) for more information.
cfgdevice(8) ■ If connection or disconnection is made when the power supply of the system is ON, settings are made immediately after cfgdevice(8) command execution. When the power supply of the system is OFF, connection or disconnection is reserved and settings are made after the power supply is turned on.
cfgdevice(8) EXAMPLES 8-2 disable down enable up 8-4 disable down enable up 8-6 disable down enable up EXAMPLE 1 When the system is being powered off, reserves the connection of the CDRW/DVD-RW drive unit and the tape drive unit to the port 0-0. XSCF> cfgdevice -c attach -p 0-0 Are you sure you want to attach the device [y|n] :y Completed.( Reservation ) EXAMPLE 2 When the system is being powered on, connects the CD-RW/DVD-RW drive unit and the tape drive unit to port 0-0.
cfgdevice(8) drive unit set on the M9000 server with the expansion cabinet. XSCF> cfgdevice -l Current connection for DVD/DAT: port 0-0 Main chassis: port 0-0 Expansion chassis: port 8-0 Expander status Port No.
cfgdevice(8) prompts without displaying messages. XSCF> cfgdevice -q -y -c attach -p 0-0 EXIT STATUS 34 The following exit values are returned: 0 Successful completion. >0 An error occurred.
clockboard(8) NAME SYNOPSIS clockboard - set or display the clock control unit used at system startup clockboard clockboard -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 clockboard(8) command is available only for the M8000/M9000 servers.
clockboard(8) 36 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010
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) -r Sets up a connection to a read-only console. -s escapeChar Specifies an escape character. The default is "#" . The character specified for escapeChar must be enclosed in "" "" (double quotation). The following symbols can be specified for escapeChar: "#", "@", "^", "&", "?", "*", "=", ".", "|" Specified escape character is available only in the session that executed the console(8) command. Automatically answers "y" (yes) to all prompts.
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. The deleteboard(8) command is not available on the M3000 server.
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) EXTENDED DESCRIPTION EXAMPLES ■ You can execute the deleteboard(8) command on a domain that is not running.
deleteboard(8) EXIT STATUS SEE ALSO 42 The following exit values are returned: 0 Successful completion. >0 An error occurred.
deletecodactivation(8) NAME SYNOPSIS deletecodactivation - remove a Capacity on Demand (COD) activation key from the COD Hardware Activation database deletecodactivation [-f] key-signature deletecodactivation -h DESCRIPTION The deletecodactivation(8) command removes the specified COD activation key from the COD Hardware Activation database on the Service Processor. This command is not available on the M3000 server.
deletecodactivation(8) SEE ALSO 44 SPARC Enterprise M4000/M5000/M8000/M9000 Servers Capacity on Demand (COD) User’s Guide SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010
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. The deletecodlicense(8) command is not available on the M3000 server.
deletecodlicense(8) EXIT STATUS SEE ALSO 46 The following exit values are returned: 0 Successful completion. >0 An error occurred.
deletefru(8) NAME SYNOPSIS deletefru - delete a Field Replaceable Unit (FRU) deletefru deletefru -h DESCRIPTION The deletefru(8) command deletes an FRU. The deletefru(8) command is available only for the M8000/M9000 servers. 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.
deletefru(8) 48 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008
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) 50 SPARC Enterprise Mx000 Servers 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) 52 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007
dumpconfig(8) NAME SYNOPSIS dumpconfig - save system configuration information to a file dumpconfig [-v ] [-V ] [ [-q] -{y|n} ] [-e user ] [-p proxy [-t proxy_type ]] url [-P password ]] [-c comment ] [-u dumpconfig -h DESCRIPTION The dumpconfig(8) command saves system configuration information, copying it from the XSCF to a file specified by the user. The information can later be downloaded from that file back to the XSCF using restoreconfig(8).
dumpconfig(8) OPERANDS -P password With -e option, password can be provided on command line. The command will prompt for the password if a password is not provided on command line. -p proxy Specifies the proxy server to be used for transfers. The default transfer type is http, unless modified using the -t proxy_type option. The value for proxy must be in the format servername:port. -q Suppresses all messages to stdout, including prompts.
dumpconfig(8) * Connected to 129.145.155.166 (129.145.155.166) port 8080 * Proxy auth using (nil) with user ’’ * Server auth using Basic with user ’minilla’ > PUT ftp://10.7.79.18/iktest/proxytest-ftp.cfg HTTP/1.1 Authorization: Basic bHdhbmc6bHdhbmc= User-Agent: dumpconfig Host: 10.7.79.18:21 Pragma: no-cache Accept: */* Content-Length: 24720 Expect: 100-continue < HTTP/1.1 100 Continue < HTTP/1.1 200 OK < Server: Sun-Java-System-Web-Proxy-Server/4.
dumpconfig(8) EXAMPLE 3 Dumping the Configuration Using Https XSCF> dumpconfig -V -p 129.145.155.166:8080 http://10.7.79.18/ sollgell/proxytest-https.cfg transfer from ’/tmp/dumpconfig.ZMCI3d’ to ’http://10.7.79.18/iktest/ proxytest-https.cfg’ * About to connect() to 129.145.155.166 port 8080 * Trying 129.145.155.166... * connected * Connected to 129.145.155.166 (129.145.155.166) port 8080 > > PUT http://10.7.79.18/iktest/proxytest-https.cfg HTTP/1.1 User-Agent: dumpconfig Host: 10.7.79.
dumpconfig(8) removing file ’file:///media/usb_msd/proxytest.cfg’ ... done reading database ... ..............*done creating temporary file ... done starting file transfer ...transfer from ’/tmp/dumpconfig.HE1RZa’ to ’file:///media/usb_msd/san-ff1-54.cfg’ done removing temporary file ... done operation completed Unmounted USB device XSCF> EXAMPLE 5 Encrypting and Password Protecting the Configuration XSCF> dumpconfig -v -e -P kamacuras -p 129.145.155.166:8080 http:/ /10.7.79.18/sollgell/proxytest.
dumpconfig(8) 58 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009
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) 60 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007
exit(1) NAME SYNOPSIS DESCRIPTION Privileges exit - exit the XSCF shell exit 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.
exit(1) 62 SPARC Enterprise Mx000 Servers 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. 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 an 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) : XSCF download is started (XSCFU=0,bank=1,XCP version=1082:last version=1080, Firmware Element ID=07:version=01080004:last version=01080000) XSCF download has been completed (XSCFU=0,bank=1,XCP version=1082:last version=1080, Firmware Element ID=07:version=01080004:last version=01080000) XSCF update has been completed (XSCFU=0,bank=1,XCP version=1082:last version=1080) XCP update is started (XCP version=1082:last version=1080) OpenBoot PROM update is started (OpenBoot PROM version=02090000)
flashupdate(8) EXIT STATUS SEE ALSO 66 The following exit values are returned: 0 Successful completion >0 An error occurred.
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 case-close 1.0 active Case-Close Agent fmd-self-diagnosis 1.0 active Fault Manager Self-Diagnosis sysevent-transport syslog-msgs EXIT STATUS SEE ALSO 68 DESCRIPTION 1.0 1.0 active SysEvent Transport Agent active Syslog Messaging Agent 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 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) Sep 06 09:38:10.8584 77435994-5b99-4db8-bdcd-985c7d3ae3e4 LINUX-8000-1N Sep 06 09:57:44.6502 0087d58c-e5b9-415d-91bc-adf7c41dd316 LINUX-8000-1N Sep 06 12:40:59.2801 97de2cef-8ea1-407a-8a53-c7a67e61987a LINUX-8000-1N Sep 06 12:41:10.1076 fa7304f9-c9e8-4cd1-9ca5-e35f57d53b2c LINUX-8000-1N Sep 06 13:01:49.1462 ce550611-4308-4336-8a9a-19676f828515 LINUX-8000-1N Sep 06 15:42:56.6132 0f4b429f-c048-47cd-9d9f-a2f7b6d4c957 LINUX-8000-1N Sep 06 16:07:14.
fmdump(8) nvlist version: 0 scheme = hc hc-name = iox hc-id = 0 (end hc-list[0]) (end detector) IOXserial_no = 123456 class = ereport.io.iox.cp.seeprom0.nresp ena = 0x921b650000000001 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 Sep 29 15:10:09.5652 ereport.io.iox.cp.seeprom0.
fmdump(8) mod-name = sde mod-version = 1.13 (end de) fault-list-sz = 0x1 fault-list = (array of embedded nvlists) (start fault-list[0]) nvlist version: 0 version = 0x0 class = fault.io.iox.cp.
fmdump(8) 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. AUTO-RESPONSE: The diagnosis has been saved in the fault log for examination by Sun. IMPACT: The fault log will need to be manually examined using fmdump(1M) in order to determine if any human response is required.
fmstat(8) NAME SYNOPSIS fmstat - report fault management module statistics fmstat [-a] [ [-s] [-z] [-m module]] [ interval [ count]] fmstat -h DESCRIPTION The fmstat utility can be used by system 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 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) 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 Ctrl-C.
fmstat(8) fmd.thrtotal 0 total number of auxiliary threads fmd.wcnt 0 count of events waiting on queue fmd.wlastupdate 1144424838299131us hrtime of last wait queue update fmd.wlentime 30us total wait length * time product fmd.wtime 30us total wait time on queue fmd.xprtlimit 256 limit on number of open transports fmd.xprtopen 0 total number of open transports fmd.
getflashimage(8) NAME SYNOPSIS getflashimage - download a firmware image file getflashimage [-v] [ [-q] -{y|n}] [-u user] [-p proxy [-t proxy_type]] url getflashimage -l getflashimage [ [-q] -{y|n}] [-d] getflashimage -h DESCRIPTION The getflashimage(8) command downloads a firmware image file for use by the flashupdate(8) command. If any previous image files of the firmware are present on the XSCF unit, they are deleted prior to downloading the new version.
getflashimage(8) OPERANDS The following operands are supported: url Specifies the URL of the firmware image to download. Supported formats for this value include the following: http://server[:port]/path/file https://server[:port]/path/file ftp://server[:port]/path/file file:///media/usb_msd/path/file where the value for file is in one of the following formats: XCPvvvv.tar.gz IKXCPvvvv.tar.gz FFXCPvvvv.tar.gz DCXCPvvvv.tar.gz and vvvv is the four-character version number.
getflashimage(8) Download successful: 46827KB at 1016.857KB/s Checking file... MD5: e619e6dd367c888507427e58cdb8e0a0 EXAMPLE 2 Downloading a Version from an ftp Server XSCF> getflashimage ftp://imageserver/images/FFXCP1041.tar.gz Existing versions: Version FFXCP1040.tar.gz Size 46827123 Date Wed Mar 14 19:11:40 2007 Warning: About to delete existing versions. Continue? [y|n]: y Removing FFXCP1040.tar.gz. 0MB received 1MB received 2MB received ...
getflashimage(8) 1MB received 2MB received ... 43MB received 44MB received 45MB received Download successful: 46827KB at 1016.857KB/s Checking file... MD5: e619e6dd367c888507427e58cdb8e0a2 EXAMPLE 4 Downloading Using a User Name and Password XSCF> getflashimage -u jsmith \ http://imageserver/images/FFXCP1041.tar.gz Existing versions: Version FFXCP1040.tar.gz Size 46827123 Date Wed Mar 14 19:11:40 2007 Warning: About to delete existing versions. Continue? [y|n]: y Removing FFXCP1040.tar.gz.
getflashimage(8) EXAMPLE 5 Downloading From a USB Memory Stick XSCF> getflashimage file:///media/usb_msd/images/FFXCP1041.tar.gz Existing versions: Version Size FFXCP1040.tar.gz 46827123 Date Wed Mar 14 19:11:40 2007 Warning: About to delete existing versions. Continue? [y|n]: y Removing FFXCP1040.tar.gz. Mounted USB device 0MB received 1MB received ... 44MB received 45MB received Download successful: 46827 Kbytes in 109 secs (430.094 Kbytes/sec) Checking file...
getflashimage(8) 86 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008
ioxadm(8) NAME SYNOPSIS ioxadm - manage External I/O Expansion Units and add-in cards that contain Energy Storage Modules and are attached to the host system ioxadm [-f] [-p] [-v] [-M] env [-e] [-l] [-t] [ target [ sensors]] ioxadm [-f] [-p] [-v] [-M] lifetime [ target | -z target] 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 ioxad
ioxadm(8) OPTIONS The following options are supported. -f Forces command execution by ignoring warnings. -h Displays usage statement. When used with other options or operands, an error occurs. -M Displays text by page. -p Displays only parsable output, suppressing headers in that output. Fields are separated by single tabs. -v Displays verbose output. Refer to specific operands for details.
ioxadm(8) OPERANDS The following operands are supported: env [-elt] [target [sensors]] 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. target See target in OPTIONS for a general description and the text below for information specific to env. sensors Specifies sensors about which data is to be displayed.
ioxadm(8) ■ If the -v option is set, verbose output is displayed. In addition to the regular output, the output also includes: the maximum and minimum values supported by the sensors (Max and Min), along with the low and high warning thresholds (Min Alarm and Max Alarm). ■ LED indicators do not support these fields. ■ Fields containing a "–" indicate an unsupported setting. For example, there may be no minimum temperature alarm threshold.
ioxadm(8) list [target] Lists the External I/O Expansion Units under system management. If no target is specified, list displays a list of External I/O Expansion Units, one per line. Each line contains the unique identifier for that box and the host-specific name(s) for its downlink card(s). See EXAMPLE 3. If an External I/O Expansion Unit argument or downlink card path is specified, the command displays a single line with the indicated FRU.
ioxadm(8) poweron target Restores full power to an I/O boat or reenables output from the power supply (PS) that has previously been marked ready-to-remove. When a PSU is newly installed and the power switch is in the on position, or a boat is connected to a powered link card, they automatically power themselves on. However, this command can be used to power a PSU or I/O boat back on that previously had been powered down for removal as long as the power switch is in the on position.
ioxadm(8) IOX@A3B5/PS0 I_DC 2.316 0.289 IOX@A3B5/PS0 S_FAN_ACTUAL 3708.791 40.313 RPM IOX@A3B5/PS0 S_FAN_SET 4500.000 300.000 RPM IOX@A3B5/PS1 T_AMBIENT 28.000 1.000 C IOX@A3B5/PS1 T_CHIP 29.000 1.000 C IOX@A3B5/PS1 T_HOTSPOT 31.000 1.000 C IOX@A3B5/PS1 SWITCH On - IOX@A3B5/PS1 V_12V_ANODE 11.762 0.059 V IOX@A3B5/PS1 V_12V_CATHODE 11.762 0.059 V IOX@A3B5/PS1 V_ISHARE 0.672 0.040 V IOX@A3B5/PS1 I_DC 5.211 0.289 A IOX@A3B5/PS1 S_FAN_ACTUAL 4115.854 49.
ioxadm(8) EXAMPLE 3 Display all External I/O Expansion Units or downlink card paths XSCF> ioxadm list IOX Link 0 Link 1 IOX@0033 IOU#1-PCI#4 IOU#1-PCI#1 IOX@12B4 - IOU#1-PCI#2 - IOU#2-PCI#1 In this example 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.
ioxadm(8) EXAMPLE 7 Show runtime of card with ESM using verbose output XSCF> ioxadm -v lifetime IOU#0-PCI#1 NAC Total Time On IOU#0-PCI#1 1052370 EXAMPLE 8 (% of life) 100 Warning Time Fault Time 1041120 1051200 Clear runtime of card with ESM, show runtime is cleared XSCF> ioxadm lifetime -z IOU#0-PCI#1 XSCF> ioxadm lifetime IOU#0-PCI#1 NAC Total Time On IOU#0-PCI#1 0 EXAMPLE 9 (% of life) 0 Show card with ESM after runtime has been cleared, using verbose output XSCF> ioxadm -v lifetime
ioxadm(8) IOX@X031 LOCATE Fast - LED XSCF> ioxadm env -1 iox@x031/ps1 SERVICE Location Sensor IOX@X031/PS1 SERVICE Value Resolution Units On - LED The External I/O Expansion Unit chassis white LED has an integrated push button. The button can be used to toggle the state of the chassis white locator LED between off and fast. If the push button is used to turn off the locator LED, fast blink FRU service LEDs are cleared.
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 98 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 ■ x An integer from 00–15. y An integer from 0–3. You can execute the moveboard(8) command on a source domain or a destination domain that is not running.
moveboard(8) See the setdcl(8) and showdcl(8) commands for DCL. ■ EXAMPLES EXAMPLE 1 Disconnects XSB#00-0 from the current domain and attaches it to domain ID 1. XSCF> moveboard -d 1 00-0 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 102 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) EXIT STATUS 104 The following exit values are returned: 0 Successful completion. >0 An error occurred.
password(8) NAME SYNOPSIS password - manage user passwords and expiration settings 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. The password is specified in up to 32 characters. The following characters are valid: 1. abcdefghijklmnopqrstuvwxyz 2. ABCDEFGHIJKLMNOPQRSTUVWXYZ 3. 0123456789 4.
password(8) Refer to setprivileges(8) for more information. OPTIONS The following options are supported -e days|date|Never days sets the number of days, starting from today, during which the XSCF account is enabled. days is in the format of a number (0-10730). If the current date plus the number of days exceeds January 2038 the number is considered invalid and the command will fail. date sets the date when the account expires, not exceeding January 2038.
password(8) -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 initial value is 999999. Valid values are integers with value of 0 - 999999999. -n mindays Sets the minimum number of days between password changes. An initial value of zero for this field indicates that you can change the password at any time. Valid values are integers with value of 0 - 999999999.
password(8) 108 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009
ping(8) NAME SYNOPSIS ping - send the ICMP ECHO_REQUEST packets to the network host or the network device ping [-c count] [-q] host ping -h DESCRIPTION The ping(8) command utilizes the ICMP ECHO_REQUEST datagram to elicit an ICMP ECHO_RESPONSE from the specified host or network device. When the ping(8) command normally executed, the network between XSCF and the specified host or network device can be judged as normal. And the network performance can be measured from the result.
ping(8) EXAMPLES EXAMPLE 1 Sends the packet three times to a host named scf0-hostname0. XSCF> ping -c 3 scf0-hostname0 PING scf0-hostname0 (XX.XX.XX.XX): 56 data bytes 64 bytes from XX.XX.XX.XX: icmp_seq=0 ttl=64 time=0.1 ms 64 bytes from XX.XX.XX.XX: icmp_seq=1 ttl=64 time=0.1 ms 64 bytes from XX.XX.XX.XX: icmp_seq=2 ttl=64 time=0.1 ms --- scf0-hostname0 ping statistics --3 packets transmitted, 3 packets received, 0% packet loss round-trip min/avg/max = 0.1/0.1/0.
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) EXTENDED DESCRIPTION ■ 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. ■ If the Solaris OS 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 Solaris OS of the domain is booting.
poweroff(8) EXAMPLE 2 Turns off power to domains with domain IDs 0. XSCF> poweroff -d 0 DomainIDs to power off:00 Continue? [y|n]:y 00:Powering off *Note* This command only issues the instruction to power-off. The result of the instruction can be checked by the "showlogs power". EXAMPLE 3 Forcibly turns off power to domains with domain IDs 0. XSCF> poweroff -f -d 0 DomainIDs to power off:00 The -f option will cause domains to be immediately resets.
poweroff(8) "y" without displaying the prompt. XSCF> poweroff -q -y -d 2 EXIT STATUS SEE ALSO 114 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) ■ When the poweron(8) command is executed, power-on results for each of the specified domains are displayed in the following format: 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 The showdomainstatus(8) command can be used to check whether the power of each domain on the system is on. EXAMPLE 1 Turns on power to all domains.
poweron(8) "y" to the prompt. XSCF> poweron -y -d 0 DomainIDs to power on:00 Continue? [y|n]:y 00:Powering on *Note* This command only issues the instruction to power-on. The result of the instruction can be checked by the "showlogs power". XSCF> EXAMPLE 4 Turns on power to domains with domain IDs 1. Automatically replies with "y" without displaying the prompt. XSCF> poweron -q -y -d 1 EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
poweron(8) 118 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009
prtfru(8) NAME SYNOPSIS prtfru - display FRUID data on the system and External I/O Expansion Unit prtfru [-c] [-l] [-M] [-x] [ container] prtfru -h DESCRIPTION prtfru is used to obtain Field Replaceable Unit Identifier (FRUID) data from the system and External I/O Expansion Unit. 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) /frutree/chassis/iou0/IOU (fru) /frutree/chassis/iou0/IOU/slot3 /frutree/chassis/iou0/IOU/slot3/LINK (container) /frutree/chassis/iou0/IOU/slot3/LINK/iox983392.IOX.iob1.PCIX.
prtfru(8) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#9/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#10/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#11/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#12/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#13/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#14/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#15/MEM (container) /frutree/chassis/XSCFU (container) /frutree/chassis/OPNL (container) /frutree/chassis/PSU#0 (fru
prtfru(8) /frutree/chassis/MBU_B/MEMB#0/MEMB/MEM#2/MEM (container) /frutree/chassis/MBU_B/MEMB#0/MEMB/MEM#3/MEM (container) /frutree/chassis/MBU_B/MEMB#0/MEMB/MEM#4/MEM (container) /frutree/chassis/MBU_B/MEMB#0/MEMB/MEM#5/MEM (container) /frutree/chassis/MBU_B/MEMB#0/MEMB/MEM#6/MEM (container) /frutree/chassis/MBU_B/MEMB#0/MEMB/MEM#7/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#8/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#9/MEM (container
rebootxscf(8) NAME SYNOPSIS rebootxscf - reset the XSCF rebootxscf [ [-q] -{y|n}] rebootxscf -h DESCRIPTION The rebootxscf(8) command resets the XSCF. The settings configured by using the following commands will be applied to XSCF after you reset XSCF by using the rebootxscf(8) command. ■ applynetwork(8) ■ setaltitude(8) ■ setdualpowerfeed(8) ■ sethttps(8) ■ setntp(8) ■ setssh(8) ■ settelnet(8) In the M8000/M9000 servers, both of the active XSCF and the standby XSCF will be reset.
rebootxscf(8) By using the rebootxscf(8) command, you can reset XSCF while the domain is in operation. However, if you set up XSCF to serve as the upper NTP server of the domain, time lag may arise between XSCF and the domain. In such a case, adjust the domain time so that XSCF and the domain will be synchronized. ■ EXAMPLES EXAMPLE 1 Resets the XSCF. XSCF> rebootxscf The XSCF will be reset. Continue? [y|n]:y EXAMPLE 2 Resets the XSCF. Automatically replies with "y" to the prompt.
replacefru(8) NAME SYNOPSIS replacefru - replace a field replaceable unit (FRU) replacefru replacefru -h DESCRIPTION The replacefru(8) command replaces an 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.
replacefru(8) 126 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009
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 Solaris OS 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. panic Instructs the Solaris OS of the domain 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) *Note* This command only issues the instruction to reset. The result of the instruction can be checked by the "showlogs power". EXAMPLE 3 Resets domain ID 0. Suppresses prompts, and automatically answers "y" to all prompts. XSCF> reset -q -y -d 0 por 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) 130 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009
resetdateoffset(8) NAME SYNOPSIS resetdateoffset - reset time of domains to match system time resetdateoffset resetdateoffset -h DESCRIPTION The resetdateoffset(8) command resets the time settings on the domains, managed by each domain clock, to match the time setting of the system, which is managed by the XSCF clock. If you change the time setting on a domain, for example by using the date(1M) command, the time of that domain differs from the time of the system.
resetdateoffset(8) 132 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009
restoreconfig(8) NAME SYNOPSIS restoreconfig - restore the system configuration information previously saved by dumpconfig restoreconfig [-v] [-V] [ [-q] -{y|n}] [-P password] [-s network={yes|no}] [-u user] [-p proxy [-t proxy_type]] url restoreconfig -h DESCRIPTION The restoreconfig(8) command restores to the XSCF the system configuration information previously saved using the dumpconfig(8) command.
restoreconfig(8) OPERANDS -t proxy_type Used with the -p option to specify the type of proxy. Possible values for proxy_type are: http, socks4, and socks5. The default value is http. -u user Specifies the user name when logging in to a remote ftp or http server that requires authentication. You are prompted for a password. -v Displays verbose output. This may be helpful when diagnosing server problems. -V Displays details of network activity.
restoreconfig(8) EXAMPLES EXAMPLE 1 Restoring the Configuration using FTP XSCF> restoreconfig -V -u manilla 129.145.155.156:8080 ftp:/ 10.7.79.18/sollgell/proxytest-ftp.cfg transfer from ’/tmp/dumpconfig.EvY1Yf’ to ’ftp://10.7.79.18/sollgell/ proxytest-ftp.cfg’ Password: * About to connect() to 129.145.155.166 port 8080 * Trying 129.145.155.166... * connected * Connected to 129.145.155.166 (129.145.155.
restoreconfig(8) EXAMPLE 2 Restoring the Configuration Using http XSCF> restoreconfig -V -p 129.145.155.166:8080 http://10.7.79.18/ sollgell/proxytest.cfg transfer from ’/scf/firmtmp/hcp/config/config_file.bin’ to ’http://10.7.79.18/sollgell/proxytest.cfg’ * About to connect() to 129.145.155.166 port 8080 * Trying 129.145.155.166... * connected * Connected to 129.145.155.166 (129.145.155.166) port 8080 GET http://10.7.79.18/sollgell/proxytest.cfg HTTP/1.1 User-Agent: restoreconfig Host: 10.7.79.
restoreconfig(8) EXAMPLE 3 Restoring the Configuration Using https XSCF> restoreconfig -v -V https://10.7.79.18/sollgell/ proxytest.cfg obtaining lock ... done initiating file transfer from ’https://10.7.79.18/sollgell/proxytest.cfg’ ... transfer from ’/scf/firmtmp/hcp/config/config_file.bin’ to ’https://10.7.79.18/ sollgell/proxytest.cfg’ * About to connect() to 10.7.79.18 port 443 * Trying 10.7.79.18... * connected * Connected to 10.7.79.18 (10.7.79.
restoreconfig(8) < ETag: "4fa2a-601b-4897602f" < Accept-Ranges: bytes < Content-Length: 24603 < Content-Type: text/plain * Connection #0 to host 10.7.79.18 left intact * Closing connection #0 done file decoding done.
restoreconfig(8) ... transfer from ’/scf/firmtmp/hcp/config/config_file.bin’ to ’http://10.7.79.18/sollgell/proxytest.cfg’ * About to connect() to 10.7.79.18 port 80 * Trying 10.7.79.18... * connected * Connected to 10.7.79.18 (10.7.79.18) port 80 GET /sollgell/proxytest.cfg HTTP/1.1 User-Agent: restoreconfig Host: 10.7.79.18 Pragma: no-cache Accept: */* < HTTP/1.1 200 OK < Date: Wed, 13 Aug 2008 23:29:42 GMT < Server: Apache/1.3.36 (Unix) mod_perl/1.29 mod_ssl/2.8.27 OpenSSL/0.9.
restoreconfig(8) EXIT STATUS 140 The following exit values are returned: 0 Successful completion. >0 An error occurred.
restoredefaults(8) NAME SYNOPSIS restoredefaults - delete the setting and the log information that stored in the server or the XSCF unit, and restore it to the state as of the factory shipment restoredefaults -c range restoredefaults -h DESCRIPTION The restoredefaults(8) command deletes the setting and the log information that stored in the server or the XSCF unit, and restores it to the state as of the factory shipment.
restoredefaults(8) EXAMPLES EXAMPLE 1 Restores the XSCF unit to the state as of the factory shipment. XSCF> restoredefaults -c xscfu WARNING: If this system does not have OPNL, this command will set all the user settable XSCF configuration parameters to their default value as they were set when the system was shipped out. Furthemore, this command will delete all logs on both XSCFUs. Check the man page of this command before you run it.
restoredefaults(8) setdefaults : XSCF clear : dbs[282]: NOTICE: received setdefaults : XSCF clear : ... setdefaults : XSCF clear : setdefaults : XSCF clear : setdefaults : XSCF clear : setdefaults : complete unmount filesystem start signal: 15 unmount /hcp0/linux unmount /hcpcommon/firmtmp -unmount filesystem complete end complete Please turn off the breaker after XSCF halt. The system is going down NOW !! Please stand by while rebooting the system. Restarting system.
restoredefaults(8) XSCF will be automatically rebooted. Afterwards, XSCFU will be initialized. Continue?[yes/no](default no):yes The NVRAM setting of XSCFU#0 was completed. XSCF shutdown request was completed. ....XSCF reboot.. ***** WARNING ***** XSCF initialization terminate for XSCF/OPNL data clear.
restoredefaults(8) EXIT STATUS The following exit values are returned: 0 Successful completion. >0 An error occurred.
restoredefaults(8) 146 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008
sendbreak(8) NAME SYNOPSIS sendbreak - send a break signal to the specified domain sendbreak -d domain_id sendbreak [ [-q] -{y|n}] -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 Solaris OS of the domain, control is transferred from the Solaris OS to OpenBoot PROM and the OpenBoot PROM prompt "ok" is displayed.
sendbreak(8) 148 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009
setad(8) NAME SYNOPSIS setad - configure Active Directory setad enable|disable setad loadcert [[-q] -{y|n}] [-i n] [-u URI username] [-p proxy [-t proxy_type]] setad loadcert [[-q] -{y|n}] [-i n] console setad rmcert [[-q] -{y|n}] [-i n] setad group administrator -i n name [ groupname] setad group operator -i n name [ groupname] setad group custom -i n name [ groupname] setad group custom -i n roles [ privileges] setad userdomain -i n [ domainname ] setad defaultrole [ privileges] setad timeout second
setad(8) OPTIONS OPERANDS The following options are supported: -h Displays usage statement. When used with other options or operands, an error occurs. -i n Sets an index marker, value 1 - 5. -n Automatically answers "n" (no) to all prompts. -p Specifies the proxy server to be used for transfers. The default transfer type is http, unless modified using the -t proxy_type option. The value for proxy must be in the format servername:port. See EXAMPLE 8.
setad(8) group administrator Assign group name for up to five specified administrator groups. The administrator group has platadm, useradm, and auditadm privileges and you cannot change that. group operator Assign group name for up to five specified operator groups. The operator group has platop and auditop privileges and you cannot change that. group custom Assign group name and privileges for up to five groups. userdomain Configure the specified user domain.
setad(8) logdetail 152 Enable logging of Active Directory authentication and authorization diagnostic messages at the specified detail level. This log is for use in troubleshooting and is cleared on SP reboot. Level can be one of the following: none Do not log diagnostic messages.
setad(8) EXAMPLES strictcertmode Enable or disable strictcertmode mode. This mode is disabled by default; the channel is secure, but limited validation of the certificate is performed. If strictcertmode is enabled, the server’s certificate must have already been uploaded to the server so that the certificate signatures can be validated when the server certificate is presented. Data is always protected, even if strictcertmode is disabled. Strictcertmode applies to primary and alternate servers alike.
setad(8) -----END CERTIFICATE----- CTRL-D XSCF> EXAMPLE 6 Configures user domain 2. is a template that must be entered exactly as shown. During authentication the user’s login name replaces . userdomain can take the form of UPN or Distinguished Name (DN). XSCF> setad userdomain -i 2 '@yoshi.example.aCompany.com' EXAMPLE 7 Loads a server certificate for Active Directory using the specified URI.
setad(8) substitution marker. XSCF> setad dnslocatorquery -i 2 '_ldap._tcp.gc._msdcs..' EXAMPLE 15 Configures the default privileges, where privileges are the same as those used in the setad group custom roles command. XSCF> setad defaultrole platadm platop EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
setad(8) 156 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010
setaltitude(8) NAME SYNOPSIS setaltitude - set the altitude of the system or whether or not the air filter installed setaltitude -s key=value setaltitude -h DESCRIPTION The setaltitude(8) command sets the altitude of the system or whether or not the air filter installed. Whether or not the air filter installed can be specified on the M4000/M5000 servers only. Privileges You must have platadm or fieldeng privileges to run this command. Refer to setprivileges(8) for more information.
setaltitude(8) EXAMPLES ■ To apply the specified configuration, execute the rebootxscf(8) command and reset XSCF. ■ The command does not accept negative numbers. If the system is below sea-level use altitude=0. ■ When you specified either of the altitude of the system or whether or not the air filter installed, the current settings are listed. The setting of the air filter is displayed only when it is set to installed.
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: -h Displays usage statement. 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) The following are valid classes: all Denotes all classes.
setaudit(8) -g enable|disable Sets the global user audit record generation policy. When set to disable, no audit record which can be attributed to any user account is generated. These settings can be overridden on an individual user basis using the -a option. -h Displays usage statement. When used with other options or operands, an error occurs. -m mailaddr Sets the mail address to which email is sent when the local audit storage space usage reaches a threshold (see option -t).
setaudit(8) OPERANDS EXAMPLES The following operands are supported: archive Notifies the log archiving facility to archive the current audit trail. delete Delete the portion of the local audit trail in the secondary partition. This can be used to free space for new audit records if the local audit trail becomes full. For more information on the secondary partition, refer to the Administration Guide for your server.
setaudit(8) Warnings will be sent at 50% capacity and 75% capacity. EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
setaudit(8) 168 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008
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) 170 SPARC Enterprise Mx000 Servers 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] setcod [[-q] -{y|n}] [-v] headroom setcod [-v] -d domain_id [ proc-permits] setcod -h DESCRIPTION setcod(8) sets up the COD resources to be used for domains. COD Hardware Activation keys must be installed before COD boards in a domain can be utilized. You can also enable headroom and reserve COD Hardware Activation permits for some domains with setcod(8).
setcod(8) OPERANDS EXTENDED DESCRIPTION The following operands are supported: headroom Amount of headroom (processors) to be enabled. Maximum value is 4. proc-permits The number of COD permits reserved for a domain. One COD permit is required for each CPU. If you run the setcod command without specifying any options, the command prompts you for COD information. You are asked to specify the amount of COD headroom to be used, and the number of COD permits to be reserved for your domains.
setcod(8) PROC Permits reserved for domain 13 (0 MAX) [0]: PROC Permits reserved for domain 14 (0 MAX) [0]: PROC Permits reserved for domain 15 (0 MAX) [0]: After this command completes, you will see a message similar to this one in the XSCF console: Aug 28 17:28:30 FF1-1-0 codd[PID]: COD PROC Headroom changed to 3 EXAMPLE 2 Set the COD Headroom CPUs to 0 XSCF> setcod 0 EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
setcod(8) 174 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010
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). After the command executed, XSCF will be reset automatically. 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 can be executed only while all domains are powered off. ■ When an NTP server has been set to XSCF, the setdate(8) command results in an error. 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 XSCF> 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) 178 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010
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 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. An LSB is a board unit recognized by the Solaris OS in 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. On the M3000 server, you cannot specify this option. -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.
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 3 Sets policy=system for domain ID 0. XSCF> setdcl -d 0 -s policy=system 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) 184 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008
setdomainmode(8) NAME SYNOPSIS setdomainmode - set the modes of operation for the specified domain setdomainmode [ [-q] -{y|n}] -d domain_id -m function=mode setdomainmode -h DESCRIPTION setdomainmode(8) sets the modes of operation for the specified domain. The modes of operation for the specified domain include the following types: Diagnostics Level OpenBoot PROM diagnostic levels. The default is standard.
setdomainmode(8) ■ Host watchdog and suppress break signal reception, auto boot function, and operational mode of CPU: platadm Can run this command for all domains. domainadm Can run this command only for your managed domains. Refer to setprivileges(8) for more information. OPTIONS 186 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.
setdomainmode(8) -m function=mode Sets the modes of operation and specifies its values. Use function to set the modes of operation. One of the following can be specified: diag Specifies the OpenBoot PROM diagnostic level. secure Specifies whether to enable or disable the host watchdog and suppress break signal reception. autoboot Specifies whether to enable or disable the Auto boot function. cpumode Sets the operational mode of CPU.
setdomainmode(8) (continued) When cpumode is specified for function, one of the following can be specified for mode: Note – When the domain is in any status other than powered off, it results in an error. auto Automatically determines the operational mode of CPU at domain startup.
setdomainmode(8) Domain CPU configuration Value of CPU Mode Current CPU operational mode CPU configuration of a system board which can be added by DR operation SPARC64 VII compatible SPARC64 VI compatible mode Any CPU configuration SPARC64 VII/VI auto or compatible SPARC64 VI compatible mode Any CPU configuration SPARC64 VI auto or compatible SPARC64 VI compatible mode Any CPU configuration For details of the CPU operational mode and the DR operation, see the DR User’s Guide.
setdomainmode(8) ■ EXAMPLES The settings of the current modes of operation for the specified domain can be checked by using the showdomainmode(8) command. When you use the showdomainmode(8) command after the setdomainmode(8) command, it will display the pending modifications performed by the setdomainmode(8), which might not yet be effective. EXAMPLE 1 Sets the OpenBoot PROM diagnostic level for domain ID 0 to none.
setdomainmode(8) EXAMPLE 3 Cancels the setdomainmode(8) command execution that is in progress. XSCF> setdomainmode -d 0 -m diag=none Diagnostic Level :min -> none Secure Mode :on -> - Autoboot :on -> - CPU Mode :auto -> - The specified modes will be changed. Continue? [y|n]:n EXAMPLE 4 Enables the auto boot function for domain ID 0.
setdomainmode(8) 192 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008
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 of a specified domain. The following OpenBoot PROM environment variables can be specified.
setdomparam(8) OPERANDS The following operands are supported: use-nvramrc Sets false for the use-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.
setdomparam(8) EXIT STATUS The following exit values are returned: 0 Successful completion. >0 An error occurred.
setdomparam(8) 196 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009
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) Domain #11 address [10.1.1.13 ] > [Enter] Domain #12 address [10.1.1.14 ] > [Enter] Domain #13 address [10.1.1.15 ] > [Enter] Domain #14 address [10.1.1.16 ] > [Enter] Domain #15 address [10.1.1.17 ] > [Enter] Domain #16 address [10.1.1.18 ] > [Enter] Domain #17 address [10.1.1.19 ] > [Enter] Domain #18 address [10.1.1.20 ] > [Enter] Domain #19 address [10.1.1.21 ] > [Enter] Domain #20 address [10.1.1.22 ] > [Enter] Domain #21 address [10.1.1.
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. Note – The ability to enable and disable dual power feed is available on M3000/ M4000/M5000 servers only. However, dual power feed mode cannot be used with 100V power on M4000/M5000 servers.
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 202 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 [-v] [-t] setemailreport [-s variable= value]... setemailreport -h DESCRIPTION setemailreport(8) sets up email reporting configuration data for remote maintenance. Once 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 4 Enable Email Reporting Noninteractively XSCF> setemailreport -s enable=yes -s recipient=”useradm@company.com, adm2@company.com” 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) 206 SPARC Enterprise Mx000 Servers 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. In M8000/M9000 servers, 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. Refer to setprivileges(8) for more information.
sethostname(8) OPERANDS EXTENDED DESCRIPTION EXAMPLES The following operands are supported: hostname Specifies a host name to be set for the XSCF unit. The hostname is specified in up to 64 characters, not in Fully Qualified Domain Name (FQDN) but in an abbreviated form. If a host name exceeding 64 characters is specified, an error occurs. Alphanumeric character and "-" can be used. However, a host name must always begin with an alphabetic character and end with an alphanumeric character.
sethostname(8) SEE ALSO applynetwork(8), setnameserver(8), showhostname(8) System Administration 209
sethostname(8) 210 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010
sethttps(8) NAME SYNOPSIS sethttps - start or stop the HTTPS service, which is used in the XSCF network.
sethttps(8) OPTIONS The following options are supported: -c {enable|disable} OPERANDS 212 Specify whether to enable the HTTPS service. One of the following values can be specified. If none of them is specified, an error occurs. 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) organization Specifies a company name and so on using up to 64 characters. If "-c selfsign" is specified, the value with only spaces is not allowed. organizationalunit Specifies an organization such as a section or department using up to 64 characters. state|province Specifies the name of a state, province, and so on using up to 64 characters. If "-c selfsign" is specified, the value with only spaces is not allowed.
sethttps(8) ■ The size of the file to be generated by sethttps(8) grows with total character count typed in the operands of configuring the self-certification authority and creating a self-signed web server certificate, and creating a CSR. If the file to be generated is too large for XSCF, the command fails with an error. If you see this error, reduce the number of characters in the operands and execute the sethttps(8) command again.
sethttps(8) EXAMPLE 5 Creates the private key of the web server. XSCF> sethttps -c genserverkey Server key already exists. Do you still wish to update? [y|n] :y Enter passphrase: Verifying - Enter passphrase: EXAMPLE 6 Creates the private key of the web server. Automatically replies with "y" to the prompt. XSCF> sethttps -c genserverkey -y Server key already exists.
sethttps(8) 5A51Yuhf8OGrR+bYGli6H1a6RPmlMSD7Z0AGDxR0eY0CAwEAAaOCAQ0wggEJMAkG A1UdEwQCMAAwLAYJYIZIAYb4QgENBB8WHU9wZW5TU0wgR2VuZXJhdGVkIENlcnRp ZmljYXRlMB0GA1UdDgQWBBQHIlCmI7QyZa8zpt1Hl6EfLR+EwDCBrgYDVR0jBIGm MIGjgBTnQYs6jzD7wdDhk7wsFeJGVaUTtaGBh6SBhDCBgTELMAkGA1UEBhMCamox DjAMBgNVBAgTBXN0YXRlMREwDwYDVQQHEwhsb2NhbGl0eTEVMBMGA1UEChMMb3Jn YW5pemF0aW9uMQ8wDQYDVQQLEwZvcmdhbmkxDzANBgNVBAMTBmNvbW1vbjEWMBQG CSqGSIb3DQEJARYHZWUubWFpbIIBADANBgkqhkiG9w0BAQQFAAOBgQCqBFbo88Hi yvOUyW8E8ll1AbuA04IrnjHI4cjHq9NuSX1w8mJsXKTV
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 3 Setting the LDAP Timeout XSCF> setldap -T 60 XSCF> showldap Bind Name: user Base Distinguished Name: ou=people,dc=company,dc=com LDAP Search Timeout: 60 Bind Password: Set LDAP Servers: None CERTS: None 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.
setldap(8) EXIT STATUS SEE ALSO 220 The following exit values are returned: 0 Successful completion. >0 An error occurred.
setldapssl(8) NAME SYNOPSIS setldapssl - configure LDAP/SSL setldapssl enable|disable setldapssl loadcert [[-q] -{y|n}] [-i n] [-u username] [-p proxy [-t proxy_type]] URI setldapssl loadcert [[-q] -{y|n}] [-i n] console setldapssl rmcert [[-q] -{y|n}] [-i n] setldapssl group administrator -i n name [ groupname] setldapssl group operator -i n name [ groupname] setldapssl group custom -i n name [ groupname] setldapssl group custom -i n roles [ privileges] setldapssl userdomain -i n [ domainname ] setldapss
setldapssl(8) OPTIONS OPERANDS The following options are supported: -h Displays usage statement. When used with other options or operands, an error occurs. -i n Sets an index marker, value 1 - 5. -n Automatically answers "n" (no) to all prompts. -p Specifies the proxy server to be used for transfers. The default transfer type is http, unless modified using the -t proxy_type option. The value for proxy must be in the format servername:port. See EXAMPLE 12.
setldapssl(8) group administrator Assign group name for up to five specified administrator groups. The administrator group has platadm, useradm, and auditadm privileges and you cannot change that. group operator Assign group name for up to five specified operator groups. The operator group has platop and auditop privileges and you cannot change that. group custom Assign group name and privileges for up to five groups. userdomain Configure the user domain.
setldapssl(8) logdetail 224 Enable logging of LDAP/SSL authentication and authorization diagnostic messages at the specified detail level. This log is for use in troubleshooting and is cleared on SP reboot. Level can be one of the following: none Do not log diagnostic messages.
setldapssl(8) usermapmode Enable or disable use of the usermap. When enabled, user attributes specified with the usermap operand, rather than userdomain, are used for user authentication.
setldapssl(8) EXAMPLE 5 Loads certificate information for Alternate Server 4 from the console. XSCF> setldapssl loadcert -i 4 console Warning: About to load certificate for Alternate Server 4: . Continue? [y|n]: y Please enter the certificate: -----BEGIN CERTIFICATE----MIIETjCCAzagAwIBAgIBADANBgkqhkiG9w0BAQQFADB8MQswCQYDVQQGEwJVUzET MBEGA1UECBMKQ2FsaWZvcm5pYTESMBAGA1UEBxMJU2FuIERpZWdvMRkwFwYDVQQK ExBTdW4gTWljcm9zeXN0ZW1zMRUwEwYDVQQLEwxTeXN0ZW0gR3JvdXAxEjAQBgNV ...
setldapssl(8) 8080 . XSCF> setldapssl loadcert -p webproxy.aCompany.com:8080 http://domain_2/UID_2333/testcert EXAMPLE 13 Loads a server certificate for LDAP/SSL using a username and password. XSCF> setldapssl loadcert -u yoshi http://domain_2/UID_2333/testcert EXAMPLE 14 Sets logging of high-severity diagnostic messages. XSCF> setldapssl logdetail high EXAMPLE 15 Clears diagnostic messages from the log file, answering Yes to all prompts.
setldapssl(8) 228 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010
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) 230 SPARC Enterprise Mx000 Servers 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 232 The following exit values are returned: 0 Successful completion. >0 An error occurred.
setloginlockout(8) NAME SYNOPSIS setloginlockout - enable or disable login lockout feature setloginlockout -s time setloginlockout -h DESCRIPTION Privileges The setloginlockout(8) command sets the amount of time, in minutes, that users are prevented from logging into their accounts after the third unsuccessful login attempt. You must have useradm privileges to run this command. Refer to setprivileges(8) for more information.
setloginlockout(8) EXIT STATUS SEE ALSO 234 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) EXIT STATUS SEE ALSO 236 The following exit values are returned: 0 Successful completion. >0 An error occurred.
setnameserver(8) NAME SYNOPSIS setnameserver - set the domain name system (DNS) servers and the DNS search paths used in the XSCF network setnameserver [-c add] address ... setnameserver -c del address ... setnameserver -c del -a setnameserver -c addsearch domainname... setnameserver -c delsearch domainname... setnameserver -c delsearch -a setnameserver -h DESCRIPTION The setnameserver(8) command specifies the DNS servers and DNS search paths used in the XSCF network.
setnameserver(8) OPERANDS -c del Deletes specified DNS servers. If the -c option is omitted, "-c add" is assumed specified. When deleting multiple DNS servers, the servers are deleted in the order they are specified. See EXAMPLE 3. -c delsearch Deletes specified DNS search path. If the -c option is omitted, "-c add" is assumed specified. When deleting multiple DNS search paths, the search paths are deleted in the order they are specified. -h Displays usage statement.
setnameserver(8) EXAMPLES ■ The DNS domain name (set by the sethostname(8) command) and search path (set by the setnameserver(8) command) together can contain up to 256 characters. ■ To change the DNS servers and the DNS search paths in XSCF, execute the applynetwork(8) command. Then, use the rebootxscf(8) command to reset XSCF, completing the change. ■ 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.
setnameserver(8) EXAMPLE 7 Deletes all the registered domain names from the DNS search path. XSCF> setnameserver -c delsearch -a EXIT STATUS SEE ALSO 240 The following exit values are returned: 0 Successful completion. >0 An error occurred.
setnetwork(8) NAME SYNOPSIS setnetwork - set or remove an XSCF network interface setnetwork [-m addr] interface address setnetwork -c {up | down} interface setnetwork [ [-q] -{y|n}] -r interface setnetwork -h DESCRIPTION setnetwork(8) command sets or removes an XSCF network interface. The following settings can be made for the specified network interface: ■ Whether to enable or disable the network interface.
setnetwork(8) OPTIONS The following options are supported: -c {up|down} Specifies whether to enable the specified network interface. One of the following values can be specified. If none of them is specified, an error occurs. up down Enables the network interface. Disables the network interface. -h Displays usage statement. When used with other options or operands, an error occurs. -m addr Specifies a netmask. To specify addr, use the standard form of four integer values delimited by "." (periods).
setnetwork(8) interface Specifies the network interface to be configured. One of the following values can be specified: ■ In M3000/M4000/M5000 servers: For XSCF unit 0: xscf#0-lan#0 XSCF-LAN#0 xscf#0-lan#1 XSCF-LAN#1 For abbreviation: lan#0 an abbreviation of XSCF-LAN#0 lan#1 an abbreviation of XSCF-LAN#1 ■ In M8000/M9000 servers: Specifying the -c or -r option and Inter SCF Network (ISN) together, it results in errors.
setnetwork(8) ■ After you set the network interface, if you disable that network interface and execute the applynetwork(8) command, the setting data of IP address and netmask will be stored in XSCF. When you enable the network interface, the setting of IP address and netmask will be used.
setnetwork(8) ■ EXAMPLES To reflect information on the specified network interface, execute the applynetwork(8) command and reset XSCF. EXAMPLE 1 Sets the IP address 192.168.10.10 and netmask 255.255.255.0 for XSCF-LAN#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 netmask 255.255.255.0 for XSCF-LAN#0 on XSCF unit 0 in an M3000/M4000/M5000 server. XSCF> setnetwork lan#0 -m 255.255.255.0 192.168.10.
setnetwork(8) EXIT STATUS SEE ALSO 246 The following exit values are returned: 0 Successful completion. >0 An error occurred.
setntp(8) NAME SYNOPSIS setntp - set the NTP servers used on the XSCF network, the stratum value, the preferred server and the clock address of the local clock of XSCF setntp [-c add] address ... setntp -c del address ... setntp -c del -a setntp -c stratum -i stratum_no setntp -m type= value setntp -h DESCRIPTION setntp(8) command sets the NTP information for XSCF. The setntp(8) command can specify the following information: Privileges ■ The NTP servers which are used on the XSCF network.
setntp(8) -h Displays usage statement. When used with other options or operands, an error occurs. -i stratum_no Specifies the stratum value. This option is used together with the "-c stratum". An integer from 1 to 15 can be specified. If the stratum value not specified, it is 5. -m type=value Sets the preferred server or the local clock of XSCF.
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 host names can be specified by delimited the spaces. Host name, if specified, must be resolvable. 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 apply the ntp settings. EXAMPLE 4 Deletes the first NTP server whose IP address is 192.168.1.2. This case is when a NTP server is listed multiple times. XSCF> showntp -a server 192.168.1.2 server 10.18.108.10 server 192.168.1.2 XSCF> setntp -c del 192.168.1.2 XSCF> showntp -a server 10.18.108.10 server 192.168.1.
setpacketfilters(8) NAME SYNOPSIS setpacketfilters - set the IP packet filtering rules to be used in the XSCF network setpacketfilters [ [-q] -{y|n}] -c {add | del} [-i interface] [-s address [ /mask]] -j target setpacketfilters [ [-q] -{y|n}] -c clear setpacketfilters -h DESCRIPTION The setpacketfilters(8) command sets the IP packet filtering rules to be used in the XSCF network. IP packet filtering rules can be used to prevent illegal access to the XSCF network.
setpacketfilters(8) -i interface Specifies the XSCF network interface to which you set the IP packet filtering rules. Any of the following can be set.
setpacketfilters(8) -s address[/mask] Specifies the sender of the IP packet. Either an IP address or a network IP address with a netmask (/mask) added can be specified. To specify an IP address or a network IP address, use the standard form of four integer values delimited by "." (periods). For example, use xxx.xxx.xxx.xxx, where xxx is an integer from 0-255. Zero suppression can be used to specify the integer.
setpacketfilters(8) NOTE: applied IP packet filtering rules. Continue? [y|n] :y XSCF> EXAMPLE 2 On M3000/M4000/M5000 servers, communication to xscf#0-lan#0 exclusively accepts those IP packets sent from the 192.168.100.0/255.255.255.0 network. XSCF> setpacketfilters -c add -s 192.168.100.0/255.255.255.0 -i xscf#0-lan#0 -j ACCEPT -s 192.168.100.0/255.255.255.0 -i xscf#0-lan#0 -j ACCEPT NOTE: applied IP packet filtering rules.
setpacketfilters(8) EXAMPLE 4 Clears all IP packet filtering rules which have been set. XSCF> setpacketfilters -c clear (none) NOTE: applied IP packet filtering rules. Continue? [y|n] :y XSCF> EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
setpacketfilters(8) 256 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010
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 system password policy. These policies are enforced by XSCF on the Service Processor.
setpasswordpolicy(8) -k difok Sets the minimum number of new characters (characters which were not present in the old password) that a new password must contain. The initial setting is 3. Valid values are integers with value of 0 - 999999999. -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 0 - 999999999.
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. Valid values are integers with value of 0 - 999999999. 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.
setpasswordpolicy(8) 260 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009
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) EXAMPLE 2 Sets the wait time before system startup to 20 minutes. XSCF> setpowerupdelay -c wait -s 20 EXIT STATUS SEE ALSO 262 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 unique users to whom privileges can be assigned. Each of the 100 unique user can be assigned more than one privilege.
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) SEE ALSO 266 setpasswordpolicy(8), showuser(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008
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. To specify address, use the standard form of four integer values delimited by "." (periods). For example, use xxx.xxx.xxx.xxx, where xxx is an integer from 0-255. Zero suppression can be used to specify the integer. If you omitted the -m option, or if the destination IP address is other than 0.0.0.0 and you specified 0.0.0.
setroute(8) OPERANDS The following operand is supported: interface Specifies the network interface to be set with routing information.
setroute(8) EXAMPLES ■ To reflect the routing information to XSCF, execute the applynetwork(8) command. After reflected the information, use the rebootxscf(8) command to reset XSCF to complete the setting. ■ The showroute(8) command can display the current routing information that is set for the XSCF network. EXAMPLE 1 Adds the routing of destination 192.168.1.0 and netmask 255.255.255.0 for XSCF-LAN#0 on XSCF unit 0. XSCF> setroute -c add -n 192.168.1.0 -m 255.255.255.
setroute(8) EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
setroute(8) 272 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010
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) 274 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008
setsmtp(8) NAME SYNOPSIS setsmtp - set up the Simple Mail Transfer Protocol (SMTP) settings setsmtp [-v] setsmtp [-s variable= value]... setsmtp -h DESCRIPTION setsmtp(8) sets up the SMTP configuration values. When used without options, this command prompts for the name of the SMTP email server to be used, and for the port and the Reply-To address to be used on outgoing email. Make sure that a valid email address is specified here. The -s option lets you specify SMTP settings noninteractively.
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: mailserver is specified by IP address or server name. Server name, if specified, must be resolvable. port is the port address for replies. auth is the authentication mechanism. Valid values are: none, pop, and smtp-auth.
setsmtp(8) EXAMPLE 3 Setting Up SMTP Authentication in Interactive Mode XSCF> setsmtp Mail Server [10.4.1.1]: Port [25]: Authentication Mechanism [none]: smtp-auth User Name []: jsmith Password []: ****** Reply Address [useradm@company.com]: EXAMPLE 4 Setting Up Mailserver With Invalid Authentication Mechanism XSCF> setsmtp Mail Server [10.4.1.1]: Port [25]: Authentication Mechanism [none]: ? Invalid value ’?’.
setsmtp(8) 278 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009
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 -l system-location Specifies the system location for the agent. -p agent-port Specifies the listening port for the agent. The default is 161. -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. For password encryption and no visibility, use addv3traphost instead. The following operands are supported: addtraphost Enables the SNMP agent to send the chosen type of trap to the desired host.
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) default Stops the SNMP agent and changes the SNMP configuration to the factory default settings. After using this option, SNMP must be configured again before the SNMP agent is restarted. When used with default, the command also stops the SNMP agent for Sun MC in servers running Sun MC.
setsnmp(8) enable When used alone, activates the SNMP agent with support for all MIB modules. When used with the value ALL for the optional mib_name, activates the SNMP agent with support for all MIB modules. When used with a value other than ALL for the optional mib_name, adds support for the targeted MIB module and, if necessary, activates the SNMP agent. You can specify only one value at a time for mib_name. mib_name Name of the MIB module to be enabled.
setsnmp(8) EXAMPLES EXAMPLE 1 Setting Up System Information XSCF> setsnmp -l sandiego -c username@company.
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 286 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 communication. Possible values are MD5 Algorithm 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 288 The following exit values are returned:
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 configu
setsnmpvacm(8) OPERANDS The following operands are supported: createaccess creategroup createview deleteaccess Sets access to a MIB view for the specified group. -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) 292 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007
setssh(8) NAME SYNOPSIS setssh - configure the settings for the Secure Shell (SSH) service used in the XSCF network setssh [ [-q] -{y|n}] -c enable setssh -c disable setssh [ [-q] -{y|n}] -m dscp= mode setssh -c addpubkey [-u user_name] setssh -c delpubkey {-a | -s line } [-u user_name] setssh [ [-q] -{y|n}] -c genhostkey setssh -h DESCRIPTION The setssh(8) command configures the settings for the SSH service used in the XSCF network. Only SSH2 is supported for XSCF.
setssh(8) OPTIONS EXTENDED DESCRIPTION 294 The following options are supported: -a Deletes all registered user public keys. Should be specified with "-c delpubkey." -c addpubkey Registers the user public key. -c delpubkey Deletes the user public key. -c {enable|disable} Specifies whether to enable the SSH service. One of the following values can be specified: enable Starts the SSH service. disable Stops the SSH service. -c genhostkey Generates a host public key for SSH2.
setssh(8) ■ The setssh(8) command can register one user public key at a time. ■ In time of setssh(8) command execution, finish the input of user public key by pressing Enter and then pressing "Ctrl" and "D" (EOF). ■ In case the XSCF unit is duplicated configuration, the setting automatically reflected to the standby XSCF. When there is a defect on the standby XSCF, it leads to an error and the setting will be reflected to the active XSCF only.
setssh(8) EXAMPLE 6 Generates a SSH2 host public key, even if one already exists. Automatically replies with "y" to the prompt. XSCF> setssh -c genhostkey -y Host key already exists. The key will be updated. Continue? [y|n] :y Please reset the XSCF by rebootxscf to apply the ssh settings. EXAMPLE 7 Generates a host public key for SSH2. Automatically replies with "y" without displaying the prompt. XSCF> setssh -c genhostkey -q -y EXAMPLE 8 Registers the user public key.
setssh(8) EXAMPLE 10 Specifies the public key number to delete the user public key. XSCF> setssh -c delpubkey -s 1 1 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAzFh95SohrDgpnN7zFCJCVNy+jaZPTjNDxcid QGbihYDCBttI4151Y0Sv85FJwDpSNHNKoVLMYLjtBmUMPbGgGVB61qskSv/ FeV44hefNCZMiXGItIIpK P0nBK4XJpCFoFbPXNUHDw1rTD9icD5U/wRFGSRRxFI+Ub5oLRxN8+A8=abcd@example.com EXAMPLE 11 Deletes all user public keys. XSCF> setssh -c delpubkey -a EXAMPLE 12 Restricts access from domain to the SSH service via DSCP.
setssh(8) 298 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009
setsunmc(8) NAME SYNOPSIS setsunmc - start or stop the Sun Management Center agent and make changes to its configuration setsunmc [enable|disable] setsunmc [-s server] [-z seed] [-p agent_port] [-c community_string] [-t trap_port] [-e event_port] [-a SNMP_agent_port] [-d dmn_agent_port] setsunmc [-h] DESCRIPTION When invoked with one or more options, setsunmc makes changes to the Sun Management Center agent configuration, as described in the Options section.
setsunmc(8) OPERANDS EXAMPLES -s server Specifies the Sun Management Center server with which the agent will be communicating. The server can be specified using either a host name or an IP address. It must be set prior to enabling the agent. -t trap_port Specifies the port on the Sun Management Center server to which traps are sent. The default value is 162. -z seed Specifies the seed to generate a security key for communication between Sun Management Center server and agent.
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} EXAMPLES enable Starts the Telnet service. disable Stops the Telnet service.
settelnet(8) EXIT STATUS SEE ALSO 302 The following exit values are returned: 0 Successful completion. >0 An error occurred.
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 provided by default is pursuant to POSIX standard.
settimezone(8) -d dst Specifies the zone name of Daylight Saving Time. For dst, specify the alphabets of 3 letters or more. You can specify it in the format which complies with RFC2822. Specify this option in combination with "-c adddst." -f date [/time] Specifies the starting time of Daylight Saving Time. It should be specified in the same format as date in the -t option. You can specify date in any of the following formats. Mm.w.d Mm: Specifies the month to start Daylight Saving Time.
settimezone(8) -o offset Specifies the offset of time zone and Greenwich mean time (GMT). Specify this option in combination with "-c adddst" or "-c deldst." 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.
settimezone(8) -p offset Specifies the offset of Daylight Saving Time and Greenwich mean time (GMT). Specify this option in combination with "-c adddst." In case omitted, it is 1 hour ahead of the offset time that specified using the -o option. You can specify offset in the following format. GMT{+|–}hh[:mm[:ss]] -s timezone 306 GMT Greenwich mean time {+|–} Specifies "–" to set the standard time to the time which is ahead of GMT.
settimezone(8) -t date [/time] Specifies the termination time of Daylight Saving Time. It should be specified in the same format as date in the -f option. 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.
settimezone(8) EXAMPLES ■ The addition of the offset time to the standard time which has been set by the settimezone(8) command comes to GMT. ■ The current time zone settings can be checked by using the showtimezone(8) command. ■ To apply the Daylight Saving Time information modified by the "-c adddst" or the "-c adddst" option, log out of XSCF and then log in again. EXAMPLE 1 Sets "Asia/Tokyo" as the time zone.
settimezone(8) the first Sunday of April 0:00(JST) to the first Sunday of September 0:00(JDT). XSCF> settimezone -c adddst -b JST -o GMT-9 -d JDT -p GMT-10 -f M4.1.0/00:00:00 -t M9.1.0/00:00:00 JST-9JDT-10,M4.1.0/00:00:00,M9.1.0/00:00:00 EXAMPLE 5 Deletes the Daylight Saving Time information of current settings. XSCF> settimezone -c deldst -b JST -o GMT-9 EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
settimezone(8) 310 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009
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. The setupfru(8) command is not supported on the M3000 server. Only a physical system board (PSB) can be specified as a device.
setupfru(8) OPERANDS The following operands are supported: device Specifies the device to be set up. Only the following device can be specified: sb location Specifies the location of the device. sb EXTENDED DESCRIPTION EXAMPLES Physical system board (PSB) Integer from 0–15. Specify only one location. ■ In the M8000/M9000 server, the Quad-XSB configuration cannot be set in memory mirror mode.
setupplatform(8) NAME SYNOPSIS setupplatform - set up platform specific settings setupplatform [-v] setupplatform [-v] -p part [-p part] setupplatform -h DESCRIPTION The setupplatform(8) command sets up platform specific settings. The command leads an administrator through Service Processor installation tasks. By default, setupplatform command walks through each of the available settings. Individual settings may be selected using the -p option.
setupplatform(8) In user setup, a new local user account can be created with a user supplied password. In network setup, the following items can be optionally configured: EXAMPLES ■ XSCF Network Settings ■ Internal DSCP Network ■ DNS ■ NTP ■ SSH ■ HTTPS Server ■ Email reports EXAMPLE 1 Creating a New User.
setupplatform(8) xscf#0-lan#0 ip address: 192.168.1.4 xscf#0-lan#0 netmask: 255.255.254.0 xscf#0-lan#0 default gateway: 192.168.1.1 Are these settings correct? [y|n]: y XSCF> setnetwork xscf#0-lan#0 -m 255.255.254.0 192.168.1.4 . . . EXAMPLE 3 Enabling ssh.
setupplatform(8) are switched on again. Do you want to reboot the XSCF now? [y|n]: n XSCF> EXAMPLE 5 Setting the Time Zone.
setupplatform(8) Enter number to choose time zone or return for next set of time zones: 21 XSCF time zone: Africa/Freetown Is this setting correct? [y|n]: y XSCF> settimezone -c settz -s Africa/Freetown Africa/Freetown XSCF> EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
setupplatform(8) 318 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010
showad(8) NAME SYNOPSIS showad - show Active Directory configuration and messages showad showad cert [-v] [-i n] showad log [-M] [-C] [-S start_record_number] [-E end_record_number] showad log -f showad group administrator [-i n] showad group operator [-i n] showad group custom [-i n] showad userdomain [-i n] showad dnslocatorquery [-i n] showad defaultrole showad server [-i n] showad -h DESCRIPTION Privileges showad(8) displays Active Directory configuration and diagnostic messages.
showad(8) OPERANDS EXAMPLES -C Appends to end of output the number of records in the log. -E Specifies the last record number to display, where end_record_number can be any record number in the log. Use -C to obtain the number of records in the log. -M Displays text by page, like the more(1) command does. -S Specifies the first record to display, where start_record_number can be any record number in the log. Use -C to obtain the number of records in the log.
showad(8) valid from = Apr 18 05:38:36 2009 GMT valid until = Apr 16 05:38:36 2019 GMT version = 3 (0x02) EXAMPLE 3 Displays specified diagnostic messages.
showad(8) 322 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009
showaltitude(8) NAME SYNOPSIS showaltitude - display the altitude of the system and whether the air filter installed showaltitude showaltitude -h DESCRIPTION The showaltitude(8) command displays the current settings for the altitude of the system and whether the air filter installed. Whether the air filter installed is displayed on the M4000/M5000 servers only. The displayed altitude value is a multiple of 100 meters. Privileges You must have platadm or fieldeng privileges to run this command.
showaltitude(8) 324 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008
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) Archive host fingerprint - Server authentication disabled *** Connection to Archive Host *** Latest communication ----- None Connection status -------- None AUDIT LOGS OTHER LOGS ---------- ---------- Unlimited 2000 MB Not monitored Not monitored Total archiving failures 0 0 Unresolved failures 0 0 Archive space limit Archive space used EXAMPLE 2 XSCF> Displaying Archiving Error Information showarchiving -e No archiving errors have occurred.
showarchiving(8) 328 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised March 2008
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) OPTIONS The following options are supported: -a users Displays the audit record generation policy for the specified users. users is a comma-separated list of valid user names. -c classes Displays the audit record generation policy for the specified audit classes. classes is a comma-separated list of audit classes. A class may be specified by its numeric value or its name. The ACS_ prefix may be omitted.
showaudit(8) -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. The following operands are supported: Displays the following information: all EXAMPLES Space consumed by local audit records Displays the thresholds at which to issue warning(s) about local storage usage.
showaudit(8) EXAMPLE 3 Displaying All Event Information XSCF> showaudit -e all Events: AEV_AUDIT_START enabled AEV_AUDIT_STOP enabled AEV_ENTER_MODE enabled AEV_EXIT_MODE enabled AEV_LOGIN_BUI enabled AEV_LOGIN_CONSOLE enabled AEV_LOGIN_SSH enabled AEV_LOGIN_TELNET enabled AEV_LOGOUT enabled AEV_AUTHENTICATE enabled AEV_addboard enabled AEV_addfru enabled [...] EXIT STATUS SEE ALSO 332 The following exit values are returned: 0 Successful completion. >0 An error occurred.
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) 334 SPARC Enterprise Mx000 Servers 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) Assignment Pwr Conn 336 Domain assignment state of the XSB. Either of the following is displayed: Unavailable The XSB cannot be used. The XSB may be unrecognizable because it is not mounted, it contains an error, it has been assigned to another domain, or the settings of the domain or system board are not complete. Available The XSB is registered on the DCL and can be used. The XSB may be located in the system board pool. Assigned The XSB is reserved for or assigned to the domain.
showboards(8) Conf Test Fault Incorporation state of XSB hardware resources into the Solaris OS n The resources are not connected to the Solaris OS. y The resources are incorporated in the Solaris OS. Status of an initial diagnosis on an XSB Unmount The XSB cannot be recognized because it is not mounted or because it has an error. Unknown Not performed. Testing The initial diagnosis is in progress. Passed The initial diagnosis ended normally.
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) 00-0 00(00) Assigned y y y Passed Normal 00-1 00(01) Assigned y y y Passed Normal 00-2 SP Available y n n Passed Normal 00-3 02(00) Unavailable y n n Unknown Normal Displays detailed information on all mounted system boards.
showboards(8) EXAMPLE 6 Displays the system boards that are defined for domain ID 0 and located in the system board pool. XSCF> showboards -d 0 -c sp XSB DID(LSB) Assignment Pwr Conn Conf Test Fault ---- -------- ----------- ---- ---- ---- ------- -------00-2 SP EXIT STATUS SEE ALSO 340 Available y n n Passed Normal The following exit values are returned: 0 Successful completion. >0 An error occurred.
showcod(8) NAME SYNOPSIS showcod - display Capacity on Demand (COD) configuration information showcod [-v] [-d domain_id] showcod -h DESCRIPTION showcod(8) displays the COD information which includes the headroom amount, number of installed COD Hardware Activation permits, the number of COD permits reserved for domains, and the Chassis Hostid. The showcod(8) command is not supported on the M3000 server. When used without arguments this command displays the current COD information.
showcod(8) The output shown is what you would see if you had platform privileges.
showcodactivation(8) NAME SYNOPSIS showcodactivation - display the current Capacity on Demand (COD) activation permits stored in the COD Hardware Activation database showcodactivation [-r] [-v] showcodactivation -h DESCRIPTION showcodactivation(8) displays information stored in the COD Hardware Activation database. This command is not available on the M3000 server. When used without options this command displays the current COD keys.
showcodactivation(8) EXAMPLES EXAMPLE 1 Displaying Verbose Permit Data XSCF> showcodactivation -v Description Ver Expiration Count Status ----------- --- ----------- ----- ------- 01 NONE 16 GOOD PROC 01:84000000:000000001:0301010100:16:00000000:xxxxxxxxxxxxxxxxxxxxxx EXAMPLE 2 Displaying Raw Permit Data XSCF> showcodactivation -r 01:84000000:104:0301010100:3:00000000:xxxxxxxxxxxxxxx EXIT STATUS SEE ALSO 344 The following exit values are returned: 0 Successful completion.
showcodlicense(8) NAME SYNOPSIS showcodlicense - display the current Capacity on Demand (COD) right-to-use (RTU) licenses stored in the COD license database showcodlicense [-r] [-v] showcodlicense -h DESCRIPTION showcodlicense(8) displays COD license information stored in the COD license database. The showcodlicense(8) command is not available on the M3000 server. When used without options it displays the current licenses. Privileges You must have platadm or platop privileges to run this command.
showcodlicense(8) EXAMPLES EXAMPLE 1 Displaying Verbose License Data XSCF> showcodlicense -v Description Ver Expiration Count Status ----------- --- ----------- ----- ------- 01 NONE 16 GOOD PROC 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 346 The following exit values are returned: 0 Successful completion.
showcodusage(8) NAME SYNOPSIS showcodusage - display the current usage statistics for Capacity on Demand (COD) resources showcodusage [-v] [-M] [-p resource|domain|all ] showcodusage -h DESCRIPTION showcodusage(8) shows current information about COD Hardware Activation permits in use. The showcodusage(8) command is not available on the M3000 server. By default, this command displays a summary of COD permits used and installed, along with the current state of each resource.
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. COD Permitted Specifies the number of COD permits installed.
showcodusage(8) Installed Specifies the number of COD CPU resources installed in the domain. Reserved Specifies the number of COD permits allocated to the domain. Status Contains one of the following when the -v option is specified: COD Permitted The domain COD CPU has a COD permit and is in use. Not COD Permitted A COD permit for the domain COD CPU could not be obtained and it is not in use. The COD CPU is not in use.
showcodusage(8) Quad-XSB, CMU02 Uni-XSB XSCF> showcodusage -v Resource In Use Installed COD Permitted Status -------- ------ --------- ------------- ------ 0 8 PROC 0 OK: 0 available Headroom: 2 Domain/Resource In Use Installed Reserved Status --------------- ------ --------- -------- ------ 0 8 0 0 1 0 - PROC 00-0 - PROC CMU00-CPU0 00-1 - PROC Unused 0 1 CMU00-CPU1 00-2 - PROC Unused 0 1 CMU00-CPU2 00-3 - PROC Unused 0 1 CMU00-CPU3 02-0 - PROC 350 Unused 0 4 CMU0
showcodusage(8) 13 - PROC 0 0 0 14 - PROC 0 0 0 15 - PROC 0 0 0 Unused - PROC 0 0 2 Displaying COD Usage by Resource and Domain: M5000 Server EXAMPLE 4 XSCF> showcodusage -v Resource In Use Installed COD Permitted Status -------- ------ --------- ------------- ------ 0 4 PROC In Use Installed Reserved Status --------------- ------ --------- -------- ------ 0 - PROC 0 0 0 1 - PROC 0 0 0 2 - PROC 0 0 0 3 - PROC 0 0 0 0 4 0 0 4 00-0 - PROC SEE
showcodusage(8) 352 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010
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 Privileges The showdate(8) command displays the date and time of XSCF. 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. OPTIONS EXTENDED DESCRIPTION EXAMPLES The following options are supported: -h Displays usage statement.
showdate(8) 356 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008
showdateoffset(8) NAME SYNOPSIS showdateoffset - display differences between system time and domain times showdateoffset -d domain_id showdateoffset -a showdateoffset -h DESCRIPTION The showdateoffset(8) command displays the differences in seconds between the time of the system, managed by the XSCF clock, and the time of the domains, each of which is managed by its domain clock.
showdateoffset(8) EXAMPLE 2 On the M5000 server, displays the time differences between the time of the system and the time of the domains. XSCF> showdateoffset DID Domain Date Offset 00 128 sec 01 0 sec 02 -1024 sec 03 -9999999 sec EXAMPLE 3 On the M8000 server, displays the time differences between the time of the system and the time of the domains.
showdateoffset(8) EXIT STATUS SEE ALSO 21 21 sec 22 -621 sec 23 -9999999 sec The following exit values are returned: 0 Successful completion. >0 An error occurred.
showdateoffset(8) 360 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009
showdcl(8) NAME SYNOPSIS showdcl - display the current domain component list (DCL) showdcl [-v] -a showdcl [-v] -d domain_id [-l lsb [-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 the Solaris OS in a domain.
showdcl(8) Status Domain status. One of the following status is displayed. Additional information may be displayed. Powered Off Power is off. Panic State A panic occurred, and the domain is in the reboot state. Shutdown Started The power-off process is starting. Initialization Phase OpenBoot PROM initialization is in progress. OpenBoot Executing Completed The system is in the OpenBoot PROM (ok prompt) state. Booting/OpenBoot PROM prompt The Solaris OS is booting.
showdcl(8) If the -v option is specified, the following information is added: Cfg-policy No-Mem No-IO Float Privileges 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 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) 03 - 04 01-0 05 - 06 - 07 - 08 02-0 09 - 10 - 11 - 12 03-0 13 - 14 - 15 - EXAMPLE 3 False True False True True True True True False Displays details in the DCL that are set for all domains.
showdcl(8) 15 - --------------------------------------------------------------01 Running (Waiting for OS Shutdown) 00 01-2 True True False 01 04-0 False False False 02 - 03 - 04 - 05 - 06 - 07 05-0 True False False 08 - 09 - 10 - 11 - 12 - 13 - 14 06-0 True True True 15 - FRU --------------------------------------------------------------: : EXIT STATUS SEE ALSO 366 The following exit values are returned: 0 Successful completion. >0 An error occurred.
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 Solaris OS when an XSB 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 Solaris OS when an XSB 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) and their available resources. XSCF> showdevices 00-0 CPU: ---DID XSB id state speed ecache 00 00-0 0 on-line 2530 5.5 00 00-0 1 on-line 2530 5.5 00 00-0 2 on-line 2530 5.5 00 00-0 3 on-line 2530 5.5 00 00-0 4 on-line 2530 5.5 00 00-0 5 on-line 2530 5.5 00 00-0 6 on-line 2530 5.5 00 00-0 7 on-line 2530 5.
showdevices(8) sources in domain ID 0. XSCF> showdevices -v -d 0 CPU: ---DID XSB id state speed ecache 00 00-0 0 on-line 2530 5.5 00 00-0 1 on-line 2530 5.5 00 00-0 2 on-line 2530 5.5 00 00-0 3 on-line 2530 5.5 00 00-0 4 on-line 2530 5.5 00 00-0 5 on-line 2530 5.5 00 00-0 6 on-line 2530 5.5 00 00-0 7 on-line 2530 5.
showdevices(8) EXIT STATUS SEE ALSO 372 00 00-0 sd3 /dev/dsk/c0t3s0s1 dump device (swap) 00 00-0 sd3 /dev/dsk/c0t3s0s1 swap area 00 00-0 sd3 /dev/dsk/c0t3d0s3 mounted filesystem "/var" 00 00-0 00 00-0 sd4 00 00-0 sd5 00 00-0 sd6 sd3 /var/run mounted filesystem "/var/run" The following exit values are returned: 0 Successful completion. >0 An error occurred.
showdomainmode(8) NAME SYNOPSIS showdomainmode - display the modes of operation for the specified domain showdomainmode -d domain_id [-v] showdomainmode -h DESCRIPTION showdomainmode(8) command displays the modes of operation that are set for the specified domain. The following states are displayed: HOST-ID Displays the host ID. Diagnostic Level Displays the OpenBoot PROM diagnostic level.
showdomainmode(8) Displays the state of the auto boot function. One of the following is displayed: Autoboot on Enabled off Disabled Way of determining the CPU operational mode mounted on the domain. One of the following is displayed. CPU Mode auto Automatically determines at domain startup compatible Sets to the SPARC64 VI compatible mode regardless of the CPUs mounted Ethernet Address Privileges XSCF-supplied domain ethernet (mac) address.
showdomainmode(8) EXAMPLES ■ OpenBoot PROM diagnostic level (Diagnostic Level), CPU operational mode (CPU Mode): operates as the showdomainmode(8) command display ■ Host watchdog and suppress break signal reception (Secure Mode), auto boot function (Autoboot): off ■ When the OpenBoot PROM environmental variable 'auto-boot?' has been set to false, the auto boot function is disabled. ■ The setdomainmode(8) command sets the modes of operation specified for a domain.
showdomainmode(8) 376 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2009
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. Additional information may be displayed. Powered Off Power is off. Panic State A panic occurred, and the domain is in the reboot state.
showdomainstatus(8) Can run this command for all domains. domainadm, domainmgr, domainop Can run this command only for your accessible domains. 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 displayed. domain_id can be 0–23 depending on the system configuration. -h Displays usage statement.
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) Domain #11 10.1.1.13 Domain #12 10.1.1.14 Domain #13 10.1.1.15 Domain #14 10.1.1.16 Domain #15 10.1.1.17 Domain #16 10.1.1.18 Domain #17 10.1.1.19 Domain #18 10.1.1.20 Domain #19 10.1.1.21 Domain #20 10.1.1.22 Domain #21 10.1.1.23 Domain #22 10.1.1.24 Domain #23 10.1.1.25 Displaying a Specific Domain’s IP Address EXAMPLE 2 XSCF> showdscp -d 1 Domain #01 Address: 10.1.1.
showdscp(8) 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 382 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. Note – The ability to display the current status of the dual power feed is available on M3000/M4000/M5000 servers only. However, the dual power feed mode cannot be used with 100V power on M4000/M5000 servers.
showdualpowerfeed(8) SEE ALSO 384 setdualpowerfeed(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009
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, platop or fieldeng privileges to run this command. Refer to setprivileges(8) for more information. OPTIONS The following options are supported: -h Displays usage statement.
showemailreport(8) 386 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised June 2007
showenvironment(8) NAME SYNOPSIS showenvironment - display the airflow volume, intake air temperature and humidity, temperature sensor, voltage sensor, fan speed, and power consumption information in the server showenvironment [-M] [ type] showenvironment -h DESCRIPTION showenvironment(8) command displays the information listed below.
showenvironment(8) OPTIONS OPERANDS The following options are supported: -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. The following operand is supported: type EXTENDED DESCRIPTION EXAMPLES Specifies the one of the type of information to be displayed. The following types can be specified.
showenvironment(8) CPUM#2-CHIP#0:30.71C CPUM#3-CHIP#0:30.71C CMU#1:30.71C CPUM#0-CHIP#0:30.71C CPUM#1-CHIP#0:30.71C CPUM#2-CHIP#0:30.71C CPUM#3-CHIP#0:30.71C CMU#2:30.71C CPUM#0-CHIP#0:30.71C CPUM#1-CHIP#0:30.71C CPUM#2-CHIP#0:30.71C CPUM#3-CHIP#0:30.71C CMU#3:30.71C CPUM#0-CHIP#0:30.71C CPUM#1-CHIP#0:30.71C CPUM#2-CHIP#0:30.71C CPUM#3-CHIP#0:30.71C EXAMPLE 3 Displays voltage information about each component on the M4000 server. XSCF> showenvironment volt MBU_A 1.0V Power Supply Group:1.010V 1.
showenvironment(8) 1.8V Power Supply Group:1.700V 2.5V Power Supply Group:2.500V MEMB#2 1.2V Power Supply Group:1.200V 1.8V Power Supply Group:1.700V 2.5V Power Supply Group:2.500V MEMB#3 1.2V Power Supply Group:1.200V 1.8V Power Supply Group:1.700V 2.5V Power Supply Group:2.500V IOU#0 1.0V Power Supply Group:1.020V 1.2V Power Supply Group:1.180V 1.5V Power Supply Group:1.500V 1.8V Power Supply Group:1.850V 2.5V Power Supply Group:2.510V 3.3V Power Supply Group:3.300V 5.0V Power Supply Group:5.
showenvironment(8) FAN_A#2: 4177rpm FAN_A#3:Low speed FAN_A#3: 4101rpm PSU#0 PSU#0:Low speed PSU#0: 3879rpm PSU#0: 3835rpm PSU#1 PSU#1:Low speed PSU#1: 3924rpm PSU#1: 3970rpm PSU#2 PSU#2:Low speed PSU#2: 4218rpm PSU#2: 4066rpm PSU#3 PSU#3:Low speed EXAMPLE 5 PSU#3: 3835rpm PSU#3: 3970rpm Displays the fan speed information on the M3000 server.
showenvironment(8) power supply). XSCF> showenvironment power Permitted AC power consumption:470W Actual AC power consumption:450W EXAMPLE 7 Displays power consumption information on the M3000 server (in case of DC power supply). XSCF> showenvironment power Permitted DC power consumption:470W Actual DC power consumption:450W EXAMPLE 8 Displays the volume of air exhausted from the M3000 server.
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 ■ 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. As a result, the component might be operating with reduced functionality or performance. Deconfigured As a result of another component's faulted or degraded status, the component is not operating. (The component itself is not faulted or degraded.
showhardconf(8) CPUM#0-CHIP#0 Status:Normal; Ver:0501h; Serial:PP0723016Q + FRU-Part-Number:CA06761-D204 A0 ; /LGA-JUPP-01 ; + Freq:2.530 GHz; Type:32; + Core:4; Strand:2; : CPUM#3-CHIP#1 Status:Normal; Ver:0501h; Serial:PP074804E9 + FRU-Part-Number:CA06761-D204 A0 ; /LGA-JUPP-01 ; + Freq:2.530 GHz; Type:32; + Core:4; Strand:2; MEMB#0 Status:Normal; Ver:0101h; Serial:BF09061G0E + FRU-Part-Number:CF00541-0545 06 ; /541-0545-06 ; MEM#0A Status:Normal; + Code:c1000000000000005372T128000HR3.
showhardconf(8) DDC_B#1 Status:Normal; IOU#0 Status:Normal; Ver:0101h; Serial:BF07486TEU + FRU-Part-Number:CF00541-2240 02 ; /541-2240-02 ; DDC_A#0 Status:Normal; DDCR Status:Normal; DDC_B#0 Status:Normal; IOU#1 Status:Normal; Ver:0101h; Serial:BF073226HP + FRU-Part-Number:CF00541-2803 01 ; /541-2803-01 ; DDC_A#0 Status:Normal; DDCR Status:Normal; DDC_B#0 Status:Normal; XSCFU Status:Normal,Active; Ver:0101h; Serial:BF07435D98 + FRU-Part-Number:CF00541-0481 04 /541-0481-04 OPNL Status:Normal; Ver:
showhardconf(8) | FRU | Quantity | +-----------------------------------+------------+ | MBU_B | 1 | | | 4 | 8) | | 8 | | 64 | 64) | CPUM | Freq:2.
showhardconf(8) + FRU-Part-Number:CA06629-D001 A4 ; + Memory_Size:128 GB; + Type:A CPUM#0-CHIP#0 Status:Normal; Ver:0101h; Serial:PP091505ZY ; + FRU-Part-Number:CA06620-D021 A3 ; + Freq:2.280 GHz; Type:16; + Core:2; Strand:2; CPUM#1-CHIP#0 Status:Normal; Ver:0101h; Serial:PP091505ZW ; + FRU-Part-Number:CA06620-D021 A3 ; + Freq:2.280 GHz; Type:16; + Core:2; Strand:2; CPUM#2-CHIP#0 Status:Normal; Ver:0101h; Serial:PP0915060H ; + FRU-Part-Number:CA06620-D021 A3 ; + Freq:2.
showhardconf(8) CMU#2 Status:Normal; Ver:4201h; Serial:PP0618K472 + FRU-Part-Number:CA06620-D003 A0 ; /371-4617-01 ; + Memory_Size:32 GB; + Type:B CPUM#0-CHIP#0 Status:Normal; Ver:0901h; Serial:PP0608J517 + FRU-Part-Number:CA06620-D051 A0 ; /371-4616-01 ; + Freq:2.880 GHz; Type:32; + Core:4; Strand:2; CPUM#1-CHIP#0 Status:Normal; Ver:0901h; Serial:PP0620P552 + FRU-Part-Number:CA06620-D051 A0 ; /371-4616-01 ; + Freq:2.
showhardconf(8) : IOU#0 Status:Normal; Ver:0101h; Serial:PP072102UN + FRU-Part-Number:CA06620-D102 B1 ; /371-2217-02 ; PCI#0 Name_Property:pci; Card_Type:IOUA; + Serial:PP0611T826 ; + FRU-Part-Number:CA21126-B20X 002AB PCI#1 Status:Normal; Name_Property:LSILogic,sas; Card_Type:Other; + Serial:0000004; Type:F20; + FRU-Part-Number:5111500-01; IOU#1 Status:Normal; Ver:0101h; Serial:PP072102UM + FRU-Part-Number:CA06620-D102 B1 ; /371-2217-02 ; PCI#0 Name_Property:pci; Card_Type:IOUA; + Serial:PP0611T
showhardconf(8) + FRU-Part-Number:CA06501-D023 A2 /371-2222-00 ; : FAN_A#15 Status:Normal; Serial:PA0605B303; + FRU-Part-Number:CA06501-D023 A2 /371-2222-00 ; : FANBP_B#0 Status:Normal; Ver:0201h; Serial:PP0607D270 ; + FRU-Part-Number:CA21123-B55X 003AC ; FAN_A#4 Status:Normal; Serial:PA0605B297; + FRU-Part-Number:CA06501-D023 A2 /371-2222-00 ; : FAN_A#9 Status:Normal; Serial:PA0605B300; + FRU-Part-Number:CA06501-D023 A2 /371-2222-00 ; : SWBP#0 Status:Normal; Ver:0101h; Serial:PP0607E759 ;
showhardconf(8) | Type:4B; Size:4 GB; | ( 32) | | IOU | 8 | | XSCFU_B | 2 | | XBU_B | 8 | | CLKU_B | 2 | | OPNL | 1 | | PSU | 15 | | FANBP_A | 1 | | FANBP_B | 1 | | | 16 | | SWBP | 1 | | MEDBP | 1 | FAN_A +-----------------------------------+------------+ EXAMPLE 5 Displays the information of the FRUs in the M3000 server (in case of AC power supply).
showhardconf(8) MEM#3B Status:Normal; + Code:00000000000000c14572T128000HR3.
showhardconf(8) + CPU Status:Normal; + Freq:2.750 GHz; Type:32; + Core:4; Strand:2; + Memory_Size:8 GB; MEM#0A Status:Normal; + Code:00000000000000c14572T128000HR3.7A 2b25-20541204; + Type:1A; Size:1 GB; : MEM#3B Status:Normal; + Code:00000000000000c14572T128000HR3.
showhardconf(8) Displays the number of installed FRUs in the M3000 server. EXAMPLE 7 XSCF> showhardconf -u SPARC Enterprise M3000; Memory_Size:8 GB; +-----------------------------------+------------+ | FRU | Quantity | +-----------------------------------+------------+ | MBU_A | | | | CPU | | Freq:2.
showhardconf(8) 408 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010
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 410 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) CA cert: installed in Apr 24 12:00:34 JST 200 CSR: -----BEGIN CERTIFICATE REQUEST----MIIBwjCCASsCAQAwgYExCzAJBgNVBAYTAmpqMQ4wDAYDVQQIEwVzdGF0ZTERMA8G A1UEBxMIbG9jYWxpdHkxFTATBgNVBAoTDG9yZ2FuaXphdGlvbjEPMA0GA1UECxMG b3JnYW5pMQ8wDQYDVQQDEwZjb21tb24xFjAUBgkqhkiG9w0BCQEWB2VlLm1haWww gZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAJ5D57X/k42LcipTWBWzv2GrxaVM 5GEyx3bdBW8/7WZhnd3uiZ9+ANlvRAuw/YYy7I/pAD+NQJesBcBjuyj9x+IiJl9F MrI5fR8pOIywVOdbMPCar09rrU45bVeZhTyi+uQOdWLoX/Dhq0fm2BpYuh9WukT5 pTEg+2dABg8UdHmNAgMBAAG
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 or fieldeng privileges to run this command.
showldap(8) SEE ALSO 414 setldap(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised June 2007
showldapssl(8) NAME SYNOPSIS showldapssl - show LDAP/SSL configuration and messages showldapssl showldapssl cert [-v] [-i n] showldapssl log [-M] [-C] [-S start_record_number] [-E end_record_number] showldapssl log -f showldapssl group administrator [-i n] showldapssl group operator [-i n] showldapssl group custom [-i n] showldapssl userdomain [-i n] showldapssl usermap showldapssl defaultrole showldapssl server [-i n] showldapssl -h DESCRIPTION Privileges showldapssl(8) displays the LDAP/SSL configurat
showldapssl(8) OPERANDS EXAMPLES -C Appends to end of output the number of records in the log. -E Specifies the last record number to display, where end_record_number can be any record number in the log. Use -C to obtain the number of records in the log. -M Displays text by page, like the more(1) command does. -S Specifies the first record to display, where start_record_number can be any record number in the log. Use -C to obtain the number of records in the log.
showldapssl(8) valid from = Apr 18 05:38:36 2009 GMT valid until = Apr 16 05:38:36 2019 GMT version = 3 (0x02) EXAMPLE 3 Displays specified diagnostic messages.
showldapssl(8) 418 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010
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) 420 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised March 2008
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) 422 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007
showloginlockout(8) NAME SYNOPSIS showloginlockout - display the account lockout setting showloginlockout showloginlockout -h DESCRIPTION Privileges The showloginlockout(8) command displays the amount of time, in minutes, that a user is prevented from logging in after three failed attempts. 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.
showloginlockout(8) 424 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009
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 ID 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. -p timestamp Specifies a timestamp in a log when one log is to be displayed. This option can be specified for an error log or event log.
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 Status: Alarm Code: xxxxxxxx-xxxxxxxx-xxxxxxxxxxxxxxxx Occurred: Mar 30 17:45:31.
showlogs(8) Date: Log collection date and time (month day hour:minute:second time-zone year) The displayed time is the local time. Code: Error code Data is displayed in 16-byte format. Occurred: Date (Month Day Hour: Minute: Second TimeZone Year) when an error occurred. This date is displayed as the local time.
showlogs(8) MSG-ID: Unique message ID Diagnostic Messages: Detailed message Detail log: Scan log code If the log has a detailed message, it is displayed. This code is displayed when the log includes a scan log. Address: Displayed in hexadecimal notation. ■ Power log Date Event Mar 30 17:25:31 JST 2005 System Power Off Mar 30 17:35:31 JST 2005 System Power On Mar 30 17:45:31 JST 2005 Domain Power On Mar 30 17:50:31 JST 2005 Domain Power Off Cause Pow.Fail/Recov.-Pow.Fail/Recov.
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 system power is on. System Power Off The system power is off. SCF Reset XSCF is in the reset state. Domain Reset The domain is in the reset state. XIR The domain CPU is in the reset state.
showlogs(8) Mar 30 17:55:31 JST 2005 System power off : : Case where the -v option is specified Date Message Mar 30 17:45:31 JST 2005 System power on Switch= Service Code=xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx Log collection date and time (month day hour:minute:second time-zone year) Date: The displayed time is the local time.
showlogs(8) Log collection date and time (month day hour:minute:second time-zone year) Date: 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 (%). Humidity is displayed on the M8000/M9000 servers only. Power state of the main unit Power: Either of the following states is displayed: ■ System Power ON The main unit power is on.
showlogs(8) [Second and subsequent lines] Each line of display has a date and time paired with a console message. The time in the displayed log collection date and time (month day hour:minute:second time-zone year) is the local time.
showlogs(8) [Second line] IPL date and time (month day hour:minute:second time-zone year) Date: The displayed time is the local time. Domain ID DomainID: domain_id can be 00–23 depending on the system configuration. [Third and subsequent lines] Each line of display has a date and time paired with an IPL message. 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.
showlogs(8) Diagnostic Code: 00112233 44556677 8899aabb 00112233 44556677 8899aabb ccddeeff 00112233 44556677 8899aabb ccddeeff UUID: bf36f0ea-9e47-42b5-fc6f-c0d979c4c8f4 MSG-ID: FMD-8000-11 EXAMPLE 3 Displays an error log in greater detail for the times of the specified timestamp (-V). XSCF> showlogs error -p Mar3012:45:312005 -V Date: Mar 30 12:45:31 JST 2005 Status: Alarm Code: 00112233-44556677-8899aabbcceeff0 Occurred: Mar 30 17:45:31.
showlogs(8) timestamp. XSCF> showlogs power -r Date Event Mar 30 17:50:31 JST 2005 Domain Power On Cause Operator DID 00 Switch Service Mar 30 17:45:31 JST 2005 Domain Power Off Operator 00 Locked Mar 30 17:35:31 JST 2005 System Power On Pow.Fail/Recov.-- Locked Mar 30 17:25:31 JST 2005 System Power Off EXAMPLE 6 Pow.Fail/Recov.-- Service Displays the specified range of a power log.
showlogs(8) Mar 30 17:45:31 JST 2005 Executing last command: boot Mar 30 17:55:31 JST 2005 disk@0,0:a File and args: Boot device: /pci@83,4000/FJSV,ulsa@2,1/ Mar 30 17:55:32 JST 2005 SunOS Release 5.10 Version Generic 64-bit Note: The codes or messages shown here may differ from those actually displayed. EXIT STATUS 440 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 or fieldeng privileges to run this command. Refer to setprivileges(8) for more information. OPTIONS The following option is supported: Displays usage statement.
showlookup(8) 442 SPARC Enterprise Mx000 Servers 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 executed, the showmonitorlog(8) command will not terminate in order to display the monitoring message log, and the XSCF shell is occupied for the display. When a monitoring message is registered, the contents of the message are displayed.
showmonitorlog(8) 444 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008
shownameserver(8) NAME SYNOPSIS shownameserver - display the registered domain name system (DNS) servers and the DNS search paths specified on the XSCF network shownameserver shownameserver -h DESCRIPTION Privileges shownameserver(8) command displays the registered DNS servers and the DNS search paths in the XSCF network.
shownameserver(8) DNS search path are set: XSCF> shownameserver nameserver --search EXIT STATUS SEE ALSO 446 --- The following exit values are returned: 0 Successful completion. >0 An error occurred.
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 operands are 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) EXAMPLES ■ In the M8000/M9000 servers and when the takeover IP address has been disabled by setnetwork(8) command, nothing will be displayed even though the takeover IP address is specified by the shownetwork(8) command. ■ The setnetwork(8) command configures a network interface used by the XSCF. EXAMPLE 1 Displays the information for XSCF-LAN#0 on XSCF unit 0. XSCF> shownetwork xscf#0-lan#1 xscf#0-lan#1 Link encap:Ethernet HWaddr 00:00:00:12:34:56 inet addr:192.168.10.
shownetwork(8) inet addr:192.168.10.128 Bcast: 192.168.10.255 UP BROADCAST RUNNING MULTICAST MTU:1500 Mask:255.255.255.0 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:(0.0 B) TX bytes:17010 (16.6 KiB) Base address:0x1000 EXAMPLE 4 Displays the information for XSCF-LAN#0 on XSCF Unit 0.
shownetwork(8) EXAMPLE 7 Displays the information for XSCF unit 0 and XSCF unit 1 in the M8000/ M9000 servers. 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 UP BROADCAST RUNNING MULTICAST MTU:1500 Mask:255.255.255.0 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:12241827 (11.3 MiB) TX bytes:1189769 (0.
shownetwork(8) HWaddr 00:00:00:12:34:59 inet addr:192.168.10.12 Mask:255.255.255.0 xscf#1-lan#1 HWaddr 00:00:00:12:34:60 xscf#1-if HWaddr 00:00:00:12:34:61 XSCF> EXIT STATUS SEE ALSO 452 The following exit values are returned: 0 Successful completion. >0 An error occurred.
shownotice(8) NAME SYNOPSIS shownotice - display copyright and license information for the 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. You can display only the copyright or the license file by specifying the -c option.
shownotice(8) 454 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008
showntp(8) NAME SYNOPSIS showntp - display the NTP information which currently set for XSCF showntp {-l | -a | address | -s | -m} showntp -h DESCRIPTION The showntp(8) command displays the NTP information currently set for XSCF.
showntp(8) OPERANDS The following operand is supported: address Specifies the IP address or the XSCF host name of an NTP server to be displayed. If the -a option is specified, the operand is ignored. 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 where: xxx An integer from 0–255. Zero suppression can be used to specify the integer. The host name can be specified in the format that complies with RFC 1034.
showntp(8) EXAMPLE 3 Displays the stratum value which has been set to XSCF. XSCF> showntp -s stratum : 5 EXAMPLE 4 Displays whether a preferred server has been designated, and displays the clock address of the local clock. XSCF> showntp -m prefer : on localaddr : 0 EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
showntp(8) 458 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009
showpacketfilters(8) NAME SYNOPSIS showpacketfilters - show the IP packet filtering rules that are set in the XSCF network showpacketfilters {-a | -l} [-M] showpacketfilters -h DESCRIPTION Privileges showpacketfilters(8) command shows the IP packet filtering rules that are set in the XSCF network. No privileges are required to run this command. Refer to setprivileges(8) for more information.
showpacketfilters(8) ing rules in the XSCF network. XSCF> showpacketfilters -l pkts bytes target prot in source 0 0 DROP all xscf#0-lan#0 172.16.0.0/255.255.0.0 0 0 DROP all xscf#0-lan#0 10.10.10.10 0 0 DROP all xscf#0-lan#1 10.10.10.10 0 0 ACCEPT all xscf#0-lan#1 192.168.100.0/255.255.255.0 0 0 DROP all xscf#0-lan#1 0.0.0.0/0.0.0.0 pkts bytes target prot in source 0 0 DROP all xscf#1-lan#0 172.16.0.0/255.255.0.0 0 0 DROP all xscf#1-lan#0 10.10.10.
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) SEE ALSO 462 setpasswordpolicy(8) SPARC Enterprise Mx000 Servers 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) 464 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2008
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) 466 SPARC Enterprise Mx000 Servers 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 -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. -n Displays IP address without the name resolution of host name. 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.
showroute(8) EXAMPLES EXAMPLE 1 Displays routing information for XSCF-LAN#0 on XSCF unit 0. XSCF> showroute xscf#0-lan#0 Destination Gateway Netmask Flags Interface 192.168.10.0 * 255.255.255.0 xscf#1-lan#0 default 192.168.10.1 0.0.0.0 UG EXAMPLE 2 xscf#0-lan#0 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 Flags Interface 192.168.10.0 0.0.0.0 255.255.255.
showroute(8) 470 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010
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) 472 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007
showsmtp(8) NAME SYNOPSIS showsmtp - display the Simple Mail Transfer Protocol (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.
showsmtp(8) 474 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008
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) System Location: SanDiego System Contact: bob@jupiter.
showsnmp(8) Community String: public Enabled MIB Modules: SP_MIB FM_MIB EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
showsnmp(8) 478 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007
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: Displays usage statement.
showsnmpusm(8) 480 SPARC Enterprise Mx000 Servers 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: Displays usage statement.
showsnmpvacm(8) SEE ALSO 482 setsnmpvacm(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007
showssh(8) NAME SYNOPSIS showssh - display the settings of the Secure Shell (SSH) service that configured for the XSCF network showssh [-c hostkey] [-M] showssh -c pubkey [-u user_name] [-M] showssh -h DESCRIPTION showssh(8) command displays the current settings of the SSH service that 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) VN3009kmVwAAAIAON1LR/ 9Jdd7yyG18+Ue7eBBJHrCA0pkSzvfzzFFj5XUzQBdabh5p5Rwz+1vriawFI ZI9j2uhM/3HQdrvYSVBEdMjaasF9hB6T/ uFwP8yqtJf6Y9GdjBAhWuH8F13pX4BtvK9IeldqCscnOuu0 e2rlUoI6GICMr64FL0YYBSwfbwLIz6PSA/yKQe23dwfkSfcwQZNq/ 5pThGPi3tob5Qev2KCK2OyEDMCA OvVlMhqHuPNpX+hE19nPdBFGzQ== Fingerprint: 1024 9e:39:8e:cb:8a:99:ff:b4:45:12:04:2d:39:d3:28:15 /etc/ssh/ ssh_host_dsa_key.pub EXAMPLE 2 Displays the user public key of the current login user account.
showssh(8) 486 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009
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) module in a CPU memory unit are degraded because of an error. XSCF> showstatus CMU#0; * CPUM#0-CHIP#0 Status:Faulted; * MEM#00A Status:Faulted; Displays the degraded units. In this example, a memory module on a memory board is degraded because of an error. EXAMPLE 2 XSCF> showstatus MBU_B; MEMB#0; * MEM#0A Status:Faulted; EXAMPLE 3 Displays the degraded units. In this example, a CPU/memory board unit and memory module on a motherboard unit are degraded because of an error.
showsunmc(8) NAME SYNOPSIS showsunmc - show setup information and status of Sun Management Center agent showsunmc [isenabled] showsunmc [-h] DESCRIPTION OPTIONS This command is used to show the setup information and current status of the Sun Management Center agent. When used with the isenabled option, the showsunmc command output displays on the agent status: 1 if the agent is enabled, 0 if the agent is disabled. The following options are supported. isenabled Displays only the agent status.
showsunmc(8) EXAMPLE 2 Show the Status of the Agent: Set Up, But Not Enabled XSCF> showsunmc Agent Status: Setup Status: SunMC Server: Security Seed: SNMPv1 Community String: Agent Port: Host Trap Port: Host Event Port: SNMP Agent Port: Domain Agent Ports: EXAMPLE 3 Disabled Set up balon maplesyr double_secret 1161 162 163 161 1161 Show the Agent Status of an Enabled Agent XSCF> showsunmc isenabled 1 EXIT STATUS SEE ALSO 490 The following exit values are returned: 0 Successful completion.
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) 492 SPARC Enterprise Mx000 Servers 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 [-m {standard | custom}] showtimezone -h DESCRIPTION Privileges The showtimezone(8) command displays the XSCF time zone and Daylight Saving Time information of current settings.
showtimezone(8) offset Offset time of time zone and Greenwich mean time (GMT). Displayed in minus "–" in case the offset is plus, and displayed in plus "+" in case the offset is minus. dst Name of Daylight Saving Time. 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.
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) dst The settimezone(8) command sets the time zone of the XSCF. ■ EXAMPLES dst name 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 Displays Password and Account Validity Information EXAMPLE 1 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: EXAMPLE 2 XSCF> Never Displays Privileges Information showuser -p User Name: jsmith Privileges: domainadm@1,3-6,8,9 platadm EXIT STATUS SEE ALSO 498 The following exit values are returned: 0 Successful
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 prov
snapshot(8) command. The following example decrypts the file jupiter_10.1.1.1_2006-07-08T22-33-44.zip.e: % openssl aes-128-cbc -d -in jupiter_10.1.1.1_2006-07-08T22-33- 44.zip.e -out jupiter_10.1.1.1_2006-07-08T22-33-44.zip 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 .
snapshot(8) -e Encrypts the zip archive. Required when using -P password. -h Displays usage statement. When used with other options or operands, an error occurs. -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 Used with the -e option, sets the encryption password used for encrypting the output file. -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.
snapshot(8) EXTENDED DESCRIPTION Modes of Operation The following is a brief overview of the modes of operation for the snapshot command. The first mode is SSH Target Mode. The data collector is run in this mode when it is invoked with the -t or -T option. In this mode, the data collector opens an SSH 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.
snapshot(8) Setting up ssh connection to remote host... Collecting data into joe@jupiter.west:/home/joe/logs/x/archive.zip Data collection complete. EXAMPLE 3 Downloading With a User-Provided Public Key XSCF> snapshot -t joe@jupiter.west:/home/joe/logs/x -k “ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAwVFiSQNVBFhTTzq0AX5iQqCkkJjd6ezWkVGt mMkJJzzMjYK0sBlhn6dGEIiHdBSzO8QLAXb8N4Kq8JDOBpLSN4yokUPTcZQNxJaY A0W058Qgxbn” Enter ssh password for user ‘joe’ on host ‘jupiter.
snapshot(8) EXAMPLE 6 Downloading Using No Key to Invalid Directory XSCF> snapshot -t sue@saturn.north:/home/sue/logs/bad_dir -k none Enter ssh password for user ’sue’ on host ’saturn.north’ Setting up ssh connection to remote host... Failed to create remote file: /home/sue/logs/bad_dir/archive.zip Verify adequate disk permissions and disk space on target host Error opening SSH target Exiting with error 1 EXAMPLE 7 Downloading Public Key With Connectivity Failure XSCF> snapshot -t sue@saturne.
snapshot(8) EXAMPLE 9 Downloading Public Key Attempted by Unauthorized User XSCF> snapshot -t fakeuser@fakehost.com:/fakedir -p fake-password Downloading Public Key from ’fakehost.com’... Error downoading key for host ’fakehost.com’ Error opening SSH target Exiting with error 1 EXAMPLE 10 Downloading to External Media Device XSCF> snapshot -d usb0 -r Testing writability of USB device....SUCCESS About to remove all files from device ‘usb0’.
switchscf(8) NAME SYNOPSIS switchscf - switch the XSCF unit between the active and standby states switchscf [ [-q] -{y|n}] -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. The switchscf(8) command is available on the M8000/M9000 servers only.
switchscf(8) EXTENDED DESCRIPTION EXAMPLES -t Active Switches the state of the XSCF unit to active. -t Standby Switches the state of the XSCF unit to standby. -y Automatically answers "y" (yes) to all prompts. 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. EXAMPLE 1 Switches the state of the XSCF unit that the user is currently logged in to, to standby.
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 [ [-q] -{y|n}] [-m diag=mode] -c {all | expansion} testsb -v [ -y|-n] [-m diag=mode] location testsb -v [-y|-n] [-m diag=mode] -c {all | expansion} testsb -h DESCRIPTION testsb(8) command performs an initial diagnosis of the specified PSB. The testsb(8) command is not available on the M3000 server.
testsb(8) OPTIONS The following options are supported:. -c {all|expansion} Specifies the target PSB to be diagnosed. One of the values shown below can be specified: all Diagnoses all the PSB that are mounted. If the following conditions not satisfied, it leads to an error. ■ The system has been powered off. ■ All of the target PSB are Uni-XSB. expansion Diagnoses all the PSB that are mounted on the expansion cabinet. If the following conditions not satisfied, it leads to an error.
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 reboot status. ■ The addboard(8), deleteboard(8), or moveboard(8) command is executed for XSB. ■ In case an XSB which belongs to the specified PSB is in Unmount or Faulted status, it may be excluded from the target of diagnosis and may not be shown in the diagnosis result.
testsb(8) EXAMPLES EXAMPLE 1 Performs the initial diagnosis on PSB#00. XSCF> testsb 0 Initial diagnosis is about to start, Continue?[y|n] :y SB#00 power on sequence started. 0end Initial diagnosis started. [1800sec] 0..... 30..... 60..... 90.....120end Initial diagnosis has completed. SB power off sequence started. [1200sec] 0.end SB powered off.
testsb(8) EXAMPLE 3 Performs the initial diagnosis on all the PSB that are mounted. XSCF> testsb -c all Initial diagnosis is about to start. Continue? [y|n] :y SB power on sequence started. 0end Initial diagnosis started. [1800sec] 0..... 30..... 60..... 90.....120end Initial diagnosis has completed. SB power off sequence started. [1200sec] 0.end SB powered off.
testsb(8) EXIT STATUS SEE ALSO 514 00-0 Passed Normal 01-0 Passed Normal 02-0 Passed Normal 03-0 Passed Normal The following exit values are returned: 0 Successful completion. >0 An error occurred.
traceroute(8) NAME SYNOPSIS traceroute - display the route packets take to the specified network host or the network device traceroute [-n] [-r] [-v] [-m maxttl] [-p port] [-q nqueries] [-s src_addr] [-w wait] host traceroute -h DESCRIPTION The traceroute(8) command displays the route packets take to the specified network host or the network device.
traceroute(8) OPERANDS -r Bypasses the routing table and directly sends the packet to the specified network host or the network device. If the desired host or the network device is not on the same physical network, it results in errors. -s src_addr Specifies the source address to start tracking the route. -v Displays verbose output. The size of the sending packet will be displayed. -w wait Specifies the timeout period in units of seconds. If omitted, it is set to 3 seconds.
traceroute(8) EXIT STATUS 4 XX.XX.XX.4 36 bytes to 192.168.100.10 2.516 ms 2.229 ms 2.357 ms 5 XX.XX.XX.5 36 bytes to 192.168.100.10 2.546 ms 2.347 ms 2.272 ms 6 server.example.com 48 bytes to 192.168.100.10 2.172 ms 2.313 ms 2.36 ms The following exit values are returned: 0 Successful completion. >0 An error occurred.
traceroute(8) 518 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009
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) XSCF#1 (Standby) XCP0 (Current): 1090 XCP1 (Reserve): 1090 EXAMPLE 2 Displays the details of the XCP version. XSCF> version -c xcp -v XSCF#0 (Active) XCP0 (Current): 1082 OpenBoot PROM : 02.09.0000 XSCF : 01.08.0005 XCP1 (Reserve): 1082 OpenBoot PROM : 02.09.0000 XSCF : 01.08.0005 XSCF#1 (Standby) XCP0 (Current): 1082 OpenBoot PROM : 02.09.000 XSCF : 01.08.0005 XCP1 (Reserve): 1082 OpenBoot PROM : 02.09.0000 XSCF : 01.08.0005 OpenBoot PROM BACKUP #0: 02.08.0000 #1: 02.09.
version(8) EXAMPLE 5 Displays the version of OpenBoot PROM firmware. XSCF> version -c cmu DomainID 0: 02.09.0000 DomainID 1: 02.09.0000 DomainID 2: 02.09.0000 DomainID 3: 02.09.0000 : DomainID 23: 02.09.0000 EXAMPLE 6 Displays the detailed version of OpenBoot PROM firmware. XSCF> version -c cmu -v DomainID 0: 02.09.0000 DomainID 1: 02.09.0000 DomainID 2: 02.09.0000 DomainID 3: 02.09.0000 : DomainID 23: 02.09.0000 XSB#00-0: 02.09.0000(Current) 02.07.0000(Reserve) XSB#00-1: 02.09.
version(8) EXIT STATUS 524 The following exit values are returned: 0 Successful completion. >0 An error occurred.
viewaudit(8) NAME SYNOPSIS viewaudit - display audit records viewaudit viewaudit [-A date-time] [ -B date-time ] [ -C] [ -c classes] [ -D date-time] [-E endrecord] [-e events ] [ -i audit-ids] [-l] [ -m del] [ -n] [ -p privilege-results] [ -r return-values ] [ -S start-record] [ -u users] [-x] viewaudit -h DESCRIPTION Privileges viewaudit(8) displays audit records. When invoked without options, viewaudit displays all current local audit records.
viewaudit(8) -B date-time Selects records that occurred before date-time. The date-time 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 16. The following are valid classes: all Denotes all classes.
viewaudit(8) -e events Selects records of the indicated events. events is a commaseparated 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 4. See showaudit -e all for a list of valid events. -h Displays usage statement. When used with other options or operands, an error occurs. -i audit-ids Selects records of the indicated audit session identifier.
viewaudit(8) EXAMPLES -u users Selects records attributed to indicated users. users is a comma-separated list of users. A user can be specified by user name or numeric UID. -x Prints in XML format. EXAMPLE 1 Displaying Audit Records for December 12, 2005 XSCF> viewaudit -D 20051212 file,1,2006-01-11 10:52:30.391 -05:00,20060111155230.0000000000.jupiter EXAMPLE 2 Displaying User Audit Records XSCF> viewaudit -u jsmith file,1,2006-01-11 10:52:30.391 -05:00,20060111155230.0000000000.
viewaudit(8) EXAMPLE 4 Displaying Audit Records for Successful Access XSCF> viewaudit -r success 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 header,57,1,command - viewaudit,jupiter.company.com,2006-01-26 16:13:09.128 -05:00 subject,5,sue,normal,ssh 1282 saturn command,viewaudit platform access,granted return,0 ...
viewaudit(8) header,37,1,logout,sca-m5k-0-0.sfbay.sun.com,2008-01-09 20:12:14.800 08:00,subject,250,o pl,normal,ssh 42759 san-e4900-0.West.Sun.COM header,37,1,login - ssh,sca-m5k-0-0.sfbay.sun.com,2008-01-09 20:12:15.595 08:00,subject, 253,scfroot,normal,ssh 42762 san-e4900-0.West.Sun.COM 4238 EXIT STATUS SEE ALSO The following exit values are returned: 0 Successful completion. >0 An error occurred.
viewaudit(8) 532 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008
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. OPTIONS The following option is supported: Displays usage statement.
who(1) 534 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007