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.
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 version 12c Release 4.
See the Enterprise Manager Cloud Control documentation library for information about Enterprise Manager Cloud Control system requirements and installation procedures.
Enterprise Manager Cloud Control requires an Oracle Enterprise Database. See the Oracle Enterprise Database documentation for information about installing and configuring Oracle Enterprise Database.
For more information about system requirements and certified versions for Enterprise Manager, see the Enterprise Manager Base Platform certification matrix available on My Oracle Support.
Caution:
The Oracle Management Repository for Enterprise Manager is not certified on Oracle Database 12c. For the full functionality described in this guide, the Management Repository must be configured in an Oracle Database version listed in the Enterprise Manager certification matrix.This guide assumes a properly configured Enterprise Manager Cloud Control and Enterprise Database environment.
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 Technology Network at:
See "Supported Applications" for a list of supported Oracle Communications applications and versions.
Install the plug-in using one of the following methods:
You install the Application Management Pack for Oracle Communications plug-in using Self Update in the Enterprise Manager Cloud Control administration console.
To install the plug-in using Self Update:
Log in to the Enterprise Manager Cloud Control administration console.
From the Setup menu, select Extensibility, and then Self Update.
Select the Plug-in row and click Open.
Select the row for the Oracle Communications plug-in.
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.
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:
Download the Application Management Suite for Communications plug-in from the Oracle Software Delivery Cloud:
Copy the 12.1.0.2.0_oracle.cgbu.ocom_2000_0.opar file to the Enterprise Manager Cloud Control host.
In a terminal session, navigate to the oms/bin directory of your Enterprise Manager Cloud Control installation.
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
where host and port are the connection values for the Enterprise Manager Cloud Control server and password is the password for the sysman user.
Import the Application Management Suite for Communications OPAR file using the following command:
./emcli import_update -file=filepath/12.1.0.2.0_oracle.cgbu.ocom_2000_0.opar -omslocal
where filepath is the absolute path to the location where the 12.1.0.2.0_ oracle.cgbu.ocom_2000_0.opar file is located.
Verify the successful plug-in import:
Log in to the Enterprise Manager Cloud Control administration console.
From the Setup menu, select Extensibility, and then Plug-ins.
In the Applications folder, verify that there is an Oracle Communications row.
See "Deploying the Application Management Pack for Oracle Communications Plug-In" for information about deploying the plug-in.
After installing the plug-in, deploy it on the Enterprise Manager Cloud Control Management Server and target host agents.
To deploy the plug-in on the Management Server:
Log in to the Enterprise Manager Cloud Control administration console.
Set up preferred credentials for the target hosts. See "Setting Up Host Preferred Credentials" for more information.
From the Setup menu, select Extensibility, and then Plug-ins.
From the Applications folder, select the Oracle Communications.
From the Deploy On menu, select Management Servers.
The Deploy Plugin on Management Servers dialog appears.
In the Password field, enter the password for the sys user and click Continue.
Complete the remaining steps in the dialog box.
Click Deploy.
Monitor the status to ensure successful deployment.
Install the default configuration template files. See "Installing the Default Configuration Template Files" for more information.
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:
Log in to the Enterprise Manager Cloud Control administration console.
From the Setup menu, select Extensibility, and then Plug-ins.
Expand Applications.
Right-click Oracle Communications.
Select Deploy On, and then Management Agent.
The Deploy Plug-in on Management Agent window appears.
Click Continue.
Select the targets on which to deploy the plug-in.
Click Continue.
Confirm there are no errors indicated by the pre-requisite check.
Click Next.
Click Deploy.
Confirm that the Application Management Pack for Oracle Communication plug-in deploys successfully.
Repeat steps 1 through 12 for all Oracle Communications host targets.
For more information about the Plug-In Manager, see Oracle Enterprise Manager Cloud Control Administrator's Guide.
You can upgrade the plug-in using the Self Update feature in Enterprise Manager Cloud Control. You must deploy the updated plug-in to the Management Server and Management Agents.
Upgrading and deploying the plug-in involves the following tasks:
Check whether a new version of the plug-in is available. See the discussion of checking the availability of plug-ins in Oracle Enterprise Manager Cloud Control Administrator's Guide for details.
Download the newest version of the plug-in. See "Installing the Plug-in using Enterprise Manager Self Update" for details.
Deploy the newest version of the plug-in to Oracle Management Service. See "Deploying the Plug-In on the Management Server" for details.
Deploy the newest version of the plug-in on each Management Agent. See "Deploying the Plug-In on Management Agents" for details.
Confirm that the newest version of the plug-in was successfully deployed as follows:
Log in to the Enterprise Manager Cloud Control administration console.
From the Setup menu, select Extensibility, and then Plug-ins.
The Plug-ins page appears.
Select the Oracle Communications row.
From the Actions menu, select Information.
The Plug-in Information page appears.
On the General tab, confirm that the values for Latest Available Version, Version Downloaded, Version are all the same.
In the Certified Targets table, confirm that the values for Plug-in Version and Plug-in Version on Management Server are the same.
Install the default configuration template files. See "Installing the Default Configuration Template Files" for details.
For more information about upgrading plug-ins, see the chapter about managing plug-ins in Oracle Enterprise Manager Cloud Control Administrator's Guide.
For more information about Self Update, see the chapter about updating Cloud Control in Oracle Enterprise Manager Cloud Control Administrator's Guide.
To remove Application Management Pack for Oracle Communications:
Log in to the Enterprise Manager Cloud Control administration console.
From the Setup menu, select Extensibility, and then Plug-ins.
In the Applications folder, select Oracle Communications.
Click Undeploy From and undeploy the plug-in from all Management Agents.
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.
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:
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.
Create the following directory structure in your Enterprise Manager Cloud Control instance:
EM_home/../gc_inst/user_projects/domains/GCDomain/default_xml/platform
Copy the EM_home/plugins/oracle.cgbu.ocom.oms.plugin_12.1.0.2.0/metadata/swlib/platform/components/default_xml.zip to EM_home/../gc_inst/user_projects/domains/GCDomain/default_xml/platform.
Unzip default_xml.zip into the platform directory.
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:
<parameter mandatory="true" name="DATABASE_SID" value="db_name" category="orclocom_brm" basic="true" type="DBRegister">
<label locale="en" value="Database SID"/>
</parameter>
Make a copy of the edited platform_suite_default.xml file and save it in a secure location.
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:
Log in to the Enterprise Manager Cloud Control administration console.
From the Enterprise menu, select Provisioning and Patching, and then Software Library.
From the Actions menu, select Create Folder.
In the Name field, enter CommsSuiteProvisioning.
Click OK.
Select the CommsSuiteProvisioning folder.
From the Actions menu, select Create Folder.
In the Name field, enter BRMComponents.
Click OK.
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:
EM_home/gc_inst/user_projects/domains/GCDomain/config/fmwconfig/servers/EMGC_OMS1
To enable logging:
Log in to the Management Server host as a user with permissions to modify the Enterprise Manager Cloud Control configuration.
Change directory to EM_home/gc_inst/user_projects/domains/GCDomain/config/fmwconfig/servers/EMGC_OMS1.
Open the logging.xml file with a text editor.
Add a new entry for the Application Management Pack for Oracle Communications log handler. Use the following example as a guide:
<log_handler name='comms-ams-handler' class='oracle.core.ojdl.logging.ODLHandlerFactory' filter='oracle.dfw.incident.IncidentDetectionLogFilter'>
<property name='path' value='${domain.home}/servers/${weblogic.Name}/sysman/log/comms-ams.log'/>
<property name='maxFileSize' value='10485760'/>
<property name='maxLogSize' value='104857600'/>
<property name='encoding' value='UTF-8'/>
<property name='useThreadName' value='true'/>
<property name='supplementalAttributes' value='J2EE_APP.name,J2EE_MODULE.name,WEBSERVICE.name,WEBSERVICE_PORT.name,composite_instance_id,component_instance_id,composite_name,component_name'/>
</log_handler>
Add a new entry for a logger referring to the log handler created in step 4. Use the following example as a guide:
<logger name='oracle.communications.platform.em' level='NOTIFICATION' useParentHandlers='false'> <handler name='comms-ams-handler'/> </logger>
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:
<logger name='oracle.communications.platform.em' level='TRACE:32' useParentHandlers='false'> <handler name='comms-ams-handler'/> </logger>
Setting the logging level to TRACE:32 produces large amounts of logging data and should only be used for resolving issues with your Application Management Pack for Oracle Communications environment. See the chapter about logging in Oracle Enterprise Manager System Administrator's Guide for more information on setting logging levels.
Save the changes made to logging.xml and exit the editor.
You are not required to restart the Enterprise Manager Cloud Control Management Server to activate changes to logging configuration.