Sun Microsystems M900, M4000, M3000, M5000, M8000 Reference Manual

...

Download

Sun SPARC Enterprise™

M3000/M4000/M5000/M8000/M9000

Servers XSCF Reference Manual

XSCF Control Package (XCP) 1090

Sun Microsystems, Inc. www.sun.com

Part No. 821-0338-10 August 2009, Revision A

Submit comments about this document by clicking the Feedback[+] link at: http://docs.sun.com

Copyright 2007-2009Sun Microsystems,Inc., 4150 Network Circle, SantaClara, California95054, U.S.A. and FUJITSU LIMITED,1-1, Kamikodanaka 4-chome,Nakahara-ku, Kawasaki-shi, Kanagawa-ken 211-8588,Japan. All rights reserved.

Sun Microsystems, Inc.and Fujitsu Limited each ownor controlintellectual propertyrights relating to products and technology describedin this document,and such products, technology and this documentare protectedby copyright laws, patents andother intellectualproperty laws and internationaltreaties. Theintellectual propertyrights of SunMicrosystems, Inc.and Fujitsu Limited in suchproducts, technologyand this document include,without limitation, one or more ofthe United States patents listedat http://www.sun.com/patentsand one or more additional patentsor patent applications in theUnited Statesor other countries.

This documentand the product and technology to whichit pertains are distributed under licenses restrictingtheir use,copying, distribution, and decompilation.No part of such product ortechnology, orof this document, may bereproduced inany formby any meanswithout prior written authorizationof Fujitsu Limited and SunMicrosystems, Inc.,and their applicable licensors, ifany. Thefurnishing of this document to you doesnot give you any rightsor licenses, express or implied, with respect tothe productor technology to which itpertains, and this document doesnot contain or representany commitment ofany kindon the part of FujitsuLimited or Sun Microsystems, Inc.,or anyafﬁliate of either ofthem.

This documentand the product and technology described inthis document may incorporate third-party intellectualproperty copyrightedby and/or licensedfrom suppliersto Fujitsu Limited and/or SunMicrosystems, Inc.,including software and font technology.

Per theterms of the GPL orLGPL, a copy of thesource codegoverned by the GPL orLGPL, as applicable, is availableupon requestby the End User.Please contactFujitsu Limited orSun Microsystems,Inc.

This distributionmay include materials developed bythird parties. Parts ofthe productmay be derived from BerkeleyBSD systems,licensed from the University ofCalifornia. UNIXis a registered trademark in

the U.S.and in other countries, exclusivelylicensed throughX/Open Company, Ltd. Sun, SunMicrosystems, theSun logo, Java, Netra, Solaris,Sun Ray, Answerbook2, docs.sun.com, OpenBoot, andSun Fireare trademarks or

registered trademarks of SunMicrosystems, Inc.in the U.S. and othercountries. Fujitsu andthe Fujitsu logo are registered trademarks of Fujitsu Limited. All SPARC trademarks are used under license andare registered trademarksof SPARC International, Inc.in theU.S. and othercountries.

Products bearing SPARC trademarksare basedupon architecturedeveloped by Sun Microsystems, Inc. SPARC64 isa trademarkof SPARC International, Inc.,used under license by FujitsuMicroelectronics, Inc.and Fujitsu Limited. The OPENLOOK and Sun™ Graphical UserInterface was developed by SunMicrosystems, Inc.for its users and licensees.Sun acknowledges

the pioneeringefforts ofXerox inresearching anddeveloping the concept of visualor graphical user interfaces forthe computer industry.Sun holds anon-exclusive license from Xeroxto the Xerox GraphicalUser Interface,which license alsocovers Sun’slicensees who implement OPEN LOOK GUIsand otherwise comply with Sun’swritten license agreements.

United StatesGovernment Rights - Commercial use. U.S. Governmentusers aresubject to the standard governmentuser licenseagreements of Sun Microsystems, Inc.and Fujitsu Limited and theapplicable provisionsof the FAR andits supplements.

Disclaimer: Theonly warranties granted by FujitsuLimited, Sun Microsystems, Inc. or any afﬁliate ofeither of them in connectionwith this document orany productor technology described herein are those expressly set forth in thelicense agreementpursuant to which the product or technology isprovided. EXCEPTAS EXPRESSLY SET FORTH INSUCH AGREEMENT, FUJITSU LIMITED,SUN MICROSYSTEMS, INC. AND THEIRAFFILIATESMAKE NO REPRESENTATIONSOR WARRANTIES OF ANYKIND (EXPRESS OR IMPLIED) REGARDINGSUCH PRODUCT ORTECHNOLOGY OR THIS DOCUMENT,WHICH AREALL PROVIDED AS IS, ANDALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDINGWITHOUT LIMITATION ANYIMPLIED WARRANTY OF MERCHANTABILITY, FITNESSFOR A PARTICULARPURPOSE ORNON-INFRINGEMENT, ARE DISCLAIMED, EXCEPTTO THE EXTENT THAT SUCH DISCLAIMERS ARE HELDTO BELEGALLYINVALID.Unless otherwise expressly set forth in suchagreement, tothe extent allowedby applicablelaw,in no event shall FujitsuLimited, SunMicrosystems, Inc.or any of their afﬁliates haveany liabilityto any third party underany legal theory for anyloss ofrevenues or proﬁts, loss of use ordata, or business interruptions, orfor any indirect, special, incidental orconsequential damages, even if advisedof the possibility of suchdamages.

DOCUMENTATION IS PROVIDED “AS IS”AND ALL EXPRESS OR IMPLIEDCONDITIONS, REPRESENTATIONS ANDWARRANTIES, INCLUDING ANYIMPLIED WARRANTY OF MERCHANTABILITY,FITNESS FORA PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED,EXCEPT TOTHE EXTENT THAT SUCHDISCLAIMERS AREHELD TO BE LEGALLY INVALID.

Copyright 2007-2009Sun Microsystems,Inc., 4150 Network Circle, SantaClara, California95054, U.S.A. et FUJITSU LIMITED,1-1, Kamikodanaka 4-chome,Nakahara-ku, Kawasaki-shi, Kanagawa-ken 211-8588,Japon. Tous droits réservés.

Sun Microsystems, Inc.et Fujitsu Limited détiennent etcontrôlent toutes deux des droits depropriété intellectuellerelatifs auxproduits et technologies décritsdans ce document. De même,ces produits,technologies et ce document sontprotégés pardes lois sur le copyright,des brevets, d’autres lois surla propriétéintellectuelle et des traités internationaux.Les droitsde propriétéintellectuelle de SunMicrosystems, Inc. et FujitsuLimited concernant ces produits, ces technologies etce document comprennent, sans que cette listesoit exhaustive, un ou plusieurs des brevets déposésaux États-Unis et indiqués àl’adresse http://www.sun.com/patents de même qu’un ouplusieurs brevetsou applications brevetées supplémentaires aux États-Uniset dansd’autres pays.

Ce document,le produitet les technologies afférents sont exclusivement distribuésavec des licences qui enrestreignent l’utilisation,la copie,la distribution etla décompilation. Aucune partie dece produit,de ces technologies ou dece document ne peut être reproduite sousquelque forme quece soit, par quelque moyenque ce soit, sans l’autorisationécrite préalablede Fujitsu Limitedet deSun Microsystems, Inc., et deleurs éventuels bailleursde licence. Ce document, bienqu’il vousait été fourni,ne vousconfère aucun droit et aucune licence, expressesou tacites, concernant leproduit oula technologie auxquels il serapporte. Par ailleurs, il necontient ni ne représente aucun engagement, dequelque type que cesoit, de la part deFujitsu Limited ou de SunMicrosystems, Inc.,ou des sociétés afﬁliées.

Please

Recycle

Ce document,et le produit et les technologies qu’ildécrit, peuvent inclure des droits de propriété intellectuellede parties tierces protégéspar copyright et/oucédés sous licence par desfournisseurs àFujitsu Limited et/ouSun Microsystems,Inc., y compris des logicielset des technologies relatives auxpolices de caractères.

Cette distributionpeut comprendredes composantsdéveloppés par destierces parties. Des partiesde ce produit pourrontêtre dérivées des systèmes BerkeleyBSD licenciés par l’Université deCalifornie. UNIXest une marque

déposée auxEtats-Unis et dans d’autres pays et licenciéeexclusivement par X/Open Company, Ltd. Sun, SunMicrosystems, lelogo Sun, Java, Netra, Solaris,Sun Ray, Answerbook2, docs.sun.com, OpenBoot, etSun Firesont des marques de

fabrique oudes marquesdéposées de Sun Microsystems, Inc.aux Etats-Uniset dans d’autres pays. Fujitsu etle logo Fujitsu sont desmarques déposéesde Fujitsu Limited. Toutes lesmarques SPARC sont utilisées sous licenceet sont des marques de fabrique oudes marquesdéposées de SPARC International, Inc.

aux Etats-Uniset dans d’autres pays. Les produits portantles marquesSPARCsont basés sur une architecture développée par Sun Microsystems, Inc.

SPARC64 estune marquesdéposée de SPARC International, Inc., utiliséesous le permis par FujitsuMicroelectronics, Inc.et FujitsuLimited. L’interfaced’utilisation graphiqueOPEN LOOK et Sun™ aété développée par Sun Microsystems,Inc. pourses utilisateurs etlicenciés. Sun

reconnaît les efforts depionniers deXerox pour la recherche et le développementdu conceptdes interfaces d’utilisationvisuelle ougraphique pour l’industriede l’informatique. Sun détient unelicense non exclusive de Xerox surl’interface d’utilisation graphique Xerox, cette licence couvrant égalementles licenciésde Sun qui mettent enplace l’interfaced’utilisation graphique OPEN LOOK etqui, enoutre, se conforment aux licences écritesde Sun.

Droits du gouvernement américain- logiciel commercial. Les utilisateursdu gouvernementaméricain sont soumis aux contratsde licence standard de Sun Microsystems,Inc. etde Fujitsu Limitedainsi qu’auxclauses applicables stipulées dans leFAR et ses suppléments.

Avis denon-responsabilité: lesseules garanties octroyées par Fujitsu Limited, SunMicrosystems, Inc.ou toute sociétéafﬁliée del’une ou l’autre entité enrapport avec ce document outout produitou toute technologie décrit(e) dansles présentes correspondent aux garanties expressément stipulées dansle contrat de licence régissantle produitou la technologie fourni(e). SAUFMENTION CONTRAIRE EXPRESSÉMENT STIPULÉE DANSCE CONTRAT, FUJITSULIMITED, SUN MICROSYSTEMS, INC. ETLES SOCIÉTÉSAFFILIÉES REJETTENT TOUTE REPRÉSENTATION OU TOUTE GARANTIE, QUELLE QU’EN SOITLA NATURE (EXPRESSEOU IMPLICITE)CONCERNANT CE PRODUIT,CETTE TECHNOLOGIEOU CE DOCUMENT, LESQUELS SONT FOURNIS ENL’ÉTAT. ENOUTRE, TOUTESLES CONDITIONS, REPRÉSENTATIONS ET GARANTIES EXPRESSES OUTACITES,Y COMPRIS NOTAMMENT TOUTE GARANTIEIMPLICITE RELATIVE À LA QUALITÉMARCHANDE, À L’APTITUDE À UNE UTILISATION PARTICULIÈREOU À L’ABSENCE DECONTREFAÇON,SONT EXCLUES, DANSLA MESUREAUTORISÉE PAR LA LOI APPLICABLE. Saufmention contraireexpressément stipuléedans cecontrat, dans la mesure autorisée par laloi applicable, en aucun casFujitsu Limited, Sun Microsystems, Inc. ou l’unede leurs ﬁliales ne sauraientêtre tenues responsables envers une quelconquepartie tierce,sous quelque théoriejuridique quece soit, de tout manqueà gagner ou de pertede proﬁt,de problèmes d’utilisation ou deperte de données, ou d’interruptionsd’activités, ou de tout dommageindirect, spécial,secondaire ouconsécutif, même sices entités ont été préalablementinformées d’unetelle éventualité.

LA DOCUMENTATION EST FOURNIE “ENL’ETAT” ETTOUTES AUTRESCONDITIONS, DECLARATIONS ET GARANTIESEXPRESSES OU TACITES SONT FORMELLEMENT EXCLUES, DANSLA MESURE AUTORISEE PAR LA LOIAPPLICABLE, YCOMPRIS NOTAMMENT TOUTE GARANTIE IMPLICITE RELATIVE A LAQUALITE MARCHANDE,A L’APTITUDE AUNE UTILISATION PARTICULIERE OU A L’ABSENCEDE CONTREFACON.

Contents

Preface xi

Intro 1 addboard 7 addcodlicense 11 addfru 13 adduser 15 applynetwork 17 cfgdevice 23 clockboard 29 console 31 deleteboard 33 deletecodlicense 37 deletefru 39 deleteuser 41 disableuser 43 dumpconfig 45 enableuser 51 exit 53 flashupdate 55 fmadm 59 fmdump 61 fmstat 69 getflashimage 73

ioxadm 79 man 89 moveboard 91 nslookup 95 password 97 ping 101 poweroff 103 poweron 107 prtfru 111 rebootxscf 117 replacefru 119 reset 121 resetdateoffset 125 restoreconfig 127 restoredefaults 135 sendbreak 141 setaltitude 143 setarchiving 145 setaudit 149 setautologout 155 setcod 157 setdate 161 setdcl 165 setdomainmode 171 setdomparam 179 setdscp 183 setdualpowerfeed 187 setemailreport 189 sethostname 193 sethttps 195 setldap 201 setlocale 205 setlocator 207 setloginlockout 209

vi SPARC Enterprise Mx000 Servers XSCF Reference Manual • August 2009

setlookup 211 setnameserver 213 setnetwork 215 setntp 221 setpasswordpolicy 225 setpowerupdelay 229 setprivileges 231 setroute 235 setshutdowndelay 241 setsmtp 243 setsnmp 247 setsnmpusm 255 setsnmpvacm 259 setssh 263 settelnet 269 settimezone 271 setupfru 279 setupplatform 281 showaltitude 287 showarchiving 289 showaudit 293 showautologout 297 showboards 299 showcod 307 showcodlicense 309 showcodusage 311 showconsolepath 317 showdate 319 showdateoffset 321 showdcl 325 showdevices 331 showdomainmode 337 showdomainstatus 341 showdscp 343

Contents vii

showdualpowerfeed 347 showemailreport 349 showenvironment 351 showfru 357 showhardconf 359 showhostname 373 showhttps 375 showldap 377 showlocale 379 showlocator 381 showloginlockout 383 showlogs 385 showlookup 401 showmonitorlog 403 shownameserver 405 shownetwork 407 shownotice 413 showntp 415 showpasswordpolicy 419 showpowerupdelay 421 showresult 423 showroute 425 showshutdowndelay 429 showsmtp 431 showsnmp 433 showsnmpusm 437 showsnmpvacm 439 showssh 441 showstatus 445 showtelnet 447 showtimezone 449 showuser 455 snapshot 457 switchscf 467

viii SPARC Enterprise Mx000 Servers XSCF Reference Manual • August 2009

testsb 469 traceroute 475 unlockmaintenance 479 version 481 viewaudit 485 who 493

Contents ix

x SPARC Enterprise Mx000 Servers XSCF Reference Manual • August 2009

Preface

This manual contains the man pages for the eXtended System Control Facility (XSCF) firmware for Sun SPARC Enterprise™ M3000/M4000/M5000/M8000/M9000 servers.

Overview of Man Page Structure

The following table describes the sections included in man pages. The man pages of each manual section generally follow this order, but include only needed headings. For example, if there are no examples, there is no EXAMPLES section. Refer to the Intro page for a description of each man page, and man(1) for more information about man pages in general.

NAME This section gives the names of the commands

or functions documented, followed by a brief description of what they do.

SYNOPSIS This section shows the syntax of commands or

functions. Options and arguments are alphabetized, with single-letter arguments first, and options with arguments next, unless a different argument order is required.

The following special characters are used in this section:

[] Brackets. The option or argument

enclosed in these brackets is optional. If the brackets are omitted, the argument must be specified.

… Ellipses. Several values may be

provided for the previous argument, or the previous argument can be specified multiple times, for example

“filename...”.

| Separator. Only one of the arguments

separated by this character can be specified at one time.

{} Braces. The options and/or arguments

enclosed within braces are interdependent, such that everything enclosed must be treated as a unit.

DESCRIPTION This section defines the functionality and

behavior of the service. Thus it describes concisely what the command does. It does not discuss OPTIONS or cite EXAMPLES.

OPTIONS This lists the command options with a concise

summary of what each option does. The options are listed literally and in alphabetical order. Possible arguments to options are discussed under the option, and where appropriate, default values are supplied.

OPERANDS This section lists the command operands and

describes how they affect the actions of the command.

EXTENDED DESCRIPTION This section includes further description.

EXAMPLES This section provides examples of usage or of

how to use a command or function. Wherever possible, a complete example including command-line entry and machine response is shown. Most examples illustrate concepts from the SYNOPSIS, DESCRIPTION, OPTIONS, and OPERANDS sections.

EXIT STATUS This section lists the values the command

returns to the calling program or shell and the conditions that cause these values to be returned. Usually, zero is returned for successful completion and values other than zero for various error conditions.

SEE ALSO This section lists references to other man pages.

xii SPARC Enterprise Mx000 Servers XSCF Reference Manual • August 2009

Intro(8)

NAME Intro - list the commands provided by the XSCF firmware

DESCRIPTION Intro(8) command lists the commands provided by the XSCF firmware of the

SPARC Enterprise™ M3000/M4000/M5000/M8000/M9000 servers.

Some commands are used in a different way or not supported on your server. For details, refer to the pages of each command.

LIST OF

COMMANDS

In XSCF, the following commands are provided:

Intro, intro list the commands provided by the XSCF firmware

addboard configure an eXtended System Board(XSB) into the domain

configuration or assigns it to the domain configuration

addcodlicense add a Capacity on Demand (COD) right-to-use (RTU)

license key to the COD license database

addfru add a Field Replaceable Unit (FRU)

adduser create an XSCF user account

applynetwork reflect the information that has been set for the XSCF

network

cfgdevice connect a CD-RW/DVD-RW and TAPE drive unit to the

port, disconnect it from the port, or display the status of the drive

clockboard set or display the clock control unit used at system startup

console connect to a domain console

deleteboard disconnect an eXtended System Board (XSB) from the

domain configuration

deletecodlicense remove a Capacity on Demand (COD) right-to-use (RTU)

deletefru delete a Field Replaceable Unit (FRU)

deleteuser delete an XSCF user account

disableuser disable an XSCF user account

dumpconfig save system configuration information to a file

enableuser enable an XSCF user account

exit exit the XSCF shell

flashupdate update the firmware

fmadm fault management configuration tool

license key from the COD license database

Intro 1

Intro(8)

fmdump view fault management logs

fmstat report fault management module statistics

getflashimage download a firmware image file

ioxadm manage External I/O Expansion Units

man display manual pages of specified XSCF shell command

moveboard move an eXtended System Board (XSB) from the current

domain to another

nslookup refer to the DNS server for the host

password manage user passwords and expiration settings

ping send the ICMP ECHO_REQUEST packets to the network

host or the network device

poweroff turn off the power to the specified domain

poweron turn on the power to the specified domain

prtfru display FRUID data on the system and External I/O

Expansion Unit

rebootxscf reset the XSCF

replacefru replace a Field Replaceable Unit (FRU)

reset reset the specified domain

resetdateoffset reset time of domains to match system time

restoreconfig restore the system configuration information previously

saved by dumpconfig

restoredefaults delete the setting and the log information that stored in the

server or the XSCF unit, and restore it to the state as of the factory shipment

sendbreak send a break signal to the specified domain

setaltitude set the altitude of the system or whether or not the air filter

installed

setarchiving configure the log archiving functionality

setaudit manage the system auditing functionality

setautologout set the session timeout time of the XSCF shell

setcod set up the Capacity on Demand (COD) resources used for

domains

setdate set the date and time of XSCF

2 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009

Intro(8)

setdcl set a domain component list (DCL)

setdomainmode set a domain mode

setdomparam forcibly rewrite OpenBoot™ PROM environment variables

setdscp set the IP address assignments for the Domain to Service

Processor Communications Protocol (DSCP)

setdualpowerfeed set dual power feed mode

setemailreport set up the email report configuration data

sethostname set a host name and domain name for an XSCF unit

sethttps start or stop the HTTPS service, which is used in the XSCF

network. This command also performs authenticationrelated settings

setldap configure the Service Processor as a Lightweight Directory

Access Protocol (LDAP) client

setlocale set the default locale of the XSCF

setlocator control the blinking of the CHECK LED on the operator

panel

setloginlockout enable or disable login lockout feature

setlookup enable or disable the use of the Lightweight Directory

Access Protocol (LDAP) server for authentication and privilege lookup

setnameserver set the domain name system (DNS) servers used in the

XSCF network

setnetwork set or remove the network interface that used in XSCF

setntp set the NTP servers used in the XSCF network

setpasswordpolicy manage the system password policy

setpowerupdelay set the warm-up time of the system and wait time before

system startup

setprivileges assign user privileges

setroute set routing information for an XSCF network interface

setshutdowndelay set the shutdown wait time at power interruption of the

uninterruptible power supply (UPS)

setsmtp set up the Simple Mail Transfer Protocol (SMTP) settings

setsnmp manage the SNMP agent

Intro 3

Intro(8)

setsnmpusm specify the SNMPv3 agent’s User-based Security Model

(USM) configuration

setsnmpvacm modify the SNMPv3 agent’s View-based Access Control

Model (VACM) configuration

setssh configure the settings for the Secure Shell (SSH) service

used in the XSCF network

setsunmc start or stop the Sun Management Center agent and make

changes to its configuration

settelnet start or stop the telnet service used in the XSCF network

settimezone set the time zone and Daylight Saving Time of XSCF

setupfru set up device hardware

setupplatform set up platform specific settings

showaltitude display the altitude of the system and whether the air filter

installed

showarchiving display log archiving configuration and status

showaudit display the current auditing system state

showautologout display the session timeout time of the XSCF shell

showboards display information on an eXtended System Board (XSB)

showcod display Capacity on Demand (COD) configuration

information

showcodlicense display the current Capacity on Demand (COD) right-to-

use (RTU) licenses stored in the COD license database

showcodusage display the current usage statistics for Capacity on Demand

(COD) resources

showconsolepath display information on the domain console that is currently

connected

showdate show the date and time of XSCF

showdateoffset display the time differences between the time of the system

and the time of the domains

showdcl display the current domain component list (DCL)

showdevices display current information on an eXtended System Board

(XSB)

showdomainmode display the domain mode

showdomainstatus display the current domain component list (DCL)

4 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009

Intro(8)

showdscp display the IP addresses assigned to the Domain to Service

Processor Communications Protocol (DSCP)

showdualpowerfeed display the current setting of dual power feed mode

showemailreport display the email report configuration data

showenvironment display the air flow volume, intake air temperature and

humidity, temperature sensor, voltage sensor, fan speed, and power consumption information in the server

showfru display the hardware settings of specified device

showhardconf display information about Field Replaceable Units (FRUs)

installed in the system

showhostname display the current host name for the XSCF unit

showhttps display the status of the HTTPS service set for the XSCF

network

showldap display the Lightweight Directory Access Protocol (LDAP)

configuration for the Service Processor

showlocale display the current setting for the XSCF locale

showlocator display the state of the CHECK LED on the operator panel

showloginlockout display the account lockout setting

showlogs display the specified log

showlookup display the configuration for authentication and privileges

lookup

showmonitorlog display the contents of monitoring messages in real time

shownameserver display the registered domain name system (DNS) servers

specified on the XSCF network

shownetwork display information of network interfaces for XSCF

shownotice display copyright and license information for the copyright

information for eXtended System Control Facility (XSCF) Control Package (XCP)

showntp display the NTP servers currently set for the XSCF network

showpasswordpolicy display the current password settings

showpowerupdelay display the current settings for the warm-up time of the

system and wait time before system startup

showresult display the exit status of the most recently executed

command

Intro 5

Intro(8)

showroute display routing information for an XSCF network interface

showshutdowndelay show the shutdown wait time at power interruption of the

uninterruptible power supply (UPS)

showsmtp display the Simple Mail Transfer Protocol (SMTP)

configuration information

showsnmp display the configuration information and current status of

the SNMP agent

showsnmpusm display the current User-based Security Model (USM)

information for the SNMP agent

showsnmpvacm display the current View-based Access Control Access

(VACM) information for the SNMP agent

showssh display the settings of the Secure Shell (SSH) service that

configured for the XSCF network

showstatus display the degraded Field Replaceable Units (FRUs)

showsunmc show setup information and status of Sun Management

Center agent

showtelnet display the current status of the telnet service for the XSCF

network

showtimezone display the XSCF time zone and Daylight Saving Time

information of current settings

showuser display user account information

snapshot collect and transfer environment, log, error, and FRUID

data

switchscf switch the XSCF unit between the active and standby states

testsb perform an initial diagnosis of the specified physical system

board (PSB)

traceroute display the route packets take to the specified network host

or the network device

unlockmaintenance forcibly release the locked status of XSCF

version display firmware version

viewaudit display audit records

who display a list of the user accounts who are logged in to the

XSCF

6 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009

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 The addboard(8) command, based on domain component list (DCL), configures a

XSB into the domain configuration or assigns it to the domain configuration.

The addboard(8) command is not available on the M3000 server.

One of the following configuration methods can be specified:

configure Configures an XSB into the specified domain configuration. The

incorporated XSB can be accessed from the Solaris™ OS.

assign Assigns an XSB to the specified domain. The assigned XSB is

reserved for the specified domain and cannot be configured in or assigned to other domains. The assigned XSB is configured in the domain by reboot or execution of the addboard(8) command with "-c configure".

reserve Reserves incorporation of an XSB into the domain configuration.

The action of "reserve" is the same as "assign."

Privileges You must have one of the following privileges to run this command:

platadm Can run this command for all domains.

domainadm Can run this command only for your managed domains.

Refer to setprivileges(8) for more information.

OPTIONS The following options are supported:

-c assign Assigns an XSB to the domain configuration. If the -c option is omitted, "-c configure" is used.

-c configure Configures an XSB in the domain configuration. If the -c option is omitted, "-c configure" is used.

-c reserve Reserves incorporation of an XSB into the domain configuration. If the -c option is omitted, "-c configure" is used.

System Administration 7

addboard(8)

-d domain_id Specifies the ID of the domain in which an XSB is to be configured or to which it is to be assigned. domain_id can be 0–23 depending on the system configuration.

-f Forcibly incorporates into a domain an XSB.

Caution – If the -f option is used to forcibly add an XSB to a

domain, all the added hardware resources may not work normally. For this reason, use of the -f option is not recommended in normal operation. If the -f option must be specified, verify the status of every added XSB and device.

-h Displays usage statement. When used with other options or operands, an error occurs.

-n Automatically answers "n" (no) to all prompts.

-q Suppresses all messages to stdout, including prompts.

-v Displays a detailed message. If this option is specified with the

-q option, the -v option is ignored.

-y Automatically answers "y" (yes) to all prompts.

OPERANDS The following operand is supported:

xsb Specifies the XSB number to be configured or assigned. Multiple

xsb operands are permitted, separated by spaces. The following

xsb form is accepted:

x–y

where:

x An integer from 00–15.

y An integer from 0–3.

EXTENDED

DESCRIPTION

■ You can execute the addboard(8) command under the environment where the

following services, managed by the Solaris Service Management Facility (SMF), are in operation:

■ Domain SP Communication Protocol (dscp service) is working properly and

the network with XSCF has been established

■ Domain Configuration Server (dcs service) is working properly

■ Sun cryptographic key management daemon (sckmd service) is working

properly

8 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009

addboard(8)

■ When the command is executed, a prompt to confirm execution of the command

with the specified options is displayed. Enter "y" to execute the command or "n" to cancel the command.

■ If "-c configure" is specified when either the domain power has been turned

off or the Solaris OS is not running, an error occurs.

■ When "-c configure" is specified, hardware diagnosis is performed on the XSB

before it is incorporated into the domain. Therefore, command execution may take time.

■ To use the addboard(8) command to configure or assign an XSB, DCL must be

set up in advance using the setdcl(8) command.

■ If the addboard(8) command is executed under the progress of power-on or

power-off processing, the busy status is returned. After that processing in the domain is completed, reexecute the command.

■ See the setdcl(8) and showdcl(8) commands for DCL.

EXAMPLES

EXAMPLE 1 Configures XSB#00-0, #01-0, #02-0, and #03-0 into domain ID 0.

XSCF> addboard -y -c assign -d 0 00-0 01-0 02-0 03-0

EXAMPLE 2 Configures XSB#00-0, #01-0, #02-0, and #03-0 forcibly into domain ID 2.

XSCF> addboard -f -d 2 00-0 01-0 02-0 03-0

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

SEE ALSO deleteboard(8), moveboard(8), replacefru(8), setdcl(8), setdomainmode(8),

setupfru(8), showboards(8),showdcl(8), showdevices(8), showdomainstatus(8), showfru(8), testsb(8)

System Administration 9

addboard(8)

10 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009

addcodlicense(8)

NAME addcodlicense - add a Capacity on Demand (COD) right-to-use (RTU) license key to

the COD license database

SYNOPSIS addcodlicense license-signature

addcodlicense -h

DESCRIPTION addcodlicense(8) adds the COD RTU specified license key to the COD license

database on the Service Processor.

The addcodlicense(8) command is not available on the M3000 server.

When the license key is added, the quantity of headroom is reduced by the quantity provided by the license key. The quantity of headroom cannot be lower than 0.

Note – Before you run this command, you must obtain a COD license key. To

obtain a license key, contact your sales representative. For details on COD RTU license keys, refer to the COD User’s Guide for your server.

Privileges You must have platadm privileges to run this command.

Refer to setprivileges(8) for more information.

OPTIONS The following option is supported:

-h Displays usage statement.

When used with other options or operands, an error occurs.

OPERANDS The following operands are supported:

license-signature Specifies the COD RTU license key to be added to the COD

license database.

EXAMPLES

EXAMPLE 1 Adding a COD RTU License Key

XSCF> addcodlicense \

01:84000000:104:0301010100:3:00000000:xxxxxxxxxxxxxxxxxxxxxx

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

SEE ALSO deletecodlicense(8), setcod(8), showcod(8), showcodlicense(8),

showcodusage(8)

System Administration 11

addcodlicense(8)

12 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008

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.

The following FRUs can be added by the addfru(8) command:

■ CPU/Memory Board unit (CMU)

■ I/O unit (IOU)

■ Fan unit (FANU)

■ Power supply unit (PSU)

Privileges You must have fieldeng privileges to run this command.

addfru(8)

Refer to setprivileges(8) for more information.

OPTIONS The following option is supported:

-h Displays usage statement.

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

SEE ALSO deletefru(8), replacefru(8), setupfru(8), showfru(8), showhardconf(8),

testsb(8), unlockmaintenance(8)

System Administration 13

addfru(8)

14 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008

adduser(8)

NAME adduser - create an XSCF user account

SYNOPSIS adduser [-u UID] user

adduser -h

DESCRIPTION adduser(8) creates a new local XSCF user account. This account is used to

configure, operate, manage and administer the XSCF firmware. Initially, this account has no password. It cannot be used for login until either the password is set (using password(8)) or Secure Shell (SSH) public key authentication is set for the user. The new account will be locked but not disabled. The system can support up to 100 local users with an average length of 10 characters for the user operand.

When invoked without the -u option, adduser automatically assigns a UID for the user account. When invoked with the -u option adduser assigns the given UID to the user account. Automatic UIDs are assigned starting from 100.

If the Service Processor is configured to use Lightweight Directory Access Protocol (LDAP) for user account data, the user name and UID (if specified) must not already be in use, either locally or in LDAP.

When a user is created, adduser(8) command stores the current password policy values in a file for the user. For more information on setting password policy see, setpasswordpolicy(8).

Privileges You must have useradm privileges to run this command.

Refer to setprivileges(8) for more information.

OPTIONS The following options are supported.

-h Displays usage statement.

When used with other options or operands, an error occurs.

-u UID Creates a new user with the given user identifier (UID). Specifying a UID is optional. If specified, the UID must be greater than or equal to 100; and 65534 and 65535 are reserved. If not specified, a UID is automatically assigned.

OPERANDS The following operand is supported:

user Specifies a valid user name to be added. The maximum length of

the user name is 31 characters. A new local XSCF user account name can be a combination of lowercase letters, numbers, "-", or "_". Do not use uppercase letters. The first character must be a letter. ( Examples of acceptable names include jsmith, j_smith, and j_smith-0123.

System Administration 15

adduser(8)

EXAMPLES EXAMPLE 1 Creating a New User

XSCF> adduser -u 359 jsmith

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

SEE ALSO deleteuser(8), disableuser(8), enableuser(8), password(8), setldap(8),

setpasswordpolicy(8), showldap(8), showpasswordpolicy(8), showuser(8)

16 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009

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.

■ XSCF host name

■ DNS domain name

■ IP address

■ netmask

■ routing

When you execute the applynetwork(8)command, it displays the information which has been set to XSCF host name, DNS domain name, name server, IP address, net mask, and routing. After reflected the information of XSCF network, use the rebootxscf(8) command to reset XSCF, to complete the setting.

Note – If XSCF is reset without executing the applynetwork(8) command,

network information that is set is not reflected in XSCF. Also, information that is set is deleted.

Privileges You must have platadm privileges to run this command.

Refer to setprivileges(8) for more information.

OPTIONS The following options are supported:

-h Displays usage statement. When used with other options or

operands, an error occurs.

-M Displays text by page. This option provides a function that is the

same as that of the more command.

-n Automatically answers "n" (no) to all prompts.

-q Suppresses all messages to stdout, including prompts.

-y Automatically answers "y" (yes) to all prompts.

EXTENDED

DESCRIPTION

■ When the command is executed, a prompt to confirm execution of the command

with the specified options is displayed. Enter "y" to execute the command or "n" to cancel the command.

System Administration 17

applynetwork(8)

■ Unless all of the host name, DNS domain name, IP address, net mask, and

routing settings have been made on the target interface, it results in errors. Please execute the sethostname(8) and setnetwork(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,

and net mask settings need to be set on every interface. In these interfaces, if any of these setting items omitted, it results in errors.

■ To specify a host name, use the sethostname(8) command. To specify an IP

address and net mask, use the setnetwork(8) command.

■ When the status is down in all network interfaces, it results in errors.

■ On the M8000/M9000 servers, when you set different netmask in the following

interfaces, it results in errors.

■ xscf#0-lan#0, xscf#1-lan#0, lan#0

■ xscf#0-lan#1, xscf#1-lan#1, lan#1

■ xscf#0-if, xscf#1-if

EXAMPLES

EXAMPLE 1 Reflects the information that has been set for the XSCF network.

On the M3000/M4000/M5000 servers:

XSCF> applynetwork

The following network settings will be applied:

xscf#0 hostname :hostname-0

DNS domain name :example.com

nameserver :10.23.4.3

interface :xscf#0-lan#0

status :up

IP address :10.24.144.214

netmask :255.255.255.0

route :-n 0.0.0.0 -m 0.0.0.0 -g 10.24.144.1

interface :xscf#0-lan#1

status :down

IP address :

netmask :

18 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008

route :

Continue? [y|n] :y

On the M8000/M9000 servers:

XSCF> applynetwork

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 :up

applynetwork(8)

IP address :10.24.144.214

netmask :255.255.255.0

route : -n 0.0.0.0 -m 0.0.0.0 -g 10.24.144.1

interface :xscf#0-lan#1

status :down

IP address :

netmask :

route :

interface :xscf#0-if

status :down

IP address :10.24.100.1

netmask :255.255.255.0

interface :lan#0

status :down

IP address :

netmask :

System Administration 19

applynetwork(8)

interface :xscf#1-lan#0

status :up

IP address :10.24.144.215

netmask :255.255.255.0

route : -n 0.0.0.0 -m 0.0.0.0 -g 10.24.144.1

interface :xscf#1-lan#1

status :down

IP address :

netmask :

route :

interface :xscf#1-if

status :down

IP address :10.24.100.2

netmask :255.255.255.0

interface :lan#1

status :down

IP address :

netmask :

Continue? [y|n] :y

EXAMPLE 2 Reflects the information that has been set for the XSCF network, on the

M3000/M4000/M5000 servers. Automatically answers "y" to all prompts.

XSCF> applynetwork -y

The following network settings will be applied:

xscf#0 hostname :hostname-0

DNS domain name :example.com

nameserver :10.23.4.3

20 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008

interface :xscf#0-lan#0

status :up

IP address :10.24.144.214

netmask :255.255.255.0

route :-n 0.0.0.0 -m 0.0.0.0 -g 10.24.144.1

interface :xscf#0-lan#1

status :down

IP address :

netmask :

route :

applynetwork(8)

Continue? [y|n] :

Please reset the XSCF by rebootxscf to apply the network settings.

Please confirm that the settings have been applied by executing

showhostname, shownetwork, showroute and shownameserver after rebooting

the XSCF.

EXAMPLE 3 Reflects the information that has been set for the XSCF network. Suppresses

prompts, and automatically answers "y" to all prompts.

XSCF> applynetwork -q -y

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

SEE ALSO rebootxscf(8), sethostname(8), setnameserver(8), setnetwork(8), setroute(8)

System Administration 21

applynetwork(8)

22 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008

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 The cfgdevice(8) connects the CD-RW/DVD-RW drive unit and the tape drive

unit to the specified port, disconnects it from the domain, or displays the current status.

The cfgdevice(8) command is available only for the M8000/M9000 servers.

To connect the CD-RW/DVD-RW drive unit and the tape drive unit, the port number which is a PCI slot number on the I/O unit which installed IOU Onboard Device Card A (IOUA) needs to specify. Executing the cfgdevice(8) command, the CD-RW/DVD-RW drive unit and the tape drive unit is connected to specified port by the built-in switching unit.

The current status of the drive that is displayed with this command includes the following types of status information:

port_no Port number of the port where the IOUA is installed and that

can be connected to the CD-RW/DVD-RW drive unit and the tape drive unit. It is displayed in the "IOU number-PCI slot number" format.

IOU/SAS-status Connection status between IOUA and built-in switching unit. It

is changed by specifying "attach"or"detach."

■ enable/disable: Setting status of the cfgdeive(8)

command

enable: Connected with "-c attach." disable: Not connected.

■ up/down: Logical connection between IOUA and built-in

switching unit.

up: Connected. down: Not connected.

System Administration 23

cfgdevice(8)

Privileges You must have platadm or fieldeng privileges to run this command.

OPTIONS The following options are supported:

SAS-status Connection status between I/O unit and the system.

■ enable/disable: Connection setting between I/O unit and

the system. When starting a domain with no I/O unit, the "disable" may be displayed.

enable:Yes disable:No

■ up/down: Logical connection between I/O unit and the

system.

up: Connected. down: Not connected.

Refer to setprivileges(8) for more information.

-c attach Connects the CD-RW/DVD-RW drive unit and the tape drive

unit to the specified port.

EXTENDED

DESCRIPTION

-c detach Disconnects the CD-RW/DVD-RW drive unit and the tape drive unit from the specified port.

-h Displays usage statement. When used with other options or operands, an error occurs.

-l Displays the current status of the CD-RW/DVD-RW drive unit and the tape drive unit currently set up.

-M Displays text by page. This option provides a function that is the same as that of the more command.

-n Automatically answers "n" (no) to all prompts.

-p port_no Specifies the number of the port, in the specified domain, to

which the CD-RW/DVD-RW drive unit and the tape drive unit is to be connected. port_no can be specified in the ’IOU number-PCI slot number’ format. The -p option cannot be omitted.

-q Suppresses all messages to stdout, including prompts.

-y Automatically answers "y" (yes) to all prompts.

■ When the command is executed, a prompt to confirm execution of the command

with the specified options is displayed. Enter "y" to execute the command or "n" to cancel the command.

24 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008

cfgdevice(8)

■ If connection or disconnection is made when the power supply of the system is

ON, settings are made immediately after cfgdevice(8) command execution. When the power supply of the system is OFF, connection or disconnection is reserved and settings are made after the power supply is turned on.

■ The CD-RW/DVD-RW and the tape connection is maintained even if the domain

configuration is changed, or a CPU/Memory Board unit (CMU) or I/O unit (IOU) is replaced with a connected CD-RW/DVD-RW drive unit and the tape drive unit.

■ The CD-RW/DVD-RW and the tape connection is maintained even if the domain

power is turned off or the system is rebooted.

■ The CD-RW/DVD-RW drive unit and the tape drive unit is mounted in each of

the base and expansion cabinets in the M9000 server that has the expansion cabinet. In such cases, each CD-RW/DVD-RW drive unit and the tape drive unit can be connected only to a domain within the cabinet in which the drive is mounted. Settings for connection must be made for both the base cabinet and expansion cabinet.

XSCF> cfgdevice -l

Current connection for DVD/DAT:

Main chassis: port 0-0

Expansion chassis: port 8-0

Expander status

Port No. IOU/SAS-status SAS-status

-----------------------------------

0-0 enable up enable up

0-2 disable down enable up

0-4 disable down enable up

0-6 disable down enable up

1-0 disable down enable up

1-2 disable down enable up

1-4 disable down enable up

1-6 disable down enable up

2-0 disable down enable up

2-2 disable down enable up

2-4 disable down enable up

2-6 disable down enable up

8-0 enable up enable up

System Administration 25

cfgdevice(8)

EXAMPLES EXAMPLE 1 When the system is being powered off, reserves the connection of the CD-

8-2 disable down enable up

8-4 disable down enable up

8-6 disable down enable up

RW/DVD-RW drive unit and the tape drive unit to the port 0-0.

XSCF>

Are you sure you want to attach the device [y|n] :y

Completed.( Reservation )

EXAMPLE 2 When the system is being powered on, connects the CD-RW/DVD-RW drive

cfgdevice -c attach -p 0-0

unit and the tape drive unit to port 0-0.

XSCF> cfgdevice -c attach -p 0-0

Are you sure you want to attach the device [y|n] :y

Completed.

EXAMPLE 3 Disconnects the CD-RW/DVD-RW drive unit and the tape drive unit from

the port 0-0.

XSCF> cfgdevice -f -c detach -p 0-0

Are you sure you want to detach the device [y|n] :y

Completed.

EXAMPLE 4 Displays the status of individual CD-RW/DVD-RW drive unit and the tape

drive unit set on the M8000 server and the M9000 server without the expansion cabinet.

XSCF> cfgdevice -l

Current connection for DVD/DAT: port 0-0

Expander status

Port No. IOU/SAS-status SAS-status

-----------------------------------

0-0 enable up enable up

0-2 disable down enable up

EXAMPLE 5 Displays the status of individual CD-RW/DVD-RW drive unit and the tape

26 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008

drive unit set on the M9000 server with the expansion cabinet.

XSCF> cfgdevice -l

Current connection for DVD/DAT: port 0-0

Main chassis: port 0-0

Expansion chassis: port 8-0

Expander status

Port No. IOU/SAS-status SAS-status

-----------------------------------

0-0 enable up enable up

0-2 disable down enable up

0-4 disable down enable up

0-6 disable down enable up

1-0 disable down enable up

1-2 disable down enable up

cfgdevice(8)

1-4 disable down enable up

1-6 disable down enable up

2-0 disable down enable up

2-2 disable down enable up

2-4 disable down enable up

2-6 disable down enable up

8-0 enable up enable up

8-2 disable down enable up

8-4 disable down enable up

8-6 disable down enable up

EXAMPLE 6 Connects the CD-RW/DVD-RW drive unit and the tape drive unit to port 0-

0 when the system is being powered on. Automatically answers "y" to all prompts.

XSCF>

Are you sure you want to attach the device [y|n] :y

Completed.

cfgdevice -y -c attach -p 0-0

EXAMPLE 7 Connects the CD-RW/DVD-RW drive unit and the tape drive unit to port 0-

0 when the system is being powered on. Automatically answers "y" to all

System Administration 27

cfgdevice(8)

prompts without displaying messages.

XSCF> cfgdevice -q -y -c attach -p 0-0

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

28 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008

clockboard(8)

NAME clockboard - Set or display the clock control unit used at system startup

SYNOPSIS clockboard

clockboard -s CLKU_B-number

clockboard -h

DESCRIPTION The clockboard(8) command specifies the clock control unit used when the

system power is turned on, or it displays the clock control unit that is currently used and the clock control unit used at the next system startup.

The clockboard(8) command is available only for the M8000/M9000 servers.

The number 0 or 1 is used to specify or display a clock control unit. When the clockboard(8) command is executed with no options, the clock control unit that is currently used and the one used at the next system startup are displayed.

Privileges You must have fieldeng privilege to run this command.

Refer to setprivileges(8) for more information.

OPTIONS The following options are supported:

-h Displays usage statement. When used with other options or operands, an error occurs.

-s CLKU_B-number Specifies the clock control unit to be used the next time the system power is turned on. Either 0 or 1 can be specified for CLKU_B-number.

EXAMPLES

EXAMPLE 1 Displays the clock control unit that is currently used and the one used at the

next system startup.

XSCF> clockboard

current CLKU_B number :0

next CLKU_B number :1

EXAMPLE 2 Specifies the clock control unit used at the next system startup.

XSCF> clockboard -s 1

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

System Administration 29

clockboard(8)

30 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008

console(8)

NAME console - connect to a domain console

SYNOPSIS console [[-q] -{y|n}] -d domain_id [-f | -r][-s escapeChar]

console -h

DESCRIPTION The console(8) command connects the XSCF shell console to the console of the

specified domain (domain console).

Domain consoles include a writable console and read-only console. Only one writable console and multiple read-only consoles can be connected to one domain. An attempt to set up a connection to another writable console while one writable console is already connected results in an error. Even in this case, however, a user with the platadm or domainadm privilege can forcibly establish a connection to a writable console, in which case the currently connected writable console is disconnected.

To exit the domain console and return to the XSCF shell console, press the Enter key and then enter "#" and "." (period).

Note – When you return to XSCF shell console without logging out from the

domain, the return causes automatically logging out from the domain.

Privileges You must have one of the following privileges to run this command:

platadm, platop, fieldeng

Can run this command for all domains.

domainadm, domainmgr, domainop

Can run this command only for your accessible domains.

Refer to setprivileges(8) for more information.

OPTIONS The following options are supported.

-d domain_id Specifies only one ID of the domain to which to connect to a

domain console. domain_id can be 0–23 depending on the system configuration.

-f Forcibly connects to a writable console. The currently connected

writable console is disconnected. Only users who belong to the

platadm or domainadm privilege can specify this option.

-h Displays usage statement. When used with other options or

operands, an error occurs.

-n Automatically answers "n" (no) to all prompts.

-q Suppresses all messages to stdout, including prompts.

System Administration 31

console(8)

-r Sets up a connection to a read-only console.

-s escapeChar Specifies an escape character. The default is "#" . The character

specified for escapeChar must be enclosed in """" (double quotation). The following symbols can be specified for escapeChar:

"#", "@", "^", "&", "?", "*", "=", ".", "|"

Specified escape character is available only in the session that executed the console(8) command.

-y Automatically answers "y" (yes) to all prompts.

EXTENDED

DESCRIPTION

■ When the command is executed, a prompt to confirm execution of the command

with the specified options is displayed. Enter "y" to execute the command or "n" to cancel the command.

■ The domain console regards "#" used at the beginning of a line as an escape

character. An escape character is specified to instruct the console to perform special processing. Examples of processing that can be specified in combination with "#" are as follows.

"#" and "?" Outputs a status message.

"#" and "." (period) Disconnects the console.

■ To enter "#" at the beginning of a line, enter "#" twice.

■ To display information on the currently connected domain console, use the

showconsolepath(8) command.

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

SEE ALSO sendbreak(8), showconsolepath(8)

32 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008

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

in which it has been configured.

The deleteboard(8) command is not available on the M3000 server.

One of the following disconnection methods can be specified:

disconnect Disconnects the XSB from the domain configuration but keeps it

assigned. Because the XSB thus remains assigned to the domain configuration, it can be configured again in the domain by reboot the domain or execution of the addboard(8) command.

unassign Completely disconnects the XSB from the main configuration and

puts it in the system board pool. The XSB in the system board pool can be incorporated into or assigned to other domain configurations.

reserve Does not immediately disconnects the XSB from the domain

configuration but only reserves detachment. When the domain power is shut down, the reserved XSB is disconnected from the domain configuration and put in the system board pool.

Privileges You must have one of the following privileges to run this command:

platadm Can run this command for all domains.

domainadm Can run this command only for your managed domains.

Refer to setprivileges(8) for more information.

System Administration 33

deleteboard(8)

OPTIONS The following options are supported.

-c disconnect Detaches the XSB from the domain configuration and keeps it assigned. If the -c option is omitted, "-c disconnect" is used.

-c reset Reserves disconnect of an XSB. If the -c option is omitted, "-c disconnect" is used.

-c unassign Disconnects the XSB completely from the domain configuration

and puts it in the system board pool. If the -c option is omitted, "-c disconnect" is used.

-f Forcibly detaches the specified XSB.

Caution – 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. If the -f option must be specified, verify the status of every added system board and device.

-h Displays usage statement. When used with other options or operands, an error occurs.

-n Automatically answers "n" (no) to all prompts.

-q Suppresses all messages to stdout, including prompts.

-v Displays a detailed message. If this option is specified with the

-q option, the -v option is ignored.

-y Automatically answers "y" (yes) to all prompts.

OPERANDS The following operand is supported:

xsb Specifies the XSB number to be disconnected. Multiple xsb

operands are permitted, separated by spaces. The following xsb form is accepted:

x–y

where:

x An integer from 00–15.

y An integer from 0–3.

34 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009

deleteboard(8)

EXTENDED

DESCRIPTION

■ You can execute the deleteboard(8) command under the environment where

the following services, managed by the Solaris Service Management Facility (SMF), are in operation:

■ Domain SP Communication Protocol (dscp service) is working properly and

the network with XSCF has been established

■ Domain Configuration Server (dcs service) is working properly

■ Sun cryptographic key management daemon (sckmd service) is working

properly

■ When the command is executed, a prompt to confirm execution of the command

with the specified options is displayed. Enter "y" to execute the command or "n" to cancel the command.

■ If "-c 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" is specified when either the domain power has been turned

off or the XSB is already disconnected from the domain configuration, the XSB is switched from the assigned state to a system board pool. If the XSB is already in a system board pool, no operation is performed.

■ If "-c reserve" is specified when either the domain power has been turned off

or the XSB is already disconnected from the domain configuration, the XSB is immediately switched from the assigned state to a system board pool. If the XSB is already in a system board pool, no operation is performed. If domain poweron or power-off is in progress, the command results in an error.

EXAMPLES

■ When the XSB is disconnected, the hardware resource on the XSB is disconnected

from the operating system. For this reason, command execution may take time.

■ The state in which an XSB has been assigned means that configuring the XSB in

the specified domain has been reserved. The reserved XSB is configured when the domain is rebooted or the addboard(8) command is executed. An already assigned XSB cannot be specified for configuring or assignment from other domains.

■ An XSB in the system board pool means that the XSB belongs to no domain and

is therefore available for configuring or assignment.

EXAMPLE 1 Puts the system board XSB#00-0, #01-0, #02-0, and #03-0 in the system board

pool

XSCF> deleteboard -c unassign 00-0 01-0 02-0 03-0

EXAMPLE 2 Reserves disconnection of XSB#00-0, #01-0, #02-0, and #03-0 .

XSCF> deleteboard -c reserve 00-0 01-0 02-0 03-0

System Administration 35

deleteboard(8)

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

SEE ALSO addboard(8), moveboard(8), replacefru(8), setdcl(8), setupfru(8),

showboards(8), showdcl(8), showdevices(8), showdomainstatus(8), showfru(8)

36 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009

deletecodlicense(8)

NAME deletecodlicense - remove a Capacity on Demand (COD) right-to-use (RTU) license

key from the COD license database

SYNOPSIS deletecodlicense [-f] license-signature

deletecodlicense -h

DESCRIPTION The deletecodlicense(8) command removes the specified COD RTU license key

from the COD license database on the Service Processor.

The deletecodlicense(8) command is not available on the M3000 server.

For further information about COD RTU license keys, refer to the Administration Guide.

The system checks the number of COD RTU licenses against the number of COD CPUs in use. If the license removal will result in an insufficient number of COD RTU licenses with respect to the CPU in use, the system does not delete the license key from the COD RTU license database. If you still want to delete the COD RTU license key, you must reduce the number of COD CPUs in use. Power off the appropriate number of domains or disconnect the appropriate number of the eXtended System Boards (XSBs).

Privileges You must have platadm privileges to run this command.

Refer to setprivileges(8) for more information.

OPTIONS The following options are supported:

-f Forces the specified COD RTU license key to be deleted from the COD license database.

-h Displays usage statement.

When used with other options or operands, an error occurs.

OPERANDS The following operands are supported:

license-signature Specifies the COD RTU license key to be deleted from the

COD license database.

EXAMPLES

EXAMPLE 1 Deleting a COD RTU license key

XSCF> deletecodlicense \

01:84000000:104:0301010100:3:00000000:xxxxxxxxxxxxxxxxxxxxxx

System Administration 37

deletecodlicense(8)

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

SEE ALSO addcodlicense(8), setcod(8), showcod(8), showcodlicense(8),

showcodusage(8)

38 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008

NAME deletefru - delete a Field Replaceable Unit (FRU)

SYNOPSIS deletefru

deletefru -h

DESCRIPTION The deletefru(8) command deletes an FRU.

The deletefru(8) command is available only for the M8000/M9000 servers.

The deletefru(8) command allows the user to make the settings that are required for FRU deletion and related to selecting, confirming, and removing FRUs interactively using menus.

The following FRUs can be deleted:

■ CPU/Memory Board unit (CMU)

■ I/O unit (IOU)

Privileges You must have fieldeng privileges to run this command.

Refer to setprivileges(8) for more information.

deletefru(8)

OPTIONS The following option is supported:

-h Displays usage statement.

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

SEE ALSO addfru(8), deleteboard(8), replacefru(8), setupfru(8), showdomainstatus(8),

showfru(8), showhardconf(8), unlockmaintenance(8)

System Administration 39

deletefru(8)

40 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised September 2008

deleteuser(8)

NAME deleteuser - delete an XSCF user account

SYNOPSIS deleteuser user

deleteuser -h

DESCRIPTION deleteuser(8) deletes a local XSCF user account. All local account data associated

with the user account is deleted including password and Secure Shell (SSH) keys.

The local user’s currently running XSCF shell and browser sessions are terminated at once. The user’s account is removed from the system and they cannot log back in. You cannot delete your own account.

Privileges You must have useradm privileges to run this command.

Refer to setprivileges(8) for more information.

OPTIONS The following option is supported:

-h Displays usage statement.

When used with other options or operands, an error occurs.

OPERANDS The following operands are supported:

user Specifies a valid user name. The name of the user account to be

deleted.

EXAMPLES

EXAMPLE 1 Deleting a User

XSCF> deleteuser jsmith

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

SEE ALSO adduser(8), disableuser(8), enableuser(8)

System Administration 41

deleteuser(8)

42 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007

disableuser(8)

NAME disableuser - disable an XSCF user account

SYNOPSIS disableuser user

disableuser -h

DESCRIPTION disableuser(8) disables a local XSCF user account for subsequent logins. Current

sessions are not affected.

When an account is disabled, it cannot be used for login. This applies to console (serial) and telnet connections, as well as the Secure Shell (SSH). XSCF Web login is also disabled. All local XSCF account data associated with the user remains on the system. This includes password and SSH keys. You can reenable a disabled account using enableuser(8).

Privileges You must have useradm privileges to run this command.

Refer to setprivileges(8) for more information.

OPTIONS The following option is supported:

-h Displays usage statement.

When used with other options or operands, an error occurs.

OPERANDS The following operands are supported:

user Specifies a valid user name of the user account to be disabled.

EXAMPLES

EXAMPLE 1 Disabling a User Account

XSCF> disableuser jsmith

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

SEE ALSO adduser(8), deleteuser(8), enableuser(8), showuser(8)

System Administration 43

disableuser(8)

44 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised January 2007

dumpconfig(8)

NAME dumpconfig - save system configuration information to a file

SYNOPSIS dumpconfig [-v ][-V ][[-q] -{y|n} ][-e [-P password ]] [-c comment ][-u

user ][-p proxy [-t proxy_type ]] url

dumpconfig -h

DESCRIPTION The dumpconfig(8) command saves system configuration information, copying it

from the XSCF to a file specified by the user. The information can later be downloaded from that file back to the XSCF using restoreconfig(8).

Privileges You must have platadm, platop, or fieldeng privileges to run this command.

Refer to setprivileges(8) for more information.

OPTIONS The following options are supported:

-c comment Accepts a user-provided comment in the file to distinguish between different backup copies and is not read by the software. This comment must be 132 chars or less in length. Special characters are not allowed in the comment. Special characters are not allowed in the comment.

Allowed characters are [0-9a-zA-Z] and " ". A space is also valid but if spaces are used the entire comment must be enclosed in double quotes.

Some examples:

-c "This is valid comment"

-c This is invalid comment

This example is invalid because spaces are included without quotations.

-c "This! is @invalid"

This example is invalid because special characters are not allowed.

-e Encrypt the file. "-P password" option can be used to specify the password. If a password is not specified the key will be prompted. Once encrypted the configuration file cannot be decrypted without the key. If the key is lost, there is no possibility of recovering the configuration data.

-h Displays usage statement. When used with other options or operands, an error occurs.

-n Automatically answers "n"(no) to all prompts.

System Administration 45

dumpconfig(8)

-P password With -e option, password can be provided on command line. The command will prompt for the password if a password is not provided on command line.

-p proxy Specifies the proxy server to be used for transfers. The default transfer type is http, unless modified using the -t proxy_type option. The value for proxy must be in the format servername:port.

-q Suppresses all messages to stdout, including prompts.

-t proxy_type Used with the -p option to specify the type of proxy. Possible

values for proxy_type are: http, socks4, and socks5. The default value is http.

-u user Specifies the user name when logging in to a remote ftp or http server that requires authentication. You will be prompted for a password.

-v Displays verbose output. This may be helpful when diagnosing server problems.

-V Displays details of network activity. This may be helpful when diagnosing network or server problems.

-y Automatically answers "y"(yes) to all prompts.

OPERANDS The following operands are supported:

url Specifies the URL where the configuration will be dumped.

Supported formats for this value include the following:

http://server[:port]/path/file

https://server[:port]/path/file

ftp://server[:port]/path/file

file:///media/usb_msd/path/file

EXAMPLES

EXAMPLE 1 Dumping the Configuration using FTP

XSCF> dumpconfig -V -p 129.145.155.156:8080 -u minilla ftp:/

10.7.79.18/sollgell/proxytest-ftp.cfg

transfer from ’/tmp/dumpconfig.EvY1Yf’ to ’ftp://10.7.79.18/sollgell/ proxytest-ftp.cfg’

Password:

* About to connect() to 129.145.155.166 port 8080

* Trying 129.145.155.166... * connected

46 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009

* Connected to 129.145.155.166 (129.145.155.166) port 8080

* Proxy auth using (nil) with user ’’

* Server auth using Basic with user ’minilla’

> PUT ftp://10.7.79.18/iktest/proxytest-ftp.cfg HTTP/1.1

Authorization: Basic bHdhbmc6bHdhbmc=

User-Agent: dumpconfig

Host: 10.7.79.18:21

Pragma: no-cache

Accept: */*

Content-Length: 24720

Expect: 100-continue

< HTTP/1.1 100 Continue

< HTTP/1.1 200 OK

< Server: Sun-Java-System-Web-Proxy-Server/4.0

< Date: Mon, 04 Aug 2008 16:46:11 GMT

dumpconfig(8)

< Transfer-encoding: chunked

* Connection #0 to host 129.145.155.166 left intact

* Closing connection #0

operation completed

XSCF>

EXAMPLE 2 Dumping the Configuration Using http

XSCF>

dumpconfig -v -p 129.145.155.166:8080 http://10.7.79.18/

sollgell/proxytest.cfg

reading database ... ..............*done

creating temporary file ... done

starting file transfer ...done

removing temporary file ... done

operation completed

XSCF>

System Administration 47

dumpconfig(8)

EXAMPLE 3 Dumping the Configuration Using Https

XSCF> dumpconfig -V -p 129.145.155.166:8080 http://10.7.79.18/

sollgell/proxytest-https.cfg

transfer from ’/tmp/dumpconfig.ZMCI3d’ to ’http://10.7.79.18/iktest/ proxytest-https.cfg’

* About to connect() to 129.145.155.166 port 8080

* Trying 129.145.155.166... * connected

* Connected to 129.145.155.166 (129.145.155.166) port 8080

> > PUT http://10.7.79.18/iktest/proxytest-https.cfg HTTP/1.1

User-Agent: dumpconfig

Host: 10.7.79.18

Pragma: no-cache

Accept: */*

Content-Length: 24720

Expect: 100-continue

< HTTP/1.1 100 Continue

< HTTP/1.1 204 No Content

< Content-type: text/html

< Date: Mon, 04 Aug 2008 16:42:46 GMT

< Server: Apache/1.3.36 (Unix) mod_perl/1.29 mod_ssl/2.8.27 OpenSSL/0.9.7d

< Via: 1.1 proxy-proxy

< Proxy-agent: Sun-Java-System-Web-Proxy-Server/4.0

* Connection #0 to host 129.145.155.166 left intact

* Closing connection #0

operation completed

XSCF>

EXAMPLE 4 Dumping the Configuration Using USB

XSCF>

Making sure mount point is clear

Trying to mount USB device /dev/sda1 as /media/usb_msd

dumpconfig -v -V file:///media/usb_msd/proxytest.cfg

Mounted USB device

file ’/media/usb_msd/proxytest.cfg’ already exists

Do you want to overwrite this file? [y|n]: y

48 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised August 2009

dumpconfig(8)

removing file ’file:///media/usb_msd/proxytest.cfg’ ... done

reading database ... ..............*done

creating temporary file ... done

starting file transfer ...transfer from ’/tmp/dumpconfig.HE1RZa’ to

’file:///media/usb_msd/san-ff1-54.cfg’

done

removing temporary file ... done

operation completed

Unmounted USB device

XSCF>

EXAMPLE 5 Encrypting and Password Protecting the Configuration

XSCF>

dumpconfig -v -e -P kamacuras -p 129.145.155.166:8080 http:/

/10.7.79.18/sollgell/proxytest.cfg

reading database ... ..............*done

creating temporary file ... done

starting file transfer ...done

removing temporary file ... done

operation completed

XSCF>

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

Sun Microsystems M900, M4000, M3000, M5000, M8000 Reference Manual

Specifications and Main Features

Frequently Asked Questions

User Manual