Fujitsu SPARC Enterprise M4000 Reference Manual
Fujitsu SPARC Enterprise M4000 Reference Manual

Fujitsu SPARC Enterprise M4000 Reference Manual

Xscf control package (xcp) 106x
Hide thumbs Also See for SPARC Enterprise M4000:

Advertisement

Advertisement

Table of Contents
loading

Summary of Contents for Fujitsu SPARC Enterprise M4000

  • Page 3 SPARC Enterprise ® M4000/M5000/M8000/M9000 Servers XSCF Reference Manual XSCF Control Package (XCP) 106x Manual Code C120-E333-05EN Part No. 819-7891-12 November 2007, Revision A...
  • Page 4 Fujitsu Limited or Sun Microsystems, Inc., or any affiliate of either of them.
  • Page 5 Aucune partie de ce produit, de ces technologies ou de ce document ne peut être reproduite sous quelque forme que ce soit, par quelque moyen que ce soit, sans l’autorisation écrite préalable de Fujitsu Limited et de Sun Microsystems, Inc., et de leurs éventuels bailleurs de licence.
  • Page 7: Table Of Contents

    Contents Preface Intro addboard addcodlicense addfru adduser applynetwork cfgdevice console clockboard deleteboard deletecodlicense deletefru deleteuser disableuser enableuser exit flashupdate fmadm fmdump fmstat getflashimage ioxadm...
  • Page 8 moveboard nslookup password poweroff poweron prtfru rebootxscf replacefru reset resetdateoffset sendbreak setaltitude setarchiving setaudit setautologout setcod setdate setdcl setdomainmode setdomparam setdscp setdualpowerfeed setemailreport sethostname sethttps setldap setlocale setlocator setlookup setnameserver setnetwork setntp setpasswordpolicy XSCF Reference Manual • November 2007...
  • Page 9 setpowerupdelay setprivileges setroute setshutdowndelay setsmtp setsnmp setsnmpusm setsnmpvacm setssh settelnet settimezone setupfru setupplatform showaltitude showarchiving showaudit showautologout showboards showcod showcodlicense showcodusage showconsolepath showdate showdcl showdevices showdomainmode showdomainstatus showdscp showdualpowerfeed showemailreport showenvironment showfru showhardconf showhostname Contents...
  • Page 10 showhttps showldap showlocale showlocator showlogs showlookup showmonitorlog shownameserver shownetwork shownotice showntp showpasswordpolicy showpowerupdelay showresult showroute showshutdowndelay showsmtp showsnmp showsnmpusm showsnmpvacm showssh showstatus showtelnet showtimezone showuser snapshot switchscf testsb unlockmaintenance version viewaudit viii XSCF Reference Manual • November 2007...
  • Page 11 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 M4000/ M5000/M8000/M9000 Servers XSCF User’s Guide.
  • Page 12: Audience

    Audience This manual is intended for users, who administrate SPARC Enterprise M4000/ M5000/M8000/M9000 servers (hereinafter referred to as XSCF user). The XSCF user is required to have the following knowledge: Solaris Operating System and Unix command ■ SPARC Enterprise M4000/M5000/M8000/M9000 servers and basic knowledge of ■...
  • Page 13 Each XSCF shell command is described in the order of sections below. When there's no relevant description provided, the section itself is omitted. Section Description NAME This section gives the names of the XSCF shell commands, followed by a brief description of what they do. SYNOPSIS This section gives the syntax of commands.
  • Page 14: Sparc Enterprise Mx000 Servers Documentation

    SPARC Enterprise Mx000 Servers Documentation The manuals listed below are provided for reference. Book Titles Manual Codes SPARC Enterprise M4000/M5000 Servers Site Planning Guide C120-H015 SPARC Enterprise M8000/M9000 Servers Site Planning Guide C120-H014 SPARC Enterprise Equipment Rack Mounting Guide C120-H016...
  • Page 15 Manual Codes SPARC Enterprise M8000/M9000 Servers Safety and C120-E326 Compliance Guide External I/O Expansion Unit Safety and Compliance Guide C120-E457 SPARC Enterprise M4000 Server Unpacking Guide C120-E349 SPARC Enterprise M5000 Server Unpacking Guide C120-E350 SPARC Enterprise M8000/M9000 Servers Unpacking Guide C120-E327...
  • Page 16 4. Provided in system Man page of the XSCF Note – The man page can be referenced on the XSCF Shell, and it provides the same content as the SPARC Enterprise M4000/M5000/M8000/M9000 Servers XSCF Reference Manual. 5. Documentations and Supporting on the Web The latest information about other documents and the supporting of the SPARC Enterprise series are provided on the website.
  • Page 17 7. 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 M4000/M5000/ M8000/M9000 Servers RCI Build Procedure and SPARC Enterprise M4000/M5000/ M8000/M9000 Servers RCI User’s Guide available on the website.
  • Page 18: Abbreviated References To Other Documents

    In this manual, the following abbreviated titles may be used when referring to a systems manual. The following table lists the abbreviations used in this manual. Abbreviated Title Full Title Overview Guide SPARC Enterprise M4000/M5000 Servers Overview Guide SPARC Enterprise M8000/M9000 Servers Overview Guide Service Manual...
  • Page 19: Models

    OpenBoot PROM Software License The function to explain in this manual uses the softwares of GPL,LGPL and others. For the information of the license, see Appendix E, "Software License Condition" in SPARC Enterprise M4000/M5000/M8000/M9000 Servers XSCF User’s Guide. Preface xiii...
  • Page 20: Fujitsu Welcomes Your Comments

    Fujitsu Welcomes Your Comments We would appreciate your comments and suggestions to improve this document. You can submit your comments by using “Reader's Comment Form” on page XSCF Reference Manual • November 2007...
  • Page 21 Reader's Comment Form Preface...
  • Page 22 IN THE UNITED STATES BUSINESS REPLY MAIL FIRST-CLASS MAIL PERMIT NO 741 SUNNYVALE CA POSTAGE WILL BE PAID BY ADDRESSEE FUJITSU COMPUTER SYSTEMS AT TENTION ENGINEERING OPS M/S 249 1250 EAST ARQUES AVENUE P O BOX 3470 SUNNYVALE CA 94088-3470 FOLD AND TAPE XSCF Reference Manual •...
  • Page 23: Addboard

    Intro(8) NAME Intro - eXtended System Control Facility (XSCF) man pages DESCRIPTION This manual contains XSCF man pages. LIST OF The following commands are supported: COMMANDS eXtended System Control Facility (XSCF) man pages Intro, intro configure an eXtended System Board(XSB) into the domain addboard configuration or assigns it to the domain configuration add a Capacity on Demand (COD) right-to-use (RTU)
  • Page 24: Moveboard

    Intro(8) display manual pages of specified XSCF shell command move an eXtended System Board (XSB) from the current moveboard domain to another refer to the DNS server for the host nslookup manage user passwords and expiration settings password turn off the power to the specified domain poweroff turn on the power to the specified domain poweron...
  • Page 25 Intro(8) display manual pages of specified XSCF shell command move an eXtended System Board (XSB) from the current moveboard domain to another refer to the DNS server for the host nslookup manage user passwords and expiration settings password turn off the power to the specified domain poweroff turn on the power to the specified domain poweron...
  • Page 26: Setldap

    Intro(8) configure the Service Processor as a Lightweight Directory setldap Access Protocol (LDAP) client sets the default locale of the XSCF setlocale control the blinking of the CHECK LED on the operator setlocator panel enable or disable the use of the Lightweight Directory setlookup Access Protocol (LDAP) server for authentication and privilege lookup...
  • Page 27: Showaudit

    Intro(8) display the current auditing system state showaudit display the session timeout time of the XSCF shell showautologout display information on an eXtended System Board (XSB) showboards display Capacity on Demand (COD) configuration showcod information display the current Capacity on Demand (COD) right-to- showcodlicense use (RTU) licenses stored in the COD license database display the current usage statistics for Capacity on Demand...
  • Page 28: Showlogs

    Intro(8) display the specified log showlogs display the configuration for authentication and privileges showlookup lookup display the contents of monitoring messages in real time. showmonitorlog display the registered domain name system (DNS) servers shownameserver specified on the XSCF network display information of network interfaces for XSCF shownetwork display copyright and license information for the copyright shownotice...
  • Page 29: Snapshot

    Intro(8) 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 testsb system board (PSB) unlockmaintenance forcibly release the locked status of XSCF display firmware version version display audit records...
  • Page 30 Intro(8) XSCF Reference Manual • Last Revised June 2006...
  • Page 31 addboard(8) NAME addboard - configure an eXtended System Board(XSB) into the domain configuration or assign it to the domain configuration SYNOPSIS addboard [ [-q] -{y|n}] [-f] [-v] [-c configure] -d domain_id xsb [ xsb...] addboard [ [-q] -{y|n}] [-f] [-v] -c assign -d domain_id xsb [ xsb...] addboard [ [-q] -{y|n}] [-f] [-v] -c reserve -d domain_id xsb [ xsb...] addboard -h DESCRIPTION...
  • Page 32 addboard(8) Forcibly incorporates into a domain an XSB. Note – If the -f option is used to forcibly add a system board to a domain, all the added hardware resources may not work normally. For this reason, use of the -f option is not recommended in normal operation.
  • Page 33 addboard(8) See the setdcl(8) and showdcl(8) commands for DCL. ■ EXAMPLES Configures XSB#00-0, #01-0, #02-0, and #03-0 into domain ID 0. EXAMPLE 1 addboard -y -c assign -d 0 00-0 01-0 02-0 03-0 XSCF> Configures XSB#00-0, #01-0, #02-0, and #03-0 forcibly into domain ID 2. EXAMPLE 2 addboard -f -d 2 00-0 01-0 02-0 03-0 XSCF>...
  • Page 34 addboard(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 35 addcodlicense(8) NAME addcodlicense - add a Capacity on Demand (COD) right-to-use (RTU) license key to the COD license database SYNOPSIS addcodlicense license-signature addcodlicense -h DESCRIPTION addcodlicense(8) adds the COD RTU specified license key to the COD license database on the Service Processor. When the license key is added, the quantity of headroom is reduced by the quantity provided by the license key.
  • Page 36 addcodlicense(8) XSCF Reference Manual • Last Revised June 2007...
  • Page 37 addfru(8) NAME addfru - add a Field Replaceable Unit (FRU) SYNOPSIS addfru addfru -h DESCRIPTION The addfru(8) command adds an FRU. The addfru(8) command enables the user to make the settings that are required for FRU addition and related to selecting, confirming, and mounting FRUs, interactively using menus.
  • Page 38 addfru(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 39 adduser(8) NAME adduser - create an XSCF user account SYNOPSIS adduser [-u UID] user adduser -h DESCRIPTION adduser(8) creates a new local XSCF user account. This account is used to configure, operate, manage and administrate the XSCF firmware. Initially, this account has no password.
  • Page 40 adduser(8) EXAMPLES Creating a New User EXAMPLE 1 adduser -u 359 jsmith XSCF> EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO deleteuser(8), disableuser(8), enableuser(8), password(8), setldap(8), setpasswordpolicy(8), showldap(8), showpasswordpolicy(8), showuser(8) XSCF Reference Manual • Last Revised November 2007...
  • Page 41 applynetwork(8) NAME applynetwork - reflect the information that has been set for the XSCF network SYNOPSIS applynetwork [ [-q] -{y|n}] [-M] applynetwork -h DESCRIPTION applynetwork(8) command reflects the information that has been set for the XSCF network to XSCF. When you set one of the following for the XSCF network, it is necessary to execute the applynetwork(8) command to reflect the information to XSCF.
  • Page 42 applynetwork(8) Unless all of the host name, DNS domain name, IP address, net mask, and ■ routing settings have been made, it results in errors. Please execute the sethostname(8), setnetwork(8), and setroute(8) command to set all items, then reexecute the applynetwork(8) command. To set to multiple interfaces, all of the host name, DNS domain name, IP address, ■...
  • Page 43: System Administration

    applynetwork(8) On a high-end server: The case of high-end server. applynetwork XSCF> The following network settings will be applied: xscf#0 hostname :hostname-0 xscf#1 hostname :hostname-1 DNS domain name :example.com nameserver :10.23.4.3 interface :xscf#0-lan#0 status IP address :10.24.144.214 netmask :255.255.255.0 route : -n 0.0.0.0 -m 0.0.0.0 -g 10.24.144.1 interface :xscf#0-lan#1...
  • Page 44 applynetwork(8) On the midrange server, reflects the information that has been set for the EXAMPLE 2 XSCF network. Automatically answers "y" to all prompts. applynetwork -y XSCF> The following network settings will be applied: xscf#0 hostname :hostname-0 DNS domain name :example.com nameserver :10.23.4.3...
  • Page 45 cfgdevice(8) NAME cfgdevice - connect the CD-RW/DVD-RW drive unit and the tape drive unit to the port, disconnect it from the port, or display the status of the drive SYNOPSIS cfgdevice [ [-q] -{y|n}] -c attach -p port_no cfgdevice [ [-q] -{y|n}] -c detach -p port_no cfgdevice -l [-M] cfgdevice -h DESCRIPTION...
  • Page 46 cfgdevice(8) The current status of the drive that is displayed with this command includes the following types of status information: Port number of the port where the IOUA is installed and that port_no can be connected to the DVD drive/tape drive unit. It is displayed in the "IOU number-PCI slot number"...
  • Page 47 cfgdevice(8) OPTIONS The following options are supported: Connects the DVD drive/tape drive unit to the specified -c attach port. Disconnects the DVD drive/tape drive unit from the -c detach specified port. Displays usage statement. When used with other options or operands, an error occurs.
  • Page 48 cfgdevice(8) The DVD drive/tape drive unit is mounted in each of the base and expansion ■ cabinets in a high-end server that has the expansion cabinet. In such cases, each DVD drive/tape drive unit can be connected only to a domain within the cabinet in which the drive is mounted.
  • Page 49 cfgdevice(8) DVD drive/tape drive unit Displays the status of individual set (without EXAMPLE 4 the expansion cabinet). cfgdevice -l XSCF> Current connection for DVD/DAT: port 0-0 Expander status Port No. IOU/SAS-status SAS-status ----------------------------------- enable enable disable down enable DVD drive/tape drive unit Displays the status of individual set (with the EXAMPLE 5...
  • Page 50 cfgdevice(8) XSCF Reference Manual • Last Revised June 2007...
  • Page 51 console(8) NAME console - connect to a domain console SYNOPSIS console [ [-q] -{y|n}] -d domain_id [-f | -r] [-s escapeChar] console -h DESCRIPTION The console(8) command connects the XSCF shell console to the console of the specified domain (domain console). Domain consoles include a writable console and read-only console.
  • Page 52 console(8) Automatically answers 'n' (no) to all prompts. Suppresses all messages to stdout, including prompts. Sets up a connection to a read-only console. -s escapeChar Specifies an escape character. The default is ’#’ (sharp). The character specified for escapeChar must be enclosed in double quotation ("...
  • Page 53 clockboard(8) NAME clockboard - Set or display the clock control unit used at system startup SYNOPSIS clockboard clockboard -s CLKU_B-number clockboard -h DESCRIPTION The clockboard(8) command specifies the clock control unit used when the system power is turned on, or it displays the clock control unit that is currently used and the clock control unit used at the next system startup.
  • Page 54 clockboard(8) XSCF Reference Manual • Last Revised June 2007...
  • Page 55 deleteboard(8) NAME deleteboard - disconnect an eXtended System Board (XSB) from the domain configuration SYNOPSIS deleteboard [ [-q] -{y|n}] [-f] [-v] [-c disconnect] xsb [ xsb...] deleteboard [ [-q] -{y|n}] [-f] [-v] -c unassign xsb [ xsb...] deleteboard [ [-q] -{y|n}] [-f] [-v] -c reserve xsb [ xsb...] deleteboard -h DESCRIPTION The deleteboard(8) command disconnects an XSB from the domain configuration...
  • Page 56 deleteboard(8) OPTIONS The following options are supported. -c disconnect Detaches the XSB from the domain configuration and keeps it assigned. If the -c option is omitted, "-c disconnect" is used. Reserves disconnect of an XSB. If the -c option is omitted, "-c -c reset disconnect"...
  • Page 57 deleteboard(8) If "-c disconnect" is specified when either the domain power has been turned ■ off or the XSB is already disconnected from the domain configuration, no operation is performed. If domain power-on or power-off is in progress, the command results in an error. If "-c unassign"...
  • Page 58 deleteboard(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 59 deletecodlicense(8) NAME deletecodlicense - remove a Capacity on Demand (COD) right-to-use (RTU) license key from the COD license database SYNOPSIS deletecodlicense [-f] license-signature deletecodlicense -h DESCRIPTION The deletecodlicense(8) command removes the specified COD RTU license key from the COD license database on the Service Processor. For further information about COD RTU license keys, refer to the OPL Administration Guide.
  • Page 60 deletecodlicense(8) SEE ALSO addcodlicense(8), setcod(8), showcod(8), showcodlicense(8), showcodusage(8) XSCF Reference Manual • Last Revised June 2007...
  • Page 61 deletefru(8) NAME deletefru - delete a Field Replaceable Unit (FRU) SYNOPSIS deletefru deletefru -h DESCRIPTION The deletefru(8) command deletes a FRU. The deletefru(8) command allows the user to make the settings that are required for FRU deletion and related to selecting, confirming, and removing FRUs interactively using menus.
  • Page 62 deletefru(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 63 deleteuser(8) NAME deleteuser - delete an XSCF user account SYNOPSIS deleteuser user deleteuser -h DESCRIPTION deleteuser(8) deletes a local XSCF user account. All local account data associated with the user account is deleted including password and Secure Shell (SSH) keys. The local user’s currently running XSCF shell and browser sessions are terminated at once.
  • Page 64 deleteuser(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 65 disableuser(8) NAME disableuser - disable an XSCF user account SYNOPSIS disableuser user disableuser -h DESCRIPTION disableuser(8) disables a local XSCF user account for subsequent logins. Current sessions are not affected. When an account is disabled, it cannot be used for login. This applies to console (serial) and telnet connections, as well as the Secure Shell (SSH).
  • Page 66 disableuser(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 67 enableuser(8) NAME enableuser - enable an XSCF user account SYNOPSIS enableuser user enableuser -h DESCRIPTION enableuser(8) enables a local XSCF user account. An enabled account can be used for login at the console, using Secure Shell (SSH). Using this command, you can reenable accounts disabled by disableuser.
  • Page 68 enableuser(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 69 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 70 exit(1) XSCF Reference Manual • Last Revised January 2007...
  • Page 71 -h DESCRIPTION The flashupdate(8) command updates the firmware that is provided for the SPARC Enterprise M4000/M5000/M8000/M9000 servers. The entire firmware shown below is updated. Whether update can be performed can be checked beforehand. Update of the entire firmware (XSCF, OpenBoot PROM) (xcp) ■...
  • Page 72 flashupdate(8) Suppresses all messages to stdout, including prompts. -s version Specifies a XCP comprehensive firmware version. For version, specify a major version, minor version and micro version continuously. The XCP version number appears as xyyz by four digits, where: Major firmware release number Minor release number Micro release number Automatically answers 'y' (yes) to all prompts.
  • Page 73 flashupdate(8) Updates the entire firmware to version from 1010 to 1020. EXAMPLE 2 flashupdate -c update -m xcp -s 1020 XSCF> The XSCF will be reset. Continue? [y|n] : XCP update is started (XCP version=1020:last version=1010) OpenBoot PROM update is started OpenBoot PROM update has been completed (OpenBoot PROM version=01010001) XSCF update is started (SCF=0, bank=1, XCP version=1020:last version=1010) XSCF download is started (SCF=0, bank=1, XCP version=1020:last...
  • Page 74 flashupdate(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 75 fmadm(8) NAME fmadm - fault management configuration tool SYNOPSIS fmadm [-q] config fmadm -h DESCRIPTION fmadm (8) can be used to view system configuration parameters related to fault management. fmadm can be used to: View the set of diagnosis engines and agents that are currently participating in fault management View the list of system components that have been diagnosed as faulty The Fault Manager attempts to automate as many activities as possible, so use of...
  • Page 76 fmadm(8) EXAMPLES Displaying the Fault Manager Configuration EXAMPLE 1 fmadm config XSCF> MODULE VERSION STATUS DESCRIPTION case-close active Case-Close Agent fmd-self-diagnosis 1.0 active Fault Manager Self- Diagnosis sysevent-transport 1.0 active SysEvent Transport Agent syslog-msgs active Syslog Messaging Agent EXIT STATUS The following exit values are returned: Successful completion.
  • Page 77 fmdump(8) NAME fmdump - view fault management logs SYNOPSIS fmdump fmdump [-e] [-f] [-M] [-v] [-V] [-c class] [-t time] [-T time] [-u uuid] fmdump -m [-M] [-t time] [-T time] fmdump -h DESCRIPTION The fmdump utility displays the contents of any of the logs associated with the Fault Manager (fault manager daemon).
  • Page 78 fmdump(8) filter option is present on the command-line, the like options combine to display any events selected by the logical OR of the options. You can use the -m option to display the Fault Manager syslog contents. You must have platop, platadm, or fieldeng privileges to run this command. Privileges Refer to setprivileges(8) for more information.
  • Page 79 fmdump(8) -u uuid Selects fault diagnosis events that exactly match the specified uuid. Each diagnosis is associated with a Universal Unique Identifier (UUID) for identification purposes. The -u option can be combined with other options such as -v to show all of the details associated with a particular diagnosis.
  • Page 80 fmdump(8) Time Format Description yyyy-mm-dd[T hh:mm[:ss]] Year, month, day, and optional hour in 24-hour format, minute, and second, where T is an integer value specified in base 10. The second, or hour, minute, and second, can be optionally omitted. ddMonyy 12:00:00AM on the specified day, month name, and year.
  • Page 81 fmdump(8) EXAMPLES Default fmdump Display EXAMPLE 1 fmdump XSCF> TIME UUID MSG-ID Aug 12 16:12:13.2811 7868c1cc-23d4-c575-8659-85cdbe61842e FMD-8000-77 Aug 12 16:12:13.2985 7868c1cc-23d4-c575-8659-85cdbe61842e FMD-8000-77 Sep 01 16:06:57.5839 3ceca439-b0b2-4db1-9123-c8ace3f2b371 FMD-8000-77 Sep 01 16:06:57.6278 3ceca439-b0b2-4db1-9123-c8ace3f2b371 FMD-8000-77 Sep 06 09:37:05.0983 6485b42b-6638-4c5d-b652-bec485290788 LINUX-8000-1N 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...
  • Page 82 fmdump(8) Displaying the Full Fault Report for the Specified UUID EXAMPLE 4 fmdump -V -u 5f88d7d5-a107-4435-99c9-7c59479d22ed XSCF> TIME UUID MSG-ID Sep 29 15:10:09.6151 5f88d7d5-a107-4435-99c9-7c59479d22ed FMD-8000-58 TIME CLASS Sep 29 15:10:09.5652 ereport.io.iox.cp.seeprom0.nresp 0x921b650000000001 nvlist version: 0 version = 0x0 class = list.suspect uuid = 5f88d7d5-a107-4435-99c9-7c59479d22ed code = FMD-8000-58 diag-time = 1128021009 615016...
  • Page 83 fmdump(8) Displaying Contents of the Fault Manager syslog Message EXAMPLE 5 fmdump -m -M XSCF> MSG-ID: FMD-8000-11, TYPE: Defect, VER: 1, SEVERITY: Minor EVENT-TIME: Tue Nov 7 07:01:44 PST 2006 PLATFORM: SUNW,SPARC-Enterprise, CSN: 7860000764, HOSTNAME: san-ff2-20-0 SOURCE: sde, REV: 1.5 EVENT-ID: 2daddee0-2f42-47ee-b5b2-57ae6a41bfc0 DESC: A Solaris Fault Manager component generated a diagnosis for which no message summary exists.
  • Page 84 fmdump(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 85 fmstat(8) NAME fmstat - report fault management module statistics SYNOPSIS fmstat [-a] [ [-s] [-z] [-m module]] [ interval [ count]] fmstat -h DESCRIPTION The fmstat utility can be used by administrators and service personnel to report statistics associated with the Fault Manager (fault manager daemon), and its associated set of modules.
  • Page 86 fmstat(8) The total number of cases solved by this module since it was solve loaded. The amount of dynamic memory currently allocated by this memsz module. The amount of persistent buffer space currently allocated by bufsz this module. You must have platadm, platop, or fieldeng privileges to run this command. Privileges Refer to setprivileges(8) for more information.
  • Page 87 fmstat(8) OPERANDS The following operands are supported: count Print only count reports, and then exit. interval Print a new report every interval seconds. If neither count nor interval is specified, a single report is printed and fmstat exits. If an interval is specified but no count is specified, fmstat prints reports every interval seconds indefinitely until the command is interrupted by Control-C.
  • Page 88 fmstat(8) fmstat XSCF> module ev_recv ev_acpt wait svc_t open solve memsz bufsz case-close 0 0.0 fmd-self-diagnosis 1 0.0 sysevent-transport 0 0.0 573.2 syslog-msgs 0 0.0 Displaying FM Statistics for fmd Self-Diagnosis Module EXAMPLE 2 fmstat -z -m fmd-self-diagnosis XSCF> NAME VALUE DESCRIPTION module 1 error events received from fmd modules...
  • Page 89 getflashimage(8) NAME getflashimage - download a firmware image file SYNOPSIS getflashimage [-v ] [ [-q] -{y|n} ] [-u user ] [-p proxy [-t proxy_type]] url getflashimage -l getflashimage [ [-q] -{y|n} ] [-d] getflashimage -h DESCRIPTION The getflashimage(8) command downloads a firmware image file for use by the flashupdate(8) command.
  • Page 90 getflashimage(8) -u user Specifies the user name when logging in to a remote ftp or http server that requires authentication. You will be prompted for a password. Displays verbose output. This may be helpful when diagnosing network or server problems. Automatically answers y (yes) to all prompts.
  • Page 91 getflashimage(8) Downloading a Version from an ftp Server EXAMPLE 2 getflashimage ftp://imageserver/images/FFXCP1041.tar.gz XSCF> Existing versions: Version Size Date FFXCP1040.tar.gz 46827123 Wed Mar 14 19:11:40 2007 Warning: About to delete existing versions. Continue? [y|n]: Removing FFXCP1040.tar.gz. 0MB received 1MB received 2MB received 43MB received 44MB received 45MB received...
  • Page 92 getflashimage(8) Downloading Using a User Name and Password EXAMPLE 4 getflashimage -u jsmith XSCF> http://imageserver/images/FFXCP1041.tar.gz Existing versions: Version Size Date FFXCP1040.tar.gz 46827123 Wed Mar 14 19:11:40 2007 Warning: About to delete existing versions. Continue? [y|n]: Removing FFXCP1040.tar.gz. Password: [not echoed] 0MB received 1MB received 2MB received...
  • Page 93 ioxadm(8) NAME ioxadm - manage External I/O Expansion Units SYNOPSIS ioxadm [-f] [-p] [-v] [-M] env [-e] [-l] [-t] [ target [ sensors]] ioxadm [-f] [-p] [-v] [-M] list [ target] ioxadm [-f] [-p] [-v] [-M] locator [on|off] [ target] ioxadm [-f] [-p] [-v] [-M] poweroff target ioxadm [-f] [-p] [-v] [-M] poweron target ioxadm [-f] [-p] [-v] [-M] reset target...
  • Page 94 ioxadm(8) Displays text by page. This option provides a function that is the same as that of the more command. Parsable output. Suppresses headers in display output. Fields are separated by single tabs. Specifies verbose output. Refer to specific operands for details. OPERANDS The following operands are supported: env [-elt] [target [sensors]]...
  • Page 95 ioxadm(8) Displays a summary of an External I/O Expansion Unit or link card’s environmental state. ■ Displays electrical states: measured voltage, current, fan speed, switch settings. ■ Displays LED states. ■ Displays thermal readings. If no target is specified, env displays a list of all sensors for all External I/O Expansion Units.
  • Page 96 ioxadm(8) Displays a summary of an External I/O Expansion Unit or link card’s environmental state. ■ Displays electrical states: measured voltage, current, fan speed, switch settings. ■ Displays LED states. ■ Displays thermal readings. If no target is specified, env displays a list of all sensors for all External I/O Expansion Units.
  • Page 97 ioxadm(8) Fields containing a dash (–) indicate an unsupported setting. For example, there may be no minimum temperature alarm threshold. led_type Used with the setled operand, specifies a software-controlled FRU LED. The following table indicates which LED states can be controlled using the setled operand with the off, on, fast, and slow LED state settings.
  • Page 98 ioxadm(8) Sets or queries the state of the locator indicator (LED). Without options, locator reports the current state of the LED on the specified FRU. If no target is specified, locator returns the current state of all locator LEDs. A target argument is required when using the option fields: Turns the LED on.
  • Page 99 ioxadm(8) Reinitializes FRU components used to monitor External I/O Expansion Unit environmentals. If a boat or link card is specified, the bridge controllers in the link cards are reset and re-initialized. If a box is specified, the fan controller and demux in the box are reset and re-initialized along with all bridge controllers associated with the External I/O Expansion Unit.
  • Page 100 The downlink card is identified by the hostpath to the card. hostpath is platform dependent and indicates the path to the slot on the host system which contains the downlink card. On SPARC Enterprise M4000/M5000/M8000/M9000 servers, the hostpath has the following format: IOU#0-PCI#0 IO Board 0, PCI-E slot0 The External I/O Expansion Unit (box_id) is identified by serial number.
  • Page 101 ioxadm(8) EXAMPLES Displaying Temperature, Voltage, Current, and Fanspeed Sensor Readings EXAMPLE 1 ioxadm env -te iox@A3B5 XSCF> Location Sensor Value Units IOX@A3B5/PS0 T_AMBIENT 28.000 1.000 IOX@A3B5/PS0 T_CHIP 28.000 1.000 IOX@A3B5/PS0 T_HOTSPOT 31.000 1.000 IOX@A3B5/PS0 SWITCH SWITCH IOX@A3B5/PS0 V_12V_ANODE 11.703 0.059 IOX@A3B5/PS0 V_12V_CATHODE 11.703...
  • Page 102 ioxadm(8) , the list command is used to display the connections between EXAMPLE 3 External I/O Expansion Units and downlink cards in the host. IOX@0033 (which includes boats, uplink cards, and power supplies) is connected to the host through two downlink cards. The Link 0 column shows which host downlink card is attached to boat0.
  • Page 103 ioxadm(8) Enabling the Indicator for Power Supply 1 When Power Supply 1 Has a EXAMPLE 9 Fault Indication ioxadm locator on iox@x031/ps1 XSCF> ioxadm locator XSCF> Location Sensor Value Resolution Units IOX@X031 LOCATE Fast - LED ioxadm env -1 iox@x031/ps1 SERVICE XSCF>...
  • Page 104 ioxadm(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 105 man(1) NAME man - display manual pages of specified XSCF shell command SYNOPSIS man command_name ... man -h DESCRIPTION man(1) displays manual pages of specified XSCF shell command. No privileges are required to run this command. Privileges Refer to setprivileges(8) for more information. OPTIONS The following option is supported;...
  • Page 106 man(1) EXIT STATUS The following exit values are returned: Successful completion An error occurred. >0 XSCF Reference Manual • Last Revised January 2007...
  • Page 107 moveboard(8) NAME moveboard - move an eXtended System Board (XSB) from the current domain to another SYNOPSIS moveboard [ [-q] -{y|n}] [-f] [-v] [-c configure] -d domain_id xsb [ xsb...] moveboard [ [-q] -{y|n}] [-f] [-v] -c assign -d domain_id xsb [ xsb...] moveboard [ [-q] -{y|n}] [-f] [-v] -c reserve -d domain_id xsb [ xsb...] moveboard -h DESCRIPTION...
  • Page 108 moveboard(8) OPTIONS The following options are supported: Disconnects a configured XSB from its domain configuration and -c assign assigns it to the domain configuration of the move destination. If the -c option is omitted, '-c configure' is used. Disconnects a configured XSB from its domain configuration and -c configure configures it in the domain configuration of the move destination.
  • Page 109 moveboard(8) OPERANDS The following operand is supported: Specifies the XSB number to be moved. Multiple xsb operands are permitted, separated by spaces. The following xsb form is accepted: x–y where: An integer from 00–15. An integer from 0–3. EXTENDED When the command is executed, a prompt to confirm execution of the command ■...
  • Page 110 moveboard(8) Reserves assignment of the XSB#00-0 to the domain ID 1. EXAMPLE 2 moveboard -d 1 -c reserve 00-0 XSCF> EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO addboard(8), deleteboard(8), setdcl(8), setupfru(8), showboards(8), showdcl(8), showdevices(8), showdomainstatus(8), showfru(8) XSCF Reference Manual •...
  • Page 111 nslookup(8) NAME nslookup - refer to the DNS server for the host SYNOPSIS nslookup hostname nslookup -h DESCRIPTION nslookup(8) refers to the DNS server for the host. The following information is displayed: Server DNS server name Address IP address of DNS server Name Specified host name Address...
  • Page 112 nslookup(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 113 password(8) NAME password - manage user passwords and expiration settings SYNOPSIS password [-e days| date|Never] [-i inactive] [-M maxdays] [-n mindays] [-w warn] [ user] password -h DESCRIPTION password (8) changes a user’s password and password expiration settings. The password is specified in up to 32 characters. The following characters are valid: 1.
  • Page 114 password(8) OPTIONS The following options are supported -e days|date|Never Sets the number of days, starting from today, during which the XSCF account is enabled. Otherwise, it sets the date when the account expires. The date format can be yyyy-mm-dd. Never (or its equivalent in the language of the system locale) means an account will never expire.
  • Page 115 password(8) EXAMPLES Enabling Password Until February 2, 2008 EXAMPLE 1 password -e 2008-02-02 XSCF> Set Password Lock 10 Days After Password Expiration EXAMPLE 2 password -i 10 XSCF> EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO setpasswordpolicy(8), showpasswordpolicy(8)
  • Page 116 password(8) XSCF Reference Manual • Last Revised November 2007...
  • Page 117 poweroff(8) NAME poweroff - turn off the power to the specified domain SYNOPSIS poweroff [ [-q] -{y|n}] [-f] [-M] -d domain_id poweroff [ [-q] -{y|n}] -a [-M] poweroff -h DESCRIPTION The poweroff(8) command turns off the power to the specified domain. The command can turn off the power to the specified domain or to all domains.
  • Page 118 poweroff(8) If the operating system of the target domain is running, the poweroff(8) ■ command processing is equivalent to that of the shutdown(1M) command with the "-i5" option specified. A domain cannot be powered off while the operating system of the domain is ■...
  • Page 119 poweroff(8) Turns off power to domains with domain IDs 1. An error occurs because the EXAMPLE 3 user has no control privilege. poweroff -d 1 XSCF> DomainIDs to power off:01 Continue? [y|n]: 01:Not powering off:Permission denied. *Note* This command only issues the instruction to power-off. The result of the instruction can be checked by the "showlogs power".
  • Page 120 poweroff(8) Automati- Cancels the poweroff(8) command execution that is in progress. EXAMPLE 9 cally replies with ' ' without displaying the prompt. poweroff -q -n -d 3 XSCF> EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO poweron(8), reset(8), showdomainstatus(8)
  • Page 121 poweron(8) NAME poweron - turn on the power to the specified domain SYNOPSIS poweron [ [-q] -{y|n}] [-M] -d domain_id poweron [ [-q] -{y|n}] [-M] -a poweron -h DESCRIPTION The poweron(8) command turns on the power to the specified domain. The command can turn on the power to the specified domain or to all domains.
  • Page 122 poweron(8) When the poweron(8) command is executed, power-on results for each of the ■ specified domains are displayed in the following format: The power was turned on normally. Powering on An error occurred, and the power could not be turned on. An Not Powering error message is displayed with Not Powering on.
  • Page 123 poweron(8) Cancels the poweron(8) command execution that is in progress. EXAMPLE 5 poweron -d 1 XSCF> DomainIDs to power on:01 Continue? [y|n]: Automati- Cancels the poweron(8) command execution that is in progress. EXAMPLE 6 cally replies with ' ' to the prompt. poweron -n -d 1 XSCF>...
  • Page 124 poweron(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 125 prtfru(8) NAME prtfru - display FRUID data on the system and External I/O Expansion Unit SYNOPSIS prtfru [-c] [-l] [-M] [-x] [ container] prtfru -h DESCRIPTION prtfru is used to obtain FRUID (Field-Replaceable Unit Identifier) data from the system. Its output is a tree structure, echoing the path in the FRU tree to each container.
  • Page 126 prtfru(8) EXAMPLES Displaying FRU Tree Hierarchy EXAMPLE 1 prtfru -l XSCF> /frutree /frutree/chassis (fru) /frutree/chassis/SYS?Label=SYS /frutree/chassis/SYS?Label=SYS/led-location (fru) /frutree/chassis/SYS?Label=SYS/key-location (fru) /frutree/chassis/SC?Label=SC /frutree/chassis/SC?Label=SC/system-controller (container) /frutree/chassis/MB?Label=MB /frutree/chassis/MB?Label=MB/system-board (container) /frutree/chassis/MB?Label=MB/system-board/BAT?Label=BAT /frutree/chassis/MB?Label=MB/system-board/BAT?Label=BAT/battery (fru) /frutree/chassis/FT0?Label=FT0 /frutree/chassis/FT0?Label=FT0/F0?Label=F0 /frutree/chassis/FT0?Label=FT0/F0?Label=F0/fan (fru) /frutree/chassis/HDD0?Label=HDD0 /frutree/chassis/HDD0?Label=HDD0/disk (fru) /frutree/chassis/DVD?Label=DVD /frutree/chassis/SCC?Label=SCC /frutree/chassis/SCC?Label=SCC/scc (fru) /frutree/chassis/PCI0?Label=PCI0 /frutree/chassis/PCI1?Label=PCI1 /frutree/chassis/SCSIBP?Label=SCSIBP /frutree/chassis/SCSIBP?Label=SCSIBP/system-board (container)
  • Page 127 prtfru(8) Displaying Power Supply FRU ID Data EXAMPLE 4 prtfru -l power-supply XSCF> /frutree/chassis/PS0?Label=PS0/power-supply (container) Displaying Memory Module FRU ID Data EXAMPLE 5 prtfru -l mem-module XSCF> /frutree/chassis/C0?Label=C0/system-board/P0?Label=P0/cpu/B0?Label=B0/ bank/D0?Label=D0/mem-module (container) The following exit values are returned: EXIT STATUS Successful completion. An error occurred.
  • Page 128 prtfru(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 129 rebootxscf(8) NAME rebootxscf - reset the XSCF SYNOPSIS rebootxscf [ [-q] -{y|n}] rebootxscf -h DESCRIPTION The rebootxscf(8) command resets the XSCF. In case the XSCF unit is duplicated configuration, both of the active XSCF and the standby XSCF will be reset. You must have platadm or fieldeng privilege to run this command.
  • Page 130 rebootxscf(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO applynetwork(8), setdate(8), sethttps(8), setssh(8) XSCF Reference Manual • Last Revised June 2007...
  • Page 131 replacefru(8) NAME replacefru - replace a field replaceable unit (FRU) SYNOPSIS replacefru replacefru -h DESCRIPTION The replacefru(8) command replaces a FRU. The command allows the user to select, confirm, and replace the FRU interactively using menus. The following FRUs can be replaced using the replacefru(8) command. CPU memory unit (CMU) ■...
  • Page 132 replacefru(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 133 reset(8) NAME reset - reset the specified domain SYNOPSIS reset [ [-q] -{y|n}] -d domain_id level reset -h Note – Since the reset(8) command forcibly resets the system, this command may DESCRIPTION cause a failure in a hard disk drive or other components. Use this command only for the purpose of recovery, such as if the operating system hangs, and for other limited purposes.
  • Page 134 reset(8) OPERANDS The following operand is supported: level Specifies the level of resetting. One of the following can be specified. This operand cannot be omitted. Resets the domain system. Instructs the domain operating system to request generate a panic. Resets the domain CPU. EXTENDED When the command is executed, a prompt to confirm execution of the command ■...
  • Page 135 reset(8) Cancels the reset command execution that is in progress. EXAMPLE 4 reset -d 0 panic XSCF> DomainID to panic:00 Continue? [y|n]: EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO poweroff(8), poweron(8), setdomainmode(8), showdomainstatus(8) System Administration...
  • Page 136 reset(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 137 resetdateoffset(8) NAME resetdateoffset - reset the time subtraction between XSCF and the domain SYNOPSIS resetdateoffset resetdateoffset -h DESCRIPTION The resetdateoffset(8) command resets the time subtraction between XSCF and the domain, which stored in XSCF. Usually, the time of the domain is synchronized with the time of XSCF. When the time of the domain changed by using a command such as the date(1M) which prepared in the operating system of domain, the time subtraction between the time of XSCF and the changed time of domain will be stored in XSCF.
  • Page 138 resetdateoffset(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 139 sendbreak(8) NAME sendbreak - send a break signal to the specified domain SYNOPSIS sendbreak -d domain_id sendbreak [ [-q] -{y|n}] -d domain_id sendbreak -h DESCRIPTION The sendbreak(8) command sends a break signal to the specified domain. When a break signal is sent from the domain console to the domain operating system, control is transferred from the operating system to OpenBoot PROM and the OpenBoot PROM prompt "ok>"...
  • Page 140 sendbreak(8) XSCF Reference Manual • Last Revised June 2007...
  • Page 141 setaltitude(8) NAME setaltitude - set the altitude of the system SYNOPSIS setaltitude -s key=value setaltitude -h DESCRIPTION The setaltitude(8) command sets the altitude of the system. The specified value becomes valid when the circuit breakers of the system are switched on again. You must have platadm or fieldeng privileges to run this command.
  • Page 142 setaltitude(8) Sets the altitude of the system to 200 m. The specified value is rounded up EXAMPLE 2 to the nearest hundred meters. setaltitude -s altitude=157 XSCF> 200m EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO showaltitude(8)
  • Page 143 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 144 setarchiving(8) OPTIONS The following options are supported: Displays usage statement. When used with other options or operands, an error occurs. -k host-key Sets the public key that XSCF uses to verify the identity of the host. Possible values for the host-key are shown here: none This literal value specifies that a public key...
  • Page 145 setarchiving(8) -l audit-limit,non-audit-limit Sets the space limits for log archives in megabytes. The option argument must consist of two values separated by a comma. The audit-limit value specifies the archive space limit for audit logs. It must be either 0 (zero), unlimited or an integer in the range of 500–50000.
  • Page 146 setarchiving(8) OPERANDS The following operands are supported: Activates the log archiving feature. Cannot be used with any enable options. De-activates the log archiving feature. Cannot be used with any disable options. EXAMPLES Setting the Archiving Target and Password EXAMPLE 1 setarchiving -t jsmith@somehost.company.com:/home/jsmith/ XSCF>...
  • Page 147 setaudit(8) NAME setaudit - manage the system auditing functionality SYNOPSIS setaudit enable|disable|archive|delete setaudit [-p count|suspend] [ -m mailaddr] [-a users=enable|disable|default] [-c classes= {enable|disable }]... [-e events=enable|disable ]... [-g {enable|disable }] [-t percents] setaudit -h DESCRIPTION setaudit(8) manages the collection of data on the use of system resources. Audit data provides a record of security-related system events.
  • Page 148 setaudit(8) OPTIONS The following options are supported. -a users=enable|disable|default Sets the audit record generation policy for the specified users. users is a comma-separated list of valid user names. When set to enable or disable, audit record generation for the users is turned on or off respectively.
  • Page 149 setaudit(8) -e events = enable|disable Changes the audit record generation policy for the specified audit events. events is a comma-separated list of audit events. An event may be specified by its numeric value or its name. The AEV_ prefix may be omitted. For example, the event for SSH login can be expressed as AEV_LOGIN_SSH, LOGIN_SSH or 0.
  • Page 150 setaudit(8) -t percents Sets thresholds at which to issue a warning about local audit storage usage. percents is a comma-separated list of percentages of available space used. At most two values may be set. For example, a value of 50, 75 would cause warnings to be issued when 50% and 75%, respectively, of the available storage for audit records is consumed.
  • Page 151 setaudit(8) Auditing is enabled for all of Class 1 (SYSTEM) except for event 64 (USER) is disabled. Enabling Auditing EXAMPLE 4 setaudit enable XSCF> Turns on writing of the audit records for the audit trail. Enabling Warnings EXAMPLE 5 setaudit -t 50,75 XSCF>...
  • Page 152 setaudit(8) XSCF Reference Manual • Last Revised June 2007...
  • Page 153 setautologout(8) NAME setautologout - set the session timeout time of the XSCF shell SYNOPSIS setautologout -s timeout setautologout -h DESCRIPTION The setautologout(8) command sets the session timeout time of the XSCF shell. The default of the session timeout time is 10 minutes. You must have platadm or fieldeng privileges to run this command.
  • Page 154 setautologout(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 155 setcod(8) NAME setcod - set up the Capacity on Demand (COD) resources used for domains SYNOPSIS setcod setcod [-v] setcod [[-q] -{y|n}] [-v] headroom setcod [-v] -d domain_id [ proc-rtus] setcod -h DESCRIPTION setcod(8) sets up the COD resources to be used for domains. License keys must be installed (see addcodlicense(8)) before COD boards in a domain can be utilized.
  • Page 156 setcod(8) OPERANDS The following operands are supported: headroom Amount of headroom (processors) to be enabled. Maximum value is 4. proc-rtus The number of Right To Use (RTUs) licenses reserved for a domain. One RTU license is required for each CPU. EXTENDED If you run the setcod command without specifying any options, the command DESCRIPTION...
  • Page 157 setcod(8) After this command completes, you will see a message similar to this one in the XSCF console: codd 15:51:36: COD PROC Headroom changed to 3 Set the COD Headroom CPUs to 0 EXAMPLE 3 setcod 0 XSCF> EXIT STATUS The following exit values are returned: Successful completion.
  • Page 158 setcod(8) XSCF Reference Manual • Last Revised June 2007...
  • Page 159 setdate(8) NAME setdate - set the date and time of XSCF SYNOPSIS setdate [ [-q] -{y|n}] [-u] -s date setdate -h DESCRIPTION The setdate(8) command sets the date and time of XSCF. If the local date and time are specified, they are set following conversion to coordinated universal time (UTC).
  • Page 160 setdate(8) The ntpdate(1M) command is executed in the domain. ■ Rebooting the domain ■ The setdate(8) command needs to be executed in the system power-off status. ■ In case an NTP server set to XSCF, the time set by the setdate(8) command ■...
  • Page 161 setdate(8) SEE ALSO setntp(8), settimezone(8), showdate(8), showntp(8), showtimezone(8) System Administration...
  • Page 162 setdate(8) XSCF Reference Manual • Last Revised June 2007...
  • Page 163 setdcl(8) NAME setdcl - set a domain component list (DCL) SYNOPSIS setdcl -d domain_id -s policy=value setdcl -d domain_id -s option=value lsb [ lsb...] setdcl -d domain_id -a lsb=xsb [ lsb=xsb...] setdcl -d domain_id -r lsb [ lsb...] setdcl -h DESCRIPTION The setdcl(8) command sets a domain component list (DCL).
  • Page 164 setdcl(8) Whether to set a priority for the specified LSB as a floating board, relative to ■ other boards (float) The user can specify whether to set a priority for the specified LSB as a floating board, relative to other boards. A floating board is used for dynamic reconfiguration (DR) for purposes such as changing the domain configuration, while minimizing effect of DR on the operating system.
  • Page 165 setdcl(8) Clears the XSB number associated with an LSB number in the specified domain. -s option=value Makes settings regarding hardware resources of the XSB associated with an LSB. An item to be set is specified for option, and a value corresponding to option is specified for value. option and value are specified only once in a format using an equal sign (=) to delimit the specified values.
  • Page 166 setdcl(8) Clears the XSB number associated with an LSB number in the specified domain. -s option=value Makes settings regarding hardware resources of the XSB associated with an LSB. An item to be set is specified for option, and a value corresponding to option is specified for value. option and value are specified only once in a format using an equal sign (=) to delimit the specified values.
  • Page 167 setdcl(8) If no-io is specified for option, either of the following can be specified for value: Omits the use of I/O devices on a domain. true Does not omit the use of I/O devices on a false domain (default). If float is specified for option, either of the following can be specified for value: Gives a higher priority regarding floating true...
  • Page 168 setdcl(8) Clear the XSBs associated with LSB#00 and #01 of domain ID 0. EXAMPLE 4 setdcl -d 0 -r 00 01 XSCF> EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO addboard(8), deleteboard(8), moveboard(8), setupfru(8), showboards(8), showdcl(8), showdevices(8), showfru(8) XSCF Reference Manual •...
  • Page 169 setdomainmode(8) NAME setdomainmode - set a domain mode SYNOPSIS setdomainmode [ [-q] -{y|n}] -d domain_id -m function=mode setdomainmode -h DESCRIPTION setdomainmode(8) sets a domain mode for the specified domain. The domain mode of each domain can be set. The domain mode includes the following settings: OpenBoot PROM diagnostic levels (Diagnostics Level) ■...
  • Page 170 setdomainmode(8) OPTIONS The following options are supported: -d domain_id Specifies the domain ID to be set. domain_id can be 0–23 depending on the system configuration. Displays usage statement. When used with other options or operands, an error occurs. -m function=mode Sets the domain mode and specifies its values. Use function to set the domain mode.
  • Page 171 setdomainmode(8) When the OpenBoot PROM environmental variable 'auto-boot?' has been set ■ to false, the auto boot function is disabled. value specified with '-m diag' is applied to the diag level of the addboard(8) ■ command and moveboard(8) command. The settings of the current domain mode can be checked by using the ■...
  • Page 172 setdomainmode(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO showdomainmode(8) XSCF Reference Manual • Last Revised June 2007...
  • Page 173 setdomparam(8) NAME setdomparam - forcibly rewrite OpenBoot PROM environment variables SYNOPSIS setdomparam [ [-q] -{y|n}] -d domain_id use-nvramrc setdomparam [ [-q] -{y|n}] -d domain_id security-mode setdomparam [ [-q] -{y|n}] -d domain_id set-defaults setdomparam -h DESCRIPTION The setdomparam(8) command rewrites OpenBoot PROM environment variables. This command can rewrite variables of a specified domain or all the domains.
  • Page 174 setdomparam(8) OPERANDS The following operands are supported: Sets false for theuse-nvramrc? environment variable. use-nvramrc security-mode Sets none to the security-mode? environment variable. Restores the OpenBoot PROM environment variables to the set-defaults settings at the time of shipment from the factory EXTENDED When the command is executed, a prompt to confirm execution of the command DESCRIPTION...
  • Page 175 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 176 setdscp(8) Note – The -y and -n options can be used (with or without the -q option) when running setdscp in interactive mode. Privileges You must have platadm or fieldeng privileges to run this command. Refer to setprivileges(8) for more information. OPTIONS The following options are supported: -d domain_id...
  • Page 177 setdscp(8) Assigning All DSCP Addresses EXAMPLE 1 setdscp -y -i 10.1.1.0 -m 255.255.255.0 XSCF> Commit these changes to the database? [y|n] : y Assigning an Alternative IP address to Domain 1 EXAMPLE 2 setdscp -d 1 -i 10.1.1.26 XSCF> Commit these changes to the database? [y|n] : Specifying a Netmask Address With -q and -y Options EXAMPLE 3 setdscp -q -y -i 10.1.1.0 -m 255.255.255.0...
  • Page 178 setdscp(8) EXIT STATUS The following exit values are returned: Successful completion. >0 An error occurred. SEE ALSO showdscp(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 179 setdualpowerfeed(8) NAME setdualpowerfeed - set dual power feed mode SYNOPSIS setdualpowerfeed -s key setdualpowerfeed -h DESCRIPTION The setdualpowerfeed(8) command specifies dual power feed mode in the system. The setdualpowerfeed(8) command is valid in a midrange server only. In a high- end server, when the power cabinet for dual power feed connected, it automatically configures the dual power feed mode.
  • Page 180 setdualpowerfeed(8) Enables dual power feed mode in the system. Before rebooting the system, EXAMPLE 2 a message is displayed. setdualpowerfeed -s enable XSCF> disable -> enable NOTE: Dual power feed will be enabled the next time the platform is powered EXIT STATUS The following exit values are returned: Successful completion.
  • Page 181 setemailreport(8) NAME setemailreport - set up the email report configuration data SYNOPSIS setemailreport [-v] [-t] setemailreport [-s variable= value]... setemailreport -h DESCRIPTION setemailreport(8) sets up email reporting configuration data for remote maintenance. Once the configuration data is set up, it is used by the fault management daemon to send email reports as required.
  • Page 182 setemailreport(8) OPTIONS The following options are supported: Displays usage statement. When used with other options or operands, an error occurs. -s variable=value Configures email reporting. Valid entries for variable are: enable recipient Valid value entries for enable are: Valid value entries for recipient are: Any valid company email account Sends test email.
  • Page 183 setemailreport(8) Sending Test Email EXAMPLE 5 setemailreport -t XSCF> ..Sending test email to useradm@company.com [Email contents shown below] Host Name: jupiter Send Timestamp: 04-20-2006 16:31:45 PST Mail Server: 10.4.1.1 EXIT STATUS The following exit values are returned: Successful completion. >0 An error occurred.
  • Page 184 setemailreport(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 185 sethostname(8) NAME sethostname - set a host name and a DNS domain name for an XSCF unit SYNOPSIS sethostname xscfu hostname sethostname -d domainname sethostname -h DESCRIPTION sethostname(8) command sets a host name and a DNS domain name for an XSCF unit.
  • Page 186 sethostname(8) EXTENDED To reflect the host name and the DNS domain name to XSCF, execute the ■ DESCRIPTION applynetwork(8) command. After reflected the information, use the rebootxscf(8) command to reset XSCF to complete the setting. To enable the set host name and DNS domain name, execute the ■...
  • Page 187 sethttps(8) NAME sethttps - start or stop the HTTPS service, which is used in the XSCF network. This command also performs authentication-related settings SYNOPSIS sethttps [ [-q] -{y|n}] -c enable sethttps -c disable sethttps -c gencsr country state | province locality organization organizationalunit common e-mail sethttps [ [-q] -{y|n}] -c genserverkey sethttps -c importca...
  • Page 188 sethttps(8) OPTIONS The following options are supported: -c {enable|disable} Specify whether to enable the HTTPS service. One of the following values can be specified. If none of them is specified, an error occurs. Starts the HTTPS service. enable Stops the HTTPS service. disable Creates a CSR.
  • Page 189 sethttps(8) In case the XSCF unit is duplicated configuration, the setting automatically ■ reflected to the standby XSCF. When there's a defect on the standby XSCF, it leads to an error. When using an external certification authority, it leads to an error in the ■...
  • Page 190 sethttps(8) development, common: scf-host, e-mail: abc@example.com sethttps -c selfsign JP Kanagawa Kawasaki Example XSCF> development scf-host abc@example.com CA key and CA cert already exist. Do you still wish to update? [y|n] : Enter passphrase: Verifying - Enter passphrase: Creates the private key of the web server. EXAMPLE 5 sethttps -c genserverkey XSCF>...
  • Page 191 sethttps(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO showhttps(8) System Administration...
  • Page 192 sethttps(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 193 setldap(8) NAME setldap - configure the Service Processor as a Lightweight Directory Access Protocol (LDAP) client SYNOPSIS setldap {-b bind} {-B baseDN} {-c certchain} {-p } {-s servers} {-t user} -T timeout setldap -h DESCRIPTION setldap(8) allows you to configure the Service Processor as an LDAP client. Note –...
  • Page 194 setldap(8) -s servers Sets the primary and secondary LDAP servers and ports. servers is a comma-separated list of server:port. Ports are specified numerically and servers can be specified either by name or IP address in the dotted decimal format. For example, 10.8.31.14.636,company:636.
  • Page 195 setldap(8) Setting the LDAP Server EXAMPLE 4 setldap -s ldap://company.com,ldaps://company2.com XSCF> showldap XSCF> user Bind Name: Base Distinguished Name: ou=people,dc=company,dc=com LDAP Search Timeout: Bind Password: LDAP Servers: ldap://company.com:389 ldaps://company2.com:636 CERTS: None Importing a Certificate EXAMPLE 5 setldap -c user@remote.machine:/path/to/cacert.pem XSCF> showldap XSCF>...
  • Page 196 setldap(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 197 setlocale(8) NAME setlocale - set the default locale of the XSCF SYNOPSIS setlocale -s locale setlocale -h DESCRIPTION The setlocale(8) command sets the default locale of the XSCF. The locale that can be set is English or Japanese. You must have platadm privileges to run this command. Privileges Refer to setprivileges(8) for more information.
  • Page 198 setlocale(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 199 setlocator(8) NAME setlocator - control the blinking of the CHECK LED on the operator panel SYNOPSIS setlocator value setlocator -h DESCRIPTION setlocator(8) command controls the blink state of the CHECK LED on the operator panel. The following states can be set: Start blinking Makes the CHECK LED blink.
  • Page 200 setlocator(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO showlocator(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 201 setlookup(8) NAME setlookup - enable or disable the use of the Lightweight Directory Access Protocol (LDAP) server for authentication and privilege lookup SYNOPSIS setlookup -a {local|ldap} setlookup -p {local|ldap} setlookup -h setlookup(8) sets whether authentication and privileges data are looked up in DESCRIPTION LDAP or not.
  • Page 202 setlookup(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 203 setnameserver(8) NAME setnameserver - set the domain name system (DNS) servers used in the XSCF network SYNOPSIS setnameserver [-c add] address ... setnameserver -c del address ... setnameserver -c del -a setnameserver -h DESCRIPTION setnameserver(8) command specifies the DNS servers used in the XSCF network. Up to three DNS servers can be registered for XSCF.
  • Page 204 setnameserver(8) EXTENDED If multiple DNS servers are specified, names are solved in the order specified. ■ DESCRIPTION To reflect the DNS server name to XSCF, execute the applynetwork(8) command. ■ After reflected the information, use the rebootxscf(8) command to reset XSCF to complete the setting.
  • Page 205 setnetwork(8) NAME setnetwork - configure a network interface using by XSCF SYNOPSIS setnetwork [-m addr] interface address setnetwork -c {up | down} interface setnetwork -h DESCRIPTION setnetwork(8) command configures a network interface using by XSCF. The following settings can be made for the specified network interface: Whether to enable or disable the network interface.
  • Page 206 setnetwork(8) OPERANDS The following operands are supported: XSCF Reference Manual • Last Revised June 2007...
  • Page 207 setnetwork(8) address Specifies an IP address. The specified value is a set of four integer values delimited by the period (.). The following address form is accepted: xxx.xxx.xxx.xxx An integer from 0–255. Zero suppression can be used to specify the integer. interface Specifies the network interface to be configured.
  • Page 208 setnetwork(8) EXTENDED When the XSCF unit is duplicated configuration in the high-end server, a ■ DESCRIPTION takeover IP address can be used without a need 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 209 setnetwork(8) Sets the IP address 192.168.10.128 on ISN on the XSCF unit 0. By default, EXAMPLE 4 255.255.255.0 is set for the net mask. setnetwork xscf#0-if 192.168.10.128 XSCF> Sets the IP address 192.168.11.10 and net mask 255.255.255.0 for XSCF- EXAMPLE 5 LAN#0 on XSCF unit 1.
  • Page 210 setnetwork(8) XSCF Reference Manual • Last Revised June 2007...
  • Page 211 setntp(8) NAME setntp - set the NTP information for XSCF SYNOPSIS setntp [-c add] address ... setntp -c del address ... setntp -c del -a setntp -c stratum -i stratum_no setntp -h DESCRIPTION setntp(8) command sets the NTP information for XSCF. The setntp(8) command can specify the following information: In case XSCF is regarded as the NTP client: ■...
  • Page 212 setntp(8) Sets the stratum value in case you regard XSCF as an NTP -c stratum server. Displays usage statement. When used with other options or operands, an error occurs. -i stratum_no Specifies the stratum value. This option is used together with the "-c stratum".
  • Page 213 setntp(8) and 10.24.1.2. setntp 192.168.1.2 10.18.108.10 10.24.1.2 XSCF> Please reset the XSCF by rebootxscf to apply the ntp settings. Deletes the NTP server 10.18.108.10. EXAMPLE 2 setntp -c del 10.18.108.10 XSCF> Please reset the XSCF by rebootxscf to apply the ntp settings. Adds the two NTP servers ntp1.examples.com and ntp2.example.com.
  • Page 214 setntp(8) XSCF Reference Manual • Last Revised November 2007...
  • Page 215 setpasswordpolicy(8) NAME setpasswordpolicy - manage the system password policy SYNOPSIS setpasswordpolicy [-d dcredit] [ -e expiry] [-i inactive] [-k difok] [-l lcredit] [ -M maxdays] [-m minlen] [-n mindays] [-o ocredit] [-r remember] [-u ucredit] [-w warn] [-y retry] setpasswordpolicy -h DESCRIPTION setpasswordpolicy(8) allows an administrator to change the the system password policy.
  • Page 216 setpasswordpolicy(8) -k difok Sets the minimum number of new characters (characters which were not present in the old password) that a new password must contain. The initial setting is 3. Valid values are integers with value of zero or greater. -l lcredit Sets the maximum credit for lower case letters in a password.
  • Page 217 setpasswordpolicy(8) -u ucredit Sets the maximum credit for uppercase letters in a password. The minimum acceptable password length is decreased by one for each digit in the password, up to ucredit digits. The initial setting is 1. -w warn Sets the default number of days before password expiration at which to start warning the user.
  • Page 218 setpasswordpolicy(8) XSCF Reference Manual • Last Revised November 2007...
  • Page 219 setpowerupdelay(8) NAME setpowerupdelay - set the warm-up time of the system and wait time before system startup SYNOPSIS setpowerupdelay -c warmup -s time setpowerupdelay -c wait -s time setpowerupdelay -h The setpowerupdelay(8) command sets the warm-up time of the system and wait DESCRIPTION time before system startup.
  • Page 220 setpowerupdelay(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO showpowerupdelay(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 221 setprivileges(8) NAME setprivileges - assign user privileges SYNOPSIS setprivileges user [ privileges] [ domainprivilege@ domains] setprivileges -h DESCRIPTION setprivileges(8) assigns privileges to an XSCF user. setprivileges modifies only local privileges data. Multiple privileges are separated by one or more spaces. There is a maximum of 100 users to whom privileges can be assigned.
  • Page 222 setprivileges(8) OPERANDS The following operands are supported: domainprivilege@domains Specifies domainadm, domainmgr, or domainop privileges for a specific domain or domains. The following are valid values for domainprivilege, each of which must be used with @domains: Can perform all operations and view status on the domainadm hardware assigned to the domains on which this privilege is held (assign, unassign, power, and so on).
  • Page 223 setprivileges(8) The following are valid values for privileges: Can configure auditing. Can delete audit trail. auditadm Can view all audit state and audit trail. auditop Can perform all operations reserved for field engineers fieldeng and authorized service personnel. Cannot perform any operations on the Service none Processor that require privilege, even if privileges are set for the user in LDAP.
  • Page 224 setprivileges(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 225 setroute(8) NAME setroute - set routing information for an XSCF network interface SYNOPSIS setroute -c {add | del} -n address [-m address] [-g address] interface setroute -h DESCRIPTION setroute(8) command sets routing information for an XSCF network interface. Up to eight routing information items can be registered for each network interface. Any attempt to register more than eight items causes an error.
  • Page 226 setroute(8) Displays usage statement. When used with other options or operands, an error occurs. -m address Specifies the netmask to which routing information is forwarded. The specified value is a set of four integer values delimited by the period (.). The following address form is accepted: xxx.xxx.xxx.xxx An integer from 0–255.
  • Page 227 setroute(8) OPERANDS The following operand is supported: interface Specifies the network interface to be set with routing information. One of the following values can be specified: For midrange server: ■ For XSCF unit 0: XSCF-LAN#0 xscf#0-lan#0 XSCF-LAN#1 xscf#0-lan#1 For abbreviation: XSCF-LAN#0 lan#0 XSCF-LAN#1...
  • Page 228 setroute(8) Deletes the routing of destination 192.168.1.0 and default net mask EXAMPLE 4 (255.255.255.0) from XSCF-LAN#1 on XSCF unit 0. setroute -c del -n 192.168.1.0 -m 255.255.255.0 xscf#0-lan#1 XSCF> Adds the routing of destination 192.168.1. 4 for XSCF-LAN#1 on XSCF unit 0. EXAMPLE 5 setroute -c add -n 192.168.1.4 xscf#0-lan#1 XSCF>...
  • Page 229 setshutdowndelay(8) NAME setshutdowndelay - set the shutdown wait time at power interruption of the uninterruptible power supply (UPS) SYNOPSIS setshutdowndelay -s time setshutdowndelay -h DESCRIPTION The setshutdowndelay(8) command sets the wait time before the start of system shutdown for when power interruption occurs in a system connected to the UPS. The start of system shutdown can be delayed until the specified time.
  • Page 230 setshutdowndelay(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 231 setsmtp(8) NAME setsmtp - set up the SMTP settings SYNOPSIS setsmtp [-v] setsmtp [-s variable= value]... setsmtp -h DESCRIPTION setsmtp(8) sets up the SMTP configuration values. When used without options, you will be prompted to provide the name of the SMTP email server to be used.
  • Page 232 setsmtp(8) OPTIONS The following options are supported: Displays usage statement. When used with other options or operands, an error occurs. -s variable=value Sets SMTP. Valid entries for variable are: mailserver port auth user password replyaddress Where: auth is the authentication mechanism. user/password are the smtp mail server authentication.
  • Page 233 setsmtp(8) Setting Up Mailserver With Invalid Authentication Mechanism 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]: EXIT STATUS The following exit values are returned: Successful completion.
  • Page 234 setsmtp(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 235 setsnmp(8) NAME setsnmp - manage the SNMP agent SYNOPSIS setsnmp enable [ mib_name] setsnmp disable [ mib_name] setsnmp addtraphost -t type -s community-string [-p trap-port] traphost setsnmp remtraphost -t type traphost setsnmp addv3traphost -u username -r authentication-protocol {-n engine_id|-i} [ -a authentication-password] [ -e encryption-password] [-p trap-port ] traphost setsnmp remv3traphost -u username traphost setsnmp enablev1v2c read-only-community-string...
  • Page 236 setsnmp(8) OPERANDS The following operands are supported: Enables the SNMP agent to send the chosen type of trap to the addtraphost desired host. If no trap-port is provided, the default is 162. A community string is mandatory. addtraphost takes the following options and operand: -p trap-port ID of the trap port.
  • Page 237 setsnmp(8) addv3traphost Enables the SNMP agent to send SNMPv3 traps or informs to the desired host. An authentication protocol must be chosen. Valid protocols are: MD5 = Uses the MD5 algorithm for authentication SHA = Uses SHA (Secure Hash Algorithm) for authentication The encryption protocol used in all communication is DES (Data Encryption Standard).
  • Page 238 setsnmp(8) When used alone, stops the SNMP agent. disable When used with the value ALL for the optional mib_name, stops the SNMP agent. When used with a value other than ALL for the optional mib_name, removes support for the targeted MIB module. If support remains for another MIB module, the SNMP agent remains enabled.
  • Page 239 setsnmp(8) Disables the SNMP agent from sending the chosen type of trap remtraphost to the desired host. -t type Type of trap. Valid trap types are: v1 = The agent will send SNMPv1 traps v2 = The agent will send SNMPv2 traps inform = The agent will send inform notifications traphost Host name of the trap host.
  • Page 240 setsnmp(8) SEE ALSO showsnmp(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 241 setsnmpusm(8) NAME setsnmpusm - specify the SNMPv3 agent’s User-based Security Model (USM) configuration SYNOPSIS setsnmpusm create -a authentication_protocol [-p authentication_password] [ -e encyrption_password] user setsnmpusm delete user setsnmpusm clone -u clone_user user setsnmpusm passwd [-c { auth|encrypt}] [ -o old_password] [ -n new_password] user setsnmpusm -h DESCRIPTION...
  • Page 242 setsnmpusm(8) OPERANDS The following operands are supported: Makes the supplied user known to the agent for subsequent clone SNMP communication with the identical settings as the specified clone_user. -u clone_user Specifies a valid user name of the user settings to be cloned. user Specifies a different user name for the clone of clone_user.
  • Page 243 setsnmpusm(8) Makes the supplied user known to the agent for subsequent create SNMP communication. When used without the -a or -p options, create displays a prompt for passwords and reads them without echoing them to the screen. The encryption protocol used in all SNMP communication is Data Encryption Standard (DES).
  • Page 244 setsnmpusm(8) EXAMPLES Adding a User With Password Options EXAMPLE 1 setsnmpusm create -a SHA -p xxxxxxxx -e yyyyyyyy jsmith XSCF> Adding a User Without Specifying Password Options EXAMPLE 2 setsnmpusm create -a SHA bob XSCF> Authetication Password: Encryption Password: Cloning a User EXAMPLE 3 setsnmpusm clone -u sue joe XSCF>...
  • Page 245 setsnmpvacm(8) NAME setsnmpvacm - modify the SNMPv3 agent’s View-based Access Control Model (VACM) configuration SYNOPSIS setsnmpvacm creategroup -u username groupname setsnmpvacm deletegroup -u username groupname setsnmpvacm createview -s OID_subtree [-e] [-m OID_Mask] viewname setsnmpvacm deleteview -s OID_subtree viewname setsnmpvacm createaccess -r read_viewname groupname setsnmpvacm deleteaccess groupname setsnmpvacm -h DESCRIPTION...
  • Page 246 setsnmpvacm(8) OPERANDS The following operands are supported: createaccess Sets access to a MIB view for the specified group. -r read_viewname Specifies an SNMP Agent view. groupname Specifies a valid group name. Sets up a group for the specified user for view access. creategroup -u username Specifies a valid user name.
  • Page 247 setsnmpvacm(8) Create a View of the Entire MIB EXAMPLE 2 setsnmpvacm createview -s .1 all_view XSCF> Create a View Where the Subtree Is Excluded EXAMPLE 3 setsnmpvacm createview -e -s .1.3.6.1.2.1.1 -m fe excl_view XSCF> Create Access EXAMPLE 4 setsnmpvacm createaccess -r all admin XSCF>...
  • Page 248 setsnmpvacm(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 249 setssh(8) NAME setssh - set the SSH service used in the XSCF network. Also, generate the host public key, and register or delete the user public key, which are necessary for the SSH service. SYNOPSIS setssh [ [-q] -{y|n}] -c enable setssh -c disable setssh -c addpubkey [-u user_name] setssh -c delpubkey {-a | -s line } [-u user_name]...
  • Page 250 setssh(8) -c {enable|disable} Specifies whether to enable the SSH service. One of the following values can be specified: Starts the SSH2 service. enable Stops the SSH2 service. disable Generates a host public key for SSH2. -c genhostkey Displays usage statement. When used with other options or operands, an error occurs.
  • Page 251 setssh(8) EXAMPLES Starts the SSH service. EXAMPLE 1 setssh -c enable XSCF> Continue? [y|n] : Please reset the XSCF by rebootxscf to apply the ssh settings. Starts the SSH service. Automatically replies with 'y' to the prompt. EXAMPLE 2 setssh -y -c enable XSCF>...
  • Page 252 setssh(8) Registers the user public key by specifying the user name. Finish the input EXAMPLE 9 of public key by pressing Enter and then pressing Ctrl+D. setssh -c addpubkey -u efgh XSCF> Please input a public key: ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAzFh95SohrDgpnN7zFCJCVNy+jaZPTjNDxcid QGbihYDCBttI4151Y0Sv85FJwDpSNHNKoVLMYLjtBmUMPbGgGVB61qskSv/ FeV44hefNCZMiXGItIIpK P0nBK4XJpCFoFbPXNUHDw1rTD9icD5U/wRFGSRRxFI+Ub5oLRxN8+A8=abcd@example.com [Enter]...
  • Page 253 settelnet(8) NAME settelnet - start or stop the Telnet service used in the XSCF network SYNOPSIS settelnet -c {enable | disable} settelnet -h DESCRIPTION settelnet(8) command starts or stops the Telnet service used in the XSCF network. Privileges You must have platadm privileges to run this command. Refer to setprivileges(8) for more information.
  • Page 254 settelnet(8) SEE ALSO rebootxscf(8), showtelnet(8) XSCF Reference Manual • Last Revised June 2007...
  • Page 255 settimezone(8) NAME settimezone - set the time zone and Daylight Saving Time of XSCF SYNOPSIS settimezone -c settz -s timezone settimezone -c settz -a [-M] settimezone -c adddst -b std -o offset -d dst [-p offset] -f date [ /time] -t date [ /time] settimezone -c deldst -b std -o offset settimezone -h...
  • Page 256 settimezone(8) -f date [/time] Specifies the starting time of Daylight Saving Time. You can specify date in any of the following formats. Mm.w.d Mm: Specifies the month to start Daylight Saving Time. For m, you can specify any integer from 1 to 12. w: Specifies the week to start Daylight Saving Time.
  • Page 257 settimezone(8) -f date [/time] Specifies the starting time of Daylight Saving Time. You can specify date in any of the following formats. Mm.w.d Mm: Specifies the month to start Daylight Saving Time. For m, you can specify any integer from 1 to 12. w: Specifies the week to start Daylight Saving Time.
  • Page 258 settimezone(8) -o offset Specifies the offset of time zone and Greenwich mean time (GMT). You can specify offset in the following format. GMT{+|–}hh[:mm[:ss]] Greenwich mean time {+|–} Specifies "–" to set the standard time to the time which is ahead of GMT. (To adjust to the local time east to Greenwich, the offset is a negative value.)Specifies "+"...
  • Page 259 settimezone(8) -p offset Specifies the offset of Daylight Saving Time and Greenwich mean time (GMT). You can specify offset in the following format. In case omitted, it is 1 hour before the specified time. GMT{+|–}hh[:mm[:ss]] Greenwich mean time {+|–} Specifies "–" to set the standard time to the time which is ahead of GMT.
  • Page 260 settimezone(8) -t date [/time] Specifies the termination time of Daylight Saving Time. You can specify date in any of the following formats. Mm.w.d Mm: Specifies the month to terminate Daylight Saving Time. For m, you can specify any integer from 1 to 12. w: Specifies the week to terminate Daylight Saving Time.
  • Page 261 settimezone(8) Lists the time zones that can be set. EXAMPLE 2 settimezone -c settz -a XSCF> Africa/Abidjan Africa/Accra Africa/Addis_Ababa Africa/Algiers Africa/Asmera Africa/Bamako Africa/Bangui Sets the Daylight Saving Time information as follows: abbreviation of time EXAMPLE 3 zone is JST, the offset from GMT is +9, the name of Daylight Saving Time is JDT, Daylight Saving Time is 1 hour ahead, and the time period is from the last Monday of March 2:00 to the last Sunday of October 2:00.
  • Page 262 settimezone(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 263 setupfru(8) NAME setupfru - set up device hardware SYNOPSIS setupfru [-m {y | n}] [-x {1 | 4}] device location setupfru -h DESCRIPTION The setupfru(8) command makes hardware settings for the specified device. 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: XSB type To use an added PSB in the system, hardware resources...
  • Page 264 setupfru(8) OPERANDS The following operands are supported: device Specifies the device to be set up. Only the following device can be specified: Physical system board (PSB) location Specifies the location of the device. Integer from 0–15. Specify only one location. EXTENDED In a high-end server, the Quad-XSB configuration cannot be set in memory ■...
  • Page 265 Specifies verbose output. EXTENDED The available interfaces on the SPARC Enterprise M4000/M5000 servers are xscf#0- DESCRIPTION lan#0, xscf#0-lan#1, lan#0, lan#1. The available interfaces on the SPARC Enterprise M8000/M9000 servers are the same but they also include the xscf#0-if, xscf#1-lan#0, xscf#1-lan#1, and xscf#1-if.
  • Page 266: Domain Name Service

    setupplatform(8) XSCF Network Settings ■ Internal DSCP Network ■ Domain Name Service ■ Network Time Protocol ■ ■ HTTPS Server ■ Email reports ■ EXAMPLES Creating a New User. EXAMPLE 1 setplatform -p user XSCF> Do you want to set up an account? [y|n]: myadminuser Username: User id in range 100 to 65533 or leave blank to let the system...
  • Page 267: Setting The Time Zone

    setupplatform(8) Configuring the Altitude. EXAMPLE 4 setplatform -p altitude XSCF> Do you want to set up the chassis altitude? [y|n]: Chassis altitude is already configured: Chassis altitude in meters: 200 Continue setting up the chassis altitude? [y|n]: Chassis altitude in meters: 400 Chassis altitude in meters: 400 Is this setting correct? [y|n]: XSCF>...
  • Page 268 setupplatform(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO adduser(8), applynetwork(8), password(8), setaltitude(8), setdscp(8), setemailreport(8), sethostname(8), sethttps(8), setnameserver(8), setnetwork(8), setntp(8), setprivileges(8), setsmtp(8), setssh(8), setroute(8), settimezone(8) XSCF Reference Manual • Last Revised November 2007...
  • Page 269 showaltitude(8) NAME showaltitude - display the altitude state of the system SYNOPSIS showaltitude showaltitude -h DESCRIPTION The showaltitude(8) command displays the current settings for the altitude state of the system. The displayed altitude value is a multiple of 100 meters. You must have platadm or fieldeng privileges to run this command.
  • Page 270 showaltitude(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 271 showarchiving(8) NAME showarchiving - display log archiving configuration and status SYNOPSIS showarchiving showarchiving [-e] [-v] showarchiving -h DESCRIPTION showarchiving(8) displays the status and configuration information for log archiving on the Service Processor. You must have platadm, platop or fieldeng privileges to run this command. Privileges Refer to setprivileges(8) for more information.
  • Page 272 showarchiving(8) User name which the Service Processor uses to Username for ssh login login to the archive host. Initial value is Not configured. The public key which the Service Processor Archive host public key uses to verify the identity of the archive host. This field is not displayed unless the -v option is specified.
  • Page 273 showarchiving(8) EXAMPLES Viewing Status and Configuration Data EXAMPLE 1 showarchiving XSCF> *** Archiving Configuration *** Archiving state ---------- Disabled Archive host ------------- Not configured Archive directory -------- Not configured User name for ssh login -- Not configured Archive host fingerprint - Server authentication disabled *** Connection to Archive Host *** Latest communication ----- None Connection status -------- None...
  • Page 274 showarchiving(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 275 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 276 showaudit(8) OPTIONS The following options are supported: -a users Displays the audit record generation policy for the specified users. users is a comma-separated list of valid user names. -c classes Displays the audit record generation policy for the specified audit classes.
  • Page 277 showaudit(8) Displays the policy to follow when the audit trail reaches full capacity. Displays the following auditing states: Space consumed by local audit records ■ Free space remaining for local audit records ■ Number of audit records dropped (since the last boot) since the ■...
  • Page 278 showaudit(8) AEV_LOGIN_SSH enabled AEV_LOGIN_TELNET enabled AEV_LOGOUT enabled AEV_AUTHENTICATE enabled AEV_addboard enabled AEV_addcodlicense enabled AEV_addfru enabled [...] EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO setaudit(8), viewaudit(8) XSCF Reference Manual • Last Revised June 2007...
  • Page 279 showautologout(8) NAME showautologout - display the session timeout time of the XSCF shell SYNOPSIS showautologout showautologout -h DESCRIPTION The showautologout(8) command displays the session timeout time of the XSCF shell. The session timeout time is displayed in units of minutes. If the session timeout time has not been specified with the setautologout(8) command, a time of 10 minutes is set by default.
  • Page 280 showautologout(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 281 showboards(8) NAME showboards - display information on an extended system board (XSB) SYNOPSIS showboards [-v] -a [-c sp] showboards [-v] -d domain_id [-c sp] showboards [-v] xsb showboards -h DESCRIPTION The showboards(8) command displays information on XSBs. This command displays information on XSBs currently configured in or assigned to a domain and information on all mounted XSBs.
  • Page 282 showboards(8) Power status of the XSB Power is off. Power is on. Status of the XSB connection to the domain configuration Conn The XSB is not connected to the domain, or it is located in the system board pool. The XSB is connected to the domain. Incorporation state of XSB hardware resources into the operating Conf system...
  • Page 283 showboards(8) You must have one of the following privileges to run this command: Privileges platadm, platop, fieldeng Can execute the command for all domains. domainadm, domainmgr, domainop Can execute the command only for accessible domains. Refer to setprivileges(8) for more information. The following options are supported: OPTIONS Displays the state of XSBs configured in or assigned to a domain...
  • Page 284 showboards(8) Displays detailed information on all mounted system boards. EXAMPLE 2 showboards -v -a XSCF> R DID(LSB) Assignment Conn Conf Test Fault ---- - -------- ----------- ---- ---- ---- ------- -------- --- 00-0 00(00) Assigned Passed Normal 00-1 * 00(01) Assigned Passed Normal...
  • Page 285 showcod(8) NAME showcod - display Capacity on Demand (COD) configuration information SYNOPSIS showcod [-v] [-d domain_id] showcod -h DESCRIPTION showcod(8) displays the COD information which includes the headroom amount, number of installed COD right-to-use (RTU) licenses, the number of COD RTU licenses reserved for domains, and the Chassis Hostid.
  • Page 286 showcod(8) Displaying All COD Information EXAMPLE 2 The output shown is what you would see if you had platform privileges. showcod XSCF> Chassis HostID : 81000001 PROC RTUs installed : 8 PROC Headroom Quantity : 0 PROC RTUs reserved for domain 0 : 4 PROC RTUs reserved for domain 1 : 0 PROC RTUs reserved for domain 2 : 0 PROC RTUs reserved for domain 3 : 0...
  • Page 287 showcodlicense(8) NAME showcodlicense - display the current Capacity on Demand (COD) right-to-use (RTU) licenses stored in the COD license database SYNOPSIS showcodlicense [-r] [-v] showcodlicense -h DESCRIPTION showcodlicense(8) displays COD license information stored in the COD license database. When used without options it displays the current licenses. You must have platadm or platop privileges to run this command.
  • Page 288 showcodlicense(8) Displaying Raw License Data EXAMPLE 2 showcodlicense -r XSCF> 01:84000000:104:0301010100:3:00000000:xxxxxxxxxxxxxxx EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO addcodlicense(8), deletecodlicense(8), showcodusage(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 289 showcodusage(8) NAME showcodusage - display the current usage statistics for Capacity on Demand (COD) resources SYNOPSIS showcodusage [-v] [-M] [-p resource|domain|all ] showcodusage -h DESCRIPTION showcodusage(8) shows current information about COD right-to-use (RTU) licenses in use. By default, this command displays a summary of COD RTU licenses used and installed, along with the current state of each resource.
  • Page 290 showcodusage(8) EXTENDED The showcodusage -p resource command displays the following COD usage DESCRIPTION information for the system: Identifies the type of COD resources available (processors). Resource Specifies the number of COD CPUs currently used in the In Use system. Specifies the number of COD CPUs installed in the system. Installed Specifies the number of COD RTU licenses installed.
  • Page 291 showcodusage(8) Specifies the number of COD CPU resources installed in the Installed domain. Specifies the number of COD RTU licenses allocated to the Reserved domain. Contains one of the following when the -v option is specified: Status The domain COD CPU has a COD RTU Licensed license and is in use.
  • Page 292 showcodusage(8) Displaying COD Usage by Resource and Domain: M8000 Server With EXAMPLE 3 CMU00 Quad-XSB, CMU02 Uni-XSB showcodusage -v XSCF> Resource In Use Installed Licensed Status -------- ------ --------- -------- ------ PROC OK: 0 available Headroom: 2 Domain/Resource In Use Installed Reserved Status...
  • Page 293 showcodusage(8) EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO addcodlicense(8), deletecodlicense(8), showcodlicense(8) System Administration...
  • Page 294 showcodusage(8) XSCF Reference Manual • Last Revised June 2007...
  • Page 295 showconsolepath(8) NAME showconsolepath - displays information on the domain console that is currently connected SYNOPSIS showconsolepath -a showconsolepath -d domain_id showconsolepath -h The showconsolepath(8) command displays information on the domain console DESCRIPTION that is currently connected. The following information can be displayed: User account of the XSCF connected to the domain console User Domain ID...
  • Page 296 showconsolepath(8) EXTENDED Only one writable console and one or more read-only consoles can be connected to DESCRIPTION one domain. EXAMPLES Displays console information on all domains that can be accessed. EXAMPLE 1 showconsolepath -a XSCF> User ro/rw escape Date nakagawa Fri Jul 29 21:23:34 hana Fri Jul 29 09:49:12...
  • Page 297 showdate(8) NAME showdate - display the date and time of XSCF SYNOPSIS showdate [-u] showdate -h DESCRIPTION The showdate(8) command displays the date and time of XSCF. If showdate(8) command is executed with no options, date and time currently set is displayed.
  • Page 298 showdate(8) Displays the current time in UTC. EXAMPLE 2 showdate -u XSCF> Mon Jan 23 05:56:15 UTC 2006 EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO setdate(8), settimezone(8), showtimezone(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 299 showdcl(8) NAME showdcl - display the current domain component list (DCL) SYNOPSIS showdcl [-v] -a showdcl [-v] -d domain_id [-l lsb...] showdcl -h DESCRIPTION The showdcl(8) command displays the DCL that has been set by the setdcl(8) command. The DCL is hardware resource information that can be set for a domain or the logical system boards (LSBs) that are components of a domain.
  • Page 300 showdcl(8) The showdcl(8) command can display the following information that is part of a domain component list: Domain ID LSB number. The displayed number is an integer ranging from 00 to 15. XSB number corresponding to the LSB. The displayed number has the following format: x–y where:...
  • Page 301 showdcl(8) If the -v option is specified, the following information is added: Degradation range applicable for an error detected during an Cfg-policy initial diagnosis of hardware. Any of the following is displayed: Degradation of a component (default) Degradation of an XSB. Degradation of a domain System Whether to omit the use of memory on a domain.
  • Page 302 showdcl(8) OPTIONS The following options are supported:. Displays information that is set for all domains. -d domain_id Specifies the ID of the domain for which information is to be displayed. The domain_id can be 0–23 depending on the system configuration. Displays usage statement.
  • Page 303 showdcl(8) Displays details in the domain component list that is set for domain ID 0. EXAMPLE 2 showdcl -v -d 0 XSCF> Status No-Mem No-IO Float Cfg-policy Running 00-0 False False False 01-0 False True False 02-0 True True True 03-0 True True...
  • Page 304 showdcl(8) Displays details in the domain component lists that are set for all domains. EXAMPLE 3 showdcl -v -a XSCF> Status No-Mem No-IO Float Cfg-policy Running 00-0 False False False 01-0 False True False 02-0 True True True 03-0 True True False ---------------------------------------------------------------...
  • Page 305 showdevices(8) NAME showdevices - display current information on an eXtended System Board (XSB) SYNOPSIS showdevices [-v] [-p bydevice | byboard | query | force] xsb showdevices [-v] [-p bydevice | byboard] -d domain_id showdevices -h DESCRIPTION The showdevices(8) command displays the information of the physical devices configured on XSB and their available resources of these devices.
  • Page 306 showdevices(8) When memory is being disconnected, the following items are displayed: XSB number at the move destination target XSB Size of memory which was already deleted (MB) deleted mem remaining mem Size of remaining memory to be deleted (MB) I/O devices: Instance name of I/O device device Managed resource name...
  • Page 307 showdevices(8) Predicts system resources deleted from the operating system -p force when a system board is forcibly disconnected by "deleteboard -f" command. If the -p option is omitted, "-p bydevice" is used. Predicts system resources deleted from the operating system -p query when a system board is disconnected by deleteboard command.
  • Page 308 showdevices(8) EXAMPLES Displays the information of the physical devices configured on the XSB#00-0 EXAMPLE 1 and their available resources. showdevices 00-0 XSCF> CPU: ---- DID XSB state speed ecache 00-0 40 on-line 2048 00-0 41 on-line 2048 00-0 42 on-line 2048 00-0 43 on-line...
  • Page 309 showdevices(8) Displays detail information of the physical devices and their available re- EXAMPLE 2 sources in domain ID 0. showdevices -v -d 0 XSCF> CPU: ---- DID XSB state speed ecache 00-0 40 on-line 2048 00-0 41 on-line 2048 00-0 42 on-line 2048 00-0 43...
  • Page 310 showdevices(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 311 showdomainmode(8) NAME showdomainmode - display the domain mode SYNOPSIS showdomainmode -d domain_id showdomainmode -h DESCRIPTION showdomainmode(8) command displays the domain mode that is set for the specified domain. The following states are displayed: Host ID HOST-ID Diagnostic Level Displays the OpenBoot PROM diagnostic level. One of the following is displayed: None none...
  • Page 312 showdomainmode(8) EXTENDED If the Mode switch on the operator panel is set to "Service", the settings have ■ DESCRIPTION the following values regardless of the domain mode displayed by the showdomainmode(8) command: Diagnostics Level: operates as the showdomainmode(8) command ■ display Secure Mode: off ■...
  • Page 313 showdomainstatus(8) NAME showdomainstatus - display the current domain component list (DCL) SYNOPSIS showdomainstatus -d domain_id showdomainstatus -a showdomainstatus -h DESCRIPTION The showdomainstatus( ) 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 314 showdomainstatus(8) Can run this command for all domains. domainadm, domainmgr, domainop Can run this command only for your accessible domains. Refer to setprivileges(8) for more information. OPTIONS The following options are supported. Displays status information on all domains that can be accessed. -d domain_id Specifies only one ID of the domain to be displayed.
  • Page 315 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 316 showdscp(8) OPTIONS The following options are supported: -d domain_id Displays an individual domain’s IP address. Displays usage statement. When used with other options or operands, an error occurs. Generates parsable output. Displays the Service Processor’s IP address. Specifies verbose output. Prints additional information about internal progress of the program’s operations to the screen.
  • Page 317 showdscp(8) Displaying a Table of All DSCP IP Addresses EXAMPLE 1 showdscp XSCF> DSCP Configuration Network: 10.1.1.0 Netmask: 255.255.255.0 Location Address ---------- --------- XSCF 10.1.1.1 Domain #00 10.1.1.2 Domain #01 10.1.1.3 Domain #02 10.1.1.4 Domain #03 10.1.1.5 Domain #04 10.1.1.6 Domain #05 10.1.1.7 Domain #06...
  • Page 318 showdscp(8) Displaying All DSCP Address Information In a Parsable Form EXAMPLE 4 showdscp -p XSCF> Network 10.1.1.0 Netmask 255.255.255.0 XSCF 10.1.1.1 Domain[0] 10.1.1.2 Domain[1] 10.1.1.3 Domain[2] 10.1.1.4 Domain[3] 10.1.1.5 Domain[4] 10.1.1.6 Domain[5] 10.1.1.7 Domain[6] 10.1.1.8 Domain[7] 10.1.1.9 Domain[8] 10.1.1.10 Domain[9] 10.1.1.11 EXIT STATUS The following exit values are returned:...
  • Page 319 showdualpowerfeed(8) NAME showdualpowerfeed - display the current setting of dual power feed mode SYNOPSIS showdualpowerfeed showdualpowerfeed -h DESCRIPTION The showdualpowerfeed(8) command displays the current setting of dual power feed mode in the system. The showdualpowerfeed(8) command is valid in a midrange server only. The dual power feed mode can be set by the setdualpowerfeed(8) command.
  • Page 320 showdualpowerfeed(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 321 showemailreport(8) NAME showemailreport - display the email report configuration data SYNOPSIS showemailreport [-v ] showemailreport -h DESCRIPTION showemailreport(8) displays the email reporting configuration data. When used without options, it displays current email report configuration data. Privileges You must have platadm, platop or fieldeng privileges to run this command. Refer to setprivileges(8) for more information.
  • Page 322 showemailreport(8) XSCF Reference Manual • Last Revised June 2007...
  • Page 323 showenvironment(8) NAME showenvironment - display the intake air temperature and humidity, temperature sensor information, voltage sensor information, and fan rotation information about the system SYNOPSIS showenvironment [-M] [ type] showenvironment -h DESCRIPTION showenvironment(8) command displays the information listed below. The following types of the information are displayed: Environment Intake temperature and humidity of the system (humidity only information...
  • Page 324 showenvironment(8) EXTENDED For some systems, voltage margin is set for each entire system. In such a case, the DESCRIPTION voltage margin is displayed along with the value of the voltage sensor. EXAMPLES Displays the intake temperature and humidity of the system. EXAMPLE 1 showenvironment XSCF>...
  • Page 325 showenvironment(8) Displays voltage information about each component. 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 MEMB#0 1.2V Power Supply Group:1.200V 1.8V Power Supply Group:1.700V 2.5V Power Supply Group:2.500V MEMB#1 1.2V Power Supply Group:1.200V...
  • Page 326 showenvironment(8) Displays fan rotation information. EXAMPLE 5 showenvironment Fan XSCF> FAN_A#0:Low speed FAN_A#0: 4101rpm FAN_A#1:Low speed FAN_A#1: 4101rpm FAN_A#2:Low speed FAN_A#2: 4177rpm FAN_A#3:Low speed FAN_A#3: 4101rpm PSU#0 PSU#0:Low speed PSU#0: 3879rpm PSU#0: 3835rpm PSU#1 PSU#1:Low speed PSU#1: 3924rpm PSU#1: 3970rpm PSU#2 PSU#2:Low speed PSU#2:...
  • Page 327 showfru(8) NAME showfru - display the hardware settings of specified device SYNOPSIS showfru device location showfru -a device showfru -h DESCRIPTION The showfru(8) command displays the hardware settings of specified device by the setupfru(8) command. The command can display the settings of the specified device or of all devices. Only the physical system board (PSB) can be specified as a device.
  • Page 328 showfru(8) OPERANDS The following operands are supported: device Specifies the device to display. Currently, only the following device can be specified: Physical system board (PSB) location Specifies the location of device. If the device is ‘sb’, an integer ranging from 00 to 15 can be specified. EXTENDED The setupfru(8) command makes hardware settings for a device.
  • Page 329 showhardconf(8) NAME showhardconf - display information about field replaceable unit (FRU) installed in the system SYNOPSIS showhardconf [-u] [-M] showhardconf -h DESCRIPTION showhardconf(8) command displays information about each FRU. The following information is displayed: Current configuration and status ■ Number of installed FRUs ■...
  • Page 330 showhardconf(8) EXTENDED When the configuration and status information regarding FRUs and domain DESCRIPTION information are displayed, for any failed or degraded unit, an asterisk (*) indicating an abnormal unit is displayed along with any of the following states: Status Description The component is faulty and is not operating Faulted The component is operating.
  • Page 331 showhardconf(8) + Type:1B; Size:1 GB; MEM#1B Status:Normal; + Code:c1000000000000004572T128000HR3.7A 252b-04123b25; + Type:1B; Size:1 GB; MEM#2A Status:Normal; + Code:c1000000000000004572T128000HR3.7A 252b-04123e20; + Type:1B; Size:1 GB; MEM#2B Status:Normal; + Code:c1000000000000004572T128000HR3.7A 252b-04123822; + Type:1B; Size:1 GB; MEM#3A Status:Normal; + Code:c1000000000000004572T128000HR3.7A 252b-04123724; + Type:1B; Size:1 GB; MEM#3B Status:Normal;...
  • Page 332 showhardconf(8) + Type:1B; Size:1 GB; MEM#1B Status:Normal; + Code:c1000000000000004572T128000HR3.7A 252b-04123b25; + Type:1B; Size:1 GB; MEM#2A Status:Normal; + Code:c1000000000000004572T128000HR3.7A 252b-04123e20; + Type:1B; Size:1 GB; MEM#2B Status:Normal; + Code:c1000000000000004572T128000HR3.7A 252b-04123822; + Type:1B; Size:1 GB; MEM#3A Status:Normal; + Code:c1000000000000004572T128000HR3.7A 252b-04123724; + Type:1B; Size:1 GB; MEM#3B Status:Normal;...
  • Page 333 showhardconf(8) + FRU-Part-Number:CF00300-2001 02 /300-2001-02; PCI#4 Status:Normal; Name_Property:; Card_Type:DownLink; + Ver:17h; Serial:XF01LM; Type:Optic; + Connection:IOX@X07P/IOB1; + FRU-Part-Number:CF00501-7040 04 /501-7040-04; IOX@X07P Status:Faulted; Serial:XCX07P; + FRU-Part-Number:CF00541-0314 05 /501-6937-03; IOB1 Status:Normal; Serial:XE00F9; Type:PCI-Express; + FRU-Part-Number:CF00541-0507 03 /501-6939-05; LINK Status:Normal; Ver:17h; Serial:XF01N0; Type:Optic; + FRU-Part-Number:CF00501-7040 04 /501-7040-04;...
  • Page 334 showhardconf(8) | PSU | FANBP_A | FANBP_B FAN_A | SWBP | MEDBP +-----------------------------------+------------+ EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 XSCF Reference Manual • Last Revised November 2007...
  • Page 335 showhostname(8) NAME showhostname - display the current host name for the XSCF unit SYNOPSIS showhostname {-a | xscfu} showhostname -h DESCRIPTION showhostname(8) command displays the current host name for the XSCF unit. The host name is displayed in Fully Qualified Domain Name (FQDN) format. You must have one of the following privileges to run this command: Privileges useradm, platadm, platop, auditadm, auditop, domainadm, domainmgr,...
  • Page 336 showhostname(8) Displays the host name for XSCF unit 0. EXAMPLE 2 showhostname xscf#0 XSCF> xscf#0: scf0-hostname.example.com EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 SEE ALSO sethostname(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 337 showhttps(8) NAME showhttps - display the status of the HTTPS service set for the XSCF network SYNOPSIS showhttps showhttps -h DESCRIPTION The showhttps(8) command displays the status of the HTTPS service currently set for the XSCF network. With this command, whether the HTTPS service is operating and the installation status of the information that is necessary for authentication can be checked.
  • Page 338 showhttps(8) EXAMPLES Displays the status of the HTTPS service. EXAMPLE 1 showhttps XSCF> HTTPS status: enabled Server key: installed in Apr 24 12:34:56 JST 2006 CA key: installed in Apr 24 12:00:34 JST 200 CA cert: installed in Apr 24 12:00:34 JST 200 CSR: -----BEGIN CERTIFICATE REQUEST----- MIIBwjCCASsCAQAwgYExCzAJBgNVBAYTAmpqMQ4wDAYDVQQIEwVzdGF0ZTERMA8G...
  • Page 339 showldap(8) NAME showldap - display the Lightweight Directory Access Protocol (LDAP) configuration for the Service Processor SYNOPSIS showldap showldap [-c ] showldap -h showldap(8) displays the Service Processor LDAP configuration. When invoked DESCRIPTION without options, showldap displays all LDAP configuration except for the certificate chain and the password used when binding to the LDAP server.
  • Page 340 showldap(8) XSCF Reference Manual • Last Revised June 2007...
  • Page 341 showlocale(8) NAME showlocale - display the current setting for the XSCF locale SYNOPSIS showlocale showlocale -h DESCRIPTION The showlocale(8) command displays the current setting for the XSCF locale. Either of the following is displayed: English Japanese ja_JP.UTF-8 You must have one of the following privileges to run this command: Privileges useradm, platadm, platop, auditadm, auditop, domainadm, domainmgr, domainop...
  • Page 342 showlocale(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 343 showlocator(8) NAME showlocator - display the state of the CHECK LED on the operator panel SYNOPSIS showlocator showlocator -h DESCRIPTION showlocator(8) command displays the blink state of the CHECK LED on the operator panel. The one of the following state is displayed: Indicates normal operation, which means either the circuit breaker is off or power is not being supplied.
  • Page 344 showlocator(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 345 showlogs(8) NAME showlogs - display the specified log SYNOPSIS showlogs [-t time [-T time] | -p timestamp] [-v | -V | -S] [-r] [-M] error showlogs [-t time [-T time] | -p timestamp] [-v] [-r] [-M] event showlogs [-t time [-T time]] [-r] [-M] {power | env} showlogs [-r] [-M] monitor showlogs -d domain_id [-t time [-T time]] [-r] [-M] {console | ipl | panic} showlogs -h...
  • Page 346 showlogs(8) OPTIONS The following options are supported: -d domain_id Specifies the number of a domain to be displayed. This option can be specified for domain specific log. domain_id can be 0–23 depending on the system configuration. Displays usage statement. When used with other options or operands, an error occurs.
  • Page 347 showlogs(8) -t time Specifies the start date and time of the display range for log data. It is specified in one of the following formats: yyyy-mm-dd,hh:mm The timestamp is specified in the ’year-month-day, hour:minute’ format. mm/dd/yy,hh:mm The timestamp is specified in the ’month/day/year, hour:minute’ format.
  • Page 348 showlogs(8) -T time Specifies the end date and time of the display range for log data. It is specified in one of the following formats: yyyy-mm-dd,hh:mm The timestamp is specified in the ’year-month-day, hour:minute’ format. mm/dd/yy,hh:mm The timestamp is specified in the ’month/day/year, hour:minute’ format.
  • Page 349 showlogs(8) OPERANDS The following operands are supported: Displays the error log. (sometimes includes scan log) error Displays the power log. power Displays the event log. event Displays the temperature and humidity record. Displays the monitoring message log. monitor Displays the console message log. console Displays the panic message log.
  • Page 350 showlogs(8) Case where the -V option is specified Date: Mar 30 17:45:31 JST 2005 Code: xxxxxxxx-xxxxxxxx- xxxxxxxxxxxxxxxx Status: Alarm Occurred: Mar 30 17:45:31.000 JST 2005 FRU: PSU#1,PSU#2,* Msg: ACFAIL occurred (ACS=3)(FEP type = A1) Diagnostic Code: xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx UUID: bf36f0ea-9e47-42b5-fc6f-c0d979c4c8f4 MSG-ID:FMD-8000-11 Diagnostic Messages:...
  • Page 351 showlogs(8) Error status Status: Either of the following is displayed: Partial degradation of the unit or warning Warning about the FRU FRU failure or error Alarm Suspected faulty unit FRU: The suspected faulty units that are displayed and delimited by a comma (,) are the units most likely and second most likely to be faulty.
  • Page 352 showlogs(8) Log collection date and time (month day hour:minute:second Date: time-zone year) The displayed time is the local time. Power status Event: One of the following states is displayed: The domain power is on. Domain Power On The domain power is off. Domain Power Off The main unit power is on.
  • Page 353 showlogs(8) Case where the -v option is specified Date Message Mar 30 17:45:31 JST 2005 System power on Switch= Service RCIaddr=000105ff Code=xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx Log collection date and time (month day hour:minute:second Date: time-zone year) The displayed time is the local time.
  • Page 354 showlogs(8) Log collection date and time (month day hour:minute:second Date: time-zone year) The displayed time is the local time. Intake air temperature Temperature: Decimal numbers are displayed to two decimal places. The unit is degree Celsius ( C). Humidity Humidity: The displayed numbers are percentages (%).
  • Page 355 showlogs(8) The time in the displayed log collection date and time (month day hour:minute:second time-zone year) is the local time. Panic message log ■ <<panic>> Date: Mar 30 18:45:31 JST 2005 DomainID: 00 Mar 30 17:45:31 JST 2005 panic message Mar 30 17:55:31 JST 2005 panic message [Second line]...
  • Page 356 XSCF> Date: Mar 30 12:45:31 JST 2005 Code: 00112233-44556677-8899aabbcceeff0 Status: Alarm Occurred: Mar 30 17:45:31.000 JST 2005 FRU: IOU#0/PCI#3 Msg: offline(vendor=FUJITSU, product=MAJ3182MC) Date: Mar 30 15:45:31 JST 2005 Code: 00112233-44556677-8899aabbcceeff0 Status: Warning Occurred: Mar 30 17:45:31.000 JST 2005 FRU: PSU#1,PSU#2...
  • Page 357 showlogs(8) Displays a power log. EXAMPLE 4 showlogs power XSCF> Date Event Cause Switch Mar 30 17:25:31 JST 2005 System Power Off Power Failure -- Service Mar 30 17:35:31 JST 2005 System Power On AC Restored Locked Mar 30 17:45:31 JST 2005 Domain Power Off Operator Locked...
  • Page 358 showlogs(8) Note: The codes or messages shown here may differ from those actually displayed. EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 XSCF Reference Manual • Last Revised January 2007...
  • Page 359 showlookup(8) NAME showlookup - display the configuration for authentication and privileges lookup SYNOPSIS showlookup showlookup -h DESCRIPTION showlookup(8) displays configuration settings for authentication and privileges. You must have useradm or fieldeng privileges to run this command. Privileges Refer to setprivileges(8) for more information. OPTIONS The following option is supported: Displays usage statement.
  • Page 360 showlookup(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 361 showmonitorlog(8) NAME showmonitorlog - display the contents of monitoring messages in real time SYNOPSIS showmonitorlog showmonitorlog -h DESCRIPTION The showmonitorlog(8) command displays the contents of monitoring messages in real time. When the showmonitorlog(8) command is executed, the XSCF shell is occupied for the display of monitoring messages.
  • Page 362 showmonitorlog(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 363 shownameserver(8) NAME shownameserver - display the registered domain name system (DNS) servers specified on the XSCF network SYNOPSIS shownameserver shownameserver -h DESCRIPTION shownameserver(8) command displays the registered DNS servers in the XSCF network. You must have one of the following privileges to run this command: Privileges useradm, platadm, platop, auditadm, auditop, domainadm, domainmgr, domainop, fieldeng...
  • Page 364 shownameserver(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 365 shownetwork(8) NAME shownetwork - display information of network interfaces for XSCF SYNOPSIS shownetwork [-M] {-a | -i | interface} shownetwork -h DESCRIPTION shownetwork(8) command displays current information of network interfaces for XSCF. Information on the specified network interface or all the network interfaces can be displayed.
  • Page 366 shownetwork(8) OPERANDS The following operands are supported: interface Specifies the network interface whose information is to be displayed. One of the following values can be specified, depending on the system configuration. If this operand is specified with the -a option, the operand is ignored. For midrange server: ■...
  • Page 367 shownetwork(8) EXTENDED When the XSCF unit is duplicated configuration in the high-end server, a ■ DESCRIPTION takeover IP address can be used without a need 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 368 shownetwork(8) Displays the information for XSCF-LAN#0 on XSCF Unit 0. EXAMPLE 4 shownetwork xscf#0-lan#0 XSCF> xscf#0-lan#0 Link encap:Ethernet HWaddr 00:00:00:12:34:56 inet addr:192.168.11.10 Bcast:192.168.11.255 Mask 255.255.255.0 UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:54424 errors:0 dropped:0 overruns:0 frame:0 TX packets:14369 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:14541827 (13.8 MiB) TX bytes:1459769 (1.3 MiB)
  • Page 369 shownetwork(8) server. shownetwork -a XSCF> xscf#0-lan#0 Link encap:Ethernet HWaddr 00:00:00:12:34:56 inet addr: 192.168.11.10 Bcast: 192.168.11.255 Mask:255.255.255.0 UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:54424 errors:0 dropped:0 overruns:0 frame:0 TX packets:14369 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:12241827 (11.3 MiB) TX bytes:1189769 (0.9 MiB) Base address:0x1000 xscf#0-lan#1...
  • Page 370 shownetwork(8) XSCF Reference Manual • Last Revised June 2007...
  • Page 371 shownotice(8) NAME shownotice - display copyright and license information for the eXtended System Control Facility (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 372 shownotice(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 373 showntp(8) NAME showntp - display the NTP information which currently set for XSCF SYNOPSIS showntp {-l | -a | address | -s} showntp -h DESCRIPTION The showntp(8) command displays the NTP information which currently set for XSCF. The showntp(8) command can display the following information: NTP servers which have been registered to the XSCF network ■...
  • Page 374 showntp(8) EXAMPLES Displays all NTP servers being currently set. EXAMPLE 1 showntp -a XSCF> server ntp1.example.com prefer # [1] ntp server name server ntp2.example.com # [2] ntp server name Confirms synchronization with an NTP server and displays the results. EXAMPLE 2 showntp -l XSCF>...
  • Page 375 showpasswordpolicy(8) NAME showpasswordpolicy - display the current password settings SYNOPSIS showpasswordpolicy showpasswordpolicy -h DESCRIPTION showpasswordpolicy(8) displays the password policy settings. These include default password expiration settings for new accounts, pam_cracklib parameters, and the number of passwords to keep in password history for each user. You must have useradm privileges to run this command.
  • Page 376 showpasswordpolicy(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 377 showpowerupdelay(8) NAME showpowerupdelay - display the current settings for the warm-up time of the system and wait time before system startup SYNOPSIS showpowerupdelay showpowerupdelay -h DESCRIPTION The showpowerupdelay(8) command displays the current settings for the warm- up time of the system and wait time before system startup. The following settings are displayed: Warm-up time warmup time...
  • Page 378 showpowerupdelay(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 379 showresult(8) NAME showresult - display the exit status of the most recently executed command SYNOPSIS showresult showresult -h DESCRIPTION showresult(8) command displays the exit status of the most recently executed. showresult(8) is convenient for a remote control program to confirm whether the most recently executed command is successfully completed.
  • Page 380 showresult(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 381 showroute(8) NAME showroute - display routing information for an XSCF network interface SYNOPSIS showroute [-M] [-n] {-a | interface} showroute -h DESCRIPTION showroute(8) command displays the current routing information for an XSCF network interface. Routing information for the specified network interface or all the network interfaces can be displayed.
  • Page 382 showroute(8) Displays usage statement. When used with other options or operands, an error occurs. Displays text by page. This option provides a function that is the same as that of the more command. Displays IP address without the name resolution of host name. OPERANDS The following operand is supported: interface...
  • Page 383 showroute(8) Displays routing information for XSCF-LAN#0 on XSCF unit 0 without the EXAMPLE 2 name resolution of host name. showroute -n xscf#0-lan#0 XSCF> Destination Gateway Netmask Flags Interface 192.168.10.0 255.255.255.0 xscf#0-lan#0 default 192.168.10.1 0.0.0.0 xscf#0-lan#0 Displays all routing information for XSCF unit 0 and XSCF unit 1 in the EXAMPLE 3 highend server.
  • Page 384 showroute(8) XSCF Reference Manual • Last Revised June 2007...
  • Page 385 showshutdowndelay(8) NAME showshutdowndelay - display the shutdown wait time at power interruption of the uninterruptible power supply (UPS) SYNOPSIS showshutdowndelay showshutdowndelay -h DESCRIPTION The showshutdowndelay(8) command displays the wait time before the start of system shutdown for when power interruption occurs in a system connected to the UPS.
  • Page 386 showshutdowndelay(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 387 showsmtp(8) NAME showsmtp - display the SMTP configuration information SYNOPSIS showsmtp showsmtp [ -v ] showsmtp -h DESCRIPTION showsmtp(8) displays the SMTP configuration. When used without options, it displays current SMTP configuration data. You must have platadm or platop privileges to run this command. Privileges Refer to setprivileges(8) for more information.
  • Page 388 showsmtp(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 389 showsnmp(8) NAME showsnmp - display the configuration information and current status of the SNMP agent SYNOPSIS showsnmp showsnmp -h DESCRIPTION showsnmp(8) displays the configuration and information and current status of the SNMP agent. This includes: agent status, port, system location, contact and description, traphosts, SNMP version, and any enabled MIB modules.
  • Page 390 showsnmp(8) Displaying SNMP Information for a Enabled System Set Up With EXAMPLE 3 SNMPv1/v2c Trap Host showsnmp XSCF> Agent Status: Enabled Agent Port: System Location: SanDiego System Contact: jsmith@jupiter.west System Description: FF1 Trap Hosts: Hostname Port Type Community String Username Auth Protocol -------- ----...
  • Page 391 showsnmpusm(8) NAME showsnmpusm - display the current User-based Security Model (USM) information for the SNMP agent SYNOPSIS showsnmpusm showsnmpusm -h DESCRIPTION showsnmpusm(8) displays the current USM information for the SNMP agent. Privileges You must have platadm or platop privileges to run this command. Refer to setprivileges(8) for more information.
  • Page 392 showsnmpusm(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 393 showsnmpvacm(8) NAME showsnmpvacm - display the current View-based Access Control Access (VACM) information for the SNMP agent SYNOPSIS showsnmpvacm showsnmpvacm -h DESCRIPTION showsnmpvacm(8) displays the current VACM information for the SNMP agent. Privileges You must have platadm or platop privileges to run this command. Refer to setprivileges(8) for more information.
  • Page 394 showsnmpvacm(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 395 showssh(8) NAME showssh - display the status, host public keys, fingerprint, or user public keys of the SSH service configured for the XSCF network SYNOPSIS showssh [ hostkey] [-M] showssh pubkey [ user_name] [-M] showssh -h showssh(8) command displays the status, host public keys, fingerprint, or user DESCRIPTION public keys of the SSH service configured for the XSCF network.
  • Page 396 showssh(8) Displays usage statement. When used with other options or operands, an error occurs. Displays text by page. This option provides a function that is the same as that of the more command. -u user_name Specify the user account name to display the user public key. Should be specified with "-c pubkey."...
  • Page 397 showssh(8) Displays the user public key of the current login user account. EXAMPLE 2 showssh -c pubkey XSCF> Public key: ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAzFh95SohrDgpnN7zFCJCVNy+jaZPTjNDxcid QGbihYDCBttI4151Y0Sv85FJwDpSNHNKoVLMYLjtBmUMPbGgGVB61qskSv/ FeV44hefNCZMiXGItIIpK P0nBK4XJpCFoFbPXNUHDw1rTD9icD5U/wRFGSRRxFI+Ub5oLRxN8+A8=abcd@example.com ssh-rsa CSqGSIb3DQEJARYHZWUubWFpbDCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEA nkPntf+TjYtyKlNYFbO/YavFpUzkYTLHdt0Fbz/ tZmGd3e6Jn34A2W9EC7D9hjLsj+kAP41Al6wFwGO7 KP3H4iImX0Uysjl9Hyk4jLBU51sw8JqvT2utTjltV5mFPKL6bDcAgY9=efgh@example.com EXIT STATUS The following exit values are returned: Successful completion. An error occurred.
  • Page 398 showssh(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 399 showstatus(8) NAME showstatus - display the degraded Field Replaceable Units (FRUs) SYNOPSIS showstatus [-M] showstatus -h DESCRIPTION showstatus(8) command displays information about degraded units that are among the FRUs composing the system. Privileges You must have one of the following privileges to run this command: useradm, platadm, platop, domainadm, domainmgr, domainop, fieldeng Refer to setprivileges(8) for more information.
  • Page 400 showstatus(8) Displays the degraded units. In this example, a memory module on a mem- EXAMPLE 2 ory board is degraded because of an error. showstatus XSCF> MBU_B; MEMB#0; MEM#0A Status:Faulted; Displays the degraded units. In this example, a CPU memory unit and EXAMPLE 3 memory module on a motherboard unit are degraded because of an error.
  • Page 401 showtelnet(8) NAME showtelnet - display the current status of the Telnet service for the XSCF network SYNOPSIS showtelnet showtelnet -h DESCRIPTION showtelnet(8) command displays the current status of the Telnet service for the XSCF network. One of the following states is displayed: The Telnet service is enabled.
  • Page 402 showtelnet(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 403 showtimezone(8) NAME showtimezone - display the XSCF time zone and Daylight Saving Time information of current settings SYNOPSIS showtimezone -c tz showtimezone -c dst showtimezone -h The showtimezone(8) command displays the XSCF time zone and Daylight Saving DESCRIPTION Time information of current settings. It is displayed in the following format.
  • Page 404 showtimezone(8) offset2 Offset time of Daylight Saving Time and Greenwich mean time (GMT). Displayed in minus "–" in case the offset is plus, and displayed in plus "+" in case the offset is minus. from-date[/time] The starting time of Daylight Saving Time. Any of the following formats displays from-date.
  • Page 405 showtimezone(8) offset2 Offset time of Daylight Saving Time and Greenwich mean time (GMT). Displayed in minus "–" in case the offset is plus, and displayed in plus "+" in case the offset is minus. from-date[/time] The starting time of Daylight Saving Time. Any of the following formats displays from-date.
  • Page 406 showtimezone(8) to-date[/time] The termination time of Daylight Saving Time. Any of the following formats displays to-date. Mm.w.d Mm: Shows the month when Daylight Saving Time terminates. Any numeric from 1 to 12 comes in m. w: Shows the week when Daylight Saving Time terminates. Any numeric from 1 to 5 comes in, "1"...
  • Page 407 showtimezone(8) EXTENDED The settimezone(8) command sets the time zone of the XSCF. DESCRIPTION EXAMPLES Displays the time zone. EXAMPLE 1 showtimezone -c tz XSCF> Asia/Tokyo Displays the Daylight Saving Time information as follows: the abbrevia- EXAMPLE 2 tion of time zone is JST, the offset from GMT is +9, the name of Daylight Saving Time is JDT, Daylight Saving Time is 1 hour ahead, and the time pe- riod is from the last Sunday of March 2:00 to the last Sunday of October 2:00.
  • Page 408 showtimezone(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 409 showuser(8) NAME showuser - display user account information SYNOPSIS showuser showuser [ [-a] [-M] [-p] [-u] [ user]] showuser [ [-a] [-l] [-M] [-p] [-u]] showuser -h DESCRIPTION showuser (8) displays XSCF user account information. If the user argument is specified, showuser displays account information for the specified user.
  • Page 410 showuser(8) EXAMPLES Displays Password and Account Validity Information EXAMPLE 1 showuser -a XSCF> User Name: jsmith Status: Enabled Minimum: Maximum: 99999 Warning: Inactive: Last Change: Aug 22, 2005 Password Expires: Never Password Inactive: Never Account Expires: Never Displays Privileges Information EXAMPLE 2 showuser -p XSCF>...
  • Page 411 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 412 snapshot(8) Every .zip archive generated by snapshot includes two files generated by snapshot itself. The first file, called README, contains the original name of the .zip archive, the name of the configuration file on the Service Processor used to create the .zip archive, the version of snapshot and whether log-only mode (the -l flag) was used to generate the archive.
  • Page 413 snapshot(8) -k host-key Used with the -t or -T option, sets the public key that the Service Processor uses to log in to the network host. This option is not valid with the -d option. Possible values for host-key are as follows: none This literal value specifies that a public key should not be used to authenticate the network host.
  • Page 414 snapshot(8) -k host-key Used with the -t or -T option, sets the public key that the Service Processor uses to log in to the network host. This option is not valid with the -d option. Possible values for host-key are as follows: none This literal value specifies that a public key should not be used to authenticate the network host.
  • Page 415 snapshot(8) -p password Specifies the user password used to log in to the host using SSH. This option is valid with the -t option, not with the -d or -T options. Suppresses all messages to stdout, including prompts. -S time Specifies the start time for the time period for which data is collected.
  • Page 416 snapshot(8) EXTENDED Modes of Operation DESCRIPTION The following is a brief overview of the modes of operation for the snapshot command. The first mode is SSH Target Mode. The data collector is run in this mode when it is invoked with the -t or -T option. In this mode, the data collector opens an SSH connection from the Service Processor to the specified target (after appropriate authentication) and sends the zip data archive through the SSH connection to the target host.
  • Page 417 snapshot(8) Downloading With a User-Provided Public Key EXAMPLE 3 snapshot -t joe@jupiter.west:/home/joe/logs/x -k “ssh-rsa XSCF> AAAAB3NzaC1yc2EAAAABIwAAAIEAwVFiSQNVBFhTTzq0AX5iQqCkkJjd6ezWkVGt mMkJJzzMjYK0sBlhn6dGEIiHdBSzO8QLAXb8N4Kq8JDOBpLSN4yokUPTcZQNxJaY A0W058Qgxbn” Enter ssh password for user ‘joe’ on host ‘jupiter.west’ Setting up ssh connection to remote host... Collecting data into joe@jupiter.west:/home/joe/logs/x/archive.zip Data collection complete. Log Files Only Using No Public Key EXAMPLE 4 snapshot -t bob@mars.east:/home/bob/logs/x -k none -l...
  • Page 418 snapshot(8) Downloading Public Key and Answering No to All Prompts EXAMPLE 8 snapshot -v -t jill@earth.east:/home/jill/logs/x -k download XSCF> Downloading Public Key from ‘earth.east’... Public Key: ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAwVFiSQNVBFhTTzq0AX5iQqCkkJjd6ezWkVGtmMkJJzzM jYK0sBlhn6dGEIiHdBSzO8QLAXb8N4Kq8JDOBpLSN4yokUPTcZQNxJaYA0W058Qgxbn Key fingerprint in md5: c9:e0:bc+b2:1a:80:29:24:13:d9:f1:13:f5:5c:2c:0f Accept this public key (yes/no)? Public Key declined Error opening SSH target Exiting with error 1 Downloading Public Key Attempted by Unauthorized User...
  • Page 419 switchscf(8) NAME switchscf - switch the XSCF unit between the active and standby states SYNOPSIS switchscf [ [-q] -{y|n}] -t {Active | Standby} [-f] switchscf -h DESCRIPTION The switchscf(8) command switches the XSCF unit that the user is currently logged in to, between the active and standby states. If the XSCF unit is duplicated configuration, the switchscf(8) command can be executed.
  • Page 420 switchscf(8) EXTENDED When the command is executed, a prompt to confirm execution of the command DESCRIPTION with the specified options is displayed. Enter "y" to execute the command or "n" to cancel the command. EXAMPLES Switches the state of the XSCF unit that the user is currently logged in to, EXAMPLE 1 to standby.
  • Page 421 testsb(8) NAME testsb - perform an initial diagnosis of the specified physical system board (PSB) SYNOPSIS testsb [ [-q] -{y|n}] [-m diag=mode] location testsb [ [-q] -{y|n}] [-m diag=mode] -c {all | expansion} testsb -v [ -y|-n] [-m diag=mode] location testsb -v [-y|-n] [-m diag=mode] -c {all | expansion} testsb -h DESCRIPTION...
  • Page 422 testsb(8) OPTIONS The following options are supported:. -c {all|expansion} Specifies the target PSB to be diagnosed. One of the values shown below can be specified: Diagnoses all the PSB that are mounted. If the following conditions not satisfied, it leads to an error.
  • Page 423 testsb(8) XSB is installed in the domain and this domain is power ON status, power ■ OFF status, or reset status. The addboard(8), deleteboard(8), or moveboard(8) command is executed ■ for XSB. In case an XSB which belongs to the specified PSB is in Unmount or Faulted ■...
  • Page 424 testsb(8) EXAMPLES Performs the initial diagnosis on PSB#00. EXAMPLE 1 testsb 0 XSCF> Initial diagnosis is about to start, Continue?[y|n] : SB#00 power on sequence started. 0end Initial diagnosis started. [1800sec] 0..30..60..90..120end Initial diagnosis has completed. SB power off sequence started. [1200sec] 0.end SB powered off.
  • Page 425 testsb(8) mounted. testsb -c all XSCF> Initial diagnosis is about to start. Continue? [y|n] : Ignore warmup-time and air-conditioner-wait-time, Continue?[y|n] : SB power on sequence started. 0end Initial diagnosis started. [1800sec] 0..30..60..90..120end Initial diagnosis has completed. SB power off sequence started. [1200sec] 0.end SB powered off.
  • Page 426 testsb(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 427 unlockmaintenance(8) NAME unlockmaintenance - forcibly release the locked status of XSCF SYNOPSIS unlockmaintenance [ [-q] -{y|n}] unlockmaintenance -h DESCRIPTION unlockmaintenance(8) command releases the locked status of XSCF forcibly. Normally, while the maintenance command addfru(8), deletefru(8), or replacefru(8) is in execution, XSCF is in the locked status. After the command complete, the lock is released.
  • Page 428 unlockmaintenance(8) Unlocks the maintenance lock status. Automatically answers "y" to all EXAMPLE 2 prompts. unlockmaintenance -y XSCF> This command unlocks the maintenance lock which prevents the multiple execution of maintenance commands. *Never* use this command, except when the lock state remains by some reason.
  • Page 429 version(8) NAME version - display firmware version SYNOPSIS version -c xcp [-v] [-t] version -c {cmu | xscf} [-v] version -h DESCRIPTION The version(8) command displays firmware version. The following versions can be displayed: The comprehensive version of the XSCF control package (XCP) firmware currently applied to the system.
  • Page 430 version(8) Displays the details of the XCP version. EXAMPLE 2 version -c xcp -v XSCF> XSCF#0 (Active) XCP0 (Current): 1020 OpenBoot PROM : 01.01.0001 : 01.01.0001 XCP1 (Reserve): 1020 OpenBoot PROM : 01.01.0001 OpenBoot PROM BACKUP 01.01.0001 01.02.0001 XSCF#1 (Standby) XCP0 (Current): 1020 OpenBoot PROM : 01.01.0001 : 01.01.0001...
  • Page 431 version(8) Displays the detailed version of OpenBoot PROM firmware. EXAMPLE 6 version -c cmu -v XSCF> DomainID 00 : 01.01.0001 DomainID 01 : 01.01.0001 DomainID 02 : 01.01.0001 DomainID 03 : 01.01.0001 DomainID 23: 01.01.0001 XSB#00-0 : 01.01.0001 (Current), 01.01.0001 (Reserve) XSB#00-1 : 01.01.0001 (Reserve), 01.01.0001 (Current) XSB#00-2...
  • Page 432 version(8) XSCF Reference Manual • Last Revised January 2007...
  • Page 433 viewaudit(8) NAME viewaudit - display audit records SYNOPSIS viewaudit viewaudit [-A date-time] [ -B date-time ] [ -C] [ -c classes] [ -D date-time] [-E end- record] [-e events ] [ -i audit-ids] [-l] [ -m del] [ -n] [ -p privilege-results] [ -r return-values ] [ -S start-record] [ -u users] [-x] viewaudit -h DESCRIPTION...
  • Page 434 viewaudit(8) -B date-time Selects records that occurred before date-time. The date-time argument is in local time. the -A and -B options can be used together to form a range. Valid values for date-time are either absolute or offset: Absolute date-time : yyyymmdd[hh[mm[ss]]] ■...
  • Page 435 viewaudit(8) -B date-time Selects records that occurred before date-time. The date-time argument is in local time. the -A and -B options can be used together to form a range. Valid values for date-time are either absolute or offset: Absolute date-time : yyyymmdd[hh[mm[ss]]] ■...
  • Page 436 viewaudit(8) -c classes Selects records in indicated classes. classes is a comma- separated list of audit classes. A class may be specified by its numeric value or its name. The ACS_ prefix may be omitted. For example, the class of audit related events can be expressed as ACS_AUDIT, AUDIT or 16.
  • Page 437 viewaudit(8) -e events Selects records of the indicated events. events is a comma- separated list of audit events. An event may be specified by its numeric value or its name. The AEV_ prefix may be omitted. For example, the event for SSH login can be expressed as AEV_LOGIN_SSH, LOGIN_SSH or 4.
  • Page 438 viewaudit(8) -u users Selects records attributed to indicated users. users is a comma-separated list of users. A user can be specified by user name or numeric UID. Prints in XML format. EXAMPLES Displaying Audit Records for December 12, 2005 EXAMPLE 1 viewaudit -D 20051212 XSCF>...
  • Page 439 viewaudit(8) Displaying Audit Records Within a Range of Two Days EXAMPLE 5 viewaudit -A 20060125 -B +2d XSCF> file,1,2006-01-26 16:11:52.785 - 05:00,20060126211152.0000000000.jupiter.west.company.com subject,1,jsmith,normal,ssh 51409 jupiter.west header,56,1,command - showldap,jupiter.west,2006-01-27 21:15:12.416 - 05:00 subject,4,jblake,normal,telnet 51409 sr1.company.com command,showldap platform access,granted return,0 subject,7,bob,normal,ssh 40952 mars.com header,57,1,command - viewaudit,mars.company.com,2006-01-26 16:12:16.127 -05:00 subject,0,opl,normal,ssh 40952 apps...
  • Page 440 viewaudit(8) XSCF Reference Manual • Last Revised June 2007...
  • Page 441 Displays a list of the user accounts who are logged in to the XSCF. EXAMPLES EXAMPLE 1 XSCF> USER IDLE FROM HOST pts/0 00:00m Dec 21 13:57 JJJJ.ggg.fujitsu.com EXIT STATUS The following exit values are returned: Successful completion. An error occurred. >0 System Administration...
  • Page 442 who(1) XSCF Reference Manual • Last Revised January 2007...

Table of Contents