Monday, January 11, 2016

Sun M10 - Series server set up xscf command line reference


SUN SPARC System Console access


ALOM and the System Controller

T-series servers t1000 and t2000 servers can be access through ALOM to get access to ok prompt. Even server is powered off, ALOM still run its firmwares which allow you to login and power on and off the system. The server comes with two ports called SER MGT and NET MGT. Ser MGT is used for serial connection while network management is used with console servers such as digi comsole (cisco, avacent) or similar products.

Here is the basic overview,
when you first time login, you will be prompted for pw. Please check for service manual for default username and password.

Please login:
Please Enter password:

Once you login, you will see sc prompt.

sc>

To connect to console, type consule and press enter.

sc> console


You should either at ok prompt or on the login prompt of the OS.

{ok}

To go back to sc menu, type #., it will take you to sc prompt. and type exit to get out of sc prompt.


At any time, you can switch back to the system controller prompt from the OpenBoot prompt by typing the pound key (#) followed by the period (.) as follows:


To poweron or power off the OS, you can type poweron or poweroff on the sc prompt.

sc> poweron

Only one user can use console at rw mode. If you already have a user, you can use -f to gain control of the console.


sc> console –f

to go back to the sc prompt, type #.


ILOM and the Service Processor

Other t-series servers such as t3, t4, t5 and blade servers, you can use ILOM.

These servers are also come with SER MGT and the NET MGT. You can configure login in through the serial console or theough the console server.



Please login:
Enter a password:

Once you login, you will see -> prompt (-> service processor prompt).

->

To login to the console, you have to Start the system console

-> start /SP/console<cr>

Are you sure you want to start /SP/console (y/n)?

Once you type y, you will either be on OK prompt or on os login prompt.

To go back to system processor prompt, just type #.

To turn the power of the server, type

-> start /SYS

-> stop /SYS

/SYS is uppercase


Like ALOM, to login with write access if user is already logged on, you can forrce login.

-> start -force /SP/console


To login to M-series servers (M3k/M5K)

login:
password:

XSCF>

List configured domains on your physical system.
XSCF>showdomainstatus -a

Login to console on domain 0 or 00

XSCF> console –d 0
XSCF> console –d 00
XSCF> console –d0
Increment of domain is like 1 , 2, 3

To login to domain 1
XSCF> console –d 1



XSCF> console -p 0


Press the [Enter] key. Then, press the [#] (default value for the escape
symbol) and [.] (period) keys to move from the console to the XSCF shell.

{0} ok #


Note: M-series such as M3k/4K/5K do not support LDOM but M10 series do.


M10 series server console login

1. Execute the showdomainstatus command, and confirm that status is "OpenBoot Running".

XSCF# showdomainstatus -p 0
Logical Domain Name    Status
primary                OpenBoot Running
XSCF#


2. Execute the console command to connect to the console of the specified physical partition.

XSCF> console -p 0



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

M10 server login

Logging In to the XSCF

login: default

XSCF>

1. Checking the XCP Version
XSCF> version -c xcp

if you have M10-4S and chassis has different XCP version, then the command to update XCP version on that chassis.

XSCF> flashupdate -c sync


2. Display the XSCF time.
XSCF> showdate

To change the date and time
XSCF> setdate -s 102016592012.00

Sat Oct 20 16:59:00 JST 2012

Performing a Diagnosis Test
---------------------------
The SPARC M10 system cannot be powered on until a CPU Activation key is registered and CPU core resources are assigned to a physical partition.


1. Execute the testsb command.
The testsb command performs an initial diagnosis of the specified physical system board (PSB).

XSCF> testsb -v -p -s -a -y

The command powers on and off the system during the diagnosis.

options
-v: Additionally displays detailed messages of the initial diagnosis
-p: Executes the "probe-scsi-all" command of OpenBoot PROM and displays the results while a diagnosis is being processed
-s: Executes the "show-devs" command of OpenBoot PROM and displays the results while a diagnosis is being processed
-a: Diagnoses all the mounted PSBs
-y: Automatically responds with "y" to a query


2. showhardconf command -  Checking the Component Status
The command displays all the FRUs mounted in the chassis and their status.
However, it does not display the status of I/O-related components such as PCI
cards and PCI expansion units while the system power is off.

XSCF> showhardconf -M


3. Execute the showlogs error command.
Confirm that no error is displayed

XSCF> showlogs error


4. Execute the showstatus command.
When there is no problem, the command displays nothing.

XSCF> showstatus


Making the Initial System Settings

a. Setting the Password Policy

1. Execute the showpasswordpolicy command to check the password policy.

XSCF> showpasswordpolicy

2. Execute the setpasswordpolicy command to set the password policy

XSCF> setpasswordpolicy -y 3 -m 8 -d 2 -u 0 -l 0 -o 0 -M 60 -w 15

Option Password policy
-n        Mindays
-M        Maxdays
-w        Warn
-i        Inactive
-e        Expiry
-y        Retry
-k        Difok
-m        Minlen
-d        Dcredit
-u        Ucredit
-l        Lcredit
-o        Ocredit
-r        Remember

verify the change
XSCF> showpasswordpolicy

b. Setting a User Account and Password
1. Execute the adduser command to add a user account
XSCF> adduser jsmith
or to add with userid
XSCF> adduser -u 359 jsmith

2. Execute the password command, and specify a password
XSCF> password jsmith
XSCF> password -M 60 -w 15 jsmith

Password expores in 60 days and warn you 15 days ahead before the password expires.


3. Execute the setprivileges command to assign a user privilege to the user account.

User privilege   Overview
------------- ---------
platadm Manage the whole system
useradm Manage user accounts.
auditop Refer to the XSCF audit status
auditadm Control auditing OR delete XSCF audit methods.
fieldeng Allow use by field engineers.

XSCF> setprivileges jsmith useradm platadm

specifies useradm and platadm for the user account

4. Execute the showuser command to check information on a created user account.
XSCF> showuser -l


C. Configuring the Telnet/SSH Service

1. Execute the showtelnet command to display the Telnet setting.
XSCF> showtelnet

2. Execute the settelnet command to configure the Telnet service.
XSCF> settelnet -c enable

3. Execute the showtelnet command, and confirm that the Telnet setting is "enabled".
XSCF> showtelnet

 Configuring the SSH service

1. Execute the showssh command to display the SSH settings.
displays the SSH service settings. The factory default is "disabled".

XSCF> showssh

2. Execute the setssh command to configure the SSH service
XSCF> setssh -c enable

3. Execute the showssh command to display the host key and fingerprint.
XSCF> showssh

4. Execute the setssh command to generate the host key
XSCF> setssh -c genhostkey

The following example updates the host key.
XSCF> setssh -c genhostkey
Host key already exists. The key will be updated. Continue? [y|n] :y


D. Configuring the HTTPS Service
XSCF Web with a connection to the XSCF-LAN and for use of a Web browser window.


1. Execute the showhttps command to display the HTTPS service settings.
XSCF> showhttps

2. Execute the sethttps command to configure HTTPS.
XSCF> sethttps -c enable

3. Execute the showhttps command, and confirm that the HTTPS setting has changed to "enabled"
XSCF> showhttps


E. Configuring the XSCF Network
Setting an XSCF host name and domain name

1. Execute the showhostname command to display host names
XSCF> showhostname -a

2. Execute the sethostname command to set a host name.
XSCF> sethostname xscfu hostname

For hostname, specify the host name to set. For xscfu, specify the chassis for the
setting. You can specify it as follows depending on the system configuration:
- M10-1/M10-4/M10-4S (no crossbar box): bb#00, bb#01
- M10-4S (with crossbar boxes): xbbox#80, xbbox#81


The following example sets the host name scf0-hostname for BB#00 and the host name scf1-hostname for BB#01.

XSCF> sethostname bb#00 scf0-hostname
XSCF> sethostname bb#01 scf1-hostname
The following example sets the host name scf0-hostname for XBBOX#80 and the host name scf1-hostname for XBBOX#81

XSCF> sethostname xbbox#80 scf0-hostname
XSCF> sethostname xbbox#81 scf1-hostname

The following example sets the domain name example.com for the master XSCF and standby XSCF.
XSCF> sethostname -d example.com

Setting an Ethernet (XSCF-LAN) IP address

The XSCF-LAN is a LAN established for user access to the XSCF. Two XSCF-LAN
ports can be used, depending on the network configuration.


M10-1/M10-4/1BB configuration of the M10-4S

In the systems with one XSCF, set either or both of the following IP addresses:
- XSCF-LAN#0 of BB#00
- XSCF-LAN#1 of BB#00


1. Execute the setnetwork command with network interface information specified.
The following example sets the IP addresses and net masks for XSCF-LAN#0 and
XSCF-LAN#1 of BB#00 to enable them.

XSCF> setnetwork bb#00-lan#0 -m 255.255.255.0 192.168.1.x
XSCF> setnetwork bb#00-lan#1 -m 255.255.255.0 192.168.2.a

FOR SPARC M10-4S, CHECK THE MANUAL.


Setting the routing
1. Execute the showroute command to display the routing environment.

XSCF> showroute -a


2. Execute the setroute command to set the default gateway

XSCF> setroute -c add -n address -g address interface


For -n address, specify the IP address that is the routing information destination.
If 0.0.0.0 is specified in address, the command sets the default routing information.
For -g address, specify the gateway address used in routing.
For interface, specify the network interface to be set.

XSCF> setroute -c add -n address -g address interface

XSCF> setroute -c add -n 0.0.0.0 -g 192.168.1.1 bb#00-lan#0

The following example adds the default gateway IP address 192.168.1.1 for XSCF-LAN#0 of BB#00.
XSCF> setroute -c add -n 0.0.0.0 -g 192.168.2.1 xbbox#80-lan#1

Applying network settings

1. Execute the applynetwork command on the XSCF shell.
XSCF> applynetwork

2. Execute the rebootxscf command to reset the XSCF and complete the settings
XSCF> rebootxscf -a

Execution of the command disconnects the XSCF connection.

nOTE: To switch from a serial connection to an XSCF-LAN connection, connect to the
XSCF by specifying its IP address on a PC connected to the XSCF-LAN, and log in again.

3. Execute the showhostname, shownetwork, showsscp, and showroute
commands again to display the network settings, and confirm the new
network information


F.  Configuring Memory Mirroring
The SPARC M10 systems support memory mirroring configurations to protect data
through memory duplication. Data reliability increases, but the amount of available
memory is halved.

The memory access controller controls writing of data to memory and reading of
data from memory. The SPARC M10 systems configure the mirroring by grouping
memory into sets controlled by two memory access controllers.

Note - The memory grouped together in a mirroring group must all have the same capacity
and be the same rank

1. Execute the showfru command to check memory mirror mode
XSCF> showfru -a
DISPLAYS default settings.

2. Execute the setupfru command to configure memory mirroring.
XSCF> setupfru [-m {y|n}] device location

To configure memory mirroring, specify -m y
For device, specify the device for which to configure the mirroring. To configure
memory mirroring for all the CPUs mounted on the specified system board
(PSB), specify sb. To configure it only for the specified CPU, specify cpu.
For location, specify the location of the target device. You can specify it in the
xx-0-z format. For xx, specify a system board number. For z, specify a CPU chip
number from 0 to 3.
The following example sets all the CPUs mounted on physical system board 00-0
to memory mirror mode

XSCF> setupfru -m y sb 00-0

3. Execute the showfru command to check the set memory mirror mode.
XSCF> showfru -a


g. Creating a Physical Partition Configuration List (PCL)

A physical partition (PPAR) consists of physical system boards (PSBs). In the
physical partition, the hardware resources of a physical system board (PSB) can be
assigned to logical system boards (LSB).
Use the showpcl command to check a physical partition configuration list (PCL), and
use the setpcl command to set a PCL.

¦ Physical system board (PSB)
The PSB consists of all physical components mounted on a SPARC M10 System
chassis such as CPUs and memory. In other words, the physical system board
(PSB) of the SPARC M10-1 is a motherboard unit, and that of the SPARC
M10-4/M10-4S is a CPU memory unit (containing the <CMUL> on the bottom and
the <CMUU> on top). The other devices that are treated as physical system boards
(PSBs) may include PCIe cards and disk devices. Sometimes, a physical unit of
hardware being installed/removed/replaced is described as a physical system
board (PSB).

¦ Logical system board (LSB)
The LSB is a logical unit name assigned to a physical system board (PSB). Each
physical partition has a set of logical system boards (LSBs) assigned to it. A logical
system board number is used to control how resources such as kernel memory are
assigned to each logical domain.

¦ System board
This term is used to describe hardware resources in operations such as configuring
or displaying a physical partition.


1. Execute the showpcl command to check a physical partition configuration list(PCL).
No physical partition configuration list (PCL) is set in the factory default settings.

XSCF> showpcl -p 0

2. Execute the setpcl command to create a physical partition configuration list (PCL).

The following example maps system board 00-0 to logical system board 0 of
physical partition 0.

XSCF> setpcl -p 0 -a 0=00-0

The following example maps system boards 01-0, 02-0, and 03-0 to logical system
boards 0, 1, and 2, respectively, of physical partition 1.

XSCF> setpcl -p 1 -a 0=01-0 1=02-0 2=03-0


3. Execute the setpcl command to set the configuration policy for all physical
partitions as a whole

XSCF> setpcl -p ppar_id -s policy=value

In value, specify fru (part), psb (system board), or system (all physical partitions
as a whole) as the degradation unit. The default setting is fru.
The following example sets the configuration policy to "All physical partitions"
for physical partitions 0 and 1.

XSCF> setpcl -p 0 -s policy=system
XSCF> setpcl -p 1 -s policy=system

4. Execute the showpcl command, and confirm the set physical partition
configuration list (PCL).
XSCF> showpcl -a


h. Assigning a System Board (PSB) to a Physical Partition (PPAR)

Based on the physical partition configuration list (PCL), assign a system board (PSB)
to a logical system board (LSB) of the physical partition (PPAR).
For the SPARC M10-1/M10-4 system, a system board is already assigned.

1. Execute the showboards command to check the system board (PSB) status.

XSCF> showboards -a


2. Execute the addboard command to assign the system board (PSB) to the physical partition.
The following example adds system board 00-0 to physical partition 0

XSCF> addboard -c assign -p 0 00-0

The following example adds system boards 01-0, 02-0, and 03-00 to physical partition 1.
XSCF> addboard -c assign -p 1 01-0 02-0 03-0

3. Execute the showboards command to check the system board (PSB) status.

XSCF> showboards -a


i. Setting a CPU Operational Mode for the Physical Partition

There are two CPU operational modes (cpumode) that are specifiable for the
setpparmode command: auto mode and compatible mode.


1. Execute the showpparmode command to check the CPU Mode of the physical partition.

XSCF>showpparmode -p 0


2. To change the CPU mode to "compatible" mode, execute the setpparmode
command and set the CPU Mode to "compatible".

XSCF>setpparmode -p 0 -m cpumode=compatible

3. Execute the showpparmode command, and confirm that the CPU Mode of the
physical partition has been set to "compatible".

XSCF>showpparmode -p 0

j. Synchronizing the Physical Partition (PPAR) Time and XSCF Time


1. Execute the showdate command to display the XSCF time.
XSCF> showdate

2. Confirm that the set XSCF time is correct. To change the date and time,
execute the setdate command.

3. Execute the showdateoffset command to check the times difference between
the XSCF system time and physical partition time.

XSCF> showdateoffset -p 0

4. Unless the time difference in step 3 was 0 seconds, execute the resetdateoffset
command to initialize the difference between the XSCF system time and the
time of the physical partition.
The time of each physical partition is synchronized with the XSCF system time at
the next physical partition startup.

XSCF> resetdateoffset -p 0


Registering a CPU Activation Key

Checking a CPU Activation key

1. Execute the showcodactivation command to check the CPU Activation key information

XSCF> showcodactivation

XSCF> showcodactivation

Registering a CPU Activation key

XSCF> addcodactivation -F file:///media/usb_msd/XXXXX_XX.TXT


4. Execute the showcodactivation command, and confirm that the CPU
Activation key is registered with the XSCF.

XSCF> showcodactivation


1. Copy the "ACTIVATION_KEY" contents on the CPU Activation key CD-ROM to
a USB device.
2. Connect the USB device to the USB connector (where "MAINTENANCE
ONLY" is printed) on the XSCF unit panel (rear panel) of the master XSCF.
3. Register the CPU Activation key by executing the addcodactivation command
from the storage location of the key.
The following example specifies the "XXXXX_XX.TXT" file on a USB device to
register CPU Activation keys


XSCF> addcodactivation -F file:///media/usb_msd/XXXXX_XX.TXT

4. Execute the showcodactivation command, and confirm that the CPU
Activation key is registered with the XSCF.

XSCF> showcodactivation

How to copy and paste the CPU Activation key contents
1. Insert the CPU Activation key CD-ROM into the system administration terminal.
2. Open the ACTIVATION_KEY folder on the CD-ROM.

3. Open the relevant file (XXXX_XX_001.TXT), and copy the contents of the key.
4. Execute the addcodactivation command to register the CPU Activation key

XSCF> addcodactivation "Product: SPARC M10-x

5. Execute the showcodactivation command, and confirm that the CPU
Activation key is registered with the XSCF.

XSCF> showcodactivation


Assigning CPU Core Resources

1. Execute the setcod command to assign the CPU core resources to the physical partition.

XSCF> setcod -p ppar_id -s cpu permits

XSCF> setcod -p 0 -s cpu 4

2. Execute the showcod command, and confirm the number of assigned CPU Activations.
XSCF> showcod -v -s cpu

3. Similarly assign CPU core resources to all of the physical partitions.


Starting and Stopping a Physical Partition (PPAR)

1. Execute the setpparparam command to change the auto-boot? setting, which
is an OpenBoot PROM environment variable

XSCF> setpparparam -p 0 -s bootscript "setenv auto-boot? false"

2. Execute the poweron command to start the physical partition.

XSCF> poweron -a

Note - In the SPARC M10-1, a physical partition takes about 5 minutes to start. In the SPARC
M10-4, it takes about 7 minutes. In the SPARC M10-4S in the 4BB configuration, it takes
about 25 minutes.

3. Execute the showpparprogress command
XSCF> showpparprogress -p 0


4. Execute the showdomainstatus command, and confirm that status is "OpenBoot Running".

XSCF# showdomainstatus -p 0
Logical Domain Name    Status
primary                OpenBoot Running
XSCF#


5. Execute the console command to connect to the console of the specified physical partition.

XSCF> console -p 0


6. Press the [Enter] key. Then, press the [#] (default value for the escape
symbol) and [.] (period) keys to move from the console to the XSCF shell.

{0} ok #


7. Execute the poweroff command to stop the physical partition

XSCF> poweroff -a


8. Execute the showpparprogress command, and confirm that the command
displays "The sequence of power control is completed." and ends.

XSCF> showpparprogress -p 0



XSCF> showlogs error

showhardconf command to check the configuration, status, and quantities.

Execute the showpcl command to check a physical partition configuration list
XSCF> showpcl -p 0

Execute the setpcl command to register a system board in the physical partition configuration list




Once you login to the control domain, you can run the following command to see the LDOMs

To check the operation status of the logical domains.

# ldm list-domain
You can check the LDOM status from the characters displayed on the output under FLAGS


The characters and their meanings under FLAGS are
"n" -> Solaris OS running
"t" -> OS on OK prompt PROM state
"-" -> other state (including cases in which STATE is not active)


After reconfiguration, execute the ldm add-spconfig command to save the LDOM configuration in the XSCF.



Check the status of resource usages
# ldm list-devices -a

Execute the ldm list-io command to check the status of I/O device usage

# ldm list-io


In the following example, PCIE8 to PCIE11 belong to domain01


NAME                    TYPE    BUS       DOMAIN    STATUS
----                    ----    ---       ------    ------
PCIE0                   BUS     PCIE0     primary    IOV
PCIE1                   BUS     PCIE1     primary    IOV
PCIE2                   BUS     PCIE2     primary    IOV
PCIE3                   BUS     PCIE3     primary    IOV
PCIE8                   BUS     PCIE8     domain01 IOV
PCIE9                   BUS     PCIE9     domain01 IOV
PCIE10                  BUS     PCIE10    domain01 IOV
PCIE11                  BUS     PCIE11    domain01 IOV
/BB0/CMUL/NET0          PCIE    PCIE0     primary    OCC
/BB0/CMUL/NET2          PCIE    PCIE0     primary    OCC
/BB0/CMUL/SASHBA        PCIE    PCIE0     primary    OCC
/BB0/PCI0               PCIE    PCIE1     primary    EMP
/BB0/PCI1               PCIE    PCIE1     primary    EMP

Of the services provided by the I/O domain, release all the I/O devices of the system board (PSB) that is the removal target.

The following example stops the I/O domain domain01 and releases the PCIe
root complexes related to the removal-target system board (PSB) from among
those belonging to domain01.

# ldm stop domain01
# ldm rm-io PCIE11 domain01
# ldm rm-io PCIE10 domain01
# ldm rm-io PCIE9 domain01
# ldm rm-io PCIE8 domain01


Execute the ldm list-io command again to check the status of I/O device usage
# ldm list-io



Return to the XSCF shell, execute the showboards command, and check the
system board (PSB) status

XSCF> showboards -p 0



Execute the console command to connect to the console of the control domain, and then log in

XSCF> console -p 0


. Execute the deleteboard command to release the system board (PSB) from
the physical partition



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


Stop the target physical partition, and check the cables.
XSCF> poweroff -y -p 0


XSCF> showlogs error
XSCF> poweron -y -p 0

Execute the poweroff command to stop the system.
XSCF> poweroff -y -a


Checking information on a component where a failure or degradation occurred
XSCF> showstatus

Checking diagnosis results
XSCF> testsb -v -p -s -a -y






reference doc: http://www.fujitsu.com/downloads/SPARCS/manuals/en/c120-e678-09en.pdf

No comments:

Post a Comment