C H A P T E R  2

Configuring Your System

This chapter assumes you have already installed the Solaris OS and the required patches on your Netra CT system.

You configure the Netra CT system primarily through the alarm card command-line interface (CLI). The alarm card CLI enables system-level configuration, administration, and management that includes the CPU nodes, I/O boards, the alarm card, power supplies, and fan trays. The alarm card CLI interface can be used both locally and remotely.

You configure the alarm card first, then the CPU boards, then the system-wide applications.

This chapter includes the following sections:


Accessing the Alarm Card

When you initially access the alarm card, you must do so over serial port COM1 (console), using an ASCII terminal or the Tip program.

When you first access the alarm card, log in with the default user account of netract and the password suncli1. This account is set to full authorization (permissions). This account can not be deleted; however, you should change the password on this account for security purposes, before your Netra CT server is operational.

The next sections provide information on configuring the alarm card serial and Ethernet ports, and setting up user accounts and passwords using the alarm card command-line interface. For more information on using the alarm card command-line interface, refer to Chapter 3.

After you configure the serial and Ethernet ports, you can access and configure the alarm card over:

To use the console on a rear-access Netra CT server, connect a cable to the rear serial port on the alarm card (the front ports are disabled on a rear-access system).


Configuring the Alarm Card Serial Ports

The alarm card has two serial ports, COM1 and COM2. COM1 is configured for the console; you can not change this port. You can configure COM2 using the following CLI commands:

You must be logged in to the alarm card with a user account that has full permissions.

When you specify the port number (port_num), use 2 to reference serial port COM2.


procedure icon  To Configure the Alarm Card Serial Ports

1. Log in to the alarm card.

2. Set the serial mode:


hostname cli> setserialmode -b port_num tty|none


Set the mode of the specified serial port to tty or none. The default for COM2 is none, that is, no services are available on this port.

3. Set the serial baud rate:


hostname cli> setserialbaud -b port_num baudrate


Valid values for the baud rate are 1200, 4800, 9600, 19200, 38400, and 56000. The default is 9600.

4. Set the serial parity:


hostname cli> setserialparity -b port_num none|odd|even


Valid values for the parity bit are none, odd, or even. The default is odd.

5. Set the serial stop bit:


hostname cli> setserialstop -b port_num none|odd|even


Valid values for the stop bit are 1 or 2. The default is 1.

6. Set the serial data bit number:


hostname cli> setserialdata -b port_num 7|8


Valid values for the number of data bits are 7 or 8. The default is 8.

7. Set the serial hardware handshake:


hostname cli> setserialhwhandshake -b port_num true|false


Valid values for the hardware handshake are true or false. The default is false.


Configuring the Alarm Card Ethernet Ports

The alarm card has two Ethernet ports, ENET1 and ENET2. You configure these ports using the following CLI commands:

You must be logged in to the alarm card with a user account that has full permissions.

When you specify the port number (port_num), use 1 or 2, depending on which port you are referencing.

Any one of the Ethernet ports can be configured for failover to the other port. Refer to "Set the IP mode," below, for instructions.

You must reset the alarm card for any changes to take effect.


procedure icon  To Configure the Alarm Card Ethernet Ports

1. Log in to the alarm card.

2. Set the IP mode:


hostname cli> setipmode -b port_num rarp|config|standby|none


Choose the IP mode according to the services available in the network (rarp or config) or to configure the port for failover (standby). The default for ENET1 is rarp; the default for ENET2 is none, that is, no services are available on this port. You must reset the alarm card for the changes to take effect.

Any one of the Ethernet ports can be configured for failover. To do this, set the IP mode to standby on one port, and set the IP mode to rarp or config on the other port. If the port configured for rarp or config fails, the network traffic will be switched over to the port configured for standby. For example:


hostname cli> setipmode -b 1 rarp
hostname cli> setipmode -b 2 standby
hostname cli> reset ac


In this example, ENET2 is set to standby. If ENET1 fails, all network traffic is switched over to ENET2.

3. Set the IP address:


hostname cli> setipaddr -b port_num addr


The default is 0.0.0.0. This command is only used if the ipmode is set to config. You must reset the alarm card for the changes to take effect.

4. Set the IP netmask:


hostname cli> setipnetmask -b port_num addr


The default is 0.0.0.0. This command is only used if the ipmode is set to config. You must reset the alarm card for the changes to take effect.

5. Set the IP gateway:


hostname cli> setipgateway -b port_num addr


Set the IP gateway of Ethernet port 1. The default is 0.0.0.0. You must reset the alarm card for the changes to take effect.

6. Reset the alarm card.


Setting Up User Accounts on the Alarm Card

User accounts are set up using the alarm card command-line interface. The default user account is netract and the password is suncli1. This account is set to full authorization (permissions). This account can not be deleted; however, you should change the password on this account for security purposes, before your Netra CT server is operational.

The alarm card supports 16 accounts with passwords.


procedure icon  To Set Up a User Account

1. Log in to the alarm card.

2. Add a user:


hostname cli> useradd username

3. Add a password for that user:


hostname cli> userpassword username

By default, new accounts are created with read-only permission. Permission levels can be changed using the userperm command; refer to CLI Commands for more information about permissions and the userperm command.

A different type of alarm card user account is used solely with the Managed Object Hierarchy (MOH) Remote Method Invocation (RMI) interface. Refer to MOH Configuration and RMI for more information.

Username Restrictions

The username field has a maximum length of 16 characters; it must contain at least one lowercase alphabetic character, and the first character must be alphabetic.

Valid characters for username include:

Password Restrictions

Passwords have the following restrictions:


Specifying Netra CT Server FRU ID Information

A field-replaceable unit (FRU) is a module or component that can typically be replaced in its entirety as part of a field service repair operation.

The Netra CT system FRUs include:

All FRUs contain FRU ID (identification) information that includes FRU manufacturing and configuration data. This information can be displayed through the alarm card CLI (see TABLE 2-3).

In addition, you enter certain FRU ID information, through the alarm card CLI, that is stored in the midplane. (Note that you can also enter FRU ID information through the MOH application; refer to the Netra CT Server Developer's Guide for instructions.) FRU ID information includes:

Some of this information is used by the MOH application to audit board insertions and prevent misconfigurations, and to display information; some is used by the MCNet interface.

The format of the information to be specified is:


hostname cli> setfru fru_target  fru_instance  fru_field  value

FRU ID information can be displayed using the CLI showfru command; see Displaying Netra CT Server FRU ID Information for more information.

TABLE 2-1 shows the FRU ID information that can be specified with the CLI setfru command.


TABLE 2-1 FRU ID Information Specified Using the setfru Command

FRU Target

FRU Instance

FRU Field

Value

Description

midplane

1

Drawer_Cfg

1 or 2

Set the Netra CT functional configuration to 1 (satellite only) or 2 (hosted or mixed)

midplane

1

MCNetIPSubnet

IP subnet address (hexadecimal)

Specify the IP subnet address for the MCNet. The default is 0xc0a80d (192.168.13).

midplane

1

MCNetIPSubnetMask

IP subnet mask (hexadecimal)

Specify the IP subnet mask for the MCNet. The default is 0xffffff00 (255.255.255.0).

midplane

1

Location

text description

A description of the location (for example, the number on the chassis label) of the Netra CT system. This description is used in the MOH application. The text can be up to 80 characters in length.

midplane

1

Cust_Data

text description

Any customer-supplied information. The text can be up to 80 characters in length.

midplane

1

User_Label

text description

Any customer-supplied information. The text can be up to 10 characters in length.

slot

1 to 7

Acceptable_Fru_Types

vendor:partnumber

First, specify the chassis slot number to be configured, where the FRU Instance can be 1, 2, 3, 4, 5, 6, or 7 for a Netra CT 810 and 2, 3, 4, or 5 for a Netra CT 410. (Slots are numbered starting from the left.) Second, specify the allowable plug-in board(s) for that slot, where the value is the vendor name and part number (separated by a colon) of the board. Use the showfru command to display this information. Multiple boards may be specified, separated by a semicolon (;).

Type .* to allow all cPCI boards.

For the Netra CP2500 CPU board only, following its value, you can add a colon and specify the part number for that board's rear transition card.

slot

1 to 7

Boot_Devices

boot_device_list

First, specify the chassis slot number to be configured, where the FRU Instance can be 1, 2, 3, 4, 5, 6, or 7 for a Netra CT 810 and 2, 3, 4, or 5 for a Netra CT 410. (Slots are numbered starting from the left.) Second, specify the alias(es) listing the devices the board in this slot will boot from. The text can be up to 25 characters in length. When the board in this slot is powered up, this FRU information overwrites the entry in the OpenBoot PROM boot-device NVRAM configuration variable.

slot

1 to 7

Cust_Data

text description

First, specify the chassis slot number to be configured, where the FRU Instance can be 1, 2, 3, 4, 5, 6, or 7 for a Netra CT 810 and 2, 3, 4, or 5 for a Netra CT 410. (Slots are numbered starting from the left.) Second, specify any customer-supplied information. The text can be up to 80 characters in length.

fan

1 or 2

Acceptable_Fru_Types

vendor:partnumber

First, specify the fan number to be configured, where the FRU Instance can be 1 or 2 for the Netra CT 810 and 1 for the Netra CT 410. Second, specify the allowable fan for that slot, where the value is the vendor name and part number (separated by a colon) of the fan. Use the showfru command to display this information.

fan

1 or 2

Cust_Data

text description

Any customer-supplied information. The text can be up to 80 characters in length.

ps

1 or 2

Acceptable_Fru_Types

vendor:partnumber

First, specify the power supply number to be configured, where the FRU Instance can be 1 or 2 for the Netra CT 810 and 1 for the Netra CT 410. Second, specify the allowable power supply for that slot, where the value is the vendor name and part number (separated by a colon) of the power supply. Use the showfru command to display this information.

ps

1 or 2

Cust_Data

text description

Any customer-supplied information. The text can be up to 80 characters in length.

rtm

1 to 7

Cust_Data

text description

Any customer-supplied information. The text can be up to 80 characters in length. This information can only be specified for the rear transition card used with a Netra CP2500 CPU board.

scb

1

Cust_Data

text description

Any customer-supplied information. The text can be up to 80 characters in length.


Changes to FRU fields through the CLI setfru command require you to completely power the system off and on for the changes to take effect. To avoid powering the system off and on several times, enter all necessary FRU ID information at once, then power the system off and on.



Note - You must have the host CPU board, the alarm card, and the system controller board installed in the Netra CT server before powering it on. The system will not power on properly if all of these components are not installed.

The system power on sequence is as follows: (1) the alarm card comes up and powers on the power supplies; (2) the alarm card powers on I/O boards; (3) the alarm card powers on the host CPU board, and the Solaris OS boots; (4) the alarm card powers on satellite CPU boards supported by Sun Microsystems, such as the Netra CP2160 and the Netra CP2500. The power on sequence must finish before you can use the alarm card CLI commands poweron cpu_node and poweroff cpu_node.



The next several sections describe the configurations you can set by entering FRU ID information.


Specifying the Netra CT Server Functional Configuration

Netra CT server base configurations of rear access with diskful or diskless access are set at the factory. Each of these base configurations supports any one of the functional configurations shown in TABLE 2-2.


TABLE 2-2 Netra CT Server Functional Configurations

Configuration

Description

Hosted

Host CPU board and I/O boards

Satellite

Host CPU board and satellite CPU boards

Mixed

Host CPU board, satellite CPU boards, and I/O boards


There is no default functional configuration on the Netra CT server; you set the functional configuration using the alarm card CLI. The functional configuration information is used by the MOH application to audit board insertions and prevent misconfigurations. The functional configuration can be changed at any time if desired using the alarm card CLI.


procedure icon  To Specify the Netra CT Server Functional Configuration

1. Log in to the alarm card.

2. Set the functional configuration for the Netra CT server:


hostname cli> setfru fru_target fru_instance fru_field value

Refer to TABLE 2-1 for allowable information for each variable. For example, if you want to set the functional configuration to hosted, enter the following:


hostname cli> setfru midplane 1 Drawer_Cfg 2

3. Completely power off and on the system:

a. Press the system power button on the system status panel and release it to go through a graceful soft power-down; wait for the system power LED to go off.

b. Push the locking mechanism on the power supplies up (unlocked) to power down; wait for the green LEDs on the power supplies to go off; then push the locking mechanism on the power supplies down (locked) to power up.

Note: on the Netra CT 810 server, push the locking mechanism on both power supplies up and then down at the same time.

c. Press the system power button on the system status panel and release it to power on the server.


Configuring a Chassis Slot for a Board

You can specify the type of board that is allowed in a given chassis slot using the alarm card CLI. The slot usage information is used by the MOH application to audit board insertions and prevent misconfigurations. You can also specify the boot device for the slot, that is, the path to the device the board in the slot will boot from. When the board is powered on, the FRU boot device information overwrites the entry in the OpenBoot PROM boot-device NVRAM configuration variable on that board. The chassis slot information can be changed at any time if desired using the alarm card CLI.

By default, slots are configured to accept any cPCI FRU unless you specifically set an allowable plug-in for a specific slot. The exceptions are for a Netra CT 810 server, the alarm card must be in slot 8 and the host CPU must be in slot 1; for a Netra CT 410 server, the alarm card must be in slot 1 and the host CPU must be in slot 3.

To set allowable plug-ins for a particular slot, you need the vendor name and the part number of the board. This FRU ID information can be displayed using the CLI showfru command; see Displaying Netra CT Server FRU ID Information for more information.

An exception is the rear transition card for the Netra CP2500 CPU board; to set the allowable plug-in for a Netra CP2500 CPU board rear transition card, you need its part number only.


procedure icon  To Configure a Chassis Slot for a Board

1. Log in to the alarm card.

2. Set the acceptable FRUs for the slot:


hostname cli> setfru fru_target fru_instance fru_field value

Refer to TABLE 2-1 for allowable information for each variable. For example, if you want to set chassis slot 5 to allow only a Sun Microsystems (vendor 003E) particular CPU board (part number 595-5769-03), enter the following:


hostname cli> setfru slot 5 Acceptable_Fru_Types 003E:595-5769-03

3. Set the boot device for the slot:


hostname cli> setfru fru_target fru_instance fru_field value

Refer to TABLE 2-1 for allowable information for each variable. For example, if you want to set chassis slot 5 to boot from a device on the network, enter the following:


hostname cli> setfru slot 5 Boot_Devices boot_device_list

where boot_device_list is the alias(es) specifying the boot devices (limit is 25 bytes), for example, disk net.

4. Completely power off and on the system:

a. Press the system power button on the system status panel and release it to go through a graceful soft power-down; wait for the system power LED to go off.

b. Push the locking mechanism on the power supplies up (unlocked) to power down; wait for the green LEDs on the power supplies to go off; then push the locking mechanism on the power supplies down (locked) to power up.

Note: on the Netra CT 810 server, push the locking mechanism on both power supplies up and then down at the same time.

c. Press the system power button on the system status panel and release it to power on the server.


procedure icon  To Unconfigure A Chassis Slot Setting

single-step bulletTo clear any prior setting for a chassis slot, enter the following:


hostname cli> setfru slot # Acceptable_Fru_Types ""


Configuring the MCNet Interface

MCNet provides a communication channel over the cPCI midplane. It can be used to communicate between the alarm card, the host CPU board, and satellite CPU boards. It appears as any other generic Ethernet port in the Solaris OS. MCNet is configured by default on Solaris (host CPU and satellite CPUs) and on the alarm card. MCNet is used by the MOH and PMS applications.

Choosing the IP Address for the MCNet

The IP address of the MCNet interfaces on the CPU boards is formed as follows: The midplane FRU ID field MCNetIPSubnet contains the value IP_subnet_address.slot_number. The default IP subnet address is 0xc0a80d (192.168.13) and the default IP subnet mask is 0xffffff00 (255.255. 255.0). When you power on the Netra CT server, and if you have not made any changes for the MCNet interface in the midplane FRU ID, the IP address of a board installed in slot 2 will be configured to 192.168.13.2; if you then move that board to slot 4, the IP address for that board will be configured to 192.168.13.4.

The IP address of the MCNet interface on the alarm card is always the midplane FRU ID field MCNetIPSubnet value IP_subnet_address.8. This is the case for the alarm card in the Netra CT 810 server and in the Netra CT 410 server.


procedure icon  To Configure the MCNet Interface

1. Log in to the alarm card.

2. Set the FRU ID for the MCNet interface:


hostname cli> setfru fru_target fru_instance fru_field value

Refer to TABLE 2-1 for allowable information for each variable. You must set both the MCNet IP subnet address and the subnet mask in hexadecimal format. For example, to set the subnet address to 192.168.16 and the subnet mask to 255.255.255.0, enter the following:


hostname cli> setfru midplane 1 MCNetIPSubnet 0xc0a810
hostname cli> setfru midplane 1 MCNetIPSubnetMask 0xffffff00

3. Completely power off and on the system:

a. Press the system power button on the system status panel and release it to go through a graceful soft power-down; wait for the system power LED to go off.

b. Push the locking mechanism on the power supplies up (unlocked) to power down; wait for the green LEDs on the power supplies to go off; then push the locking mechanism on the power supplies down (locked) to power up.

Note: on the Netra CT 810 server, push the locking mechanism on both power supplies up and then down at the same time.

c. Press the system power button on the system status panel and release it to power on the server.

Checking the MCNet Configuration for the Solaris OS

After you boot the Solaris OS, you can check to see that MCNet has been configured by using the ifconfig -a command. You should see output for the mcn0 interface similar to the following:


# ifconfig -a...eri0: flags=10000843<UP,BROADCAST,RUNNING,MULTICAST,IPv4>mtu 1500
 index 1
  inet 192.168.207.64 netmask ffffff00 broadcast 192.168.207.255
  ether 8:0:20:a9:4d:1d
lo0: flags=1000849<UP,LOOPBACK,RUNNING,MULTICAST,IPv4>mtu 1500
 index 2
  inet 127.0.0.1 netmask ff000000
mcn0: flags=10000843<UP,BROADCAST,RUNNING,MULTICAST,IPv4>mtu 1500
 index 3
  inet 192.168.16.1 netmask ffffff00 broadcast 192.168.16.255
  ether 8:0:20:a9:4d:1d

To test for actual communication, use the ping -s command. You should see output similar to the following:


# ping -s 192.168.16.3
PING 192.168.13.3: 56 data bytes
64 bytes from 192.168.16.3:icmp_seq=0,time=1,ms
64 bytes from 192.168.16.3:icmp_seq=1,time=0,ms
64 bytes from 192.168.16.3:icmp_seq=2,time=0,ms
...
----192.168.16.3 PING statistics----
14 packets transmitted, 14 packets received, 0% packet loss
round-trip (ms) min/avg/max=0/0/1

Checking the MCNet Configuration on the Alarm Card

After you configure the MCNet interface, you can check to see that it has been configured by using the CLI shownetwork command. You should see output similar to the following:


hostname cli> shownetwork
Netract network configuration is:
 
ethernet ports
ip_addr :192.168.207.130
ip_netmask : 0xffffff00
mac_address : 00:03:ba:13:c4:dd
 
ip_addr :192.168.13.8
ip_netmask : 0xffffff00
mac_address : 00:03:ba:13:c4:dd
hostname cli> 


Specifying Other FRU ID Information

You can use the FRU fields Location, Cust_Data, and User_Label to enter any customer-specific information about your system. These are optional entries; by default, there is no information stored in these fields. Information entered in the Location field is displayed through the MOH application.

You might want to use the Location FRU field to enter specific, physical location information for your system. For example, you might enter the number on the chassis label, to indicate the location of the system.


procedure icon  To Specify Other FRU ID Information

1. Log in to the alarm card.

2. Specify other FRU ID information for the Netra CT server:


hostname cli> setfru fru_target fru_instance fru_field value

Refer to TABLE 2-1 for allowable information for each variable. For example, if you want to set the location information to reflect a chassis label that reads 12345-10-20, enter the following:


hostname cli> setfru midplane 1 Location 12345-10-20

3. Completely power off and on the system:

a. Press the system power button on the system status panel and release it to go through a graceful soft power-down; wait for the system power LED to go off.

b. Push the locking mechanism on the power supplies up (unlocked) to power down; wait for the green LEDs on the power supplies to go off; then push the locking mechanism on the power supplies down (locked) to power up.

Note: on the Netra CT 810 server, push the locking mechanism on both power supplies up and then down at the same time.

c. Press the system power button on the system status panel and release it to power on the server.


Displaying Netra CT Server FRU ID Information

FRU ID information entered during the manufacturing process and through the alarm card CLI setfru command can be displayed using the showfru command.

TABLE 2-3 shows the FRU ID information that can be displayed with the CLI showfru command. Use the FRU field to specify the information you want.


TABLE 2-3 FRU ID Information Displayed Using the showfru Command

FRU Target

FRU Instance

FRU Field

Description

midplane

1

Sun_Part_No

Display the part number for the midplane.

midplane

1

Sun_Serial_No

Display the serial number for the midplane.

midplane

1

Drawer_Cfg

Display the functional configuration (satellite, hosted, or mixed) for this system.

midplane

1

MCNetIPSubnet

Display the MCNet IP subnet address in hexadecimal format for this system.

midplane

1

MCNetIPSubnetMask

Display the MCNet IP subnet mask in hexadecimal format for this system.

midplane

1

Vendor_Name

Display the vendor name for the midplane.

midplane

1

Fru_Shortname

Display the FRU short name for the midplane.

midplane

1

Initial_HW_Dash_Level

Display the initial hardware dash level of the midplane.

midplane

1

Initial_HW_Rev_Level

Display the initial hardware revision level of the midplane.

midplane

1

Location

Display any customer-supplied text specified for the location of this system.

midplane

1

User_Label

Display any customer-supplied text for this field.

midplane

1

Cust_Data

Display any customer-supplied text for this field.

slot

1 to 8

Sun_Part_No

Display the part number for the board in a particular slot.

slot

1 to 8

Sun_Serial_No

Display the serial number for the board in a particular slot.

slot

1 to 8

Acceptable_Fru_Types

Display the allowable plug-in boards for a particular slot.

slot

1 to 8

Boot_Devices

Display the boot devices for a particular slot.

slot

1 to 8

Vendor_Name

Display the vendor name for the board in a particular slot.

slot

1 to 8

Fru_Shortname

Display the FRU short name for the board in a particular slot.

slot

1 to 8

Initial_HW_Dash_Level

Display the initial hardware dash level of the board in a particular slot.

slot

1 to 8

Initial_HW_Rev_Level

Display the initial hardware revision level of the board in a particular slot.

slot

1 to 8

Cust_Data

Display any customer-supplied text for this field for the board in a particular slot.

fan

1 or 2

Acceptable_Fru_Types

Display the vendor name and part number for fan tray 1 or 2.

fan

1 or 2

Sun_Part_No

Display the part number for fan tray 1 or 2.

fan

1 or 2

Sun_Serial_No

Display the serial number for fan tray 1 or 2.

fan

1 or 2

Vendor_Name

Display the vendor name for fan tray 1 or 2.

fan

1 or 2

Fru_Shortname

Display the FRU short name for fan tray 1 or 2.

fan

1 or 2

Initial_HW_Dash_Level

Display the initial hardware dash level of fan tray 1 or 2.

fan

1 or 2

Initial_HW_Rev_Level

Display the initial hardware revision level of fan tray 1 or 2.

fan

1 or 2

Cust_Data

Display any customer-supplied text for this field for fan tray 1 or 2.

ps

1 or 2

Acceptable_Fru_Types

Display the vendor name and part number for power supply unit 1 or 2.

ps

1 or 2

Sun_Part_No

Display the part number for power supply unit 1 or 2.

ps

1 or 2

Sun_Serial_No

Display the serial number for power supply unit 1 or 2.

ps

1 or 2

Vendor_Name

Display the vendor name for power supply unit 1 or 2.

ps

1 or 2

Fru_Shortname

Display the FRU short name for power supply unit 1 or 2.

ps

1 or 2

Initial_HW_Dash_Level

Display the initial hardware dash level of power supply unit 1 or 2.

ps

1 or 2

Initial_HW_Rev_Level

Display the initial hardware revision level of power supply unit 1 or 2.

ps

1 or 2

Cust_Data

Display any customer-supplied text for this field for power supply unit 1 or 2.

rtm

1 to 8

Sun_Part_No

Display the part number for the rear transition card of a Netra CP2500 board in a particular slot.

rtm

1 to 8

Sun_Serial_No

Display the serial number for the rear transition card of a Netra CP2500 board in a particular slot.

rtm

1 to 8

Vendor_Name

Display the vendor name for the rear transition card of a Netra CP2500 board in a particular slot.

rtm

1 to 8

Fru_Shortname

Display the FRU short name for the rear transition card of a Netra CP2500 board in a particular slot.

rtm

1 to 8

Initial_HW_Dash_Level

Display the initial hardware dash level for the rear transition card of a Netra CP2500 board in a particular slot.

rtm

1 to 8

Initial_HW_Rev_Level

Display the initial hardware revision level for the rear transition card of a Netra CP2500 board in a particular slot.

rtm

1 to 8

Cust_Data

Display any customer-supplied text for this field for the rear transition card of a Netra CP2500 board in a particular slot.

scb

1

Sun_Part_No

Display the part number for the system controller board.

scb

1

Sun_Serial_No

Display the serial number for the system controller board.

scb

1

Vendor_Name

Display the vendor name for the system controller board.

scb

1

Fru_Shortname

Display the FRU short name for the system controller board.

scb

1

Initial_HW_Dash_Level

Display the initial hardware dash level of the system controller board.

scb

1

Initial_HW_Rev_Level

Display the initial hardware revision level of the system controller board.

scb

1

Cust_Data

Display any customer-supplied text for this field for the system controller board.



procedure icon  To Display FRU ID Information

1. Log in to the alarm card.

2. Enter the showfru command:


hostname cli> showfru fru_target fru_instance fru_field 

Refer to TABLE 2-3 for allowable information for each variable. For example, if you want to display the part number FRU ID information for fan tray 1, enter the following:


hostname cli> showfru fan 1 Sun_Part_No

Use the FRU target slot to display information for the alarm card, the CPU boards, and the I/O boards; the FRU slot instance can be 1, 2, 3, 4, 5, 6, 7, or 8 for a Netra CT 810 and 1, 2, 3, 4, or 5 for a Netra CT 410 (slots are numbered starting from the left). For example, to display part number FRU ID information for the alarm card in a Netra CT 810 server, enter the following:


hostname cli> showfru slot 8 Sun_Part_No


Configuring the CPU Boards

The supported configuration is to run the same version of the Solaris OS on all CPU boards in a chassis. You should verify that you can log in to the CPU boards. Any Solaris configuration needed for your environment should be done, such as modifying OpenBoot PROM variables. Refer to the Solaris documentation, the OpenBoot PROM documentation, or to the specific CPU board documentation if you need additional information.

Although various combinations of cPCI boards, including the Netra CP2140, the Netra CP2160, the Netra CP2500, and cPCI I/O cards, are allowed in the Netra CT 810 and 410 servers, power capability limits the maximum number of CP2500 boards in either server to three. Refer to the Netra CT Server Upgrade Guide or to the Netra CT Server Service Manual for information on system power capability and configurations.

Current platform and CPU board information can be displayed with the uname and prtpicl Solaris commands, as shown in TABLE 2-4.


TABLE 2-4 Displaying Platform and CPU Board Information

CPU Board Location

Command

Platform or Property Displayed

Meaning

Host slot

uname -i

SUNW,NetraCT-810 or

SUNW,NetraCT-410

The CPU board in the host slot is either a Netra CP2140 or a Netra CP2500.

Satellite slot

uname -i

SUNW,NetraCT-810 or

SUNW,NetraCT-410

 

SUNW,NetraCP2500

The CPU board in the satellite slot is a Netra CP2160.

 

The CPU board in the satellite slot is a Netra CP2500.

Host slot

prtpicl -v

...

:name CPU

SUNW,Netra-CP2140...

HostCPU...

 

...

:name CPU

SUNW,Netra-CP2500...

HostCPU...

The CPU board in the host slot is a Netra CP2140.

 

 

 

The CPU board in the host slot is a Netra CP2500.

Satellite slot

prtpicl -v

...

:name CPU

SUNW,Netra-CP2160...

 

...

:name CPU

SUNW,Netra-CP2500...

The CPU board in the satellite slot is a Netra CP2160.

 

 

The CPU board in the satellite slot is a Netra CP2500.


The alarm card must be present in the system to power on the host CPU board. Once the host CPU board is powered on, the alarm card and the host CPU board can be rebooted independently. The host CPU board can be rebooted while the alarm card is resetting; however, if you do this simultaneously, you also need to reboot any satellite boards so the host CPU board MOH agent can manage them using MCNet.


Enabling the Managed Object Hierarchy Application

The Managed Object Hierarchy (MOH) is an application that runs on the alarm card, the host CPU, and satellite CPUs. It monitors the field-replaceable units (FRUs) in your system.

Software Required

The MOH application requires the Solaris 9 OS, and additional Netra CT platform-specific Solaris patches that contain packages shown in TABLE 2-5.


TABLE 2-5 Solaris Packages for the MOH Application

Package

Description

SUNW2jdrt

Javatrademark Runtime Java Dynamic Management Kit (JDMK) package

SUNWctmgx

Netra CT management agent package

SUNWctac

Alarm card firmware package that includes the Netra CT management agent


Download Solaris patch updates from the web site: http://www.sunsolve.sun.com. For current patch information, refer to the Netra CT Server Release Notes.

Install the patch updates using the patchadd command. After these packages are installed, they reside in the default installation directory, /opt/SUNWnetract/mgmt2.0/bin. To verify the packages are installed, use the pkginfo command:


# pkginfo -l SUNW2jdrt SUNWctmgx SUNWctac
...
PKGINST: SUNW2jdrt
...

The Netra High Availability Suite may be used to provide enhanced services for customer high-availability applications. It is required to use certain monitoring capabilities of the MOH application, such as monitoring nfs and tftp daemons. The Netra HA Suite is ordered and shipped separately from the Netra CT server.

Once the MOH application is running, MOH agents on the alarm card and on CPU boards interface with your Simple Network Management Protocol (SNMP) or Remote Method Invocation (RMI) application to discover network elements, monitor the system, and provide status messages.

Refer to the Netra CT Server Software Developer's Guide for information on writing applications to interface with the MOH application.

Starting the MOH Application

The MOH application is started automatically on the alarm card.

You must start the MOH application as root on the CPU boards using the ctmgx start command:


# cd /opt/SUNWnetract/mgmt2.0/bin
# ./ctmgx start [options]

If you installed the Solaris patches in a directory other than the default directory, specify that path instead.

Options that can be specified with ctmgx start when you start the MOH application include:


TABLE 2-6 ctmgx Options

Option

Description

-drawerview

This option is valid only on the host CPU board. Specify that the MOH application model (represent) all components in the chassis. If the -drawerview option is not specified, MOH models only the host CPU board and any other cPCI boards in the chassis. This option is also required if you want to authenticate RMI application programs.

To switch between using the MOH application with or without the -drawerview option, stop the MOH application on the host CPU board, reset the alarm card, and restart the MOH application on the host CPU board.

-rmiport portnum

Specify the RMI port number. The default is 1099.

-snmpport portnum

Specify the SNMP port number. The default is 9161.

-snmpacl filename

Specify the SNMP access control list (ACL) file to be used. The full path to filename must be specified.

-showversion

Print the system version number.


By default, SNMP and RMI applications have read-write access to MOH agents on the alarm card and on CPU boards. The next sections describe how to configure MOH to control SNMP and RMI access on the alarm card and CPU boards.

MOH Configuration and SNMP

By default, SNMP applications have read-write access to the Netra CT server MOH agents. If you want to control which applications communicate with the MOH agents, you must configure the alarm card and CPU board SNMP interfaces. This configuration provides additional security by controlling who has access to the agent.

The SNMP interface uses an SNMP access control list (ACL) to control:

An SNMP community is a group of IP addresses of devices supporting SNMP. It helps define where information is sent. The community name identifies the group. An SNMP device or agent may belong to more than one SNMP community. An SNMP device or agent will not respond to requests originating from IP addresses that do not belong to one of its communities.

Alarm Card SNMP Interface

On the alarm card, you enter ACL information using the CLI snmpconfig command. A limit of 20 communities can be specified. For each community, a limit of five IP addresses can be specified. The ACL information is stored in the alarm card flash memory.


procedure icon  To Configure the Alarm Card SNMP Interface

1. Log in to the alarm card.

2. Enter SNMP ACL information with the snmpconfig command:


hostname cli> snmpconfig add|del|show access|trap community [readonly|readwrite] [ip_addr] 

where community is the name of a group that the MOH agent on the alarm card supports, and ip_addr is the IP address of a device supporting an SNMP management application. For example, to add read-only access (the default) for the community trees, to add read-write access for the community birds, and to add a trap for the community lakes, enter the following:


hostname cli> snmpconfig add access trees ip_addr ip_addr ip_addr
hostname cli> snmpconfig add access birds readwrite ip_addr
hostname cli> snmpconfig add trap lakes ip_addr

3. Reset the alarm card.

You can use the snmpconfig command to show or delete existing ACL information. For example, to show the ACL access and trap information entered in Step 2 above, enter the following:


hostname cli> snmpconfig show access *
Community   Permissions    Hosts
trees       read-only      ip_addr ip_addr ip_addr
birds       read-write     ip_addr
hostname cli> snmpconfig show trap *
Community   Hosts
lakes       ip_addr
hostname cli> 

 

CPU Board SNMP Interface

On CPU boards, ACL information is stored in a configuration file in the Solaris OS.

The format of this file is specified in the JDMK documentation. An ACL file template that is part of the JDMK package is installed by default in
/opt/SUNWjdmk/jdmk4.2/1.2/etc/conf/template.acl.

An example of a configuration file is:


acl = {
 {
 communities = trees
 access = read-only
 managers = oak, elm
 }
 {
 communities = birds
 access = read-write
 managers = robin
 } 
} 
 
trap = {
  {
  trap-community = lakes
  hosts = michigan, mead
  }
}

In this example, oak, elm, robin, michigan, and mead are hostnames. If this is the ACL file specified, when the MOH starts, a coldStart trap will be sent to michigan and mead. Management applications running on oak and elm can read (get) information from MOH, but they cannot write (set) information. Management applications running on robin can read (get) and write (set) information from MOH.

The ACL file can be stored anywhere on your system. When you start the MOH application and you want to use an ACL file you created, you specify the complete path to the file.

Refer to the JDMK documentation (http://www.sun.com/documentation) for more information on ACL file format.


procedure icon  To Configure a CPU Board SNMP Interface

1. Log in to the server.

2. Create a configuration file in the format of a JDMK ACL configuration file.

3. As root, start the MOH application.


# cd /opt/SUNWnetract/mgmt2.0/bin
# ./ctmgx start [options]

If you installed the Solaris patches in a directory other than the default directory, specify that path instead.

The MOH application starts and reads the configuration file using one of these methods, in this order:

If the ACL cannot be determined after these steps, SNMP applications will have read-write access and MOH will send the coldStart trap to the local host only.

MOH Configuration and RMI

By default, RMI applications have read-write access to the Netra CT server MOH agents. If you want to control which applications communicate with the MOH agents, you must configure the alarm card and host CPU board interfaces for RMI. This configuration provides additional security by authenticating who has access to the agent.

To authenticate which RMI applications can access the MOH agents on the alarm card and on the host CPU board, the following configuration is needed:

If MOH security for RMI was enabled but becomes disabled on the alarm card (for example, if the alarm card is being reset or hot-swapped), security will be disabled on the host CPU board as well; a security exception occurs and no access is given.


procedure icon  To Set Up an MOH User Account on the Alarm Card

1. Log in to the alarm card.

2. Add an MOH user:


hostname cli> mohuseradd username

3. Add a password for that user:


hostname cli> mohuserpassword username

Restrictions on the alarm card MOH user name and MOH user password are the same as for the alarm card user name and user password; see Username Restrictions and Password Restrictions.

By default, new MOH user accounts are created with read-only permission. Permission levels can be changed using the mohuserperm command; valid permissions for the mohuserperm command are r (read only) and rw (read and write).

The mohuserdel command is available to delete an MOH user; the mohusershow command can be used to show information for a particular MOH user name or for all MOH user names.


procedure icon  To Configure the Alarm Card RMI Interface

1. Verify that RMI programs you want to access the alarm card MOH agent contain a valid alarm card MOH user name and password, with appropriate permissions.

2. Log in to the alarm card.

3. Set the setmohsecurity option to true:


hostname cli> setmohsecurity true

4. Reset the alarm card.

The RMI authentication takes effect immediately. Any modification to the alarm card MOH user names and passwords also takes effect immediately. If the MOH application is running on the host CPU board, you must stop and restart it for the changes to take effect.


procedure icon  To Configure the Host CPU Board RMI Interface

1. Verify the following:

2. Log in to the host CPU board.

3. As superuser, start the MOH application.


# cd /opt/SUNWnetract/mgmt2.0/bin
# ./ctmgx start -drawerview

 


Enabling the Processor Management Service Application

The Processor Management Service (PMS) is a management application that provides support for high-availability services and applications, such as the Netra High Availability Suite. It provides both local and remote monitoring and control of a cluster of CPU boards.

This section describes:

You use the alarm card PMS CLI commands to control PMS services, such as fault detection/notification, and fault recovery. The recovery administration is described in Using the PMS Application for Recovery and Control of CPU Boards. You can also use the PMS API to configure partner lists (tables of alarm card and CPU board information relating to connectivity and addressing; the alarm card and the CPU boards in a partner list must be in the same system). Refer to the pms API man pages, installed by default in /opt/SUNWnetract/mgmt2.0/man, for more information on partner lists.


procedure icon  To Start or Stop the PMS Application on a CPU Board

1. Log in as superuser to the server that has the Solaris patches installed (see Software Required).

2. Create a Solaris script to start, stop, and restart PMS, as follows:


#!/sbin/sh
# Start/stop/restart processes required for PMS
 
case "$1" in
'start')
	/opt/SUNWnetract/mgmt2.0/bin/pmsd start -e force_avail
	;;
'stop')
	/opt/SUNWnetract/mgmt2.0/bin/pmsd stop
	;;
'restart')
	/opt/SUNWnetract/mgmt2.0/bin/pmsd stop
	/opt/SUNWnetract/mgmt2.0/bin/pmsd start -e force_avail
	;;
*)
	echo "Usage: $0 {start | stop | restart }"
	exit 1
	;;
esac
exit 0

3. Save the script to a file.

4. Start, stop, or restart the PMS application by typing one of the following:

where filename is the name of the file in which you saved the script.

You can also save this script in the /etc/rc* directory of your choice to have PMS automatically start at boot time.

This script starts PMS in the available state (start -e force_avail).

On CPU boards, PMS's internal timer service uses a default interval of 0.1 seconds as the time tick interval. You can adjust the tick interval to a number from 0.1 seconds to 2.0 seconds by using the -t option. For example, to start PMS with a tick interval of 1.0 seconds, use the command pmsd start -e force_avail -t 1.

Keeping the default interval value may lead to a large number of voluntary context switches in the system. You can check the effect of increasing the -t option to various intervals by looking at the output from the prstat command; the column labeled VCX contains the number of voluntary context switches received by the operating system from an application. An example of prstat output, with the -t option set to 1, is:


# prstat -v -c -L -p `pgrep pmsd` 10
    PID USERNAME USR SYS TRP TFL DFL LCK SLP LAT VCX ICX SCL SIG PROCESS/LWPID
    868 root     0.0 0.0  -   -   -   -  100  -   30   0  20   0 pmsd/6
    868 root     0.0 0.0  -   -   -   -  100  -   10   0  13   0 pmsd/5
    868 root     0.0 0.0  -   -   -   -  100  -    0   0   0   0 pmsd/4
    868 root     0.0 0.0  -   -   -   -  100  -    4   0  12   0 pmsd/3
    868 root     0.0 0.0  -   -   -   -  100  -    6   0   9   0 pmsd/2
    868 root     0.0 0.0  -   -   -   -  100  -    1   0   2   0 pmsd/1
Total: 1 processes, 6 lwps, load averages: 0.02, 0.02, 0.02
...

Stopping and Restarting the PMS Daemon on the Alarm Card

The PMS daemon (pmsd) starts automatically on the alarm card. However, you can manually stop and restart the PMS daemon on the alarm card, specifying these optional parameters:

You specify the port number for pmsd using the parameter port_num.

You specify the state in which to start pmsd using the parameter server_admin_state. This parameter may be set to force_unavail (force pmsd to start in the unavailable state); force_avail (force pmsd to start in the available state); or vote_avail (start pmsd in the available state, but only if all conditions have been met to make it available; if all the conditions have not been met, pmsd will not become available).

You specify whether to reset persistent storage to the default values on the alarm card using the -d option. Data in persistent storage remains across reboots or power on and off cycles. If you do not specify -d, pmsd is started using its existing persistent storage configuration; if you specify -d, the persistent storage configuration is reset to the defaults for pmsd. The -d option would typically be specified only to perform a bulk reset of persistent storage during initial system bring up or if corruption occurred.


procedure icon  To Manually Stop the Processor Management Service on the Alarm Card

1. Log in to the alarm card.

2. Stop the PMS daemon with the stop command:


hostname cli> pmsd stop [-p port_num] 

where port_num is the port number of the currently running pmsd you want to stop. The default is port 10300.


procedure icon  To Manually Start the Processor Management Service on the Alarm Card

1. Log in to the alarm card.

2. Start the PMS daemon with the start command:


hostname cli> pmsd start [-p port_num] [-e server_admin_state] [-d]

where port_num is the port number for pmsd to listen on, server_admin_state can be force_unavail, force_avail, or vote_avail, and -d resets the persistent storage to the defaults for pmsd.

Setting the IP Address for the Alarm Card to Control CPU Boards in the Same System

The pmsd slotaddressset command is used to set the IP address by which the alarm card controls and monitors a CPU board in a particular slot. The command establishes the connection between pmsd running on the alarm card and pmsd running on a CPU board. The alarm card and the CPU board must be in the same system.

You specify the slot number of the CPU board and the IP address to be configured. The default IP address for all slots is 0.0.0.0; therefore, control is initially disabled.


procedure icon  To Set the IP Address for the Alarm Card to Control CPU Boards in the Same System

1. Log in to the alarm card.

2. Set the IP address with the slotaddressset command:


hostname cli> pmsd slotaddressset -s slot_num -i ip_addr

where slot_num can be a slot number from 1 to 8, and ip_addr is the IP address to be configured.

Printing IP Address Information

The pmsd slotaddressshow -s slot_num|all command can be used to print IP address information for the specified slot or all slots. If the IP address information is not 0.0.0.0 for a given slot, PMS is configured to manage the CPU board in this slot using this IP address.

Adding Address Information for a Local CPU Board to Control CPU Boards in Local or Remote Systems

You can use the PMS CLI application to enable local CPU boards to remotely monitor and control CPU boards in the same system or in other Netra CT systems. One use for this capability is in a high availability environment. For example, if a high availability application fails on a controlled CPU board, PMS notifies the controlling CPU board of the failure, and the controlling CPU board (through a customer application) notifies another controlled CPU board to start the same high availability application.

The pmsd slotrndaddressadd command is used to configure a local CPU board to control and monitor another CPU board by specifying the IP addresses and slot information for the CPU board to be controlled, using the parameters shown in TABLE 2-7.


TABLE 2-7 pmsd slotrndaddressadd Parameters

Parameter

Description

-s slot_num|all

Specifies the slot number of the CPU that is being configured in the local system to monitor or control other local or remote CPUs

-n ip_addr

Specifies the IP address of the CPU board in the local or remote system to be monitored or controlled by the local CPU

-d ip_addr

Specifies the IP address of the alarm card in the same local or remote system of the CPU board to be monitored or controlled by the local CPU

-r slot_num

Specifies the slot number of the CPU board in the local or remote system to be monitored or controlled by the local CPU


Each local CPU board can control and monitor 16 local or remote CPU boards. Each local CPU board being managed must have already had its IP address set using the pmsd slotaddressset command.


procedure icon  To Add Address Information for a Local CPU Board to Control CPU Boards in Local or Remote Systems

1. Log in to the alarm card.

2. Add the address information with the slotrndaddressadd command:


hostname cli> pmsd slotrndaddressadd -s slot_num|all -n ip_addr -d ip_addr -r slot_num

where -s slot_num is the slot number in the same system of the local CPU board you want to use to control other local or remote CPU boards, and all specifies all slots containing CPU boards in the local system; -n ip_addr is the IP address of the CPU board to be controlled; -d ip_addr is the IP address of the alarm card in the system of the CPU board to be controlled; and -r slot_num is the slot number of the CPU board to be controlled.

When you add address information with the slotrndaddressadd command, an index number is automatically assigned to the information. You can see index numbers by using the slotrndaddressshow command and use the index numbers to delete address information with the slotrndaddressdelete command, described below.

Deleting Address Information

The pmsd slotrndaddressdelete -s slot_num|all -i index_num|all command can be used to delete address information from the controlling CPU board. The -s slot_num|all parameter specifies whether the address information will be deleted on a single slot number or on all slots containing CPU boards in the local system. The -i index_num|all parameter specifies whether the address information will be deleted for a single address entry or for all address entries; index_num can be 1 to 16. Before using this command, it is advisable to print the current address information using the pmsd slotrndaddressshow command, so you know the index number to use.

Printing Address Information

The pmsd slotrndaddressshow -s slot_num|all -i index_num|all command can be used to print address information. The -s slot_num|all parameter specifies whether the address information will be printed for a single slot number or for all slots containing CPU boards in the local system; index_num can be 1 to 16. The -i index_num|all parameter specifies whether the address information will be printed for a single address entry or for all address entries.