Use this Knowledge Script to retrieve the latest Operational Measurement (OM) report from the Signaling Server, the VGMC, the MGC, and the MC32S. This script also retrieves the previous OM Report, if one is available.
Run GetOMReport on the Signaling Server resource object before running the following scripts:
Run GetOMReport on the VGMC, MGC, and MC32S resource objects before running the VGMC_CallQuality Knowledge Script.
The GetOMReport Knowledge Script automatically uses FTP to retrieve the OM Report from the Signaling Server, the VGMC, the MGC, and MC32S. Configure special FTP requirements in AppManager Security Manager. For more information, see Section 4.4.5, Configuring FTP Server Parameters.
The script hangs in Running state unless you configured all required SNMP community strings, PDT passwords, and SL1 Level 1 logins and passwords, and ensured you cannot ping the TLAN interface of the CS1000 device.
NortelCS Signaling Server
NortelCS VGMC
NortelCS Media Gateway Controller
NortelCS MC32S
By default, this script runs once every hour, at five minutes past the hour. Do not change the default. Devices collect data for the OM Report at the top of each hour. You receive the most recent data if you retrieve the OM Report at five minutes past the hour.
By default, the call quality-related NortelCS Knowledge Scripts run once every hour, at ten minutes past the hour. Under most circumstances, you do not need to change the default schedule. Devices collect data for the Operational Measurement (OM) report at the top of each hour. The GetOMReport Knowledge Script retrieves the OM Report at five minutes past the hour. And you have to run GetOMReport before you can run the CallQuality scripts.
You probably run multiple instances of each script in order to collect the data you need. Running several virtually identical jobs at the same time could put a heavy strain on CPU usage.
If you want to run multiple instances of any NortelCS script, you should offset the schedules just a bit, one or two minutes, so you are not running all of the jobs at the same time.
Keep in mind the following:
OM Reports are retrieved by the GetOMReport Knowledge Script
OM Reports are collected hourly, at five minutes past the hour (by default)
OM Reports are requested from Signaling Servers, VGMCs, MC32Ss, and MGCs by using SNMP, but are transferred by using FTP
OM Reports generally grow to as large as 200K
Multiple FTP sessions can interfere with SNMP requests for other OM Reports, thereby making the OM Reports unavailable
To alleviate FTP contention or to reduce bandwidth requirements, consider creating multiple GetOMReport jobs. Stagger the times by using the Schedule tab to change the Starting at time in the Frequency panel.
NOTE:Do not set the Starting at time for later than 12:58:00. You do not want to miss the creation of the OM Report, which happens on the hour.
Set the following parameters as needed:
|
Parameter |
How to Set It |
|---|---|
|
Event Notification |
|
|
Raise event if NortelCS_GetOMReport fails? |
Select Yes to raise an event when this Knowledge Script fails to retrieve the latest OM Report. The default is Yes. |
|
Event severity if NortelCS_GetOMReport fails |
Set the severity level, between 1 and 40, to indicate the importance of an event raised when the GetOMReport job fails. The default is 15. |
|
FTP timeout |
Specify the number of seconds to allow for the transfer of the OM Report before the job times out. The default is 60 seconds. |
The AppManager for Avaya CS1000 module uses a built-in FTP (File Transfer Protocol) server to transfer Operational Measurement (OM) reports. If your FTP requirements do not fall within the category of “special” as defined below, you can use the built-in FTP server as-is. You do not need to complete the procedures in this topic.
If you have special FTP requirements, use the procedures in this topic to configure FTP parameters in AppManager Security Manager before you run the GetOMReport Knowledge Script.
If you do not have special FTP requirements, do not complete the following procedures. “Special” FTP requirements are defined as one or both of the following:
You want to use IIS as the FTP server.
Your proxy agent computer has two or more network interface cards (NICs).
Whether you use the built-in FTP server or the IIS FTP server, configure AppManager Security Manager when your proxy agent computer has two or more NICs (network interface cards). Configure Security Manager in the following instances:
You have a preference as to which NIC is used in the FTP process
One NIC has access to the ELAN and the others do not
NOTE:
If one NIC has access to the ELAN and another has access to the TLAN, ensure the binding order is such that the NIC connected to the ELAN is listed first.
If you use NetIQ Vivinet Diagnostics to diagnose VoIP quality problems in your CS1000 environment, the proxy agent computer must also have TLAN connectivity.
On the Custom tab of Security Manager, complete the following fields:
|
Field |
Description |
|---|---|
|
Label |
NortelCS_FTP_IPAddress |
|
Sub-label |
|
|
Value 1 |
IP address of the FTP server that resides on the proxy agent computer. By identifying this IP address, you tell incoming connections which IP address to use when the computer has more than one NIC. This IP address should have access to the ELAN |
To use IIS as the FTP server, configure the root directory, the login username, and the login password into AppManager Security Manager.
Identify the IIS FTP root directory path in AppManager Security Manager. Ensure the FTP path is write enabled.
On the Custom tab of Security Manager, complete the following fields:
|
Field |
Description |
|---|---|
|
Label |
NortelCS_FTP_Path |
|
Sub-label |
|
|
Value 1 |
Root directory of the FTP server. The FTP server root directory, called “local path” in IIS, must be write enabled. |
|
Value 2 |
File directory path, relative to the root directory, of the folder where OM Report files are to be saved. If this value is not specified, the OM Report files are saved in the root directory path. NOTE:Virtual directory paths for IIS FTP are not supported. |
In AppManager Security Manager, configure the login username and password required for accessing the IIS FTP server.
On the Custom tab of Security Manager, complete the following fields:
|
Field |
Description |
|---|---|
|
Label |
NortelCS_FTP_Login |
|
Sub-label |
|
|
Value 1 |
Login user name required for accessing the IIS FTP server. The user name should have access to the file directory, or root directory if the file directory is not specified. |
|
Value 2 |
Login password associated with the user name you entered in the Value 1 field |
|
Extended application support |
Encrypts the password in Security Manager. You must select this option. |