Introduction

OAM Service

Configuration File Changes

Keyword Changes

Introduction

This chapter describes migration from earlier versions of AG software.

With the 2000-1 release of Natural Access, some major changes were made in the configuration and monitoring aspects of AG software including:

• Introduction of the OAM service

• Configuration file changes

• Keyword changes

OAM Service

Natural Access 2000-1 introduces the OAM service. This service performs configuration, monitoring, and testing functions across the telephony resources, including the AG boards.

The OAM service manages a central database of configuration information. Every board in the system has a record in the database, describing its configuration. The OAM service can start (boot) boards based on the information in the database.

The OAM service can be controlled programmatically, using its API. It can also be controlled using various utilities. One of these utilities, oamsys, effectively takes the place of the agmon configuration and booting function: it takes a configuration file, loads into the NMS OAM database, and then starts the boards. Another utility, oammon, takes the place of the agmon monitoring function. After running oamsys, you can run oammon to monitor for board errors and other board-level events. For details on using these utilities to configure the AG system, refer to Chapter 3. For more general information on the OAM service and related utilities, refer to the NMS OAM System User's Manual.

Configuration File Changes

agmon took a single configuration file, ag.cfg, containing configuration information for each board. Each board was referenced using a board number. oamsys takes a system configuration file that assigns each board:

• A board name, used to refer to the board in software

• A board number, used to refer to the board in legacy software

• A board keyword file, containing the configuration information for the board.

The internal structure of the system configuration file and the board keyword file is very different from agmon configuration files. For details on creating a file for your system, refer to Chapter 3. For more general information on NMS OAM configuration files, refer to the NMS OAM System User's Manual.

Keyword Changes

The statements used in configuration files have also changed. Most configuration statements are specified in the board keyword file. They are expressed in keyword name/value pairs. Keywords have type definitions; for example, some keywords can take integer values, whereas others take string values. Some keywords represent arrays of values, or structures of other keywords or arrays.

The following table lists agmon keywords and NMS OAM keyword equivalents. For details on AG-specific keywords and values, refer to Chapter 6. For more general information on NMS OAM keywords, refer to the NMS OAM System User's Manual.

Old Keyword	New Keyword	Notes
AG2DSP_Lib	DSP.C5x.Lib
AG2DSP_Loader	DSP.C5x.Loader
AG2DSP_OS	DSP.C5x[x].Os	x = the number specified in the AG2DSP_OS keyword.
AG2DSPFile	DSP.C5x.DSPFiles[x]	x = running count of files from the Common section and from the board-specific section. Ensure that this list contains: callp, dtmf, ptf, mf, and tone.
AG2DSPImage	DSP.C5x[x].Image DSP.C5x.Image	x = the number specified in the AG2DSPImage keyword.
AG2TaskProcessor	DSP.C5x[x].Files[y]	If a DSP processor range is specified, then it converts to x. Otherwise, it applies to all processors (from 0 to number of DSPs).
Buffers	Buffers[x].Num where x = 0
BufferSize	Buffers[x].Size where x = 0
ClockRef	Clocking.HBus.ClockSource	AG OSC H100 SEC8K NET1 NET2 NET3 NET4 MVIP	NMS OAM OSC A_CLOCK NETREF NETWORK NETWORK NETWORK NETWORK C4
	Clocking.HBus.ClockSourceNetwork	If ClockRef was set to NETx, set this keyword = x.
ConnectMode	SwitchConnectMode	AG FRAMED UNFRAMED	NMS OAM AllConstantDelay AllDirect
D_channel	NetworkInterface.T1E1[x].D_Channel	If DigitalMode = PRI, set NetworkInterface.T1E1[x]. D_Channel = ISDN. If DigitalMode = RAW, set NetworkInterface.T1E1[x]. D_Channel = ISDN_NONE.
Diagnostics	BootDiagnosticLevel
DigitalMode	NetworkInterface.T1E1[x].SignalingType	x is the trunk number.
DriveSec8K	Clocking.HBus.NetRefSource Clocking.HBus.NetRefSourceNetwork	If DriveSec8K = OSC, set Clocking.HBus.NetRefSource = OSC. If DriveSec8K is set to any other value, set Clocking.HBus.NetRefSource = NETWORK. If DriveSec8K = NET1, NET2, NET3, or NET4, then set this keyword to 1, 2, 3, or 4. Otherwise, do not set this keyword.
EnableMVIP	Clocking.HBus.ClockMode	If there is no EnableMVIP setting in agmon, refer to the ClockRef value. If ClockRef is equal to either H100 or MVIP, set Clocking.HBus.ClockMode = SLAVE. If ClockRef is equal to a value other than H100 or MVIP, set Clocking.HBus.ClockMode = STANDALONE. If EnableMVIP was set to NO in agmon, set Clocking.HBus.ClockMode = STANDALONE. If EnableMVIP = YES, determine the ClockRef setting in the ag.cfg file. If the ClockRef setting was H100 or MVIP, set to SLAVE. If the ClockRef setting was not H100 or MVIP, set to MASTER_A. There is no migration for the MASTER_B option.
FrameType	NetworkInterface.T1E1[x].FrameType	Use the value of FrameType in ag.cfg. where x is the trunk number. A value must be specified even if one was not specified in agmon. T1 = ESF or D4 E1 = CEPT
IdleCode	SignalIdleCode VoiceIdleCode Xlaw	If IdleCode = number, use this number for both SignalIdleCode and for VoiceIdleCode. If IdleCode is equal to two numbers, use the first number for VoiceIdleCode and use the second number for SignalIdleCode. If IdleCode = string, set Xlaw as follows:
		AG Mu-LAW A-LAW	NMS OAM MU-LAW A-LAW
LineCode	NetworkInterface.T1E1[x].LineCode	x = trunk number A value must be specified even if one was not specified in agmon. If you have a T1 board and NetworkInterface.T1E1[x]. SignalingType = CAS, set this value to AMI_ZCS. If you have a T1 board and NetworkInterface.T1E1[x]. SignalingType is not equal to CAS, set this value to B8ZS. If you have an E1 board, set this value to HDB3.
LineLength	NetworkInterface.T1E1[x].Length	Use the value of LineLength in ag.cfg where x is the trunk number. Do not generate a default if a LineLength was not specified.
LoadFile	LoadFile
MaxChannels	MaxChannels
MedBuffers	Buffers[x].Num where x = 1
MedBufferSize	Buffers[x].Size where x = 1
NAI	NetworkInterface.T1E1[x].ISDN.NFAS_ MEMBER[y].NAI
NFAS_Group	NetworkInterface.T1E1[x].ISDN.D_Channel_Backup_Trunk NetworkInterface.T1E1[x].ISDN.NFAS_ MEMBER[y].Board NetworkInterface.T1E1[x].ISDN.NFAS_ MEMBER[y].NAI NetworkInterface.T1E1[x].ISDN.NFAS_ MEMBER[y].Trunk NetworkInterface.T1E1[x].ISDN.NFASGroup
PCIbus	Location.PCI.Bus
PCIslot	Location.PCI.Slot
RunFile	RunFile
RunModule	DLMFiles[x]
SmallBuffers	Buffers[x].Num where x = 2
TCP	TCPFiles[x]