Troubleshooting Avaya Aura® System Manager 6.2
Troubleshooting Avaya Aura® System Manager 6.2
Troubleshooting Avaya Aura® System Manager 6.2
Manager
Release 6.2
Issue 1.0
March 2012
Copyright
Except where expressly stated otherwise, no use should be made of
materials on this site, the Documentation, Software, or Hardware
provided by Avaya. All content on this site, the documentation and the
Product provided by Avaya including the selection, arrangement and
design of the content is owned either by Avaya or its licensors and is
protected by copyright and other intellectual property laws including the
sui generis rights relating to the protection of databases. You may not
modify, copy, reproduce, republish, upload, post, transmit or distribute
in any way any content, in whole or in part, including any code and
software unless expressly authorized by Avaya. Unauthorized
reproduction, transmission, dissemination, storage, and or use without
the express written consent of Avaya can be a criminal, as well as a
civil offense under the applicable law.
Third-party components
Certain software programs or portions thereof included in the Product
may contain software distributed under third party agreements (Third
Party Components), which may contain terms that expand or limit
rights to use certain portions of the Product (Third Party Terms).
Information regarding distributed Linux OS source code (for those
Products that have distributed the Linux OS source code), and
identifying the copyright holders of the Third Party Components and the
Third Party Terms that apply to them is available on the Avaya Support
Web site: http://support.avaya.com/Copyright.
Preventing Toll Fraud
March 2012
Contents
Chapter 1: Overview........................................................................................................... 5
Chapter 2: Launching errors.............................................................................................. 7
System Manager Web console fails to open............................................................................................. 7
Proposed solution..................................................................................................................................... 7
Chapter 3: Alarm errors...................................................................................................... 9
Alarms fail to reach ADC through SAL Gateway...................................................................................... 9
Proposed solution..................................................................................................................................... 9
System Manager generates hundreds of alarms...................................................................................... 10
Proposed Solution..................................................................................................................................... 10
Chapter 4: System Platform errors.................................................................................... 13
System Platform fails to detect the short hostname prior to template install............................................ 13
Proposed Solution..................................................................................................................................... 13
Chapter 5: Certification errors........................................................................................... 15
System Manager does not support third-party certificates........................................................................ 15
Proposed solution..................................................................................................................................... 15
Chapter 6: Bulk import and export errors......................................................................... 17
Import utility fails to import the users of specific time zone....................................................................... 17
Proposed solution..................................................................................................................................... 17
Chapter 7: Miscellaneous errors....................................................................................... 19
Authentication of the LDAP user to System Manager fails....................................................................... 19
Proposed solution..................................................................................................................................... 19
Chapter 8: Element Manager errors.................................................................................. 21
Removed Communication Manager reappears on the System Manager Web Console........................... 21
Proposed Solution..................................................................................................................................... 21
Deletion of Communication Manager from RTS fails................................................................................ 22
Proposed solution..................................................................................................................................... 23
Index..................................................................................................................................... 25
March 2012
March 2012
Chapter 1: Overview
The section provides detailed information to help you resolve issues with Avaya Aura System Manager.
The troubleshooting section is intended for those who use System Manager to maintain, manage, and
service Avaya applications and systems.
Some of the Avaya adopting products that System Manager currently supports:
Avaya Aura Session Manager
Avaya Aura Presence Services
Avaya Aura Communication Manager
Avaya B5800 Branch Gateway
Avaya Aura Call Center Elite
Avaya Aura Contact Center
CS 1000
March 2012
Overview
March 2012
System Manager Web console fails to open and does not display
any error.
If you log in to the System Manager from the Web console when the
CND service is not running, the log-in page fails to open and displays
an error message.
Proposed solution
Procedure
1. To start the CND service, enter service cnd start.
2. To start the jboss service, enter service jboss start.
Tip:
If you run the init 6 command, the system starts all services including CND.
March 2012
Launching errors
March 2012
Related topics:
Proposed solution on page 9
Proposed solution
Procedure
1. Through the command prompt interface (CLI), log on to the Console Domain (Cdom) of System Platform.
2. At the command prompt, enter the following commands:
cd /opt/avaya/SAL/gateway/upgradeScripts
/upgradeSALModels.sh
The system populates the latest models. SAL Gateway automatically reflects the
Solution Element Identifiers (SEID) attached to the latest model.
3. Configure System Manager as managed element for SAL Gateway.
Alarms start flowing to ADC from System Manager.
March 2012
Alarm errors
The sys_ConfRefreshConfig job fails with the following errors in the jboss
server.log:
- A scheduled job failed to execute. Please see logs for more details.
- Illegal Argument Exception: Lookup is incorrect. Reason :
javax.naming.NameNotFoundException: conferencing-ear-6.0.0.0.267 not
bound
Cause of the
issue
.
- Mismatch of version in the conferencing-ear file
- If any SSL negotiation error occurs, the system logs any further database
queries in the postgres log files that causes the current issue.
- If the system is a 6.0.x upgraded setup, mismatch of JNDI name between
the scheduler and Conferencing.
Related topics:
Proposed Solution on page 10
Proposed Solution
If you do not have the Conferencing solution deployed in your environment, disable the job to
stop the logs or alarms.
Procedure
1. Log on to the System Manager Web Console as a user that has privileges to make
changes on the Scheduler Web page. For example, admin.
2. Click Monitoring > Scheduler.
3. Click Pending Jobs and look for sys_ConfRefreshConfig.
The system schedules the sys_ConfRefreshConfig job to run once per minute. If
you do not find this job in the list of pending jobs, it means the job is disabled.
4. Check the status of the sys_ConfRefreshConfig job in the Job Status column. If
the status is enabled, select the job and click More Actions > Disable.
10
March 2012
Proposed Solution
Verify that the value of the count is less. The completed jobs displays the list of
all jobs that includes ConfRefreshConfig. If the ConfRefreshConfig job is in
disabled state, enable the job and allow the job to run twice.
The system stops the generation of alarms related to ConfRefreshConfig.
Related topics:
System Manager generates hundreds of alarms on page 10
March 2012
11
Alarm errors
12
March 2012
In System Manager 6.1, you must enter only the FQDN as the hostname.
However, you can still enter the short name in the hostname field. After
you install the System Manager template using the System Platform Web
Console, System Manager runs a post install script for validation. The
script delays by 30 minutes or fails to recognize the shortname for the
Hostname field. As a result, the template installation rolls back.
Related topics:
Proposed Solution on page 13
Proposed Solution
Procedure
1. Open the SystemManager.ovf file from the build location.
2. To detect the short hostnames prior to the System Manager template installation,
add an XML attribute to the OVF templates in System Platform for template fields
similar to the following:
<ovf:Property ovf:key="smgr.hostname" ovf:type="string"
ovf:qualifiers="MinLen(1)"
ovf:def-value="" ovf:userConfigurable="true"
ovf:requirefqdn="true" or ovf:requireip="true" or generic
attribute=---- >
<ovf:Description>Hostname: System Manager FQDN</ovf:Description>
</ovf:Property>
System Platform detects the use of shortnames in the fields before the System
Manager post install script validates.
March 2012
13
3. In the SystemManager.ovf file, change the checksum, sha1sum and update the
sha1sum_report.txt file in the build location.
System Manager captures the new parameters and uses them in the post install
script for validation.
14
March 2012
Proposed solution
Before you begin
Obtain the certificate that has the System Manager hostname as CN, and signed by the
third-party Certificate Authority (CA).
If required, store the third-party certificate and subordinate CA certificates in a PKCS#12
container with the corresponding private key.
Procedure
1. Replace the System Manager Web server certificate with a third-party certificate.
2. Update the trust stores for internal services, clients, or managed elements with thirdparty root and subordinate CA certificate.
For more information, see Application notes for supporting third-party certificate in
Avaya Aura System Manager 6.1 on the Avaya Support Site at http://
support.avaya.com.
March 2012
15
Certification errors
16
March 2012
Using the import utility, when you import the users with the (+01:00)
Amsterdam, Berlin, Rome, Belgrade, Prague, Brussels, Sarajevo time
zone, the system fails to import the user data.
Cause of the issue Bulk import feature does not take the timezone string that the User
Management page displays. Also, the bulk import feature expects the
timezone offset information to be present for the timezone attribute in
import XML file.
Related topics:
Proposed solution on page 17
Proposed solution
The system does not display the timezone information of the user that you import on the User
View profile page. Therefore, for each imported user, you must manually update the timezone
information.
Procedure
To successfully import the users, perform one of the following procedures:
Click Users > User Management > Manage Users and perform the following:
i. Select the user and click View.
March 2012
17
ii. On the User Profile View page, ensure that the timezone offset
information in the Time Zone field. For example, (+01:00) Amsterdam,
Berlin, Rome, Belgrade, Prague, Brussels, Sarajevo.
For each user, in the import XML file, remove the timeZone attribute tag. For
example, remove:
<timeZone>(+01:00) Amsterdam, Berlin, Rome, Belgrade, Prague, Brussels,
Sarajevo</timeZone>
18
March 2012
Related topics:
Proposed solution on page 19
Proposed solution
Using the Subject Mapping table, you can map an LDAP user to a System Manager user.
Therefore, System Manager authenticates the LDAP username without @domain and then
maps to the correct user in System Manager.
Procedure
1. To map the users in the User Management and the LDAP, enter the user name in
the CSSecurityIdentity table.
2. To populate the CSSecurityIdentity table, use the bulk import functionality as
shown in the sample XML file.
<?xml version="1.0" encoding="UTF-8"?>
<delta:deltaUserList xmlns:delta="http://xml.avaya.com/schema/
deltaImport" xmlns:tns="http://xml.avaya.com/schema/import"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xml.avaya.com/schema/deltaImport
userdeltaimport.xsd ">
<delta:userDelta>
<loginName>[email protected]</loginName>
March 2012
19
Miscellaneous errors
<securityIdentity>
<identity>janedoe</identity>
<realm>admin</realm>
<type>principalname</type>
</securityIdentity>
</delta:userDelta>
</delta:deltaUserList>
20
March 2012
Related topics:
Proposed Solution on page 21
Proposed Solution
Assume the IPTCM database has two entries of Communication Manager systems with
rtsappids 50 and 100. Use this procedure to remove the Communication Manager system with
the rtsappid 100 and reinstate the entry of the legitimate Communication Manager with rtsappid
50.
March 2012
21
Procedure
1. To set the rtsappid to null and the name to any arbitrary value for Communication
Manager that has rtsappid 100, run the following query:
update ipt_cm set cmname='ABC',rtsappid= null where id = 100;
2. To modify the IP addresses in the ipt_cm_conn table, run the following query:
update ipt_cm_conn set ipaddress1='1.1.1.1' , ipaddress2='1.1.1.1' where
id = 100;
3. To run the maintenance job for Communication Manager, on the System Manager
Web Console, click Services > Scheduler > Pending Jobs.
The system removes the entry cm_id=100 from the tables ipt_cm and
ipt_cm_conn.
4. To add the entry of the Communication Manager system again, from Runtime
Topology System (RTS), provide the IP address and the name of the legitimate
Communication Manager system.
Note:
If the details you enter does not match with the legitimate Communication
Manager, the system adds a new entry for the Communication Manager in the
ipt_cm table.
5. To retrieve the ID of Communication Manager that you entered in step 4, from the
rts_applicationsystem table, run the following query:
select id,name from rts_applicationsystem;
Cause of the issue When you attempt to delete Communication Manager from RTS, the
system checks for the resource name UDP Group instead of
UDP_Group. If the system fails to find UDP_Group, Communication
Manager does not get deleted from RTS.
22
March 2012
Proposed solution
Related topics:
Proposed solution on page 23
Proposed solution
Procedure
1. On the System Manager Web Console, click Elements > Inventory.
2. In the left navigation pane, click Manage Elements.
3. To delete Communication Manager from RTS that is part of a UDP group:
a) Select the check box for the Communication Manager system that has the Type
field set to UDP_Group.
You set the Type field to UDP_Group from Users > Groups & Roles on the
Group management page.
b) Click Delete.
Note:
Do not search for the GLS Group UDP Group.
March 2012
23
24
March 2012
Index
A
C
Communication Manager ......................................21, 22
reappears after its removal from as managed
element ..............................................21, 22
R
Removed Communication Manager .....................21, 22
reappears on the System Manager Web Console ...
21,
22
F
fails to detect the short hostname ..............................13
H
hundreds of alarms generated ...................................10
T
I
troubleshooting .............................................................5
March 2012
25