Oracle Sun SPARC Enterprise M3000, Sun SPARC Enterprise M8000, Sun SPARC Enterprise M9000, Sun SPARC Enterprise M5000, Sun SPARC Enterprise M4000 Reference Manual

Sun SPARC Enterprise

M3000/M4000/M5000/

M8000/M9000 Servers

XSCF Reference Manual for XCP Version 109x

Part No. 821-0338-11
July 2010, Revision A

Copyright 2007,2010, Oracle and/or its affiliates andFUJITSU LIMITED.All rights reserved.

Oracle and/orits affiliatesand 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.

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 thisdocument, may bereproduced in any formby any means without prior
written authorizationof Oracle and/or its affiliates andFujitsu Limited, and their applicablelicensors, ifany.The furnishings of this document
to youdoes not give you anyrights or licenses, express or implied, withrespect tothe productor technology towhich itpertains, and this
document doesnot contain or representany commitment ofany kindon the part of Oracleor Fujitsu Limited, or anyaffiliate ofeither of them.

This documentand the product and technology described inthis document may incorporate third-party intellectualproperty copyrightedby
and/or licensedfrom thesuppliers to Oracle and/or itsaffiliates andFujitsu Limited, including software andfont 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 contactOracle and/or itsaffiliates orFujitsu Limited.

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.
Oracle andJava areregistered trademarksof Oracle and/or its affiliates. Fujitsuand the Fujitsu logo are registered trademarks of Fujitsu

Limited.
All SPARCtrademarks areused under license and are registered trademarks of SPARCInternational, Inc.in the U.S.and othercountries.

Products bearing SPARC trademarksare basedupon architecturesdeveloped by Oracle and/or itsaffiliates. SPARC64is a trademark of SPARC
international, Inc.,used under license by FujitsuMicroelectronics, Inc.and FujitsuLimited. Other names may betrademarks of their respective
owners.

United StatesGovernment Rights - Commercial use. U.S. Governmentusers aresubject to the standard governmentuser licenseagreements of
Oracle and/orits affiliatesand Fujitsu Limited and theapplicable provisionsof the FAR andits supplements.

Disclaimer: Theonly warranties granted by Oracleand Fujitsu Limited, and/or anyaffiliate ofeither of them in connectionwith this document
or anyproduct ortechnology described herein are those expressly set forth inthe license agreement pursuant towhich theproduct or
technology isprovided. EXCEPTAS EXPRESSLY SET FORTH IN SUCHAGREEMENT,ORACLE OR FUJITSU LIMITED, AND/ORTHEIR
AFFILIATESMAKE NOREPRESENTATIONS OR WARRANTIES OFANY KIND (EXPRESS OR IMPLIED)REGARDING SUCH PRODUCT
OR TECHNOLOGYOR THIS DOCUMENT, WHICHARE ALLPROVIDED AS IS, AND ALLEXPRESS OR IMPLIED CONDITIONS,
REPRESENTATIONS ANDWARRANTIES,INCLUDING WITHOUT LIMITATIONANY IMPLIEDWARRANTYOF MERCHANTABILITY,
FITNESS FORA PARTICULAR PURPOSEOR NON-INFRINGEMENT, ARE DISCLAIMED,EXCEPT TOTHE EXTENT THAT SUCH
DISCLAIMERS AREHELD TOBE LEGALLY INVALID. Unless otherwise expressly setforth insuch agreement, to the extentallowed by
applicable law, inno event shall Oracle orFujitsu Limited, and/or any oftheir affiliateshave any liability to anythird partyunder any legal
theory forany loss of revenues or profits, lossof useor data, or business interruptions,or for any indirect, special, incidental orconsequential
damages, evenif advised of the possibilityof such damages.

DOCUMENTATION ISPROVIDED “AS IS” AND ALLEXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONSAND WARRANTIES,
INCLUDING ANYIMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT,
ARE DISCLAIMED,EXCEPT TOTHE EXTENT THAT SUCHDISCLAIMERS AREHELD TO BE LEGALLY INVALID.

Copyright ©2007, 2010, Oracle et/ou sessociétés affiliéeset FUJITSU LIMITED. Tous droits réservés.
Oracle et/ouses sociétés affiliées et Fujitsu Limited détiennentet contrôlent chacune des droits depropriété intellectuellerelatifs auxproduits

et technologiesdécrits dans ce document. Demême, cesproduits, technologies et ce documentsont protégéspar des lois sur lecopyright, des
brevets, d’autres lois surla propriétéintellectuelle et des traités internationaux.

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 sous quelque
forme quece soit, par quelque moyenque ce soit, sans l’autorisationécrite préalabled’Oracle et/ou sessociétés affiliéeset de Fujitsu Limited, et
de leurséventuels bailleurs de licence. Cedocument, bien qu’il vous aitété fourni,ne vous confère aucun droitet aucunelicence, expresses ou
tacites, concernantle produitou la technologie auxquels ilse rapporte. Par ailleurs, ilne contient ni ne représente aucun engagement,de
quelque typeque ce soit, de lapart d’Oracle ou de FujitsuLimited, oudes sociétés affiliées de l’uneou l’autreentité.

Ce document,ainsi que les produits et technologies qu’ildécrit, peuvent inclure des droits de propriété intellectuelle departies tierces protégés
par copyrightet/ou cédés sous licence pardes fournisseursà Oracle et/ouses sociétésaffiliées et Fujitsu Limited, ycompris des logiciels et des
technologies relatives auxpolices de caractères.

Conformément auxconditions dela licence GPL ou LGPL,une copiedu codesource régipar la licence GPL ouLGPL, selonle cas, est disponible
sur demandepar l’Utilisateur final. Veuillez contacter Oracleet/ou sessociétés affiliéesou Fujitsu Limited.

Cette distributionpeut comprendredes composantsdéveloppés par desparties tierces.
Des partiesde ce produit peuvent être dérivées dessystèmes BerkeleyBSD, distribués sous licence parl’Université de Californie. UNIX estune

marque déposée aux États-Uniset dans d’autres pays, distribuéeexclusivement souslicence par X/Open Company, Ltd.
Oracle etJava sont des marques déposées d’Oracle Corporationet/ou de ses sociétés affiliées. Fujitsuet le logo Fujitsu sontdes marques

déposées deFujitsu Limited.

Please

Recycle

Toutes les marquesSPARCsont utiliséessous licence etsont desmarques déposées de SPARC International, Inc.,aux États-Unis et dans
d’autres pays. Les produitsportant lamarque SPARC reposentsur des architectures développées parOracle et/ouses sociétés affiliées.
SPARC64 est unemarque deSPARCInternational, Inc., utiliséesous licencepar Fujitsu Microelectronics, Inc. et Fujitsu Limited.Toutautre nom
mentionné peutcorrespondre àdes marquesappartenant à d’autres propriétaires.

United StatesGovernment Rights - Commercial use. U.S. Governmentusers aresubject to the standard governmentuser licenseagreements of
Oracle and/orits affiliatesand Fujitsu Limited and theapplicable provisionsof the FAR andits supplements.

Avis de non-responsabilité :les seulesgaranties octroyées par Oracle etFujitsu Limited et/ou toute sociétéaffiliée del’une ou l’autre entité en
rapport avecce document ou tout produit ou toutetechnologie décrits dans les présentescorrespondent auxgaranties expressément stipulées
dans lecontrat de licence régissant leproduit oula technologie fournis. SAUF MENTIONCONTRAIRE EXPRESSÉMENT STIPULÉE DANS
CE CONTRAT,ORACLE OU FUJITSU LIMITED ETLES SOCIÉTÉS AFFILIÉES À L’UNE OU L’AUTRE ENTITÉREJETTENT TOUTE
REPRÉSENTATION OUTOUTE GARANTIE, QUELLE QU’EN SOITLA NATURE (EXPRESSE OUIMPLICITE) CONCERNANTCE
PRODUIT,CETTE TECHNOLOGIEOU CE DOCUMENT, LESQUELSSONT FOURNIS EN L’ÉTAT. EN OUTRE, TOUTES LESCONDITIONS,
REPRÉSENTATIONS ETGARANTIES EXPRESSES OU TACITES,Y COMPRIS NOTAMMENT TOUTE GARANTIE IMPLICITERELATIVEÀ
LA QUALITÉMARCHANDE, À L’APTITUDE À UNE UTILISATION PARTICULIÈRE OUÀ L’ABSENCE DE CONTREFAÇON, SONT
EXCLUES, DANSLA MESUREAUTORISÉE PAR LALOI APPLICABLE. Sauf mention contraire expressément stipuléedans cecontrat, dansla
mesure autorisée par laloi applicable, en aucun casOracle ou Fujitsu Limited et/oul’une ou l’autre de leurs sociétés affiliéesne sauraientêtre
tenues responsables enversune quelconque partie tierce, sous quelque théoriejuridique que ce soit, detout manque à gagner oude perte de
profit, de problèmes d’utilisationou deperte de données,ou d’interruptionsd’activités, ou de tout dommageindirect, spécial,secondaire ou
consécutif, mêmesi ces entités ont étépréalablement informées d’une telle éventualité.

LA DOCUMENTATIONEST FOURNIE « EN L’ÉTAT »ET TOUTE AUTRE CONDITION, DÉCLARATION ETGARANTIE, EXPRESSE OU
TACITE,EST FORMELLEMENTEXCLUE, DANS LA MESURE AUTORISÉE PAR LA LOIEN VIGUEUR,Y COMPRIS NOTAMMENT TOUTE
GARANTIE IMPLICITERELATIVEÀ LA QUALITÉMARCHANDE, ÀL’APTITUDE À UNE UTILISATION PARTICULIÈRE OUÀ
L’ABSENCEDE CONTREFAÇON.

Contents

Preface xi

Intro 1
addboard 9
addcodactivation 13
addcodlicense 15
addfru 17
adduser 19
applynetwork 21
cfgdevice 29
clockboard 35
console 37
deleteboard 39
deletecodactivation 43
deletecodlicense 45
deletefru 47
deleteuser 49
disableuser 51
dumpconfig 53
enableuser 59
exit 61
flashupdate 63
fmadm 67
fmdump 69

v

fmstat 77
getflashimage 81
ioxadm 87
man 97
moveboard 99
nslookup 103
password 105
ping 109
poweroff 111
poweron 115
prtfru 119
rebootxscf 123
replacefru 125
reset 127
resetdateoffset 131
restoreconfig 133
restoredefaults 141
sendbreak 147
setad 149
setaltitude 157
setarchiving 159
setaudit 163
setautologout 169
setcod 171
setdate 175
setdcl 179
setdomainmode 185
setdomparam 193
setdscp 197
setdualpowerfeed 201
setemailreport 203
sethostname 207
sethttps 211
setldap 217

vi SPARC Enterprise Mx000 Servers XSCF Reference Manual • July 2010

setldapssl 221
setlocale 229
setlocator 231
setloginlockout 233
setlookup 235
setnameserver 237
setnetwork 241
setntp 247
setpacketfilters 251
setpasswordpolicy 257
setpowerupdelay 261
setprivileges 263
setroute 267
setshutdowndelay 273
setsmtp 275
setsnmp 279
setsnmpusm 285
setsnmpvacm 289
setssh 293
settelnet 299
settimezone 301
setupfru 309
setupplatform 311
showad 317
showaltitude 321
showarchiving 323
showaudit 327
showautologout 331
showboards 333
showcod 339
showcodactivation 341
showcodlicense 343
showcodusage 345
showconsolepath 351

Contents vii

showdate 353
showdateoffset 355
showdcl 359
showdevices 365
showdomainmode 371
showdomainstatus 375
showdscp 377
showdualpowerfeed 381
showemailreport 383
showenvironment 385
showfru 391
showhardconf 393
showhostname 407
showhttps 409
showldap 411
showldapssl 413
showlocale 417
showlocator 419
showloginlockout 421
showlogs 423
showlookup 439
showmonitorlog 441
shownameserver 443
shownetwork 445
shownotice 451
showntp 453
showpacketfilters 457
showpasswordpolicy 459
showpowerupdelay 461
showresult 463
showroute 465
showshutdowndelay 469
showsmtp 471
showsnmp 473

viii SPARC Enterprise Mx000 Servers XSCF Reference Manual • July 2010

showsnmpusm 477
showsnmpvacm 479
showssh 481
showstatus 485
showtelnet 487
showtimezone 489
showuser 493
snapshot 495
switchscf 503
testsb 505
traceroute 511
unlockmaintenance 515
version 517
viewaudit 521
who 529

Contents ix

x SPARC Enterprise Mx000 Servers XSCF Reference Manual • July 2010

Preface

This manual contains the man pages for the eXtended System Control Facility
(XSCF) firmware for Oracle’s 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 • July 2010

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

addcodactivation add a Capacity on Demand (COD) activation key to the

COD Hardware Activation database

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 apply XSCF network information to the XSCF

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

deletecodactivation remove a Capacity on Demand (COD) activation key from

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

domain configuration

the COD Hardware Activation database

license key from the COD license database

Intro 1

Intro(8)

exit exit the XSCF shell

flashupdate update the firmware

fmadm fault management configuration tool

fmdump view fault management logs

fmstat report fault management module statistics

getflashimage download a firmware image file

ioxadm manage External I/O Expansion Units and add-in cards

that contain Energy Storage Modules and are attached to
the host system

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

setad configure Active Directory

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

2 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010

installed

Intro(8)

exit exit the XSCF shell

flashupdate update the firmware

fmadm fault management configuration tool

fmdump view fault management logs

fmstat report fault management module statistics

getflashimage download a firmware image file

ioxadm manage External I/O Expansion Units and add-in cards

that contain Energy Storage Modules and are attached to
the host system

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

setad configure Active Directory

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

installed

Intro 3

Intro(8)

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

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

setldapssl configure LDAP/SSL

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 and the DNS

search paths used in the XSCF network

setnetwork set or remove the network interface that used in XSCF

setntp set the NTP servers used on the XSCF network, the stratum

value, the preferred server and the clock address of the
local clock of XSCF

4 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010

Intro(8)

setpacketfilters set the IP packet filtering rules to be 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

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

showad show Active Directory configuration and messages

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

showcodactivation display the current Capacity on Demand (COD) activation

permits stored in the COD Hardware Activation database

Intro 5

Intro(8)

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 differences between system time and domain times

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)

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

showldapssl show LDAP/SSL configuration and messages

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

6 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010

Intro(8)

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

and the DNS search paths 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

showpacketfilters show the IP packet filtering rules that are set in 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

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

Intro 7

Intro(8)

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

8 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010

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 9

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

10 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 11

addboard(8)

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

addcodactivation(8)

NAME addcodactivation - add a Capacity on Demand (COD) activation key to the COD

Hardware Activation database

SYNOPSIS addcodactivation key_signature

addcodactivation -h

DESCRIPTION addcodactivation(8) adds the specified COD activation key to the COD

Hardware Activation database on the Service Processor.

This command is not available on the M3000 server.

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

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

contact your sales representative. For details on COD keys, refer to the SPARC
Enterprise M4000/M5000/M8000/M9000 Servers Capacity on Demand (COD) User’s
Guide.

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 operand is supported:

key_signature Specifies the key to be added to the COD database.

EXAMPLES

EXAMPLE 1 Adding a Key

XSCF> addcodactivation \

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

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

SEE ALSO SPARC Enterprise M4000/M5000/M8000/M9000 Servers Capacity on Demand (COD)

User’s Guide

System Administration 13

addcodactivation(8)

14 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010

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 SPARC Enterprise M4000/M5000/M8000/M9000 Servers Capacity on Demand (COD)

User’s Guide

System Administration 15

addcodlicense(8)

16 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010

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 17

addfru(8)

18 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.

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

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). If
specified, the UID must be between 100 and 60000, inclusive. If not
specified, a UID is automatically assigned with a minimum value
of 100.

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 19

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), setad(8),

setldap(8), setldapssl(8), setpasswordpolicy(8), showad(8), showldap(8),
showldapssl(8), showpasswordpolicy(8), showuser(8)

20 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010

applynetwork(8)

NAME applynetwork - apply XSCF network information to the XSCF

SYNOPSIS applynetwork [[-q] -{y|n}][-M]

applynetwork -h

DESCRIPTION applynetwork(8) command applies XSCF network information that has been set

to the XSCF.

Setting network information on XSCF is a three-step process:

1. Set the information with the following commands:

■ sethostname(8) - Set XSCF host name and a DNS domain name

■ setnameserver(8) - Set a DNS server name and a DNS search path

■ setnetwork(8) - Set IP address and netmask of XSCF network interface

■ setroute(8) - Set routing information of XSCF network interface

2. Execute the applynetwork(8) command to apply the settings to XSCF.

3. Execute the rebootxscf(8) command to make the changes to the XSCF

permanent.

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

network information that is set is not applied 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.

-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 21

applynetwork(8)

■ Use the appropriate network commands to specify the following settings, then

execute the applynetwork(8) command. All these settings must be present and
proper or the XSCF network settings will not be applied.

■ XSCF host name (sethostname(8))

■ DNS domain name (sethostname(8))

■ IP address and netmask of XSCF network interface (setnetwork(8))

■ On M8000/M9000 servers, use the sethostname(8) command to set host names

to both xscf#0 and xscf#1.

■ On M3000/M4000/M5000 servers, use the setnetwork(8) command to set

xscf#0-lan#0 and xscf#0-lan#1 so that at least one is up. If both are up, they must
use different subnets.

■ On M8000/M9000 servers, if xscf#0-lan#0, xscf#1-lan#0, xscf#0-lan#1, and xscf#1-

lan#1 are all in down status, an error results.

■ On M8000/M9000 servers, if the network interface which is in the up status has

the following settings, it results in an error. Use the setnetwork(8) command to
set up correctly.

■ If the subnet of xscf#0-lan#0, xscf#1-lan#0, and the takeover IP address lan#0

are different

EXAMPLES

■ If the subnet of xscf#0-lan#1, xscf#1-lan#1, and the takeover IP address lan#1

are different

■ If the subnet of ISN is different

■ If the subnet of xscf#0-lan#0, xscf#0-lan#1, and xscf#0-if are the same

■ If the subnet of xscf#1-lan#0, xscf#1-lan#1, and xscf#1-if are the same

■ In case the total number of the characters of the DNS domain name that you set

by using the sethostname(8) command and of the search path that you set by
using the setnameserver(8) command exceeds 256, it results in an error.

■ In the setnameserver(8) command, if you do not set the DNS server but set the

search path alone, an error results.

■ On M8000/M9000 servers, do not execute the applynetwork(8) command

during XSCF failover.

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

On M3000/M4000/M5000 servers:

XSCF> applynetwork

The following network settings will be applied:

xscf#0 hostname :hostname-0

DNS domain name :example.com

22 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010

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 :

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.

y

On 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

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

System Administration 23

applynetwork(8)

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 :

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

24 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010

applynetwork(8)

interface :lan#1

status :down

IP address :

netmask :

Continue? [y|n] :y

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

Please confirm that the settings have been applied by executing

showhostname, shownetwork, showroute and shownameserver after rebooting

the XSCF.

EXAMPLE 2 Applies the information that has been set for the XSCF network, on 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

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 :

Continue? [y|n] :y

System Administration 25

applynetwork(8)

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 Applies the information that has been set for the XSCF network. Suppresses

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

XSCF> applynetwork -q -y

EXAMPLE 4 Sets the name server and the search path and then applies the XSCF network

settings.

XSCF> applynetwork

The following network settings will be applied:

xscf#0 hostname :hostname-0

DNS domain name :example.com

nameserver :10.23.4.3

nameserver :10.24.144.3

nameserver :10.24.131.7

search :example1.com

search :example2.com

search :example3.com

search :example4.com

search :example5.com

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 :

26 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010

applynetwork(8)

route :

Continue? [y|n] :y

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

Please confirm that the settings have been applied by executing

showhostname, shownetwork, showroute and shownameserver after rebooting

the XSCF.

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 27

applynetwork(8)

28 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010

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 29

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.

30 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 31

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 expan­sion 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

32 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 33

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.

34 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 35

clockboard(8)

36 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010

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 37

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)

38 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 39

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.

40 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 power­on 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 41

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)

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

deletecodactivation(8)

NAME deletecodactivation - remove a Capacity on Demand (COD) activation key from the

COD Hardware Activation database

SYNOPSIS deletecodactivation [-f] key-signature

deletecodactivation -h

DESCRIPTION The deletecodactivation(8) command removes the specified COD activation key

from the COD Hardware Activation database on the Service Processor.

This command is not available on the M3000 server.

Note – For details on COD keys, refer to the SPARC Enterprise M4000/M5000/

M8000/M9000 Servers Capacity on Demand (COD) User’s Guide.

The system checks the number of COD permits against the number of COD CPUs
in use. If the permit removal will result in an insufficient number of COD permits
with respect to the CPUs in use, the system does not delete the key from the COD
Hardware Activation database. If you still want to delete the COD 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 key to be deleted from the COD database.

-h Displays usage statement.

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

OPERANDS The following operands are supported:

key-signature Specifies the key to be deleted from the COD database.

EXAMPLES

EXAMPLE 1 Deleting a key

XSCF> deletecodactivation \

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

System Administration 43

deletecodactivation(8)

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

SEE ALSO SPARC Enterprise M4000/M5000/M8000/M9000 Servers Capacity on Demand (COD)

User’s Guide

44 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010

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 SPARC Enterprise
M4000/M5000/M8000/M9000 Capacity on Demand (COD) User’s 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 45

deletecodlicense(8)

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

SEE ALSO SPARC Enterprise M4000/M5000/M8000/M9000 Servers Capacity on Demand (COD)

User’s Guide

46 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010

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 47

deletefru(8)

48 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 49

deleteuser(8)

50 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 51

disableuser(8)

52 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 53

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

54 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 55

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

56 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.

SEE ALSO restoreconfig(8)

System Administration 57

dumpconfig(8)

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

enableuser(8)

NAME enableuser - enable an XSCF user account

SYNOPSIS enableuser user

enableuser -h

DESCRIPTION enableuser(8) enables a local XSCF user account. An enabled account can be used

for login at the console, using Secure Shell (SSH). Using this command, you can
reenable accounts disabled by disableuser.

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 the valid user name of the account to be enabled.

EXAMPLES

EXAMPLE 1 Enable a User Account

XSCF> enableuser jsmith

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

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

System Administration 59

enableuser(8)

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

NAME exit - exit the XSCF shell

SYNOPSIS exit

DESCRIPTION The exit(1) command exits and closes the XSCF shell.

Privileges No privileges are required to run this command.

Refer to setprivileges(8) for more information.

exit(1)

System Administration 61

exit(1)

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

NAME flashupdate - update the firmware

SYNOPSIS flashupdate -c check -m xcp -s version

flashupdate [[-q] -{y|n}] -c update -m xcp -s version

flashupdate -c sync

flashupdate -h

DESCRIPTION The flashupdate(8) command updates the firmware.

The entire firmware shown below is updated. Whether update can be performed
can be checked beforehand.

■ Update of the entire firmware (XSCF, OpenBoot PROM including Power-On Self-

Test (POST)) (xcp)

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

Refer to setprivileges(8) for more information.

OPTIONS The following options are supported:.

flashupdate(8)

-c check Checks whether the specified firmware can be updated.

-c update Updates the specified firmware. In the M8000/M9000 servers,

updates the firmware of both XSCF units.

-c sync Synchronizes the firmware versions of the XSCF units in the
M8000/M9000 servers. This option is used when replacing an
XSCF unit.

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

-m xcp Specifies the entire firmware as a target.

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

System Administration 63

flashupdate(8)

-q Suppresses all messages to stdout, including prompts.

-s version Specifies an XCP comprehensive firmware version. For version,

specify a major version, minor version and micro version
continuously.

The XCP version number appears as xyyz by four digits, where:

x Major firmware release number

yy Minor release number

z Micro release number

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

EXTENDED

DESCRIPTION

EXAMPLES

■ 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.

■ When the firmware is updated, the XSCF unit is reset. Therefore, LAN

connection to the XSCF is canceled if already established.

■ When there's a faulty Field Replaceable Unit (FRU), can't update the firmware.

Resolve the FRU fault then update.

EXAMPLE 1 Check whether the entire firmware can be updated to version 1082.

XSCF> flashupdate -c check -m xcp -s 1082

EXAMPLE 2 Updates the entire firmware to version from 1080 to 1082.

XSCF> flashupdate -c update -m xcp -s 1082

The XSCF will be reset. Continue? [y|n] :y

XCP update is started (XCP version=1082:last version=1080)

OpenBoot PROM update is started (OpenBoot PROM version=02090000)

OpenBoot PROM update has been completed (OpenBoot PROM version=02090000)

XSCF update is started (XSCFU=0,bank=1,XCP version=1082:last version=1080)

XSCF download is started (XSCFU=0,bank=1,XCP version=1082:last

version=1080, Firmware Element ID=00:version=01080001:last
version=01080000)

XSCF download has been completed (XSCFU=0,bank=1,XCP version=1082:last

version=1080, Firmware Element ID=00:version=01080001:last
version=01080000)

:

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

flashupdate(8)

:

XSCF download is started (XSCFU=0,bank=1,XCP version=1082:last

version=1080, Firmware Element ID=07:version=01080004:last
version=01080000)

XSCF download has been completed (XSCFU=0,bank=1,XCP version=1082:last

version=1080, Firmware Element ID=07:version=01080004:last
version=01080000)

XSCF update has been completed (XSCFU=0,bank=1,XCP version=1082:last

version=1080)

XCP update is started (XCP version=1082:last version=1080)

OpenBoot PROM update is started (OpenBoot PROM version=02090000)

OpenBoot PROM update has been completed (OpenBoot PROM version=02090000)

XSCF update is started (XSCFU=0,bank=0,XCP version=1082:last version=1080)

XSCF download is started (XSCFU=0,bank=0,XCP version=1082:last

version=1080, Firmware Element ID=00:version=01080001:last
version=01080000)

XSCF download has been completed (XSCFU=0,bank=0,XCP version=1082:last

version=1080, Firmware Element ID=00:version=01080001:last
version=01080000)

:

:

XSCF download is started (XSCFU=0,bank=0,XCP version=1082:last

version=1080, Firmware Element ID=07:version=01080004:last
version=01080000)

XSCF download has been completed (XSCFU=0,bank=0,XCP version=1082:last

version=1080, Firmware Element ID=07:version=01080004:last
version=01080000)

XSCF update has been completed (XSCFU=0,bank=0,XCP version=1082:last

version=1080)

XSCF is rebooting to update the reserve bank

EXAMPLE 3 Synchronizes the firmware version of the replaced XSCF units in the M8000/

M9000 servers.

XSCF>

flashupdate -c sync

System Administration 65

flashupdate(8)

EXIT STATUS The following exit values are returned:

0 Successful completion

>0 An error occurred.

SEE ALSO version(8)

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

fmadm(8)

NAME fmadm - fault management configuration tool

SYNOPSIS fmadm [-q] config

fmadm -h

DESCRIPTION fmadm (8) can be used to view system configuration parameters related to fault

management.

fmadm can be used to:

View the set of diagnosis engines and agents that are currently participating in
fault management

View the list of system components that have been diagnosed as faulty

The Fault Manager attempts to automate as many activities as possible, so use of
fmadm is typically not required. When the Fault Manager needs help from a human
administrator or service representative, it produces a message indicating its needs.
It also refers you to a URL containing the relevant knowledge article. The web site
might ask you to use fmadm or one of the other fault management utilities to gather
more information or perform additional tasks. The documentation for fmdump(8)
describes more about tools to observe fault management activities.

Privileges You must have platop, platadm,orfieldeng 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.

-q Sets quiet mode. fmadm does not produce messages indicating the

result of successful operations to standard output.

OPERANDS The following operands are supported:

config Displays the configuration of the Fault Manager itself, including

the module name, version, and description of each component
module. Fault Manager modules provide services such as
automated diagnosis, self-healing, and messaging for hardware
and software present on the system.

System Administration 67

fmadm(8)

EXAMPLES EXAMPLE 1 Displaying the Fault Manager Configuration

XSCF> fmadm config

MODULE VERSION STATUS DESCRIPTION

case-close 1.0 active Case-Close Agent

fmd-self-diagnosis 1.0 active Fault Manager Self-Diagnosis

sysevent-transport 1.0 active SysEvent Transport Agent

syslog-msgs 1.0 active Syslog Messaging Agent

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

SEE ALSO fmdump(8), fmstat(8)

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

fmdump(8)

NAME fmdump - view fault management logs

SYNOPSIS fmdump

fmdump [-e][-f][-M][-v][-V][-c class][-t time][-T time][-u uuid]

fmdump -m [-M][-t time][-T time]

fmdump -h

DESCRIPTION The fmdump utility displays the contents of any of the logs associated with the Fault

Manager (fault manager daemon). The Fault Manager runs in the background on
each server. It records, in the error log, faults detected by the XSCF, and initiates
proactive self-healing activities, such as disabling faulty components.

The Fault Manager maintains two sets of logs for use by system administrators and
service personnel:

Error log Records error telemetry, the symptoms of problems detected by

the system

Fault log Records fault diagnosis information; the problems believed to

explain these symptoms. By default, fmdump displays the
contents of the fault log, which records the result of each
diagnosis made by the fault manager or one of its component
modules.

Each problem recorded in the fault log is identified by:

■ The time of its diagnosis

■ A Universal Unique Identifier (UUID) that can be used to uniquely identify this

particular problem across any set of systems

■ A message identifier (MSG-ID) that can be used to access a corresponding

knowledge article located at the specified website.

If a problem requires action by a system administrator or service personnel or
affects system behavior, the Fault Manager also issues a human-readable message.

This message provides a summary of the problem and a reference to the knowledge
article on the specified website.

You can use the -v and -V options to expand the display from a single-line
summary to increased levels of detail for each event recorded in the log. You can
also use the -M option to display only one screen at a time. The -c, -t, -T,and-u
options can be used to filter the output by selecting only those events that match
the specified class, range of times, or uuid. If more than one filter option is present
on the command line, the options combine to display only those events that are
selected by the logical AND of the options. If more than one instance of the same

System Administration 69

fmdump(8)

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

OPTIONS The following options are supported.

filter option is present on the command-line, the like options combine to display
any events selected by the logical OR of the options.

You can use the -m option to display the Fault Manager syslog contents.

Refer to setprivileges(8) for more information.

-c class Selects events that match the specified class. The class argument
can use the global pattern matching syntax, which is similar to
global pattern matching for files. For example xyz.* would match
xyz.sxc and xyz.pdf. The class represents a hierarchical
classification string indicating the type of telemetry event.

-h Displays usage statement.

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

-e Displays events from the fault management error log instead of the
fault log.

The error log contains private telemetry information used by
XSCF’s automated diagnosis software. This information is recorded
to facilitate post-mortem analysis of problems and event replay,
and should not be parsed or relied upon for the development of
scripts and other tools.

-f Displays only lines that have been appended to the dump file since
the command was executed. Output continues until interrupted by

Ctrl-C.

-m Displays the Fault Manager syslog message contents.

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

-t time Selects events that occurred at or after the specified time. The time

can be specified using the forms in the Time Formats following this
section. Used with -T you can specify a range.

-T time Selects events that occurred at or before the specified time. time can
be specified using any of the time formats described for the -t
option. Used with -t you can specify a range.

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

fmdump(8)

-u uuid Selects fault diagnosis events that exactly match the specified uuid.
Each diagnosis is associated with a UUID for identification
purposes. The -u option can be combined with other options such
as -v to show all of the details associated with a particular
diagnosis.

If the -e option and -u option are specified at the same time,

fmdump displays the relevant error events.

-v Displays verbose event detail. The event display is enlarged to

show additional common members of the selected events.

-V Displays very verbose event detail. The event display is enlarged
to show every member of the name-value pair list associated with
each event. In addition, for fault logs, the event display includes a
list of cross-references to the corresponding errors that were
associated with the diagnosis.

The following are the Time Formats:

Time Format Description

mm/dd/yy hh:mm:ss Month, day, year, hour in 24-hour format, minute, and

second. Any amount of whitespace can separate the
date and time. The argument should be quoted so that
the shell interprets the two strings as a single
argument.

mm/dd/yy hh:mm Month, day, year, hour in 24-hour format, and minute.

Any amount of whitespace can separate the date and
time. The argument should be quoted so that the shell
interprets the two strings as a single argument.

mm/dd/yy 12:00:00AM on the specified month, day, and year

ddMonyy hh:mm:ss Day, month name, year, hour in 24-hour format,

minute, and second. Any amount of whitespace can
separate the date and time. The argument should be
quoted so that the shell interprets the two strings as a
single argument.

Mon dd hh:mm:ss Month, day, hour in 24-hour format, minute, and

second of the current year. Any amount of whitespace
can separate the date and time. The argument should
be quoted so that the shell interprets the two strings as
a single argument.

System Administration 71

fmdump(8)

Time Format Description

yyyy-mm-dd[Thh:mm[:ss]] Year, month, day, and optional hour in 24-hour format,

minute, and second, where T is an integer value
specified in base 10. The second, or hour, minute, and
second, can be optionally omitted.

ddMonyy 12:00:00AM on the specified day, month name, and

year.

hh:mm:ss Hour in 24-hour format, minute, and second of the

current day.

hh:mm Hour in 24-hour format and minute of the current day.

Tns | Tnsec T nanoseconds ago where T is an integer value

specified in base 10.

Tu s | Tusec T microseconds ago where T is an integer value

specified in base 10

Tms | Tmsec T milliseconds ago where T is an integer value

specified in base 10.

EXAMPLES

Ts | Tsec T seconds ago where T is an integer value specified in

base 10.

Tm | Tmin T minutes ago where T is an integer value specified in

base 10.

Th | Thour T hours ago where T is an integer value specified in

base 10.

Td | Tday T days ago where T is an integer value specified in

base 10.

You can append a decimal fraction of the form .n to any -t option argument to
indicate a fractional number of seconds beyond the specified time.

EXAMPLE 1 Default fmdump Display

XSCF> fmdump

TIME UUID MSG-ID

Aug 12 16:12:13.2811 7868c1cc-23d4-c575-8659-85cdbe61842e FMD-8000-77

Aug 12 16:12:13.2985 7868c1cc-23d4-c575-8659-85cdbe61842e FMD-8000-77

Sep 01 16:06:57.5839 3ceca439-b0b2-4db1-9123-c8ace3f2b371 FMD-8000-77

Sep 01 16:06:57.6278 3ceca439-b0b2-4db1-9123-c8ace3f2b371 FMD-8000-77

Sep 06 09:37:05.0983 6485b42b-6638-4c5d-b652-bec485290788 LINUX-8000-1N

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

fmdump(8)

Sep 06 09:38:10.8584 77435994-5b99-4db8-bdcd-985c7d3ae3e4 LINUX-8000-1N

Sep 06 09:57:44.6502 0087d58c-e5b9-415d-91bc-adf7c41dd316 LINUX-8000-1N

Sep 06 12:40:59.2801 97de2cef-8ea1-407a-8a53-c7a67e61987a LINUX-8000-1N

Sep 06 12:41:10.1076 fa7304f9-c9e8-4cd1-9ca5-e35f57d53b2c LINUX-8000-1N

Sep 06 13:01:49.1462 ce550611-4308-4336-8a9a-19676f828515 LINUX-8000-1N

Sep 06 15:42:56.6132 0f4b429f-c048-47cd-9d9f-a2f7b6d4c957 LINUX-8000-1N

Sep 06 16:07:14.4652 7d5fb282-e01b-476a-b7e1-1a0f8de80758 LINUX-8000-1N

Sep 06 16:08:16.3755 41379237-9750-4fd6-bce3-b5131d864d34 LINUX-8000-1N

Sep 29 14:49:27.8452 0455ceaa-e226-424a-9b34-27603ca603f1 FMD-8000-58

Sep 29 15:02:00.3039 fb550ebc-80e9-41c8-8afc-ac680b9eb613 FMD-8000-58

Sep 29 15:09:25.4335 8cec9a83-e2a3-4dc3-a7cd-de01caef5c63 FMD-8000-4M

Sep 29 15:10:09.6151 5f88d7d5-a107-4435-99c9-7c59479d22ed FMD-8000-58

EXAMPLE 2 Display in Verbose Mode

XSCF>

TIME UUID MSG-ID

Nov 30 20:44:55.1283 9f773e33-e46f-466c-be86-fd3fcc449935 FMD-8000-0W

100% defect.sunos.fmd.nosub

:

EXAMPLE 3 Display Very Verbose Event Detail for the Last UUID

XSCF> fmdump -e -V -u 5f88d7d5-a107-4435-99c9-7c59479d22ed

TIME CLASS

Sep 29 2005 15:10:09.565220864 ereport.io.iox.cp.seeprom0.nresp

nvlist version: 0

detector = (embedded nvlist)

nvlist version: 0

scheme = hc

version = 0

hc-root = /

fmdump -v

hc-list_sz = 0x1

hc-list = (array of embedded nvlists)

(start hc-list[0])

System Administration 73

fmdump(8)

nvlist version: 0

scheme = hc

hc-name = iox

hc-id = 0

(end hc-list[0])

(end detector)

IOXserial_no = 123456

class = ereport.io.iox.cp.seeprom0.nresp

ena = 0x921b650000000001

EXAMPLE 4 Displaying the Full Fault Report for the Specified UUID

XSCF>

TIME UUID MSG-ID

Sep 29 15:10:09.6151 5f88d7d5-a107-4435-99c9-7c59479d22ed FMD-8000-58

TIME CLASS ENA

Sep 29 15:10:09.5652 ereport.io.iox.cp.seeprom0.nresp
0x921b650000000001

nvlist version: 0

version = 0x0

class = list.suspect

uuid = 5f88d7d5-a107-4435-99c9-7c59479d22ed

code = FMD-8000-58

diag-time = 1128021009 615016

de = (embedded nvlist)

nvlist version: 0

version = 0x0

scheme = fmd

authority = (embedded nvlist)

fmdump -V -u 5f88d7d5-a107-4435-99c9-7c59479d22ed

nvlist version: 0

version = 0x0

product-id = SUNW,SPARC-Enterprise

chassis-id = BF0000001V

server-id = localhost

(end authority)

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

mod-name = sde

mod-version = 1.13

(end de)

fault-list-sz = 0x1

fault-list = (array of embedded nvlists)

(start fault-list[0])

nvlist version: 0

version = 0x0

class = fault.io.iox.cp.seeprom

certainty = 0x64

fru = (embedded nvlist)

nvlist version: 0

scheme = hc

version = 0x0

hc-root =

fmdump(8)

hc-list-sz = 0x1

hc-list = (array of embedded nvlists)

(start hc-list[0])

nvlist version: 0

hc-name = iox

hc-id = 0

(end hc-list[0])

(end fru)

(end fault-list[0])

EXAMPLE 5 Displaying Contents of the Fault Manager syslog Message

XSCF>

MSG-ID: FMD-8000-11, TYPE: Defect, VER: 1, SEVERITY: Minor

EVENT-TIME: Tue Nov 7 07:01:44 PST 2006

PLATFORM: SUNW,SPARC-Enterprise, CSN: 7860000764, HOSTNAME: san-ff2-20-0

SOURCE: sde, REV: 1.5

fmdump -m -M

EVENT-ID: 2daddee0-2f42-47ee-b5b2-57ae6a41bfc0

System Administration 75

fmdump(8)

DESC: A Solaris Fault Manager component generated a diagnosis for which no
message summary exists. Refer to http://www.sun.com/msg/FMD-8000-11 for
more information.

AUTO-RESPONSE: The diagnosis has been saved in the fault log for examination
by Sun.

IMPACT: The fault log will need to be manually examined using fmdump(1M)
in order to determine if any human response is required.

MSG-ID: FMD-8000-11, TYPE: Defect, VER: 1, SEVERITY: Minor

EVENT-TIME: Tue Nov 7 07:03:25 PST 2006

PLATFORM: SUNW,SPARC-Enterprise, CSN: 7860000764, HOSTNAME: san-ff2-20-0

SOURCE: sde, REV: 1.5

EVENT-ID: 2b03ab60-96db-439d-a13a-2f420a1b73c7

DESC: A Solaris Fault Manager component generated a diagnosis for which no
message summary exists. Refer to http://www.sun.com/msg/FMD-8000-11 for
more information.

AUTO-RESPONSE: The diagnosis has been saved in the fault log for examination
by Sun.

IMPACT: The fault log will need to be manually examined using fmdump(1M)
in order to determine if any human response is required.

EXIT STATUS The following exit values are returned:

0 Successful completion. All records in the log file were examined

successfully.

>0 An error occurred.

SEE ALSO fmadm(8), fmstat(8)

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

fmstat(8)

NAME fmstat - report fault management module statistics

SYNOPSIS fmstat [-a][[-s][-z][-m module]] [ interval [ count]]

fmstat -h

DESCRIPTION The fmstat utility can be used by system administrators and service personnel to

report statistics associated with the Fault Manager (fault manager daemon), and its
associated set of modules. The Fault Manager runs in the background on each
system. It receives telemetry information relating to problems detected by the
system software, diagnoses these problems, and initiates proactive self-healing
activities such as disabling faulty components.

You can use fmstat to view statistics for diagnosis engines and agents that are
currently participating in fault management. The fmadm(8), and fmdump(8) man
pages describe more about tools to observe fault management activities.

If the -m option is present, fmstat reports any statistics kept by the specified fault
management module. The module list can be obtained using fmadm config.

If the -m option is not present, fmstat reports the following statistics for each of its
client modules:

module The name of the fault management module as reported by

fmadm config.

ev_recv The number of telemetry events received by the module.

ev_acpt The number of events accepted by the module as relevant to a

diagnosis.

wait The average number of telemetry events waiting to be examined

by the module.

svc_t The average service time for telemetry events received by the

module, in milliseconds.

%w The percentage of time that there were telemetry events waiting

to be examined by the module.

%b The percentage of time that the module was busy processing

telemetry events.

open The number of active cases (open problem investigations)

owned by the module.

System Administration 77

fmstat(8)

solve The total number of cases solved by this module since it was

loaded.

memsz The amount of dynamic memory currently allocated by this

module.

bufsz The amount of persistent buffer space currently allocated by this

module.

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

Refer to setprivileges(8) for more information.

OPTIONS The following options are supported.

-a Prints the default global statistics for the Fault Manager or a
module. If used without the -m module option, the default global
Fault Manager statistics are displayed. If used with the -m module
option, the global statistics for a module are displayed.

-h Displays usage statement.

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

-m module Prints a report on the statistics associated with the specified fault
management module, instead of the default statistics report.

Modules can publish an arbitrary set of statistics to help service the
fault management software itself.

If used without the -a option, displays only those statistics kept by
the module. If used with the -a option, displays statistics kept by
the module and the global statistics associated with the module.

-s Prints a report on Soft Error Rate Discrimination (SERD) engines
associated with the module instead of the default module statistics
report. A SERD engine is a construct used by fault management
software to determine if a statistical threshold measured as N
events in some time T has been exceeded. The -s option can only
be used in combination with the -m option.

-z Omits statistics with a zero value from the report associated with
the specified fault management module. The -z option can only be
used in combination with the -m option.

OPERANDS The following operands are supported:

count Print only count reports, and then exit.

interval Print a new report every interval seconds.

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

fmstat(8)

If neither count nor interval is specified, a single report is printed and fmstat exits.

If an interval is specified but no count is specified, fmstat prints reports every
interval seconds indefinitely until the command is interrupted by Ctrl-C.

EXAMPLES

EXAMPLE 1 Displaying FM Statistics for the Syslog Module

XSCF> fmstat -a -m syslog-msgs

NAME VALUE DESCRIPTION

bad_code 0 event code has no dictionary name

bad_fmri 0 event fmri is missing or invalid

bad_time 0 event time is not properly encoded

bad_vers 0 event version is missing or invalid

fmd.accepted 0 total events accepted by module

fmd.buflimit 10M limit on total buffer space

fmd.buftotal 0 total buffer space used by module

fmd.caseclosed 0 total cases closed by module

fmd.caseopen 0 cases currently open by module

fmd.casesolved 0 total cases solved by module

fmd.ckptcnt 0 number of checkpoints taken

fmd.ckptrestore true restore checkpoints for module

fmd.ckptsave true save checkpoints for module

fmd.ckpttime 0d total checkpoint time

fmd.ckptzero false zeroed checkpoint at startup

fmd.debugdrop 4 dropped debug messages

fmd.dequeued 1 total events dequeued by module

fmd.dispatched 1 total events dispatched to module

fmd.dlastupdate 1144424838299131us hrtime of last event dequeue completion

fmd.dropped 0 total events dropped on queue overflow

fmd.dtime 0d total processing time after dequeue

fmd.loadtime 1144424251692484us hrtime at which module was loaded

fmd.memlimit 10M limit on total memory allocated

fmd.memtotal 97b total memory allocated by module

fmd.prdequeued 0 protocol events dequeued by module

fmd.snaptime 1144424838299148us hrtime of last statistics snapshot

fmd.thrlimit 8 limit on number of auxiliary threads

System Administration 79

fmstat(8)

fmd.thrtotal 0 total number of auxiliary threads

fmd.wcnt 0 count of events waiting on queue

fmd.wlastupdate 1144424838299131us hrtime of last wait queue update

fmd.wlentime 30us total wait length * time product

fmd.wtime 30us total wait time on queue

fmd.xprtlimit 256 limit on number of open transports

fmd.xprtopen 0 total number of open transports

fmd.xprtqlimit 256 limit on transport event queue length

log_err 0 failed to log message to log(7D)

msg_err 0 failed to log message to sysmsg(7D)

no_msg 0 message logging suppressed

XSCF>

module ev_recv ev_acpt wait svc_t %w %b open solve memsz bufsz

case-close 0 0 0.0 0.0 0 0 0 0 0 0

fmd-self-diagnosis 1 1 0.0 0.2 0 0 1 0 27b 0

sysevent-transport 0 0 0.0 573.2 0 0 0 0 0 0

syslog-msgs 0 0 0.0 0.0 0 0 0 0 97b 0

EXAMPLE 2 Displaying FM Statistics for fmd Self-Diagnosis Module

XSCF> fmstat -z -m fmd-self-diagnosis

NAME VALUE DESCRIPTION

module 1 error events received from fmd modules

fmstat

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

SEE ALSO fmadm(8), fmdump(8)

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

getflashimage(8)

NAME getflashimage - download a firmware image file

SYNOPSIS getflashimage [-v][[-q] -{y|n}][-u user][-p proxy [-t proxy_type]] url

getflashimage -l

getflashimage [[-q] -{y|n}][-d]

getflashimage -h

DESCRIPTION The getflashimage(8) command downloads a firmware image file for use by the

flashupdate(8) command.

If any previous image files of the firmware are present on the XSCF unit, they are
deleted prior to downloading the new version. After successful download, the
image file is checked for integrity, and the MD5 checksum is displayed.

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

Refer to setprivileges(8) for more information.

OPTIONS The following options are supported:

-d Deletes all previous firmware image files still on the XSCF unit,
then exits.

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

-l Lists firmware image files that are still on the XSCF unit, then exits.

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

-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.
(Refer to Example 3.)

-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
network or server problems.

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

System Administration 81

getflashimage(8)

OPERANDS The following operands are supported:

url Specifies the URL of the firmware image to download. 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

where the value for file is in one of the following formats:

XCPvvvv.tar.gz

IKXCPvvvv.tar.gz

FFXCPvvvv.tar.gz

DCXCPvvvv.tar.gz

EXAMPLES

and vvvv is the four-character version number.

EXAMPLE 1 Downloading a Version from an http Server

XSCF> getflashimage http://imageserver/images/FFXCP1041.tar.gz

Existing versions:

Version Size Date

FFXCP1040.tar.gz 46827123 Wed Mar 14 19:11:40 2007

Warning: About to delete existing versions.

Continue? [y|n]: y

Removing FFXCP1040.tar.gz.

0MB received

1MB received

2MB received

...

43MB received

44MB received

45MB received

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

getflashimage(8)

Download successful: 46827KB at 1016.857KB/s

Checking file...

MD5: e619e6dd367c888507427e58cdb8e0a0

EXAMPLE 2 Downloading a Version from an ftp Server

XSCF> getflashimage ftp://imageserver/images/FFXCP1041.tar.gz

Existing versions:

Version Size Date

FFXCP1040.tar.gz 46827123 Wed Mar 14 19:11:40 2007

Warning: About to delete existing versions.

Continue? [y|n]: y

Removing FFXCP1040.tar.gz.

0MB received

1MB received

2MB received

...

43MB received

44MB received

45MB received

Download successful: 46827KB at 1016.857KB/s

Checking file...

MD5: e619e6dd367c888507427e58cdb8e0a1

EXAMPLE 3 Downloading Using an http Proxy Server With Port 8080

XSCF> getflashimage -p webproxy.sun.com:8080 \

http://imageserver/images/FFXCP1041.tar.gz

Existing versions:

Version Size Date

FFXCP1040.tar.gz 46827123 Wed Mar 14 19:11:40 2007

Warning: About to delete existing versions.

Continue? [y|n]: y

Removing FFXCP1040.tar.gz.

0MB received

System Administration 83

getflashimage(8)

1MB received

2MB received

...

43MB received

44MB received

45MB received

Download successful: 46827KB at 1016.857KB/s

Checking file...

MD5: e619e6dd367c888507427e58cdb8e0a2

EXAMPLE 4 Downloading Using a User Name and Password

XSCF>

getflashimage -u jsmith \

http://imageserver/images/FFXCP1041.tar.gz

Existing versions:

Version Size Date

FFXCP1040.tar.gz 46827123 Wed Mar 14 19:11:40 2007

Warning: About to delete existing versions.

Continue? [y|n]: y

Removing FFXCP1040.tar.gz.

Password: [not echoed]

0MB received

1MB received

2MB received

...

43MB received

44MB received

45MB received

Download successful: 46827KB at 1016.857KB/s

Checking file...

MD5: e619e6dd367c888507427e58cdb8e0a3

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

getflashimage(8)

EXAMPLE 5 Downloading From a USB Memory Stick

XSCF> getflashimage file:///media/usb_msd/images/FFXCP1041.tar.gz

Existing versions:

Version Size Date

FFXCP1040.tar.gz 46827123 Wed Mar 14 19:11:40 2007

Warning: About to delete existing versions.

Continue? [y|n]:

Removing FFXCP1040.tar.gz.

Mounted USB device

0MB received

1MB received

...

44MB received

45MB received

Download successful: 46827 Kbytes in 109 secs (430.094 Kbytes/sec)

Checking file...

MD5: e619e6dd367c888507427e58cdb8e0a4

y

EXIT STATUS The following exit values are returned:

0 Successful completion.

>0 An error occurred.

SEE ALSO flashupdate(8)

System Administration 85

getflashimage(8)

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

NAME ioxadm - manage External I/O Expansion Units and add-in cards that contain

Energy Storage Modules and are attached to the host system

SYNOPSIS ioxadm [-f][-p][-v][-M] env [-e][-l][-t][ target [ sensors]]

ioxadm [-f][-p][-v][-M] lifetime [ target | -z target]

ioxadm [-f][-p][-v][-M] list [ target]

ioxadm [-f][-p][-v][-M] locator [on|off] [ target]

ioxadm [-f][-p][-v][-M] poweroff target

ioxadm [-f][-p][-v][-M] poweron target

ioxadm [-f][-p][-v][-M] reset target

ioxadm(8)

ioxadm [-f][-p

][-v][-M] setled [ on|off|slow|fast] target led_type

ioxadm -h

DESCRIPTION ioxadm(8) manages External I/O Expansion Units, link cards, and cards that

contain Energy Storage Modules (ESM) and are attached to the host system.

The M3000 server does not support External I/O Expansion Units.

When using this utility you must specify an operand, and any options that operand
requires. The target device can be a card mounted in a built-in PCI slot in the host
system; an External I/O Expansion Unit; or a field replaceable unit (FRU) in an
External I/O Expansion Unit. The card in the host system is identified by a string
that specifies the host path to the card. A linkcard installed in the host system is
called a downlink. A linkcard installed in an I/O Expansion Unit boat is called an
uplink.

For more information, see target in OPTIONS.

Privileges You must have one of the following privileges to run these commands:

Required Privileges Operands

platop env, list

platadm env, list, locator, poweroff, poweron

fieldeng All operands

Refer to setprivileges(8) for more information.

System Administration 87

ioxadm(8)

OPTIONS The following options are supported.

-f Forces command execution by ignoring warnings.

-h Displays usage statement.

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

-M Displays text by page.

-p Displays only parsable output, suppressing headers in that output.

Fields are separated by single tabs.

-v Displays verbose output. Refer to specific operands for details.

target Specifies the target device, which can be a card mounted in a built-

in PCI slot in the host system; an External I/O Expansion Unit; or
a field replaceable unit (FRU) in an External I/O Expansion Unit.

The card in the host slot is identified by the host_path to the card.

host_path is platform dependent and indicates the path to the
slot on the host system that contains the card. The host_path has
the following format:

IOU#0-PCI#0 IO Board 0, PCI-E slot0

The External I/O Expansion Unit (box_id) is identified by serial
number.

Use iox@nnnn, where nnnn represents the last four digits of the
box serial number.

Some commands affect only a single component of an External
I/O Expansion Unit system. For example, individual boats and
power supplies can be turned on and turned off independently.

A FRU in an External I/O Expansion Unit (fru) is identified as:

iox@nnnn/iob0 – I/O boat in the left tray (rear view)
iox@nnnn/iob1 – I/O boat in the right tray (rear view)
iox@nnnn/iob0/link – Uplink card in boat 0
iox@nnnn/iob1/link – Uplink card in boat 1
iox@nnnn/ps0 – Power supply in the left bay (front view)
iox@nnnn/ps1 – Power supply in the right bay (front view)

88 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised April 2010