Page is loading ...
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
Please
Recycle
Copyright 2007, 2010, Oracle and/or its affiliates and FUJITSU LIMITED. All rights reserved.
Oracle and/or its affiliates and Fujitsu Limited each own or control intellectual property rights relating to products and technology described in
this document, and such products, technology and this document are protected by copyright laws, patents, and other intellectual property laws
and international treaties.
This document and the product and technology to which it pertains are distributed under licenses restricting their use, copying, distribution,
and decompilation. No part of such product or technology, or of this document, may be reproduced in any form by any means without prior
written authorization of Oracle and/or its affiliates and Fujitsu Limited, and their applicable licensors, if any. The furnishings of this document
to you does not give you any rights or licenses, express or implied, with respect to the product or technology to which it pertains, and this
document does not contain or represent any commitment of any kind on the part of Oracle or Fujitsu Limited, or any affiliate of either of them.
This document and the product and technology described in this document may incorporate third-party intellectual property copyrighted by
and/or licensed from the suppliers to Oracle and/or its affiliates and Fujitsu Limited, including software and font technology.
Per the terms of the GPL or LGPL, a copy of the source code governed by the GPL or LGPL, as applicable, is available upon request by the End
User. Please contact Oracle and/or its affiliates or Fujitsu Limited.
This distribution may include materials developed by third parties.
Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in
the U.S. and in other countries, exclusively licensed through X/Open Company, Ltd.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Fujitsu and the Fujitsu logo are registered trademarks of Fujitsu
Limited.
All SPARC trademarks are used under license and are registered trademarks of SPARC International, Inc. in the U.S. and other countries.
Products bearing SPARC trademarks are based upon architectures developed by Oracle and/or its affiliates. SPARC64 is a trademark of SPARC
international, Inc., used under license by Fujitsu Microelectronics, Inc. and Fujitsu Limited. Other names may be trademarks of their respective
owners.
United States Government Rights - Commercial use. U.S. Government users are subject to the standard government user license agreements of
Oracle and/or its affiliates and Fujitsu Limited and the applicable provisions of the FAR and its supplements.
Disclaimer: The only warranties granted by Oracle and Fujitsu Limited, and/or any affiliate of either of them in connection with this document
or any product or technology described herein are those expressly set forth in the license agreement pursuant to which the product or
technology is provided. EXCEPT AS EXPRESSLY SET FORTH IN SUCH AGREEMENT, ORACLE OR FUJITSU LIMITED, AND/OR THEIR
AFFILIATES MAKE NO REPRESENTATIONS OR WARRANTIES OF ANY KIND (EXPRESS OR IMPLIED) REGARDING SUCH PRODUCT
OR TECHNOLOGY OR THIS DOCUMENT, WHICH ARE ALL PROVIDED AS IS, AND ALL EXPRESS OR IMPLIED CONDITIONS,
REPRESENTATIONS AND WARRANTIES, INCLUDING WITHOUT LIMITATION ANY IMPLIED WARRANTY OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH
DISCLAIMERS ARE HELD TO BE LEGALLY INVALID. Unless otherwise expressly set forth in such agreement, to the extent allowed by
applicable law, in no event shall Oracle or Fujitsu Limited, and/or any of their affiliates have any liability to any third party under any legal
theory for any loss of revenues or profits, loss of use or data, or business interruptions, or for any indirect, special, incidental or consequential
damages, even if advised of the possibility of such damages.
DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES,
INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT,
ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.
Copyright © 2007, 2010, Oracle et/ou ses sociétés affiliées et FUJITSU LIMITED. Tous droits réservés.
Oracle et/ou ses sociétés affiliées et Fujitsu Limited détiennent et contrôlent chacune des droits de propriété intellectuelle relatifs aux produits
et technologies décrits dans ce document. De même, ces produits, technologies et ce document sont protégés par des lois sur le copyright, des
brevets, d’autres lois sur la propriété intellectuelle et des traités internationaux.
Ce document, le produit et les technologies afférents sont exclusivement distribués avec des licences qui en restreignent l’utilisation, la copie, la
distribution et la décompilation. Aucune partie de ce produit, de ces technologies ou de ce document ne peut être reproduite sous quelque
forme que ce soit, par quelque moyen que ce soit, sans l’autorisation écrite préalable d’Oracle et/ou ses sociétés affiliées et de Fujitsu Limited, et
de leurs éventuels bailleurs de licence. Ce document, bien qu’il vous ait été fourni, ne vous confère aucun droit et aucune licence, expresses ou
tacites, concernant le produit ou la technologie auxquels il se rapporte. Par ailleurs, il ne contient ni ne représente aucun engagement, de
quelque type que ce soit, de la part d’Oracle ou de Fujitsu Limited, ou des sociétés affiliées de l’une ou l’autre entité.
Ce document, ainsi que les produits et technologies qu’il décrit, peuvent inclure des droits de propriété intellectuelle de parties tierces protégés
par copyright et/ou cédés sous licence par des fournisseurs à Oracle et/ou ses sociétés affiliées et Fujitsu Limited, y compris des logiciels et des
technologies relatives aux polices de caractères.
Conformément aux conditions de la licence GPL ou LGPL, une copie du code source régi par la licence GPL ou LGPL, selon le cas, est disponible
sur demande par l’Utilisateur final. Veuillez contacter Oracle et/ou ses sociétés affiliées ou Fujitsu Limited.
Cette distribution peut comprendre des composants développés par des parties tierces.
Des parties de ce produit peuvent être dérivées des systèmes Berkeley BSD, distribués sous licence par l’Université de Californie. UNIX est une
marque déposée aux États-Unis et dans d’autres pays, distribuée exclusivement sous licence par X/Open Company, Ltd.
Oracle et Java sont des marques déposées d’Oracle Corporation et/ou de ses sociétés affiliées. Fujitsu et le logo Fujitsu sont des marques
déposées de Fujitsu Limited.
Toutes les marques SPARC sont utilisées sous licence et sont des marques déposées de SPARC International, Inc., aux États-Unis et dans
d’autres pays. Les produits portant la marque SPARC reposent sur des architectures développées par Oracle et/ou ses sociétés affiliées.
SPARC64 est une marque de SPARC International, Inc., utilisée sous licence par Fujitsu Microelectronics, Inc. et Fujitsu Limited. Tout autre nom
mentionné peut correspondre à des marques appartenant à d’autres propriétaires.
United States Government Rights - Commercial use. U.S. Government users are subject to the standard government user license agreements of
Oracle and/or its affiliates and Fujitsu Limited and the applicable provisions of the FAR and its supplements.
Avis de non-responsabilité : les seules garanties octroyées par Oracle et Fujitsu Limited et/ou toute société affiliée de l’une ou l’autre entité en
rapport avec ce document ou tout produit ou toute technologie décrits dans les présentes correspondent aux garanties expressément stipulées
dans le contrat de licence régissant le produit ou la technologie fournis. SAUF MENTION CONTRAIRE EXPRESSÉMENT STIPULÉE DANS
CE CONTRAT, ORACLE OU FUJITSU LIMITED ET LES SOCIÉTÉS AFFILIÉES À L’UNE OU L’AUTRE ENTITÉ REJETTENT TOUTE
REPRÉSENTATION OU TOUTE GARANTIE, QUELLE QU’EN SOIT LA NATURE (EXPRESSE OU IMPLICITE) CONCERNANT CE
PRODUIT, CETTE TECHNOLOGIE OU CE DOCUMENT, LESQUELS SONT FOURNIS EN L’ÉTAT. EN OUTRE, TOUTES LES CONDITIONS,
REPRÉSENTATIONS ET GARANTIES EXPRESSES OU TACITES, Y COMPRIS NOTAMMENT TOUTE GARANTIE IMPLICITE RELATIVE À
LA QUALITÉ MARCHANDE, À L’APTITUDE À UNE UTILISATION PARTICULIÈRE OU À L’ABSENCE DE CONTREFAÇON, SONT
EXCLUES, DANS LA MESURE AUTORISÉE PAR LA LOI APPLICABLE. Sauf mention contraire expressément stipulée dans ce contrat, dans la
mesure autorisée par la loi applicable, en aucun cas Oracle ou Fujitsu Limited et/ou l’une ou l’autre de leurs sociétés affiliées ne sauraient être
tenues responsables envers une quelconque partie tierce, sous quelque théorie juridique que ce soit, de tout manque à gagner ou de perte de
profit, de problèmes d’utilisation ou de perte de données, ou d’interruptions d’activités, ou de tout dommage indirect, spécial, secondaire ou
consécutif, même si ces entités ont été préalablement informées d’une telle éventualité.
LA DOCUMENTATION EST FOURNIE « EN L’ÉTAT » ET TOUTE AUTRE CONDITION, DÉCLARATION ET GARANTIE, EXPRESSE OU
TACITE, EST FORMELLEMENT EXCLUE, DANS LA MESURE AUTORISÉE PAR LA LOI EN VIGUEUR, Y COMPRIS NOTAMMENT TOUTE
GARANTIE IMPLICITE RELATIVE À LA QUALITÉ MARCHANDE, À L’APTITUDE À UNE UTILISATION PARTICULIÈRE OU À
L’ABSENCE DE CONTREFAÇON.
vi SPARC Enterprise Mx000 Servers XSCF Reference Manual • July 2010
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
Contents vii
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
viii SPARC Enterprise Mx000 Servers XSCF Reference Manual • July 2010
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
x SPARC Enterprise Mx000 Servers XSCF Reference Manual • July 2010
xi
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.
xii SPARC Enterprise Mx000 Servers XSCF Reference Manual • July 2010
… 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.
Intro(8)
Intro 1
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
domain configuration
deletecodactivation remove a Capacity on Demand (COD) activation key from
the COD Hardware Activation database
deletecodlicense remove a Capacity on Demand (COD) right-to-use (RTU)
license key from the COD license database
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
Intro(8)
2 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010
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(8)
Intro 3
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(8)
4 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010
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
Intro(8)
Intro 5
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(8)
6 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010
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
Intro(8)
Intro 7
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(8)
8 SPARC Enterprise Mx000 Servers XSCF Reference Manual • Last Revised July 2010
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
/
