Summary of Contents for Oracle Sun SPARC Enterprise M3000
Page 1
Sun SPARC Enterprise M3000/M4000/M5000/ M8000/M9000 Servers XSCF Reference Manual for XCP Version 109x Part No. 821-0338-11 July 2010, Revision A...
Page 2
Oracle or Fujitsu Limited, or any affiliate of either of them.
Page 3
EXCLUES, DANS LA MESURE AUTORISÉE PAR LA LOI APPLICABLE. Sauf mention contraire expressément stipulée dans ce contrat, dans la mesure autorisée par la loi applicable, en aucun cas Oracle ou Fujitsu Limited et/ou l’une ou l’autre de leurs sociétés affiliées ne sauraient être tenues responsables envers une quelconque partie tierce, sous quelque théorie juridique que ce soit, de tout manque à...
Preface This manual contains the man pages for the eXtended System Control Facility (XSCF) firmware for Oracle’s Sun SPARC Enterprise M3000/M4000/M5000/M8000/ M9000 servers. Overview of Man Page Structure The following table describes the sections included in man pages. The man pages of each manual section generally follow this order, but include only needed headings.
Page 12
… Ellipses. Several values may be provided for the previous argument, or the previous argument can be specified multiple times, for example “filename...”. Separator. Only one of the arguments separated by this character can be specified at one time. Braces. The options and/or arguments enclosed within braces are interdependent, such that everything enclosed must be treated as a unit.
Intro(8) NAME Intro - list the commands provided by the XSCF firmware DESCRIPTION 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.
Page 14
Intro(8) exit the XSCF shell exit update the firmware flashupdate fault management configuration tool fmadm view fault management logs fmdump report fault management module statistics fmstat download a firmware image file getflashimage manage External I/O Expansion Units and add-in cards ioxadm that contain Energy Storage Modules and are attached to the host system...
Page 15
Intro(8) exit the XSCF shell exit update the firmware flashupdate fault management configuration tool fmadm view fault management logs fmdump report fault management module statistics fmstat download a firmware image file getflashimage manage External I/O Expansion Units and add-in cards ioxadm that contain Energy Storage Modules and are attached to the host system...
Page 16
Intro(8) configure the log archiving functionality setarchiving manage the system auditing functionality setaudit set the session timeout time of the XSCF shell setautologout set up the Capacity on Demand (COD) resources used for setcod domains set the date and time of XSCF setdate set a domain component list (DCL) setdcl...
Page 17
Intro(8) set the IP packet filtering rules to be used in the XSCF setpacketfilters network manage the system password policy setpasswordpolicy set the warm-up time of the system and wait time before setpowerupdelay system startup assign user privileges setprivileges set routing information for an XSCF network interface setroute set the shutdown wait time at power interruption of the setshutdowndelay...
Page 18
Intro(8) display the current Capacity on Demand (COD) right-to- showcodlicense use (RTU) licenses stored in the COD license database display the current usage statistics for Capacity on Demand showcodusage (COD) resources display information on the domain console that is currently showconsolepath connected show the date and time of XSCF...
Page 19
Intro(8) display the configuration for authentication and privileges showlookup lookup display the contents of monitoring messages in real time showmonitorlog display the registered domain name system (DNS) servers shownameserver and the DNS search paths specified on the XSCF network display information of network interfaces for XSCF shownetwork display copyright and license information for the copyright shownotice...
Page 20
Intro(8) display the XSCF time zone and Daylight Saving Time showtimezone information of current settings display user account information showuser collect and transfer environment, log, error, and FRUID snapshot data switch the XSCF unit between the active and standby states switchscf perform an initial diagnosis of the specified physical system testsb...
addboard(8) NAME addboard - configure an eXtended System Board (XSB) into the domain configuration or assign it to the domain configuration SYNOPSIS 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 -h DESCRIPTION...
Page 22
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. Forcibly incorporates into a domain an XSB. Caution –...
Page 23
addboard(8) 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 ■...
Page 24
addboard(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
addcodactivation(8) NAME addcodactivation - add a Capacity on Demand (COD) activation key to the COD Hardware Activation database SYNOPSIS 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.
Page 26
addcodactivation(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010...
addcodlicense(8) NAME addcodlicense - add a Capacity on Demand (COD) right-to-use (RTU) license key to the COD license database SYNOPSIS 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.
Page 28
addcodlicense(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010...
addfru(8) NAME addfru - add a Field Replaceable Unit (FRU) SYNOPSIS 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.
Page 30
addfru(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
adduser(8) NAME adduser - create an XSCF user account SYNOPSIS 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.
Page 32
adduser(8) EXAMPLES Creating a New User EXAMPLE 1 adduser -u 359 jsmith XSCF> The following exit values are returned: EXIT STATUS Successful completion. An error occurred. >0 SEE ALSO deleteuser(8), disableuser(8), enableuser(8), password(8), setad(8), setldap(8), setldapssl(8), setpasswordpolicy(8), showad(8), showldap(8), showldapssl(8), showpasswordpolicy(8), showuser(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual •...
applynetwork(8) NAME applynetwork - apply XSCF network information to the XSCF SYNOPSIS 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.
Page 34
applynetwork(8) Use the appropriate network commands to specify the following settings, then ■ execute the applynetwork(8) command. All these settings must be present and proper or the XSCF network settings will not be applied. XSCF host name (sethostname(8)) ■ DNS domain name (sethostname(8)) ■...
applynetwork(8) nameserver :10.23.4.3 interface :xscf#0-lan#0 status 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] : 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.
Page 36
applynetwork(8) interface :xscf#0-lan#1 status :down 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 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...
Page 37
applynetwork(8) interface :lan#1 status :down IP address netmask Continue? [y|n] : 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. Applies the information that has been set for the XSCF network, on M3000/ EXAMPLE 2 M4000/M5000 servers.
Page 38
applynetwork(8) 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. Applies the information that has been set for the XSCF network. Suppresses EXAMPLE 3 prompts, and automatically answers "y"...
Page 39
applynetwork(8) route Continue? [y|n] : 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 The following exit values are returned: Successful completion.
Page 40
applynetwork(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010...
cfgdevice(8) NAME 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 SYNOPSIS cfgdevice [ [-q] -{y|n}] -c attach -p port_no cfgdevice [ [-q] -{y|n}] -c detach -p port_no cfgdevice -l [-M] cfgdevice -h DESCRIPTION...
Page 42
cfgdevice(8) Connection status between I/O unit and the system. SAS-status 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 ■...
Page 43
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. The CD-RW/DVD-RW and the tape connection is maintained even if the domain ■...
Page 44
cfgdevice(8) disable down enable disable down enable disable down enable EXAMPLES When the system is being powered off, reserves the connection of the CD- EXAMPLE 1 RW/DVD-RW drive unit and the tape drive unit to the port 0-0. cfgdevice -c attach -p 0-0 XSCF>...
Page 45
cfgdevice(8) drive unit set on the M9000 server with the expansion cabinet. cfgdevice -l XSCF> Current connection for DVD/DAT: port 0-0 Main chassis: port 0-0 Expansion chassis: port 8-0 Expander status Port No. IOU/SAS-status SAS-status ----------------------------------- enable enable disable down enable disable down enable...
Page 46
cfgdevice(8) prompts without displaying messages. cfgdevice -q -y -c attach -p 0-0 XSCF> The following exit values are returned: EXIT STATUS Successful completion. An error occurred. >0 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
clockboard(8) NAME clockboard - set or display the clock control unit used at system startup SYNOPSIS 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.
Page 48
clockboard(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010...
console(8) NAME console - connect to a domain console SYNOPSIS 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.
Page 50
console(8) 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: "#", "@", "^", "&", "?", "*", "=", ".", "|"...
deleteboard(8) NAME deleteboard - disconnect an eXtended System Board (XSB) from the domain configuration SYNOPSIS 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...
Page 52
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. Reserves disconnect of an XSB. If the -c option is omitted, "-c -c reset disconnect"...
Page 53
deleteboard(8) EXTENDED You can execute the deleteboard(8) command under the environment where ■ DESCRIPTION the following services, managed by the Solaris Service Management Facility (SMF), are in operation: Domain SP Communication Protocol (dscp service) is working properly and ■ the network with XSCF has been established Domain Configuration Server (dcs service) is working properly ■...
Page 54
deleteboard(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO addboard(8), moveboard(8), replacefru(8), setdcl(8), setupfru(8), showboards(8), showdcl(8), showdevices(8), showdomainstatus(8), showfru(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
deletecodactivation(8) NAME deletecodactivation - remove a Capacity on Demand (COD) activation key from the COD Hardware Activation database SYNOPSIS 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.
Page 56
deletecodactivation(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO 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 deletecodlicense - remove a Capacity on Demand (COD) right-to-use (RTU) license key from the COD license database SYNOPSIS 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.
Page 58
deletecodlicense(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO 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...
deletefru(8) NAME deletefru - delete a Field Replaceable Unit (FRU) SYNOPSIS 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.
Page 60
deletefru(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
deleteuser(8) NAME deleteuser - delete an XSCF user account SYNOPSIS 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.
Page 62
deleteuser(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
disableuser(8) NAME disableuser - disable an XSCF user account SYNOPSIS 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).
Page 64
disableuser(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
dumpconfig(8) NAME dumpconfig - save system configuration information to a file SYNOPSIS dumpconfig [-v ] [-V ] [ [-q] -{y|n} ] [-e [-P password ]] [-c comment ] [-u user ] [-p proxy [-t proxy_type ]] url dumpconfig -h DESCRIPTION The dumpconfig(8) command saves system configuration information, copying it from the XSCF to a file specified by the user.
Page 66
dumpconfig(8) -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.
Page 67
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 <...
Page 68
dumpconfig(8) Dumping the Configuration Using Https EXAMPLE 3 dumpconfig -V -p 129.145.155.166:8080 http://10.7.79.18/ XSCF> 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 >...
Page 69
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> Encrypting and Password Protecting the Configuration EXAMPLE 5 dumpconfig -v -e -P kamacuras -p 129.145.155.166:8080 http:/ XSCF>...
Page 70
dumpconfig(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
enableuser(8) NAME enableuser - enable an XSCF user account SYNOPSIS enableuser user enableuser -h DESCRIPTION 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.
Page 72
enableuser(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
exit(1) NAME exit - exit the XSCF shell SYNOPSIS exit DESCRIPTION The exit(1) command exits and closes the XSCF shell. No privileges are required to run this command. Privileges Refer to setprivileges(8) for more information. System Administration...
Page 74
exit(1) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
flashupdate(8) NAME flashupdate - update the firmware SYNOPSIS 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.
Page 76
flashupdate(8) 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: Major firmware release number Minor release number Micro release number Automatically answers "y"...
Page 77
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) OpenBoot PROM update has been completed (OpenBoot PROM version=02090000) XSCF update is started (XSCFU=0,bank=0,XCP version=1082:last version=1080) XSCF download is started (XSCFU=0,bank=0,XCP version=1082:last...
Page 78
flashupdate(8) EXIT STATUS The following exit values are returned: Successful completion An error occurred. >0 SEE ALSO version(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
fmadm(8) NAME fmadm - fault management configuration tool SYNOPSIS 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...
Page 80
fmadm(8) EXAMPLES Displaying the Fault Manager Configuration EXAMPLE 1 fmadm config XSCF> MODULE VERSION STATUS DESCRIPTION case-close active Case-Close Agent fmd-self-diagnosis 1.0 active Fault Manager Self-Diagnosis sysevent-transport active SysEvent Transport Agent syslog-msgs active Syslog Messaging Agent EXIT STATUS The following exit values are returned: Successful completion.
fmdump(8) NAME fmdump - view fault management logs SYNOPSIS 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).
Page 82
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. You must have platop, platadm, or fieldeng privileges to run this command. Privileges Refer to setprivileges(8) for more information.
Page 83
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.
Page 84
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.
Page 88
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 fmstat - report fault management module statistics SYNOPSIS 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.
Page 90
fmstat(8) The total number of cases solved by this module since it was solve loaded. The amount of dynamic memory currently allocated by this memsz module. The amount of persistent buffer space currently allocated by this bufsz module. You must have platadm, platop, or fieldeng privileges to run this command. Privileges Refer to setprivileges(8) for more information.
Page 91
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. EXAMPLES Displaying FM Statistics for the Syslog Module EXAMPLE 1...
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...
getflashimage(8) NAME getflashimage - download a firmware image file SYNOPSIS 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.
Page 94
getflashimage(8) OPERANDS The following operands are supported: 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...
Page 95
getflashimage(8) Download successful: 46827KB at 1016.857KB/s Checking file... MD5: e619e6dd367c888507427e58cdb8e0a0 Downloading a Version from an ftp Server EXAMPLE 2 getflashimage ftp://imageserver/images/FFXCP1041.tar.gz XSCF> Existing versions: Version Size Date FFXCP1040.tar.gz 46827123 Wed Mar 14 19:11:40 2007 Warning: About to delete existing versions. Continue? [y|n]: Removing FFXCP1040.tar.gz.
Page 96
getflashimage(8) 1MB received 2MB received 43MB received 44MB received 45MB received Download successful: 46827KB at 1016.857KB/s Checking file... MD5: e619e6dd367c888507427e58cdb8e0a2 Downloading Using a User Name and Password EXAMPLE 4 getflashimage -u jsmith XSCF> http://imageserver/images/FFXCP1041.tar.gz Existing versions: Version Size Date FFXCP1040.tar.gz 46827123 Wed Mar 14 19:11:40 2007 Warning: About to delete existing versions.
Page 97
getflashimage(8) Downloading From a USB Memory Stick EXAMPLE 5 getflashimage file:///media/usb_msd/images/FFXCP1041.tar.gz XSCF> Existing versions: Version Size Date FFXCP1040.tar.gz 46827123 Wed Mar 14 19:11:40 2007 Warning: About to delete existing versions. Continue? [y|n]: 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)
Page 98
getflashimage(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
ioxadm(8) NAME ioxadm - manage External I/O Expansion Units and add-in cards that contain Energy Storage Modules and are attached to the host system SYNOPSIS 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...
Page 100
ioxadm(8) OPTIONS The following options are supported. Forces command execution by ignoring warnings. Displays usage statement. When used with other options or operands, an error occurs. Displays text by page. Displays only parsable output, suppressing headers in that output. Fields are separated by single tabs. Displays verbose output.
Page 101
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. Displays electrical states: measured voltage, current, fan speed, switch settings. Displays LED states. Displays thermal readings. target See target in OPTIONS for a general description and the text below for information specific to env.
Page 102
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.
Page 103
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).
Page 104
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.
Page 106
ioxadm(8) Display all External I/O Expansion Units or downlink card paths EXAMPLE 3 ioxadm list XSCF> 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.
Page 107
ioxadm(8) Show runtime of card with ESM using verbose output EXAMPLE 7 ioxadm -v lifetime IOU#0-PCI#1 XSCF> Total Time On (% of life) Warning Time Fault Time IOU#0-PCI#1 1052370 1041120 1051200 Clear runtime of card with ESM, show runtime is cleared EXAMPLE 8 ioxadm lifetime -z IOU#0-PCI#1 XSCF>...
Page 108
ioxadm(8) IOX@X031 LOCATE Fast - LED ioxadm env -1 iox@x031/ps1 SERVICE XSCF> Location Sensor Value Resolution Units IOX@X031/PS1 SERVICE - 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.
man(1) NAME man - display manual pages of specified XSCF shell command SYNOPSIS man command_name ... man -h DESCRIPTION man(1) displays manual pages of specified XSCF shell command. No privileges are required to run this command. Privileges Refer to setprivileges(8) for more information. OPTIONS The following option is supported;...
Page 110
man(1) EXIT STATUS The following exit values are returned: Successful completion An error occurred. >0 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
moveboard(8) NAME moveboard - move an eXtended System Board (XSB) from the current domain to another SYNOPSIS 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 -h DESCRIPTION...
Page 112
moveboard(8) OPTIONS The following options are supported: Disconnects a configured XSB from its domain configuration and -c assign assigns it to the domain configuration of the move destination. If the -c option is omitted, "-c configure" is used. Disconnects a configured XSB from its domain configuration and -c configure configures it in the domain configuration of the move destination.
Page 113
moveboard(8) OPERANDS The following operand is supported: Specifies the XSB number to be moved. Multiple xsb operands are permitted, separated by spaces. The following xsb form is accepted: x–y where: An integer from 00–15. An integer from 0–3. EXTENDED You can execute the moveboard(8) command under the environment where the ■...
Page 114
moveboard(8) See the setdcl(8) and showdcl(8) commands for DCL. ■ EXAMPLES Disconnects XSB#00-0 from the current domain and attaches it to domain ID EXAMPLE 1 moveboard -d 1 00-0 XSCF> Reserves assignment of the XSB#00-0 to the domain ID 1. EXAMPLE 2 moveboard -d 1 -c reserve 00-0 XSCF>...
nslookup(8) NAME nslookup - refer to the DNS server for the host SYNOPSIS nslookup hostname nslookup -h DESCRIPTION nslookup(8) refers to the DNS server for the host. The following information is displayed: Server DNS server name Address IP address of DNS server Name Specified host name Address...
Page 116
nslookup(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010...
password(8) NAME password - manage user passwords and expiration settings SYNOPSIS 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.
Page 118
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.
Page 119
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.
Page 120
password(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009...
ping(8) NAME ping - send the ICMP ECHO_REQUEST packets to the network host or the network device SYNOPSIS 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.
Page 122
ping(8) EXAMPLES Sends the packet three times to a host named scf0-hostname0. EXAMPLE 1 ping -c 3 scf0-hostname0 XSCF> 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...
poweroff(8) NAME poweroff - turn off the power to the specified domain SYNOPSIS 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.
Page 124
poweroff(8) EXTENDED When the command is executed, a prompt to confirm execution of the command ■ DESCRIPTION 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 ■...
Page 125
poweroff(8) Turns off power to domains with domain IDs 0. EXAMPLE 2 poweroff -d 0 XSCF> DomainIDs to power off:00 Continue? [y|n]: 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". Forcibly turns off power to domains with domain IDs 0.
poweroff(8) "y" without displaying the prompt. poweroff -q -y -d 2 XSCF> The following exit values are returned: EXIT STATUS Successful completion. An error occurred. >0 SEE ALSO poweron(8), reset(8), showdomainstatus(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
Page 127
poweron(8) NAME poweron - turn on the power to the specified domain SYNOPSIS 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.
Page 128
poweron(8) When the poweron(8) command is executed, power-on results for each of the ■ specified domains are displayed in the following format: The power was turned on normally. Powering on Not Powering on An error occurred, and the power could not be turned on. An error message is displayed with Not Powering on.
Page 129
poweron(8) "y" to the prompt. poweron -y -d 0 XSCF> DomainIDs to power on:00 Continue? [y|n]: 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> Turns on power to domains with domain IDs 1.
Page 130
poweron(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
prtfru(8) NAME prtfru - display FRUID data on the system and External I/O Expansion Unit SYNOPSIS 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.
rebootxscf(8) NAME rebootxscf - reset the XSCF SYNOPSIS 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. ■...
Page 138
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.
replacefru(8) NAME replacefru - replace a field replaceable unit (FRU) SYNOPSIS 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. CPU/Memory Board unit (CMU) ■...
Page 140
replacefru(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
reset(8) NAME reset - reset the specified domain SYNOPSIS reset [ [-q] -{y|n}] -d domain_id level reset -h Note – Since the reset(8) command forcibly resets the system, this command may DESCRIPTION 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.
Page 142
reset(8) OPERANDS The following operand is supported: level Specifies the level of resetting. One of the following can be specified. This operand cannot be omitted. Resets the domain system. Instructs the Solaris OS of the domain to panic generate a panic. Resets the domain CPU.
Page 143
reset(8) *Note* This command only issues the instruction to reset. The result of the instruction can be checked by the "showlogs power". Resets domain ID 0. Suppresses prompts, and automatically answers "y" to EXAMPLE 3 all prompts. reset -q -y -d 0 por XSCF>...
Page 144
reset(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
resetdateoffset(8) NAME resetdateoffset - reset time of domains to match system time SYNOPSIS 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.
Page 146
resetdateoffset(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
restoreconfig(8) NAME restoreconfig - restore the system configuration information previously saved by dumpconfig SYNOPSIS 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.
Page 148
restoreconfig(8) -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.
Page 149
restoreconfig(8) EXAMPLES Restoring the Configuration using FTP EXAMPLE 1 restoreconfig -V -u manilla 129.145.155.156:8080 ftp:/ XSCF> 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.166) port 8080 * Proxy auth using (nil) with user ’’...
Page 150
restoreconfig(8) Restoring the Configuration Using http EXAMPLE 2 restoreconfig -V -p 129.145.155.166:8080 http://10.7.79.18/ XSCF> 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.18 Pragma: no-cache...
Page 151
restoreconfig(8) Restoring the Configuration Using https EXAMPLE 3 restoreconfig -v -V https://10.7.79.18/sollgell/ XSCF> 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.18) port 443 * error setting certificate verify locations, continuing anyway: CAfile: /home/ares/cross/fje/pwrqcc3/target_root/usr/share/ssl/certs/...
Page 152
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. Configuration backup created on Mon Aug 4 12:58:19 2008 from system ‘M3000’ with serial number ‘IKS08220xx’, version ‘19830000’ validating backup configuration data *** You will need to power-cycle the entire system after this operation is completed...
Page 153
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 <...
Page 154
restoreconfig(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
restoredefaults(8) NAME 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 SYNOPSIS 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.
Page 156
restoredefaults(8) EXAMPLES Restores the XSCF unit to the state as of the factory shipment. EXAMPLE 1 restoredefaults -c xscfu XSCF> 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.
sendbreak(8) NAME sendbreak - send a break signal to the specified domain SYNOPSIS 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"...
Page 162
sendbreak(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
setad(8) NAME setad - configure Active Directory SYNOPSIS setad enable|disable setad loadcert [[-q] -{y|n}] [-i n] [-u 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]...
Page 164
setad(8) You must have useradm privileges to run this command. Privileges Refer to setprivileges(8) for more information. OPTIONS The following options are supported: Displays usage statement. When used with other options or operands, an error occurs. -i n Sets an index marker, value 1 - 5. Automatically answers "n"...
Page 165
setad(8) OPERANDS The following operands are supported: enable|disable When used with no other operands, enable or disable the Active Directory feature. loadcert loadcert console prompts for certificate information to be entered at the console. Use this command to paste certificate information copied from a file. Terminate input with CTRL-D.
Page 166
setad(8) defaultrole Configure default privileges. If defaultrole is configured, users have privileges as specified by defaultrole after authentication; user group membership is not checked. If defaultrole is not configured, users’ privileges will be learned from Active Directory based on group membership.
Page 167
setad(8) expsearchmode Enable or disable expanded search mode. The default Active Directory functionality is intentionally restrictive to ensure proper security. Search criteria can be expanded to accommodate specific customer environments. The expanded search mode is disabled by default, which means the UserPrincipalName (UPN) is expected to have a fully qualified domain name suffix.
Page 168
setad(8) Loads certificate information for Alternate Server 4 from the console. EXAMPLE 5 setad loadcert -i 4 console XSCF> Warning: About to load certificate for Alternate Server 4: . Continue? [y|n]: y Please enter the certificate: -----BEGIN CERTIFICATE----- MIIETjCCAzagAwIBAgIBADANBgkqhkiG9w0BAQQFADB8MQswCQYDVQQGEwJVUzET MBEGA1UECBMKQ2FsaWZvcm5pYTESMBAGA1UEBxMJU2FuIERpZWdvMRkwFwYDVQQK ExBTdW4gTWljcm9zeXN0ZW1zMRUwEwYDVQQLEwxTeXN0ZW0gR3JvdXAxEjAQBgNV -----END CERTIFICATE----- CTRL-D...
Page 169
setad(8) Clears diagnostic messages from the log file, answering Yes to all prompts. EXAMPLE 12 setad log -y clear XSCF> Enables strictcertmode. EXAMPLE 13 setad strictcertmode enable XSCF> Configures the dnslocatorquery configuration. service represents the DNS EXAMPLE 14 query to be performed. The port ID is generally part of the record, but you can override it by using the format <PORT:portnumber>.
Page 170
setad(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010...
setaltitude(8) NAME setaltitude - set the altitude of the system or whether or not the air filter installed SYNOPSIS 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.
Page 172
setaltitude(8) 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 ■...
setarchiving(8) NAME setarchiving - configure the log archiving functionality SYNOPSIS 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 setarchiving(1M) manages the log archiving configuration. Persistent storage DESCRIPTION space on the Service Processor is limited. Some logs may grow to the point where old log entries must be overwritten or deleted.
Page 174
setarchiving(8) OPTIONS The following options are supported: 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...
Page 175
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.
Page 176
setarchiving(8) OPERANDS The following operands are supported: Activates the log archiving feature. Cannot be used with any enable options. De-activates the log archiving feature. Cannot be used with any disable options. EXAMPLES Setting the Archiving Target and Password EXAMPLE 1 setarchiving -t jsmith@somehost.company.com:/home/jsmith/ XSCF>...
setaudit(8) NAME setaudit - manage the system auditing functionality SYNOPSIS 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 setaudit(8) manages the collection of data on the use of system resources. Audit data provides a record of security-related system events.
Page 178
setaudit(8) -c classes=enable|disable Changes 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. For example, the class of audit-related events can be expressed as ACS_AUDIT, AUDIT or 16.
Page 179
setaudit(8) -c classes=enable|disable Changes 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. For example, the class of audit-related events can be expressed as ACS_AUDIT, AUDIT or 16.
Page 180
setaudit(8) -e events=enable|disable Changes the audit record generation policy for the specified audit events. events is a comma-separated list of audit events. An event may be specified by its numeric value or its name. The AEV_ prefix may be omitted. For example, the event for SSH login can be expressed as AEV_LOGIN_SSH, LOGIN_SSH or See showaudit -e all for a list of valid events.
Page 181
setaudit(8) -t percents Sets thresholds at which to issue a warning about local audit storage usage. percents is a comma-separated list of percentages of available space used. At most four values may be set. For example, values of 50, 75, 80, 90 would cause warnings to be issued when 50%, 75%, 80% and 90% respectively, of the available storage for audit records is consumed.
Page 182
setaudit(8) Enabling Auditing EXAMPLE 4 setaudit enable XSCF> Turns on writing of the audit records for the audit trail. Enabling Warnings EXAMPLE 5 setaudit -t 50,75 XSCF> Warnings will be sent at 50% capacity and 75% capacity. EXIT STATUS The following exit values are returned: Successful completion.
setautologout(8) NAME setautologout - set the session timeout time of the XSCF shell SYNOPSIS 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. You must have platadm or fieldeng privileges to run this command.
Page 184
setautologout(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
setcod(8) NAME setcod - set up the Capacity on Demand (COD) resources used for domains SYNOPSIS 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.
Page 186
setcod(8) OPERANDS 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. EXTENDED If you run the setcod command without specifying any options, the command DESCRIPTION prompts you for COD information.
Page 187
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 Set the COD Headroom CPUs to 0...
Page 188
setcod(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010...
setdate(8) NAME setdate - set the date and time of XSCF SYNOPSIS 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).
Page 190
setdate(8) 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 ■...
Page 191
setdate(8) Sets "January 27 16:59:00 2006" of the local time (JST) as the current time. Au- EXAMPLE 4 tomatically replies with "y" without displaying the prompt. setdate -q -y -s 012716592006.00 XSCF> XSCF> The reset continues after this point. EXIT STATUS The following exit values are returned: Successful completion.
Page 192
setdate(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010...
setdcl(8) NAME setdcl - set a domain component list (DCL) SYNOPSIS 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.
Page 194
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.
Page 195
setdcl(8) 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.
Page 196
setdcl(8) 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.
Page 197
setdcl(8) If no-io is specified for option, either of the following can be specified for value: Omits the use of I/O devices on a domain. true Does not omit the use of I/O devices on a false domain (default). If float is specified for option, either of the following can be specified for value: Gives a higher priority regarding floating true...
Page 198
setdcl(8) Sets policy=system for domain ID 0. EXAMPLE 3 setdcl -d 0 -s policy=system XSCF> Clear the XSBs associated with LSB#00 and #01 of domain ID 0. EXAMPLE 4 setdcl -d 0 -r 00 01 XSCF> EXIT STATUS The following exit values are returned: Successful completion.
setdomainmode(8) NAME setdomainmode - set the modes of operation for the specified domain SYNOPSIS 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: OpenBoot PROM diagnostic levels.
Page 200
setdomainmode(8) Host watchdog and suppress break signal reception, auto boot function, and ■ operational mode of CPU: Can run this command for all domains. platadm Can run this command only for your managed domains. domainadm Refer to setprivileges(8) for more information. OPTIONS The following options are supported: -d domain_id...
Page 201
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: Specifies the OpenBoot PROM diagnostic diag level. Specifies whether to enable or disable the secure host watchdog and suppress break signal reception.
Page 202
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: Specifies the OpenBoot PROM diagnostic diag level. Specifies whether to enable or disable the secure host watchdog and suppress break signal reception.
Page 203
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.
Page 204
setdomainmode(8) Domain CPU Value of CPU Current CPU operational mode CPU configuration of a system configuration Mode board which can be added by DR operation SPARC64 VII SPARC64 VI compatible Any CPU configuration compatible mode SPARC64 VII/VI auto or SPARC64 VI compatible Any CPU configuration mode compatible...
Page 205
setdomainmode(8) 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.
Page 206
setdomainmode(8) Cancels the setdomainmode(8) command execution that is in progress. EXAMPLE 3 setdomainmode -d 0 -m diag=none XSCF> Diagnostic Level :min -> none Secure Mode -> - Autoboot -> - CPU Mode :auto -> - The specified modes will be changed. Continue? [y|n]: Enables the auto boot function for domain ID 0.
Page 208
setdomparam(8) OPERANDS The following operands are supported: Sets false for the use-nvramrc? environment variable. use-nvramrc security-mode Sets none to the security-mode? environment variable. Restores the OpenBoot PROM environment variables to the set-defaults settings at the time of shipment from the factory EXTENDED When the command is executed, a prompt to confirm execution of the command DESCRIPTION...
Page 209
setdomparam(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 System Administration...
Page 210
setdomparam(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
setdscp(8) NAME setdscp - set the IP address assignments for the Domain to Service Processor Communications Protocol (DSCP) SYNOPSIS 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...
Page 212
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...
Page 213
setdscp(8) Assigning All DSCP Addresses EXAMPLE 1 setdscp -y -i 10.1.1.0 -m 255.255.255.0 XSCF> Commit these changes to the database? [y|n] : y Assigning an Alternative IP address to Domain 1 EXAMPLE 2 setdscp -d 1 -i 10.1.1.26 XSCF> Commit these changes to the database? [y|n] : Specifying a Netmask Address With -q and -y Options EXAMPLE 3 setdscp -q -y -i 10.1.1.0 -m 255.255.255.0...
setdualpowerfeed(8) NAME setdualpowerfeed - set dual power feed mode SYNOPSIS 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.
Page 216
setdualpowerfeed(8) Enables dual power feed mode in the system. Before rebooting the system, a EXAMPLE 2 message is displayed. setdualpowerfeed -s enable XSCF> disable -> enable NOTE: Dual power feed will be enabled the next time the platform is powered EXIT STATUS The following exit values are returned: Successful completion.
setemailreport(8) NAME setemailreport - set up the email report configuration data SYNOPSIS 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.
Page 218
setemailreport(8) OPTIONS The following options are supported: Displays usage statement. 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: Valid value entries for recipient are: Any valid company email account Sends test email.
Page 219
setemailreport(8) Enable Email Reporting Noninteractively EXAMPLE 4 setemailreport -s enable=yes -s XSCF> recipient=”useradm@company.com, adm2@company.com” Sending Test Email EXAMPLE 5 setemailreport -t XSCF> ..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 The following exit values are returned: Successful completion.
Page 220
setemailreport(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
sethostname(8) NAME sethostname - set a host name and a DNS domain name for an XSCF unit SYNOPSIS 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.
Page 222
sethostname(8) OPERANDS 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.
Page 223
sethostname(8) SEE ALSO applynetwork(8), setnameserver(8), showhostname(8) System Administration...
Page 224
sethostname(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010...
sethttps(8) NAME sethttps - start or stop the HTTPS service, which is used in the XSCF network. This command also performs authentication-related settings SYNOPSIS sethttps [ [-q] -{y|n}] -c enable sethttps -c disable sethttps -c gencsr country state | province locality organization organizationalunit common e-mail sethttps [ [-q] -{y|n}] -c genserverkey sethttps -c importca...
Page 226
sethttps(8) OPTIONS The following options are supported: -c {enable|disable} Specify whether to enable the HTTPS service. One of the following values can be specified. If none of them is specified, an error occurs. Starts the HTTPS service. enable Stops the HTTPS service. disable Creates a CSR.
Page 227
sethttps(8) If you omit the value, enclose a space in single or double quotation marks; for ■ example, " ". If you include symbols or blanks in a value, enclose the value in single or double ■ quotation marks; for example, "Kawasaki city". If you include a backslash or dollar mark in a value, put a backslash before the ■...
Page 228
sethttps(8) EXAMPLES Starts the HTTPS service. EXAMPLE 1 sethttps -c enable XSCF> Continue? [y|n] : Please reset the XSCF by rebootxscf to apply the https settings. Stops the HTTPS service. EXAMPLE 2 sethttps -c disable XSCF> Creates a CSR with the following settings: country: JP, state|province: Kanaga- EXAMPLE 3 wa, locality: Kawasaki, organization: Example, organizationalunit: develop- ment, common: scf-host, e-mail: abc@example.com...
Page 229
sethttps(8) Server key already exists. Do you still wish to update? [y|n] :y Enter passphrase: Verifying - Enter passphrase: Creates the private key of the web server. Automatically replies with "y" EXAMPLE 7 without displaying the prompt. sethttps -c genserverkey -q -y XSCF>...
Page 230
sethttps(8) -----END CERTIFICATE----- [Enter] [Ctrl]and[D] Specifies "\development" to organizationunit to create a CSR. EXAMPLE 9 sethttps -c gencsr JP Kanagawa Kawasaki Example \ XSCF> "\\development" scf-host abc@example.com EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO rebootxscf(8), showhttps(8)
setldap(8) NAME setldap - configure the Service Processor as a Lightweight Directory Access Protocol (LDAP) client SYNOPSIS 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 –...
Page 232
setldap(8) -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.
setldap(8) Setting the LDAP Timeout EXAMPLE 3 setldap -T 60 XSCF> showldap XSCF> user Bind Name: Base Distinguished Name: ou=people,dc=company,dc=com LDAP Search Timeout: Bind Password: LDAP Servers: None CERTS: None Setting the LDAP Server EXAMPLE 4 setldap -s ldap://company.com,ldaps://company2.com XSCF> showldap XSCF>...
Page 234
setldap(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO setlookup(8), showldap(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010...
setldapssl(8) NAME setldapssl - configure LDAP/SSL SYNOPSIS 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]...
Page 236
setldapssl(8) You must have useradm privileges to run this command. Privileges Refer to setprivileges(8) for more information. OPTIONS The following options are supported: Displays usage statement. When used with other options or operands, an error occurs. -i n Sets an index marker, value 1 - 5. Automatically answers "n"...
Page 237
setldapssl(8) OPERANDS The following operands are supported: enable|disable When used with no other operands, enable or disable LDAP/SSL. loadcert loadcert console prompts for certificate information to be entered at the console. Use this command to paste certificate information copied from a file. Terminate input with CTRL-D.
Page 238
setldapssl(8) server Configure the primary and up to five alternate LDAP/ SSL servers. To use a host name, DNS must be enabled. An IP address can be specified with port number; otherwise, the default port is used. logdetail Enable logging of LDAP/SSL authentication and authorization diagnostic messages at the specified detail level.
Page 239
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. usermap Only if usermapmode is enabled, configure the specified usermap parameter: attributeInfo Use the specified attribute information for user validation binddn Use the specified Distinguished Name for binding with the LDAP/SSL server...
Page 240
setldapssl(8) Loads certificate information for Alternate Server 4 from the console. EXAMPLE 5 setldapssl loadcert -i 4 console XSCF> Warning: About to load certificate for Alternate Server 4: . Continue? [y|n]: y Please enter the certificate: -----BEGIN CERTIFICATE----- MIIETjCCAzagAwIBAgIBADANBgkqhkiG9w0BAQQFADB8MQswCQYDVQQGEwJVUzET MBEGA1UECBMKQ2FsaWZvcm5pYTESMBAGA1UEBxMJU2FuIERpZWdvMRkwFwYDVQQK ExBTdW4gTWljcm9zeXN0ZW1zMRUwEwYDVQQLEwxTeXN0ZW0gR3JvdXAxEjAQBgNV -----END CERTIFICATE----- CTRL-D...
Page 241
setldapssl(8) Loads a server certificate for LDAP/SSL using a username and password. EXAMPLE 13 setldapssl loadcert -u yoshi \ XSCF> http://domain_2/UID_2333/testcert Sets logging of high-severity diagnostic messages. EXAMPLE 14 setldapssl logdetail high XSCF> Clears diagnostic messages from the log file, answering Yes to all prompts. EXAMPLE 15 setldapssl log -y clear XSCF>...
Page 242
setldapssl(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010...
setlocale(8) NAME setlocale - set the default locale of the XSCF SYNOPSIS 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. You must have platadm privileges to run this command. Privileges Refer to setprivileges(8) for more information.
Page 244
setlocale(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
setlocator(8) NAME setlocator - control the blinking of the CHECK LED on the operator panel SYNOPSIS 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: Start blinking Makes the CHECK LED blink.
Page 246
setlocator(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO showlocator(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised March 2008...
setloginlockout(8) NAME setloginlockout - enable or disable login lockout feature SYNOPSIS setloginlockout -s time setloginlockout -h DESCRIPTION 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.
Page 248
setloginlockout(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO showloginlockout(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
setlookup(8) NAME setlookup - enable or disable the use of the Lightweight Directory Access Protocol (LDAP) server for authentication and privilege lookup SYNOPSIS setlookup -a {local|ldap} setlookup -p {local|ldap} setlookup -h setlookup(8) sets whether authentication and privileges data are looked up in DESCRIPTION LDAP or not.
Page 250
setlookup(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO setldap(8), showlookup(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010...
setnameserver(8) NAME setnameserver - set the domain name system (DNS) servers and the DNS search paths used in the XSCF network SYNOPSIS setnameserver [-c add] address ... setnameserver -c del address ... setnameserver -c del -a setnameserver -c addsearch domainname... setnameserver -c delsearch domainname...
Page 252
setnameserver(8) Deletes specified DNS servers. If the -c option is omitted, "-c -c del add" is assumed specified. When deleting multiple DNS servers, the servers are deleted in the order they are specified. See EXAMPLE 3 Deletes specified DNS search path. If the -c option is omitted, -c delsearch "-c add"...
Page 253
setnameserver(8) 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 ■...
Page 254
setnameserver(8) Deletes all the registered domain names from the DNS search path. EXAMPLE 7 setnameserver -c delsearch -a XSCF> The following exit values are returned: EXIT STATUS Successful completion. An error occurred. >0 SEE ALSO applynetwork(8), sethostname(8), shownameserver(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010...
setnetwork(8) NAME setnetwork - set or remove an XSCF network interface SYNOPSIS 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.
Page 256
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. Enables the network interface. Disables the network interface. down Displays usage statement.
Page 257
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-LAN#0 xscf#0-lan#0 XSCF-LAN#1 xscf#0-lan#1 For abbreviation: an abbreviation of XSCF-LAN#0 lan#0 an abbreviation of XSCF-LAN#1 lan#1 In M8000/M9000 servers: ■...
Page 258
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. In the following cases, the setnetwork(8) command results in an error: ■...
Page 259
setnetwork(8) To reflect information on the specified network interface, execute the ■ applynetwork(8) command and reset XSCF. EXAMPLES Sets the IP address 192.168.10.10 and netmask 255.255.255.0 for XSCF-LAN#0 EXAMPLE 1 on XSCF unit 0. setnetwork xscf#0-lan#0 -m 255.255.255.0 192.168.10.10 XSCF> Sets the IP address 192.168.10.10 and netmask 255.255.255.0 for XSCF-LAN#0 EXAMPLE 2 on XSCF unit 0 in an M3000/M4000/M5000 server.
Page 260
setnetwork(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO applynetwork(8), rebootxscf(8), shownetwork(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010...
setntp(8) NAME 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 SYNOPSIS setntp [-c add] address ... setntp -c del address ... setntp -c del -a setntp -c stratum -i stratum_no setntp -m type= value...
Page 262
setntp(8) 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.
Page 263
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.
Page 264
setntp(8) Adds the two NTP servers ntp1.examples.com and ntp2.example.com. EXAMPLE 3 setntp ntp1.example.com ntp2.example.com XSCF> Please reset the XSCF by rebootxscf to apply the ntp settings. Sets the stratum value to 7. EXAMPLE 4 setntp -c stratum -i 7 XSCF> Please reset the XSCF by rebootxscf to apply the ntp settings.
setpacketfilters(8) NAME setpacketfilters - set the IP packet filtering rules to be used in the XSCF network SYNOPSIS setpacketfilters [ [-q] -{y|n}] -c {add | del} [-i interface] [-s address [ /mask]] -j target setpacketfilters [ [-q] -{y|n}] -c clear setpacketfilters -h The setpacketfilters(8) command sets the IP packet filtering rules to be used DESCRIPTION...
Page 266
setpacketfilters(8) OPTIONS The following options are supported: Specifies the operation to define the IP packet filtering rule. {add|del|clear} Any of the following can be specified. This option cannot be omitted. Adds an IP packet filtering rule. Deletes specified IP packet filtering rule. Clears all IP packet filtering rules which clear have been set.
Page 267
setpacketfilters(8) Automatically answers "n" (no) to all prompts. Suppresses all messages to stdout, including prompts. -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.
Page 268
setpacketfilters(8) EXAMPLES Drops the IP packet sent from the IP address 10.10.10.10. EXAMPLE 1 setpacketfilters -c add -s 10.10.10.10 -j DROP XSCF> -s 10.10.10.10/255.255.255.255 -j DROP NOTE: applied IP packet filtering rules. Continue? [y|n] : XSCF> On M3000/M4000/M5000 servers, communication to xscf#0-lan#0 exclusive- EXAMPLE 2 ly accepts those IP packets sent from the 192.168.100.0/255.255.255.0 net- work.
Page 269
setpacketfilters(8) Clears all IP packet filtering rules which have been set. EXAMPLE 4 setpacketfilters -c clear XSCF> (none) NOTE: applied IP packet filtering rules. Continue? [y|n] : XSCF> EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO showpacketfilters(8)
Page 270
setpacketfilters(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010...
setpasswordpolicy(8) NAME setpasswordpolicy - manage the system password policy SYNOPSIS 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.
Page 272
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.
Page 273
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.
Page 274
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.
setpowerupdelay(8) NAME setpowerupdelay - set the warm-up time of the system and wait time before system startup SYNOPSIS setpowerupdelay -c warmup -s time setpowerupdelay -c wait -s time setpowerupdelay -h The setpowerupdelay(8) command sets the warm-up time of the system and wait DESCRIPTION time before system startup.
Page 276
setpowerupdelay(8) Sets the wait time before system startup to 20 minutes. EXAMPLE 2 setpowerupdelay -c wait -s 20 XSCF> The following exit values are returned: EXIT STATUS Successful completion. An error occurred. >0 SEE ALSO showpowerupdelay(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2009...
setprivileges(8) NAME setprivileges - assign user privileges SYNOPSIS 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.
Page 278
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: Can perform all operations and view status on the domainadm hardware assigned to the domains on which this privilege is held (assign, unassign, power, and so on).
Page 279
setprivileges(8) The following are valid values for privileges: Can configure auditing. Can delete audit trail. auditadm Can view all audit state and audit trail. auditop Can perform all operations reserved for field engineers fieldeng and authorized service personnel. Cannot perform any operations on the Service Processor none that require privilege, even if privileges are set for the user in LDAP.
Page 280
setprivileges(8) SEE ALSO setpasswordpolicy(8), showuser(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
setroute(8) NAME setroute - set routing information for an XSCF network interface SYNOPSIS 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.
Page 282
setroute(8) 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.
Page 283
setroute(8) OPERANDS The following operand is supported: interface Specifies the network interface to be set with routing information. One of the following values can be specified: In M3000/M4000/M5000 servers: ■ For XSCF unit 0: XSCF-LAN#0 xscf#0-lan#0 XSCF-LAN#1 xscf#0-lan#1 For abbreviation: XSCF-LAN#0 lan#0 XSCF-LAN#1...
Page 284
setroute(8) 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.
Page 285
setroute(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO applynetwork(8), showroute(8) System Administration...
Page 286
setroute(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010...
setshutdowndelay(8) NAME setshutdowndelay - set the shutdown wait time at power interruption of the uninterruptible power supply (UPS) SYNOPSIS 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.
Page 288
setshutdowndelay(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
setsmtp(8) NAME setsmtp - set up the Simple Mail Transfer Protocol (SMTP) settings SYNOPSIS 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.
Page 290
setsmtp(8) OPTIONS The following options are supported: Displays usage statement. 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.
Page 291
setsmtp(8) Setting Up SMTP Authentication in Interactive Mode EXAMPLE 3 setsmtp XSCF> Mail Server [10.4.1.1]: Port [25]: smtp-auth Authentication Mechanism [none]: jsmith User Name []: ****** Password []: Reply Address [useradm@company.com]: Setting Up Mailserver With Invalid Authentication Mechanism EXAMPLE 4 setsmtp XSCF>...
Page 292
setsmtp(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
Page 294
setsnmp(8) -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.
Page 295
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).
Page 296
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).
Page 297
setsnmp(8) Stops the SNMP agent and changes the SNMP configuration to default 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.
Page 298
setsnmp(8) When used alone, activates the SNMP agent with support for all enable 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.
Page 299
setsnmp(8) EXAMPLES Setting Up System Information EXAMPLE 1 setsnmp -l sandiego -c username@company.com -d ff1 XSCF> Setting Up and SNMPv3 Trap Host With Password Options EXAMPLE 2 setsnmp addv3traphost -u jsmith -n 0x### -r SHA -a xxxxxxxx XSCF> -e yyyyyyyy fiche Setting Up and SNMPv3 Trap Host without Password Options EXAMPLE 3 setsnmp addv3traphost -u bob -i -r SHA fiche...
Page 300
setsnmp(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
setsnmpusm(8) NAME setsnmpusm - specify the SNMPv3 agent’s User-based Security Model (USM) configuration SYNOPSIS 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...
Page 302
setsnmpusm(8) OPERANDS The following operands are supported: Makes the supplied user known to the agent for subsequent clone 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.
Page 303
setsnmpusm(8) Makes the supplied user known to the agent for subsequent create 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).
Page 304
setsnmpusm(8) EXAMPLES Adding a User With Password Options EXAMPLE 1 setsnmpusm create -a SHA -p xxxxxxxx -e yyyyyyyy jsmith XSCF> Adding a User Without Specifying Password Options EXAMPLE 2 setsnmpusm create -a SHA bob XSCF> Authetication Password: Encryption Password: Cloning a User EXAMPLE 3 setsnmpusm clone -u sue joe XSCF>...
Page 306
setsnmpvacm(8) OPERANDS The following operands are supported: Sets access to a MIB view for the specified group. createaccess -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. creategroup -u username Specifies a valid user name.
Page 307
setsnmpvacm(8) Create a View of the Entire MIB EXAMPLE 2 setsnmpvacm createview -s .1 all_view XSCF> Create a View Where the Subtree Is Excluded EXAMPLE 3 setsnmpvacm createview -e -s .1.3.6.1.2.1.1 -m fe excl_view XSCF> Create Access EXAMPLE 4 setsnmpvacm createaccess -r all admin XSCF>...
Page 308
setsnmpvacm(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
setssh(8) NAME setssh - configure the settings for the Secure Shell (SSH) service used in the XSCF network SYNOPSIS 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...
Page 310
setssh(8) OPTIONS The following options are supported: Deletes all registered user public keys. Should be specified with "-c delpubkey." Registers the user public key. -c addpubkey Deletes the user public key. -c delpubkey -c {enable|disable} Specifies whether to enable the SSH service. One of the following values can be specified: Starts the SSH service.
Page 311
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 ■...
Page 312
setssh(8) Generates a SSH2 host public key, even if one already exists. Automatically EXAMPLE 6 replies with "y" to the prompt. setssh -c genhostkey -y XSCF> Host key already exists. The key will be updated. Continue? [y|n] :y Please reset the XSCF by rebootxscf to apply the ssh settings. Generates a host public key for SSH2.
Page 313
setssh(8) Specifies the public key number to delete the user public key. EXAMPLE 10 setssh -c delpubkey -s 1 XSCF> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAzFh95SohrDgpnN7zFCJCVNy+jaZPTjNDxcid QGbihYDCBttI4151Y0Sv85FJwDpSNHNKoVLMYLjtBmUMPbGgGVB61qskSv/ FeV44hefNCZMiXGItIIpK P0nBK4XJpCFoFbPXNUHDw1rTD9icD5U/wRFGSRRxFI+Ub5oLRxN8+A8=abcd@example.com Deletes all user public keys. EXAMPLE 11 setssh -c delpubkey -a XSCF> Restricts access from domain to the SSH service via DSCP. EXAMPLE 12 setssh -m dscp=deny XSCF>...
Page 314
setssh(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
settelnet(8) NAME settelnet - start or stop the Telnet service used in the XSCF network SYNOPSIS settelnet -c {enable | disable} settelnet -h DESCRIPTION settelnet(8) command starts or stops the Telnet service used in the XSCF network. Privileges You must have platadm privileges to run this command. Refer to setprivileges(8) for more information.
Page 316
settelnet(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO rebootxscf(8), showtelnet(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
settimezone(8) NAME settimezone - set the time zone and Daylight Saving Time of XSCF SYNOPSIS 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...
Page 318
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.
Page 319
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.
Page 320
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]] Greenwich mean time {+|–} Specifies "–" to set the standard time to the time which is ahead of GMT.
Page 321
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.
Page 322
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.
Page 323
settimezone(8) 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 ■...
Page 324
settimezone(8) the first Sunday of April 0:00(JST) to the first Sunday of September 0:00(JDT). settimezone -c adddst -b JST -o GMT-9 -d JDT -p GMT-10 -f XSCF> 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 Deletes the Daylight Saving Time information of current settings. EXAMPLE 5 settimezone -c deldst -b JST -o GMT-9 XSCF>...
setupfru(8) NAME setupfru - set up device hardware SYNOPSIS 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.
Page 326
setupfru(8) OPERANDS The following operands are supported: device Specifies the device to be set up. Only the following device can be specified: Physical system board (PSB) location Specifies the location of the device. Integer from 0–15. Specify only one location. In the M8000/M9000 server, the Quad-XSB configuration cannot be set in EXTENDED ■...
setupplatform(8) NAME setupplatform - set up platform specific settings SYNOPSIS 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.
Page 328
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: XSCF Network Settings ■ Internal DSCP Network ■ ■ ■ ■ HTTPS Server ■...
Page 329
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]: XSCF> setnetwork xscf#0-lan#0 -m 255.255.254.0 192.168.1.4 . . . Enabling ssh. EXAMPLE 3 setupplatform -p network XSCF> Do you want to set up the XSCF network interfaces? [y|n]: Do you want to set up the DSCP network? [y|n]: Do you want to set up the domain name service? [y|n]: Do you want to set up the network time protocol? [y|n]:...
Page 330
setupplatform(8) are switched on again. Do you want to reboot the XSCF now? [y|n]: XSCF> Setting the Time Zone. EXAMPLE 5 setupplatform -p timezone XSCF> Do you want to set up the XSCF time zone? [y|n]: Chassis time zone is already configured: XSCF time zone: US/Pacific Continue setting up the XSCF time zone? [y|n]: Africa/Abidjan...
Page 331
setupplatform(8) Enter number to choose time zone or return for next set of time zones: XSCF time zone: Africa/Freetown Is this setting correct? [y|n]: XSCF> settimezone -c settz -s Africa/Freetown Africa/Freetown XSCF> EXIT STATUS The following exit values are returned: Successful completion.
Page 332
setupplatform(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010...
showad(8) NAME showad - show Active Directory configuration and messages SYNOPSIS 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...
Page 334
showad(8) Appends to end of output the number of records in the log. 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. Displays text by page, like the more(1) command does.
showaltitude(8) NAME showaltitude - display the altitude of the system and whether the air filter installed SYNOPSIS 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.
Page 338
showaltitude(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
showarchiving(8) NAME showarchiving - display log archiving configuration and status SYNOPSIS showarchiving showarchiving [-e] [-v] showarchiving -h DESCRIPTION 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. Privileges Refer to setprivileges(8) for more information.
Page 340
showarchiving(8) User name which the Service Processor uses to Username for ssh login login to the archive host. Initial value is Not configured. The public key which the Service Processor Archive host public key uses to verify the identity of the archive host. This field is not displayed unless the -v option is specified.
Page 341
showarchiving(8) Archive host fingerprint - Server authentication disabled *** Connection to Archive Host *** Latest communication ----- None Connection status -------- None AUDIT LOGS OTHER LOGS ---------- ---------- Archive space limit Unlimited 2000 MB Archive space used Not monitored Not monitored Total archiving failures Unresolved failures Displaying Archiving Error Information...
Page 342
showarchiving(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised March 2008...
showaudit(8) NAME showaudit - display the current auditing system state SYNOPSIS showaudit showaudit [all] showaudit [-a users] [-c classes] [-e events] [-g] [-m] [-p] [-s] [-t] showaudit -h DESCRIPTION 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.
Page 344
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.
Page 345
showaudit(8) Displays the policy to follow when the audit trail reaches full capacity. Displays the following auditing states: Space consumed by local audit records ■ Free space remaining for local audit records ■ Number of audit records dropped (since the last boot) since the ■...
Page 346
showaudit(8) Displaying All Event Information EXAMPLE 3 showaudit -e all XSCF> 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 The following exit values are returned: Successful completion.
showautologout(8) NAME showautologout - display the session timeout time of the XSCF shell SYNOPSIS 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.
Page 348
showautologout(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
showboards(8) NAME showboards - display information on an eXtended System Board (XSB) SYNOPSIS 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.
Page 350
showboards(8) Domain assignment state of the XSB. Either of the following is Assignment displayed: The XSB cannot be used. The XSB may be Unavailable 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.
Page 351
showboards(8) Domain assignment state of the XSB. Either of the following is Assignment displayed: The XSB cannot be used. The XSB may be Unavailable 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.
Page 352
showboards(8) Incorporation state of XSB hardware resources into the Solaris OS Conf The resources are not connected to the Solaris The resources are incorporated in the Solaris Status of an initial diagnosis on an XSB Test The XSB cannot be recognized because it is Unmount not mounted or because it has an error.
Page 353
showboards(8) You must have one of the following privileges to run this command: Privileges 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. The following options are supported: OPTIONS Displays the state of XSBs configured in or assigned to a domain...
Page 354
showboards(8) 00-0 00(00) Assigned Passed Normal 00-1 00(01) Assigned Passed Normal 00-2 SP Available Passed Normal 00-3 02(00) Unavailable y Unknown Normal Displays detailed information on all mounted system boards. EXAMPLE 2 showboards -v -a XSCF> R DID(LSB) Assignment Conn Conf Test Fault ---- - -------- ---------- ---- ---- ----...
Page 355
showboards(8) Displays the system boards that are defined for domain ID 0 and located in EXAMPLE 6 the system board pool. showboards -d 0 -c sp XSCF> DID(LSB) Assignment Conn Conf Test Fault ---- -------- ---------- ---- ---- ---- ----- 00-2 SP Available Passed...
Page 356
showboards(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010...
showcod(8) NAME showcod - display Capacity on Demand (COD) configuration information SYNOPSIS 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.
Page 358
showcod(8) Displaying All COD Information EXAMPLE 2 The output shown is what you would see if you had platform privileges. showcod XSCF> Chassis HostID : 81000001 PROC Permits installed : 8 PROC Headroom Quantity : 0 PROC Permits reserved for domain 0 : 4 PROC Permits reserved for domain 1 : 0 PROC Permits reserved for domain 2 : 0 PROC Permits reserved for domain 3 : 0...
showcodactivation(8) NAME showcodactivation - display the current Capacity on Demand (COD) activation permits stored in the COD Hardware Activation database SYNOPSIS 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 hardware activation keys (COD keys).
Page 360
showcodactivation(8) EXAMPLES Displaying Verbose Permit Data EXAMPLE 1 showcodactivation -v XSCF> Description Expiration Count Status ----------- ----------- ----- ------- PROC NONE GOOD 01:84000000:000000001:0301010100:16:00000000:xxxxxxxxxxxxxxxxxxxxxx Displaying Raw Permit Data EXAMPLE 2 showcodactivation -r XSCF> 01:84000000:104:0301010100:3:00000000:xxxxxxxxxxxxxxx EXIT STATUS The following exit values are returned: Successful completion.
showcodlicense(8) NAME showcodlicense - display the current Capacity on Demand (COD) right-to-use (RTU) licenses stored in the COD license database SYNOPSIS 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.
Page 362
showcodlicense(8) EXAMPLES Displaying Verbose License Data EXAMPLE 1 showcodlicense XSCF> Description Expiration Count Status ----------- ----------- ----- ------- PROC NONE GOOD 01:84000000:000000001:0301010100:16:00000000:xxxxxxxxxxxxxxxxxxxxxx Displaying Raw License Data EXAMPLE 2 showcodlicense -r XSCF> 01:84000000:104:0301010100:3:00000000:xxxxxxxxxxxxxxx EXIT STATUS The following exit values are returned: Successful completion.
showcodusage(8) NAME showcodusage - display the current usage statistics for Capacity on Demand (COD) resources SYNOPSIS 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.
Page 364
showcodusage(8) EXTENDED The showcodusage -p resource command displays the following COD usage DESCRIPTION information for the system: Identifies the type of COD resources available (processors). Resource Specifies the number of COD CPUs currently used in the In Use system. Specifies the number of COD CPUs installed in the system. Installed Specifies the number of COD permits installed.
Page 365
showcodusage(8) Specifies the number of COD CPU resources installed in the Installed domain. Specifies the number of COD permits allocated to the domain. Reserved Contains one of the following when the -v option is specified: Status COD Permitted The domain COD CPU has a COD permit and is in use.
Page 366
showcodusage(8) Quad-XSB, CMU02 Uni-XSB showcodusage -v XSCF> Resource In Use Installed COD Permitted Status -------- ------ --------- ------------- ------ PROC OK: 0 available Headroom: 2 Domain/Resource In Use Installed Reserved Status --------------- ------ --------- -------- ------ - PROC 00-0 - PROC CMU00-CPU0 Unused 00-1 - PROC...
Page 367
showcodusage(8) 13 - PROC 14 - PROC 15 - PROC Unused - PROC Displaying COD Usage by Resource and Domain: M5000 Server EXAMPLE 4 showcodusage -v XSCF> Resource In Use Installed COD Permitted Status -------- ------ --------- ------------- ------ PROC OK: 0 available Domain/Resource In Use...
Page 368
showcodusage(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010...
showconsolepath(8) NAME showconsolepath - displays information on the domain console that is currently connected SYNOPSIS showconsolepath -a showconsolepath -d domain_id showconsolepath -h The showconsolepath(8) command displays information on the domain console DESCRIPTION that is currently connected. The following information can be displayed: User account of the XSCF connected to the domain console User Domain ID...
Page 370
showconsolepath(8) EXTENDED Only one writable console and one or more read-only consoles can be connected to DESCRIPTION one domain. EXAMPLES Displays console information on all domains that can be accessed. EXAMPLE 1 showconsolepath -a XSCF> User ro/rw escape Date nakagawa Fri Jul 29 21:23:34 hana Fri Jul 29 09:49:12...
showdate(8) NAME showdate - display the date and time of XSCF SYNOPSIS showdate [-u] showdate -h DESCRIPTION The showdate(8) command displays the date and time of XSCF. You must have one of the following privileges to run this command: Privileges useradm, platadm, platop, auditadm, auditop, domainadm, domainmgr, domainop, fieldeng Refer to setprivileges(8) for more information.
Page 372
showdate(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
showdateoffset(8) NAME showdateoffset - display the time differences between the time of the system and the time of the domains SYNOPSIS showdateoffset -d domain_id showdateoffset -a showdateoffset -h The showdateoffset(8) command displays the time differences between the time DESCRIPTION of the system, managed by the XSCF clock, and the time of the domains, which is managed by each domain clock in second.
Page 374
showdateoffset(8) system and the time of the domains with specifying the ID of the domain. showdateoffset XSCF> Domain Date Offset 128 sec On the M5000 server, displays the time differences between the time of the EXAMPLE 2 system and the time of the domains. showdateoffset XSCF>...
Page 375
showdateoffset(8) 901 sec 0 sec 0 sec -111 sec 0 sec 3 sec 21 sec -621 sec -9999999 sec EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO resetdateoffset(8) System Administration...
Page 376
showdateoffset(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
showdcl(8) NAME showdcl - display the current domain component list (DCL) SYNOPSIS 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.
Page 378
showdcl(8) Domain status. One of the following status is displayed. Status 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.
Page 379
showdcl(8) If the -v option is specified, the following information is added: Degradation range applicable for an error detected during an Cfg-policy initial diagnosis of hardware. Any of the following is displayed: Degradation of a component (default) Degradation of an XSB. System Degradation of a domain Whether to omit the use of memory on a domain.
Page 380
showdcl(8) OPTIONS The following options are supported:. 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. Displays usage statement.
Page 381
showdcl(8) 01-0 False True False 02-0 True True True 03-0 True True False Displays details in the DCL that are set for all domains. EXAMPLE 3 showdcl -v -a XSCF> Status No-Mem No-IO Float Cfg-policy Running 00-0 False False False 01-0 False True...
Page 382
showdcl(8) --------------------------------------------------------------- Running (Waiting for OS Shutdown) 01-2 True True False 04-0 False False False 05-0 True False False 06-0 True True True --------------------------------------------------------------- EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO addboard(8), deleteboard(8), moveboard(8), setdcl(8), setupfru(8), showboards(8), showdevices(8), showfru(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual •...
showdevices(8) NAME showdevices - display current information on an eXtended System Board (XSB) SYNOPSIS 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.
Page 384
showdevices(8) When memory is being disconnected, the following items are displayed: XSB number at the move destination target XSB Size of memory which was already deleted (MB) deleted mem remaining mem Size of remaining memory to be deleted (MB) I/O devices: Instance name of I/O device device Managed resource name...
Page 385
showdevices(8) Predicts system resources deleted from the Solaris OS when an -p force XSB is forcibly disconnected by "deleteboard -f" command. If the -p option is omitted, "-p bydevice" is used. Predicts system resources deleted from the Solaris OS when an -p query XSB is disconnected by deleteboard command.
Page 386
showdevices(8) and their available resources. showdevices 00-0 XSCF> CPU: ---- DID XSB state speed ecache 00-0 0 on-line 2530 00-0 1 on-line 2530 00-0 2 on-line 2530 00-0 3 on-line 2530 00-0 4 on-line 2530 00-0 5 on-line 2530 00-0 6 on-line 2530 00-0 7...
showdomainmode(8) NAME showdomainmode - display the modes of operation for the specified domain SYNOPSIS 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: Displays the host ID.
Page 390
showdomainmode(8) Displays the state of the auto boot function. One of the Autoboot following is displayed: Enabled Disabled Way of determining the CPU operational mode mounted on CPU Mode the domain. One of the following is displayed. auto Automatically determines at domain startup compatible Sets to the SPARC64 VI compatible mode regardless of the CPUs mounted...
Page 391
showdomainmode(8) 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 ■...
Page 392
showdomainmode(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2009...
showdomainstatus(8) NAME showdomainstatus - display the current domain component list (DCL) SYNOPSIS 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.
Page 394
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 The following options are supported. Displays status information on all domains that can be accessed. -d domain_id Specifies only one ID of the domain to be displayed.
showdscp(8) NAME showdscp - display the IP addresses assigned to the Domain to Service Processor Communications Protocol (DSCP) SYNOPSIS 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.
Page 396
showdscp(8) OPTIONS The following options are supported: -d domain_id Displays an individual domain’s IP address. Displays usage statement. When used with other options or operands, an error occurs. Generates parsable output. Displays the Service Processor’s IP address. Specifies verbose output. Prints additional information about internal progress of the program’s operations to the screen.
Page 398
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 The following exit values are returned: EXIT STATUS Successful completion. An error occurred. >0 SEE ALSO setdscp(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2008...
showdualpowerfeed(8) NAME showdualpowerfeed - display the current setting of dual power feed mode SYNOPSIS 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.
Page 400
showdualpowerfeed(8) SEE ALSO setdualpowerfeed(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009...
showemailreport(8) NAME showemailreport - display the email report configuration data SYNOPSIS showemailreport [-v ] showemailreport -h DESCRIPTION showemailreport(8) displays the email reporting configuration data. When used without options, it displays current email report configuration data. Privileges You must have platadm, platop or fieldeng privileges to run this command. Refer to setprivileges(8) for more information.
Page 402
showemailreport(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised June 2007...
showenvironment(8) NAME showenvironment - display the airflow volume, intake air temperature and humidity, temperature sensor, voltage sensor, fan speed, and power consumption information in the server SYNOPSIS showenvironment [-M] [ type] showenvironment -h DESCRIPTION showenvironment(8) command displays the information listed below. The following types of the information are displayed: Exhaust air Amount of exhaust air from the server...
Page 404
showenvironment(8) OPTIONS The following options are supported: Displays usage statement. When used with other options or operands, an error occurs. Displays text by page. This option provides a function that is the same as that of the more command. OPERANDS The following operand is supported: type Specifies the one of the type of information to be displayed.
Page 405
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 Displays voltage information about each component on the M4000 server. EXAMPLE 3 showenvironment volt XSCF> MBU_A 1.0V Power Supply Group:1.010V 1.8V Power Supply Group:1.700V CPUM#0-CHIP#0 1.0V Power Supply Group:1.000V CPUM#1-CHIP#0...
Page 406
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...
Page 407
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 PSU#3: 3835rpm PSU#3: 3970rpm Displays the fan speed information on the M3000 server. EXAMPLE 5 showenvironment Fan XSCF>...
Page 408
showenvironment(8) power supply). showenvironment power XSCF> Permitted AC power consumption:470W Actual AC power consumption:450W Displays power consumption information on the M3000 server (in case of DC EXAMPLE 7 power supply). showenvironment power XSCF> Permitted DC power consumption:470W Actual DC power consumption:450W Displays the volume of air exhausted from the M3000 server.
showfru(8) NAME showfru - display the hardware settings of specified device SYNOPSIS 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.
Page 410
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) location Specifies the location of device. If the device is "sb", an integer ranging from 00 to 15 can be specified. EXTENDED The setupfru(8) command makes hardware settings for a device.
showhardconf(8) NAME showhardconf - display information about field replaceable unit (FRU) installed in the system SYNOPSIS showhardconf [-u] [-M] showhardconf -h DESCRIPTION showhardconf(8) command displays information about each FRU. The following information is displayed: Current configuration and status ■ Number of installed FRUs ■...
Page 412
showhardconf(8) EXTENDED When the configuration and status information regarding FRUs and domain ■ DESCRIPTION information are displayed, for any failed or degraded unit, an asterisk (*) indicating an abnormal unit is displayed along with any of the following states: Status Description The component is faulty and is not operating Faulted...
Page 421
showhardconf(8) Type:4B; Size:4 GB; | IOU | XSCFU_B | XBU_B | CLKU_B | OPNL | PSU | FANBP_A | FANBP_B FAN_A | SWBP | MEDBP +-----------------------------------+------------+ Displays the information of the FRUs in the M3000 server (in case of AC pow- EXAMPLE 5 er supply).
showhostname(8) NAME showhostname - display the current host name for the XSCF unit SYNOPSIS 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. You must have one of the following privileges to run this command: Privileges useradm, platadm, platop, auditadm, auditop, domainadm, domainmgr,...
Page 426
showhostname(8) Displays the host name for XSCF unit 0. EXAMPLE 2 showhostname xscf#0 XSCF> xscf#0: scf0-hostname.example.com EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO sethostname(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
showhttps(8) NAME showhttps - display the status of the HTTPS service set for the XSCF network SYNOPSIS 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.
Page 428
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+2dABg8UdHmNAgMBAAGgADANBgkqhkiG9w0BAQQFAAOBgQAux1jH3dyB6Xho PgBuVIakDzIKEPipK9qQfC57YI43uRBGRubu0AHEcLVue5yTu6G5SxHTCq07tV5g 38UHSg5Kqy9QuWHWMri/hxm0kQ4gBpApjNb6F/B+ngBE3j/thGbEuvJb+0wbycvu 5jrhB/ZV9k8X/MbDOxSx/U5nF+Zuyw== -----END CERTIFICATE REQUEST----- EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO sethttps(8)
showldap(8) NAME showldap - display the Lightweight Directory Access Protocol (LDAP) configuration for the Service Processor SYNOPSIS showldap showldap [-c ] showldap -h showldap(8) displays the Service Processor LDAP configuration. When invoked DESCRIPTION without options, showldap displays all LDAP configuration except for the certificate chain and the password used when binding to the LDAP server.
Page 430
showldap(8) SEE ALSO setldap(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised June 2007...
showldapssl(8) NAME showldapssl - show LDAP/SSL configuration and messages SYNOPSIS 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...
Page 432
showldapssl(8) Appends to end of output the number of records in the log. 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. Displays text by page, like the more(1) command does.
showlocale(8) NAME showlocale - display the current setting for the XSCF locale SYNOPSIS showlocale showlocale -h DESCRIPTION The showlocale(8) command displays the current setting for the XSCF locale. Either of the following is displayed: English Japanese ja_JP.UTF-8 You must have one of the following privileges to run this command: Privileges useradm, platadm, platop, auditadm, auditop, domainadm, domainmgr, domainop...
Page 436
showlocale(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised March 2008...
showlocator(8) NAME showlocator - display the state of the CHECK LED on the operator panel SYNOPSIS 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: Indicates normal operation, which means either the circuit breaker is off or power is not being supplied.
Page 438
showlocator(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
showloginlockout(8) NAME showloginlockout - display the account lockout setting SYNOPSIS showloginlockout showloginlockout -h DESCRIPTION The showloginlockout(8) command displays the amount of time, in minutes, that a user is prevented from logging in after three failed attempts. Privileges You must have useradm privileges to run this command. Refer to setprivileges(8) for more information.
Page 440
showloginlockout(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
Page 442
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. Displays usage statement. When used with other options or operands, an error occurs.
Page 443
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.
Page 444
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.
Page 445
showlogs(8) OPERANDS The following operands are supported: Displays the error log. (sometimes includes scan log) error Displays the power log. power Displays the event log. event Displays the temperature and humidity record. Displays the monitoring message log. monitor Displays the console message log. console Displays the panic message log.
Page 446
showlogs(8) Case where the -V option is specified Date: Mar 30 17:45:31 JST 2005 Code: xxxxxxxx-xxxxxxxx-xxxxxxxxxxxxxxxx Status: Alarm Occurred: Mar 30 17:45:31.000 JST 2005 FRU: PSU#1,PSU#2,* Msg: ACFAIL occurred (ACS=3)(FEP type = A1) Diagnostic Code: xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx UUID: bf36f0ea-9e47-42b5-fc6f-c0d979c4c8f4 MSG-ID:FMD-8000-11 Diagnostic Messages:...
Page 447
showlogs(8) Log collection date and time (month day hour:minute:second Date: time-zone year) The displayed time is the local time. Error code Code: Data is displayed in 16-byte format. Date (Month Day Hour: Minute: Second TimeZone Year) when Occurred: an error occurred. This date is displayed as the local time.
Page 448
showlogs(8) Unique message ID MSG-ID: Detailed message Diagnostic Messages: If the log has a detailed message, it is displayed. Scan log code Detail log: This code is displayed when the log includes a scan log. Address: Displayed in hexadecimal notation. Power log ■...
Page 449
showlogs(8) Log collection date and time (month day hour:minute:second Date: time-zone year) The displayed time is the local time. Power status Event: One of the following states is displayed: The domain power is on. Domain Power On The domain power is off. Domain Power Off The system power is on.
Page 450
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 Date: time-zone year)
Page 451
showlogs(8) Log collection date and time (month day hour:minute:second Date: time-zone year) The displayed time is the local time. Intake air temperature Temperature: Decimal numbers are displayed to two decimal places. The unit is degree Celsius ( C). Humidity Humidity: The displayed numbers are percentages (%).
Page 452
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. Panic message log ■...
Page 453
showlogs(8) [Second line] IPL date and time (month day hour:minute:second time-zone Date: year) 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.
Page 454
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 Displays an error log in greater detail for the times of the specified EXAMPLE 3 timestamp (-V). showlogs error -p Mar3012:45:312005 -V XSCF>...
Page 455
showlogs(8) timestamp. showlogs power -r XSCF> Date Event Cause Switch Mar 30 17:50:31 JST 2005 Domain Power On Operator Service Mar 30 17:45:31 JST 2005 Domain Power Off Operator 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 Pow.Fail/Recov.--...
Page 456
showlogs(8) Mar 30 17:45:31 JST 2005 Executing last command: boot Mar 30 17:55:31 JST 2005 Boot device: /pci@83,4000/FJSV,ulsa@2,1/ disk@0,0:a File and args: 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. The following exit values are returned: EXIT STATUS Successful completion.
showlookup(8) NAME showlookup - display the configuration for authentication and privileges lookup SYNOPSIS showlookup showlookup -h DESCRIPTION showlookup(8) displays configuration settings for authentication and privileges. You must have useradm or fieldeng privileges to run this command. Privileges Refer to setprivileges(8) for more information. OPTIONS The following option is supported: Displays usage statement.
Page 458
showlookup(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
showmonitorlog(8) NAME showmonitorlog - display the contents of monitoring messages in real time SYNOPSIS 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.
Page 460
showmonitorlog(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
shownameserver(8) NAME shownameserver - display the registered domain name system (DNS) servers and the DNS search paths specified on the XSCF network SYNOPSIS shownameserver shownameserver -h DESCRIPTION shownameserver(8) command displays the registered DNS servers and the DNS search paths in the XSCF network. You must have one of the following privileges to run this command: Privileges useradm, platadm, platop, auditadm, auditop, domainadm, domainmgr,...
Page 462
shownameserver(8) DNS search path are set: shownameserver XSCF> nameserver --- search EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO setnameserver(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009...
shownetwork(8) NAME shownetwork - display information of network interfaces for XSCF SYNOPSIS 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.
Page 464
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. In the M3000/M4000/M5000 servers: ■...
Page 465
shownetwork(8) 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. ■...
Page 466
shownetwork(8) inet addr:192.168.10.128 Bcast: 192.168.10.255 Mask:255.255.255.0 UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:54424 errors:0 dropped:0 overruns:0 frame:0 TX packets:14369 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:(0.0 B) TX bytes:17010 (16.6 KiB) Base address:0x1000 Displays the information for XSCF-LAN#0 on XSCF Unit 0. EXAMPLE 4 shownetwork xscf#0-lan#0 XSCF>...
Page 467
shownetwork(8) Displays the information for XSCF unit 0 and XSCF unit 1 in the M8000/ EXAMPLE 7 M9000 servers. shownetwork -a XSCF> xscf#0-lan#0 Link encap:Ethernet HWaddr 00:00:00:12:34:56 inet addr: 192.168.11.10 Bcast: 192.168.11.255 Mask:255.255.255.0 UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:54424 errors:0 dropped:0 overruns:0 frame:0 TX packets:14369 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:12241827 (11.3 MiB)
Page 468
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 The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO setnetwork(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010...
shownotice(8) NAME shownotice - display copyright and license information for the XSCF Control Package (XCP) SYNOPSIS shownotice [-c {copyright|license}] shownotice -h DESCRIPTION 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.
Page 470
shownotice(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
showntp(8) NAME showntp - display the NTP information which currently set for XSCF SYNOPSIS showntp {-l | -a | address | -s | -m} showntp -h DESCRIPTION The showntp(8) command displays the NTP information currently set for XSCF. The showntp(8) command can display the following information: NTP servers which have been registered to the XSCF network ■...
Page 472
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 "."...
Page 473
showntp(8) Displays the stratum value which has been set to XSCF. EXAMPLE 3 showntp -s XSCF> stratum : 5 Displays whether a preferred server has been designated, and displays the EXAMPLE 4 clock address of the local clock. showntp -m XSCF>...
Page 474
showntp(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009...
showpacketfilters(8) NAME showpacketfilters - show the IP packet filtering rules that are set in the XSCF network SYNOPSIS showpacketfilters {-a | -l} [-M] showpacketfilters -h DESCRIPTION showpacketfilters(8) command shows the IP packet filtering rules that are set in the XSCF network. No privileges are required to run this command.
Page 476
showpacketfilters(8) ing rules in the XSCF network. showpacketfilters -l XSCF> pkts bytes target prot in source 0 DROP xscf#0-lan#0 172.16.0.0/255.255.0.0 0 DROP xscf#0-lan#0 10.10.10.10 0 DROP xscf#0-lan#1 10.10.10.10 0 ACCEPT xscf#0-lan#1 192.168.100.0/255.255.255.0 0 DROP xscf#0-lan#1 0.0.0.0/0.0.0.0 pkts bytes target prot in source 0 DROP xscf#1-lan#0...
showpasswordpolicy(8) NAME showpasswordpolicy - display the current password settings SYNOPSIS showpasswordpolicy showpasswordpolicy -h DESCRIPTION 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.
Page 478
showpasswordpolicy(8) SEE ALSO setpasswordpolicy(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
showpowerupdelay(8) NAME showpowerupdelay - display the current settings for the warm-up time of the system and wait time before system startup SYNOPSIS showpowerupdelay showpowerupdelay -h DESCRIPTION The showpowerupdelay(8) command displays the current settings for the warm- up time of the system and wait time before system startup. The following settings are displayed: Warm-up time warmup time...
Page 480
showpowerupdelay(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2008...
showresult(8) NAME showresult - display the exit status of the most recently executed command SYNOPSIS 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.
Page 482
showresult(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
showroute(8) NAME showroute - display routing information for an XSCF network interface SYNOPSIS 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.
Page 484
showroute(8) Displays usage statement. When used with other options or operands, an error occurs. Displays text by page. This option provides a function that is the same as that of the more command. Displays IP address without the name resolution of host name. OPERANDS The following operand is supported: interface...
Page 485
showroute(8) EXAMPLES Displays routing information for XSCF-LAN#0 on XSCF unit 0. EXAMPLE 1 showroute xscf#0-lan#0 XSCF> Destination Gateway Netmask Flags Interface server1.example * 255.255.255.0 xscf#0-lan#0 default 192.168.10.1 0.0.0.0 xscf#0-lan#0 Displays routing information for XSCF-LAN#0 on XSCF unit 0 without the EXAMPLE 2 name resolution of host name.
Page 486
showroute(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
showshutdowndelay(8) NAME showshutdowndelay - display the shutdown wait time at power interruption of the uninterruptible power supply (UPS) SYNOPSIS 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.
Page 488
showshutdowndelay(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
showsmtp(8) NAME showsmtp - display the Simple Mail Transfer Protocol (SMTP) configuration information SYNOPSIS showsmtp showsmtp [ -v ] showsmtp -h showsmtp(8) displays the SMTP configuration. When used without options, it DESCRIPTION displays current SMTP configuration data. You must have platadm or platop privileges to run this command. Privileges Refer to setprivileges(8) for more information.
Page 490
showsmtp(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
showsnmp(8) NAME showsnmp - display the configuration information and current status of the SNMP agent SYNOPSIS showsnmp showsnmp -h DESCRIPTION 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.
Page 492
showsnmp(8) System Location: SanDiego System Contact: bob@jupiter.west System Description: FF1 Trap Hosts: Hostname Port Type Community String Username Auth Protocol -------- ---- ---- ---------------- -------- -------------- host1 jsmith SNMP V1/V2c: None Enabled MIB Modules: None Displaying SNMP Information for a Enabled System Set Up With SNMPv1/ EXAMPLE 3 v2c Trap Host showsnmp...
Page 493
showsnmp(8) Community String: public Enabled MIB Modules: SP_MIB FM_MIB The following exit values are returned: EXIT STATUS Successful completion. An error occurred. >0 SEE ALSO setsnmp(8) System Administration...
Page 494
showsnmp(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
showsnmpusm(8) NAME showsnmpusm - display the current User-based Security Model (USM) information for the SNMP agent SYNOPSIS showsnmpusm showsnmpusm -h DESCRIPTION showsnmpusm(8) displays the current USM information for the SNMP agent. Privileges You must have platadm or platop privileges to run this command. Refer to setprivileges(8) for more information.
Page 496
showsnmpusm(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
showsnmpvacm(8) NAME showsnmpvacm - display the current View-based Access Control Access (VACM) information for the SNMP agent SYNOPSIS showsnmpvacm showsnmpvacm -h DESCRIPTION showsnmpvacm(8) displays the current VACM information for the SNMP agent. Privileges You must have platadm or platop privileges to run this command. Refer to setprivileges(8) for more information.
Page 498
showsnmpvacm(8) SEE ALSO setsnmpvacm(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
showssh(8) NAME showssh - display the settings of the Secure Shell (SSH) service that configured for the XSCF network SYNOPSIS showssh [-c hostkey] [-M] showssh -c pubkey [-u user_name] [-M] showssh -h showssh(8) command displays the current settings of the SSH service that DESCRIPTION configured for the XSCF network.
Page 500
showssh(8) Displays usage statement. When used with other options or operands, an error occurs. 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."...
Page 501
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 Displays the user public key of the current login user account. EXAMPLE 2 showssh -c pubkey XSCF> Public key: ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAzFh95SohrDgpnN7zFCJCVNy+jaZPTjNDxcid QGbihYDCBttI4151Y0Sv85FJwDpSNHNKoVLMYLjtBmUMPbGgGVB61qskSv/ FeV44hefNCZMiXGItIIpK P0nBK4XJpCFoFbPXNUHDw1rTD9icD5U/wRFGSRRxFI+Ub5oLRxN8+A8=abcd@example.com ssh-rsa CSqGSIb3DQEJARYHZWUubWFpbDCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEA nkPntf+TjYtyKlNYFbO/YavFpUzkYTLHdt0Fbz/ tZmGd3e6Jn34A2W9EC7D9hjLsj+kAP41Al6wFwGO7 KP3H4iImX0Uysjl9Hyk4jLBU51sw8JqvT2utTjltV5mFPKL6bDcAgY9=efgh@example.com EXIT STATUS...
Page 502
showssh(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
showstatus(8) NAME showstatus - display the degraded Field Replaceable Units (FRUs) SYNOPSIS showstatus [-M] showstatus -h DESCRIPTION showstatus(8) command displays information about degraded units that are among the FRUs composing the system. Privileges 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.
Page 504
showstatus(8) module in a CPU memory unit are degraded because of an error. showstatus XSCF> 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 EXAMPLE 2 board is degraded because of an error. showstatus XSCF>...
showtelnet(8) NAME showtelnet - display the current status of the Telnet service for the XSCF network SYNOPSIS 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: The Telnet service is enabled.
Page 506
showtelnet(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
showtimezone(8) NAME showtimezone - display the XSCF time zone and Daylight Saving Time information of current settings SYNOPSIS showtimezone -c tz showtimezone -c dst [-m {standard | custom}] showtimezone -h The showtimezone(8) command displays the XSCF time zone and Daylight Saving DESCRIPTION Time information of current settings.
Page 508
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. Name of Daylight Saving Time. offset2 Offset time of Daylight Saving Time and Greenwich mean time (GMT).
Page 509
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. Name of Daylight Saving Time. offset2 Offset time of Daylight Saving Time and Greenwich mean time (GMT).
Page 510
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"...
Page 511
showtimezone(8) dst name The settimezone(8) command sets the time zone of the XSCF. ■ EXAMPLES Displays the time zone. EXAMPLE 1 showtimezone -c tz XSCF> Asia/Tokyo Displays the Daylight Saving Time information as follows: the abbreviation EXAMPLE 2 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.
Page 512
showtimezone(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
showuser(8) NAME showuser - display user account information SYNOPSIS 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.
Page 514
showuser(8) EXAMPLES Displays Password and Account Validity Information EXAMPLE 1 showuser -a XSCF> User Name: jsmith Status: Enabled Minimum: Maximum: 99999 Warning: Inactive: Last Change: Aug 22, 2005 Password Expires: Never Password Inactive: Never Account Expires: Never Displays Privileges Information EXAMPLE 2 showuser -p XSCF>...
snapshot(8) NAME snapshot - collect and transfer environment, log, error, and FRUID data SYNOPSIS snapshot -d device [-r] [-e [-P password]] [-L {F|I|R}] [-l] [-v] [ [-q] -{y|n}] [-S time [-E time]] 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]]...
Page 516
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 .zip archive, the version of snapshot and whether log-only mode (the -l flag) was used to generate the archive.
Page 517
snapshot(8) Encrypts the zip archive. Required when using -P password. 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.
Page 518
snapshot(8) Encrypts the zip archive. Required when using -P password. 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.
Page 519
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.
Page 520
snapshot(8) EXTENDED Modes of Operation DESCRIPTION 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.
Page 521
snapshot(8) Setting up ssh connection to remote host... Collecting data into joe@jupiter.west:/home/joe/logs/x/archive.zip Data collection complete. Downloading With a User-Provided Public Key EXAMPLE 3 snapshot -t joe@jupiter.west:/home/joe/logs/x -k “ssh-rsa XSCF> AAAAB3NzaC1yc2EAAAABIwAAAIEAwVFiSQNVBFhTTzq0AX5iQqCkkJjd6ezWkVGt mMkJJzzMjYK0sBlhn6dGEIiHdBSzO8QLAXb8N4Kq8JDOBpLSN4yokUPTcZQNxJaY A0W058Qgxbn” Enter ssh password for user ‘joe’ on host ‘jupiter.west’ Setting up ssh connection to remote host...
Page 522
snapshot(8) Downloading Using No Key to Invalid Directory EXAMPLE 6 snapshot -t sue@saturn.north:/home/sue/logs/bad_dir -k none XSCF> 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 Downloading Public Key With Connectivity Failure...
Page 523
snapshot(8) Downloading Public Key Attempted by Unauthorized User EXAMPLE 9 snapshot -t fakeuser@fakehost.com:/fakedir -p fake-password XSCF> Downloading Public Key from ’fakehost.com’... Error downoading key for host ’fakehost.com’ Error opening SSH target Exiting with error 1 Downloading to External Media Device EXAMPLE 10 snapshot -d usb0 -r XSCF>...
Page 524
snapshot(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
switchscf(8) NAME switchscf - switch the XSCF unit between the active and standby states SYNOPSIS 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.
Page 526
switchscf(8) Switches the state of the XSCF unit to active. -t Active Switches the state of the XSCF unit to standby. -t Standby Automatically answers "y" (yes) to all prompts. EXTENDED When the command is executed, a prompt to confirm execution of the command DESCRIPTION with the specified options is displayed.
Page 528
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: Diagnoses all the PSB that are mounted. If the following conditions not satisfied, it leads to an error. The system has been powered off.
Page 529
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 ■...
Page 530
testsb(8) EXAMPLES Performs the initial diagnosis on PSB#00. EXAMPLE 1 testsb 0 XSCF> Initial diagnosis is about to start, Continue?[y|n] : 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.
Page 531
testsb(8) Performs the initial diagnosis on all the PSB that are mounted. EXAMPLE 3 testsb -c all XSCF> Initial diagnosis is about to start. Continue? [y|n] : SB power on sequence started. 0end Initial diagnosis started. [1800sec] 0..30..60..90..120end Initial diagnosis has completed.
Page 532
testsb(8) 00-0 Passed Normal 01-0 Passed Normal 02-0 Passed Normal 03-0 Passed Normal EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO addfru(8), deletefru(8), replacefru(8), setupfru(8), showboards(8), showfru(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
traceroute(8) NAME traceroute - display the route packets take to the specified network host or the network device SYNOPSIS 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.
Page 534
traceroute(8) 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.
Page 535
traceroute(8) XX.XX.XX.4 36 bytes to 192.168.100.10 2.516 ms 2.229 ms 2.357 ms 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 EXIT STATUS The following exit values are returned: Successful completion.
Page 536
traceroute(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
unlockmaintenance(8) NAME unlockmaintenance - forcibly release the locked status of XSCF SYNOPSIS 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.
Page 538
unlockmaintenance(8) Unlocks the maintenance lock status. Automatically answers "y" to all EXAMPLE 2 prompts. unlockmaintenance -y XSCF> 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 version - display firmware version SYNOPSIS 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: The comprehensive version of the XSCF control package (XCP) firmware currently applied to the system.
Page 540
version(8) XSCF#1 (Standby) XCP0 (Current): 1090 XCP1 (Reserve): 1090 Displays the details of the XCP version. EXAMPLE 2 version -c xcp -v XSCF> 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)
Page 541
version(8) Displays the version of OpenBoot PROM firmware. EXAMPLE 5 version -c cmu XSCF> 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 Displays the detailed version of OpenBoot PROM firmware. EXAMPLE 6 version -c cmu -v XSCF>...
Page 542
version(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
Page 544
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. Valid values for date-time are either absolute or offset: Absolute date-time : yyyymmdd[hh[mm[ss]]] where: yyyy = year (1970 is the earliest valid value) ■...
Page 545
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. Valid values for date-time are either absolute or offset: Absolute date-time : yyyymmdd[hh[mm[ss]]] where: yyyy = year (1970 is the earliest valid value) ■...
Page 546
viewaudit(8) -c classes Selects records in indicated 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. For example, the class of audit related events can be expressed as ACS_AUDIT, AUDIT or 16.
Page 547
viewaudit(8) -e events Selects records of the indicated events. events is a comma- separated list of audit events. An event may be specified by its numeric value or its name. The AEV_ prefix may be omitted. For example, the event for SSH login can be expressed as AEV_LOGIN_SSH, LOGIN_SSH or 4.
Page 548
viewaudit(8) -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. Prints in XML format. EXAMPLES Displaying Audit Records for December 12, 2005 EXAMPLE 1 viewaudit -D 20051212 XSCF>...
Page 549
viewaudit(8) Displaying Audit Records for Successful Access EXAMPLE 4 viewaudit -r success XSCF> 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 Displaying Audit Records Within a Range of Two Days EXAMPLE 5 viewaudit -A 20080108 -B +2d...
Page 550
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 The following exit values are returned: EXIT STATUS Successful completion. An error occurred. >0 SEE ALSO setaudit(8), showaudit(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
who(1) NAME who - display a list of the user accounts who are logged in to the XSCF SYNOPSIS who -h DESCRIPTION who(1) displays a list of the user accounts who are logged in to the XSCF. The following information is displayed: XSCF user account name ■...
Page 552
who(1) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
Need help?
Do you have a question about the Sun SPARC Enterprise M3000 and is the answer not in the manual?
Questions and answers