Installation Steps
To install the integration:
1. Download the installation C2M-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 C2M-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/C2M-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:
Linux
export MW_HOME=/Oracle/Middleware/soa
export SOA_HOME=$MW_HOME/soa
export ORACLE_HOME=/Oracle/Middleware
export PRODUCT_HOME=/Product_Homes/C2M-NMS
source $MW_HOME/wlserver/server/bin/setWLSEnv.sh
 
Windows
SET MW_HOME=C:\Oracle\Middleware
SET SOA_HOME=%MW_HOME%\soa
SET ORACLE_HOME=C:\Oracle\Middleware
SET PRODUCT_HOME=C:\Product_Homes\C2M-NMS
%MW_HOME%/wlserver/server/bin/setWLSEnv.cmd
 
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 C2M-NMS integration code.
• PRODUCT_HOME/bin/UnInstallBuild.xml is used to uninstall C2M-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 OUC2MOUNMSConfigurationProperties.xml files with appropriate values.
• InstallProperties.xml
File location: $PRODUCT_HOME/config
• OUC2MOUNMSConfigurationProperties.xml
File location: $PRODUCT_HOME/MDS-Artifacts/C2M-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. Execute the following commands:
Linux:
ant -f InstallBuild.xml installWL -DinstallJMSWrappers=true -DInstallProperties=$PRODUCT_HOME/config/InstallProperties.xml | -l iwl.log
ant -f InstallBuild.xml installSOA -DInstallProperties=$PRODUCT_HOME/config/InstallProperties.xml | tee isoa.log
Windows:
ant -f InstallBuild.xml installWL -DInstallProperties=%PRODUCT_HOME%/config/InstallProperties.xml -l iwl.log
ant -f InstallBuild.xml installSOA -DInstallProperties=%PRODUCT_HOME%/config/InstallProperties.xml -l isoa.log
 
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 Network Management System and Oracle Utilities Customer to Meter by updating the JMSAdapter_C2M-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: C2M-NMS
• Compile and deploy all composites.