EMC SolutionPack for Cisco VoIP Summary Sheet – Service Assurance Suite 9.4

Table of Contents

Overview

Learn how to install and configure the SolutionPack for Cisco VoIP. This SolutionPack reports on voice quality, availability and VoIP performance and provides status and metrics for service level measurement.

The SolutionPack enables administrators to identify and resolve issues and avoid the risk of VoIP service degradation or outages. Additionally the SolutionPack:
  • Measures voice quality-establishes voice quality trends over time and helps troubleshoot VoIP calls for failures and quality deterioration.
  • Helps optimize resources-identifies usage, reduces or increases capacity.
  • Delivers real-time insight-views performance at a glance or in-depth.
Before beginning your installation, review these sections for pre-requisite information:
Back to Top

Support

Review the prerequisite support information before installing the SolutionPack.

This SolutionPack is supported on Watch4net version 6.3 and above. The following devices are supported:

Back to Top

License management

You can evaluate features in the SolutionPack Center using 30-day temporary licenses included with EMC M&R software. If you install or plan to use the SolutionPack for longer than 30 days, contact EMC Online Support for permanent license files.

If you have an existing permanent license or a temporary license that requires updating, use the license upload feature in EMC M&R Centralized Management. Both permanent and temporary licenses are distributed in .zip files.

The EMC M&R license name is either EMC M&R SolutionPack for Cisco VoIP CUCM or ReportPack for Cisco VoiP. The system will use either license.

Back to Top

Setting up Cisco CDRs

Complete this procedure to configure your Cisco Call Manager device to save CDR/CMR data so that EMC M&R can generate your SolutionPack reports.

Before you begin

You need administrator access to Cisco Unified Communications Manager and Cisco Unified Serviceability.

Procedure

  1. Log on to your Cisco Unified Communications Manager Administration page with Administrative privileges.
  2. From the drop-down menu on the top of the window, select Cisco Unified Serviceability, and then click Go .
  3. On the Service Parameter page, go to Tools > CDR Management.
  4. Click Add new, and provide the FTP details.
    For example,
               FTP Host/Destination (VM host IP) : 10.9.13.175
               User (VM host user) : root
               Password (VM host password): dangerous
               Protocol : SFTP
               Directory on ftp server(CUCMs will dump CDR/CMR data in this directory): /root/w4n/cisco-voip/cdr
               Resend on Failure : TRUE
               
               For unix Directory Path would be like /root/w4n/cisco-voip/cdr/
               For windows Directory Path would be like /cygdrive/c/w4n/cisco-voip/cdr/
              (Note: CUCM does not understand C:\ so you need to provide cygwin path for windows.)
     
  5. Make sure you activate the service for Cisco CDR located at Tools > Control Centre Network Services.
Back to Top

Performing additional prerequisite configuration

Before installing your SolutionPack perform these additional tasks on your Cisco call managers and gateways that require polling.

Procedure

  1. Enable SNMP on all call managers and gateways that require polling.
  2. Note Image
    Refer to the following Cisco website for information on this step as well as step 3: http://www.cisco.com/en/US/docs/voice_ip_comm/cucm/devguide/9_1_1/axl.html#wp1054628

    Enable AXL for the call managers that require polling.
  3. Obtain the CUCM DB schema version to be used with AXL requests.
  4. Enable CDRs to send data to the billing server which can be the same server as Watch4net.
    Make sure the user 'apg' has the correct CDR permissions so that it can access the CDR repository on the billing server.
Back to Top

Installation

Review this information before beginning the installation.

  • Make sure you review and perform the prerequisites outlined in the first chapter.
  • Perform the installation with administrative privileges on the EMC M&R User Interface.
Back to Top

Logging in to Centralized Management

Log in to Centralized Management to perform operations that affect all servers.

Procedure

  1. Point your browser to the URL.
    For example, http://<Frontend-hostname>:58080/centralized-management
  2. Log in.
    1. Type the login credentials.
      The default username is admin and the default password is changeme.
    2. Click Sign In.

After you finish

Note Image
You are automatically logged off after four hours.

Back to Top

Installing the SolutionPack

After you log in as an administrator, you can install this SolutionPack from Centralized Management.

Before you begin

  • Core modules must be up-to-date in all servers because not all module dependencies are validated during the SolutionPack installation or update process.

Core modules are modules that are not installed by a SolutionPack. Examples of core modules include webapps, module-manager, license-manager, java, mysql, backend, tools, and so forth. Update these core modules: Databases, Backends, Frontends, Miscellaneous (except Blocks). The recommended module update order varies. Refer to the EMC Watch4net Installation and Configuration Guide for information on module update order for multiple hosts or single host deployments.

Procedure

  1. Log in and select Administration.
  2. Select Centralized Management in the Administration tree.
  3. Select SolutionPacks in the tree.
  4. Select SolutionPack Center.
  5. Select the Cisco VoIP SolutionPack on the Browse and Install SolutionPacks screen.
  6. Read the summary information and click Install.
  7. Select the components to install.
    1. Type the instance name.
    2. Select the server in one or more list boxes. For example, select the server in the Collector, and Reports list boxes.
    3. Click Next.
  8. For each list box you select, a screen appears.
    1. Click Next after you complete each screen.
    2. Click Install after you complete the last screen.
    The installation process begins.
  9. Select the maximize arrow next to each component to view the installation process.
    When the installation successfully completes, green checkmarks appear.
  10. After installation is complete, verify the SolutionPack version number along with SolutionPackBlock information. Select Centralized Management > SolutionPacks > Cisco VoIP.
Back to Top

Creating CDR database schema

After installation you must manually create the schema for the CDR database.

Procedure

  1. Verfiy that datastore service started. If not start it: <APG>/bin/manage-modules.sh service status datastore Default.
  2. Copy the content of voip-setup-db.ddl under [APG]/Event-processing/APG-Datastore-Writer/[instance_name]/ddl.
  3. Execute the script datastore-client.sh or (cmd for Windows) under [APG]/bin/ and paste the content of the ddl file at the prompt line.
  4. Restart the event-processing-manager.
Back to Top

Editing Tomcat files

After editing the schema for the CDR database, edit these Tomcat files and configure the connection to the CDR database.

Procedure

  1. Edit following tomcat file: [APG]/Web-Servers/Tomcat/[instance_name]/conf/server.xml. Add the following definition to the section where the connections to the DBs are defined. Add it above the following line Defines the connection to the Events Archive database for APG Datastore.

    <Resource name="jdbc/FLOW-TF-VOIP" auth="Container" type="javax.sql.DataSource" maxActive="10"
                                    maxIdle="10" validationQuery="SELECT 1" testOnBorrow="false" testWhileIdle="true"
                                    timeBetweenEvictionRunsMillis="10000" minEvictableIdleTimeMillis="60000" maxWait="10000"
                                    username="admin" password="changeme" driverClassName="com.watch4net.x100.jdbc.Driver"
                                    removeAbandoned="true" removeAbandonedTimeout="60" logAbandoned="true"
                                    url="jdbc:x100://localhost:48443/Databases/APG-Datastore" />
    
    
  2. Edit [APG]/Web-Servers/Tomcat/[instance_name]/conf/Catalina/localhost/APG.xml. Add the following definition to the section where the connections to the DBs are defined. Add the definition above the <!-- emc prosphere --> line: <ResourceLink name="jdbc/FLOW-TF-VOIP:{ mapping=FLOW-CISCO-CDR.xml, table= CISCO_VOIP_CUCM_CDR}" global="jdbc/FLOW-TF-VOIP" type="javax.sql.DataSource" />
  3. Restart the Tomcat service.
Back to Top

Configuring the user process limits for a Linux installation

Increase the user process limits for the user account to a maximum of 65534. This modification enables services to open 65534 files and 65534 processes when needed.

Before you begin

Procedure

  1. Open the /etc/security/limits.conf file.
  2. Add the following lines for the user.
    In this example, the user is apg.
    apg   hard  nofile  65534
    apg   soft  nofile  65534
    apg   hard  nproc   65534
    apg   soft  nproc   65534
    
  3. Save the file.
  4. To restart the services, type the following commands from the bin directory of the installation:
    ./manage-modules.sh service stop all
    ./manage-modules.sh service start all
  5. To verify the changes, type su apg -c 'ulimit -n -u'
Back to Top

Uninstalling a SolutionPack

If you no longer want to view the reports of a certain SolutionPack, you can uninstall that SolutionPack from the server.

Procedure

  1. Log in with administrator credentials for EMC M&R platform and select Administration.
  2. Select Centralized Management in the Administration tree.
  3. Select SolutionPacks in the tree.
  4. Select the SolutionPack that you want to uninstall in the Installed SolutionPacks screen.
  5. In the Properties area, click Trashcan icon for each instance of the SolutionPackBlock and click Remove.
Back to Top

Viewing SolutionPack reports

You can view your reports from the EMC M&R console.

Before you begin

After installing the SolutionPack, access the EMC M&R User Interface.

Procedure

  1. Point your web browser to http://[serverIP:port]/APG.
    An example default URL is http://localhost:58080/APG.
  2. On the login screen, enter your EMC M&R username and password, and click Sign In.
  3. View SolutionPack reports by expanding Report Library > Your SolutionPack Name.
Back to Top

Reports

This reports table includes the "out-of -the box" reports available with this SolutionPack.

You can drill-down on some top-level reports to view sub-level reports with specific metrics related to the objects in the top-level report.

Back to Top

Metrics

Report metrics are used to create SolutionPack reports. Metrics are used to gather information for monitoring or reporting on your Cisco devices.

Back to Top

SSL certificates

Generally, EMC products are distributed with a self-signed SSL certificate. If you receive an SSL certificate error or a blank pane when you are attempting to access content served by a data source, resolve the issue by doing one of the following procedures.

SSL certificate error examples provides a list of sample errors.

Temporary resolution

Accept the certificate exception temporarily: Troubleshooting an SSL certificate error: Accepting the exception.

Permanent resolution

Add an SSL certificate to your truststore to permanently prevent the exceptions from appearing.

You can: Perform:
Install the self-signed SSL certificate that is provided with the EMC product using an Internet Explorer browser. Installing a self-signed SSL certificate from an Internet Explorer browser
Install the self-signed SSL certificate that is provided with the EMC product using a Chrome or Firefox browser.
  1. Export the self-signed SSL certificate to save it to the export location: Exporting an SSL certificate from an Internet Explorer browser
  2. Importing an SSL certificate into your truststore
Import an exported SSL certificate that you or another administrator prepared. Importing an SSL certificate into your truststore

If you need to prepare an SSL certificate to share with other users, use: Exporting an SSL certificate from an Internet Explorer browser.

Back to Top

SSL certificate error examples

The SSL certificate error or a blank pane appears because the certificate is self-signed and it is not added as an exception or into the truststore yet. For example, if you are attempting to access content served by a data source, a blank pane appears when you select views under SolutionPacks.

Chrome error examples

This site's security certificate is not trusted!

Or, a blank pane.

Firefox error example

This Connection is Untrusted

Internet Explorer error examples

There is a problem with this website's security certificate.
Content was blocked because it was not signed by a valid security certificate.

Back to Top

Troubleshooting an SSL certificate error: Accepting the exception

An SSL certificate error appears in your browser.

To resolve this issue,

Procedure

Accept the exception.
Steps may vary for your browser. For example, for Internet Explorer, click Continue to this website (not recommended).
This temporary solution causes the exception to be ignored for the current browser session, but the exception reappears if you open another browser tab or window.
Back to Top

Installing a self-signed SSL certificate from an Internet Explorer browser

Install the self-signed SSL certificate that is provided with the EMC product to prevent certificate exception errors.

The following procedure is for Internet Explorer version 9.0. The steps may vary slightly depending on your browser version.

Procedure

  1. Click Continue to this website (not recommended) in the browser window.
  2. Click the red Certificate Error indicator next to the address bar.
  3. In the Untrusted Certificate window, select View certificates.
  4. In the Certificate dialog box, in the General tab, click Install Certificate.
  5. Follow the instructions in the Certificate Import Wizard.
    1. Select the Place all certificates in the following store setting to add the certificate to your truststore.
  6. In the Certificate dialog box, in the General tab, click OK.

After you finish

Refresh the browser window.

Back to Top

Importing an SSL certificate into your truststore

Import an SSL certificate into your truststore to prevent certificate exception errors.

Procedure

Back to Top

Importing an SSL certificate in Chrome

For Chrome, use this procedure to import the certificate into your truststore.

The following procedure is for Chrome version 28.0.1500.95. The steps may vary slightly depending on your browser version.

Procedure

  1. Go to Settings > Show advanced settings.
  2. Scroll down and select HTTP/SSL > Manage Certificates.
  3. In the Trusted Root Certification Authorities tab, click Import.
  4. Follow the instructions in the Certificate Import Wizard to import the certificate.
  5. Click OK in Internet options.
  6. Refresh the browser window.
Back to Top

Importing an SSL certificate in Firefox

For Firefox, use this procedure to import the certificate into your truststore.

The following procedure is for Firefox version 23.0. The steps may vary slightly depending on your browser version.

Procedure

  1. Go to Firefox > Options > Options.
  2. Click Advanced.
  3. In the Certificates tab, click View Certificates.
  4. Click Import.
  5. Locate the certificate file and click Open.
  6. Click Save.
  7. Click OK in Certificate Manager.
  8. Refresh the browser window.
Back to Top

Importing an SSL certificate in Internet Explorer

For Internet Explorer, use this procedure to import the certificate into your truststore.

The following procedure is for Internet Explorer version 9.0. The steps may vary slightly depending on your browser version.

Procedure

  1. Go to Tools > Internet options.
  2. In the Content tab, click Certificates.
  3. Select the Trusted Root Certification Authorities tab.
  4. Click Import.
  5. Follow the instructions in the Certificate Import Wizard to import the certificate.
  6. Click OK in Internet options.
  7. Refresh the browser window.
Back to Top

Exporting an SSL certificate from an Internet Explorer browser

Use this procedure to export a self-signed SSL certificate, so that you can either import the resulting exported certificate into your truststore or share it with other users.

The following procedure is for Internet Explorer version 10.0. The steps may vary slightly depending on your browser version.

Procedure

  1. Access the host for which you want to export the SSL certificate from the browser.
    For example: https://<myHostname>.emc.com
  2. Select Continue to this website (not recommended) in the There is a problem with this website's security certificate window.
  3. Click the red Certificate Error indicator next to the address bar.
  4. In the Untrusted Certificate window, select View certificates.
  5. In the Certificate dialog box, select the Details tab and ensure that the Show field is set to All. Click Copy to File.
  6. In the Certificate Export Wizard,
    1. Click Next in the Welcome screen.
    2. Click Next to accept the default DER encoded binary X.509 setting in the Export File Format screen.
    3. Browse to the location where you want to save the certificate.
    4. Specify the certificate file name and click Save.
    5. In the File name field, ensure that the location and the certificate file name are correct. Click Next.
    6. Click Finish.
    7. Click OK when The export was successful appears.
  7. In the Certificate dialog box, click OK in the Details tab.
  8. Share the resulting exported SSL certificate with other users to use.
Back to Top

Contacting EMC Support

EMC support, product, and licensing information can be obtained through EMC online support.

Procedure

Back to Top