C120-E360-06EN SPARC® Enterprise M3000/M4000/M5000/M8000/M9000 Servers RCI User’s Guide
Copyright 2007-2008 FUJITSU LIMITED, 1-1, Kamikodanaka 4-chome, Nakahara-ku, Kawasaki-shi, Kanagawa-ken 211-8588, Japan. All rights reserved. Sun Microsystems, Inc. provided technical input and review on portions of this material. Sun Microsystems, Inc.
Copyright 2007-2008 FUJITSU LIMITED, 1-1, Kamikodanaka 4-chome, Nakahara-ku, Kawasaki-shi, Kanagawa-ken 211-8588, Japon. Tous droits réservés. Entrée et revue tecnical fournies par Sun Microsystems, Incl sur des parties de ce matériel. Sun Microsystems, Inc. et Fujitsu Limited détiennent et contrôlent toutes deux des droits de propriété intellectuelle relatifs aux produits et technologies décrits dans ce document.
Preface 1 This manual describes the Remote Cabinet Interface (RCI) function on SPARC® Enterprise series servers. This manual is intended for users, specifically system management/maintenance administrators. However, when carrying out actual operations, authorized service personnels do it. Be sure to also read the SPARC Enterprise M3000/M4000/M5000/M8000/M9000 Servers XSCF User’s Guide and other manuals referenced in this manual.
Preface CHAPTER 1 RCI Overview This chapter gives an overview of the Remote Cabinet Interface (RCI). CHAPTER 2 Setup of the RCI for Operation This chapter describes setup information for use of the RCI. CHAPTER 3 Command Reference This chapter describes the RCI command. CHAPTER 4 Error Status This chapter describes the error status codes.
Preface SPARC Enterprise Mx000 Servers Documentation The manuals listed below are provided for reference.
Preface Book Titles SPARC Enterprise M3000/M4000/M5000/M8000/M9000 Servers RCI User’s Guide SPARC Enterprise M3000 Server Product Notes SPARC Enterprise M4000/M5000 Servers Product Notes SPARC Enterprise M8000/M9000 Servers Product Notes External I/O Expansion Unit Product Notes SPARC Enterprise M3000/M4000/M5000/M8000/M9000 Servers Glossary SPARC Enterprise/PRIMEQUEST Common Installation Planning Manual 1 Manual Codes C120-E360 Go to the Web Go to the Web Go to the Web C120-E456 C120-E514 C120-H007 Man
Preface 1 Message Global Site http://www.fujitsu.com/sparcenterprise/msg/ Japanese Site http://primeserver.fujitsu.com/sparcenterprise/msg/ 2 Firmware program You can download the latest files of firmware at the following websites. Global Site http://www.fujitsu.com/sparcenterprise/firmware/ Japanese Site http://primeserver.fujitsu.com/sparcenterprise/download/ firmware/ The following files or document are provided.
Preface Abbreviated References to Other Documents In this manual, the following abbreviated titles may be used when referring to a systems manual. The following table lists the abbreviations used in this manual.
Preface Fonts/symbols Meaning AaBbCc123 What you type, when contrasted with on-screen computer output. This font represents the example of command input in the frame. AaBbCc123 The names of commands, files, and directories; on-screen computer output. This font represents the example of command output in the frame. Italic font Indicates the name of a reference manual. "" Indicates names of chapters, sections, items, buttons, or menus.
z The command syntax is shown in a box. Example: XSCF> showuser -a Fujitsu Welcomes Your Comments If you have any comments or requests regarding this manual, or if you find any unclear statements in the manual, please state your points specifically on the form at the following URL. For Users in U.S.A., Canada, and Mexico: http://www.computers.us.fujitsu.com/www/ support_servers.shtml?support/servers For Users in Other Countries: SPARC Enterprise contact http://www.fujitsu.
Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . i CHAPTER 1 RCI Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 1.1 1.2 1.3 RCI Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RCI redundancy (only for the high-end system) . . . . . . . . . . . . . . . . . RCI Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents 2.4.4 Making an RCI address setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . To specify an RCI address: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . To confirm the specified RCI address: . . . . . . . . . . . . . . . . . . . . . . . . . 2.4.5 Making an RCI expansion setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . To make an RCI expansion setting: . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents EXTENDED DESCRIPTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9 EXAMPLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10 EXIT STATUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10 CHAPTER 4 Error Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1 4.1 4.2 C120-E360-06EN setrci error status . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Figures Figure 1.1 Figure 1.2 Figure 1.3 Figure 1.4 C120-E360-06EN Connections to RCI I/O units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cluster connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Duplicated configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Mixture of duplicated and unduplicated configurations . . . . . . . . . .
CHAPTER 1 RCI Overview 1 This chapter gives an overview of the Remote Cabinet Interface (RCI). 1.1 RCI Features The RCI is a device control interface used for connections of I/O units to an RCI host. In this manual, a base cabinet and an I/O unit that support the RCI are referred to as an RCI host and an RCI I/O unit (Note), respectively. Furthermore, RCI hosts and RCI I/O units are generally referred to as RCI units. Note: RCI I/O unit might be described as RCI-IO unit.
CHAPTER 1 RCI Overview • RCI redundancy (only for the high-end system) The eXtended System Control Facility (XSCF) unit (Note) of the high-end system has a redundant configuration (duplicated configuration), realizing a high-reliability system. The redundant configuration of the XSCF unit can duplicate a network (RCI network) created by connecting RCI units with RCI cables. Note: 1.2 The XSCF has a system control facility that runs on a service processor provided as standard in the base cabinet.
1.2 RCI Functions • Facility control Different kinds of facility control are available when the external power controller is connected to the RCI. The external power controller can link with the customer's existing facilities, power on each unit, recognize alarms of each unit, use the operator call function through a contact interface, and perform other such operations. Use the setrcic command at the setting of the facility control. For details on the facility control, contact authorized service personnel.
CHAPTER 1 RCI Overview 1.3 RCI Connection Scheme This section outlines RCI connection patterns. • Basic configuration Figure 1.1 shows a connection pattern with an RCI host and RCI I/O units. Figure 1.1 Connections to RCI I/O units RCI host RCI RCI I/O unit RCI I/O unit RCI cables are connected in sequence to respective units using T-branch connectors. RCI terminating resistors must be connected to the T-branch connectors at both ends of a set of RCI connections.
1.3 RCI Connection Scheme • Cluster configuration Figure 1.2 shows a cluster connection pattern. Figure 1.2 Cluster connections RCI host RCI host RCI RCI RCI I/O unit RCI I/O unit Up to 32 RCI hosts can be connected. The cluster connection requirements, such as the maximum cable length and the number of connectable RCI I/O units, are the same as the basic configuration requirements.
CHAPTER 1 RCI Overview Figure 1.4 shows a connection pattern that connects both duplicated and unduplicated configurations. Figure 1.4 Mixture of duplicated and unduplicated configurations RCI host RCI host RCI#1 RCI#0 RCI#0 RCI#0 RCI#1 I/O unit RCI#0 I/O unit The pattern can contain RCI I/O units and RCI hosts that do not support a duplicated configuration. Connect them to the duplicate system. Connect RCI hosts that do not support a duplicated configuration to the #0 system.
CHAPTER 2 Setup of the RCI for Operation 1 This chapter describes setup information for use of the RCI. 2.1 Overview of RCI Setup The RCI can be set up as follows. Note: RCI setup as explained in this chapter is carried out by authorized service personnel. z Prepare a serially-connected PC or a PC connected to the XSCF-LAN, specify its IP address, establish a connection to the XSCF, and use the XSCF shell.
CHAPTER 2 Setup of the RCI for Operation 2.2 RCI Setup for Initial Installation This section explains the procedure for initial RCI setup, which assumes RCI settings have not been configured. Note: 2.2.1 Perform this work when this system is not using any RCI I/O unit. RCI setup flow RCI setup for initial installation contains the following steps: 1 2 3 4 2.2.
2.2 RCI Setup for Initial Installation 2.2.3 Connecting RCI cables Connect RCI cables. Connect RCI units in sequence with RCI cables and their T-branch connectors. Connect RCI terminating resistors to the T-branch connectors at both ends of a set of RCI connections. 2.2.4 Making an RCI address setting Specify "000101ff" as the RCI address for the first RCI host. The RCI address must be unique in duplicate RCI networks.
CHAPTER 2 Setup of the RCI for Operation Note: To make an RCI construction setting for an RCI unit equipped with a main line switch, set the main line switch to the ON position. • To make an RCI construction setting: 1 Execute the setrci (8) command, and make an RCI construction setting. XSCF> setrci -c initconfig .................................................... The command completed successfully. • To confirm an RCI construction setting: 1 Execute the setrci (8) command to display the RCI status.
2.3 RCI Setup for Addition of an RCI I/O Unit 2.3.2 Connecting an RCI cable 1 2 2.3.3 Insert a T-branch connector and an RCI cable into the existing set of connections of RCI cables. Connect the T-branch connector to the RCI I/O unit to be added. Making an RCI expansion setting The added RCI I/O unit must be connected to the RCI network. An RCI address is automatically set for the added RCI I/O unit so that the unit can use RCI functions.
CHAPTER 2 Setup of the RCI for Operation 2.4 RCI Setup for Addition of an RCI Base Cabinet 2.4.1 RCI setup flow RCI setup for addition of an RCI host contains the following steps: 1 2 3 4 2.4.2 Confirming RCI initialization Connecting an RCI cable Making an RCI address setting Making an RCI expansion setting Confirming RCI initialization Before connecting an RCI cable to an RCI host, confirm that RCI settings have been initialized.
2.4 RCI Setup for Addition of an RCI Base Cabinet 2 Connect the T-branch connector to the RCI host to be added. Note: 2.4.4 Always do Confirming RCI initialization before connecting an RCI cable to the RCI host. Making an RCI address setting Specify an RCI addresses in a range of 000102ff to 000120ff for the RCI host to be added. The RCI address must be unique in the existing RCI network. RCI addresses must be assigned in the order of 000102ff, 000103ff, 000104ff, and so on.
CHAPTER 2 Setup of the RCI for Operation 2.4.5 Making an RCI expansion setting The added RCI host must be connected to the RCI network. The RCI address of the added RCI host is synchronized with those of existing RCI hosts so that the added cabinet can use RCI functions. Make an RCI expansion setting on the added RCI host. Note: Before beginning this RCI setup work, confirm that AC cables are connected to all RCI units.
2.5 RCI Setup for Replacement of an RCI I/O Unit 2.5 RCI Setup for Replacement of an RCI I/O Unit 2.5.1 RCI setup flow RCI setup for replacement of an RCI I/O unit contains the following steps: 1 2 3 Confirming an RCI address Replacing an RCI I/O Unit Making an RCI replacement setting Note: 2.5.2 Perform this RCI setup work for each RCI I/O unit to be replaced. Confirming an RCI address Confirm the RCI address or location of the RCI I/O unit to be replaced.
CHAPTER 2 Setup of the RCI for Operation 3 Execute the setrci (8) command to display a list of connected RCI units. XSCF> setrci -c stat HOST address 000102ff Active LIST address pwr alm I/F sys-phase tgry dev-cls sub-cls 000101ff OFF ACT host 0001 0b 003001ff OFF ACT disk 0400 04 003002ff OFF INACT disk 0400 04 003003ff OFF ACT disk 0400 04 The command completed successfully. tm-out - On the list, "INACT" is displayed in the "I/F" column of the RCI I/O unit that cannot make a transmission to the RCI.
2.5 RCI Setup for Replacement of an RCI I/O Unit 2.5.4 Making an RCI replacement setting The added RCI I/O unit must be connected to the RCI network. The RCI address of the added RCI I/O unit is synchronized with that of an existing RCI host so that the unit can use RCI functions. An RCI expansion setting can be made only once from an arbitrary RCI host. Note: Before beginning this RCI setup work, confirm that AC cables are connected to all RCI units.
CHAPTER 2 Setup of the RCI for Operation 2.6 RCI Setup for Replacement of an RCI Base Cabinet 2.6.1 RCI setup flow RCI setup for replacement of an RCI host contains the following steps: 1 2 3 4 5 Replacing an RCI host Confirming RCI initialization Connecting an RCI cable Making an RCI address setting Making an RCI replacement setting Note: 2.6.2 Perform this RCI setup work for each RCI host to be replaced.
2.6 RCI Setup for Replacement of an RCI Base Cabinet 2 Execute the setrci (8) command to initialize RCI settings. XSCF> setrci -c init The command completed successfully. 2.6.4 Connecting an RCI cable Connect the removed T-branch connector together with the RCI cable to the new RCI host. Note: 2.6.5 Always do Confirming RCI initialization before reconnecting the RCI cable to the RCI host. Making an RCI address setting Assign an RCI address to the new RCI host after replacement.
CHAPTER 2 Setup of the RCI for Operation • To confirm the specified RCI address: 1 Execute the setrci (8) command to display the RCI status. XSCF> setrci -c stat HOST address 000102ff Inactive The command completed successfully. Confirm that the "address" value is correct. To correct the RCI address, start again from RCI initialization. 2.6.6 Making an RCI replacement setting The new RCI host must be connected to the RCI network.
2.6 RCI Setup for Replacement of an RCI Base Cabinet • To confirm an RCI replacement setting: 1 Execute the setrci (8) command to display the RCI status. XSCF> setrci -c stat HOST address 000102ff Active LIST address pwr alm I/F sys-phase ctgry 000101ff OFF ACT host 000102ff OFF ACT host 003001ff OFF ACT disk The command completed successfully. dev-cls 0001 0001 0400 sub-cls 0b 0b 04 tm-out - Confirm that the displayed LIST contents include the replacement RCI host.
CHAPTER 3 Command Reference 1 3.
CHAPTER 3 Command Reference addconfig replaceconfig ledoff idpin Adds an RCI I/O unit or host. When an RCI I/O unit is added, the RCI I/O unit newly connected to RCI is searched for and found, and then an RCI address is assigned. When a host is added, it is also added to the RCI network. "-c set" must be executed beforehand on the added host to set the RCI address for the host. Replaces an RCI I/O unit or host.
3.1 setrci -c idpin -h -s RCI_network Displays the RCI address of the RCI I/O unit whose ID-PIN has been pressed. Displays usage statement. When used with other options or operands, an error occurs. Specifies an RCI network. Either of the networks shown below can be specified for RCI_network. The specification must be made together with "-c init", "-c initconfig" and "-c addconfig". RCI-0 Specifies the RCI network on the #0 side.
CHAPTER 3 Command Reference I/F RCI unit interface status. ACT Valid state. INACT Invalid state. sys-phase Operating state of the host connected to RCI. One of the following is displayed: power-off Powered off. panic In the panic state. shdwn-start Shutdown in progress. shdwn-cmplt Shutdown has completed. dump-cmplt Dump has completed. booting System being started. running System in operation. Not support the status display. ctgry Category of the RCI unit.
3.1 setrci • EXAMPLES EXAMPLE 1: Makes the first RCI setting on the first host in an M3000/M4000/ M5000 server.
CHAPTER 3 Command Reference XSCF> setrci -c init RCI-0 .......... The command completed successfully. RCI-1 .......... The command completed successfully. XSCF> setrci -c set 1 RCI-0 .......... The command completed successfully. RCI-1 .......... The command completed successfully. XSCF> setrci -c initconfig RCI-0 .......... The command completed successfully. RCI-1 .......... The command completed successfully.
3.1 setrci EXAMPLE 2: Makes the first RCI setting on the first host in an M8000/M9000 server. XSCF> setrci -c init .......... The command completed successfully. XSCF> setrci -c set 1 .......... The command completed successfully. XSCF> setrci -c initconfig .......... The command completed successfully.
CHAPTER 3 Command Reference 3.2 setrcic • NAME setrcic - make the setting of an external power control device or display its status. • SYNOPSIS setrcic -c exrdy RCI_address [ time] setrcic -c opcalldisp RCI_address setrcic -c opcallon RCI_address callNo setrcic -c opcalloff RCI_address callNo setrcic -h • DESCRIPTION The setrcic(8) command makes the setting of an external power control device or displays its status. The following can be set or displayed: Multiple items cannot be set at a time.
3.2 setrcic • OPTIONS The following options are supported: -c exrdy RCI_address [time] -c opcalldisp -c opcallon RCI_address callNo -c opcalloff RCI_address callNo -h Sets the EXRDY monitoring timeout period of the specified external power control devices. Set the EXRDY monitoring timeout period in units of minutes for time. If 0 is specified, EXRDY monitoring is disabled. If time is omitted, the EXRDY monitoring timeout period is displayed.
CHAPTER 3 Command Reference • EXAMPLES EXAMPLE 1: Makes the setting of external power control. XSCF> setrcic -c exrdy 003001ff 10 The command completed successfully. XSCF> setrcic -c exrdy 003001ff address:003001ff exrdy:10 min The command completed successfully. XSCF> setrcic -c opcallon 003001ff 0c The command completed successfully. XSCF> setrcic -c opcalldisp 003001ff address:003001ff callNo:0c The command completed successfully.
CHAPTER 4 Error Status 1 4.1 setrci error status When the RCI construction by the setrci command ends abnormally and "Operation failed error status: XX" is displayed, the displayed error status code and explanation are described to the following table. Code 00 01 02 03 04 05 06 07 08 09 0a 0b 0c 0d 0e 0f 20 30 fd fe ff C120-E360-06EN Explanation Detected the duplicate RCI address. RCI address of current unit is not configured or false.
CHAPTER 4 Error Status 4.2 setrcic error status When the RCI construction by the setrcic command ends abnormally and "Operation failed error status: XX" is displayed, the displayed error status code and explanation are described to the following table. Code -1 -2 Explanation Detected an RCI transmission error. Terminated the command execution due to RCI busy. (Note 1) -3 Internal error occurred in XSCF. (Note 2) Note 1: After a certain period of time, re-execute the setrcic command.
Back Cover
