2 Installing Application Management Pack for Oracle Communications

This chapter describes Oracle Application Management Pack for Oracle Communications system requirements, and how to install, deploy, upgrade, and uninstall Application Management Pack for Oracle Communications.

System Requirements

You install Application Management Pack for Oracle Communications as a plug-in on an existing Oracle Enterprise Manager Cloud Control instance. The plug-in is supported on Enterprise Manager Cloud Control versions 13c and 12c.

Enterprise Manager Cloud Control requires an Oracle Enterprise Database.

This guide assumes you have installed and configured the versions of Enterprise Manager Cloud Control and Enterprise Database that are compatible with your release of Application Management Pack for Oracle Communications.

You can find the latest details about system requirements and compatibility on the Certifications tab of My Oracle Support. Search for Application Management Pack for Oracle Communications and Enterprise Manager Base Platform.

See the Enterprise Manager Cloud Control documentation for information about Enterprise Manager Cloud Control system requirements and installation or upgrade procedures.

See the Oracle Enterprise Database documentation for information about installing and configuring Oracle Enterprise Database.

Supported Oracle Communications Applications

Managed application targets must meet the system requirements listed in the application's documentation. For more information, see the Oracle Communications application documentation available on the Oracle Software Delivery Cloud and Oracle Help Center at:

See "Supported Applications, Suites, and Solutions" for a list of supported Oracle Communications applications.

For information about compatible application versions, search for Application Management Pack for Oracle Communications on the Certifications tab of My Oracle Support.

Installing the Application Management Pack for Oracle Communications Plug-in

Install the plug-in using one of the following methods:

You install the same plug-in for all of the licensed management packs.

Installing the Plug-in Using Enterprise Manager Self Update

You install the Application Management Pack for Oracle Communications plug-in using Self Update in the Enterprise Manager Cloud Control administration console.

For information about setting up Self Update, see the chapter about updating Cloud Control in Oracle Enterprise Manager Cloud Control Administrator's Guide.

To install the plug-in using Self Update:

  1. Log in to the Enterprise Manager Cloud Control administration console.
  2. From the Setup menu, select Extensibility , and then Self Update .
  3. Select the Plug-in row and click Open .
  4. Select the row for the Oracle Communications plug-in.
  5. Click Download .

The plug-in becomes deployable after the download completes. See "Deploying the Application Management Pack for Oracle Communications Plug-In" for information about deploying the plug-in.

Installing the Plug-in Using an OPAR File

You can download the Oracle Plug-in Archive (OPAR) version of the plug-in from the Oracle Software Delivery Cloud and install the OPAR using the Enterprise Manager Command-Line Utility (EMCLI).

For information about OPAR files and EMCLI, see the Enterprise Manager Cloud Control documentation.

To install the plug-in using the OPAR file and EMCLI:

  1. Download the Oracle Application Management Pack for Oracle Communications plug-in from the Oracle Software Delivery Cloud: https://edelivery.oracle.com
  2. Copy one of the following files to the Enterprise Manager Cloud Control host:
  3. In a terminal session, navigate to the oms/bin directory of your Enterprise Manager Cloud Control installation.
  4. Configure the EMCLI connection to the Enterprise Manager Cloud Control host using the following command:

emcli setup -url=https://host:port/em -username=sysman -password=password -trustall
emcli import_update -file=filepath/12.1.0.4.0_oracle.cgbu.ocom_2000_0.opar -omslocal
emcli import_update -file=filepath/13.1.1.1.0_oracle.cgbu.ocom_2000_0.opar -omslocal

where filepath is the absolute path to the location where the opar file is located.

Verify the successful plug-in import:

  1. Log in to the Enterprise Manager Cloud Control administration console.
  2. From the Setup menu, select Extensibility , and then Plug-ins .
  3. In the Applications folder, verify that there is an Oracle Communications row.

Deploying the Application Management Pack for Oracle Communications Plug-In

After installing the plug-in, deploy it on the Enterprise Manager Cloud Control Management Server and target host agents.

Deploying the Plug-In on the Management Server

To deploy the plug-in on the Management Server:

  1. Log in to the Enterprise Manager Cloud Control administration console.
  2. Set up preferred credentials for the target hosts. See "About Host Preferred Credentials" for more information.
  3. From the Setup menu, select Extensibility , and then Plug-ins .
  4. From the Applications folder, select the Oracle Communications .
  5. From the Deploy On menu, select Management Servers . The Deploy Plugin on Management Servers dialog appears.
  6. In the Password field, enter the password for the sys user and click Continue .
  7. Complete the remaining steps in the dialog box.
  8. Click Deploy .
  9. Monitor the status to ensure successful deployment.
  10. Install the default configuration template files. See "Installing the Default Configuration Template Files" for more information.

Deploying the Plug-In on Management Agents

The plug-in must be deployed to each Management Agent on host targets running Oracle Communications applications. Before deploying the plug-in to a Management Agent you must add the host target to your Enterprise Manager Cloud Control instance. See "Adding Host Targets Manually and Installing the Management Agent" for information on adding host targets.

To deploy the plug-in to an Oracle Communications host target Management Agent, do the following for all host targets where Oracle Communications applications are installed:

  1. Log in to the Enterprise Manager Cloud Control administration console.
  2. From the Setup menu, select Extensibility , and then Plug-ins .
  3. Expand Applications .
  4. Right-click Oracle Communications .
  5. Select Deploy On , and then Management Agent . The Deploy Plug-in on Management Agent window appears.
  6. Click Continue .
  7. Select the targets on which to deploy the plug-in.
  8. Click Continue .
  9. Confirm there are no errors indicated by the pre-requisite check.
  10. Click Next .
  11. Click Deploy .
  12. Confirm that the Application Management Pack for Oracle Communication plug-in deploys successfully.

For more information about the Plug-In Manager, see Oracle Enterprise Manager Cloud Control Administrator's Guide .

Upgrading the Application Management Pack for Oracle Communications Plug-In

You can upgrade the plug-in using the Self Update feature in Enterprise Manager Cloud Control. You must deploy the upgraded plug-in to the Management Server and Management Agents.

You can use the following upgrade paths:

The upgrade process is slightly different for the different target versions. See one of the following sections, depending your target version:

For information about Self Update, see the chapter about updating Cloud Control in Oracle Enterprise Manager Cloud Control Administrator's Guide.

For more information about upgrading plug-ins, see the chapter about managing plug-ins in Oracle Enterprise Manager Cloud Control Administrator's Guide .

Upgrading to Version 13.1.1.1

Upgrading to version 13.1.1.1 of the Application Management Pack for Oracle Communications plug-in involves upgrading to Enterprise Manager Cloud Control 13c. As part of the Enterprise Manager Cloud Control upgrade process, the Application Management Pack for Oracle Communications plug-in is also upgraded and deployed. Because of errors in the automated plug-in upgrade process, you must uninstall and reinstall the plug-in.

To upgrade to version 13.1.1.1 of the plug-in:

  1. Upgrade your 11g Oracle Database to 12c as described in Oracle Database Upgrade Guide for version 12c.
  2. Upgrade Enterprise Manager Cloud Control from 12c to 13c as described in Enterprise Manager Cloud Control Upgrade Guide for version 13c.
  3. Uninstall version 13.1.1.1 of the Application Management Pack for Oracle Communications plug-in as described in "Uninstalling the Application Management Pack for Oracle Communications Plug-In".
  4. Reinstall version 13.1.1.1 of the plug-in as described in "Installing the Application Management Pack for Oracle Communications Plug-in".
  5. Deploy the plug-in to the management server and agents as described in "Deploying the Application Management Pack for Oracle Communications Plug-In".

Confirm that the newest version of the plug-in was successfully deployed as follows:

  1. Log in to the Enterprise Manager Cloud Control administration console.
  2. From the Setup menu, select Extensibility , and then Plug-ins . The Plug-ins page appears.
  3. Select the Oracle Communications row.
  4. From the Actions menu, select Information . The Plug-in Information page appears.
  5. On the General tab, confirm that the values for Latest Available Version , Version Downloaded , Version are all the same.
  6. In the Certified Targets table, confirm that the values for Plug-in Version and Plug-in Version on Management Server are the same.

Upgrading to Version 12.1.0.4

Upgrading to version 12.1.0.4 of the Application Management Pack for Oracle Communications plug-in follows the standard upgrade process. Additionally, because of changes to the structure for Oracle Communications Integration and ECE targets, you must remove and rediscover these targets after deploying the 12.1.0.4 version of the plug-in.

To upgrade to version 12.1.0.4 of the plug-in:

  1. Upgrade Enterprise Manager Cloud Control to version 12.1.0.5 as described in Oracle Enterprise Manager Cloud Control Upgrade Guide for version 12c.
  2. Install the 12.1.0.4 version of the Application Management Pack for Oracle Communications plug-in as described in "Installing the Application Management Pack for Oracle Communications Plug-in".
  3. Deploy the plug-in to Oracle Management Service and each Management Agent as described in "Deploying the Application Management Pack for Oracle Communications Plug-In".

Confirm that the newest version of the plug-in was successfully deployed as follows:

  1. Log in to the Enterprise Manager Cloud Control administration console.
  2. From the Setup menu, select Extensibility , and then Plug-ins . The Plug-ins page appears.
  3. Select the Oracle Communications row.
  4. From the Actions menu, select Information . The Plug-in Information page appears.
  5. On the General tab, confirm that the values for Latest Available Version , Version Downloaded , Version are all the same.
  6. In the Certified Targets table, confirm that the values for Plug-in Version and Plug-in Version on Management Server are the same.
  1. In the Enterprise Manager Cloud Control administration console, from the Targets menu, select All Targets .
  2. In the Target Type tree, select ECE Cluster, ECE Node, or Oracle Communications Integration. A list of targets of that type appears.
  3. Right-click the name of a target.
  4. From the context menu, select Target Setup and then Remove Target . A confirmation dialog box appears.
  5. Click Yes .

Uninstalling the Application Management Pack for Oracle Communications Plug-In

To remove Application Management Pack for Oracle Communications:

  1. Log in to the Enterprise Manager Cloud Control administration console.
  2. From the Setup menu, select Extensibility , and then Plug-ins .
  3. In the Applications folder, select Oracle Communications .
  4. Click Undeploy From and undeploy the plug-in from all Management Agents.
  5. Click Undeploy From and undeploy the plug-in from all Management Servers.

For more information, see the discussion of undeploying plug-ins in Oracle Enterprise Manager Cloud Control Administrator's Guide .

Installing the Default Configuration Template Files

Application Management Pack for Oracle Communications provides parameter template files used by Enterprise Manager Cloud Control to install and configure supported Oracle Communications applications. You must install the default configuration template files provided to the Enterprise Manager Cloud Control domain.

To install the configuration templates:

  1. Log in to the Enterprise Manager Cloud Control host on which you have installed and deployed the Application Management Pack for Oracle Communications plug-in.
  2. Create the following directory structure in your Enterprise Manager Cloud Control instance: EM_home /../gc_inst/user_projects/domains/GCDomain/default_xml/platform
  3. Copy one of the following files to the new EM_home /../gc_inst/user_projects/domains/GCDomain/default_xml/platform directory:
  4. Unzip default_xml.zip into the platform directory.

About Provisioning Variables

The default_xml.zip archive includes the platform_suite_default.xml file. This file contains the parameters used by the Communications Suite Installation Procedure for each supported application. See the supported application installation guides for specific information on these values and their role in application installation.

Editing platform_suite_default.xml allows the definition of commonly used or static environmental values, such as user names and port values, in your environment. The provisioning procedure pre-populates the values used in this configuration file.

The following example shows the configurable db_name value parameter for a Billing and Revenue Management database SID in the platform_suite_default.xml file:

db_name" category="orclocom_brm" basic="true" type="DBRegister">

Make a copy of the edited platform_suite_default.xml file and save it in a secure location.

Creating the Oracle Communications Folders for BRM Installers

If you are provisioning Billing and Revenue Management, you must create the CommSuiteProvisioning and BRMComponents folders in the Enterprise Manager Cloud Control Software Library to store installers used during the provisioning procedure.

To create the folders:

  1. Log in to the Enterprise Manager Cloud Control administration console.
  2. From the Enterprise menu, select Provisioning and Patching , and then Software Library .
  3. From the Actions menu, select Create Folder .
  4. In the Name field, enter CommsSuiteProvisioning .
  5. Click OK .
  6. Select the CommsSuiteProvisioning folder.
  7. From the Actions menu, select Create Folder .
  8. In the Name field, enter BRMComponents .
  9. Click OK .

Enabling Application Management Pack for Oracle Communications Logging

Enable java logging for Application Management Pack for Oracle Communications in Enterprise Manager Cloud Control by updating the logging.xml file located in the following directory on your Enterprise Manager Cloud Control Management Server host:

To enable logging:

  1. Log in to the Management Server host as a user with permissions to modify the Enterprise Manager Cloud Control configuration.
  2. Change directory to EM_home /gc_inst/user_projects/domains/GCDomain/config/fmwconfig/servers/EMGC_OMS1 .
  3. Open the logging.xml file with a text editor.
  4. Add a new entry for the Application Management Pack for Oracle Communications log handler. Use the following example as a guide:

 /servers/$/sysman/log/comms-ams.log'/>

Set the logging level by editing the level value in the logger entry. For example, the following logger entry provides trace logging of all messages:

You are not required to restart the Enterprise Manager Cloud Control Management Server to activate changes to logging configuration.

Extending Application Domains with the Enterprise Manager Template

Before you can use Enterprise Manager Cloud Control to monitor applications deployed to Oracle Fusion Middleware domains, you must extend the application's domain with the Enterprise Manager template.

You extend domains by selecting the Enterprise Manager template on the Templates screen of the Fusion Middleware Configuration Wizard or by using the WebLogic Scripting Tool (WLST). You can extend domains at any time. After extending existing domains, restart the servers for the changes to take effect.

You must extend the Fusion Middleware domains before you can monitor the following applications:

For more information about templates and extending domains, see the following: