Wednesday, October 2, 2024

Installation of Oracle SOA 12.2.1.4 Maven plugin

 To install the Oracle SOA 12.2.1.4 Maven plugin, follow the steps below. The Oracle SOA Maven plugin is not hosted in a public repository like Maven Central, so it needs to be installed manually from the Oracle installation directory or configured in a local repository.

Step 1: Locate the Oracle SOA Maven Plugin

The Oracle SOA Suite installation directory contains a script that generates a pom.xml file and installs the necessary SOA Maven artifacts into your local Maven repository. This is usually found in your Oracle Middleware home directory.

The typical path to the Maven sync script is:

ruby

<ORACLE_HOME>/oracle_common/plugins/maven/com/oracle/maven/oracle-maven-sync.jar

For Example on my Server this file is located in following directory





C:\Oracle\Middleware\Oracle_Home\oracle_common\plugins\maven\com\oracle\maven\oracle-maven-sync\12.2.1

Step 2: Execute the oracle-maven-sync Script

  1. Open a terminal or command prompt.

  2. Navigate to the directory containing oracle-maven-sync.jar.

    bash
    cd C:\Oracle\Middleware\Oracle_Home\oracle_common\plugins\maven\com\oracle\maven\oracle-maven-sync\12.2.1
  3. Run the Maven sync command to install the SOA Maven plugin and dependencies:

    bash
    mvn install:install-file -DpomFile=oracle-maven-sync.xml -Dfile=oracle-maven-sync.jar

    Alternatively, you can use the oracle-maven-sync script:

    bash
    java -jar oracle-maven-sync.jar -f

This command installs all the necessary SOA artifacts, including the oracle-soa-maven-plugin into your local Maven repository (~/.m2).

Step 3: Verify Installation

After running the command, verify that the artifacts have been installed in your local Maven repository. Check under the com/oracle/soa/oracle-soa-maven-plugin directory inside the .m2 folder:

ruby
~/.m2/repository/com/oracle/soa/oracle-soa-maven-plugin

You should see subdirectories like 12.2.1.4, containing the plugin JAR files and associated pom.xml files.

Step 4: Update the Maven pom.xml

Once the plugin is installed locally, update your pom.xml to reference it:

xml

<plugin> <groupId>com.oracle.soa</groupId> <artifactId>oracle-soa-maven-plugin</artifactId> <version>12.2.1.4</version> </plugin>

Additional Configuration (Optional)

If you need to use this plugin in a shared environment (e.g., CI/CD pipeline or team development), consider deploying it to a shared Maven repository like Nexus or Artifactory. Here’s how to do that:

  1. Install the plugin to your shared repository:

    bash
    mvn deploy:deploy-file -DgroupId=com.oracle.soa \ -DartifactId=oracle-soa-maven-plugin \ -Dversion=12.2.1.4 \ -Dpackaging=jar \ -Dfile=<ORACLE_HOME>/soa/plugins/maven/oracle-soa-maven-plugin-12.2.1.4.jar \ -DpomFile=<ORACLE_HOME>/soa/plugins/maven/oracle-soa-maven-plugin-12.2.1.4.pom \ -DrepositoryId=<repository_id> \ -Durl=<repository_url>
  2. Configure your pom.xml to point to the shared repository:

xml

<repositories> <repository> <id>shared-repo</id> <url>http://<repository_url>/repository/maven-public/</url> </repository> </repositories>

Maven script to deploy MDS (Metadata Services) artifacts in a SOA 12.2.1.4

To create a Maven script to deploy MDS (Metadata Services) artifacts in a SOA 12.2.1.4 environment, you need to use the oracle-maven-sync c...