6 Using the Lifecycle Management Tools to Install Oracle SOA Suite

Start FMW Composer from the ORACLE_HOME/oracle_common/bin directory.

1. Set the JAVA_HOME environment variable to the path of a certified JDK.

   For example:

   export JAVA_HOME=/home/Oracle/products/jdk1.8.0_77
   

2. Change directory to the ORACLE_HOME/oracle_common/bin directory.

   cd ORACLE_HOME/oracle_common/bin
   

3. Start FMW Composer (fmw-composer.sh).

   ./fmw-composer.sh
   

After you start FMW Composer, open the sample soa-bootstrap-topology-1.0.json file. This file is located in the path_to_example_directory/create-domain-example/models/topologies directory.

1. From the File menu, select Open File...
2. In the Open Composer File dialog box, navigate to the path_to_example_directory/create-domain-example/models/topologies directory.
3. Select soa-bootstrap-topology-1.0.json and click Open.

   When you open the file, you should see the following topology diagram on the screen:

   
   Description of the illustration GUID-753285A4-BF8E-4F72-83DC-CACF9EB7ACBB-default.png

After opening the soa-bootstrap-topology-1.0.json file in Composer, you need to specify the SOA Suite Oracle home location, the path to a certified JDK, and the location of the SOA Suite installer jar file.

1. Select the Oracle Home: soahome box in the Composer topology diagram.

   This will display a panel on the right side of the screen with fields where you can specify information about the SOA Suite Oracle home.

2. In the Path field, enter the full path to the Oracle home where Oracle SOA Suite will be installed. This Oracle home should already contain Fusion Middleware Infrastructure.

   For example:

   /home/Oracle/products/fmw12211
   

3. In the Java Home field, enter the path to a certified JDK.

   For example:

   /home/Oracle/products/jdk1.8.0_77
   

4. Under Installations, select the infra (Fusion Middleware Infrastructure) entry and click to remove this entry, as Infrastructure is already installed in this Oracle home.
5. Under Installations, select the soa (SOA Suite) entry and click to edit the installation data for Oracle SOA Suite:
   1. For the ID field, keep the default value, soa.
   2. For the Install Type field, keep the default value, SOA Suite.
   3. In the Installer field, specify the full path and file name of the Oracle SOA Suite installer jar file (fmw_12.2.1.1.0_soa_generic.jar) you downloaded (see Obtaining the Oracle Fusion Middleware Software):

      path_to_soa_jar_file/fmw_12.2.1.1.0_soa_generic.jar
      

   4. Click OK.
6. Select File and then Save to save the changes made to the file.
7. After saving the file, select File and then Exit to exit Composer.

After editing the soa-boostrap-topology-1.0.json file, use Apache Groovy to run the create-oracle-home.groovy script and execute the install-oraclehome action.

1. Change directory to the create-domain-example directory.

   cd path_to_example_directory/create-domain-example
   

2. In the call-oh.sh file, update the Oracle home location to point to the SOA Suite Oracle home.

   Note that there are two places in this file where you will need to update the Oracle home location, as shown in the following example:

   #!/bin/bash
   
   groovy -cp "ORACLE_HOME/oracle_common/modules/features/oracle.fmwplatform.envspec_lib.jar:
   ORACLE_HOME/oracle_common/modules/features/oracle.fmwplatform.common_lib.jar" $*
   

   In this example, replace ORACLE_HOME with the actual path to your Oracle home directory.

3. In the create-oracle-home.groovy file, replace secret1@ with the actual password of the wallet you created, as shown in the following example:

   "wallet_password".toCharArray()    // the wallet passphrase
   

4. Set the GROOVY_HOME variable to the directory where you installed the Apache Groovy distribution, as shown in the following example:

   export GROOVY_HOME=/home/Oracle/groovy-2.4.6
   export PATH=$PATH:$GROOVY_HOME/bin
   

5. Run the following command from the create-domain-example directory to execute the action:

   sh call-oh.sh create-oracle-home.groovy
   

   Ensure that you have execute permissions if not already.

   If the action is successful, the exit status code will be SUCCESS, as shown in the example below:

   May 16, 2016 11:34:42 AM oracle.fmwplatform.actionframework.v2.internal.ActionBase setInitializedState
   INFO: Action install-oraclehome changed from state CREATED to state NOT_READY
   May 16, 2016 11:34:42 AM oracle.fmwplatform.actionframework.v2.internal.ActionBase setCanInvokeState
   INFO: Action install-oraclehome changed from state NOT_READY to state READY
   May 16, 2016 11:41:40 AM oracle.fmwplatform.actionframework.v2.internal.AbstractActionImpl logActionResult
   INFO: SUCCESS: OUI successful return code: 0
   May 16, 2016 11:43:28 AM oracle.fmwplatform.actionframework.v2.internal.AbstractActionImpl logActionResult
   INFO: SUCCESS: OUI successful return code: 0
   May 16, 2016 11:43:28 AM oracle.fmwplatform.actionframework.v2.internal.ActionBase setInvokedState
   INFO: Action install-oraclehome changed from state READY to state NOT_READY
   May 16, 2016 11:43:28 AM oracle.fmwplatform.actionframework.v2.internal.AbstractActionImpl logActionResult
   INFO: SUCCESS: OUI successful return code: 0
   May 16, 2016 11:43:28 AM oracle.fmwplatform.actionframework.v2.internal.ActionBase setClosedState
   INFO: Action install-oraclehome changed from state NOT_READY to state DESTROYED
   May 16, 2016 11:43:28 AM oracle.fmwplatform.actionframework.v2.internal.ActionBase setDoneState
   INFO: Action install-oraclehome changed from state DESTROYED to state DONE
   {
     "actionResultList" : [ {
       "statusCode" : "SUCCESS",
       "statusDetail" : "OUI successful return code: 0"
     } ]
   }