Fujitsu SPARC ENTERPRISE M3000 Xscf Reference Manual

Fujitsu SPARC ENTERPRISE M3000 Xscf Reference Manual

Xscf control package (xcp) 109x
Hide thumbs Also See for SPARC ENTERPRISE M3000:
Table of Contents

Advertisement

Advertisement

Table of Contents
loading

Summary of Contents for Fujitsu SPARC ENTERPRISE M3000

  • Page 3 SPARC Enterprise ™ M3000/M4000/M5000/M8000/M9000 Servers XSCF Reference Manual XSCF Control Package (XCP) 109x Manual Code C120-E606-02EN Part No. 875-4584-11 July 2010 , Revision A...
  • Page 4 Oracle or Fujitsu Limited, or any affiliate of either of them.
  • Page 5 EXCLUES, DANS LA MESURE AUTORISÉE PAR LA LOI APPLICABLE. Sauf mention contraire expressément stipulée dans ce contrat, dans la mesure autorisée par la loi applicable, en aucun cas Oracle ou Fujitsu Limited et/ou l’une ou l’autre de leurs sociétés affiliées ne sauraient être tenues responsables envers une quelconque partie tierce, sous quelque théorie juridique que ce soit, de tout manque à...
  • Page 7: Table Of Contents

    Contents Preface Intro addboard addcodactivation addcodlicense addfru adduser applynetwork cfgdevice clockboard console deleteboard deletecodactivation deletecodlicense deletefru deleteuser disableuser dumpconfig enableuser exit flashupdate fmadm fmdump Contents...
  • Page 8 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 setdomparam setdscp setdualpowerfeed setemailreport sethostname sethttps setldap SPARC Enterprise Mx000 Servers XSCF Reference Manual • July 2010...
  • Page 9 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 showaudit showautologout showboards showcod showcodactivation showcodlicense showcodusage Contents...
  • Page 10 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 showntp showpacketfilters showpasswordpolicy showpowerupdelay showresult showroute showshutdowndelay showsmtp SPARC Enterprise Mx000 Servers XSCF Reference Manual • July 2010...
  • Page 11 showsnmp showsnmpusm showsnmpvacm showssh showstatus showsunmc showtelnet showtimezone showuser snapshot switchscf testsb traceroute unlockmaintenance version viewaudit Contents...
  • Page 13: Preface

    XSCF environment. For how to use the man command, please refer to man(1) in this manual. In addition, for the detail content of XSCF, please refer to SPARC Enterprise M3000/ M4000/M5000/M8000/M9000 Servers XSCF User’s Guide.
  • Page 14 “Prompt Notations” on page xvi ■ “Software License” on page xvii ■ “Fujitsu Welcomes Your Comments” on page xvii ■ Audience This manual is intended for users, who administrate M3000/M4000/M5000/M8000/ M9000 servers (hereinafter referred to as XSCF user). The XSCF user is required to...
  • Page 15 Intro(8) provides the XSCF shell commands and the brief description of them in the alphabetical order. Each XSCF shell command is described in the order of sections below. When there's no relevant description provided, the section itself is omitted. Section Description NAME This section gives the names of the XSCF shell commands,...
  • Page 16 SPARC Enterprise Mx000 Servers Documentation The manuals listed below are provided for reference. Book Titles SPARC Enterprise M3000 Server Site Planning Guide SPARC Enterprise M4000/M5000 Servers Site Planning Guide SPARC Enterprise M8000/M9000 Servers Site Planning Guide SPARC Enterprise Equipment Rack Mounting Guide SPARC Enterprise M3000 Server Getting Started Guide SPARC Enterprise Mx000 Servers XSCF Reference Manual •...
  • Page 17 SPARC Enterprise M4000/M5000 Servers Overview Guide SPARC Enterprise M8000/M9000 Servers Overview Guide Important Safety Information for Hardware Systems SPARC Enterprise M3000 Server Safety and Compliance Guide SPARC Enterprise M4000/M5000 Servers Safety and Compliance Guide SPARC Enterprise M8000/M9000 Servers Safety and...
  • Page 18 Note – Product Notes are available on the website only. Please check for the most recent update on your product. 2. Documentation CD For the Documentation CD, please contact your local sales representative. SPARC Enterprise M3000 Server Documentation CD (C120-E541) ■ SPARC Enterprise M4000/M5000 Servers Documentation CD (C120-E365) ■...
  • Page 19 4. Manual (man page) provided in the system XSCF man page Note – The man page can be referenced on the XSCF Shell, and it provides the same content as the SPARC Enterprise M3000/M4000/M5000/M8000/M9000 Servers XSCF Reference Manual. 5. Documentation and Support on the Web The latest information about other documents and the support for your server are provided on the websites.
  • Page 20 8. Information on Using the RCI function The manual does not contain an explanation of the RCI build procedure. For information on using the RCI function, refer to the SPARC Enterprise M3000/M4000/ M5000/M8000/M9000 Servers RCI Build Procedure and SPARC Enterprise M3000/ M4000/M5000/M8000/M9000 Servers RCI User’s Guide available on the website.
  • Page 21 The following table lists the abbreviations used in this manual. Abbreviated Title Full Title Overview Guide SPARC Enterprise M3000 Server Overview Guide SPARC Enterprise M4000/M5000 Servers Overview Guide SPARC Enterprise M8000/M9000 Servers Overview Guide Service Manual SPARC Enterprise M3000 Server Service Manual...
  • Page 22 Bourne shell and Korn shell Bourne shell and Korn shell super user OpenBoot PROM SPARC Enterprise Mx000 Servers XSCF Reference Manual • July 2010 Model name SPARC Enterprise M3000 SPARC Enterprise M4000 SPARC Enterprise M5000 SPARC Enterprise M8000 SPARC Enterprise M9000 Prompt Notations XSCF>...
  • Page 23: Software License

    Some software functions explained in this manual are licensed under public licenses (GNU Public License (GPL), GNU Lesser Public License (LGPL), and others). See Appendix E, "Software License Condition" in SPARC Enterprise M3000/M4000/M5000/ M8000/M9000 Servers XSCF User’s Guide. Fujitsu Welcomes Your Comments...
  • Page 24 xviii SPARC Enterprise Mx000 Servers XSCF Reference Manual • July 2010...
  • Page 25: Intro

    Intro(8) command lists the commands provided by the XSCF firmware of the SPARC Enterprise M3000/M4000/M5000/M8000/M9000 servers. Some commands are used in a different way or not supported on your server. For details, refer to the pages of each command. LIST OF...
  • Page 26 XSCF unit, and restore it to the state as of the factory shipment send a break signal to the specified domain...
  • Page 27 XSCF network set or remove the network interface that used in XSCF setnetwork set the NTP servers used on the XSCF network, the stratum setntp value, the preferred server and the clock address of the local clock of XSCF Intro...
  • Page 28 setpacketfilters setpasswordpolicy manage the system password policy setpowerupdelay setprivileges setroute setshutdowndelay setsmtp setsnmp setsnmpusm setsnmpvacm setssh setsunmc settelnet settimezone setupfru setupplatform showad showaltitude showarchiving showaudit showautologout showboards showcod showcodactivation display the current Capacity on Demand (COD) activation SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010 set the IP packet filtering rules to be used in the XSCF network set the warm-up time of the system and wait time before...
  • Page 29 Field Replaceable Units (FRUs)
  • Page 30 showlookup showmonitorlog shownameserver shownetwork shownotice showntp showpacketfilters show the IP packet filtering rules that are set in the XSCF showpasswordpolicy display the current password settings showpowerupdelay showresult showroute showshutdowndelay show the shutdown wait time at power interruption of the showsmtp showsnmp showsnmpusm showsnmpvacm...
  • Page 31 display the XSCF time zone and Daylight Saving Time showtimezone information of current settings display user account information showuser collect and transfer environment, log, error, and FRUID snapshot data switch the XSCF unit between the active and standby states switchscf perform an initial diagnosis of the specified physical system testsb board (PSB)
  • Page 32 Intro(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010...
  • Page 33: Addboard

    The addboard(8) command, based on domain component list (DCL), configures a XSB into the domain configuration or assigns it to the domain configuration. The addboard(8) command is not available on the M3000 server. One of the following configuration methods can be specified:...
  • Page 34 Solaris Service Management Facility (SMF) services are active on that domain: Domain SP Communication Protocol (dscp) ■ Domain Configuration Server (dcs) ■ Sun Cryptographic Key Management Daemon (sckmd) ■ SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009 Specifies the ID of the domain in which an XSB is to be configured or to which it is to be assigned.
  • Page 35 When the command is executed, a prompt to confirm execution of the command ■ with the specified options is displayed. Enter "y" to execute the command or "n" to cancel the command. If "-c configure" is specified when either the domain power has been turned ■...
  • Page 36 addboard(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 37: Addcodactivation

    COD activation key to the COD Hardware Activation database on the Service Processor. This command is not available on the M3000 server. When the key is added, the quantity of headroom is reduced by the quantity provided by the key.
  • Page 38 addcodactivation(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010...
  • Page 39: Addcodlicense

    COD RTU specified license key to the COD license database on the Service Processor. The addcodlicense(8) command is not available on the M3000 server. When the license key is added, the quantity of headroom is reduced by the quantity provided by the license key.
  • Page 40 addcodlicense(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 July 2010...
  • Page 41: Addfru

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

    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. It cannot be used for login until either the password is set (using password(8)) or Secure Shell (SSH) public key authentication is set for the user.
  • Page 44 EXAMPLES EXAMPLE 1 XSCF> The following exit values are returned: EXIT STATUS >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 • Last Revised April 2010 Creating a New User adduser -u 359 jsmith Successful completion.
  • Page 45: Applynetwork

    1. Set the information with the following commands: sethostname(8) - Set XSCF host name and a DNS domain name ■ setnameserver(8) - Set a DNS server name and a DNS search path ■ setnetwork(8) - Set IP address and netmask of XSCF network interface ■...
  • Page 46 256, it results in an error. In the setnameserver(8) command, if you do not set the DNS server but set the ■...
  • Page 47: System Administration

    status IP address :10.24.144.214 netmask :255.255.255.0 route :-n 0.0.0.0 -m 0.0.0.0 -g 10.24.144.1 interface :xscf#0-lan#1 status :down IP address netmask route Continue? [y|n] : Please reset the XSCF by rebootxscf to apply the network settings. Please confirm that the settings have been applied by executing showhostname, shownetwork, showroute and shownameserver after rebooting the XSCF.
  • Page 48 IP address netmask route interface status IP address netmask interface status IP address netmask interface status IP address netmask route interface status IP address netmask route interface status IP address netmask interface status SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010 :xscf#0-if :down :10.24.100.1...
  • Page 49 IP address netmask Continue? [y|n] : Please reset the XSCF by rebootxscf to apply the network settings. Please confirm that the settings have been applied by executing showhostname, shownetwork, showroute and shownameserver after rebooting the XSCF. Applies the information that has been set for the XSCF network, on M3000/ EXAMPLE 2 M4000/M5000 servers.
  • Page 50 Applies the information that has been set for the XSCF network. Suppresses prompts, and automatically answers "y" to all prompts. applynetwork -q -y Sets the name server and the search path and then applies the XSCF network settings. applynetwork :hostname-0 :example.com...
  • Page 51 Continue? [y|n] : Please reset the XSCF by rebootxscf to apply the network settings. Please confirm that the settings have been applied by executing showhostname, shownetwork, showroute and shownameserver after rebooting the XSCF. EXIT STATUS The following exit values are returned: >0 SEE ALSO rebootxscf(8), sethostname(8), setnameserver(8), setnetwork(8), setroute(8)
  • Page 52 applynetwork(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010...
  • Page 53: Cfgdevice

    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 54 SAS-status You must have platadm or fieldeng privileges to run this command. Privileges Refer to setprivileges(8) for more information. OPTIONS The following options are supported: -c attach -c detach -p port_no EXTENDED When the command is executed, a prompt to confirm execution of the command ■...
  • Page 55 The CD-RW/DVD-RW drive unit and the tape drive unit is mounted in each of ■ the base and expansion cabinets in the M9000 server that has the expansion cabinet. In such cases, each CD-RW/DVD-RW drive unit and the tape drive unit can be connected only to a domain within the cabinet in which the drive is mounted.
  • Page 56 CD-RW/DVD-RW drive unit and the tape drive unit Disconnects the the port 0-0. cfgdevice -f -c detach -p 0-0 Displays the status of individual drive unit set on the M8000 server and the M9000 server without the expan- sion cabinet. cfgdevice -l enable enable disable down...
  • Page 57 M9000 server with the expansion cabinet. cfgdevice -l XSCF> Current connection for DVD/DAT: port 0-0 Main chassis: port 0-0 Expansion chassis: port 8-0 Expander status Port No. IOU/SAS-status SAS-status ----------------------------------- enable enable disable down enable...
  • Page 58 XSCF> EXIT STATUS The following exit values are returned: >0 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008 prompts without displaying messages. cfgdevice -q -y -c attach -p 0-0 Successful completion. An error occurred.
  • Page 59: Clockboard

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

    NAME console - connect to a domain console SYNOPSIS console [ [-q] -{y|n}] -d domain_id [-f | -r] [-s escapeChar] console -h DESCRIPTION The console(8) command connects the XSCF shell console to the console of the specified domain (domain console). Domain consoles include a writable console and read-only console.
  • Page 62 -s escapeChar 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. The domain console regards "#" used at the beginning of a line as an escape ■...
  • Page 63: Deleteboard

    -h DESCRIPTION The deleteboard(8) command disconnects an XSB from the domain configuration in which it has been configured. The deleteboard(8) command is not available on the M3000 server. One of the following disconnection methods can be specified: disconnect unassign...
  • Page 64 OPTIONS The following options are supported. -c disconnect Detaches the XSB from the domain configuration and keeps it -c reset -c unassign OPERANDS The following operand is supported: SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009 assigned.
  • Page 65 "-c unassign" will succeed only if the following Solaris Service Management Facility (SMF) services are active on that domain: Domain SP Communication Protocol (dscp) ■ Domain Configuration Server (dcs) ■ Sun Cryptographic Key Management Daemon (sckmd) ■ When the command is executed, a prompt to confirm execution of the command ■...
  • Page 66 EXIT STATUS The following exit values are returned: >0 SEE ALSO addboard(8), moveboard(8), replacefru(8), setdcl(8), setupfru(8), showboards(8), showdcl(8), showdevices(8), showdomainstatus(8), showfru(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009 Successful completion. An error occurred.
  • Page 67: Deletecodactivation

    The deletecodactivation(8) command removes the specified COD activation key from the COD Hardware Activation database on the Service Processor. This command is not available on the M3000 server. Note – For details on COD keys, refer to the SPARC Enterprise M4000/M5000/ M8000/M9000 Servers Capacity on Demand (COD) User’s Guide.
  • Page 68 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 July 2010...
  • Page 69: Deletecodlicense

    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. For further information about COD RTU license keys, refer to the SPARC Enterprise M4000/M5000/M8000/M9000 Capacity on Demand (COD) User’s Guide.
  • Page 70 EXIT STATUS The following exit values are returned: >0 SEE ALSO SPARC Enterprise M4000/M5000/M8000/M9000 Servers Capacity on Demand (COD) User’s Guide SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010 Successful completion. An error occurred.
  • Page 71: Deletefru

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

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

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

    NAME dumpconfig - save system configuration information to a file SYNOPSIS dumpconfig [-v ] [-V ] [ [-q] -{y|n} ] [-e [-P password ]] [-c comment ] [-u user ] [-p proxy [-t proxy_type ]] url dumpconfig -h DESCRIPTION The dumpconfig(8) command saves system configuration information, copying it from the XSCF to a file specified by the user.
  • Page 78 Specifies the proxy server to be used for transfers. The default transfer type is http, unless modified using the -t proxy_type option. The value for proxy must be in the format servername:port.
  • Page 79 * Connected to 129.145.155.166 (129.145.155.166) port 8080 * Proxy auth using (nil) with user ’’ * Server auth using Basic with user ’minilla’ > PUT ftp://10.7.79.18/iktest/proxytest-ftp.cfg HTTP/1.1 Authorization: Basic bHdhbmc6bHdhbmc= User-Agent: dumpconfig Host: 10.7.79.18:21 Pragma: no-cache Accept: */* Content-Length: 24720 Expect: 100-continue <...
  • Page 80 < 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...
  • Page 81 removing file ’file:///media/usb_msd/proxytest.cfg’ ... done reading database ..*done creating temporary file ... done starting file transfer ...transfer from ’/tmp/dumpconfig.HE1RZa’ to ’file:///media/usb_msd/san-ff1-54.cfg’ done removing temporary file ... done operation completed Unmounted USB device XSCF> EXAMPLE 5 dumpconfig -v -e -P kamacuras -p 129.145.155.166:8080 http:/ XSCF>...
  • Page 82 dumpconfig(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 83: Enableuser

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

    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 -s version 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. When the firmware is updated, the XSCF unit is reset. Therefore, LAN ■...
  • Page 89 XSCF download is started (XSCFU=0,bank=1,XCP version=1082:last version=1080, Firmware Element ID=07:version=01080004:last version=01080000) XSCF download has been completed (XSCFU=0,bank=1,XCP version=1082:last version=1080, Firmware Element ID=07:version=01080004:last version=01080000) XSCF update has been completed (XSCFU=0,bank=1,XCP version=1082:last version=1080) XCP update is started (XCP version=1082:last version=1080) OpenBoot PROM update is started (OpenBoot PROM version=02090000) OpenBoot PROM update has been completed (OpenBoot PROM version=02090000) XSCF update is started (XSCFU=0,bank=0,XCP version=1082:last version=1080) XSCF download is started (XSCFU=0,bank=0,XCP version=1082:last...
  • Page 90 EXIT STATUS The following exit values are returned: >0 SEE ALSO version(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009 Successful completion An error occurred.
  • Page 91: Fmadm

    NAME fmadm - fault management configuration tool SYNOPSIS fmadm [-q] config fmadm -h DESCRIPTION fmadm (8) can be used to view system configuration parameters related to fault management. fmadm can be used to: View the set of diagnosis engines and agents that are currently participating in fault management View the list of system components that have been diagnosed as faulty The Fault Manager attempts to automate as many activities as possible, so use of...
  • Page 92 EXAMPLES EXAMPLE 1 XSCF> MODULE case-close fmd-self-diagnosis 1.0 sysevent-transport syslog-msgs EXIT STATUS The following exit values are returned: >0 SEE ALSO fmdump(8), fmstat(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007 Displaying the Fault Manager Configuration fmadm config VERSION STATUS DESCRIPTION...
  • Page 93: Fmdump

    The fmdump utility displays the contents of any of the logs associated with the Fault Manager (fault manager daemon). The Fault Manager runs in the background on each server. It records, in the error log, faults detected by the XSCF, and initiates proactive self-healing activities, such as disabling faulty components.
  • Page 94 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 -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 Time Format yyyy-mm-dd[T hh:mm[:ss]] ddMonyy hh:mm:ss hh:mm Tns | Tnsec Tus | Tusec Tms | Tmsec Ts | Tsec Tm | Tmin Th | Thour Td | Tday You can append a decimal fraction of the form .n to any -t option argument to indicate a fractional number of seconds beyond the specified time.
  • Page 97 Sep 06 09:38:10.8584 77435994-5b99-4db8-bdcd-985c7d3ae3e4 LINUX-8000-1N Sep 06 09:57:44.6502 0087d58c-e5b9-415d-91bc-adf7c41dd316 LINUX-8000-1N Sep 06 12:40:59.2801 97de2cef-8ea1-407a-8a53-c7a67e61987a LINUX-8000-1N Sep 06 12:41:10.1076 fa7304f9-c9e8-4cd1-9ca5-e35f57d53b2c LINUX-8000-1N Sep 06 13:01:49.1462 ce550611-4308-4336-8a9a-19676f828515 LINUX-8000-1N Sep 06 15:42:56.6132 0f4b429f-c048-47cd-9d9f-a2f7b6d4c957 LINUX-8000-1N Sep 06 16:07:14.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...
  • Page 98 = FMD-8000-58 diag-time = 1128021009 615016 de = (embedded nvlist) nvlist version: 0 version = 0x0 scheme = fmd authority = (embedded nvlist) nvlist version: 0 version = 0x0 product-id = SUNW,SPARC-Enterprise chassis-id = BF0000001V server-id = localhost (end authority) MSG-ID...
  • Page 99 mod-name = sde mod-version = 1.13 (end de) fault-list-sz = 0x1 fault-list = (array of embedded nvlists) (start fault-list[0]) nvlist version: 0 version = 0x0 class = fault.io.iox.cp.seeprom certainty = 0x64 fru = (embedded nvlist) nvlist version: 0 scheme = hc version = 0x0 hc-root = hc-list-sz = 0x1...
  • Page 100 DESC: A Solaris Fault Manager component generated a diagnosis for which no message summary exists. Refer to http://www.sun.com/msg/FMD-8000-11 for more information. AUTO-RESPONSE: The diagnosis has been saved in the fault log for examination by Sun. IMPACT: The fault log will need to be manually examined using fmdump(1M) in order to determine if any human response is required.
  • Page 101: Fmstat

    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 solve memsz bufsz You must have platadm, platop, or fieldeng privileges to run this command. Privileges Refer to setprivileges(8) for more information. OPTIONS The following options are supported. -m module OPERANDS The following operands are supported: count interval SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008 The total number of cases solved by this module since it was loaded.
  • Page 103 If neither count nor interval is specified, a single report is printed and fmstat exits. If an interval is specified but no count is specified, fmstat prints reports every interval seconds indefinitely until the command is interrupted by Ctrl-C. EXAMPLES Displaying FM Statistics for the Syslog Module EXAMPLE 1 fmstat -a -m syslog-msgs...
  • Page 104: Exit Status

    fmd.thrtotal 0 fmd.wcnt 0 fmd.wlastupdate 1144424838299131us hrtime of last wait queue update fmd.wlentime 30us fmd.wtime 30us fmd.xprtlimit 256 fmd.xprtopen 0 fmd.xprtqlimit 256 log_err 0 msg_err 0 no_msg 0 XSCF> module case-close fmd-self-diagnosis sysevent-transport syslog-msgs EXAMPLE 2 XSCF> EXIT STATUS The following exit values are returned: >0 SEE ALSO fmadm(8), fmdump(8)
  • Page 105: Getflashimage

    Lists firmware image files that are still on the XSCF unit, then exits. Automatically answers "n" (no) to all prompts. Specifies the proxy server to be used for transfers. The default transfer type is http, unless modified using the -t proxy_type option.
  • Page 106 XCPvvvv.tar.gz IKXCPvvvv.tar.gz FFXCPvvvv.tar.gz DCXCPvvvv.tar.gz and vvvv is the four-character version number. Downloading a Version from an http Server getflashimage http://imageserver/images/FFXCP1041.tar.gz Version Size FFXCP1040.tar.gz 46827123 Date Wed Mar 14 19:11:40 2007...
  • Page 107 1MB received 2MB received 43MB received 44MB received 45MB received Download successful: 46827KB at 1016.857KB/s Checking file... MD5: e619e6dd367c888507427e58cdb8e0a1 Downloading Using an http Proxy Server With Port 8080 EXAMPLE 3 getflashimage -p webproxy.sun.com:8080 XSCF> http://imageserver/images/FFXCP1041.tar.gz Existing versions: Version FFXCP1040.tar.gz Warning: About to delete existing versions.
  • Page 108 1MB received 2MB received 43MB received 44MB received 45MB received Download successful: 46827KB at 1016.857KB/s Checking file... MD5: e619e6dd367c888507427e58cdb8e0a2 EXAMPLE 4 XSCF> http://imageserver/images/FFXCP1041.tar.gz Existing versions: Warning: About to delete existing versions. Continue? [y|n]: Removing FFXCP1040.tar.gz. Password: [not echoed] 0MB received 1MB received 2MB received 43MB received...
  • Page 109 EXAMPLE 5 getflashimage file:///media/usb_msd/images/FFXCP1041.tar.gz XSCF> Existing versions: Version FFXCP1040.tar.gz Warning: About to delete existing versions. Continue? [y|n]: Removing FFXCP1040.tar.gz. Mounted USB device 0MB received 1MB received 44MB received 45MB received Download successful: 46827 Kbytes in 109 secs (430.094 Kbytes/sec) Checking file... MD5: e619e6dd367c888507427e58cdb8e0a4 EXIT STATUS The following exit values are returned:...
  • Page 110 getflashimage(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
  • Page 111: Ioxadm

    External I/O Expansion Units, link cards, and cards that contain Energy Storage Modules (ESM) and are attached to the host system. The M3000 server does not support External I/O Expansion Units. When using this utility you must specify an operand, and any options that operand requires.
  • Page 112 OPTIONS The following options are supported. target SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010 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.
  • Page 113 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. target sensors If no -e, -l, or -t option is specified, the command displays all sensor information.
  • Page 114 ■ ■ ■ 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 115 list [target] Lists the External I/O Expansion Units under system management. If no target is specified, list displays a list of External I/O Expansion Units, one per line. Each line contains the unique identifier for that box and the host-specific name(s) for its downlink card(s). See EXAMPLE 3. If an External I/O Expansion Unit argument or downlink card path is specified, the command displays a single line with the indicated FRU.
  • Page 116 poweron target Restores full power to an I/O boat or reenables output from the power supply (PS) that has previously been marked ready-to-remove. When a PSU is newly installed and the power switch is in the on position, or a boat is connected to a powered link card, they automatically power themselves on.
  • Page 117 IOX@A3B5/PS0 I_DC IOX@A3B5/PS0 S_FAN_ACTUAL IOX@A3B5/PS0 S_FAN_SET IOX@A3B5/PS1 T_AMBIENT IOX@A3B5/PS1 T_CHIP IOX@A3B5/PS1 T_HOTSPOT IOX@A3B5/PS1 SWITCH IOX@A3B5/PS1 V_12V_ANODE IOX@A3B5/PS1 V_12V_CATHODE IOX@A3B5/PS1 V_ISHARE IOX@A3B5/PS1 I_DC IOX@A3B5/PS1 S_FAN_ACTUAL IOX@A3B5/PS1 S_FAN_SET IOX@A3B5/IOB0 T_CHIP IOX@A3B5/IOB0 T_HOTSPOT IOX@A3B5/IOB1 T_CHIP IOX@A3B5/IOB1 T_HOTSPOT IOX@A3B5/IOB1 V_12_0V IOX@A3B5/IOB1 V_12V_MAIN IOX@A3B5/IOB1 V_1_0V IOX@A3B5/IOB1 V_1_5V IOX@A3B5/IOB1...
  • Page 118 EXAMPLE 3 XSCF> IOX@0033 IOX@12B4 In this example the list command is used to display the connections between External I/O Expansion Units and downlink cards in the host. IOX@0033 (which includes boats, uplink cards, and power supplies) is connected to the host through two downlink cards.
  • Page 119 Show runtime of card with ESM using verbose output EXAMPLE 7 ioxadm -v lifetime IOU#0-PCI#1 XSCF> Total Time On IOU#0-PCI#1 1052370 Clear runtime of card with ESM, show runtime is cleared EXAMPLE 8 ioxadm lifetime -z IOU#0-PCI#1 XSCF> ioxadm lifetime IOU#0-PCI#1 XSCF>...
  • Page 120 IOX@X031 XSCF> Location IOX@X031/PS1 The External I/O Expansion Unit chassis white LED has an integrated push button. The button can be used to toggle the state of the chassis white locator LED between off and fast. If the push button is used to turn off the locator LED, fast blink FRU service LEDs are cleared.
  • Page 121: Man

    NAME man - display manual pages of specified XSCF shell command SYNOPSIS man command_name ... man -h DESCRIPTION man(1) displays manual pages of specified XSCF shell command. No privileges are required to run this command. Privileges Refer to setprivileges(8) for more information. OPTIONS The following option is supported;...
  • Page 122 EXIT STATUS The following exit values are returned: >0 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007 Successful completion An error occurred.
  • Page 123: Moveboard

    The moveboard(8) command disconnects an XSB from the current domain and, based on the domain component list (DCL), assigns it to, or configures it in, the specified domain. The moveboard(8) command is not available on the M3000 server. One of the following movement methods can be specified: configure...
  • Page 124 OPTIONS The following options are supported: -c assign -c configure -c reserve -d domain_id SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009 Disconnects a configured XSB from its domain configuration and assigns it to the domain configuration of the move destination. If the -c option is omitted, "-c configure"...
  • Page 125 Solaris Service Management Facility (SMF) services are active on that domain: Domain SP Communication Protocol (dscp) ■ Domain Configuration Server (dcs) ■ Sun Cryptographic Key Management Daemon (sckmd) ■ When the command is executed, a prompt to confirm execution of the command ■...
  • Page 126 See the setdcl(8) and showdcl(8) commands for DCL. ■ EXAMPLES EXAMPLE 1 XSCF> EXAMPLE 2 XSCF> EXIT STATUS The following exit values are returned: >0 SEE ALSO addboard(8), deleteboard(8), setdcl(8), setupfru(8), showboards(8), showdcl(8), showdevices(8), showdomainstatus(8), showfru(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009 Disconnects XSB#00-0 from the current domain and attaches it to domain ID moveboard -d 1 00-0 Reserves assignment of the XSB#00-0 to the domain ID 1.
  • Page 127: Nslookup

    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 Address Name Address Privileges You must have one of the following privileges to run this command:...
  • Page 128 EXIT STATUS The following exit values are returned: >0 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007 Successful completion. An error occurred.
  • Page 129: Password

    NAME password - manage user passwords and expiration settings SYNOPSIS password [-e days| date|Never] [-i inactive] [-M maxdays] [-n mindays] [-w warn] [ user] password -h DESCRIPTION password (8) changes a user’s password and password expiration settings. The password is specified in up to 32 characters. The following characters are valid: 1.
  • Page 130 Refer to setprivileges(8) for more information. OPTIONS The following options are supported -e days|date|Never -i inactive SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009 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).
  • Page 131 -M maxdays -n mindays -w warn OPERANDS The following operands are supported: user EXAMPLES EXAMPLE 1 password -e 2008-02-02 XSCF> EXAMPLE 2 password -i 10 XSCF> EXIT STATUS The following exit values are returned: >0 SEE ALSO setpasswordpolicy(8), showpasswordpolicy(8) Sets the maximum number of days that a password is valid. This value is assigned to new user accounts when they are created.
  • Page 132 password(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009...
  • Page 133: Ping

    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 134 EXAMPLES EXAMPLE 1 XSCF> PING scf0-hostname0 (XX.XX.XX.XX): 56 data bytes 64 bytes from XX.XX.XX.XX: icmp_seq=0 ttl=64 time=0.1 ms 64 bytes from XX.XX.XX.XX: icmp_seq=1 ttl=64 time=0.1 ms 64 bytes from XX.XX.XX.XX: icmp_seq=2 ttl=64 time=0.1 ms --- scf0-hostname0 ping statistics --- 3 packets transmitted, 3 packets received, 0% packet loss round-trip min/avg/max = 0.1/0.1/0.1 ms EXIT STATUS The following exit values are returned:...
  • Page 135: Poweroff

    NAME poweroff - turn off the power to the specified domain SYNOPSIS poweroff [ [-q] -{y|n}] [-f] [-M] -d domain_id poweroff [ [-q] -{y|n}] -a [-M] poweroff -h DESCRIPTION The poweroff(8) command turns off the power to the specified domain. The command can turn off the power to the specified domain or to all domains.
  • Page 136 EXTENDED When the command is executed, a prompt to confirm execution of the command ■ DESCRIPTION with the specified options is displayed. Enter "y" to execute the command or "n" to cancel the command. If the Solaris OS of the target domain is running, the poweroff(8) command ■...
  • Page 137 Turns off power to domains with domain IDs 0. EXAMPLE 2 poweroff -d 0 XSCF> DomainIDs to power off:00 Continue? [y|n]: 00:Powering off *Note* This command only issues the instruction to power-off. The result of the instruction can be checked by the "showlogs power". Forcibly turns off power to domains with domain IDs 0.
  • Page 138 XSCF> EXIT STATUS The following exit values are returned: >0 SEE ALSO poweron(8), reset(8), showdomainstatus(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009 " " without displaying the prompt. poweroff -q -y -d 2 Successful completion. An error occurred.
  • Page 139: Poweron

    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 platadm, fieldeng...
  • Page 140 When the poweron(8) command is executed, power-on results for each of the ■ specified domains are displayed in the following format: Powering on Not Powering on An error occurred, and the power could not be turned on. An The showdomainstatus(8) command can be used to check whether the power ■...
  • Page 141 poweron -y -d 0 XSCF> DomainIDs to power on:00 Continue? [y|n]: 00:Powering on *Note* This command only issues the instruction to power-on. The result of the instruction can be checked by the "showlogs power". XSCF> EXAMPLE 4 poweron -q -y -d 1 XSCF>...
  • Page 142 poweron(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 143: Prtfru

    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 144 prtfru(8) /frutree/chassis/iou0/IOU (fru) /frutree/chassis/iou0/IOU/slot3 /frutree/chassis/iou0/IOU/slot3/LINK (container) /frutree/chassis/iou0/IOU/slot3/LINK/iox983392.IOX.iob1.PCIX.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)
  • Page 145 prtfru(8) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#9/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#10/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#11/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#12/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#13/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#14/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#15/MEM (container) /frutree/chassis/XSCFU (container) /frutree/chassis/OPNL (container) /frutree/chassis/PSU#0 (fru) /frutree/chassis/PSU#0/PSU (container) /frutree/chassis/PSU#2 (fru) /frutree/chassis/PSU#2/PSU (container) /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 prtfru -lc XSCF>...
  • Page 146 /frutree/chassis/MBU_B/MEMB#0/MEMB/MEM#2/MEM (container) /frutree/chassis/MBU_B/MEMB#0/MEMB/MEM#3/MEM (container) /frutree/chassis/MBU_B/MEMB#0/MEMB/MEM#4/MEM (container) /frutree/chassis/MBU_B/MEMB#0/MEMB/MEM#5/MEM (container) /frutree/chassis/MBU_B/MEMB#0/MEMB/MEM#6/MEM (container) /frutree/chassis/MBU_B/MEMB#0/MEMB/MEM#7/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#8/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#9/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#10/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#11/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#12/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#13/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#14/MEM (container) /frutree/chassis/MBU_B/MEMB#1/MEMB/MEM#15/MEM (container) /frutree/chassis/XSCFU (container) /frutree/chassis/OPNL (container) /frutree/chassis/PSU#0/PSU (container) /frutree/chassis/PSU#2/PSU (container) /frutree/chassis/IOU#0/IOU (container) /frutree/chassis/IOU#0/IOU/DDCR#0/DDCR (container) /frutree/chassis/FANBP_C#0/FANBP_C (container) EXIT STATUS...
  • Page 147: Rebootxscf

    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 148 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 149: Replacefru

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

    NAME reset - reset the specified domain SYNOPSIS reset [ [-q] -{y|n}] -d domain_id level reset -h Note – Since the reset(8) command forcibly resets the system, this command may DESCRIPTION cause a failure in a hard disk drive or other components. Use this command only for the purpose of recovery, such as if the Solaris OS hangs, and for other limited purposes.
  • Page 152 OPERANDS The following operand is supported: level 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. The showdomainstatus(8) command can be used to check whether the domain ■...
  • Page 153 *Note* This command only issues the instruction to reset. The result of the instruction can be checked by the "showlogs power". EXAMPLE 3 reset -q -y -d 0 por XSCF> EXAMPLE 4 reset -d 0 panic XSCF> DomainID to panic:00 Continue? [y|n]: EXIT STATUS The following exit values are returned:...
  • Page 154 reset(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 155: Resetdateoffset

    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 156 resetdateoffset(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 157: Restoreconfig

    Specifies the proxy server to be used for transfers. The default transfer type is http, unless modified using the -t proxy_type option. The value for proxy must be in the format servername:port.
  • Page 158 XSCF unit(s) have been halted, cut power to the system, wait at least 30 seconds, then restore power. Note that the configuration data file can be restored only to the same class of server; that is, a configuration file created by dumpconfig(8) on an M5000 server can be restored to another M5000 server, but it cannot be restored to an M3000 or M8000 server.
  • Page 159 * 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 ’’ * Server auth using Basic with user ’minilla’ > GET ftp://10.7.79.18/sollgell/proxytest-ftp.cfg HTTP/1.1 Authorization: Basic bHdhbmc6bHdhbmc= User-Agent: restoreconfig Host: 10.7.79.18:21...
  • Page 160 < 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" < Accept-ranges: bytes < Via: 1.1 proxy-proxy <...
  • Page 161 > 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 < Last-Modified: Mon, 04 Aug 2008 20:01:51 GMT System Administration...
  • Page 162 < ETag: "4fa2a-601b-4897602f" < Accept-Ranges: bytes < Content-Length: 24603 < Content-Type: text/plain * Connection #0 to host 10.7.79.18 left intact * Closing connection #0 done file decoding done. Configuration backup created on Mon Aug from system ‘M3000’ with serial number ‘IKS08220xx’, version ‘19830000’ validating backup configuration data *** You will need to power-cycle the entire system after this operation is completed...
  • Page 163 Host: 10.7.79.18 Pragma: no-cache Accept: */* < HTTP/1.1 200 OK < Date: Wed, 13 Aug 2008 23:29:42 GMT < Server: Apache/1.3.36 (Unix) mod_perl/1.29 mod_ssl/2.8.27 OpenSSL/0.9.7d < Last-Modified: Wed, 13 Aug 2008 23:25:16 GMT < ETag: "4fa55-501b-48a36d5c" < Accept-Ranges: bytes < Content-Length: 20507 <...
  • Page 164 EXIT STATUS The following exit values are returned: >0 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009 Successful completion. An error occurred.
  • Page 165: Restoredefaults

    DESCRIPTION The restoredefaults(8) command deletes the setting and the log information that stored in the server or the XSCF unit, and restores it to the state as of the factory shipment. As the range of restoration, one of the following can be specified:...
  • Page 166 EXAMPLES EXAMPLE 1 XSCF> WARNING: If this system does not have OPNL, this command will set all the user settable XSCF configuration parameters to their default value as they were set when the system was shipped out. Furthemore, this command will delete all logs on both XSCFUs. Check the man page of this command before you run it.
  • Page 167 (Apr SCF board boot factor = a040 DDR Real size: 512 MB DDR: 480 MB XSCF BOOT STOP (recover by NFB-OFF/ON) Restores the server to the state as of the factory shipment. EXAMPLE 2 restoredefaults -c factory XSCF> WARNING: If this system does not have OPNL, this command will set all the user settable XSCF configuration parameters to their default value as they were set when the system was shipped out.
  • Page 168 XSCF will be automatically rebooted. Afterwards, XSCFU will be initialized. Continue?[yes/no](default no): The NVRAM setting of XSCFU#0 was completed. XSCF shutdown request was completed. <snip>...XSCF reboot..<snip> ***** WARNING ***** XSCF initialization terminate for XSCF/OPNL data clear. execute "setdefaults factory" (AUTO) setdefaults : FACTORY mode clear : start setdefaults : FACTORY mode clear : DBS start setdefaults : FACTORY mode clear : wait 20s for DBS initialization...
  • Page 169 EXIT STATUS The following exit values are returned: >0 Successful completion. An error occurred. System Administration...
  • Page 170 restoredefaults(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
  • Page 171: Sendbreak

    NAME sendbreak - send a break signal to the specified domain SYNOPSIS sendbreak -d domain_id sendbreak [ [-q] -{y|n}] -d domain_id sendbreak -h DESCRIPTION The sendbreak(8) command sends a break signal to the specified domain. When a break signal is sent from the domain console to the Solaris OS of the domain, control is transferred from the Solaris OS to OpenBoot PROM and the OpenBoot PROM prompt "ok"...
  • Page 172 sendbreak(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 173: Setad

    -i n roles [ privileges] setad userdomain -i n [ domainname ] setad defaultrole [ privileges] setad timeout seconds setad server [-i n] [ ipaddr [: port]] setad logdetail none|high|medium|low|trace setad log [[-q] -{y|n}] clear setad dnslocatormode|expsearchmode|strictcertmode enable|disable...
  • Page 174 Sets an index marker, value 1 - 5. Automatically answers "n" (no) to all prompts. Specifies the proxy server to be used for transfers. The default transfer type is http, unless modified using the -t proxy_type option. The value for proxy must be in the format servername:port.
  • Page 175 1 to 20. The default is 4. If the specified timeout is too brief for the configuration, the login process or retrieval of user privilege settings could fail. server Configure the primary and up to five alternate Active Directory servers. To use a host name, DNS must be enabled.
  • Page 176 Enable or disable DNS locator mode. This mode is disabled by default. If enabled, XSCF queries a DNS server to learn the Active Directory server to use for user authentication. Enable or disable expanded search mode. The default Active Directory functionality is intentionally restrictive to ensure proper security.
  • Page 177 EXAMPLES Configures the Active Directory primary server, specifying a port other than EXAMPLE 1 the default. setad server 10.1.12.250:4040 XSCF> Sets name for administrator group 3. EXAMPLE 2 setad group administrator -i 3 name CN=spSuperAdmin, XSCF> OU=Groups,DC=Sales,DC=aCompany,DC=com Sets name for custom group 2.
  • Page 178 -i 2 Loads a server certificate for Active Directory using the specified URI. setad loadcert http://domain_2/UID_2333/testcert Loads a server certificate for Active Directory using an http Proxy Server with port 8080 . setad loadcert -p webproxy.aCompany.com:8080 Loads a server certificate for Active Directory using a username and pass- word.
  • Page 179 setad dnslocatorquery -i 2 XSCF> '_ldap._tcp.gc._msdcs.<DOMAIN>.<PORT:3269>' EXAMPLE 15 setad defaultrole platadm platop XSCF> EXIT STATUS The following exit values are returned: >0 SEE ALSO showad(8) <DOMAIN> substitution marker. Configures the default privileges, where privileges are the same as those used in the setad group custom roles command.
  • Page 180 setad(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010...
  • Page 181: Setaltitude

    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 182 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 183: 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 184 Next, setarchiving displays the key’s md5 fingerprint and prompts you for confirmation of the identity of the host to continue. If you accept the key, it is saved and used for server authentication. If you reject the key, setarchiving exits without changing the configuration.
  • Page 185 It must be an integer in the range of 500–50000. If unset, the initial value for non-audit-limit depends on the type of server. Use the showarchiving(8) command to determine the value for your server.
  • Page 186 OPERANDS The following operands are supported: enable disable EXAMPLES EXAMPLE 1 XSCF> logs -r Enter ssh password for jsmith@somehost.company.com: EXAMPLE 2 XSCF> Downloading public host key from somehost.company.com... Fingerprint: c3:75:f9:97:7d:dc:le:le:62:06:c1:6f:87:bc:e8:0d Accept this public key (yes|no): EXAMPLE 3 XSCF> EXAMPLE 4 XSCF>...
  • Page 187: Setaudit

    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 188 The following are valid classes: ACS_SYSTEM(1) ACS_WRITE(2) ACS_READ(4) ACS_LOGIN(8) ACS_AUDIT(16) ACS_DOMAIN(32) ACS_USER(64) ACS_PLATFORM(128) ACS_MODES(256) This option may be specified multiple times. Multiple specification are processed together with an -e options in the order listed. See EXAMPLE 1. When set to enable or disable, audit record generation for the classes is turned on or off respectively.
  • Page 189 -g enable|disable Sets the global user audit record generation policy. When set to disable, no audit record which can be attributed to any user account is generated. These settings can be overridden on an individual user basis using the -a option. Displays usage statement.
  • Page 190 For more information on the secondary partition, refer to the Administration Guide for your server. Turns off the writing of audit records to the audit trail and notifies the log archiving facility to archive the current audit trail.
  • Page 191 Warnings will be sent at 50% capacity and 75% capacity. EXIT STATUS The following exit values are returned: >0 SEE ALSO showaudit(8) Successful completion. An error occurred. System Administration...
  • Page 192 setaudit(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
  • Page 193: Setautologout

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

    You can also enable headroom and reserve COD Hardware Activation permits for some domains with setcod(8). The setcod(8) command is not available on the M3000 server. When no domain_id is specified, current values are displayed in the square brackets ([]) at the command prompt. If no value is specified for an operand, it retains its current value.
  • Page 196 OPERANDS The following operands are supported: headroom proc-permits EXTENDED If you run the setcod command without specifying any options, the command DESCRIPTION prompts you for COD information. You are asked to specify the amount of COD headroom to be used, and the number of COD permits to be reserved for your domains.
  • Page 197 PROC Permits reserved for domain 13 (0 MAX) [0]: PROC Permits reserved for domain 14 (0 MAX) [0]: PROC Permits reserved for domain 15 (0 MAX) [0]: After this command completes, you will see a message similar to this one in the XSCF console: Aug 28 17:28:30 FF1-1-0 codd[PID]: COD PROC Headroom changed to 3 EXAMPLE 2...
  • Page 198 setcod(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010...
  • Page 199: Setdate

    XSCF. When there is a defect on the standby XSCF, it leads to an error and the setting will be reflected to the active XSCF only. If the XSCF is used as an NTP server, change the XSCF time, and synchronize the ■...
  • Page 200 When an NTP server has been set to XSCF, the setdate(8) command results in ■ an error. Whether an NTP server set to XSCF or not can be checked by using the showntp(8) command. To check the currently set XSCF date and time, execute the showdate(8) ■...
  • Page 201 EXAMPLE 4 setdate -q -y -s 012716592006.00 XSCF> XSCF> The reset continues after this point. The following exit values are returned: EXIT STATUS >0 SEE ALSO setntp(8), settimezone(8), showdate(8), showntp(8), showtimezone(8) Sets "January 27 16:59:00 2006" of the local time (JST) as the current time. Au- tomatically replies with "...
  • Page 202 setdate(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010...
  • Page 203: Setdcl

    Degradation range applicable for an error detected during an initial diagnosis of ■ hardware (policy) On the M3000 server, the setdcl(8) command can set policy only. For the LSB: XSB number of the XSB to be associated with an LSB (lsb, xsb) ■...
  • Page 204 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008 Specifies an XSB number to be associated with an LSB number in the domain. The following form can be accepted. On the M3000 server, you cannot specify this option. lsb=xsb Specifies an LSB number. An integer ranging from 0 to 15 can be specified.
  • Page 205 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 206 Specifies unique lsb within the domain. If the same lsb number is specified, an error occurs. On the M3000 server, you cannot specify this option. Sets XSB#00-0 for LSB#00 and XSB#00-1 for LSB#01 of domain ID 0.
  • Page 207 EXAMPLE 3 setdcl -d 0 -s policy=system XSCF> EXAMPLE 4 setdcl -d 0 -r 00 01 XSCF> EXIT STATUS The following exit values are returned: >0 SEE ALSO addboard(8), deleteboard(8), moveboard(8), setupfru(8), showboards(8), showdcl(8), showdevices(8), showfru(8) Sets policy=system for domain ID 0. Clear the XSBs associated with LSB#00 and #01 of domain ID 0.
  • Page 208 setdcl(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
  • Page 209: Setdomainmode

    (auto), or manually set to the compatible mode (compatible). The default is to let it automatically determined at domain startup. On the M3000 server, you cannot specify CPU Mode. The CPU operational mode includes the following two types: SPARC64 VII enhanced mode Operates using the enhanced functions of SPARC64 VII processor.
  • Page 210 Host watchdog and suppress break signal reception, auto boot function, and ■ operational mode of CPU: platadm domainadm Refer to setprivileges(8) for more information. OPTIONS The following options are supported: -d domain_id SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008 Can run this command for all domains.
  • Page 211 Specifies whether to enable or disable the Auto boot function. Sets the operational mode of CPU. When you specified cpumode on the M3000 server, it results in an error. No diagnosis is performed. Sets standard for the diagnostic level.
  • Page 212 (continued) When the command is executed, a prompt to confirm execution of the command EXTENDED ■ DESCRIPTION with the specified options is displayed. Enter "y" to execute the command or "n" to cancel the command. The system board (XSB) which can be added by Dynamic Reconfiguration (DR) ■...
  • Page 213 Domain CPU Value of CPU configuration Mode SPARC64 VII compatible SPARC64 VII/VI auto or compatible SPARC64 VI auto or compatible For details of the CPU operational mode and the DR operation, see the DR User’s Guide. To add the XSB other than those above, you need to perform the domain ■...
  • Page 214 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 215 EXAMPLE 3 setdomainmode -d 0 -m diag=none XSCF> Diagnostic Level Secure Mode Autoboot CPU Mode The specified modes will be changed. Continue? [y|n]: EXAMPLE 4 setdomainmode -q -y -d 0 -m autoboot=on XSCF> EXIT STATUS The following exit values are returned: >0 SEE ALSO showdomainmode(8), showdomainstatus(8)
  • Page 216 setdomainmode(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
  • Page 217: Setdomparam

    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 218 OPERANDS The following operands are supported: use-nvramrc security-mode Sets none to the security-mode? environment variable. set-defaults When the command is executed, a prompt to confirm execution of the command EXTENDED DESCRIPTION with the specified options is displayed. Enter "y" to execute the command or "n" to cancel the command.
  • Page 219 EXIT STATUS The following exit values are returned: >0 Successful completion. An error occurred. System Administration...
  • Page 220 setdomparam(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 221: 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...
  • Page 222 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 223 Assigning All DSCP Addresses EXAMPLE 1 setdscp -y -i 10.1.1.0 -m 255.255.255.0 XSCF> Commit these changes to the database? [y|n] : y Assigning an Alternative IP address to Domain 1 EXAMPLE 2 setdscp -d 1 -i 10.1.1.26 XSCF> Commit these changes to the database? [y|n] : Specifying a Netmask Address With -q and -y Options EXAMPLE 3 setdscp -q -y -i 10.1.1.0 -m 255.255.255.0...
  • Page 224 Domain #11 address Domain #12 address Domain #13 address Domain #14 address Domain #15 address Domain #16 address Domain #17 address Domain #18 address Domain #19 address Domain #20 address Domain #21 address Domain #22 address Domain #23 address Commit these changes to the database [y|n]? EXIT STATUS The following exit values are returned: >0...
  • Page 225: Setdualpowerfeed

    M8000/M9000 servers, it automatically configures dual power feed mode. For details about the setting of dual power feed, see the Installation Guide for your server. To enable the dual power feed mode, you need to execute the rebootxscf(8) command or turn off and on the input power.
  • Page 226 EXAMPLE 2 XSCF> disable -> enable NOTE: Dual power feed will be enabled the next time the platform is powered EXIT STATUS The following exit values are returned: >0 SEE ALSO rebootxscf(8), showdualpowerfeed(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009 Enables dual power feed mode in the system.
  • Page 227: Setemailreport

    Where: You can set up email reporting noninteractively by using the -s option. After the email server and port have been set up using setsmtp(8), you can use setemailreport -t to send a test email message. You must have platadm privileges to run this command.
  • Page 228 OPTIONS The following options are supported: -s variable=value EXAMPLES EXAMPLE 1 XSCF> Enable Email Reporting? [no]: Email Recipient Address [useradm@company.com]: Do you want to send a test mail now (Yes/No): no EXAMPLE 2 XSCF> Enable Email Reporting? [yes]: Email Recipient Address[useradmin@company.com]: -a adm2@company.com EXAMPLE 3 XSCF>...
  • Page 229 -t XSCF> ...Sending test email to useradm@company.com [Email contents shown below] Host Name: jupiter Send Timestamp: 04-20-2006 16:31:45 PST Mail Server: 10.4.1.1 EXIT STATUS The following exit values are returned: >0 SEE ALSO setsmtp(8), showemailreport(8) Enable Email Reporting Noninteractively Sending Test Email Successful completion.
  • Page 230 setemailreport(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 231: Sethostname

    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 232 OPERANDS The following operands are supported: hostname xscfu EXTENDED The following situations result in an error by the applynetwork(8) command: ■ DESCRIPTION Both host name and domain name are not set. ■ On M8000/M9000 servers, the host name is not set to both xscf#0 and xscf#1. ■...
  • Page 233 sethostname(8) SEE ALSO applynetwork(8), setnameserver(8), showhostname(8) System Administration...
  • Page 234 sethostname(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010...
  • Page 235: Sethttps

    Creating a self-signed web server certificate ■ Creating the private key of the web server ■ Creating a web server certificate signing request (CSR) to an external certification ■ authority Importing a web server certificate signed by an external certification authority ■...
  • Page 236 Automatically answers "y" (yes) to all prompts. Specifies common names, such as the creator name and the host name of a server, using up to 64 characters. If "-c selfsign" is specified, the value with only spaces is not allowed.
  • Page 237 If you include a backslash or dollar mark in a value, put a backslash before the ■ symbol; for example, "\\" or "\$". EXTENDED When the HTTPS server is enabled or there is a private certificate authority, web ■ DESCRIPTION server certificate, or web server secret key, a prompt to confirm execution of the command with the specified options is displayed.
  • Page 238 CSR. If the file to be generated is too large for XSCF, the command fails with an error. If you see this error, reduce the number of characters in the operands and execute the sethttps(8) command again.
  • Page 239 EXAMPLE 7 without displaying the prompt. sethttps -c genserverkey -q -y XSCF> Enter passphrase: Verifying - Enter passphrase: Imports the web server certificate. To exit, press the Enter key and then press EXAMPLE 8 " " and " " Ctrl sethttps -c importca XSCF>...
  • Page 240 set ht t ps( 8) 5A51Yuhf8OGrR+bYGli6H1a6RPmlMSD7Z0AGDxR0eY0CAwEAAaOCAQ0wggEJMAkG A1UdEwQCMAAwLAYJYIZIAYb4QgENBB8WHU9wZW5TU0wgR2VuZXJhdGVkIENlcnRp ZmljYXRlMB0GA1UdDgQWBBQHIlCmI7QyZa8zpt1Hl6EfLR+EwDCBrgYDVR0jBIGm MIGjgBTnQYs6jzD7wdDhk7wsFeJGVaUTtaGBh6SBhDCBgTELMAkGA1UEBhMCamox DjAMBgNVBAgTBXN0YXRlMREwDwYDVQQHEwhsb2NhbGl0eTEVMBMGA1UEChMMb3Jn YW5pemF0aW9uMQ8wDQYDVQQLEwZvcmdhbmkxDzANBgNVBAMTBmNvbW1vbjEWMBQG CSqGSIb3DQEJARYHZWUubWFpbIIBADANBgkqhkiG9w0BAQQFAAOBgQCqBFbo88Hi yvOUyW8E8ll1AbuA04IrnjHI4cjHq9NuSX1w8mJsXKTVMx3WZCJpJDC+f/WoRMKw R+OpXAVQvb2tjIn3kO99dq+begECo4mwknW1t7QI7A1BkcW2/MkOolIRa6iP1Zwg JoPmwAbrGyAvGUtdzUoyIH0jl7dRQrVIRA== -----END CERTIFICATE----- [Enter] [Ctrl]and[D] EXAMPLE 9 XSCF> "\\development" scf-host abc@example.com EXIT STATUS The following exit values are returned: >0 SEE ALSO rebootxscf(8), showhttps(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010 Specifies "\development"...
  • Page 241: Setldap

    Note – The LDAP client supports passwords only in the CRYPT format; UNIX Crypt or MD5. Therefore the passwords on the LDAP server must support it as well. Refer to the Administration Guide for more information. Also note that an XSCF user account user name cannot match an LDAP user name, and an XSCF user account (UID) number cannot match an LDAP UID number.
  • Page 242 Tests connections to all configured LDAP servers. Attempts to retrieve the password data for the specified user from each configured server and reports success or failure in each case. Sets the maximum time allowed for an LDAP search before it returns search results.
  • Page 243: Importing A Certificate

    XSCF> showldap XSCF> Bind Name: Base Distinguished Name: ou=people,dc=company,dc=com LDAP Search Timeout: Bind Password: LDAP Servers: CERTS: Setting the LDAP Server EXAMPLE 4 setldap -s ldap://company.com,ldaps://company2.com XSCF> showldap XSCF> Bind Name: Base Distinguished Name: ou=people,dc=company,dc=com LDAP Search Timeout: Bind Password:...
  • Page 244 EXIT STATUS The following exit values are returned: >0 SEE ALSO setlookup(8), showldap(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010 Successful completion. An error occurred.
  • Page 245: Setldapssl

    -i n roles [ privileges] setldapssl userdomain -i n [ domainname ] setldapssl defaultrole [ privileges] setldapssl timeout seconds setldapssl server [-i n] [ ipaddr [: port]] setldapssl logdetail none|high|medium|low|trace setldapssl log [[-q] -{y|n}] clear setldapssl strictcertmode|usermapmode enable|disable...
  • Page 246 Sets an index marker, value 1 - 5. Automatically answers "n" (no) to all prompts. Specifies the proxy server to be used for transfers. The default transfer type is http, unless modified using the -t proxy_type option. The value for proxy must be in the format servername:port.
  • Page 247 If defaultrole is not configured, users’ privileges will be learned from the LDAP/SSL server based on group membership. timeout Configure transaction timeout, in seconds. seconds can be 1 to 20.
  • Page 248 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 249 EXAMPLES Configures the LDAP/SSL primary server, specifying a port other than the EXAMPLE 1 default. setldapssl server 10.1.12.250:4040 XSCF> Sets name for administrator group 3. EXAMPLE 2 setldapssl group administrator -i 3 name CN=spSuperAdmin, XSCF> OU=Groups,DC=Sales,DC=aCompany,DC=com Sets name for custom group 2.
  • Page 250 Configures the optional user mapping search base setting. setldapssl usermap searchbase OU=yoshi,DC=aCompany,DC=com Loads a server certificate for LDAP/SSL using the specified URI. setldapssl loadcert http://domain_2/UID_2333/testcert Loads a server certificate for LDAP/SSL using an http Proxy Server with port...
  • Page 251 >0 SEE ALSO showldapssl(8) 8080 . Loads a server certificate for LDAP/SSL using a username and password. Sets logging of high-severity diagnostic messages. Clears diagnostic messages from the log file, answering Yes to all prompts. Successful completion. An error occurred.
  • Page 252 setldapssl(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010...
  • Page 253: Setlocale

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

    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 Stop blinking Privileges...
  • Page 256 EXIT STATUS The following exit values are returned: >0 SEE ALSO showlocator(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised March 2008 Successful completion. An error occurred.
  • Page 257: Setloginlockout

    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. You must have useradm privileges to run this command.
  • Page 258 EXIT STATUS The following exit values are returned: >0 SEE ALSO showloginlockout(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009 Successful completion. An error occurred.
  • Page 259: Setlookup

    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 260 EXIT STATUS The following exit values are returned: >0 SEE ALSO setldap(8), showlookup(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010 Successful completion. An error occurred.
  • Page 261: Setnameserver

    "-c del." When deleting all DNS search paths, this option is used together with "-c delsearch." Adds the host with the specified IP address as a DNS server. This option is used together with address. If the -c option is omitted, "-c add"...
  • Page 262 The registered DNS search path is used, as in the case where you use the ■ nslookup(8) command and refer to the DNS server for the host name. The host name that you specified in the nslookup(8) command will be appended with the domain name which registered in the DNS search path, and be referred to the DNS server in the FQDN format.
  • Page 263 To change the DNS servers and the DNS search paths in XSCF, execute the ■ applynetwork(8) command. Then, use the rebootxscf(8) command to reset XSCF, completing the change. The currently set DNS server can be checked by using the shownameserver(8) ■ command. EXAMPLES Adds the hosts with the IP addresses 192.168.1.2, 10.18.108.10, and 10.24.1.2...
  • Page 264 EXAMPLE 7 XSCF> EXIT STATUS The following exit values are returned: >0 SEE ALSO applynetwork(8), sethostname(8), shownameserver(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010 Deletes all the registered domain names from the DNS search path. setnameserver -c delsearch -a Successful completion.
  • Page 265: Setnetwork

    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 266 OPTIONS The following options are supported: -c {up|down} -m addr OPERANDS The following operands are supported: address SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010 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.
  • Page 267 interface 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 268 After you set the network interface, if you disable that network interface and ■ execute the applynetwork(8) command, the setting data of IP address and netmask will be stored in XSCF. When you enable the network interface, the setting of IP address and netmask will be used. In the following cases, the setnetwork(8) command results in an error: ■...
  • Page 269 -m 255.255.255.0 192.168.10.10 XSCF> Sets the IP address 192.168.10.10 and netmask 255.255.255.0 for XSCF-LAN#0 EXAMPLE 2 on XSCF unit 0 in an M3000/M4000/M5000 server. setnetwork lan#0 -m 255.255.255.0 192.168.10.10 XSCF> Disables XSCF-LAN#1 on XSCF unit 0. EXAMPLE 3 setnetwork xscf#0-lan#1 -c down XSCF>...
  • Page 270 EXIT STATUS The following exit values are returned: >0 SEE ALSO applynetwork(8), rebootxscf(8), shownetwork(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010 Successful completion. An error occurred.
  • Page 271: Setntp

    NTP servers. If the -c option is omitted, "-c add" is assumed specified. When deleting multiple NTP servers, the servers are deleted in the order they are specified. See Sets the stratum value in case you regard XSCF as an NTP server. EXAMPLE 4 System Administration...
  • Page 272 "-c stratum". An integer from 1 to 15 can be specified. If the stratum value not specified, it is 5. Sets the preferred server or the local clock of XSCF. You can specify either of the following for type: Specifies whether priority should be given to...
  • Page 273 XSCF. After the XSCF is reset, its time is synchronized with the time of the selected ■ NTP server. The current NTP server settings set by the setntp(8) command can be checked ■ by using the showntp(8) command. EXAMPLES EXAMPLE 1 setntp 192.168.1.2 10.18.108.10 10.24.1.2...
  • Page 274 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010 Adds the two NTP servers ntp1.examples.com and ntp2.example.com. setntp ntp1.example.com ntp2.example.com Deletes the first NTP server whose IP address is 192.168.1.2. This case is when a NTP server is listed multiple times. showntp -a setntp -c del 192.168.1.2...
  • Page 275: Setpacketfilters

    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 276 -i interface -j target SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010 Specifies the XSCF network interface to which you set the IP packet filtering rules. Any of the following can be set. In M3000/M4000/M5000 servers: ■...
  • Page 277 -s address[/mask] 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. The IP packet filtering rules are applied in the order in which they are defined. ■...
  • Page 278 NOTE: applied IP packet filtering rules. Continue? [y|n] : XSCF> EXAMPLE 2 XSCF> xscf#0-lan#0 -j ACCEPT -s 192.168.100.0/255.255.255.0 -i xscf#0-lan#0 -j ACCEPT NOTE: applied IP packet filtering rules. Continue? [y|n] : XSCF> -s 192.168.100.0/255.255.255.0 -i xscf#0-lan#0 -j ACCEPT -i xscf#0-lan#0 -j DROP NOTE: applied IP packet filtering rules.
  • Page 279 EXAMPLE 4 setpacketfilters -c clear XSCF> (none) NOTE: applied IP packet filtering rules. Continue? [y|n] : XSCF> EXIT STATUS The following exit values are returned: >0 SEE ALSO showpacketfilters(8) Clears all IP packet filtering rules which have been set. Successful completion. An error occurred.
  • Page 280 setpacketfilters(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010...
  • Page 281: Setpasswordpolicy

    NAME setpasswordpolicy - manage the system password policy SYNOPSIS setpasswordpolicy [-d dcredit] [ -e expiry] [-i inactive] [-k difok] [-l lcredit] [ -M maxdays] [-m minlen] [-n mindays] [-o ocredit] [-r remember] [-u ucredit] [-w warn] [-y retry] setpasswordpolicy -h DESCRIPTION setpasswordpolicy(8) allows an administrator to change the system password policy.
  • Page 282 -k difok -l lcredit -M maxdays -m minlen -n mindays -o ocredit -r remember SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009 Sets the minimum number of new characters (characters which were not present in the old password) that a new password must contain.
  • Page 283 -u ucredit -w warn -y retry EXAMPLES EXAMPLE 1 setpasswordpolicy -m 12 -r 5 XSCF> EXAMPLE 2 setpasswordpolicy -m 10 -d 1 -u 0 -l 0 -o 1 XSCF> After running this command, the minimum password length for new passwords is 10 characters.
  • Page 284 setpasswordpolicy(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009...
  • Page 285: Setpowerupdelay

    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 286 EXAMPLE 2 XSCF> EXIT STATUS The following exit values are returned: >0 SEE ALSO showpowerupdelay(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2009 Sets the wait time before system startup to 20 minutes. setpowerupdelay -c wait -s 20 Successful completion.
  • Page 287: Setprivileges

    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 288 OPERANDS The following operands are supported: domainprivilege@domains privileges SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008 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...
  • Page 289 The following are valid values for privileges: auditadm auditop fieldeng none platadm platop useradm user Specifies a valid user name. EXAMPLES EXAMPLE 1 setprivileges jsmith platadm domainadm@1–4,6,9 XSCF> EXAMPLE 2 setprivileges jsmith none XSCF> EXIT STATUS The following exit values are returned: >0 Can configure auditing.
  • Page 290 setprivileges(8) SEE ALSO setpasswordpolicy(8), showuser(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
  • Page 291: Setroute

    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 292 -m address -n address SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010 Displays usage statement. When used with other options or operands, an error occurs. Specifies the netmask to which routing information is forwarded. To specify address, use the standard form of four integer values delimited by "."...
  • Page 293 OPERANDS The following operand is supported: interface EXTENDED In the following cases, the setroute(8) command results in an error. ■ DESCRIPTION When you tried to set more than eight routing information ■ When the netmask that specified by using the -m addr option does not ■...
  • Page 294 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. EXAMPLES EXAMPLE 1 XSCF>...
  • Page 295 EXIT STATUS The following exit values are returned: >0 SEE ALSO applynetwork(8), showroute(8) Successful completion. An error occurred. System Administration...
  • Page 296 setroute(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010...
  • Page 297: Setshutdowndelay

    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 298 setshutdowndelay(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
  • Page 299: Setsmtp

    When used without options, this command prompts for the name of the SMTP email server to be used, and for the port and the Reply-To address to be used on outgoing email. Make sure that a valid email address is specified here. The -s option lets you specify SMTP settings noninteractively.
  • Page 300 Where: mailserver is specified by IP address or server name. Server name, if specified, must be resolvable. port is the port address for replies. auth is the authentication mechanism. Valid values are: none, pop, and smtp-auth.
  • Page 301 EXAMPLE 3 setsmtp XSCF> Mail Server [10.4.1.1]: Port [25]: Authentication Mechanism [none]: User Name []: Password []: Reply Address [useradm@company.com]: EXAMPLE 4 setsmtp XSCF> 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]:...
  • Page 302 setsmtp(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 303: Setsnmp

    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...
  • Page 304 -l system-location -p agent-port -s community-string OPERANDS The following operands are supported: addtraphost SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009 Specifies the system location for the agent. Specifies the listening port for the agent. The default is 161.
  • Page 305 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 306 Sun MC in servers running Sun MC. The Sun MC configuration is not affected, but to enable SNMP for Sun MC again, execute the setsunmc(8) command with its -s option – sunmc-server, where sunmc-server is the server setsunmc -s hostname previously set – then, execute...
  • Page 307 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 308 EXAMPLES EXAMPLE 1 XSCF> EXAMPLE 2 XSCF> -e yyyyyyyy fiche EXAMPLE 3 XSCF> Authentication Password: Encryption Password: EXAMPLE 4 XSCF> EXIT STATUS The following exit values are returned: >0 SEE ALSO setsunmc(8), showsnmp(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009 Setting Up System Information setsnmp -l sandiego -c username@company.com -d ff1 Setting Up and SNMPv3 Trap Host With Password Options...
  • Page 309: Setsnmpusm

    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 310 OPERANDS The following operands are supported: clone SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised March 2008 Makes the supplied user known to the agent for subsequent SNMP communication with the identical settings as the specified clone_user. -u clone_user Specifies a valid user name of the user settings to be cloned.
  • Page 311 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 312 EXAMPLES EXAMPLE 1 XSCF> EXAMPLE 2 XSCF> Authetication Password: Encryption Password: EXAMPLE 3 XSCF> Authentication Password: Encryption Password: EXAMPLE 4 XSCF> EXIT STATUS The following exit values are returned: >0 SEE ALSO showsnmpusm(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised March 2008 Adding a User With Password Options setsnmpusm create -a SHA -p xxxxxxxx -e yyyyyyyy jsmith Adding a User Without Specifying Password Options...
  • Page 313: Setsnmpvacm

    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 314 OPERANDS The following operands are supported: createaccess creategroup createview deleteaccess deletegroup deleteview EXAMPLES EXAMPLE 1 XSCF> SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007 Sets access to a MIB view for the specified group. -r read_viewname groupname Sets up a group for the specified user for view access.
  • Page 315 EXAMPLE 2 setsnmpvacm createview -s .1 all_view XSCF> EXAMPLE 3 setsnmpvacm createview -e -s .1.3.6.1.2.1.1 -m fe excl_view XSCF> EXAMPLE 4 setsnmpvacm createaccess -r all admin XSCF> EXIT STATUS The following exit values are returned: >0 SEE ALSO showsnmpvacm(8) Create a View of the Entire MIB Create a View Where the Subtree Is Excluded Create Access Successful completion.
  • Page 316 setsnmpvacm(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 317: Setssh

    NAME setssh - configure the settings for the Secure Shell (SSH) service used in the XSCF network SYNOPSIS setssh [ [-q] -{y|n}] -c enable setssh -c disable setssh [ [-q] -{y|n}] -m dscp= mode setssh -c addpubkey [-u user_name] setssh -c delpubkey {-a | -s line } [-u user_name] setssh [ [-q] -{y|n}] -c genhostkey setssh -h DESCRIPTION...
  • Page 318 OPTIONS The following options are supported: -c addpubkey -c delpubkey -c {enable|disable} Specifies whether to enable the SSH service. One of the -c genhostkey -m dscp=mode -s line -u user_name EXTENDED When a host public key is created, a prompt to confirm execution of the ■...
  • Page 319 The setssh(8) command can register one user public key at a time. ■ In time of setssh(8) command execution, finish the input of user public key by ■ pressing Enter and then pressing "Ctrl" and "D" (EOF). In case the XSCF unit is duplicated configuration, the setting automatically ■...
  • Page 320 EXAMPLE 6 XSCF> Host key already exists. The key will be updated. Continue? [y|n] :y Please reset the XSCF by rebootxscf to apply the ssh settings. EXAMPLE 7 XSCF> EXAMPLE 8 XSCF> Please input a public key: ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAzFh95SohrDgpnN7zFCJCVNy+jaZPTjNDxcid QGbihYDCBttI4151Y0Sv85FJwDpSNHNKoVLMYLjtBmUMPbGgGVB61qskSv/ FeV44hefNCZMiXGItIIpK P0nBK4XJpCFoFbPXNUHDw1rTD9icD5U/wRFGSRRxFI+Ub5oLRxN8+A8=abcd@example.com [Enter]...
  • Page 321 EXAMPLE 10 setssh -c delpubkey -s 1 XSCF> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAzFh95SohrDgpnN7zFCJCVNy+jaZPTjNDxcid QGbihYDCBttI4151Y0Sv85FJwDpSNHNKoVLMYLjtBmUMPbGgGVB61qskSv/ FeV44hefNCZMiXGItIIpK P0nBK4XJpCFoFbPXNUHDw1rTD9icD5U/wRFGSRRxFI+Ub5oLRxN8+A8=abcd@example.com EXAMPLE 11 setssh -c delpubkey -a XSCF> EXAMPLE 12 setssh -m dscp=deny XSCF> Continue? [y|n] : Please reset the XSCF by rebootxscf to apply the ssh settings. EXIT STATUS The following exit values are returned: >0...
  • Page 322 setssh(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 323: 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 324 Sun Management Center server and agent. This value must be the same as the seed used on the server setup. It must be set prior to enabling the agent. When invoked with the operand enable, setsunmc activates the Sun Management Center agent. This means the Sun Management Center agent is started, and the startup daemon is notified to start the agent on subsequent reboots.
  • Page 325: Settelnet

    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 326 EXIT STATUS The following exit values are returned: >0 SEE ALSO rebootxscf(8), showtelnet(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009 Successful completion. An error occurred.
  • Page 327: Settimezone

    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 328 -d dst -f date [/time] SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009 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.
  • Page 329 -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]] {+|–} hh[:mm[:ss]] Greenwich mean time Specifies "–" to set the standard time to the time which is ahead of GMT.
  • Page 330 -p offset -s timezone SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009 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.
  • Page 331 -t date [/time] EXTENDED You cannot specify the years of validity for time zone and Daylight Saving Time. ■ DESCRIPTION In case the Daylight Saving Time is changed each year, you need to set anew by using the settimezone(8) command. When Daylight Saving Time has been set, XSCF is not affected by the time zone.
  • Page 332 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 333 settimezone -c adddst -b JST -o GMT-9 -d JDT -p GMT-10 -f XSCF> M4.1.0/00:00:00 -t M9.1.0/00:00:00 JST-9JDT-10,M4.1.0/00:00:00,M9.1.0/00:00:00 EXAMPLE 5 settimezone -c deldst -b JST -o GMT-9 XSCF> EXIT STATUS The following exit values are returned: >0 SEE ALSO setdate(8), showdate(8), showtimezone(8) the first Sunday of April 0:00(JST) to the first Sunday of September 0:00(JDT).
  • Page 334 settimezone(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 335: Setupfru

    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. After a PSB is added, the following settings can be specified for PSB:...
  • Page 336 OPERANDS The following operands are supported: device location In the M8000/M9000 server, the Quad-XSB configuration cannot be set in EXTENDED ■ DESCRIPTION memory mirror mode. To set up an already mounted PSB again, all XSBs comprising the target PSB ■...
  • Page 337: Setupplatform

    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 338 In network setup, the following items can be optionally configured: XSCF Network Settings ■ Internal DSCP Network ■ ■ ■ ■ HTTPS Server ■ Email reports ■ EXAMPLES EXAMPLE 1 XSCF> Do you want to set up an account? [y|n]:...
  • Page 339 xscf#0-lan#0 ip address: 192.168.1.4 xscf#0-lan#0 netmask: 255.255.254.0 xscf#0-lan#0 default gateway: 192.168.1.1 Are these settings correct? [y|n]: XSCF> setnetwork xscf#0-lan#0 -m 255.255.254.0 192.168.1.4 . . . Enabling ssh. EXAMPLE 3 setupplatform -p network XSCF> Do you want to set up the XSCF network interfaces? [y|n]: Do you want to set up the DSCP network? [y|n]: Do you want to set up the domain name service? [y|n]: Do you want to set up the network time protocol? [y|n]:...
  • Page 340 are switched on again. Do you want to reboot the XSCF now? [y|n]: XSCF> EXAMPLE 5 XSCF> Do you want to set up the XSCF time zone? [y|n]: Chassis time zone is already configured: Continue setting up the XSCF time zone? [y|n]: SPARC Enterprise Mx000 Servers XSCF Reference Manual •...
  • Page 341 Enter number to choose time zone or return for next set of time zones: XSCF time zone: Africa/Freetown Is this setting correct? [y|n]: XSCF> settimezone -c settz -s Africa/Freetown Africa/Freetown XSCF> EXIT STATUS The following exit values are returned: >0 SEE ALSO adduser(8), applynetwork(8), password(8), setaltitude(8), setdscp(8), setemailreport(8), sethostname(8), sethttps(8), setnameserver(8),...
  • Page 342 setupplatform(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010...
  • Page 343: Showad

    -i and no value, showad walks sequentially through items 1 through 5. Exceptions: When used without -i, the command showad cert displays the certificate information for the Primary server, and showad server displays the Primary server configuration. Specifies verbose output. Used only with the cert operand to display the full certificate.
  • Page 344 Display current group configurations. Display current userdomain settings. Display current DNS locator query configuration. Display current defaultrole setting. Display current Active Directory server settings. Displays the current state of the active directory. showad Displays certificate information for the Primary server. showad cert...
  • Page 345 SEE ALSO setad(8) Displays specified diagnostic messages. Displays configuration for administrator group 3. Displays alternate server 1 setting. A port number of 0 indicates that the de- fault port for Active Directory is used. Displays the dnslocatorquery 1 configuration. Successful completion.
  • Page 346 showad(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009...
  • Page 347: Showaltitude

    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. The displayed altitude value is a multiple of 100 meters.
  • Page 348 showaltitude(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
  • Page 349: Showarchiving

    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 350 Username for ssh login Archive host public key Archive host fingerprint 2. Time of the most recent attempt to connect to the archive host, and the outcome of that attempt (success or failure): Latest communication Connection status 3. Table of the status information for audit logs and non-audit logs: Archive space limit Archive space used The amount of space currently consumed by the archives.
  • Page 351 Archive host fingerprint - Server authentication disabled *** Connection to Archive Host *** Latest communication ----- None Connection status -------- None Archive space limit Archive space used Total archiving failures Unresolved failures EXAMPLE 2 showarchiving -e XSCF> No archiving errors have occurred.
  • Page 352 showarchiving(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised March 2008...
  • Page 353: 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 354 OPTIONS The following options are supported: -a users -c classes -e events SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010 Displays the audit record generation policy for the specified users. users is a comma-separated list of valid user names. Displays the audit record generation policy for the specified audit classes.
  • Page 355 OPERANDS The following operands are supported: EXAMPLES Displaying Auditing Status EXAMPLE 1 showaudit XSCF> Auditing: enabled Displaying All Class Information For Login Auditing EXAMPLE 2 showaudit -c LOGIN XSCF> Events: AEV_LOGIN_BUI AEV_LOGIN_CONSOLE AEV_LOGIN_SSH AEV_LOGIN_TELNET AEV_LOGOUT AEV_AUTHENTICATE Displays the policy to follow when the audit trail reaches full capacity.
  • Page 356 EXAMPLE 3 XSCF> Events: AEV_AUDIT_START AEV_AUDIT_STOP AEV_ENTER_MODE AEV_EXIT_MODE AEV_LOGIN_BUI AEV_LOGIN_CONSOLE AEV_LOGIN_SSH AEV_LOGIN_TELNET AEV_LOGOUT AEV_AUTHENTICATE AEV_addboard AEV_addfru [...] EXIT STATUS The following exit values are returned: >0 SEE ALSO setaudit(8), viewaudit(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010 Displaying All Event Information showaudit -e all Successful completion.
  • Page 357: Showautologout

    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 358 showautologout(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 359: Showboards

    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 360 Assignment Conn SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010 Domain assignment state of the XSB. Either of the following is displayed: The XSB cannot be used. The XSB may be Unavailable unrecognizable because it is not mounted, it contains an error, it has been assigned to another domain, or the settings of the domain or system board are not complete.
  • Page 361 Incorporation state of XSB hardware resources into the Solaris OS Conf Status of an initial diagnosis on an XSB Test Unmount Unknown Testing Passed Failed XSB degradation status Fault Normal Degraded Faulted When the -v option is specified, the following types of information are displayed as XSB detail status information: Dynamic reconfiguration(DR) involving the reservation state of the XSB in the domain...
  • Page 362 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: -c sp...
  • Page 363 00-0 00(00) Assigned 00-1 00(01) Assigned 00-2 SP Available 00-3 02(00) Unavailable y Displays detailed information on all mounted system boards. EXAMPLE 2 showboards -v -a XSCF> R DID(LSB) Assignment ---- - -------- ----------- ---- ---- ---- ------- -------- --- 00-0 00(00) Assigned...
  • Page 364 EXAMPLE 6 XSCF> ---- -------- ----------- ---- ---- ---- ------- -------- 00-2 SP EXIT STATUS The following exit values are returned: >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 July 2010 Displays the system boards that are defined for domain ID 0 and located in the system board pool.
  • Page 365: Showcod

    COD Hardware Activation permits, the number of COD permits reserved for domains, and the Chassis Hostid. The showcod(8) command is not supported on the M3000 server. When used without arguments this command displays the current COD information.
  • Page 366 The output shown is what you would see if you had platform privileges. XSCF> Chassis HostID : 81000001 PROC Permits installed : 8 PROC Headroom Quantity : 0 PROC Permits reserved for domain 0 : 4 PROC Permits reserved for domain 1 : 0 PROC Permits reserved for domain 2 : 0 PROC Permits reserved for domain 3 : 0 PROC Permits reserved for domain 4 : 0...
  • Page 367: Showcodactivation

    COD Hardware Activation database. This command is not available on the M3000 server. When used without options this command displays the current COD keys. Note – For details on COD keys, refer to the SPARC Enterprise M4000/M5000/ M8000/M9000 Servers Capacity on Demand (COD) User’s Guide.
  • Page 368 EXAMPLES EXAMPLE 1 XSCF> Description ----------- PROC 01:84000000:000000001:0301010100:16:00000000:xxxxxxxxxxxxxxxxxxxxxx EXAMPLE 2 XSCF> 01:84000000:104:0301010100:3:00000000:xxxxxxxxxxxxxxx The following exit values are returned: EXIT STATUS >0 SPARC Enterprise M4000/M5000/M8000/M9000 Servers Capacity on Demand (COD) SEE ALSO User’s Guide SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010 Displaying Verbose Permit Data showcodactivation -v Expiration...
  • Page 369: Showcodlicense

    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. You must have platadm or platop privileges to run this command.
  • Page 370 EXAMPLES EXAMPLE 1 XSCF> Description ----------- PROC 01:84000000:000000001:0301010100:16:00000000:xxxxxxxxxxxxxxxxxxxxxx EXAMPLE 2 XSCF> 01:84000000:104:0301010100:3:00000000:xxxxxxxxxxxxxxx The following exit values are returned: EXIT STATUS >0 SPARC Enterprise M4000/M5000/M8000/M9000 Servers Capacity on Demand (COD) SEE ALSO User’s Guide SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010 Displaying Verbose License Data showcodlicense Expiration...
  • Page 371: Showcodusage

    COD Hardware Activation permits in use. The showcodusage(8) command is not available on the M3000 server. By default, this command displays a summary of COD permits used and installed, along with the current state of each resource. When used without options, it displays the current usage.
  • Page 372 EXTENDED The showcodusage -p resource command displays the following COD usage DESCRIPTION information for the system: Resource In Use Installed COD Permitted Status The showcodusage -p domain command displays the following COD usage information for each domain: Domain/Resource Identifies COD resource (processor) for each domain. An In Use SPARC Enterprise Mx000 Servers XSCF Reference Manual •...
  • Page 373 2 - PROC 3 - PROC 4 - PROC Unused - PROC Displaying COD Usage by Resource and Domain: M8000 Server With CMU00 EXAMPLE 3 Specifies the number of COD CPU resources installed in the domain. Specifies the number of COD permits allocated to the domain.
  • Page 374 XSCF> Resource -------- PROC Domain/Resource --------------- - PROC - PROC - PROC - PROC - PROC - PROC - PROC - PROC - PROC - PROC 10 - PROC 11 - PROC 12 - PROC SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010 Quad-XSB, CMU02 Uni-XSB showcodusage -v In Use...
  • Page 375 CPUM01-CPU1 EXIT STATUS The following exit values are returned: >0 SEE ALSO SPARC Enterprise M4000/M5000/M8000/M9000 Servers Capacity on Demand (COD) User’s Guide Displaying COD Usage by Resource and Domain: M5000 Server In Use Installed COD Permitted ------ --------- ------------- In Use...
  • Page 376 showcodusage(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010...
  • Page 377: Showconsolepath

    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 ro/rw escape...
  • Page 378 EXTENDED Only one writable console and one or more read-only consoles can be connected to DESCRIPTION one domain. EXAMPLES EXAMPLE 1 XSCF> User nakagawa hana k-okano yuuki uchida EXIT STATUS The following exit values are returned: >0 SEE ALSO console(8), sendbreak(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual •...
  • Page 379: Showdate

    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 380 showdate(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
  • Page 381: Showdateoffset

    Displays usage statement. When used with other options or operands, an error occurs. On the M3000 server, displays the time differences between the time of the system and the time of the domains with specifying the ID of the domain.
  • Page 382 XSCF> EXAMPLE 3 XSCF> SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009 On the M5000 server, displays the time differences between the time of the system and the time of the domains. showdateoffset Domain Date Offset...
  • Page 383 EXIT STATUS The following exit values are returned: >0 SEE ALSO resetdateoffset(8) 21 sec -621 sec -9999999 sec Successful completion. An error occurred. System Administration...
  • Page 384 showdateoffset(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 385: Showdcl

    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 386 Status SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008 Domain status. One of the following status is displayed. Additional information may be displayed. Powered Off Power is off. Panic State A panic occurred, and the domain is in the reboot state. Shutdown Started The power-off process is starting.
  • Page 387 If the -v option is specified, the following information is added: Cfg-policy No-Mem No-IO Float 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 domain.
  • Page 388 OPTIONS The following options are supported:. -d domain_id -l lsb EXTENDED An XSB for which the floating board priority is set to a low value is difficult to ■ DESCRIPTION use as a floating board. Accordingly, it is difficult for the system board to affect the domain Solaris OS.
  • Page 389 01-0 02-0 03-0 Displays details in the DCL that are set for all domains. EXAMPLE 3 showdcl -v -a XSCF> Status Running 00-0 01-0 02-0 03-0 False True False True True True True True False No-Mem No-IO Float False False False False True...
  • Page 390 --------------------------------------------------------------- --------------------------------------------------------------- EXIT STATUS The following exit values are returned: >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 September 2008 Running (Waiting for OS Shutdown) 01-2 True 04-0 False 05-0...
  • Page 391: Showdevices

    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 392 When memory is being disconnected, the following items are displayed: target XSB deleted mem remaining mem Size of remaining memory to be deleted (MB) I/O devices: device resource usage query Privileges You must have one of the following privileges to run this command: platadm, platop, fieldeng Can run this command for all domains.
  • Page 393 ■ DESCRIPTION Management Facility (SMF) services are active on that domain: Domain SP Communication Protocol (dscp) ■ Domain Configuration Server (dcs) ■ Sun Cryptographic Key Management Daemon (sckmd) ■ The showdevices(8) command displays a complete list of devices when ■...
  • Page 394 XSCF> CPU: ---- DID XSB 00-0 0 00-0 1 00-0 2 00-0 3 00-0 4 00-0 5 00-0 6 00-0 7 Memory: ------- DID XSB 00 00-0 IO Devices: ---------- DID XSB 00-0 00-0 00-0 00-0 00-0 EXAMPLE 2 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009 and their available resources.
  • Page 395 sources in domain ID 0. showdevices -v -d 0 XSCF> CPU: ---- DID XSB state speed 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...
  • Page 396 00-0 00-0 00-0 00-0 00-0 00-0 00-0 EXIT STATUS The following exit values are returned: >0 SEE ALSO addboard(8), deleteboard(8), moveboard(8), setdcl(8), setdscp(8), setupfru(8), showboards(8), showdcl(8), showfru(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009 /dev/dsk/c0t3s0s1 /dev/dsk/c0t3s0s1 /dev/dsk/c0t3d0s3 /var/run...
  • Page 397: Showdomainmode

    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: HOST-ID Diagnostic Level Secure Mode Displays the host ID.
  • Page 398 Autoboot CPU Mode Ethernet Address You must have one of the following privileges to run this command: Privileges platadm, fieldeng domainadm Refer to setprivileges(8) for more information. OPTIONS The following operands are supported: -d domain_id EXTENDED If the Mode switch of the operator panel is set to Service, the settings of the ■...
  • Page 399 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 400 showdomainmode(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2009...
  • Page 401: Showdomainstatus

    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 402 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. -d domain_id EXAMPLES EXAMPLE 1 XSCF> EXIT STATUS The following exit values are returned: >0 SEE ALSO poweroff(8), poweron(8), reset(8), showdcl(8)
  • Page 403: 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 404 OPTIONS The following options are supported: -d domain_id EXAMPLES Caution – The IP addresses shown in the following examples are examples only. EXAMPLE 1 XSCF> DSCP Configuration Network: 10.1.1.0 Netmask: 255.255.255.0 Location ---------- XSCF Domain #00 Domain #01 Domain #02 Domain #03 Domain #04 Domain #05...
  • Page 405 Domain #11 10.1.1.13 Domain #12 10.1.1.14 Domain #13 10.1.1.15 Domain #14 10.1.1.16 Domain #15 10.1.1.17 Domain #16 10.1.1.18 Domain #17 10.1.1.19 Domain #18 10.1.1.20 Domain #19 10.1.1.21 Domain #20 10.1.1.22 Domain #21 10.1.1.23 Domain #22 10.1.1.24 Domain #23 10.1.1.25 Displaying a Specific Domain’s IP Address EXAMPLE 2 showdscp -d 1 XSCF>...
  • Page 406 Domain[6] Domain[7] Domain[8] Domain[9] The following exit values are returned: EXIT STATUS >0 SEE ALSO setdscp(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2008 10.1.1.8 10.1.1.9 10.1.1.10 10.1.1.11 Successful completion. An error occurred.
  • Page 407: Showdualpowerfeed

    M8000/M9000 servers, it automatically configures the dual power feed mode. For details about the setting the dual power feed, see the Installation Guide for your server. The dual power feed mode can be set by the setdualpowerfeed(8) command.
  • Page 408 showdualpowerfeed(8) SEE ALSO setdualpowerfeed(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009...
  • Page 409: Showemailreport

    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 410 showemailreport(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised June 2007...
  • Page 411: Showenvironment

    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.
  • Page 412 Displays the intake temperature and humidity of the system on the M8000/ M9000 servers. showenvironment Displays temperature information about the system and each component on the M8000 server. showenvironment temp Displays temperature information. Displays voltage information. Displays fan speed information.
  • Page 413 CMU#2:30.71C CPUM#0-CHIP#0:30.71C CPUM#1-CHIP#0:30.71C CPUM#2-CHIP#0:30.71C CPUM#3-CHIP#0:30.71C CMU#3:30.71C CPUM#0-CHIP#0:30.71C CPUM#1-CHIP#0:30.71C CPUM#2-CHIP#0:30.71C CPUM#3-CHIP#0:30.71C Displays voltage information about each component on the M4000 server. EXAMPLE 3 showenvironment volt XSCF> MBU_A 1.0V Power Supply Group:1.010V 1.8V Power Supply Group:1.700V CPUM#0-CHIP#0 1.0V Power Supply Group:1.000V CPUM#1-CHIP#0 1.0V Power Supply Group:1.000V...
  • Page 414 -12V Power Supply Group:-12.030V EXAMPLE 4 XSCF> FAN_A#0:Low speed FAN_A#1:Low speed FAN_A#2:Low speed SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009 Displays the fan speed information on the M5000 server. showenvironment Fan FAN_A#0: 4101rpm FAN_A#1: 4101rpm...
  • Page 415 Fan XSCF> FAN_A#0:Low speed (level-4) FAN_A#0: 4134rpm FAN_A#1:Low speed (level-4) FAN_A#1: 4212rpm 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 AC EXAMPLE 6 System Administration...
  • Page 416 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009 power supply). showenvironment power Displays power consumption information on the M3000 server (in case of DC power supply). showenvironment power Displays the volume of air exhausted from the M3000 server.
  • Page 417: Showfru

    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 418 OPERANDS The following operands are supported: device location EXTENDED The setupfru(8) command makes hardware settings for a device. DESCRIPTION EXAMPLES EXAMPLE 1 XSCF> Device EXIT STATUS The following exit values are returned: >0 SEE ALSO addboard(8), deleteboard(8), moveboard(8), setdcl(8), setupfru(8), showboards(8), showdcl(8), showdevices(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual •...
  • Page 419: Showhardconf

    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 420 It is operating normally. Description 1 GB, rank 1 2 GB, rank 1 2 GB, rank 2 Displays the information of the FRUs in the M5000 server. showhardconf + FRU-Part-Number:CF00541-0478 05 + Memory_Size:64 GB; /541-0478-05...
  • Page 421 CPUM#0-CHIP#0 Status:Normal; Ver:0501h; Serial:PP0723016Q + FRU-Part-Number:CA06761-D204 A0 + Freq:2.530 GHz; Type:32; + Core:4; Strand:2; CPUM#3-CHIP#1 Status:Normal; Ver:0501h; Serial:PP074804E9 + FRU-Part-Number:CA06761-D204 A0 + Freq:2.530 GHz; Type:32; + Core:4; Strand:2; MEMB#0 Status:Normal; Ver:0101h; Serial:BF09061G0E + FRU-Part-Number:CF00541-0545 06 MEM#0A Status:Normal; + Code:c1000000000000005372T128000HR3.7A + Type:1A; Size:1 GB; MEM#3B Status:Normal;...
  • Page 422 + 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 FAN_A#0 Status:Normal; FAN_A#1 Status:Normal; FAN_A#2 Status:Normal; FAN_A#3 Status:Normal; Displays the number of installed FRUs in the M5000 server. showhardconf -u /541-2240-02 /541-2803-01 /541-0481-04 /541-0850-06 /541-3099-01...
  • Page 423 | IOBOX | XSCFU | OPNL | PSU | FANBP_C FAN_A +-----------------------------------+------------+ Displays the information of the FRUs in the M9000 server. EXAMPLE 3 showhardconf XSCF> 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;...
  • Page 424 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010 + FRU-Part-Number:CA06629-D001 A4 + Memory_Size:128 GB; + Type:A CPUM#0-CHIP#0 Status:Normal; Ver:0101h; Serial:PP091505ZY + FRU-Part-Number:CA06620-D021 A3 + Freq:2.280 GHz; Type:16; + Core:2; Strand:2; CPUM#1-CHIP#0 Status:Normal; Ver:0101h; Serial:PP091505ZW + FRU-Part-Number:CA06620-D021 A3 + Freq:2.280 GHz;...
  • Page 425 CMU#2 Status:Normal; Ver:4201h; Serial:PP0618K472 + FRU-Part-Number:CA06620-D003 A0 + Memory_Size:32 GB; + Type:B CPUM#0-CHIP#0 Status:Normal; Ver:0901h; Serial:PP0608J517 + FRU-Part-Number:CA06620-D051 A0 + Freq:2.880 GHz; Type:32; + Core:4; Strand:2; CPUM#1-CHIP#0 Status:Normal; Ver:0901h; Serial:PP0620P552 + FRU-Part-Number:CA06620-D051 A0 + Freq:2.880 GHz; Type:32; + Core:4; Strand:2; CPUM#2-CHIP#0 Status:Normal;...
  • Page 426 IOU#0 Status:Normal; Ver:0101h; Serial:PP072102UN IOU#1 Status:Normal; Ver:0101h; Serial:PP072102UM XSCFU_B#0 Status:Normal,Active; Ver:0201h; Serial:PP080600DW XBU_B#0 Status:Normal; Ver:0201h; Serial:PP0641X324 CLKU_B#0 Status:Normal; Ver:0101h; Serial:PP0542M679 OPNL#0 Status:Normal; Ver:0101h; Serial:PP06058246 PSU#0 Status:Normal; Serial:; FANBP_A#0 Status:Normal; Ver:0101h; Serial:PP0607D266 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010 + FRU-Part-Number:CA06620-D102 B1 PCI#0 Name_Property:pci;...
  • Page 427 FAN_A#9 Status:Normal; Serial:PA0605B300; + FRU-Part-Number:CA06501-D023 A2 SWBP#0 Status:Normal; Ver:0101h; Serial:PP0607E759 + FRU-Part-Number:CA20394-B16X 001AA MEDBP#0 Status:Normal; Ver:0101h; Serial:PP06058497 + FRU-Part-Number:CA20394-B17X 002AB Displays the number of installed FRUs in the M9000 server. EXAMPLE 4 showhardconf -u XSCF> SPARC Enterprise M9000; Memory_Size:240 GB +-----------------------------------+------------+...
  • Page 428 MBU_A Status:Normal; Ver:0101h; Serial:7867000269 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010 Type:4B; Size:4 GB; FAN_A Displays the information of the FRUs in the M3000 server (in case of AC pow- er supply). showhardconf + FRU-Part-Number:CF00541-0493 0040 /541-0493-00-40 + CPU Status:Normal;...
  • Page 429 + Power_Status:Off; + Type:AC; FANBP_B Status:Normal; Ver:0101h; Serial:7867000053 + FRU-Part-Number:CA06629-D051 001AA FAN_A#0 Status:Normal; FAN_A#1 Status:Normal; Displays the information of the FRUs in the M3000 server (in case of DC pow- EXAMPLE 6 er supply). showhardconf XSCF> SPARC Enterprise M3000; + Serial:BE80601016; Operator_Panel_Switch:Service;...
  • Page 430 OPNL Status:Normal; Ver:0101h; Serial:7867000076 PSU#0 Status:Normal; Serial:EA09320015 ; PSU#1 Status:Normal; Serial:EA09320016 ; FANBP_B Status:Normal; Ver:0101h; Serial:7867000053 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010 + CPU Status:Normal; + Freq:2.750 GHz; Type:32; + Core:4; Strand:2; + Memory_Size:8 GB; MEM#0A Status:Normal;...
  • Page 431 EXAMPLE 7 showhardconf -u XSCF> SPARC Enterprise M3000; Memory_Size:8 GB; +-----------------------------------+------------+ +-----------------------------------+------------+ | MBU_A | OPNL | PSU | FANBP_B FAN_A +-----------------------------------+------------+ EXIT STATUS The following exit values are returned: >0 Displays the number of installed FRUs in the M3000 server.
  • Page 432 showhardconf(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010...
  • Page 433: Showhostname

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

    Server key: installed in Apr 24 12:34:56 JST 2006 CA key: installed in Apr 24 12:00:34 JST 200 Indicates whether the HTTPS service is operating Indicates whether the private key of the web server has been installed Indicates whether the private key of the certification authority...
  • Page 436 CA cert: installed in Apr 24 12:00:34 JST 200 CSR: -----BEGIN CERTIFICATE REQUEST----- MIIBwjCCASsCAQAwgYExCzAJBgNVBAYTAmpqMQ4wDAYDVQQIEwVzdGF0ZTERMA8G A1UEBxMIbG9jYWxpdHkxFTATBgNVBAoTDG9yZ2FuaXphdGlvbjEPMA0GA1UECxMG b3JnYW5pMQ8wDQYDVQQDEwZjb21tb24xFjAUBgkqhkiG9w0BCQEWB2VlLm1haWww gZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAJ5D57X/k42LcipTWBWzv2GrxaVM 5GEyx3bdBW8/7WZhnd3uiZ9+ANlvRAuw/YYy7I/pAD+NQJesBcBjuyj9x+IiJl9F MrI5fR8pOIywVOdbMPCar09rrU45bVeZhTyi+uQOdWLoX/Dhq0fm2BpYuh9WukT5 pTEg+2dABg8UdHmNAgMBAAGgADANBgkqhkiG9w0BAQQFAAOBgQAux1jH3dyB6Xho PgBuVIakDzIKEPipK9qQfC57YI43uRBGRubu0AHEcLVue5yTu6G5SxHTCq07tV5g 38UHSg5Kqy9QuWHWMri/hxm0kQ4gBpApjNb6F/B+ngBE3j/thGbEuvJb+0wbycvu 5jrhB/ZV9k8X/MbDOxSx/U5nF+Zuyw== -----END CERTIFICATE REQUEST----- EXIT STATUS The following exit values are returned: >0 SEE ALSO sethttps(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009 Successful completion.
  • Page 437: Showldap

    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. You must have useradm or fieldeng privileges to run this command. Privileges Refer to setprivileges(8) for more information.
  • Page 438 showldap(8) SEE ALSO setldap(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised June 2007...
  • Page 439: Showldapssl

    1 through 5. Exceptions: When used without -i, the command showldapssl cert displays the certificate information for the Primary server, and showldapssl server displays the Primary server configuration. Specifies verbose output. Used only with the cert operand to display the full certificate.
  • Page 440 Display current group configurations. Display current group configurations. Display current userdomain settings. Display current user mapping settings. Display current defaultrole setting. Display current LDAP/SSL server settings. Displays the current state of LDAP/SSL. showldapssl Displays certificate information for the Primary server. showldapssl cert...
  • Page 441 SEE ALSO setldapssl(8) Displays specified diagnostic messages. Displays configuration for administrator group 3. Displays alternate server 1 setting. A port number of 0 indicates that the de- fault port for LDAP/SSL is used. Displays the optional user mapping settings. Successful completion.
  • Page 442 showldapssl(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010...
  • Page 443: Showlocale

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

    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: Blinking You must have one of the following privileges to run this command: Privileges...
  • Page 446 showlocator(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 447: Showloginlockout

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

    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 450 OPTIONS The following options are supported: -d domain_id -p timestamp SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010 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.
  • Page 451 -t time Specifies the start date and time of the display range for log data. It is specified in one of the following formats: yyyy-mm-dd,hh:mm The timestamp is specified in the ’year-month-day, hour:minute’ format. mm/dd/yy,hh:mm The timestamp is specified in the ’month/day/year, hour:minute’ format.
  • Page 452 -T time SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010 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.
  • Page 453 OPERANDS The following operands are supported: error power event monitor console panic EXTENDED Logs are displayed in the following formats: DESCRIPTION Error log ■ Default Date: Mar 30 17:45:31 JST 2005 xxxxxxxxxxxxxxxx Status: Alarm FRU: PSU#1,PSU#2,* Msg: ACFAIL occurred (ACS=3)(FEP type = A1) Case where the -v option is specified Date: Mar 30 17:45:31 JST 2005 Status: Alarm...
  • Page 454 Case where the -V option is specified Date: Mar 30 17:45:31 JST 2005 Status: Alarm FRU: PSU#1,PSU#2,* Msg: ACFAIL occurred (ACS=3)(FEP type = A1) Diagnostic Code: xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx UUID: bf36f0ea-9e47-42b5-fc6f-c0d979c4c8f4 MSG-ID:FMD-8000-11 Diagnostic Messages: Case where the -S option is specified Date: Mar 30 17:45:31 JST 2005...
  • Page 455 Log collection date and time (month day hour:minute:second Date: time-zone year) The displayed time is the local time. Error code Code: Data is displayed in 16-byte format. Date (Month Day Hour: Minute: Second TimeZone Year) when an Occurred: error occurred. This date is displayed as the local time.
  • Page 456 MSG-ID: Diagnostic Messages: Detail log: Power log ■ Date Mar 30 17:25:31 JST 2005 Mar 30 17:35:31 JST 2005 Mar 30 17:45:31 JST 2005 Mar 30 17:50:31 JST 2005 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010 Unique message ID Detailed message If the log has a detailed message, it is displayed.
  • Page 457 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: Domain Power On Domain Power Off System Power On System Power Off SCF Reset Domain Reset Factor that caused this Status...
  • Page 458 Mar 30 17:55:31 JST 2005 Case where the -v option is specified Date Mar 30 17:45:31 JST 2005 Switch= Service Code=xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx Date: Message: Switch: Code: TEMPERATURE AND HUMIDITY RECORD ■ Date Mar 30 17:45:31 JST 2005 Mar 30 17:55:31 JST 2005 SPARC Enterprise Mx000 Servers XSCF Reference Manual •...
  • Page 459 Log collection date and time (month day hour:minute:second Date: time-zone year) The displayed time is the local time. Intake air temperature Temperature: Decimal numbers are displayed to two decimal places. The unit is degree Celsius (×C). Humidity Humidity: The displayed numbers are percentages (%). Humidity is displayed on the M8000/M9000 servers only.
  • Page 460 [Second and subsequent lines] Each line of display has a date and time paired with a console message. The time in the displayed log collection date and time (month day hour:minute:second time-zone year) is the local time. Panic message log ■...
  • Page 461 EXAMPLE 1 showlogs error XSCF> Date: Mar 30 12:45:31 JST 2005 Status: Alarm FRU: IOU#0/PCI#3 Msg: offline(vendor=FUJITSU, product=MAJ3182MC) Date: Mar 30 15:45:31 JST 2005 Status: Warning FRU: PSU#1,PSU#2 Msg: ACFAIL occurred (ACS=3)(FEP type = A1) Date: Mar 30 17:45:31 JST 2005...
  • Page 462 00112233 44556677 8899aabb ccddeeff UUID: bf36f0ea-9e47-42b5-fc6f-c0d979c4c8f4 MSG-ID: FMD-8000-11 EXAMPLE 3 XSCF> Date: Mar 30 12:45:31 JST 2005 Status: Alarm FRU: IOU#0/PCI#3 Msg: offline(vendor=FUJITSU, product=MAJ3182MC) Diagnostic Code: 00112233 44556677 8899aabb 00112233 44556677 8899aabb ccddeeff 00112233 44556677 8899aabb ccddeeff UUID: bf36f0ea-9e47-42b5-fc6f-c0d979c4c8f4 MSG-ID: FMD-8000-11 Diagnostic Messages Jul 11 16:17:42 plato10 root: [ID 702911 user.error] WARNING: /...
  • Page 463 timestamp. showlogs power -r XSCF> Date Mar 30 17:50:31 JST 2005 Mar 30 17:45:31 JST 2005 Mar 30 17:35:31 JST 2005 Mar 30 17:25:31 JST 2005 Displays the specified range of a power log. EXAMPLE 6 showlogs power -t Mar3017:302005 -T Mar3017:492005 XSCF>...
  • Page 464 Mar 30 17:45:31 JST 2005 Mar 30 17:55:31 JST 2005 disk@0,0:a Mar 30 17:55:32 JST 2005 Note: The codes or messages shown here may differ from those actually displayed. The following exit values are returned: EXIT STATUS >0 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010 Executing last command: boot Boot device: /pci@83,4000/FJSV,ulsa@2,1/ File and args:...
  • Page 465: Showlookup

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

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

    DNS search paths have been set: example1.com example2.com example3.com example4.com example5.com Displays the DNS servers and the DNS search paths XSCF network. The following example shows that no DNS server currently set for the currently set for the and the System Administration...
  • Page 470 XSCF> nameserver --- search EXIT STATUS The following exit values are returned: >0 SEE ALSO setnameserver(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009 DNS search path are set: shownameserver Successful completion. An error occurred.
  • Page 471: Shownetwork

    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 472 OPERANDS The following operands are supported: interface EXTENDED In the M8000/M9000 servers, a takeover IP address can be used without a need ■ DESCRIPTION to 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 473 TX packets:14369 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:20241827 (19.3 MiB) Base address:0x1000 Displays the information for XSCF-LAN#1 on XSCF unit 0 in the M3000/ EXAMPLE 2 M4000/M5000 server. shownetwork lan#1 XSCF> xscf#0-lan#1 Link encap:Ethernet inet addr:192.168.10.11 UP BROADCAST RUNNING MULTICAST...
  • Page 474 inet addr:192.168.10.128 Bcast: 192.168.10.255 UP BROADCAST RUNNING MULTICAST RX packets:54424 errors:0 dropped:0 overruns:0 frame:0 TX packets:14369 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:(0.0 B) Base address:0x1000 EXAMPLE 4 XSCF> xscf#0-lan#0 Link encap:Ethernet inet addr:192.168.11.10 UP BROADCAST RUNNING MULTICAST 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)
  • Page 475 Displays the information for XSCF unit 0 and XSCF unit 1 in the M8000/ EXAMPLE 7 M9000 servers. shownetwork -a XSCF> xscf#0-lan#0 Link encap:Ethernet HWaddr 00:00:00:12:34:56 inet addr: 192.168.11.10 UP BROADCAST RUNNING MULTICAST RX packets:54424 errors:0 dropped:0 overruns:0 frame:0 TX packets:14369 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:12241827 (11.3 MiB) Base address:0x1000...
  • Page 476 HWaddr 00:00:00:12:34:59 inet addr:192.168.10.12 xscf#1-lan#1 HWaddr 00:00:00:12:34:60 xscf#1-if HWaddr 00:00:00:12:34:61 XSCF> EXIT STATUS The following exit values are returned: >0 SEE ALSO setnetwork(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010 Mask:255.255.255.0 Successful completion. An error occurred.
  • Page 477: Shownotice

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

    Displays all the NTP servers currently set for the XSCF network. Displays usage statement. When used with other options or operands, an error occurs. Displays whether synchronization with an NTP server is being maintained. Displays whether a preferred server has been designated (prefer), and displays the clock address of the local clock (localaddr).
  • Page 480 OPERANDS The following operand is supported: address When the preferred server not designated, the NTP server in the output of the EXTENDED ■ DESCRIPTION showntp(8) command does not come with the prefer information. The setntp(8) command sets the NTP servers used in the XSCF network.
  • Page 481 EXIT STATUS >0 SEE ALSO setntp(8) Displays the stratum value which has been set to XSCF. Displays whether a preferred server has been designated, and displays the clock address of the local clock. Successful completion. An error occurred. System Administration...
  • Page 482 showntp(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised November 2009...
  • Page 483: Showpacketfilters

    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 484 XSCF> pkts bytes target pkts bytes target XSCF> EXIT STATUS The following exit values are returned: >0 SEE ALSO setpacketfilters(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010 ing rules in the XSCF network. showpacketfilters -l prot in 0 DROP xscf#0-lan#0...
  • Page 485: Showpasswordpolicy

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

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

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

    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 492 OPERANDS The following operand is supported: interface EXTENDED The setroute(8) command sets routing information for the XSCF network. DESCRIPTION SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010 Displays usage statement. When used with other options or operands, an error occurs.
  • Page 493 Displays routing information for XSCF-LAN#0 on XSCF unit 0 without the name resolution of host name. Gateway Netmask 0.0.0.0 255.255.255.0 192.168.10.1 0.0.0.0 Displays all routing information for XSCF unit 0 and XSCF unit 1 in the M8000/M9000 server. Gateway Netmask 255.255.255.0 192.168.10.1 0.0.0.0 Gateway Netmask 255.255.255.0 192.168.10.1...
  • Page 494 showroute(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised February 2010...
  • Page 495: Showshutdowndelay

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

    You must have platadm or platop privileges to run this command. Privileges Refer to setprivileges(8) for more information. OPTIONS The following options are supported: EXTENDED SMTP information includes the Mail Server and Reply addresses. DESCRIPTION EXAMPLES EXAMPLE 1 XSCF> Mail Server: 10.4.1.1...
  • Page 498 showsmtp(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
  • Page 499: Showsnmp

    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 500 System Location: System Contact: System Description: FF1 Trap Hosts: Hostname -------- host1 SNMP V1/V2c: None Enabled MIB Modules: None EXAMPLE 3 XSCF> Agent Status: Agent Port: System Location: System Contact: System Description: FF1 Trap Hosts: Hostname -------- host1 host2 host3 SNMP V1/V2c: Status: SPARC Enterprise Mx000 Servers XSCF Reference Manual •...
  • Page 501 Community String: public Enabled MIB Modules: SP_MIB FM_MIB The following exit values are returned: EXIT STATUS >0 SEE ALSO setsnmp(8) Successful completion. An error occurred. System Administration...
  • Page 502 showsnmp(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 503: Showsnmpusm

    NAME showsnmpusm - display the current User-based Security Model (USM) information for the SNMP agent SYNOPSIS showsnmpusm showsnmpusm -h DESCRIPTION showsnmpusm(8) displays the current USM information for the SNMP agent. Privileges You must have platadm or platop privileges to run this command. Refer to setprivileges(8) for more information.
  • Page 504 showsnmpusm(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 505: Showsnmpvacm

    NAME showsnmpvacm - display the current View-based Access Control Access (VACM) information for the SNMP agent SYNOPSIS showsnmpvacm showsnmpvacm -h DESCRIPTION showsnmpvacm(8) displays the current VACM information for the SNMP agent. Privileges You must have platadm or platop privileges to run this command. Refer to setprivileges(8) for more information.
  • Page 506 showsnmpvacm(8) SEE ALSO setsnmpvacm(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...
  • Page 507: Showssh

    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 508 -u user_name EXTENDED You can specify the automatically-numbered user public key number to delete ■ DESCRIPTION the user public key by setssh(8) command. The setssh(8) command makes settings for the SSH service in the XSCF ■ network. EXAMPLES EXAMPLE 1 XSCF>...
  • Page 509 VN3009kmVwAAAIAON1LR/ 9Jdd7yyG18+Ue7eBBJHrCA0pkSzvfzzFFj5XUzQBdabh5p5Rwz+1vriawFI ZI9j2uhM/3HQdrvYSVBEdMjaasF9hB6T/ uFwP8yqtJf6Y9GdjBAhWuH8F13pX4BtvK9IeldqCscnOuu0 e2rlUoI6GICMr64FL0YYBSwfbwLIz6PSA/yKQe23dwfkSfcwQZNq/ 5pThGPi3tob5Qev2KCK2OyEDMCA OvVlMhqHuPNpX+hE19nPdBFGzQ== Fingerprint: 1024 9e:39:8e:cb:8a:99:ff:b4:45:12:04:2d:39:d3:28:15 /etc/ssh/ ssh_host_dsa_key.pub EXAMPLE 2 showssh -c pubkey XSCF> Public key: ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAzFh95SohrDgpnN7zFCJCVNy+jaZPTjNDxcid QGbihYDCBttI4151Y0Sv85FJwDpSNHNKoVLMYLjtBmUMPbGgGVB61qskSv/ FeV44hefNCZMiXGItIIpK P0nBK4XJpCFoFbPXNUHDw1rTD9icD5U/wRFGSRRxFI+Ub5oLRxN8+A8=abcd@example.com ssh-rsa CSqGSIb3DQEJARYHZWUubWFpbDCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEA nkPntf+TjYtyKlNYFbO/YavFpUzkYTLHdt0Fbz/ tZmGd3e6Jn34A2W9EC7D9hjLsj+kAP41Al6wFwGO7 KP3H4iImX0Uysjl9Hyk4jLBU51sw8JqvT2utTjltV5mFPKL6bDcAgY9=efgh@example.com EXIT STATUS The following exit values are returned: >0 SEE ALSO setssh(8) Displays the user public key of the current login user account.
  • Page 510 showssh(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 511: Showstatus

    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 512 XSCF> CMU#0; EXAMPLE 2 XSCF> MBU_B; MEMB#0; EXAMPLE 3 XSCF> MBU_B Status:Normal; EXAMPLE 4 XSCF> MBU_B Status:Normal; XBU_B#0 Status:Degraded; The following exit values are returned: EXIT STATUS >0 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008 module in a CPU memory unit are degraded because of an error.
  • Page 513: Showsunmc

    OPERANDS There are no operands for this command. EXAMPLES EXAMPLE 1 showsunmc XSCF> Agent Status: Setup Status: SunMC Server: Security Seed: SNMPv1 Community String: Agent Port: Host Trap Port: Host Event Port: SNMP Agent Port: Domain Agent Ports: Displays only the agent status. The value 1 indicates the agent is enabled, 0 indicates the agent is disabled.
  • Page 514 EXAMPLE 2 XSCF> Agent Status: Setup Status: SunMC Server: Security Seed: SNMPv1 Community String: Agent Port: Host Trap Port: Host Event Port: SNMP Agent Port: Domain Agent Ports: EXAMPLE 3 XSCF> EXIT STATUS The following exit values are returned: SEE ALSO setsunmc(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual •...
  • Page 515: Showtelnet

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

    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 518 offset offset2 from-date[/time] SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009 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 519 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 520 The settimezone(8) command sets the time zone of the XSCF. ■ EXAMPLES EXAMPLE 1 XSCF> Asia/Tokyo EXAMPLE 2 XSCF> JST-9JDT,M3.5.0,M10.5.0 EXAMPLE 3 XSCF> JST-9JDT-10,M4.1.0/00:00:00,M9.1.0/00:00:00 EXAMPLE 4 XSCF> From: Sun Mar EXIT STATUS The following exit values are returned: >0 SEE ALSO setdate(8), settimezone(8), showdate(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual •...
  • Page 521: Showuser

    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 522 EXAMPLES EXAMPLE 1 XSCF> User Name: Status: Minimum: Maximum: Warning: Inactive: Last Change: Password Expires: Password Inactive: Never Account Expires: EXAMPLE 2 XSCF> User Name: Privileges: EXIT STATUS The following exit values are returned: >0 SEE ALSO adduser(8), deleteuser(8), disableuser(8), enableuser(8), password(8), setprivileges(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual •...
  • Page 523: 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 524 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 525 -t argument. snapshot displays the key’s md5 fingerprint and prompts for confirmation. If you accept the key, it is used for server authentication. If you reject the key, snapshot exits without doing anything. This is the default behavior in SSH Target Mode if -k is not specified.
  • Page 526 -P password -p password -S time user@host:directory SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008 Used with the -e option, sets the encryption password used for encrypting the output file. Specifies the user password used to log in to the host using SSH.
  • Page 527 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 528 Setting up ssh connection to remote host... Collecting data into joe@jupiter.west:/home/joe/logs/x/archive.zip Data collection complete. EXAMPLE 3 XSCF> AAAAB3NzaC1yc2EAAAABIwAAAIEAwVFiSQNVBFhTTzq0AX5iQqCkkJjd6ezWkVGt mMkJJzzMjYK0sBlhn6dGEIiHdBSzO8QLAXb8N4Kq8JDOBpLSN4yokUPTcZQNxJaY A0W058Qgxbn” 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.
  • Page 529 Downloading Using No Key to Invalid Directory EXAMPLE 6 snapshot -t sue@saturn.north:/home/sue/logs/bad_dir -k none XSCF> Enter ssh password for user ’sue’ on host ’saturn.north’ Setting up ssh connection to remote host... Failed to create remote file: /home/sue/logs/bad_dir/archive.zip Verify adequate disk permissions and disk space on target host Error opening SSH target Exiting with error 1 Downloading Public Key With Connectivity Failure...
  • Page 530 EXAMPLE 9 XSCF> Downloading Public Key from ’fakehost.com’... Error downoading key for host ’fakehost.com’ Error opening SSH target Exiting with error 1 EXAMPLE 10 XSCF> Testing writability of USB device...SUCCESS About to remove all files from device ‘usb0’. Continue? [y|n] : Collecting data into /media/usb_msd/jupiter_10.1.1.1_2006-04-17T22-41- 51.zip Data collection complete.
  • Page 531: Switchscf

    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 532 -t Active -t Standby 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. EXAMPLES EXAMPLE 1 XSCF>...
  • Page 533: Testsb

    DESCRIPTION testsb(8) command performs an initial diagnosis of the specified PSB. The testsb(8) command is not available on the M3000 server. The configuration of the PSB and operation of each device mounted on the PSB are checked. After the diagnostics, the result is displayed. The PSB must not be configured in the domain, or the domain in which the PSB configured must be powered off.
  • Page 534 OPTIONS The following options are supported:. -c {all|expansion} Specifies the target PSB to be diagnosed. One of the values -m diag=mode OPERANDS The following operand is supported: location EXTENDED When the command is executed, a prompt to confirm execution of the command ■...
  • Page 535 XSB is installed in the domain and this domain is in OpenBoot PROM (ok> ■ prompt) status. XSB is installed in the domain and this domain is power ON status, power ■ OFF status, or reboot status. The addboard(8), deleteboard(8), or moveboard(8) command is executed ■...
  • Page 536 EXAMPLES EXAMPLE 1 XSCF> Initial diagnosis is about to start, Continue?[y|n] : SB#00 power on sequence started. 0end Initial diagnosis started. [1800sec] 0... 30... 60... 90...120end Initial diagnosis has completed. SB power off sequence started. [1200sec] 0.end SB powered off. ---- ------- -------- 00-0 Passed 00-1 Passed...
  • Page 537 Performs the initial diagnosis on all the PSB that are mounted. EXAMPLE 3 testsb -c all XSCF> Initial diagnosis is about to start. Continue? [y|n] : SB power on sequence started. 0end Initial diagnosis started. [1800sec] 0... 30... 60... 90...120end Initial diagnosis has completed.
  • Page 538 00-0 Passed 01-0 Passed 02-0 Passed 03-0 Passed EXIT STATUS The following exit values are returned: >0 SEE ALSO addfru(8), deletefru(8), replacefru(8), setupfru(8), showboards(8), showfru(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008 Normal Normal Normal Normal Successful completion.
  • Page 539: Traceroute

    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 540 Displays the route packets take to the host named server.example.com. traceroute server.example.com 1.792 ms 2.235 ms 2.199 ms 2.516 ms 2.546 ms Displays the detailed route packets take to the host named server.exam- ple.com. (XSCF-LAN=192.168.100.10) traceroute -v server.example.com 1.673 ms 1.549 ms 2.249 ms 2.367 ms 2.228 ms...
  • Page 541 XX.XX.XX.4 36 bytes to 192.168.100.10 XX.XX.XX.5 36 bytes to 192.168.100.10 6 server.example.com 48 bytes to 192.168.100.10 2.172 ms 2.313 ms 2.36 ms EXIT STATUS The following exit values are returned: >0 Successful completion. An error occurred. 2.516 ms 2.229 ms 2.357 ms...
  • Page 542 traceroute(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009...
  • Page 543: Unlockmaintenance

    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 544 EXAMPLE 2 XSCF> This command unlocks the maintenance lock which prevents the multiple execution of maintenance commands. *Never* use this command, except when the lock state remains by some reason. Careless execution of this command causes serious situation because it interrupts the running command and XSCF might not be able to recognize the parts.
  • Page 545: Version

    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: xscf You must have platadm or fieldeng privileges to run this command. Privileges Refer to setprivileges(8) for more information.
  • Page 546 XSCF#1 (Standby) XCP0 (Current): 1090 XCP1 (Reserve): 1090 EXAMPLE 2 XSCF> XSCF#0 (Active) XCP0 (Current): 1082 OpenBoot PROM : 02.09.0000 XSCF XCP1 (Reserve): 1082 OpenBoot PROM : 02.09.0000 XSCF XSCF#1 (Standby) XCP0 (Current): 1082 OpenBoot PROM : 02.09.000 XSCF XCP1 (Reserve): 1082 OpenBoot PROM : 02.09.0000 XSCF OpenBoot PROM BACKUP...
  • Page 547 Displays the version of OpenBoot PROM firmware. EXAMPLE 5 version -c cmu XSCF> DomainID 0: 02.09.0000 DomainID 1: 02.09.0000 DomainID 2: 02.09.0000 DomainID 3: 02.09.0000 DomainID 23: 02.09.0000 Displays the detailed version of OpenBoot PROM firmware. EXAMPLE 6 version -c cmu -v XSCF>...
  • Page 548 EXIT STATUS The following exit values are returned: >0 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009 Successful completion. An error occurred.
  • Page 549: Viewaudit

    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...
  • Page 550 -B date-time SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008 Selects records that occurred before date-time. The date-time argument is in local time. the -A and -B options can be used together to form a range. Valid values for date-time are either absolute or offset: Absolute date-time : yyyymmdd[hh[mm[ss]]] where:...
  • Page 551 -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 552 -e events -i audit-ids -m del -p privilege-results -r return-values -S start-record SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008 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.
  • Page 553 -u users EXAMPLES Displaying Audit Records for December 12, 2005 EXAMPLE 1 viewaudit -D 20051212 XSCF> file,1,2006-01-11 10:52:30.391 -05:00,20060111155230.0000000000.jupiter Displaying User Audit Records EXAMPLE 2 viewaudit -u jsmith XSCF> file,1,2006-01-11 10:52:30.391 -05:00,20060111155230.0000000000.jupiter header,37,1,login - telnet,jupiter,2006-01-11 11:31:09.659 -05:00 subject,1,jsmith,normal,ssh 45880 jupiter command,showuser platform access,granted return,0...
  • Page 554 EXAMPLE 4 XSCF> file,1,2006-01-11 10:52:30.391 -05:00,20060111155230.0000000000.jupiter header,37,1,login - telnet,jupiter,2006-01-11 11:31:09.659 -05:00 subject,1,jsmith,normal,ssh 45880 jupiter command,showuser platform access,granted return,0 header,57,1,command - viewaudit,jupiter.company.com,2006-01-26 16:13:09.128 -05:00 subject,5,sue,normal,ssh 1282 saturn command,viewaudit platform access,granted return,0 EXAMPLE 5 XSCF> file,1,2008-01-09 20:12:12.968 -08:00,20080110041212.0000000004.sca-m5k-0-0 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-0-0 EXAMPLE 6 XSCF>...
  • Page 555 header,37,1,logout,sca-m5k-0-0.sfbay.sun.com,2008-01-09 20:12:14.800 - 08:00,subject,250,o pl,normal,ssh 42759 san-e4900-0.West.Sun.COM header,37,1,login - ssh,sca-m5k-0-0.sfbay.sun.com,2008-01-09 20:12:15.595 - 08:00,subject, 253,scfroot,normal,ssh 42762 san-e4900-0.West.Sun.COM 4238 The following exit values are returned: EXIT STATUS >0 SEE ALSO setaudit(8), showaudit(8) Successful completion. An error occurred. System Administration...
  • Page 556 viewaudit(8) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008...
  • Page 557: Who

    The following exit values are returned: >0 Displays usage statement. Displays a list of the user accounts who are logged in to the XSCF. IDLE FROM pts/0 00:00m Dec 21 13:57 Successful completion. An error occurred. HOST JJJJ.ggg.fujitsu.com System Administration...
  • Page 558 who(1) SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007...

Table of Contents