6 Using the Lifecycle Management Tools to Install Oracle SOA Suite

Follow these steps to use Apache Groovy to run the install-oraclehome standard action, which will install Oracle SOA Suite into the Infrastructure Oracle home you created.

Starting FMW Composer
Start FMW Composer from the ORACLE_HOME/oracle_common/bin directory.
Opening the soa-bootstrap-topology-1.0.json File
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.
Editing the soa-bootstrap-topology-1.0.json File
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.
Using Apache Groovy to Run the install-oraclehome Standard Action
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.

Parent topic: Tutorial: Installing and Configuring Oracle SOA Suite Using the LCM Tools

6.1 Starting FMW Composer

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

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
```
Change directory to the ORACLE_HOME/oracle_common/bin directory.
```
cd ORACLE_HOME/oracle_common/bin
```
Start FMW Composer (fmw-composer.sh).
```
./fmw-composer.sh
```

6.2 Opening the soa-bootstrap-topology-1.0.json File

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.

From the File menu, select Open File...
In the Open Composer File dialog box, navigate to the path_to_example_directory/create-domain-example/models/topologies directory.
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

6.3 Editing the soa-bootstrap-topology-1.0.json File

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.

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.
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
```
In the Java Home field, enter the path to a certified JDK.
For example:
```
/home/Oracle/products/jdk1.8.0_77
```
Under Installations, select the infra (Fusion Middleware Infrastructure) entry and click to remove this entry, as Infrastructure is already installed in this Oracle home.
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.
Select File and then Save to save the changes made to the file.
After saving the file, select File and then Exit to exit Composer.

6.4 Using Apache Groovy to Run the install-oraclehome Standard Action

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.

The create-oracle-home.groovy file is located in the create-domain-example directory.

To run the action:

Change directory to the create-domain-example directory.
```
cd path_to_example_directory/create-domain-example
```
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.
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
```
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
```

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"
  } ]
}

At this point, you should have an Oracle home that contains both Oracle Fusion Middleware Infrastructure and Oracle SOA Suite.