Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Info

This section makes frequent use of data contained in the Technical Requirements.

All relevant sections of the Technical Requirements Data collection should be completed or known before commencing with the steps in this section.

...


There are two parts to the configuration, the first being the server(s) under management, and the second being the supporting configuration on the web portal.

Both are covered in this chapter.

Table of Contents

ACM Configuration

Adding a new ACM Login

...

Browse to the Avaya Communication Manager and log in. Click on Security > Administrator Accounts and select Add Login and Privileged Administrator and click submit:
Image ModifiedACM Administer Accounts

 
Enter details as per the table below:Image Removed

FieldsSetting

...

Login name

...

FieldsSetting

Login name

Choose a Login name Choose a Login name (refer to technical requirements forms)

Additional groups (Profile)

prof18

SAT Limit

none

Date to disable account

Leave blank

Password

Choose a password (refer to technical requirements forms)

Force password change

No


Image Added



Click Submit.


Image Modified

ACM Add Login Success


Once this account has been created, test it has the correct privileges by logging on an SAT onto the ACM SAT and Linux CLI and running the following non-destructive commands:

ACM ApplicationSAT:

Code Block
languagetext
$ display system-parameters customer-options
$ list registered-ip-stations
$ list measurements occupancy summary
$ status ip-network-region
$ monitor security-violations station-security-codes
$ display alarms
$ test port


ACM server Linux Bash commandsCLI:

Code Block
languagetext
$ server
$ cat /etc/opt/ecs/ecs.conf
$ pingall –s 1
$ ifconfig –a

...

Adding a new Media Gateway Login

The VSM Probe collector requires access to the Media Gateways.

...

  1. Logon as 'root'
  2. Run the command:

    Code Block
    languagetext
    $ Username {choose a username} password {choose a password} access-type admin


  3. You will then be prompted to enter a password for your new user account.
  4. Once complete test you can login to Test you can login to the Gateway with the new credentials.

...

SNMP traps are used to capture alarms raised by Avaya Communication Manager, SNMP Access is used by VSM to query certain information from the Avaya Communication Manager.

ACM SNMP Access

The VSM Probe Server collector must be allowed to query the Avaya Communication Manager via SNMP.
Click on SNMP > Access. Click on 'Add/Change'.
Image Modified

SNMP Access Add/Change


Enter the details in the SNMP Version 2c or 3 option and click the Submit button:
Image Modified


ACM SNMP Access Field Description

FieldSettings

IP Address

IP address of the VSM Probecollector

Access

Read-Only

Community Name/User Name (v3)

Choose an SNMP User Name or Community Name (refer to technical requirements forms)

Authentication Protocol (v3)

Choose an Authentication Protocol

Authentication Password (v3)

Choose an Authentication Password (refer to technical requirements)

Privacy Protocol (v3)

Choose a Privacy Protocol

Privacy Password (v3)

Choose a Privacy Password (refer to technical requirements forms)

SNMP Traps

The VSM Probe Server collector must be added as a destination for SNMP traps. For this reason, the VSM Probe Server collector must be assigned a fixed IP address.

Click on SNMP > FP Traps. Enter the details in the SNMP Version 2c or 3 option and click the Submit button:
Image ModifiedACM SNMP Add IP Address



ACM SNMP Trap Field Description

Fields

Setting

IP address

IP address of the VSM Probecollector

Notification

trap

User (v3)/Community Name

Choose an SNMP User Name or Community Name (refer to technical requirements forms)

Authentication Protocol (v3)

SHA

Authentication Password (v3)

Choose an Authentication Password (refer to technical requirements)

Privacy Protocol (v3)

DES

Privacy Password (v3)

Choose a Privacy Password (refer to technical requirements forms)

Engine ID (v3)

Not required


After adding the SNMP destination it should be listed on the FP Traps page:
Image Modified

...


Next the ACM application also needs to be configured to send INADS alarm information to VSM via SNMP. This is done via the shell command "almsnmpconf".

...

Code Block
languagetext
$ almsnmpconf -d {VSM Probecollector IP ADDRESS} -c public

Where:

{VSM Probe IP ADDRESS} is the IP address of the VSM probe server (i.e. not the IP address of the physical server).collector.


Note
Note: 'Public' is used as an example and is not recommended for production systems


Check that the INAD SNMP alarms are enabled by executing the following command:

...

To complete the SNMP configuration in Avaya Communication Manager, the VSM probe server must be added to the IP Node names table as shown below and then that Name used in the IP Options page.

This configuration allows VSM to request information via SNMP query:
Image ModifiedACM SNMP Node-names IP


ACM SNMP Node-names IP Field Description

Anchor
NodeNames
NodeNames

FieldsSettings

Name

VSM Probe collector IP node-name (refer to technical requirements forms)

IP addressIP Address (V4) (refer to technical requirements forms)

VSM collector IP Address 


Submit the form.


Anchor
IP-Options
IP-Options

Image Modified

ACM SNMP System-Paramters IP-Options


Note

If the Download flag is set to yes as shown above then these settings will be downloaded to the phone and will overwrite any 46xxxSettings.txt file settings.

...

FieldsSettings

Download Flag?

Y

Community String

SNMP Community Name (refer to technical requirements forms) or publicto query phones (Note: 'Public' is used as an example and is not recommended for production systems)

Source Address

VSM Probe collector IP node-name (refer to technical requirements forms)

...

For SIP Stations, you will need to administer this within the 46xxSettings.txt files as follows and/or via Session Manager Device Settings Groups (Refer to Technical Requirements forms):

In the SNMP section edit and uncomment the following settings. Add text as per below:

Code Block
languagetext
linenumberstrue
SET SNMPADD {VSM Probecollector IP Address (V4)}
SET SNMPSTRING {ACM SNMP Community Nameto orquery publicphones}


ACM Firewall

Ensure the Avaya Communication Manager firewall is configured to pass SNMP. Click on Security > Firewall:

Image Modified

Note

ACM policy must accept UDP 161 and 162.


Enable Syslog streaming


ACM 8.0 and earlier:

The following changes are required to define the VSM Probe collector as a destination for Avaya Communication Manager Syslog. Click on Security > Server Log Files:
Image Modified


ACM Syslog Prior Field Description prior to ACM 8.1

ACM Syslog Field Description prior to ACM 8.1

FieldsFieldsSettings

When Submit button is clicked…

Checked

Enable logging to the following Syslog server

Selected

Server name

IP address of the VSM ProbeVSM collector IP Address

Selection for which logs are to be sent

All Checked


ACM 8.1 and later:

Image Removed

The following changes are required to define the VSM collector as a destination for Avaya Communication Manager Syslog. Click on Security > Server Log Files:

Image AddedACM Syslog for ACM 8.1 and Later


Administer any available 'Log Server'.

...

FieldConfiguration
EnabledYes
ProtocolUDP
Port514
Server/IPIP address of the VSM ProbeVSM collector IP Address


Once the Once the details have been entered click the Submit button.

...

On page 2, set the 'Log PMS/AD Transactions' field to 'Y':
Image ModifiedImage Modified

 ACM Logging Levels Page 1                                                                                                            ACM Logging Levels Page 2

                                                                                                             

Tip

These changes increase the logging level to add a greater level of Change Manager

Tip

These changes increase the logging level to add a greater level of Change Manager reporting.


ACM Logging Levels Field Description

...

The following changes are required to define the VSM Probe collector as a destination for ACM Backups.

These Backup files will be sent from the VSM Probe collector to the Virsae Cloud.

Click on Data Backup/Restore > Schedule Backup > Add:
Image Modified



ACM Off-site Backups ACM Off-site Backups Field Description

FieldsSetting

Method

sftp (Secure File Transfer Protocol)

User Name

Must match the SFTP Backup settings in the Web Portal Equipment Location

Password

Must match the SFTP Backup settings in the Web Portal Equipment Location

Hostname

VSM Probe collector IP Address (V4)

Directory

/


Click 'Add New Schedule'.

...

The following changes are required to define the VSM Probe collector as a CDR destination.
Use the command 'Change IP-Services' and add the service type for the CDR1 or 2:

Image Modified

ACM IP-Services Page 1



Go to Go to page 3 and check the setting for the CDR you just configured are as shown in the image below:
Image ModifiedACM IP-Services Page 3



ACM IP-Services Field Description

...

Enter the output type as 'Unformatted' and names the output Endpoint CDR1 or CDR2:  
Image Modified


ACM System-parameters CDRACM CDR Field Description

FieldsSetting

Primary/Secondary Output Format (use whichever is spare)

Unformatted

Primary/Secondary Output Format (use whichever is spare)

CDR1 or 2

Disconnect Information in place of FRL

(populates FRL column in Service Desk > Call Details )

'y' if disconnect information is required

'n' if FRL information is required


Submit the form.

Configure RTCP for VQM

The following changes are required to define the VSM Probe as the destination for RTCP (Voice Quality) traffic from the UC environment:
Image Modified


ACM System-parameters IP-Options Field Description

Anchor
ACM System-parameters IP-Options Field Description
Anchor
Table12
Table12

FieldsSetting

Default Server IP Address

VSM Probe collector IP Address (V4)

Default Server Port

5005 – *See Note

Default RTCP Report Period (secs)

5

...

Code Block
languagebash
SET RTCPCONT 	
SET RTCPMON {VSM Probecollector IP Address (V4)}
SET RTCPMONPORT 5005
SET RTCPMONPERIOD 5

...

Warning

After these entries have been put into the settings file you will need to restart SIP endpoints for them to take effect.

Avaya Agent For Desktop RTCP

If you are using Avaya Agent for desktop, the RTCP settings need to be set on each client using the following steps:

...

  1. In the Avaya Agent for Desktop Configuration window, select the Advanced tab.
  2. In the RTCP Monitoring Server Settings section, perform the following actions:
    1. In the Address field, type the IP address of the VSM probecollector.
    2. In the Port field, type the port number of the VSM RTCP receiver.
    3. In the Period field, enter ‘5 seconds’.
  3. Click Save.
Warning

ADDING: Avaya OneX Agent/Communicator

Web Portal Configuration

Add ACM

Log in to the VSM web portal using your credentials and password.

Avaya One-X Communicator RTCP

Avaya One-X Communicator supports sending RTCP packets to VSM. The following settings are required on each instance of One-X Communicator.

Before you begin, please close Avaya One-X Communicator, then:

  1. Open the config.xml file located in C:\Users\<username>\AppData\Roaming\Avaya\Avaya one-X Communicator
  2. Enter the IP Address of the VSM Collector e.g. 192.168.1.200
No Format
<parameter>
<name>RtcpMonitoringIPAddress</name>
<value>192.168.1.200</value>
</parameter>

      3. Enter the port of the RTCP Receiver on the VSM Collector e.g. the default is 5005

No Format
<parameter>
<name>RtcpMonitoringPortNumber</name>
<value>5005</value>
</parameter>

      4. Enter the time period in seconds for sending RTCP packets to the VSM Collector, the default is 5.

No Format
<parameter>
<name>RtcpMonitoringPeriod </name>
<value>5</value>
</parameter>

      5. Save the config.xml file

You can now reopen One-X Communicator.

Web Portal Configuration

Add ACM

Log in to the VSM web portal using your credentials and password.

For your customer, select Service Desk > Equipment Locations.

Right-click on the Equipment Location (ApplianceCollector) that will serve this particular UC Server and select 'Manager Equipment'.

...

A form will open which you can populate with the equipment details using this the table below.

Select the Vendor 'Avaya' and product 'Communication Manager'.

Image ModifiedWeb Portal - Add Equipment


Tip

If you are adding more than one piece of the same equipment type, check the 'Add another' box at the bottom of the form and the bulk of the configuration will be carried over for the next item.


Web Portal – Add ACM Field DescriptionField Description

Anchor
ACMFields
ACMFields

FieldSetting

Vendor

Avaya

Product

Communication Manager

Equipment Name

Friendly name for this ACM

Username

ACM Username (refer to technical requirements forms)Username 

Password

ACM Password (refer to technical requirements forms)Password 

Username for Media Gateways

Media Gateway Username (refer to technical requirements forms)Username 

Password for Media Gateways

Media Gateway Password (refer to technical requirements forms)Password 

IP Address / Host Name

IP Address of server (Virtual in IP of duplicated CMA/CMB servers)

Site

Friendly name for core site (where this server is located)

Monitored IP Network Regions

Up to 10 Intervening IP Network Regions, comma-separated

Disable automatic connection to Media Gateways

Check this to stop VSM accessing enhanced Media Gateway service information

Use the above credentials for all Media Gateways

Unchecking this box allows you to set different credentials for all media gateways


Image Modified

Web Portal - ACM Configure Equipment

SNMP

Complete the Equipment tab and then click on the 'SNMP Query' tab.

Click on the down arrow, and select the SNMP version you wish VSM to use for querying the ACM:

SNMP V1 or V2
Image Modified

...


ACM SNMP V1/V2 Field Descriptions

FieldsSetting

Version

V1, V2

SNMP Community String

Community String as administered on the ACM


SNMP V3

Image ModifiedWeb Portal – ACM SNMP V3 Query



Table 15 – ACM SNMP V3 Field Description

FieldsSetting

Version

V3

Username

SNMP V3 Username (refer to technical requirements forms)Username 

Authentication Protocol

SHA

Authentication PasswordPassword (refer to technical requirements)

Password 

Privacy Protocol

DES

Privacy PasswordPassword (refer to technical requirements forms)

Password 

Under the 'Avaya Phones' section enter the SNMP Community String to be used for querying phones (administered earlier in ‘System-Parameters IP-Options, and the 46xx settings file.

Also administered via Session Manager if applicable) then click the '+' button.

Test Access

Once all fields are populated Click on the 'Test Access' button. This will test that VSM can connect to the ACM using the settings you have entered:
Image Removed 

Web Portal – ACM Test Access

Include Page
EX:Network Connectivity Excerpt
EX:Network Connectivity Excerpt

Include Page
EX:Tagging Excerpt
EX:Tagging Excerpt

Testing Alarm Receipt

In the 'Manage Equipment' page, right-click on the ACM you just added and select 'Generate Test Alarm':
Image Added



The command should execute successfullyBoth SSH and SNMP should return success. If not, troubleshoot the configuration.

  1. The SSH test ensures the VSM probe can connect to, and log in using the account configured.
  2. The SNMP test ensures an SNMP query can be run.

Once testing is successful, click Add.

Testing Alarm Receipt

In the 'Manage Equipment' page, right-click on the ACM you just added and select 'Generate Test Alarm':
Image Removed

Web Portal – Updated Avaya Product List


Image Added


Return to the home page. For the particular customer, select Availability Manager > Manage Alarms.

The Test should show as an alarm. If not, troubleshoot the SNMP Trap configuration.

Tip

This test has ACM generate an SNMP trap and ensures VSM receives the same.

Test Access

Once all fields are populated Click on the 'Test Access' button. This will test that VSM can connect to the ACM using the settings you have entered:
Image Added 


Both SSH and SNMP should return successThe command should execute successfully. If not, troubleshoot the configuration.Image Removed

Return to the home page. For the particular customer, select Availability Manager > Manage Alarms.

The Test should show as an alarm. If not, troubleshoot the SNMP Trap configuration.

...

  1. The SSH test ensures the VSM collector can connect to, and log in using the account configured.
  2. The SNMP test ensures an SNMP query can be run.

Once testing is successful, click Add.

Configure Site Mapping (Optional)

VSM uses the IP Network Region names in Reports and Alarms.

Sometimes the name assigned to the IP Network Region in the ACM configuration is not meaningful to the Business Partner and VSM’s Site Mapping feature allows you to customise this.


Tip

Site Mapping will only be available after VSM has performed its initial data collection on the ACM, therefore it is recommended that this is a ‘day 2’ administration.


Navigate to the customers ‘Manage Equipment’ page, right-click, and select ‘Edit’ on the ACM you wish to add site mapping for.

Image ModifiedWeb Portal – Manage Equipment


On the ‘Edit Equipment’ page, you should see a list of the IPNR’s and IPNR Names as administered in the ACM.

Image Modified

Web Portal - ACM Site Mapping


If you wish to customize the IPNR Name, click the Pen button.

Add your preferred values in the ‘Customized IPNR name’ field for the IPNR, then click on the tick.

Image ModifiedWeb Portal – ACM Customized Site Mapping


After updating all site mappings click ‘Save’.

...