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

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 anyaffiliate 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 affiliate 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 affiliates haveany liabilityto any third
party underany legal theory for anyloss ofrevenues or profits, 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 affilié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éaffilié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 filiales ne sauraientêtre tenues
responsables envers une quelconquepartie tierce,sous quelque théoriejuridique quece soit, de tout manqueà gagner ou de pertede profit,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

v

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.

xi

… 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 authentication­related 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