EMC® SolutionPack for Cisco VoIP Summary Sheet

Table of Contents

Back to Top

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.

This article applies to Service Assurance Suite 9.3.

This SolutionPack is one of many provided with Service Assurance Suite.

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 Watch4net 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 Watch4net Centralized Management. Both permanent and temporary licenses are distributed in .zip files.

The Watch4net license name is either Watch4net 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 Watch4net 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 Watch4net 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 the 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

  • Make sure you have a login with root privileges.
  • The core software installed on a server running Red Hat Enterprise Linux 6, CentOS Linux 6, or SUSE Linux Enterprise Server (SLES) 11.
  • The name specified for the user account during the installation.

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. Type the following commands from the bin directory of the installation to restart the services:

    ./manage-modules.sh service stop all ./manage-modules.sh service start all

  5. Type the following command to verify the changes:

    su apg -c 'ulimit -n -u'

Back to Top

Installing a SolutionPack Center Upgrade

Periodically, updates of the SolutionPacks are available in a .zip file called SolutionPackCenter Update on EMC Online Support. This .zip file contains a README file that describes the changes made to each SolutionPack and individual <solution>.pkg files for installing each update.

Before you begin

  • Install the required license file to enable your SolutionPack.
  • Ensure any Domain Managers that supply data to the SolutionPack are installed and configured.
  • Make sure you have a login with root, APG, or system administrator privileges to perform this task. The user apg is the account that the core software application uses instead of root.
  • Update the core modules in all servers before you update or install a SolutionPack after upgrading your base installation.

Core modules are modules that are not installed by a SolutionPackBlock. 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). Since the recommended module update order varies, refer to the Module Update Order section for the multiple hosts or single host deployments. Also, the EMC Watch4net Centralized Management Guide provides more information.

Examples of modules that are installed with SolutionPackBlocks include collector-manager, event-processing-manager, and collector or event components.

Procedure

  1. Locate the Watch4net downloads area on EMC Online Support.
    1. Go to https://support.emc.com.
    2. Click Support by Product.
    3. Type Watch4net in the Find a Product field, and then click the arrow next to it.
    4. Click Downloads.
    The Downloads for Watch4net page appears.
  2. Download the latest SolutionPackCenter Update to a local directory.
    For example: SolutionPackCenter Update <month> <year>
  3. Browse to Administration > Centralized-Management > Packages Management and click > Upload.
  4. Browse to the SolutionPackCenter Update .zip file and click OK.

After you finish

Update the SolutionPackBlocks after installing the SolutionPack update. Browse to Administration > Centralized Management > SolutionPacks > SolutionPack Center and install the SolutionPack.

You can confirm the SolutionPack version number by browsing SolutionPacks in the left panel.

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 core software 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 Watch4net console.

Before you begin

After installing the SolutionPack, access the Watch4net 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 Watch4net 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.

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

  • For documentation, videos, release notes, software updates, or information about EMC products, go to EMC Online Support at https://support.emc.com.
  • For technical support, go to EMC Online Support and click Service Center.
    You must have a valid support agreement to open a service request.
  • Contact your EMC sales representative for details about obtaining a valid support agreement or with questions about your account.