Installation Steps

To install the integration:

1. Download the CCB-NMS.zip file from My Oracle Support.

Note: For specific instructions about installing this integration on non-Windows/Linux platforms, refer to Oracle Support Knowledge article ID 1349320.1. (The process described refers specifically to the CCB-MDM integration, however it applies to any integration being installed on alternate platforms).

2. Extract the zip file to get the installation folder. This folder includes subfolders, such as bin, config, Install, MDS-Artifacts, and services.

3. Verify that the environment variables for Linux and Windows operating systems.

Variable	Example
MW_HOME	XXX/Middleware
SOA_HOME	XXX/Middleware/soa
ORACLE_HOME	XXX/Middleware/soa
PRODUCT_HOME	The product installation folder. Example: PRODUCT_HOME=/scratch/PRODUCT_HOMES/CCB-NMS

The commands indicated in the readme file (setWLSEnv.sh on Linux and setWLSEnv.bat on Windows) set the environment variables used for executing the installation scripts.

Below is an example to set up environment variables in a typical installation:

Note: Ensure the latest version of ant-contrib.jar is explicitly added to the system CLASSPATH environment variable prior to execution.

Linux

export MW_HOME=/Oracle/Middleware/soa

export SOA_HOME=$MW_HOME/soa

export PRODUCT_HOME=/Product_Homes/CCB-NMS

source $MW_HOME/wlserver/server/bin/setWLSEnv.sh

export CLASSPATH=/path/ant-contrib.jar:$CLASSPATH

echo “Classpath updated successfully with ant-contrib.jar”

Example:

export ORACLE_HOME=/scratch/gbuora/SOA14c/Oracle_Home

export SOA_HOME=$ORACLE_HOME/soa

export MW_HOME=$ORACLE_HOME # If you want to keep MW_HOME for compatibility

# Source the WebLogic environment setup script from new location

source $ORACLE_HOME/wlserver/server/bin/setWLSEnv.sh

# Set product home and cd into its bin

export PRODUCT_HOME=/scratch/SOA14c/product_homes/CCB-NMS

export CLASSPATH=/scratch/ant-contrib.jar:$CLASSPATH

cd $PRODUCT_HOME/bin

Windows

SET MW_HOME=C:\Oracle\Middleware\soa

SET SOA_HOME=%MW_HOME%\soa

SET PRODUCT_HOME=C:\Product_Homes\CCB-NMS cd %MW_HOME%/wlserver/server/bin/ setWLSEnv.cmd

set CLASSPATH=C:\path\ant-contrib.jar;%CLASSPATH% echo Classpath updated successfully with ant-contrib.jar

Example:

set ORACLE_HOME=C:\scratch\SOA14c\Oracle_Home

set SOA_HOME=%ORACLE_HOME%\soa

set MW_HOME=%ORACLE_HOME% REM If you want to keep MW_HOME for compatibility

REM Source the WebLogic environment setup script

call %ORACLE_HOME%\wlserver\server\bin\setWLSEnv.cmd

REM Set product home and change directory

set PRODUCT_HOME=C:\scratch\SOA14c\product_homes\CCB-NMS

set CLASSPATH=C:\scratch\ant-contrib.jar;%CLASSPATH%

cd /d %PRODUCT_HOME%\bin

Note the following:

• Replace C:\scratch\... with the actual Windows path (if it is different).

• Use call to execute .cmd scripts so that the environment variables persist.

• /d in cd allows to change the drive letters if needed.

Also, note the following:

• PRODUCT_HOME/install/util/ant folder contains all the ant build scripts.

• PRODUCT_HOME/bin/InstallBuild.xml is used to install CCB-NMS integration code.

• PRODUCT_HOME/bin/UnInstallBuild.xml is used to uninstall CCB-NMS integration code.

• PRODUCT_HOME/bin/DeployUndeployUtility.xml is used to deploy/ undeploy individual composite/MDS folder, and then restart the managed server.

Note: The installation process may take several minutes to complete.

4. Install the integration. This section provides additional detail to supplement those steps.

a. Update the InstallProperties.xml and OUCCBOUNMSConfigurationProperties.xml files with appropriate values.

• InstallProperties.xml

File location: $PRODUCT_HOME/config

• OUCCBOUNMSConfigurationProperties.xml

File location: $PRODUCT_HOME/MDS-Artifacts/CCB-NMS/AIAMetaData/config

For detailed instructions on various properties, refer to Chapter 5: Installation Properties.

b. Navigate to the product home directory/bin folder.

cd $PRODUCT_HOME/bin (linux)

cd %PRODUCT_HOME%\bin (windows)

c. Run the following commands:

Linux:

ant -f InstallBuild.xml installDB -DInstallProperties=$PRODUCT_HOME/config/InstallProperties.xml | -l idb.log

ant -f InstallBuild.xml installWL -DinstallJMSWrappers=true -DInstallProperties=$PRODUCT_HOME/config/InstallProperties.xml | -l iwl.log

ant -f InstallBuild.xml installSOA -DinstallJMSWrappers=true DInstallProperties=$PRODUCT_HOME/config/InstallProperties.xml | tee isoa.log

Windows:

ant -f InstallBuild.xml installDB -DInstallProperties=%PRODUCT_HOME%/config/InstallProperties.xml -l idb.log

ant -f InstallBuild.xml installWL -DinstallJMSWrappers=true -DInstallProperties=%PRODUCT_HOME%/config/InstallProperties.xml -l iwl.log

ant -f InstallBuild.xml installSOA -DinstallJMSWrappers=true -DInstallProperties=%PRODUCT_HOME%/config/InstallProperties.xml -l isoa.log

Note: Use -Dproperty=value to set properties and - options (like -l or -f) for log files, build files, and other command-line options in Ant.

The installWL commands perform the following tasks:

• Create JMS server/JMS module/JMS connection pool/JMS persistence store/JMS queues and assigns the error queues to the interface queues.

• Create JMS outbound connections to both Oracle Utilities Customer Care and Billing and Oracle Utilities Network Management System by updating the JMSAdapter_CCB-NMS.rar file.

• Create the csf key for the integration.

The installSOA commands perform the following tasks:

• Update the MDS repository with all artifacts.

• Create the application partition where the composites are deployed.

Example: CCB-NMS

• Compile and deploy all composites.