Fujitsu SPARC Enterprise M3000 Xscf Reference Manual
Fujitsu SPARC Enterprise M3000 Xscf Reference Manual

Fujitsu SPARC Enterprise M3000 Xscf Reference Manual

For xcp version 1110
Hide thumbs Also See for SPARC Enterprise M3000:
Table of Contents

Advertisement

SPARC Enterprise M3000/M4000/M5000/
M8000/M9000 Servers
XSCF Reference Manual for XCP Version 1110
Part No.: E27470-01,
Manual Code: C120-E668-01EN
January 2012

Advertisement

Table of Contents
loading

Summary of Contents for Fujitsu SPARC Enterprise M3000

  • Page 1 SPARC Enterprise M3000/M4000/M5000/ M8000/M9000 Servers XSCF Reference Manual for XCP Version 1110 Part No.: E27470-01, Manual Code: C120-E668-01EN January 2012...
  • Page 2 Oracle Corporation and its affiliates and FUJITSU LIMITED disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.
  • Page 3: Table Of Contents

    Contents Preface User and System Administration Commands Intro User Commands exit System Administration addboard addcodactivation addcodlicense addfru adduser applynetwork cfgdevice clockboard console deleteboard deletecodactivation deletecodlicense...
  • Page 4 deletefru deleteuser disableuser dumpconfig enableuser flashupdate fmadm fmdump fmstat getflashimage ioxadm moveboard nslookup password ping poweroff poweron prtfru rebootxscf replacefru reset resetdateoffset restoreconfig restoredefaults sendbreak setad setaltitude setarchiving setaudit setautologout setcod setdate setdcl setdomainmode SPARC Enterprise Mx000 Servers XSCF Reference Manual • January 2012...
  • Page 5 setdomparam setdscp setdualpowerfeed setemailreport sethostname sethttps setldap setldapssl setlocale setlocator setloginlockout setlookup setnameserver setnetwork setntp setpacketfilters setpasswordpolicy setpowerupdelay setprivileges setroute setshutdowndelay setsmtp setsnmp setsnmpusm setsnmpvacm setssh setsunmc settelnet settimezone setupfru setupplatform showad showaltitude showarchiving Contents...
  • Page 6 showaudit showautologout showboards showcod showcodactivation showcodactivationhistory showcodlicense showcodusage showconsolepath showdate showdateoffset showdcl showdevices showdomainmode showdomainstatus showdscp showdualpowerfeed showemailreport showenvironment showfru showhardconf showhostname showhttps showldap showldapssl showlocale showlocator showloginlockout showlogs showlookup showmonitorlog shownameserver shownetwork shownotice SPARC Enterprise Mx000 Servers XSCF Reference Manual • January 2012...
  • Page 7 showntp showpacketfilters showpasswordpolicy showpowerupdelay showresult showroute showshutdowndelay showsmtp showsnmp showsnmpusm showsnmpvacm showssh showstatus showsunmc showtelnet showtimezone showuser snapshot switchscf testsb traceroute unlockmaintenance version viewaudit Contents...
  • Page 8 viii SPARC Enterprise Mx000 Servers XSCF Reference Manual • January 2012...
  • Page 9: Preface

    Before reading this document, you should read the overview guide for your server the SPARC Enterprise M3000/M4000/M5000/M8000/M9000 Servers Administration Guide, and the SPARC Enterprise M3000/M4000/M5000/M8000/M9000 Servers XSCF User’s Guide. At publication of this document, servers described herein were shipping with XCP 1110 firmware supported or installed.
  • Page 10: Related Documentation

    SPARC Enterprise M3000 Server Overview Guide SPARC Enterprise M4000/M5000 Servers Overview Guide SPARC Enterprise M8000/M9000 Servers Overview Guide SPARC Enterprise M3000/M4000/M5000/M8000/M9000 Servers Important Legal and Safety Information SPARC Enterprise M3000 Server Safety and Compliance Guide SPARC Enterprise Mx000 Servers XSCF Reference Manual • January 2012...
  • Page 11 SPARC Enterprise M8000/M9000 Servers Service Manual External I/O Expansion Unit Installation and Service Manual SPARC Enterprise M3000/M4000/M5000/M8000/M9000 Servers Administration Guide SPARC Enterprise M3000/M4000/M5000/M8000/M9000 Servers XSCF User’s Guide SPARC Enterprise M3000/M4000/M5000/M8000/M9000 Servers XSCF Reference Manual SPARC Enterprise M4000/M5000/M8000/M9000 Servers Dynamic Reconfiguration (DR) User’s Guide SPARC Enterprise M4000/M5000/M8000/M9000 Servers Capacity on Demand (COD) User’s Guide...
  • Page 12: Text Conventions

    This font represents the example auditadm of command output in the frame. Italic Indicates the name of a reference See the SPARC Enterprise M3000/ manual, a variable, or user- M4000/M5000/M8000/M9000 replaceable text. Servers XSCF User’s Guide " " Indicates names of chapters, See Chapter 2, "System Features."...
  • Page 13: Documentation Feedback

    For Oracle users: ■ http://www.oracle.com/goto/docfeedback Include the title and part number of your document with your feedback: SPARC Enterprise M3000/M4000/M5000/M8000/M9000 Servers SPARC Enterprise M3000/M4000/M5000/M8000/M9000 Servers XSCF Reference Manual for XCP Version 1110, part number E27470-01. For Fujitsu users: ■...
  • Page 14 SPARC Enterprise Mx000 Servers XSCF Reference Manual • January 2012...
  • Page 15: User And System Administration Commands

    R E F E R E N C E User and System Administration Commands...
  • Page 17: Intro

    This Intro page lists the user commands (exit(1), man(1), and who(1)) and system administration commands (all the others, beginning with addboard(8)) provided by the XSCF firmware of the SPARC Enterprise M3000/M4000/M5000/M8000/ M9000 servers. Some XSCF commands have the same name as their Oracle Solaris OS counterpart, but function slightly differently.
  • Page 18 Intro(1) remove a Capacity on Demand (COD) deletecodactivation hardware activation key (COD key) from the COD database remove a Capacity on Demand (COD) deletecodlicense right-to-use (RTU) license key from the COD license database delete a Field Replaceable Unit (FRU) deletefru delete an XSCF user account deleteuser disable an XSCF user account...
  • Page 19 Intro(1) reset the XSCF rebootxscf replace a field replaceable unit (FRU) replacefru reset the specified domain reset reset time of domains to match system resetdateoffset time restore the system configuration restoreconfig information previously saved by dumpconfig restore factory settings of the server or restoredefaults XSCF unit send a break signal to the specified...
  • Page 20 Intro(1) start or stop the HTTPS service, which is sethttps used in the XSCF network. This command also performs authentication- related settings configure the Service Processor as a setldap Lightweight Directory Access Protocol (LDAP) client configure LDAP/SSL setldapssl set the default locale of the XSCF setlocale control the blinking of the CHECK LED setlocator...
  • Page 21 Intro(1) manage the SNMP agent setsnmp specify the SNMPv3 agent’s User-based setsnmpusm Security Model (USM) configuration modify the SNMPv3 agent’s View-based setsnmpvacm Access Control Model (VACM) configuration configure the settings for the Secure Shell setssh (SSH) service used in the XSCF network setsunmc start or stop the Sun Management Center agent and make changes to its...
  • Page 22 Intro(1) display the current Capacity on Demand showcodlicense (COD) right-to-use (RTU) licenses stored in the COD license database display the current usage statistics for showcodusage Capacity on Demand (COD) resources displays information on the domain showconsolepath console that is currently connected display the date and time of XSCF showdate display the time differences between the...
  • Page 23 Intro(1) display the status of the HTTPS service showhttps set for the XSCF network display the Lightweight Directory Access showldap Protocol (LDAP) configuration for the Service Processor show LDAP/SSL configuration and showldapssl messages display the current setting for the XSCF showlocale locale display the state of the CHECK LED on...
  • Page 24 Intro(1) display routing information for an XSCF showroute network interface display the shutdown wait time at power showshutdowndelay interruption of the uninterruptible power supply (UPS) display the Simple Mail Transfer Protocol showsmtp (SMTP) configuration information display the configuration information showsnmp and current status of the SNMP agent display the current User-based Security showsnmpusm...
  • Page 25 Intro(1) forcibly release the locked status of XSCF unlockmaintenance display firmware version version display audit records viewaudit Intro...
  • Page 26 Intro(1) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2011...
  • Page 27: User Commands

    R E F E R E N C E User Commands...
  • Page 29: Exit

    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. User Commands...
  • Page 30 exit(1) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 31: Man

    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: Displays usage statement.
  • Page 32 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 December 2010...
  • Page 33: Who

    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 34 who(1) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 35: System Administration

    R E F E R E N C E System Administration...
  • Page 37: Addboard

    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 38 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 - If the -f option is used to forcibly add an XSB to a domain, all the added hardware resources may not work normally.
  • Page 39 addboard(8) If "-c configure" is specified when either the domain power has been turned ■ off or the Oracle Solaris OS is not running, an error occurs. When "-c configure" is specified, hardware diagnosis is performed on the XSB ■ before it is incorporated into the domain.
  • Page 40 addboard(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised December 2010...
  • Page 41: Addcodactivation

    addcodactivation(8) NAME addcodactivation - add a Capacity on Demand (COD) hardware activation key (COD key) to the COD database SYNOPSIS addcodactivation key_signature addcodactivation -h DESCRIPTION addcodactivation(8) adds the specified COD key to the COD database on the Service Processor. This command is not available on the M3000 server. When the COD key is added, the quantity of headroom is reduced by the quantity provided by the key.
  • Page 42 addcodactivation(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised October 2010...
  • Page 43: Addcodlicense

    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 44 addcodlicense(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised December 2010...
  • Page 45: Addfru

    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 46 addfru(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
  • Page 47: Adduser

    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 48 adduser(8) EXAMPLES Creating a New User EXAMPLE 1 XSCF> adduser -u 359 jsmith EXIT STATUS The following exit values are returned: 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 •...
  • Page 49: Applynetwork

    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 50 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)) ■...
  • Page 51 applynetwork(8) 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] :y Please reset the XSCF by rebootxscf to apply the network settings. Please confirm that the settings have been applied by executing showhostname, shownetwork, showroute and shownameserver after rebooting the XSCF.
  • Page 52 applynetwork(8) 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 :down IP address netmask route interface :xscf#1-if status :down IP address :10.24.100.2 netmask :255.255.255.0 interface :lan#1 status :down...
  • Page 53 applynetwork(8) route :-n 0.0.0.0 -m 0.0.0.0 -g 10.24.144.1 interface :xscf#0-lan#1 status :down IP address netmask route Continue? [y|n] :y Please reset the XSCF by rebootxscf to apply the network settings. Please confirm that the settings have been applied by executing showhostname, shownetwork, showroute and shownameserver after rebooting the XSCF.
  • Page 54 applynetwork(8) Continue? [y|n] :y Please reset the XSCF by rebootxscf to apply the network settings. Please confirm that the settings have been applied by executing showhostname, shownetwork, showroute and shownameserver after rebooting the XSCF. EXIT STATUS The following exit values are returned: Successful completion.
  • Page 55: Cfgdevice

    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 56 cfgdevice(8) The current status of the drive that is displayed with this command includes the following types of status information: Port number of the port where the IOUA is installed and that port_no can be connected to the CD-RW/DVD-RW drive unit and the tape drive unit.
  • Page 57 cfgdevice(8) Automatically answers "n" (no) to all prompts. -p port_no Specifies the number of the port, in the specified domain, to which the CD-RW/DVD-RW drive unit and the tape drive unit is to be connected. port_no can be specified in the ’IOU number-PCI slot number’...
  • Page 58 cfgdevice(8) disable down enable disable down enable disable down enable disable down enable disable down enable disable down enable disable down enable disable down enable enable enable 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.
  • Page 59 cfgdevice(8) Displays the status of individual CD-RW/DVD-RW drive unit and the tape EXAMPLE 5 drive unit set on the M9000 server with the expansion cabinet. XSCF> cfgdevice -l Current connection for DVD/DAT: port 0-0 Main chassis: port 0-0 Expansion chassis: port 8-0 Expander status Port No.
  • Page 60 cfgdevice(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised October 2010...
  • Page 61: Clockboard

    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 62 clockboard(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010...
  • Page 63: Console

    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. Only one writable console and multiple read-only consoles can be connected to one domain.
  • Page 64 console(8) Suppresses all messages to stdout, including prompts. 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: "#", "@", "^", "&", "?", "*", "=", ".", "|"...
  • Page 65: Deleteboard

    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 66 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 67 deleteboard(8) Domain Configuration Server (dcs) ■ Orcacle Sun Cryptographic Key Management Daemon (sckmd) ■ 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.
  • Page 68 deleteboard(8) 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 December 2010...
  • Page 69: Deletecodactivation

    deletecodactivation(8) NAME deletecodactivation - remove a Capacity on Demand (COD) hardware activation key (COD key) from the COD database SYNOPSIS deletecodactivation [-f] key-signature deletecodactivation -h DESCRIPTION The deletecodactivation(8) command removes the specified COD key from the COD database on the Service Processor. This command is not available on the M3000 server.
  • Page 70 deletecodactivation(8) 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 October 2010...
  • Page 71: Deletecodlicense

    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 72 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 December 2010...
  • Page 73: Deletefru

    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 74 deletefru(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
  • Page 75: Deleteuser

    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 76 deleteuser(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 77: Disableuser

    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 78 disableuser(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 79: Dumpconfig

    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 proxty_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 80 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 81 dumpconfig(8) * Server auth using Basic with user ’minilla’ > PUT ftp://10.7.79.18/iktest/proxytest-ftp.cfg HTTP/1.1 Authorization: Basic bHdhbmc6bHdhbmc= User-Agent: dumpconfig Host: 10.7.79.18:21 Pragma: no-cache Accept: */* Content-Length: 24720 Expect: 100-continue < HTTP/1.1 100 Continue < HTTP/1.1 200 OK < Server: Sun-Java-System-Web-Proxy-Server/4.0 < Date: Mon, 04 Aug 2008 16:46:11 GMT <...
  • Page 82 dumpconfig(8) < HTTP/1.1 100 Continue < HTTP/1.1 204 No Content < Content-type: text/html < Date: Mon, 04 Aug 2008 16:42:46 GMT < Server: Apache/1.3.36 (Unix) mod_perl/1.29 mod_ssl/2.8.27 OpenSSL/ 0.9.7d < Via: 1.1 proxy-proxy < Proxy-agent: Sun-Java-System-Web-Proxy-Server/4.0 * Connection #0 to host 129.145.155.166 left intact * Closing connection #0 operation completed XSCF>...
  • Page 83 dumpconfig(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO restoreconfig(8) System Administration...
  • Page 84 dumpconfig(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised October 2010...
  • Page 85: Enableuser

    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 86 enableuser(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 87: Flashupdate

    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 88 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 89 flashupdate(8) 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 90 flashupdate(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 91: Fmadm

    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 ■...
  • Page 92 fmadm(8) EXAMPLES Displaying the Fault Manager Configuration EXAMPLE 1 XSCF> fmadm config MODULE VERSION STATUS DESCRIPTION case-close active Case-Close Agent fmd-self-diagnosis 1.0 active Fault Manager Self-Diagnosis sysevent-transport 1.0 active SysEvent Transport Agent syslog-msgs active Syslog Messaging Agent EXIT STATUS The following exit values are returned: Successful completion.
  • Page 93: Fmdump

    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 94 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 95 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 96 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 97 fmdump(8) Sep 06 12:40:59.2801 97de2cef-8ea1-407a-8a53-c7a67e61987a LINUX-8000-1N Sep 06 12:41:10.1076 fa7304f9-c9e8-4cd1-9ca5-e35f57d53b2c LINUX-8000-1N Sep 06 13:01:49.1462 ce550611-4308-4336-8a9a-19676f828515 LINUX-8000-1N Sep 06 15:42:56.6132 0f4b429f-c048-47cd-9d9f-a2f7b6d4c957 LINUX-8000-1N Sep 06 16:07:14.4652 7d5fb282-e01b-476a-b7e1-1a0f8de80758 LINUX-8000-1N Sep 06 16:08:16.3755 41379237-9750-4fd6-bce3-b5131d864d34 LINUX-8000-1N Sep 29 14:49:27.8452 0455ceaa-e226-424a-9b34-27603ca603f1 FMD-8000-58 Sep 29 15:02:00.3039 fb550ebc-80e9-41c8-8afc-ac680b9eb613 FMD-8000-58 Sep 29 15:09:25.4335 8cec9a83-e2a3-4dc3-a7cd-de01caef5c63 FMD-8000-4M Sep 29 15:10:09.6151 5f88d7d5-a107-4435-99c9-7c59479d22ed FMD-8000-58 Display in Verbose Mode...
  • Page 98 fmdump(8) Displaying the Full Fault Report for the Specified UUID EXAMPLE 4 XSCF> fmdump -V -u 5f88d7d5-a107-4435-99c9-7c59479d22ed TIME UUID MSG-ID Sep 29 15:10:09.6151 5f88d7d5-a107-4435-99c9-7c59479d22ed FMD-8000-58 TIME CLASS Sep 29 15:10:09.5652 ereport.io.iox.cp.seeprom0.nresp 0x921b650000000001 nvlist version: 0 version = 0x0 class = list.suspect uuid = 5f88d7d5-a107-4435-99c9-7c59479d22ed code = FMD-8000-58 diag-time = 1128021009 615016...
  • Page 99 fmdump(8) (end hc-list[0]) (end fru) (end fault-list[0]) Displaying Contents of the Fault Manager syslog Message EXAMPLE 5 XSCF> fmdump -m -M MSG-ID: FMD-8000-11, TYPE: Defect, VER: 1, SEVERITY: Minor EVENT-TIME: Tue Nov 7 07:01:44 PST 2006 PLATFORM: SUNW,SPARC-Enterprise, CSN: 7860000764, HOSTNAME: san-ff2-20-0 SOURCE: sde, REV: 1.5 EVENT-ID: 2daddee0-2f42-47ee-b5b2-57ae6a41bfc0 DESC: A Solaris Fault Manager component generated a diagnosis for which...
  • Page 100 fmdump(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised December 2010...
  • Page 101: Fmstat

    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 102 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 bufsz this module. You must have platadm, platop, or fieldeng privileges to run this command. Privileges Refer to setprivileges(8) for more information.
  • Page 103 fmstat(8) OPERANDS The following operands are supported: count Print only count reports, and then exit. interval Print a new report every interval seconds. If neither count nor interval is specified, a single report is printed and fmstat exits. If an interval is specified but no count is specified, fmstat prints reports every interval seconds indefinitely until the command is interrupted by Ctrl-C.
  • Page 104: Exit Status

    fmstat(8) fmd.wlentime 30us total wait length * time product fmd.wtime 30us total wait time on queue fmd.xprtlimit 256 limit on number of open transports fmd.xprtopen 0 total number of open transports fmd.xprtqlimit 256 limit on transport event queue length log_err 0 failed to log message to log(7D) msg_err 0 failed to log message to sysmsg(7D)
  • Page 105: Getflashimage

    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 106 getflashimage(8) -u user Specifies the user name when logging in to a remote ftp or http server that requires authentication. You will be prompted for a password. Displays verbose output. This may be helpful when diagnosing network or server problems. Automatically answers "y"...
  • Page 107 getflashimage(8) 43MB received 44MB received 45MB received Download successful: 46827KB at 1016.857KB/s Checking file... MD5: e619e6dd367c888507427e58cdb8e0a0 Downloading a Version from an ftp Server EXAMPLE 2 XSCF> getflashimage ftp://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 108 getflashimage(8) Download successful: 46827KB at 1016.857KB/s Checking file... MD5: e619e6dd367c888507427e58cdb8e0a2 Downloading Using a User Name and Password EXAMPLE 4 XSCF> getflashimage -u jsmith \ 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. Continue? [y|n]: y Removing FFXCP1040.tar.gz.
  • Page 109 getflashimage(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO flashupdate(8) System Administration...
  • Page 110 getflashimage(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised December 2010...
  • Page 111: Ioxadm

    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 112 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 113 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 114 ioxadm(8) If you specify a FRU in an I/O Expansion Unit or a card in a host slot as the target, env only displays environmentals about that FRU. If no -e, -l, or -t option is specified, the command displays all sensor information. If no sensors are specified, the command displays information about all sensors.
  • Page 115 ioxadm(8) led_type Used with the setled operand, specifies a software-controlled FRU LED. The following table indicates which LED states can be controlled using the setled operand with the off, on, fast, and slow LED state settings. Y (yes) indicates that the LED can be controlled, N (no) indicates that it cannot be controlled.
  • Page 116 ioxadm(8) locator [on |off] [target] Sets or queries the state of the locator indicator (LED). Without options, locator reports the current state of the LED on the specified FRU. A target argument is required when using the on or off field: Turns the LED on.
  • Page 117 ioxadm(8) setled [on|off|slow|fast] target led_type Sets LED state: Off. Fast blink. fast Slow blink. slow Refer to the entry for led_type in this section for detailed information about LED types. EXAMPLES Display temperature, voltage, current, and fan-speed sensor readings EXAMPLE 1 XSCF>...
  • Page 118 ioxadm(8) IOX@A3B5/IOB1 V_3_3V 3.291 0.002 IOX@A3B5/IOB1 V_3_3AUX 3.308 0.002 IOX@A3B5/IOB1 I_DC 8.600 0.200 Display all sensor readings on a link and suppress headers EXAMPLE 2 XSCF> ioxadm -p env iou#1-pci#1 IOU#1-PCI#1 DATA IOU#1-PCI#1 MGMT Flash Display all External I/O Expansion Units or downlink card paths EXAMPLE 3 XSCF>...
  • Page 119 ioxadm(8) Show runtime of card with ESM using verbose output EXAMPLE 7 XSCF> ioxadm -v lifetime Total Time On (% of life) Warning Time Fault Time IOU#0-PCI#1 183520 1008000 1051200 IOU#0-PCI#3 36660 Clear runtime of card with ESM, show runtime is cleared EXAMPLE 8 XSCF>...
  • Page 120 ioxadm(8) off and fast. If the push button is used to turn off the locator LED, fast blink FRU service LEDs are cleared. EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2011...
  • Page 121: Moveboard

    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 The moveboard(8) command disconnects an XSB from the current domain and,...
  • Page 122 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 123 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 on a source domain or a ■...
  • Page 124 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 XSCF> moveboard -d 1 00-0 Reserves assignment of the XSB#00-0 to the domain ID 1. EXAMPLE 2 XSCF>...
  • Page 125: Nslookup

    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 126 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...
  • Page 127: Password

    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.
  • Page 128 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 129 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 130 password(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009...
  • Page 131: Ping

    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 132 ping(8) EXAMPLES Sends the packet three times to a host named scf0-hostname0. EXAMPLE 1 XSCF> ping -c 3 scf0-hostname0 PING scf0-hostname0 (XX.XX.XX.XX): 56 data bytes 64 bytes from XX.XX.XX.XX: icmp_seq=0 ttl=64 time=0.1 ms 64 bytes from XX.XX.XX.XX: icmp_seq=1 ttl=64 time=0.1 ms 64 bytes from XX.XX.XX.XX: icmp_seq=2 ttl=64 time=0.1 ms --- scf0-hostname0 ping statistics --- 3 packets transmitted, 3 packets received, 0% packet loss...
  • Page 133: Poweroff

    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. After ordinary shutdown processing for the operating system is executed, the power is turned off.
  • Page 134 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 Oracle Solaris OS of the target domain is running, the poweroff(8) ■...
  • Page 135 poweroff(8) *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. EXAMPLE 3 XSCF> poweroff -f -d 0 DomainIDs to power off:00 The -f option will cause domains to be immediately resets.
  • Page 136 poweroff(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2011...
  • Page 137: Poweron

    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. You must have one of the following privileges to run this command: Privileges Can run this command for all domains.
  • Page 138 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 An error occurred, and the power could not be turned on. An Not Powering error message is displayed with Not Powering on.
  • Page 139 poweron(8) 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. Automatically replies with EXAMPLE 4 "y" without displaying the prompt. XSCF>...
  • Page 140 poweron(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2011...
  • Page 141: Prtfru

    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.
  • Page 142 prtfru(8) /frutree/chassis/iou0/IOU/slot3/LINK (container) /frutree/chassis/iou0/IOU/slot3/LINK/iox983392.IOX.iob1.PCIX.LINK (fru) /frutree/chassis/iox983392?Label=IOX@XCX031 /frutree/chassis/iox983392?Label=IOX@XCX031/IOX (container) /frutree/chassis/iox983392?Label=IOX@XCX031/IOX/ps0 /frutree/chassis/iox983392?Label=IOX@XCX031/IOX/ps0/A195 (container) /frutree/chassis/iox983392?Label=IOX@XCX031/IOX/ps1 /frutree/chassis/iox983392?Label=IOX@XCX031/IOX/ps1/A195 (container) /frutree/chassis/iox983392?Label=IOX@XCX031/IOX/iob1 /frutree/chassis/iox983392?Label=IOX@XCX031/IOX/iob1/PCIX (container) /frutree/chassis/iox983392?Label=IOX@XCX031/IOX/iob1/PCIX/LINK (container) /frutree/chassis/iox983392?Label=IOX@XCX031/IOX/iob1/PCIX/LINK/ iou0.IOU.slot3.LINK (fru) /frutree/chassis/MBU_B (container) /frutree/chassis/MBU_B/CPUM#0/CPUM (container) /frutree/chassis/MBU_B/CPUM#1/CPUM (container) /frutree/chassis/MBU_B/MEMB#0 (fru) /frutree/chassis/MBU_B/CPUM#1/CPUM (container) /frutree/chassis/MBU_B/MEMB#0 (fru) /frutree/chassis/MBU_B/MEMB#0/MEMB (container) /frutree/chassis/MBU_B/MEMB#0/MEMB/MEM#0/MEM (container) /frutree/chassis/MBU_B/MEMB#0/MEMB/MEM#1/MEM (container) /frutree/chassis/MBU_B/MEMB#0/MEMB/MEM#2/MEM (container) /frutree/chassis/MBU_B/MEMB#0/MEMB/MEM#3/MEM (container) /frutree/chassis/MBU_B/MEMB#0/MEMB/MEM#4/MEM (container)
  • Page 143 prtfru(8) /frutree/chassis/IOU#0 (fru) /frutree/chassis/IOU#0/IOU (container) /frutree/chassis/IOU#0/IOU/DDCR#0/DDCR (container) /frutree/chassis/FANBP_C#0 (fru) /frutree/chassis/FANBP_C#0/FANBP_C (container) Displaying A list of Containers EXAMPLE 2 XSCF> prtfru -lc /frutree/chassis/iou0/IOU/slot3/LINK (container) /frutree/chassis/iox983392?Label=IOX@XCX031/IOX (container) /frutree/chassis/iox983392?Label=IOX@XCX031/IOX/ps0/A195 (container) /frutree/chassis/iox983392?Label=IOX@XCX031/IOX/ps1/A195 (container) /frutree/chassis/iox983392?Label=IOX@XCX031/IOX/iob1/PCIX (container) /frutree/chassis/iox983392?Label=IOX@XCX031/IOX/iob1/PCIX/LINK (container) /frutree/chassis/MBU_B (container) /frutree/chassis/MBU_B/CPUM#0/CPUM (container) /frutree/chassis/MBU_B/CPUM#1/CPUM (container) /frutree/chassis/MBU_B/MEMB#0/MEMB (container) /frutree/chassis/MBU_B/MEMB#0/MEMB/MEM#0/MEM (container) /frutree/chassis/MBU_B/MEMB#0/MEMB/MEM#1/MEM (container) /frutree/chassis/MBU_B/MEMB#0/MEMB/MEM#2/MEM (container)
  • Page 144 prtfru(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO ioxadm(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
  • Page 145: Rebootxscf

    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 146 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.
  • Page 147: Replacefru

    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 148 replacefru(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 149: Reset

    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 Oracle Solaris OS hangs, and for other limited purposes.
  • Page 150 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 Oracle Solaris OS of the panic domain to generate a panic. Resets the domain CPU.
  • Page 151 reset(8) Resets domain ID 0. Suppresses prompts, and automatically answers "y" to EXAMPLE 3 all prompts. XSCF> reset -q -y -d 0 por Cancels the reset command execution that is in progress. EXAMPLE 4 XSCF> reset -d 0 panic DomainID to panic:00 Continue? [y|n]:n EXIT STATUS The following exit values are returned:...
  • Page 152 reset(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised December 2010...
  • Page 153: Resetdateoffset

    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 154 resetdateoffset(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised October 2010...
  • Page 155: Restoreconfig

    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 156 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 157 restoreconfig(8) EXAMPLES Restoring the Configuration using FTP EXAMPLE 1 XSCF> restoreconfig -V -u manilla 129.145.155.156:8080 \ ftp:/10.7.79.18/sollgell/proxytest-ftp.cfg transfer from ’/tmp/dumpconfig.EvY1Yf’ to ’ftp://10.7.79.18/sollgell/ proxytest-ftp.cfg’ Password: * About to connect() to 129.145.155.166 port 8080 Trying 129.145.155.166... * connected * Connected to 129.145.155.166 (129.145.155.166) port 8080 * Proxy auth using (nil) with user ’’...
  • Page 158 restoreconfig(8) Accept: */* < HTTP/1.1 200 OK < Content-length: 24603 < Content-type: text/plain < Date: Thu, 07 Aug 2008 17:07:43 GMT < Server: Apache/1.3.36 (Unix) mod_perl/1.29 mod_ssl/2.8.27 OpenSSL/ 0.9.7d < Last-modified: Mon, 04 Aug 2008 20:01:51 GMT < Etag: "4fa2a-601b-4897602f" <...
  • Page 159 restoreconfig(8) issuer: /C=US/ST=California/L=SanDiego/O=toho/OU=QT/CN=Lwang/ emailAddress=minilla.zilla@toho.com * SSL certificate verify result: error number 1 (20), continuing anyway. > GET /sollgell/proxytest.cfg HTTP/1.1 User-Agent: restoreconfig Host: 10.7.79.18 Pragma: no-cache Accept: */* < HTTP/1.1 200 OK < Date: Tue, 12 Aug 2008 22:02:12 GMT < Server: Apache/1.3.36 (Unix) mod_perl/1.29 mod_ssl/2.8.27 OpenSSL/ 0.9.7d <...
  • Page 160 restoreconfig(8) Restoring An Encrypted Configuration EXAMPLE 5 XSCF> restoreconfig -v -V -P encryption \ http://10.7.79.18/sollgell/proxytest.cfg obtaining lock ... done initiating file transfer from ’http://10.7.79.18/sollgell/proxytest.cfg’ ... transfer from ’/scf/firmtmp/hcp/config/config_file.bin’ to ’http://10.7.79.18/sollgell/proxytest.cfg’ * About to connect() to 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...
  • Page 161: Restoredefaults

    restoredefaults(8) NAME restoredefaults - restore factory settings of the server or XSCF unit SYNOPSIS restoredefaults -c range restoredefaults -h DESCRIPTION The restoredefaults(8) command restores factory settings and error information on either the server or the XSCF unit. To execute this command, connect to the XSCF over a serial connection. Used with the -c option, range is either factory, which restores settings and information to the server, or xscfu, which does so only to the specified XSCF unit.
  • Page 162 restoredefaults(8) If you need to move the XSCF unit to another server, please specify "-c xscfu". ■ The XSCF unit is restored to its factory state and the server is powered off. You can then move it to another server. If you specify "-c xscfu", information in the operator panel remains.
  • Page 163 restoredefaults(8) execute "setdefaults xscf" (AUTO) setdefaults : XSCF clear : start setdefaults : XSCF clear : DBS start setdefaults : XSCF clear : wait 20s for DBS initialization setdefaults : XSCF clear : common database clear complete setdefaults : XSCF clear : /bin/rm /var/log/lastlog >/dev/null 2>&1 setdefaults : XSCF clear : /bin/rm /var/log/boot.log >/dev/null 2>&1 setdefaults : XSCF clear : /bin/rm /hcpcommon/tmp/panel_up_to_date_fail >/dev/null 2>&1...
  • Page 164 restoredefaults(8) Restores the server. EXAMPLE 2 XSCF> restoredefaults -c factory WARNING: If this system does not have OPNL, this command will set all the user settable XSCF configuration parameters to their default value as they were set when the system was shipped out. Furthemore, this command will delete all logs on both XSCFUs.
  • Page 165 restoredefaults(8) setdefaults : FACTORY mode clear : /bin/rm /var/log/lastlog >/dev/null 2>&1 setdefaults : FACTORY mode clear : /bin/rm /var/log/boot.log >/dev/null 2>&1 setdefaults : FACTORY mode clear : /bin/rm /hcpcommon/tmp/ panel_up_to_date_fail >/dev... setdefaults : FACTORY mode clear : log data clear complete setdefaults : FACTORY mode clear : NVRAM(PAGE#0) clear complete setdefaults : FACTORY mode clear : NVRAM(PAGE#7) clear complete setdefaults : FACTORY mode clear : NVRAM reset complete...
  • Page 166 restoredefaults(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2012...
  • Page 167: Sendbreak

    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 Oracle Solaris OS of the domain, control is transferred from the Oracle Solaris OS to OpenBoot PROM and the OpenBoot PROM prompt "ok"...
  • Page 168 sendbreak(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised December 2010...
  • Page 169: Setad

    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]] URI 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 170 setad(8) 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" (no) to all prompts. Specifies the proxy server to be used for transfers.
  • Page 171 setad(8) group administrator Assign group name for up to five specified administrator groups. The administrator group has platadm, useradm, and auditadm privileges and you cannot change that. group operator Assign group name for up to five specified operator groups. The operator group has platop and auditop privileges and you cannot change that.
  • Page 172 setad(8) logdetail Enable logging of Active Directory authentication and authorization diagnostic messages at the specified detail level. This log is for use in troubleshooting and is cleared on SP reboot. Level can be one of the following: none Do not log diagnostic messages. Use this setting during normal system operation high...
  • Page 173 setad(8) strictcertmode Enable or disable strictcertmode mode. This mode is disabled by default; the channel is secure, but limited validation of the certificate is performed. If strictcertmode is enabled, the server’s certificate must have already been uploaded to the server so that the certificate signatures can be validated when the server certificate is presented.
  • Page 174 setad(8) -----END CERTIFICATE----- CTRL-D XSCF> Configures user domain 2. <USERNAME> is a template that must be EXAMPLE 6 entered exactly as shown. During authentication the user’s login name replaces <USERNAME>. userdomain can take the form of UPN or Distinguished Name (DN). XSCF>...
  • Page 175 setad(8) Configures the default privileges, where privileges are the same as those used EXAMPLE 15 in the setad group custom roles command. XSCF> setad defaultrole platadm platop The following exit values are returned: EXIT STATUS Successful completion. An error occurred. >0 SEE ALSO showad(8)
  • Page 176 setad(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised October 2010...
  • Page 177: Setaltitude

    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 178 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 ■...
  • Page 179: Setarchiving

    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(8) 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 180 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...
  • Page 181 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 182 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 XSCF>...
  • Page 183: Setaudit

    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 184 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 The following are valid classes: Denotes all classes.
  • Page 185 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 0.
  • Page 186 setaudit(8) -p suspend|count Sets the policy to follow when the audit trail becomes full. The following are valid values: All processes which try to write to audit records will be suspend suspended until either space becomes available and records can be written, or the policy is changed to count. New audit records are dropped and a count is kept of count how many records are dropped.
  • Page 187 setaudit(8) Auditing for LOGIN and AUDIT classes has been disabled. Auditing for READ class is enabled. Changing Classes Using Numbers EXAMPLE 2 XSCF> setaudit -c 8,16=disable -c 1=enable Auditing for classes 8 (LOGIN) and 16 (AUDIT) has been disabled. Auditing for class 1 (SYSTEM) is enabled.
  • Page 188 setaudit(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised October 2010...
  • Page 189: Setautologout

    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 190 setautologout(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 191: Setcod

    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 (COD keys) must be installed before COD boards in a domain can be utilized.
  • Page 192 setcod(8) OPERANDS The following operands are supported: headroom Amount of headroom (processors to be used on demand) 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...
  • Page 193 setcod(8) Set the COD Headroom CPUs to 0 EXAMPLE 2 XSCF> setcod 0 EXIT STATUS The following exit values are returned: Successful completion. >0 An error occurred. SEE ALSO SPARC Enterprise M4000/M5000/M8000/M9000 Servers Capacity on Demand (COD) User’s Guide System Administration...
  • Page 194 setcod(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised October 2010...
  • Page 195: Setdate

    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 196 setdate(8) When you use the setdate(8) command to set the time, it may affect the time ■ difference to the domain, and a gap of time may arise at the domain start. After you set the time, use the showdateoffset(8) command to confirm the time difference between XSCF and the domain.
  • Page 197 setdate(8) Sets "January 27 16:59:00 2006" of the local time (JST) as the current time. EXAMPLE 4 Automatically replies with "y" without displaying the prompt. XSCF> setdate -q -y -s 012716592006.00 XSCF> The reset continues after this point. EXIT STATUS The following exit values are returned: Successful completion.
  • Page 198 setdate(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised October 2010...
  • Page 199: Setdcl

    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. A DCL is hardware resource information that can be set for a domain or the logical system boards (LSBs) that are components of a domain.
  • Page 200 setdcl(8) The user can specify whether an operating system in the domain can use I/O devices, such as a PCI card, mounted on an LSB. Whether to set a priority for the specified LSB as a floating board, relative to ■...
  • Page 201 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 202 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 203 setdcl(8) Clear the XSBs associated with LSB#00 and #01 of domain ID 0. EXAMPLE 4 XSCF> setdcl -d 0 -r 00 01 EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO addboard(8), deleteboard(8), moveboard(8), setupfru(8), showboards(8), showdcl(8), showdevices(8), showfru(8) System Administration...
  • Page 204 setdcl(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised December 2010...
  • Page 205: Setdomainmode

    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 206 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 207 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 208 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 209 setdomainmode(8) CPU configuration of a system Domain CPU Value of CPU board which can be added by configuration Mode Current CPU operational mode DR operation SPARC64 VII+/VII compatible SPARC64 VI compatible Any CPU configuration mode SPARC64 VII+/VII auto or SPARC64 VI compatible Any CPU configuration and SPARC64 VI mode...
  • Page 210 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 211 setdomainmode(8) CPU Mode :auto -> - The specified modes will be changed. Continue? [y|n]:n Enables the auto boot function for domain ID 0. Suppresses prompts, and EXAMPLE 4 automatically answers "y" to all prompts XSCF> setdomainmode -q -y -d 0 -m autoboot=on EXIT STATUS The following exit values are returned: Successful completion.
  • Page 212 setdomainmode(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised December 2010...
  • Page 213: Setdomparam

    setdomparam(8) NAME setdomparam - forcibly rewrite OpenBoot PROM environment variables SYNOPSIS setdomparam [[-q] -{y|n}] -d domain_id use-nvramrc setdomparam [[-q] -{y|n}] -d domain_id security-mode setdomparam [[-q] -{y|n}] -d domain_id set-defaults setdomparam -h DESCRIPTION The setdomparam(8) command rewrites OpenBoot PROM environment variables of a specified domain.
  • Page 214 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 When the command is executed, a prompt to confirm execution of the command EXTENDED DESCRIPTION...
  • Page 215: Setdscp

    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 setdscp(8) assigns IP addresses to the DSCP links.
  • Page 216 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 217 setdscp(8) Assigning All DSCP Addresses EXAMPLE 1 XSCF> setdscp -y -i 10.1.1.0 -m 255.255.255.0 Commit these changes to the database? [y|n] : y Assigning an Alternative IP address to Domain 1 EXAMPLE 2 XSCF> setdscp -d 1 -i 10.1.1.26 Commit these changes to the database? [y|n] : y Specifying a Netmask Address With -q and -y Options EXAMPLE 3 XSCF>...
  • Page 218 setdscp(8) Domain #21 address [10.1.1.23 ] > [Enter] Domain #22 address [10.1.1.24 ] > [Enter] Domain #23 address [10.1.1.25 ] > [Enter] Commit these changes to the database [y|n]? y EXIT STATUS The following exit values are returned: Successful completion. An error occurred.
  • Page 219: Setdualpowerfeed

    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 220 setdualpowerfeed(8) Enables dual power feed mode in the system. Before rebooting the system, a EXAMPLE 2 message is displayed. XSCF> setdualpowerfeed -s enable 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.
  • Page 221: Setemailreport

    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 222 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 223 setemailreport(8) Sending Test Email EXAMPLE 5 XSCF> setemailreport -t ..Sending test email to useradm@company.com [Email contents shown below] Host Name: jupiter Send Timestamp: 04-20-2006 16:31:45 PST Mail Server: 10.4.1.1 EXIT STATUS The following exit values are returned: Successful completion. >0 An error occurred.
  • Page 224 setemailreport(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 225: Sethostname

    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 226 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 227: Sethttps

    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 228 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 229 sethttps(8) The order for specifying the operands with "-c selfsign" or "-c gencsr" is ■ fixed. Please see the SYNOPSIS section. If you specify spaces in a value, enclose the value in single or double quotation ■ marks; for example, " ". However, some operands are not allowed to specify the value with only spaces.
  • Page 230 sethttps(8) When you use sethttps(8) command to disable the HTTPS service (sethttps ■ -c disable), the HTTPS service is disabled immediately. At this time, any opened HTTPS sessions are terminated. For all other settings using the sethttps(8) command, you must reboot the XSCF using the rebootxscf(8) command for the changes to take effect.
  • Page 231 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. XSCF> sethttps -c genserverkey -q -y Enter passphrase: Verifying - Enter passphrase: Imports the web server certificate.
  • Page 232 sethttps(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO rebootxscf(8), showhttps(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2012...
  • Page 233: Setldap

    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 234 setldap(8) Sets the primary and secondary LDAP servers and ports. -s servers 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.
  • Page 235 setldap(8) Bind Password: LDAP Servers: None CERTS: None Setting the LDAP Server EXAMPLE 4 XSCF> setldap -s ldap://company.com,ldaps://company2.com XSCF> showldap user Bind Name: Base Distinguished Name: ou=people,dc=company,dc=com LDAP Search Timeout: Bind Password: LDAP Servers: ldap://company.com:389 ldaps://company2.com:636 CERTS: None Importing a Certificate EXAMPLE 5 XSCF>...
  • Page 236 setldap(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010...
  • Page 237: Setldapssl

    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 238 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 239 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 240 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 241 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...
  • Page 242 setldapssl(8) Loads certificate information for Alternate Server 4 from the console. EXAMPLE 5 XSCF> setldapssl loadcert -i 4 console Warning: About to load certificate for Alternate Server 4: . Continue? [y|n]: y Please enter the certificate: -----BEGIN CERTIFICATE----- MIIETjCCAzagAwIBAgIBADANBgkqhkiG9w0BAQQFADB8MQswCQYDVQQGEwJVUzET MBEGA1UECBMKQ2FsaWZvcm5pYTESMBAGA1UEBxMJU2FuIERpZWdvMRkwFwYDVQQK ExBTdW4gTWljcm9zeXN0ZW1zMRUwEwYDVQQLEwxTeXN0ZW0gR3JvdXAxEjAQBgNV -----END CERTIFICATE----- CTRL-D...
  • Page 243 setldapssl(8) Loads a server certificate for LDAP/SSL using a username and password. EXAMPLE 13 XSCF> setldapssl loadcert -u yoshi \ http://domain_2/UID_2333/testcert Sets logging of high-severity diagnostic messages. EXAMPLE 14 XSCF> setldapssl logdetail high Clears diagnostic messages from the log file, answering Yes to all prompts. EXAMPLE 15 XSCF>...
  • Page 244 setldapssl(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised October 2010...
  • Page 245: Setlocale

    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 246 setlocale(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 247: Setlocator

    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 248 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...
  • Page 249: Setloginlockout

    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 250 setloginlockout(8) SEE ALSO showloginlockout(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 251: Setlookup

    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 252 setlookup(8) SEE ALSO setldap(8), showlookup(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010...
  • Page 253: Setnameserver

    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... setnameserver -c delsearch -a setnameserver -h DESCRIPTION...
  • Page 254 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 255 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 256 setnameserver(8) EXIT STATUS The following exit values are returned: 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...
  • Page 257: Setnetwork

    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 258 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 259 setnetwork(8) OPERANDS The following operands are supported: address Specifies an IP address. To specify address, use the standard form of four integer values delimited by "." (periods). For example, use xxx.xxx.xxx.xxx, where xxx is an integer from 0-255. Zero suppression can be used to specify the integer. You cannot specify the loopback address (127.0.0.0/8), the network address, a broadcast address, or class D or E (224.0.0.0 - 255.255.255.255) address.
  • Page 260 setnetwork(8) EXTENDED In M8000/M9000 servers, a takeover IP address can be used without a need to ■ DESCRIPTION determine whether XSCF has been switched. By setting the LAN ports of the active XSCF unit as lan#0 and lan#1, they can be accessed with the names lan#0 and lan#1.
  • Page 261 setnetwork(8) xscf#0-if: ■ IP address: 192.168.1.1 Netmask: 255.255.255.0 xscf#1-if: ■ IP address: 192.168.1.2 Netmask: 255.255.255.0 The shownetwork(8) command can display current information on a network ■ interface configured for XSCF. To reflect information on the specified network interface, execute the ■...
  • Page 262 setnetwork(8) Continue? [y|n] :y If you choose 'y'es, you must execute 'applynetwork' command for application. Or you choose 'y'es, but you don't want to apply, you execute 'rebootxscf' for reboot. EXIT STATUS The following exit values are returned: Successful completion. An error occurred.
  • Page 263: Setntp

    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 setntp -h...
  • Page 264 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 265 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. You can specify up to three IP addresses or host names using a space as a delimiter. The host name can be specified in the format that complies with RFC 1034.
  • Page 266 setntp(8) Adds the two NTP servers ntp1.examples.com and ntp2.example.com. EXAMPLE 3 XSCF> setntp ntp1.example.com ntp2.example.com Please reset the XSCF by rebootxscf to apply the ntp settings. Deletes the first NTP server whose IP address is 192.168.1.2. This case is EXAMPLE 4 when a NTP server is listed multiple times.
  • Page 267: Setpacketfilters

    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 in the XSCF network.
  • Page 268 setpacketfilters(8) OPTIONS The following options are supported: SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010...
  • Page 269 setpacketfilters(8) 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 270 setpacketfilters(8) -j target Specifies action to be taken when the received IP packet matches the filtering rule, where target is one of the following: Permits the IP packet to go through ACCEPT Drops the IP packet DROP Automatically answers "n" (no) to all prompts. Suppresses all messages to stdout, including prompts.
  • Page 271 setpacketfilters(8) If a message indicates that the XSCF must be reset, do so using the ■ rebootxscf(8) command. . Use the showpacketfilters(8) command to display the current IP packet ■ filtering rules. EXAMPLES Drops the IP packet sent from the IP address 10.10.10.10. EXAMPLE 1 XSCF>...
  • Page 272 setpacketfilters(8) NOTE: applied IP packet filtering rules. Continue? [y|n] :y XSCF> The following exit values are returned: EXIT STATUS Successful completion. An error occurred. >0 SEE ALSO showpacketfilters(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010...
  • Page 273: Setpasswordpolicy

    setpasswordpolicy(8) NAME setpasswordpolicy - manage the system password policy SYNOPSIS setpasswordpolicy [-d dcredit] [-e expiry] [-i inactive] [-k diflk] [-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 274 setpasswordpolicy(8) -l lcredit Sets the maximum credit for lowercase letters in a password. The minimum acceptable password length is decreased by one for each lowercase letter in the password, up to lcredit value. Valid values are integers with value of 0 - 999999999. The initial setting is 1. See EXAMPLE 2.
  • Page 275 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 uppercase letter in the password, up to ucredit value. Valid values are integers with value of 0 - 999999999. The initial setting is 1. See EXAMPLE 2.
  • Page 276 setpasswordpolicy(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised May 2011...
  • Page 277: Setpowerupdelay

    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 278 setpowerupdelay(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO showpowerupdelay(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2009...
  • Page 279: Setprivileges

    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. Each of the 100 unique user can be assigned more than one privilege.
  • Page 280 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 281 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 none Processor that require privilege, even if privileges are set for the user in LDAP.
  • Page 282 setprivileges(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
  • Page 283: Setroute

    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 284 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 285 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 286 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 287: Setshutdowndelay

    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...
  • Page 289: Setsmtp

    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 Mailserver With Invalid Authentication Mechanism EXAMPLE 4 XSCF> setsmtp Mail Server [10.4.1.1]: Port [25]: Authentication Mechanism [none]: ? Invalid value ’?’. Valid authentication mechanism are: none pop smtp-auth Authentication Mechanism [none]: Reply Address [useradm@company.com]: EXIT STATUS The following exit values are returned: Successful completion.
  • Page 292 setsmtp(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 293: Setsnmp

    setsnmp(8) NAME setsnmp - manage the SNMP agent SYNOPSIS setsnmp enable [mib_name] setsnmp disable [mib_name] setsnmp addtraphost -t type -s community-string [-p trap-port] traphost setsnmp remtraphost -t type traphost setsnmp addv3traphost -u username -r authentication-protocol {-n engine_id | - i} [-a authentication-password] [-e encryption-password] [-p trap-port] traphost setsnmp remv3traphost -u username traphost setsnmp enablev1v2c read-only-community-string setsnmp disablev1v2c...
  • Page 294 setsnmp(8) OPERANDS The following operands are supported: SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 295 setsnmp(8) Enables the SNMP agent to send the chosen type of trap to the addtraphost desired host. If no trap-port is provided, the default is 162. A community string is mandatory. addtraphost takes the following options and operand: -p trap-port ID of the trap port.
  • 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 XSCF> setsnmp -l sandiego -c username@company.com -d ff1 Setting Up and SNMPv3 Trap Host With Password Options EXAMPLE 2 XSCF> setsnmp addv3traphost -u jsmith -n 0x### -r SHA -a xxxxxxxx \ -e yyyyyyyy fiche Setting Up and SNMPv3 Trap Host without Password Options EXAMPLE 3 XSCF>...
  • Page 300 setsnmp(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 301: Setsnmpusm

    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 XSCF> setsnmpusm create -a SHA -p xxxxxxxx -e yyyyyyyy jsmith Adding a User Without Specifying Password Options EXAMPLE 2 XSCF> setsnmpusm create -a SHA bob Authetication Password: Encryption Password: Cloning a User EXAMPLE 3 XSCF>...
  • Page 305: Setsnmpvacm

    setsnmpvacm(8) NAME setsnmpvacm - modify the SNMPv3 agent’s View-based Access Control Model (VACM) configuration SYNOPSIS setsnmpvacm creategroup -u username groupname setsnmpvacm deletegroup -u username groupname setsnmpvacm createview -s OID_subtree [-e] [-m OID_Mask] viewname setsnmpvacm deleteview -s OID_subtree viewname setsnmpvacm createaccess -r read_viewname groupname setsnmpvacm deleteaccess groupname setsnmpvacm -h DESCRIPTION...
  • Page 306 setsnmpvacm(8) OPERANDS The following operands are supported: createaccess Sets access to a MIB view for the specified group. -r read_viewname Specifies an SNMP Agent view. groupname Specifies a valid group name. Sets up a group for the specified user for view access. creategroup -u username Specifies a valid user name.
  • Page 307 setsnmpvacm(8) Create a View Where the Subtree Is Excluded EXAMPLE 3 XSCF> setsnmpvacm createview -e -s .1.3.6.1.2.1.1 -m fe excl_view Create Access EXAMPLE 4 XSCF> setsnmpvacm createaccess -r all admin EXIT STATUS The following exit values are returned: Successful completion. An error occurred.
  • Page 308 setsnmpvacm(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 309: Setssh

    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 [-b bits] setssh -h DESCRIPTION...
  • Page 310 setssh(8) Refer to setprivileges(8) for more information. OPTIONS The following options are supported: Deletes all registered user public keys. Should be specified with "-c delpubkey." -b bits Specifies the size of the RSA host public key to create. For bits, 1024 or 2048 can be specified. When this option is omitted, the size is regarded as 1024 bit.
  • Page 311 setssh(8) EXTENDED If you are an Active Directory or LDAP/SSL user, you cannot register the user ■ DESCRIPTION piblic key. Log in to the XSCF network through the SSH service by the authentication not with the user public key but with the password. The XCP 1110 firmware is the first XCP release to support the 2048-bit RSA host ■...
  • Page 312 setssh(8) Starts the SSH service. Automatically replies with "y" without displaying the EXAMPLE 3 prompt. XSCF> setssh -q -y -c enable Stops the SSH service. EXAMPLE 4 XSCF> setssh -c disable Generates a host public key. EXAMPLE 5 XSCF> setssh -c genhostkey Host key create.
  • Page 313 setssh(8) QGbihYDCBttI4151Y0Sv85FJwDpSNHNKoVLMYLjtBmUMPbGgGVB61qskSv/ FeV44hefNCZMiXGItIIpK P0nBK4XJpCFoFbPXNUHDw1rTD9icD5U/wRFGSRRxFI+Ub5oLRxN8+A8=abcd@example.com [Enter] [Ctrl]and[D] Specifies the public key number to delete the user public key. EXAMPLE 11 XSCF> setssh -c delpubkey -s 1 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAzFh95SohrDgpnN7zFCJCVNy+jaZPTjNDxcid QGbihYDCBttI4151Y0Sv85FJwDpSNHNKoVLMYLjtBmUMPbGgGVB61qskSv/ FeV44hefNCZMiXGItIIpK P0nBK4XJpCFoFbPXNUHDw1rTD9icD5U/wRFGSRRxFI+Ub5oLRxN8+A8=abcd@example.com Deletes all user public keys. EXAMPLE 12 XSCF> setssh -c delpubkey -a Restricts access from domain to the SSH service via DSCP.
  • Page 314 setssh(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2012...
  • Page 315: Setsunmc

    setsunmc(8) NAME setsunmc - start or stop the Sun Management Center agent and make changes to its configuration SYNOPSIS setsunmc [enable|disable] setsunmc [-s server] [-z seed] [-p agent_port] [-c community_string] [-t trap_port] [-e event_port] [-a SNMP_agent_port] [-d dmn_agent_port] setsunmc [-h] DESCRIPTION When invoked with one or more options, setsunmc makes changes to the Sun Management Center agent configuration, as described in the Options section.
  • Page 316 setsunmc(8) -s server Specifies the Sun Management Center server with which the agent will be communicating. The server can be specified using either a host name or an IP address. It must be set prior to enabling the agent. -t trap_port Specifies the port on the Sun Management Center server to which traps are sent.
  • Page 317: Settelnet

    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 318 settelnet(8) Stops the Telnet service. EXAMPLE 2 XSCF> settelnet -c disable Please reset the XSCF by rebootxscf to apply the telnet settings. The following exit values are returned: EXIT STATUS Successful completion. An error occurred. >0 SEE ALSO rebootxscf(8), showtelnet(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual •...
  • Page 319: Settimezone

    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 320 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 321 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 322 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 323 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 324 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 325 settimezone(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO setdate(8), showdate(8), showtimezone(8) System Administration...
  • Page 326 settimezone(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised October 2010...
  • Page 327: Setupfru

    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 328 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 ■...
  • Page 329: Setupplatform

    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 330 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 331: Setting The Time Zone

    setupplatform(8) Enabling ssh. EXAMPLE 3 XSCF> setupplatform -p network Do you want to set up the XSCF network interfaces? [y|n]: n Do you want to set up the DSCP network? [y|n]: n Do you want to set up the domain name service? [y|n]: n Do you want to set up the network time protocol? [y|n]:n Do you want to set up ssh? [y|n]: y Enable ssh service? [y|n]: y...
  • Page 332 setupplatform(8) Africa/Bissau Africa/Blantyre Africa/Brazzaville Africa/Bujumbura Africa/Cairo Africa/Casablanca Africa/Ceuta Africa/Conakry Africa/Dakar Africa/Dar_es_Salaam Africa/Djibouti Africa/Douala Africa/El_Aaiun Africa/Freetown Africa/Gaborone Enter number to choose time zone or return for next set of time zones: 21 XSCF time zone: Africa/Freetown Is this setting correct? [y|n]: y XSCF>...
  • Page 333: Showad

    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.
  • Page 335 showad(8) valid from = Apr 18 05:38:36 2009 GMT valid until = Apr 16 05:38:36 2019 GMT version = 3 (0x02) Displays specified diagnostic messages. EXAMPLE 3 XSCF> showad log -S 5 -E 10 Thu Sep 2 01:43 2009 (ActDir): -error- authentication status: auth-ERROR Thu Sep 2 01:44 2009 (ActDir): -error- authentication status: auth-ERROR Thu Sep 2 01:47 2009 (ActDir): -error- authentication status: auth-ERROR Thu Sep 2 01:51 2009 (ActDir): -error- authentication status: auth-ERROR...
  • Page 336 showad(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised October 2010...
  • Page 337: Showaltitude

    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...
  • Page 339: Showarchiving

    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 Username for ssh login to 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) *** 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 EXAMPLE 2 XSCF>...
  • Page 342 showarchiving(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised March 2008...
  • Page 343: Showaudit

    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 audit trail reached full capacity.
  • Page 346 showaudit(8) 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. An error occurred. >0 SEE ALSO setaudit(8), viewaudit(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010...
  • Page 347: Showautologout

    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...
  • Page 349: Showboards

    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. One of the following is Assignment displayed: The XSB is in the system board pool (not Unavailable assigned to a domain) and its status is one of the following: not-yet diagnosed, under diagnosis, or diagnosis error. All XSBs that are not mounted are also shown as Unavailable.
  • Page 351 showboards(8) Incorporation state of XSB hardware resources into the Oracle Conf Solaris OS The resources are not connected to the Oracle Solaris OS. The resources are incorporated in the Oracle Solaris OS. Status of an initial diagnosis on an XSB Test The XSB cannot be recognized because it is Unmount...
  • Page 352 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. OPTIONS The following options are supported: Displays the state of XSBs configured in or assigned to a domain...
  • Page 353 showboards(8) 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 XSCF> showboards -v -a R DID(LSB) Assignment Conn Conf Test Fault ---- - -------- ---------- ---- ---- ---- ----- 00-0...
  • Page 354 showboards(8) 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), showcodusage(8), showdcl(8), showdevices(8), showfru(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised December 2010...
  • Page 355: Showcod

    showcod(8) NAME showcod - display Capacity on Demand (COD) information SYNOPSIS showcod [-v] [-d domain_id] showcod -h DESCRIPTION showcod(8) displays COD information which includes the headroom amount, number of installed COD hardware activation permits (COD permits), the number of COD permits reserved for domains, and the Chassis Hostid. The showcod(8) command is not supported on the M3000 server.
  • Page 356 showcod(8) Displaying All COD Information EXAMPLE 2 The output shown is what you might see if you had platform privileges. XSCF> showcod 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...
  • Page 357: Showcodactivation

    showcodactivation(8) NAME showcodactivation - display the current Capacity on Demand (COD) hardware activation permits (COD permits) stored in the COD database SYNOPSIS showcodactivation [-r] [-v] showcodactivation -h DESCRIPTION showcodactivation(8) displays information stored in the COD 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 358 showcodactivation(8) EXAMPLES Displaying Verbose Permit Data EXAMPLE 1 XSCF> showcodactivation -v Description Expiration Count Status ----------- ----------- ----- ------- PROC NONE GOOD 01:84000000:000000001:0301010100:16:00000000:xxxxxxxxxxxxxxxxxxxxxx Displaying Raw Permit Data EXAMPLE 2 XSCF> showcodactivation -r 01:84000000:104:0301010100:3:00000000:xxxxxxxxxxxxxxx The following exit values are returned: EXIT STATUS Successful completion.
  • Page 359: Showcodactivationhistory

    showcodactivationhistory(8) NAME showcodactivationhistory - show Capacity on Demand (COD) activation log SYNOPSIS showcodactivationhistory [-v | -V] [-m mail_address] showcodactivationhistory [-v | -V] [-u username] [-p proxy [-t proxy_type]] target_url showcodactivationhistory -h showcodactivationhistory(8) shows information in the COD activation log, a DESCRIPTION record of additions and deletions of COD hardware activation permits.
  • Page 360 showcodactivationhistory(8) OPERANDS The following operand is supported: target_url Specifies the URL to which the activation log content is to be transferred. 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 EXAMPLES Displays COD activation log EXAMPLE 1 XSCF>...
  • Page 361: Showcodlicense

    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) ----------- ----------- ----- ------- PROC NONE GOOD 01:84000000:000000001:0301010100:16:00000000:xxxxxxxxxxxxxxxxxxxxxx Displaying Raw License Data EXAMPLE 2 XSCF> showcodlicense -r 01:84000000:104:0301010100:3:00000000:xxxxxxxxxxxxxxx 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 •...
  • Page 363: Showcodusage

    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 (COD permits) in use. The showcodusage(8) command is not available on the M3000 server.
  • 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’s COD CPU has a COD permit and it is in use.
  • Page 366 showcodusage(8) Domain/Resource In Use Installed Reserved Status --------------- ------ --------- -------- ------ - PROC 00-0 - PROC CMU00-CPU0 Unused 00-1 - PROC CMU00-CPU1 Unused 00-2 - PROC CMU00-CPU2 Unused 00-3 - PROC CMU00-CPU3 Unused 02-0 - PROC CMU02-CPU0 Unused CMU02-CPU1 Unused CMU02-CPU2 Unused...
  • Page 367 showcodusage(8) Unused - PROC 00-0 - PROC CPUM00-CPU0 Unused CPUM00-CPU1 Unused CPUM01-CPU0 Unused CPUM01-CPU1 Unused 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 System Administration...
  • Page 368 showcodusage(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised October 2010...
  • Page 369: Showconsolepath

    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 XSCF> showconsolepath -a User ro/rw escape Date nakagawa Fri Jul 29 21:23:34 hana Fri Jul 29 09:49:12...
  • Page 371: Showdate

    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...
  • Page 373: Showdateoffset

    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) EXAMPLES On the M3000 server, displays the time differences between the time of the EXAMPLE 1 system and the time of the domains with specifying the ID of the domain. XSCF> showdateoffset 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.
  • Page 375 showdateoffset(8) 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...
  • Page 377: Showdcl

    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) LSB number. The displayed number is an integer ranging from 00 to 15. XSB number corresponding to the LSB. The displayed number has the following format: x–y where: An integer from 00–15. An integer from 0–3. Domain status. One of the following status is displayed. Status Additional information may be displayed.
  • 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) 03-0 True True False Displays details in the DCL that are set for all domains. EXAMPLE 3 XSCF> showdcl -v -a Status No-Mem No-IO Float Cfg-policy Running 00-0 False False False 01-0 False True False 02-0 True True True 03-0 True True...
  • Page 382 showdcl(8) 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 • Last Revised December 2010...
  • Page 383: Showdevices

    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 Oracle Solaris OS -p force when an XSB is forcibly disconnected by "deleteboard -f" command. If the -p option is omitted, "-p bydevice" is used. Predicts system resources deleted from the Oracle Solaris OS -p query when an XSB is disconnected by deleteboard command.
  • Page 386 showdevices(8) ---- 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 on-line 2530 Memory: ------- board perm...
  • Page 387 showdevices(8) 01-0 53 on-line 2048 Memory: ------- board perm base domain target deleted remaining DID XSB mem MB mem MB address mem MB XSB mem MB mem MB 00 00-0 2048 1290 0x000003c000000000 4096 00-1 1500 01-0 2048 0x000002c000000000 4096 IO Devices: ---------- DID XSB...
  • Page 388 showdevices(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised December 2010...
  • Page 389: Showdomainmode

    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 December 2010...
  • Page 393: Showdomainstatus

    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.
  • Page 395: Showdscp

    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 397 showdscp(8) Domain #16 10.1.1.18 Domain #17 10.1.1.19 Domain #18 10.1.1.20 Domain #19 10.1.1.21 Domain #20 10.1.1.22 Domain #21 10.1.1.23 Domain #22 10.1.1.24 Domain #23 10.1.1.25 Displaying a Specific Domain’s IP Address EXAMPLE 2 XSCF> showdscp -d 1 Domain #01 Address: 10.1.1.3 Displaying a Specific Domain’s IP Address in a Parsable Form EXAMPLE 3 XSCF>...
  • Page 398 showdscp(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2008...
  • Page 399: Showdualpowerfeed

    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) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009...
  • Page 401: Showemailreport

    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...
  • Page 403: Showenvironment

    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: 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#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 XSCF> showenvironment volt MBU_A 1.0V Power Supply Group:1.010V 1.8V Power Supply Group:1.700V CPUM#0-CHIP#0 1.0V Power Supply Group:1.000V CPUM#1-CHIP#0 1.0V Power Supply Group:1.000V MEMB#0...
  • Page 406 showenvironment(8) 2.5V Power Supply Group:2.510V 3.3V Power Supply Group:3.300V 5.0V Power Supply Group:5.000V 12V Power Supply Group:12.000V -12V Power Supply Group:-12.000V FANBP 3.3V Power Supply Group:3.300V 5.0V Power Supply Group:5.010V 12V Power Supply Group:12.020V -12V Power Supply Group:-12.030V Displays the fan speed information on the M5000 server. EXAMPLE 4 XSCF>...
  • Page 407 showenvironment(8) PSU#0 PSU#0:Low speed (level-4) PSU#0: 6436rpm PSU#1 PSU#1:Low speed (level-4) PSU#1: 6352rpm Displays power consumption information on the M3000 server (in case of EXAMPLE 6 AC power supply). XSCF> showenvironment power Permitted AC power consumption:470W Actual AC power consumption:450W Displays power consumption information on the M3000 server (in case of EXAMPLE 7 DC power supply).
  • Page 408 showenvironment(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised October 2010...
  • Page 409: Showfru

    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.
  • Page 411: Showhardconf

    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 413 showhardconf(8) CPUM#3-CHIP#1 Status:Normal; Ver:0601h; Serial:PP074804E9 + FRU-Part-Number:CA06761-D205 A0 /371-4932-01 + Freq:2.660 GHz; Type:48; + Core:4; Strand:2; MEMB#0 Status:Normal; Ver:0101h; Serial:BF09061G0E + FRU-Part-Number:CF00541-0545 06 /541-0545-06 MEM#0A Status:Normal; + Code:c1000000000000005372T128000HR3.7A 356d-0d016912; + Type:1A; Size:1 GB; MEM#3B Status:Normal; + Code:c1000000000000004572T128000HR3.7A 252b-04123424; + Type:1A; Size:1 GB; MEMB#7 Status:Normal;...
  • Page 414 showhardconf(8) + FRU-Part-Number:CF00541-0481 04 /541-0481-04 OPNL Status:Normal; Ver:0101h; Serial:BF0747690D + FRU-Part-Number:CF00541-0850 06 /541-0850-06 PSU#0 Status:Normal; Serial:0017527-0738063762; + FRU-Part-Number:CF00300-1898 0350 /300-1898-03-50; + Power_Status:Off; AC:200 V; PSU#3 Status:Normal; Serial:0017527-0738063767; + FRU-Part-Number:CF00300-1898 0350 /300-1898-03-50; + Power_Status:Input fail; AC: - ; FANBP_C Status:Normal; Ver:0501h; Serial:FF2#24 + FRU-Part-Number:CF00541-3099 01 /541-3099-01 FAN_A#0 Status:Normal;...
  • Page 415 showhardconf(8) | FANBP_C FAN_A +-----------------------------------+------------+ Displays the information of the FRUs in the M9000 server. EXAMPLE 3 XSCF> showhardconf SPARC Enterprise M9000; + Serial:PA30601004; Operator_Panel_Switch:Locked; + Power_Supply_System:Single-1Phase; Ex:Single-1Phase; SCF-ID:XSCF#0; + System_Power:On; System_Phase:Cabinet Power On; Domain#0 Domain_Status:Running; CMU#0 Status:Normal; Ver:8301h; Serial:PP0616B579 ; + FRU-Part-Number:CA06620-D004 B0 /371-4930-02 + Memory_Size:128 GB;...
  • Page 416 showhardconf(8) + Type:4B; Size:4 GB; CMU#2 Status:Normal; Ver:8301h; Serial:PP0618K472 + FRU-Part-Number:CA06620-D004 B0 /371-4930-02 + Memory_Size:32 GB; + Type:C; CPUM#0-CHIP#0 Status:Normal; Ver:0a01h; Serial:PP0608J517 + FRU-Part-Number:CA06620-D061 B1 /371-4929-02 + Freq:3.000 GHz; Type:48; + Core:4; Strand:2; CPUM#1-CHIP#0 Status:Normal; Ver:0a01h; Serial:PP0620P552 + FRU-Part-Number:CA06620-D061 B1 /371-4929-02 + Freq:3.000 GHz;...
  • Page 417 showhardconf(8) + Freq:3.000 GHz; Type:48; + Core:4; Strand:2; CPUM#2-CHIP#0 Status:Normal; Ver:0a01h; Serial:PP0628D036 + FRU-Part-Number:CA06620-D061 B1 /371-4929-02 + Freq:3.000 GHz; Type:48; + Core:4; Strand:2; CPUM#3-CHIP#0 Status:Normal; Ver:0a01h; Serial:PP0630M365 + FRU-Part-Number:CA06620-D061 B1 /371-4929-02 + Freq:3.000 GHz; Type:48; + Core:4; Strand:2; MEM#00A Status:Normal; + Code:7f7ffe00000000004aEBE10RD4AGFA-5C-E 3020-221d6855;...
  • Page 418 showhardconf(8) XSCFU_B#0 Status:Normal,Active; Ver:0201h; Serial:PP080600DW + FRU-Part-Number:CA06620-D342 C0 /371-2228-02 XBU_B#0 Status:Normal; Ver:0201h; Serial:PP0641X324 + FRU-Part-Number:CA06620-D302 C1 /371-2240-03 CLKU_B#0 Status:Normal; Ver:0201h; Serial:PP0542M679 + FRU-Part-Number:CA06620-D322 C1 /371-2230-03 OPNL#0 Status:Normal; Ver:0101h; Serial:PP06058246 + FRU-Part-Number:CA06620-D382 A2 /371-2239-01 PSU#0 Status:Normal; Serial:FA11155187; ++ FRU-Part-Number:CA01022-0690 20H /371-2219-08 + Power_Status:On;...
  • Page 419 +-----------------------------------+------------+ Displays the information of the FRUs in the M3000 server (in case of AC EXAMPLE 5 power supply). XSCF> showhardconf SPARC Enterprise M3000; + Serial:BE80601016; Operator_Panel_Switch:Service; + Power_Supply_System:Single; SCF-ID:XSCF#0; + System_Power:Off; System_Phase:Cabinet Power Off; Domain#0 Domain_Status:Powered Off; MBU_A Status:Normal; Ver:0101h; Serial:7867000269 + FRU-Part-Number:CF00541-0493 0040 /541-0493-00-40 + CPU Status:Normal;...
  • Page 420 FAN_A#1 Status:Normal; Displays the information of the FRUs in the M3000 server (in case of DC EXAMPLE 6 power supply). XSCF> showhardconf SPARC Enterprise M3000; + Serial:BE80601016; Operator_Panel_Switch:Service; + Power_Supply_System:Single; SCF-ID:XSCF#0; + System_Power:Off; System_Phase:Cabinet Power Off; Domain#0 Domain_Status:Powered Off; MBU_A Status:Normal; Ver:0101h; Serial:7867000269 + FRU-Part-Number:CF00541-0493 0040 /541-0493-00-40 + CPU Status:Normal;...
  • Page 421 FANBP_B Status:Normal; Ver:0101h; Serial:7867000053 + FRU-Part-Number:CA20399-B12X 009AC/541-3304-03 FAN_A#0 Status:Normal; FAN_A#1 Status:Normal; Displays the number of installed FRUs in the M3000 server. EXAMPLE 7 XSCF> showhardconf -u SPARC Enterprise M3000; Memory_Size:8 GB; +-----------------------------------+------------+ Quantity +-----------------------------------+------------+ | MBU_A Freq:2.520 GHz; Type:1A; Size:1 GB;...
  • Page 422 showhardconf(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2012...
  • Page 423: Showhostname

    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 424 showhostname(8) Displays the host name for XSCF unit 0. EXAMPLE 2 XSCF> showhostname xscf#0 xscf#0: scf0-hostname.example.com The following exit values are returned: EXIT STATUS Successful completion. An error occurred. >0 SEE ALSO sethostname(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
  • Page 425: Showhttps

    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 426 showhttps(8) -----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) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 427: Showldap

    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 428 showldap(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised June 2007...
  • Page 429: Showldapssl

    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 430 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.
  • Page 431 showldapssl(8) valid from = Apr 18 05:38:36 2009 GMT valid until = Apr 16 05:38:36 2019 GMT version = 3 (0x02) Displays specified diagnostic messages. EXAMPLE 3 XSCF> showldapssl log -S 5 -E 10 Thu Sep 2 01:43 2009 (LdapSSL): -error- authentication status: auth-ERROR Thu Sep 2 01:44 2009 (LdapSSL): -error- authentication status: auth-ERROR Thu Sep 2 01:47 2009 (LdapSSL): -error- authentication status: auth-ERROR Thu Sep 2 01:51 2009 (LdapSSL): -error- authentication status: auth-ERROR...
  • Page 432 showldapssl(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised October 2010...
  • Page 433: Showlocale

    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 434 showlocale(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised March 2008...
  • Page 435: Showlocator

    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 436 showlocator(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 437: Showloginlockout

    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 438 showloginlockout(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 439: Showlogs

    showlogs(8) NAME showlogs - display the specified log SYNOPSIS showlogs [-t time [-T time] | -p timestamp] [-v | -V | -S] [-r] [-M] error showlogs [-t time [-T time] | -p timestamp] [-v] [-r] [-M] event showlogs [-t time [-T time]] [-r] [-M] {power | env} showlogs [-r] [-M] monitor showlogs -d domain_id [-t time [-T time]] [-r] [-M] {console | ipl | panic} showlogs -h...
  • Page 440 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 441 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’...
  • Page 442 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’...
  • Page 443 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 444 showlogs(8) UUID: bf36f0ea-9e47-42b5-fc6f-c0d979c4c8f4 MSG-ID:FMD-8000-11 Diagnostic Messages: Case where the -S option is specified Date: Mar 30 17:45:31 JST 2005 Code: xxxxxxxx-xxxxxxxx-xxxxxxxxxxxxxxx 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...
  • Page 445 showlogs(8) Suspected faulty unit FRU: The suspected faulty units that are displayed and delimited by a "," (comma) are the units most likely and second most likely to be faulty. If there are three suspected faulty units, an "*" is displayed next to the unit third most likely to be faulty.
  • Page 446 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 447 showlogs(8) 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) The displayed time is the local time.
  • Page 448 showlogs(8) 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 (%). Humidity is displayed on the M8000/M9000 servers only. Power state of the main unit Power: Either of the following states is displayed: The main unit power is on.
  • Page 449 showlogs(8) Panic message log ■ <<panic>> Date: Mar 30 18:45:31 JST 2005 DomainID: 00 Mar 30 17:45:31 JST 2005 panic message Mar 30 17:55:31 JST 2005 panic message [Second line] Panic occurrence date and time (month day hour:minute:second Date: time-zone year) The displayed time is the local time.
  • Page 450 XSCF> showlogs error Date: Mar 30 12:45:31 JST 2005 Code: 00112233-44556677-8899aabbcceeff0 Status: Alarm Occurred: Mar 30 17:45:31.000 JST 2005 FRU: IOU#0/PCI#3 Msg: offline(vendor=FUJITSU, product=MAJ3182MC) Date: Mar 30 15:45:31 JST 2005 Code: 00112233-44556677-8899aabbcceeff0 Status: Warning Occurred: Mar 30 17:45:31.000 JST 2005 FRU: PSU#1,PSU#2...
  • Page 451 showlogs(8) Displays a power log. EXAMPLE 4 XSCF> showlogs power Date Event Cause Switch Mar 30 17:25:31 JST 2005 System Power Off Pow.Fail/Recov.-- Service Mar 30 17:35:31 JST 2005 System Power On Pow.Fail/Recov.-- Locked Mar 30 17:45:31 JST 2005 Domain Power Off Operator 00 Locked Mar 30 17:50:31 JST 2005...
  • Page 452 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. EXIT STATUS The following exit values are returned: Successful completion.
  • Page 453: Showlookup

    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 454 showlookup(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 455: Showmonitorlog

    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 456 showmonitorlog(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
  • Page 457: Shownameserver

    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 458 shownameserver(8) 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...
  • Page 459: Shownetwork

    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 460 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. •...
  • Page 461 shownetwork(8) In the M3000/M4000/M5000 servers, the value of the lan#0 is fixed with ■ xscf#0-lan#0, and the lan#1 is fixed with xscf#0-lan#1. 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.
  • Page 462 shownetwork(8) Displays the information for XSCF-LAN#0 on XSCF Unit 0. EXAMPLE 4 XSCF> shownetwork xscf#0-lan#0 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:14541827 (13.8 MiB) TX bytes:1459769 (1.3 MiB)
  • Page 463 shownetwork(8) TX packets:14369 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:20241827 (19.3 MiB) TX bytes:2089769 (1.9 MiB) Base address:0x1000 xscf#0-if Link encap:Ethernet HWaddr 00:00:00:00:00:00 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.0 B)
  • Page 464 shownetwork(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010...
  • Page 465: Shownotice

    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 466 shownotice(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
  • Page 467: Showntp

    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 468 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 469 showntp(8) Displays whether a preferred server has been designated, and displays the EXAMPLE 4 clock address of the local clock. XSCF> showntp -m prefer : on localaddr : 0 EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO setntp(8)
  • Page 470 showntp(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009...
  • Page 471: Showpacketfilters

    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 472 showpacketfilters(8) 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 172.16.0.0/255.255.0.0 0 DROP 10.10.10.10 0 ACCEPT xscf#1-lan#1 192.168.100.0/255.255.255.0 0 DROP xscf#1-lan#1 0.0.0.0/0.0.0.0 XSCF> EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO setpacketfilters(8)
  • Page 473: Showpasswordpolicy

    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 474 showpasswordpolicy(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 475: Showpowerupdelay

    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 476 showpowerupdelay(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2008...
  • Page 477: Showresult

    showresult(8) NAME showresult - display the exit status of the most recently executed command SYNOPSIS showresult showresult -h DESCRIPTION The showresult(8) command displays the exit status of the most recently executed command. showresult(8) is convenient for a remote control program to confirm whether the most recently executed command is successfully completed.
  • Page 478 showresult(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised December 2010...
  • Page 479: Showroute

    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 480 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 481 showroute(8) Displays routing information for XSCF-LAN#0 on XSCF unit 0 without the EXAMPLE 2 name resolution of host name. XSCF> showroute -n xscf#0-lan#0 Destination Gateway Netmask Flags Interface 192.168.10.0 0.0.0.0 255.255.255.0 xscf#0-lan#0 0.0.0.0 192.168.10.1 0.0.0.0 xscf#0-lan#0 Displays all routing information for XSCF unit 0 and XSCF unit 1 in the EXAMPLE 3 M8000/M9000 server.
  • Page 482 showroute(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
  • Page 483: Showshutdowndelay

    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 484 showshutdowndelay(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 485: Showsmtp

    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, platop, or fieldeng privileges to run this command. Privileges Refer to setprivileges(8) for more information.
  • Page 486 showsmtp(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2012...
  • Page 487: Showsnmp

    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 488 showsnmp(8) -------- ---- ---- ---------------- -------- -------------- 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 XSCF> showsnmp Agent Status: Enabled Agent Port: System Location: SanDiego System Contact: jsmith@jupiter.west...
  • Page 489: Showsnmpusm

    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, platop, or fieldeng privileges to run this command. Refer to setprivileges(8) for more information.
  • Page 490 showsnmpusm(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2012...
  • Page 491: Showsnmpvacm

    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, platop, or fieldeng privileges to run this command. Refer to setprivileges(8) for more information.
  • Page 492 showsnmpvacm(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2012...
  • Page 493: Showssh

    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 494 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 495 showssh(8) 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 XSCF> showssh -c pubkey 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 The following exit values are returned: Successful completion.
  • Page 496 showssh(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 497: Showstatus

    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 498 showstatus(8) EXAMPLES Displays the degraded units. In this example, a CPU module and memory EXAMPLE 1 module in a CPU memory unit are degraded because of an error. XSCF> showstatus CMU#0; CPUM#0-CHIP#0 Status:Faulted; MEM#00A Status:Faulted; Displays the degraded units. In this example, a memory module on a EXAMPLE 2 memory board is degraded because of an error.
  • Page 499: Showsunmc

    showsunmc(8) NAME showsunmc - show setup information and status of Sun Management Center agent SYNOPSIS showsunmc [isenabled] showsunmc [-h] DESCRIPTION This command is used to show the setup information and current status of the Sun Management Center agent. When used with the isenabled option, the showsunmc command output displays on the agent status: 1 if the agent is enabled, 0 if the agent is disabled.
  • Page 500 showsunmc(8) Agent Port: 1161 Host Trap Port: Host Event Port: SNMP Agent Port: Domain Agent Ports: 1161 Show the Agent Status of an Enabled Agent EXAMPLE 3 XSCF> showsunmc isenabled EXIT STATUS The following exit values are returned: Successful completion. An error occurred.
  • Page 501: Showtelnet

    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 502 showtelnet(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 503: Showtimezone

    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 504 showtimezone(8) std offset dst[offset2] [from-date[/time] to-date[/time] ] Abbreviations of time zone. 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.
  • Page 505 showtimezone(8) offset2 Offset time of Daylight Saving Time and Greenwich mean time (GMT). Displayed in minus "–" in case the offset is plus, and displayed in plus "+" in case the offset is minus. from-date[/time] The starting time of Daylight Saving Time. Any of the following formats displays from-date.
  • Page 506 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 507 showtimezone(8) The settimezone(8) command sets the time zone of the XSCF. ■ EXAMPLES Displays the time zone. EXAMPLE 1 XSCF> showtimezone -c tz 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 508 showtimezone(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 509: Showuser

    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. If the user argument is not specified, then showuser displays account information for the current user.
  • Page 510 showuser(8) EXAMPLES Displays Password and Account Validity Information EXAMPLE 1 XSCF> showuser -a 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 XSCF>...
  • Page 511: Snapshot

    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 512 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 513 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 514 snapshot(8) Automatically answers "n" (no) to all prompts. -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 515 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 516 snapshot(8) Downloading With a User-Provided Public Key EXAMPLE 3 XSCF> snapshot -t joe@jupiter.west:/home/joe/logs/x -k “ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAwVFiSQNVBFhTTzq0AX5iQqCkkJjd6ezWkVGtmMkJJzzM jYK0sBlhn6dGEIiHdBSzO8QLAXb8N4Kq8JDOBpLSN4yokUPTcZQNxJaYA0W058Qgxbn” Enter ssh password for user ‘joe’ on host ‘jupiter.west’ Setting up ssh connection to remote host... Collecting data into joe@jupiter.west:/home/joe/logs/x/archive.zip Data collection complete. Log Files Only Using No Public Key EXAMPLE 4 XSCF>...
  • Page 517 snapshot(8) Downloading Public Key and Answering No to All Prompts EXAMPLE 8 XSCF> snapshot -v -t jill@earth.east:/home/jill/logs/x -k download -n Downloading Public Key from ‘earth.east’... Public Key: ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAwVFiSQNVBFhTTzq0AX5iQqCkkJjd6ezWkVGtmMkJJzzM jYK0sBlhn6dGEIiHdBSzO8QLAXb8N4Kq8JDOBpLSN4yokUPTcZQNxJaYA0W058Qgxbn Key fingerprint in md5: c9:e0:bc+b2:1a:80:29:24:13:d9:f1:13:f5:5c:2c:0f Accept this public key (yes/no)? no Public Key declined Error opening SSH target Exiting with error 1...
  • Page 518 snapshot(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
  • Page 519: Switchscf

    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 520 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 521: Testsb

    testsb(8) NAME testsb - perform an initial diagnosis of the specified physical system board (PSB) SYNOPSIS testsb [[-q] -{y|n}] [-m diag=mode] location testsb [[-q] -{y|n}] [-m diag=mode] -c {all|expansion} testsb -v [-y|-n] [-m diag=mode] location testsb -v [-y|-n] [-m diag=mode] -c {all|expansion} testsb -h DESCRIPTION testsb(8) command performs an initial diagnosis of the specified PSB.
  • Page 522 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. •...
  • Page 523 testsb(8) When the system board (XSB) belonging to the specified PSB is in any status ■ below, the testsb(8) command results in an error. XSB is installed in the domain and this domain is in operation. ■ XSB is installed in the domain and this domain is in OpenBoot PROM (ok> ■...
  • Page 524 testsb(8) The displayed diagnostic results of the testsb(8) command are as follows: ■ XSB numbers belonging to the specified PSBs. One XSB number is displayed for the Uni-XSB type, and four XSB numbers are displayed for the Quad-XSB type. Status of the initial diagnosis of XSBs. One of the following Test status values is displayed: No XSB could be recognized because no XSB...
  • Page 525 testsb(8) Performs an initial diagnosis of PSB#01 with detailed messages displayed. EXAMPLE 2 XSCF> testsb -v 1 Initial diagnosis is about to start. Continue? [y|n] :y SB#01 powered on sequence started. Initial diagnosis has completed. {0} ok SB power off sequence started. [1200sec] 0.end SB powered off.
  • Page 526 testsb(8) SB power off sequence started. [1200sec] 0.end SB powered off. Test Fault ---- ------- -------- 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),...
  • Page 527: Traceroute

    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 528 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 529 traceroute(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 System Administration...
  • Page 530 traceroute(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 531: Unlockmaintenance

    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 532 unlockmaintenance(8) Unlocks the maintenance lock status. Automatically answers "y" to all EXAMPLE 2 prompts. XSCF> unlockmaintenance -y This command unlocks the maintenance lock which prevents the multiple execution of maintenance commands. *Never* use this command, except when the lock state remains by some reason.
  • Page 533: Version

    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 534 version(8) Displays the details of the XCP version. EXAMPLE 2 XSCF> version -c xcp -v XSCF#0 (Active) XCP0 (Current): 1082 OpenBoot PROM : 02.09.0000 XSCF : 01.08.0005 XCP1 (Reserve): 1082 OpenBoot PROM : 02.09.0000 XSCF : 01.08.0005 XSCF#1 (Standby) XCP0 (Current): 1082 OpenBoot PROM : 02.09.000 XSCF : 01.08.0005...
  • Page 535 version(8) DomainID 2: 02.09.0000 DomainID 3: 02.09.0000 DomainID 23: 02.09.0000 XSB#00-0: 02.09.0000(Current) 02.07.0000(Reserve) XSB#00-1: 02.09.0000(Current) 02.07.0000(Reserve) XSB#00-2: 02.09.0000(Current) 02.07.0000(Reserve) XSB#00-3: 02.09.0000(Current) 02.07.0000(Reserve) XSB#15-3: 02.09.0000(Current) 02.07.0000(Reserve) Displays the detailed version of XSCF firmware. EXAMPLE 7 XSCF> version -c xscf -v XSCF#0 (Active ) 01.08.0005(Reserve) 01.08.0005(Current) XSCF#1 (Standby) 01.08.0005(Current) 01.08.0005(Reserve)
  • Page 536 version(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 537: Viewaudit

    viewaudit(8) NAME viewaudit - display audit records SYNOPSIS viewaudit viewaudit [-A date-time] [-B date-time] [-C] [ -c classes] [-D date-time] [-E end- record] [-e events] [-i audit-ids] [-l] [-m del] [-n] [-p privilege-results] [-r return- values ] [-s start-record] [-u users] [-x] viewaudit -h DESCRIPTION viewaudit(8) displays audit records.
  • Page 538 viewaudit(8) OPTIONS The following options are supported: -A date-time Selects records that occurred at or after 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: Absolute date-time : yyyymmdd[hh[mm[ss]]] where:...
  • Page 539 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 540 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 541 viewaudit(8) -S start-record Selects the first record matching the selection criteria to display. -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...
  • Page 542 viewaudit(8) 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 XSCF> viewaudit -A 20080108 -B +2d file,1,2008-01-09 20:12:12.968 -08:00,20080110041212.0000000004.sca-m5k- file,1,2008-01-10 21:14:49.481 -08:00,terminated file,1,2008-01-10 21:14:49.485 -08:00,20080111051449.0000000005.sca-m5k- Displaying First 5 Records (of 4238) that Match a Date Range EXAMPLE 6 XSCF>...

Table of Contents