When configuring the parameters listed in Adapter configuration parameters , configure server names for the following:

Table 1. Adapter configuration parameters

Parameter

Type

Description

Values

EMS/JMS connection configuration parameters

EMSVersion

string

Specifies the EMS version

17.9 to 19.6

EmsInstance

4 strings

Specifies:

  • IP address where the Alcatel-Lucent 5620 SAM EMS server is running

  • Alcatel-Lucent 5620 SAM EMS server port number

  • user login

  • user password (must be MD-5-hashed)

“Generating an MD-5-hashed password” on page 38 provides important instructions.

NOTE: This user name must be configured with OSS Management privileges, as described in “Configuring the Alcatel-Lucent 5620 SAM EMS server” on page 28.

NOTE: For assistance with Alcatel-Lucent 5620 SAM EMS user names and passwords, consult your Alcatel-Lucent administrator.

AltEmsInstance

4 strings

For the standby Alcatel-Lucent 5620 SAM EMS server, specifies:

  • IP address where the Alcatel-Lucent 5620 SAM EMS server is running

  • Alcatel-Lucent 5620 SAM EMS server port number

  • user login

  • user password (must be MD-5-hashed)

“Generating an MD-5-hashed password” on page 38 provides important instructions.

NOTE; If there is no standby Alcatel-Lucent 5620 SAM EMS server, enter the same values as for EmsInstance.

NOTE: For assistance with Alcatel-Lucent 5620 SAM EMS user names and passwords, consult your Alcatel-Lucent administrator.

JmsPort

string

Specifies the URL:port where the SAM-O accepts requests to monitor asynchronous events.

Check with your 5620 SAM EMS administrators when setting the value for JmsPort and AltJmsPort. If it is improperly set, the Adapter will not be able to connect to the alternate 5620 SAM EMS server when a switchover occurs.

Must be resolvable from the machine where the adapter is running.

NOTE: The Alcatel-Lucent 5620 SAM EMS behaves differently based on which JMS Ports are selected. If the 5620 SAM EMS is running in

  • Standalone mode—Use port 1099.

  • Redundant mode for High Availability—Use port 1100.

If necessary, check with your Alcatel-Lucent 5620 SAM EMS administrator to determine the mode.

AltJmsPort

string

Specifies the URL:port on the standby Alcatel-Lucent 5620 SAM EMS server where the SAM-O accepts requests to monitor asynchronous events.

Check with your 5620 SAM EMS administrators when setting the value for JmsPort and AltJmsPort. If it is improperly set, the Adapter will not be able to connect to the alternate 5620 SAM EMS server when a switchover occurs.

Must be resolvable from the machine where the adapter is running.

NOTE: The Alcatel-Lucent 5620 SAM EMS behaves differently based on which JMS Ports are selected. If the 5620 SAM EMS is running in

  • Standalone mode—Use port 1099.

  • Redundant mode for High Availability—Use port 1100.

If necessary, check with your Alcatel-Lucent 5620 SAM EMS administrator to determine the mode.

ClientId

string

The identifier the Adapter is to use when making XML requests to Alcatel-Lucent 5620 SAM EMS.

Recommended to be of format: smarts@12345

JmsUniqueId

string

For durable JMS connections, this ID identifies the Adapter to the Alcatel-Lucent 5620 SAM EMS server.

Recommended to be of format: smarts@12345

NOTE: For non-durable JMS connections, leave this field blank.

JmsUser

string

JMS connections require valid user names and passwords. This field specifies the user name to be used by the Adapter.

Must match the user name configured on the Alcatel-Lucent 5620 SAM EMS server, as provided by your Alcatel-Lucent administrator. Step 7 of “Configuring the Alcatel-Lucent 5620 SAM EMS server” on page 28 provides instructions.

NOTE: This user name must be configured with OSS Management privileges, as described in “Configuring the Alcatel-Lucent 5620 SAM EMS server” on page 28.

NOTE: For assistance with Alcatel-Lucent 5620 SAM EMS user names and passwords, consult your Alcatel-Lucent administrator.

JmsPassword

string

JMS connections require valid user names and passwords. This field specifies the password to be used by the Adapter.

Must match the password configured on the Alcatel-Lucent 5620 SAM EMS server, as provided by your Alcatel-Lucent administrator. Step 7 of “Configuring the Alcatel-Lucent 5620 SAM EMS server” on page 28 provides instructions.

This must be the clear text version, not the md5-hashed version.

NOTE: For assistance with Alcatel-Lucent 5620 SAM EMS user names and passwords, consult your Alcatel-Lucent administrator.

JMS reconnection management

EMSReconnectInterval

integer

Specifies the interval at which the Adapter tries to reconnect to the EMS server. This value is in seconds.

Default is 60

If set to zero, the Adapter does not automatically reconnect to the EMS, so you must initiate reconnection manually, as described in “restartJMSConnector.asl” on page 142.

JmsConnectionMode

string

Specifies whether the JMS server sends new messages before earlier messages have been acknowledged. There are two modes:

  • DUPS (DUPS_OK_ACKNOWLEDGE): JMS server may send new messages before earlier messages are acknowledged (this mode is valid only for EMS 17.9 or later)

  • AUTO (AUTO_ACKNOWLEDGE): JMS server will not send a new message until message is acknowledged

Default is AUTO

MissedKeepAliveMessages

integer

Specifies the number of consecutive KeepAlive messages that are missed to determine the EMS Connection to have failed.

Default is 3

RestartTimeAfterTerminateClient

integer

Specifies the time interval at which the adapter will try to reconnect to the EMS after receiving the TerminateClientSession message from the EMS.

The time is specified in seconds and defaults to 600. (10 minutes)

Discovery options

DiscoveryOnStartup

boolean

This parameter controls whether a full discovery will be performed immediately after startup.

TRUE or FALSE

Default is FALSE.

NOTE: Alcatel-Lucent does not recommend that you set this parameter to TRUE. If the parameter is set to TRUE, the Adapter will start a full discovery upon startup.

After the repositories are populated by a discovery, you should set this parameter to FALSE for future restarts.

DiscoveryOnJmsLoss

boolean

This parameter controls whether SAM-O discovery will be initiated automatically when JMS events are missed or when the 5620 SAM server switches.

TRUE or FALSE. Default is TRUE.

NOTE: For large topologies, Alcatel-Lucent recommends that you set this to FALSE.

FibDiscoveryEnabled

boolean

This parameter controls whether discovery of FIB will be performed.

WARNING: Enabling this in a large-scale network could increase discovery time drastically.

TRUE or FALSE. Default is FALSE.

IGMPNetworkDiscoveryEnabled

boolean

This parameter controls whether discovery of IGMPNetwork will be performed.

Please edit the file <SM_HOME>/conf/alcatel-sam/ASA-Filter.conf and uncomment the line containing "igmp.IfGroup" if IGMPNetwork discovery is enabled.

WARNING: Enabling this in a large-scale network could increase Multicast discovery time drastically.

TRUE or FALSE. Default is FALSE.

MulticastTreeDiscoveryEnabled

boolean

This parameter controls whether discovery will be performed to construct Multicast Tree components such as (S,G), (*,G) and PIM Hops.

WARNING: Enabling this in a large-scale network could increase Multicast post-processing time drastically.

TRUE or FALSE. Default is FALSE.

Create7210NetworkConnections

boolean

This parameter controls whether the adapter creates network connections based on /30 and /31 IP addresses in 7210 SAS-E Switches.

Note: When setting this parameter to TRUE, set CreateIESSAPs and CreateVPRNSAPs to TRUE also.

TRUE or FALSE. Default is FALSE.

CreateIESSAPs

boolean

This parameter controls whether Service Access Point objects for IES services will be discovered.

TRUE or FALSE. Default is FALSE.

CreateVLLSAPs

boolean

This parameter controls whether Service Access Point objects for VLL services will be discovered.

TRUE or FALSE. Default is FALSE.

CreateVPLSSAPs

boolean

This parameter controls whether Service Access Point objects for VPLS services will be discovered.

TRUE or FALSE. Default is FALSE.

CreateVPRNSAPs

boolean

This parameter controls whether Service Access Point objects for VPRN services will be discovered.

TRUE or FALSE. Default is TRUE.

UnmanageWhenInMaintenance

boolean

This parameter controls if the IsManaged attribute will be set to false when the topology is in maintenance mode (olcState == 1).

TRUE or FALSE. Default is TRUE.

VPLSRTPrefix

integer

The adapter will use this prefix to create RouteTargets for each VPLS This parameter is required to be distinct for each adapter in a multi- adapter environment. In addition, it is also highly recommended this value is chosen such that the resulting RouteTarget, which is formed by combining this parameter with the VPLS service component id (or service manager id), will not collide with RouteTargets of VPRN VPN.

Default is 9999.

Domain Manager names

ASAServerName

string

Name of the Adapter for Alcatel-Lucent 5620 SAM EMS server

Default, ASAM

AMServerName

string

Name of the VMware Smart Assurance IP Availability Manager server

NOTE: This server is mandatory.

Default, INCHARGE-AM

OIServerName

string

Name of the VMware Smart Assurance Adapter Platform Server

NOTE: This server is mandatory.

Default, INCHARGE-OI

MPLSServerName

string

Name of the VMware Smart Assurance MPLS Manager server

Default, INCHARGE- MPLS-TOPOLOGY

“Preventing access to an optional server” on page 38 provides important information.

BGPServerName

string

Name of the VMware Smart Assurance Network Protocol Manager for BGP server

Default, INCHARGE-BGP

“Preventing access to an optional server” on page 38 provides important information.

OSPFServerName

string

Name of the VMware Smart Assurance Network Protocol Manager for OSPF server.

Default, INCHARGE-OSPF

“Preventing access to an optional server” on page 38 provides important information.

ISISServerName

string

Name of the VMware Smart Assurance Network Protocol Manager for IS-IS

Default, INCHARGE-ISIS

“Preventing access to an optional server” on page 38 provides important information.

MCASTServerName

string

Name of the VMware Smart Assurance Multicast Manager server

Default, INCHARGE-MCAST

“Preventing access to an optional server” on page 38 provides important information.

Domain Manager reconfiguration parameters

ReconfigureDelayTime

integer

Determines how long the adapter initially delays before invoking a reconfigureAndWait on a backend VMware Smart Assurance analysis server. Running a reconfiguration too often can cause performance issues on the backend servers. Certain processes inside the Adapter require a reconfigure to take place before processes can run.

This time is specified in seconds and defaults to 180 seconds (3 minutes).

ReconfigureSlidingWindow

integer

Determines how long the Adapter waits after ReconfigureDelayTime for a quiet period. This parameter is used to slide the delay forward in tiny increments when topology changes are still rapidly being processed by the adapter.

This time is specified in seconds and defaults to 10 seconds.

MaximumReconfigureDelayTime

integer

Determines the maximum delay the Adapter will wait before invoking a reconfigureAndWait on a backend VMware Smart Assurance analysis server. This value should be longer or the same as ReconfigureDelayTime.

The time is specified in seconds and defaults to 210 seconds (3.5 minutes).

Raw Alcatel-Lucent 5620 SAM EMS alarm handling options

ClearAlarmOnDelete

boolean

When SAM-O deletes alarms, this parameter controls whether the corresponding notifications should be cleared.

TRUE or FALSE. Default is TRUE.

NOTE: This parameter is in effect only when ArchiveOnDelete is set to TRUE.

ArchiveOnDelete

boolean

When SAM-O deletes alarms, this parameter controls whether the corresponding notifications should be archived.

TRUE or FALSE. Default is TRUE.

Router Down analysis enhancement parameters

NeighborDownThresholdForRouterDown

integer

Specifies the threshold percentage of NPM neighbors of a router that are experiencing SnmpReachability problems in order to conclude that this router is functionally down.

This is a percentage value and defaults to 80. If this value is set to 0, then a router down event will be generated whenever a SnmpReachabilityProblem (Alarm 243) is received from the EMS.

RouterDownCheckInterval

integer

Specifies the time interval in seconds at which the router down verification procedure runs.

Default is 60

Miscellaneous configuration parameters

LogLevel

integer

Data logged at this level or more important is kept, other data is discarded.

  • Level 1 will log severe messages only.

  • Level 2 will log warnings and severe messages.

  • Level 3 will log informational messages, warnings, and severe messages.

  • Level 7 will log everything (including verbose internal messages).