Adding and deleting boards

This topic describes how to perform the following tasks with oamcfg:

Creating a record in the database

To create a record in the NMS OAM database for the object, enter:

oamcfg -c product [-l PCIbus:slot] [-n brdname] [-b brdno] [-@ host]

The following table explains each option:

Option

Use this option to specify...

-c product

Product string for the board type. Refer to Displaying board product types for information on retrieving a list of valid product name strings. If product is omitted, oamcfg chooses the first product name in this list.

-l PCIbus:slot

PCI bus and slot location of a board in the system. If this option is omitted, oamcfg assumes PCI bus 0, slot 0.

-n brdname

Name to give the board. If this option is omitted, a default name is generated.

-b brdno

Number to give the board (0 - 15). If this option is omitted, a default number is generated.

-@ host

Machine name or IP address of the resource host where the board is located. If not specified, oamcfg performs its operations on the host on which it is initialized.


The -g and -m options cannot be used to identify the board in this operation. Refer to Command line options.

Note: The board must currently be physically installed in the system for its name to be added or deleted from the NMS OAM database.

For example, the following command adds a record for a CG 6000C board located in PCI bus 0, slot 20 on resource host MyHost1:

oamcfg -c CG_6000C_QUAD -l 0:20 -@ MyHost1

When a record is created for a board, the record includes a unique name and board number for the board. You can use either of these identifiers to refer to the board in future calls. To learn how to retrieve this information, refer to Reading and changing database information.

You can change the board name or number. Refer to Changing board ID information.

Automatically detecting and adding boards

oamcfg can automatically detect boards in a resource host chassis. You can then use oamcfg to add records for detected boards to the NMS OAM database on that host.

To detect boards in a chassis, use the -x option. To detect boards in a resource host, also include the -@ option indicating the host:

oamcfg -x -@ MyHost1

oamcfg detects boards in the chassis and creates entries in the DetectedBoards[x] array keyword for each board. These keywords are displayed on the screen, as follows:

DetectedBoards[0].Name = AG_2000_0_16
DetectedBoards[0].Product = AG_2000
DetectedBoards[0].Location.PCI.Bus = 0
DetectedBoards[0].Location.PCI.Slot = 16
DetectedBoards[1].Name = AG_2000_BRI_0_17
DetectedBoards[1].Product = AG_2000_BRI
DetectedBoards[1].Location.PCI.Bus = 0
DetectedBoards[1].Location.PCI.Slot = 17
DetectedBoards[2].Name = AG_4000_E1_0_15
DetectedBoards[2].Product = AG_4000_E1
DetectedBoards[2].Location.PCI.Bus = 0
DetectedBoards[2].Location.PCI.Slot = 15

 

Note: If you have a chassis with an unusual PCI bus topology (for example, bus number 171 directly follows bus number 0), oamcfg searches functions more slowly. To speed up operation, create a text file specifying bus numbers to search. Refer to Specifying PCI bus numbers for board search functions for more information.

To add a detected board to the NMS OAM database, use the -a option. Also specify the -n option indicating the name of the board to add. For example, the following command line adds detected board AG_2000_0_16 to the database on resource host MyHost1:

oamcfg -a -n AG_2000_0_16 -@ MyHost1

 

To add all detected boards at once, omit any specific board name, as follows:

oamcfg -a -@ MyHost1

Deleting a board

To delete a board from the NMS OAM database, use the -d option. The following command deletes the board named myboard:

oamcfg -d -n myboard

 

Note: This operation does not require that the board be physically removed from the system.

If no board is specified, oamcfg deletes all boards from the NMS OAM database.