5 Post-Installation Configurations

This chapter discusses how to set up Oracle JDeveloper, how to set up AIA Roles, how to modify passwords used for AIA deployments, how to add Foundation Pack content to a new node of an existing SOA cluster after installing Foundation Pack.

This chapter includes the following sections:

5.1 Setting up Oracle JDeveloper 11g for AIA

Oracle JDeveloper enables you to modify AIA delivered content, or develop and deploy custom AIA content. AIA uses custom XPath functions and it is necessary to import these into the JDeveloper library. You can import these using either of the following procedures:

  • In JDeveloper, navigate to Tools, Preferences, SOA and add the library aia.jar. The aia.jar is available under AIA_HOME/lib directory

  • If you download the AIA plugin from update center to use AIA service constructor, navigate into Tools, Preferences, SOA and add <JDEV_HOME>/jdeveloper/lib/aia.jar to make the functions available to all projects.

Now you can modify AIA delivered processes.

All SOA Composites delivered with AIA products include the JDeveloper projects (.jpr files) along with the source code.

To modify AIA delivered processes:

  1. Copy the content from AIAHOME to the JDeveloper workspace.

  2. All AIA delivered composites are available in AIA_HOME and also include the JDeveloper projects (.jpr files). Copy this content to JDeveloper workspace.

  3. Modify the composites as per your requirements.

  4. Deploy the composites from the JDeveloper context menu.

  5. Review your changes and copy the contents back to AIA_HOME to the same folder where you copied it from.

    This ensures that the modified code is made available to subsequent deployments in other environments.

Note:

If you are maintaining source control for AIA_HOME contents, you must check-in code to version control at this stage.

5.2 Setting up AIA Roles

To set up AIA roles on WebLogic server:

  1. Login to the WebLogic server using the appropriate port http://<hostname>:<port number>/console

  2. Click Security Realms on the left panel.

  3. Click myrealm (or the realm with true in the Default Realm column) in the list.

  4. Click the Users and Groups tab.

  5. Click the Groups tab.

  6. Add the following roles (in JDeveloper they are Roles; in WebLogic Server they are Groups)

    For AIA Lifecycle:

    • AIALifecycleUser

      Assigning users to this role enables them to access all aspects of the Project Lifecycle Workbench, excluding bill of material generation. Typically, you would assign this role to solution architects and functional product managers.

    • AIALifecycleDeveloper

      Assigning users to this role enables them to access all aspects of the Project Lifecycle Workbench, excluding bill of material generation. Typically, you would assign this role to integration developers.

    • AIALifecycleInstallDeveloper

      Assigning users to this role enables them to access all aspects of the Project Lifecycle Workbench, including bill of material generation. Typically, you would assign this role to installation developers.

    Note:

    Each of these AIA Lifecycle roles are included in the Administrators role. If a user has been assigned the Administrators role, the user inherits all the privileges provided by these AIA roles.

    For CAVS

    • AIAApplicationUser

To add the roles:

  1. Click the New button.

  2. Enter the role in the Name field.

  3. Click OK.

Now you must assign groups to the roles.

To assign groups to a roles:

  1. Click Security Realms on the left panel.

  2. Click myrealm (or the realm with true in the Default Realm column) in the list.

  3. Click the Users and Groups tab.

  4. Click the Users tab.

  5. Select the weblogic user (or add your own).

  6. Select the Groups tab.

  7. Move the desired groups to the chosen list.

  8. Click Save.

5.3 Modifying Passwords Used for AIA Deployments

The passwords specified at the time of AIA installation can be changed post-installation. To help you change passwords, AIA provides a utility called UpdateStore. AIA stores its passwords in Keystore. This utility can modify the existing passwords in the Keystore.

In order to run this utility, the AIAIntallProperties.xml properties file should exist in the corresponding AIAHOME/AIA_INSTANCE/<Instance name>/config folder. Also the password being modified must exist in the file.

Note:

This utility only updates encrypted passwords in AIA Installation. It does not change passwords of the SOA Server or the Database schemas.

To modify passwords:

  1. Source the aiaenv.sh in the AIA_INSTANCE/bin.

  2. Browse to AIA_HOME/util/.

  3. Execute ant -f updateStore.xml updateStore -DAdminUsername=<weblogic adminusername> -DAdminPassword=<weblogic admin password>

    Update AIA Keystore screen appears.

  4. Enter the Existing Username, Existing Password, New Username and New Password and the Xpath of the password which you want to change.

    Example 5-1 shows the expected value of the Xpath.

Note:

This utility modifies the username and the password in the AIAInstallProperties.xml. This does not sync the AIAInstallProperties.xml in the MDS. You must do it manually.

Example 5-1 Xpath for Changing Passwords

<properties>
<pips>
<o2c>
<username>scott</username>
<password>[C76sjg98</password>
</o2c>
</pips>
</properties>

To change the password under the o2c tag, enter the following values in the screen that appears.

Existing Username: scott

Existing Password: welcome1

New Username: scott1

New Password: welcome

XPath: /properties/pips/o2c/password

5.4 Adding Foundation Pack Content to a New Node of an Existing SOA cluster Install

  1. Follow instruction in Oracle Fusion Middleware Enterprise Deployment Guide for Oracle SOA Suite and add a new node to a SOA cluster.

  2. Navigate to <AIA_INSTANCE>/AIAMetaData/config folder and edit the AIAConfigurationProeprties.xml file to modify the following property.

    <Property name="EH.JNDIURL">t3://<existing list of soa server details>,<newsoa server host>:<newsoa server port></Property>

  3. Navigate to <AIA_INSTANCE>/config folder and open the AIAInstallProperties.xml file. Add the following information under the "/properties/fp/server/jndi-url" tag.

    <jndiurl>t3://<existing list of soa server details>,<newsoa server host>:<newsoa server port></jndiurl>

  4. Start the new Node.

    When you start the new node, you notice errors pertaining to Foundation Pack in the server logs. Ignore them for now.

  5. Navigate to <AIA_HOME>/aia_instances/<instance name>/bin and source aiaenv.sh/bat.

  6. Navigate to <AIA_HOME>/Infrastructure/Install/AID and execute the following command.

    ant -f AIAInstallDriver.xml -DDeploymentPlan=<AIA_HOME>/Infrastructure/Install/config/FPAddNodeToClusterDP.xml -DPropertiesFile=<AIA_HOME>/aia_instances/<instance name>/config/AIAInstallProperties.xml