SolutionPack for Acme Packet SBC Summary Sheet – Service Assurance Suite 9.4

Table of Contents

Overview

Learn how to install and configure the SolutionPack for Acme Packet SBC. You can monitor and report on Acme Packet devices for performance and utilization information as well as view the inventory of all devices and session metrics.

Use these guidelines in the following sections to prepare your environment for installation of the SolutionPack for Acme Packet SBC.

Back to Top

Support

This table lists the prerequisite support for this SolutionPack.

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 for Acme Packet SBC or ReportPack for Acme Packet SBC. If either license is present, the system will use it.

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 Acme 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 > Acme VoIP.
Back to Top

Adding devices for monitoring

After installation, you must manually add devices for monitoring.

Before you begin

Procedure

  1. Create the collector. In the EMC M&R console, navigate to Device discovery > Collectors > Add New Collector.
  2. Add a device for collection. Navigate to Device discovery > Devices > Add New Device.
    1. In Main Parameters, enter the name of the device and IP address.
    2. Configure SNMP Credentials by adding a collector that was previously created.
    3. Select appropriate Acme Capabilities.
    Repeat this procedure until all desired devices are added.
  3. Distribute device(s). Navigate to Device discovery > Dashboard, and then click on Distribute all approved devices with Capabilities on all enabled collectors.
Back to Top

Log files

Information on the log files for this SolutionPack follows.

This SolutionPack does not have Acme Packet SBC-specific log files. Logging for the SolutionPack is part of the Generic SNMP collector:<APG_install>/Collecting/Collector-Manager/Generic-SNMP/logs.

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 EMC M&R platform installed on a server running Red Hat Enterprise Linux 6, CentOS Linux 6.
  • 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
    After restarting, check the status of services, enter: ./manage-modules.sh service status all
  5. Type the following command to verify the changes:
    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

SolutionPack for Acme Packet SBC Reports

A list of "out-of -the box" reports available with this SolutionPack appears in the table that follows.

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

Back to Top

Report metrics

The SolutionPack software uses report metrics to gather information from your ACME Packet SBC devices for monitoring and report creation.

This table lists metrics for the SolutionPack.

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