Skip to main content

Appendix B Setup Command Workflow


Appendix B Setup Command Workflow
This appendix describes the workflow of the XSCF commands executed in installation of the SPARC M12-2.
For details, see the linked sections listed in Table B-1.
Table B-1  XSCF Setup Command Examples
XSCF Command Example Description Mandatory? Linked Section
Making the initial system settings    
version -c xcp Displays the XCP firmware version Yes "5.4 Checking the XCP Firmware Version"
showaltitude Displays the system altitude setting Yes "5.5 Checking the Altitude Setting"
setaltitude -s altitude=100 Sets the altitude
Example: The system altitude is set to 100 m.
Optional "5.5 Checking the Altitude Setting"
rebootxscf -y -a Reboots the XSCF Optional (*1) "5.5 Checking the Altitude Setting"
showtimezone -c tz Displays the XSCF time zone No "5.6 Setting the Time"
settimezone -c settz -a Lists the time zones that can be set No "5.6 Setting the Time"
settimezone -c settz -s Asia/Tokyo Sets the time zone
Example: "Asia/Tokyo" is set.
Yes "5.6 Setting the Time"
showdate Displays the XSCF clock date and time Yes "5.6 Setting the Time"
setdate -s 102016592012.00 Sets the XSCF clock date and time
Example: 16:59:00 on 2012/10/20 in local time (JST) is set.
Yes "5.6 Setting the Time"
testsb -v -p -s -a -y Initial diagnosis of hardware Yes "5.7 Performing a Diagnosis Test"
showhardconf -M Displays information on each FRU Yes "5.8 Checking the Component Status"
showhardconf -u Displays the number of mounted units by FRU No "5.8 Checking the Component Status"
showlogs error Displays an error log Yes "5.8 Checking the Component Status"
showstatus Displays information on a degraded unit Yes "5.8 Checking the Component Status"
Creating an XSCF user    
showpasswordpolicy Displays the password policy settings No "6.1 Setting the Password Policy"
setpasswordpolicy -y 3 -m 8 -d 2 -u 0 -l 0 -o 0 -M 60 -w 15 -r 3 Sets the system password policy
Example:
- A retry count of up to 3

- A password length of 6 characters or more when the password contains 2 numeric characters. A password length of 8 characters or more when the password does not contain numeric characters

- An expiration time of 60 days

- 15 days ahead as the start date for warnings before the password expires

- 3 as the number of passwords to remember
Yes "6.1 Setting the Password Policy"
adduser jsmith Creates a user account Yes "6.2 Setting a User Account and Password"
password jsmith Sets a password Yes "6.2 Setting a User Account and Password"
setprivileges jsmith useradm platadm Assigns a user privilege Yes "6.2 Setting a User Account and Password"
showuser -l Checks information on a created user account No "6.2 Setting a User Account and Password"
Configuring the Telnet/SSH/HTTPS service    
showtelnet Displays the Telnet service status No "6.3.1 Configuring the Telnet Service"
settelnet -c enabled Starts the Telnet service Optional "6.3.1 Configuring the Telnet Service"
showssh Displays SSH service information No "6.3.2 Configuring the SSH Service"
setssh -c enabled Starts the SSH service Optional "6.3.2 Configuring the SSH Service"
setssh -c genhostkey Generates a host key Optional "6.3.2 Configuring the SSH Service"
showhttps Displays the HTTPS service status No "6.4 Configuring the HTTPS Service"
sethttps -c enable Starts the HTTPS service Optional "6.4 Configuring the HTTPS Service"
Configuring the XSCF network    
showhostname -a Displays the set host names of the master chassis and the chassis with the standby XSCF No "6.5.1 Setting an XSCF Host Name and Domain Name"
sethostname bb#00 scf0-hostname Sets a host name
Example: The host name "scf0-hostname" is set for BB#00.
Optional "6.5.1 Setting an XSCF Host Name and Domain Name"
sethostname -d example.com Sets a DNS domain name
Example: The domain name "example.com" is set.
Optional "6.5.1 Setting an XSCF Host Name and Domain Name"
setnetwork bb#00-lan#0 -m 255.255.255.0 192.168.1.10 Configures an XSCF-LAN network interface
Example: The IP address 192.168.1.10 and the net mask 255.255.255.0 are set for XSCF-LAN#0 of BB#00.
Yes "6.5.2 Setting an Ethernet (XSCF-LAN) IP Address"
showroute -a Displays routing information No "6.5.3 Setting the Routing"
setroute -c add -n 0.0.0.0 -g 192.168.1.1 bb#00-lan#0 Sets routing information
Example: The default gateway IP address 192.168.1.1 is added to XSCF-LAN#0 of BB#00.
Yes "6.5.3 Setting the Routing"
applynetwork Applies XSCF network information to the XSCF Yes "6.5.4 Applying Network Settings"
rebootxscf -a Reboots the XSCF Yes "6.5.4 Applying Network Settings"
Setting memory mirror mode    
showfru -a Displays the set information for all devices Optional "6.6 Configuring Memory Mirroring"
setupfru -c mirror=yes sb 00-0 Sets the memory mounted inside the chassis to mirror mode
Example: All CPUs under PSB 00-0 are set to memory mirror mode.
Optional "6.6 Configuring Memory Mirroring"
Configuring a physical partition    
showpcl -a Displays the PPAR configuration list Yes "6.7 Creating a PPAR Configuration List"
setpcl -p 0 -s policy=system Sets the configuration policy
Example: The configuration policy is set to "All physical partitions" for physical partition 0.
Optional "6.7 Creating a PPAR Configuration List"
showboards -a Displays information on all mounted physical system boards (PSBs) Yes "6.8 Checking the Physical Partition (PPAR) Status"
Synchronizing the physical partition time with the XSCF time    
showdate Displays the XSCF clock date and time Yes "6.9 Synchronizing the Physical Partition (PPAR) Time and XSCF Time"
setdate -s 102016592016.00 Sets the XSCF clock date and time
Example: 16:59:00 on 2016/10/20 in local time (JST) is set.
Yes "6.9 Synchronizing the Physical Partition (PPAR) Time and XSCF Time"
showdateoffset -p 0 Displays the difference between the XSCF time and the physical partition time Yes "6.9 Synchronizing the Physical Partition (PPAR) Time and XSCF Time"
resetdateoffset -p 0 Resets the difference between the XSCF time and the physical partition time Yes "6.9 Synchronizing the Physical Partition (PPAR) Time and XSCF Time"
Configuring CPU Activation    
showcodactivation Displays the CPU Activation key information Yes "6.10.2 Checking a CPU Activation Key"
addcodactivation -F file:///media/usb_msd/XXXXX_XX.TXT Adds a CPU Activation key
Example: The "XXXXX_XX.TXT" file on a USB device is specified to register a CPU Activation key.
Yes "6.10.3 Registering a CPU Activation Key"
setcod -p 0 -s cpu Assigns CPU core resources to a physical partition Yes "6.11 Assigning CPU Core Resources"
showcod -v -s cpu Checks the number of assigned CPU Activations Yes "6.11 Assigning CPU Core Resources"
Starting and stopping a physical partition    
setpparparam -p 0 -s bootscript "setenv auto-boot? false" Changes the setting of the OpenBoot PROM environment variable auto-boot? Yes "6.12 Starting and Stopping a System (PPAR)"
poweron -a Starts a physical partition Yes "6.12 Starting and Stopping a System (PPAR)"
showpparprogress -p 0 Displays the physical partition status
Example: The progress between PPAR-ID 0 power-on and the start of POST is displayed in the midst of processing.
Yes "6.12 Starting and Stopping a System (PPAR)"
showdomainstatus -p 0 Displays the logical domain status
Example: The status of all logical domains on PPAR-ID 0 is displayed.
Yes "6.12 Starting and Stopping a System (PPAR)"
console -p 0 Connects to the control domain console of a physical partition (PPAR) Yes "6.12 Starting and Stopping a System (PPAR)"
poweroff -a Stops a physical partition Yes "6.12 Starting and Stopping a System (PPAR)"
showpparprogress -p 0 Displays the physical partition status Yes "6.12 Starting and Stopping a System (PPAR)"
Saving configuration information    
ldm add-spconfig ldm_set1 (*2) Saves logical domain configuration information after a logical domain configuration change
Example: It is saved with the file name ldm_set1.
Yes "6.14.1 Saving Logical Domain Configuration Information"
dumpconfig file:///media/usb_msd/backup-file.txt
or
dumpconfig ftp://<ftp_server>/backup/backupsca-ff2-16.txt
Saves XSCF setting information to a USB device
or
Saves it via a network
Yes "6.14.2 Saving XSCF Setting Information"
*1 If you execute the setdate command after setting the altitude, you can skip rebootxscf because the XSCF is automatically rebooted after the command is executed.
*2 The ldm add-spconfig command is a command of Oracle VM Server for SPARC.