9.6.2 Configuring Oracle for manually installed JBoss

To enable JBoss to connect to the Oracle database that stores LiveCycle data, you must complete the following tasks if you are manually deploying LiveCycle:

9.6.2.1 Install the Oracle 11g database driver

Copy the ojdbc6.jar for JDK 1.6 driver file from the [LiveCycle root]/lib/db/oracle directory to the [appserver root]/server/<profile_name>/lib directory. You can also download the Oracle 11g driver from the JDBC Driver Downloads site, see Supported Platform Combinationsfor supported versions Oracle 11g driver.

9.6.2.2 Edit adobe-ds.xml file

  1. Copy the adobe-ds.xml file from the [DVD_root]/third_party/additional/datasources/lc_oracle/deploy directory to the [appserver root]/server/<profile_name>/deploy directory.

  2. Open the adobe-ds.xml file in a text editor and locate this line:

    <connection-url>jdbc:oracle:thin:@localhost:1521:adobe</connection-url> 
    <driver-class>oracle.jdbc.driver.OracleDriver</driver-class> 
    <user-name>adobe</user-name> 
    <password>adobe</password>
  3. Replace the following values with values that are specific to your database:

    • localhost: The name, IP address, or fully-qualified path of the computer that hosts the database. The default is localhost.

    • 1521: The port used to access the database. The default port is 1521.

    • adobe: Change the default value, adobe, with your database SID.

  4. In the lines that follow the <connection-url> settings, locate the user-name and password settings and replace the default values with the user name and password that the application server uses to access your database.

  5. (Only for Oracle RAC) Replace the connection URL mentioned in step 2 with the following connection URL:
    jdbc:oracle:thin:@(DESCRIPTION=(ENABLE=broken) (ADDRESS_LIST=(ADDRESS= (PROTOCOL=TCP) (HOST=yourhost1) (PORT=1521)) (ADDRESS=(PROTOCOL=TCP) (HOST=yourhost2) (PORT=1521)) (LOAD_BALANCE=on) (FAILOVER=on)) (CONNECT_DATA=(SERVER=dedicated) (SERVICE_NAME=service.yourcompany.com) (FAILOVER_MODE=(TYPE=session) (METHOD=basic) (RETRIES=10) (DELAY=3))))
    Note: Ensure that this entry appears as a single line in the adobe-ds.xml file.
  6. (Only for Oracle RAC) Replace the following text from the connection URL in step 5 with values that are specific to your database:

    • yourhost1: The name, IP address, or fully-qualified domain name of the first node in the cluster that hosts the database.

    • yourhost2: The name, IP address, or fully-qualified domain name of the second node in the cluster that hosts the database.

      Note: The cluster hosting the database could have n nodes. yourhost1 and yourhost2 are examples in the case of a two-node cluster.
    • service.yourcompany.com: The service name for the Oracle RAC database.

  7. Modify the minimum and maximum values for the data source connections:

    • IDP_DS:

      <min-pool-size>1</min-pool-size> 
      <max-pool-size>30</max-pool-size>
    • EDC_DS:

      <min-pool-size>1</min-pool-size> 
      <max-pool-size>20</max-pool-size>
      Note: If your LiveCycle Server handles heavy load, increase the number of maximum JDBC connections to ensure that all jobs are processed. In such cases, increase <max-pool-size> to 50 or more for both IDP_DS and EDC_DS.
  8. Save and close the file.

9.6.2.3 Set Oracle as the data source

If you are running LiveCycle with a Oracle database, you must set Oracle to be the default data source for JBoss. This procedure assumes that the Oracle JDBC driver is installed in the [appserver root]/server/<profile_name>/lib directory.

  1. Navigate to the [appserver root]/server/<profile_name>/deploy directory and delete the hsqldb-ds.xml file.

  2. Copy the oracle-ds.xml file from the [appserver root]/docs/examples/jca directory to the [appserver root]/server/<profile_name>/deploy directory.

  3. Open the [appserver root]/server/<profile_name>/deploy/oracle-ds.xml file in a text editor and modify the <local-tx-datasource> element with your Oracle connection settings:
        <jndi-name>OracleDS</jndi-name> 
        <connection-url>jdbc:oracle:thin:@youroraclehost:1521:yoursid    </connection-url> 
        <driver-class>oracle.jdbc.driver.OracleDriver</driver-class> 
        <user-name>x</user-name> 
        <password>y</password>
  4. Replace the bold values with values that are specific to your database:

    • OracleDS: Change this value to DefaultDS.

    • youroraclehost: Replace this value with the host name of your Oracle server.

    • 1521: If Oracle is not using the default port, replace this value with the appropriate port number.

    • yoursid: Replace this value with your Oracle System Identifier.

  5. In the lines that follow the <connection-url> settings, locate the user-name and password settings and replace the default values with the user name and password that the application server uses to access your database.

  6. (Only for Oracle RAC) Replace the connection settings mentioned in step 3 with the following connection URL:
    jdbc:oracle:thin:@(DESCRIPTION=(ENABLE=broken) (ADDRESS_LIST=(ADDRESS= (PROTOCOL=TCP) (HOST=yourhost1) (PORT=1521)) (ADDRESS=(PROTOCOL=TCP) (HOST=yourhost2) (PORT=1521)) (LOAD_BALANCE=on) (FAILOVER=on)) (CONNECT_DATA=(SERVER=dedicated) (SERVICE_NAME=service.yourcompany.com) (FAILOVER_MODE=(TYPE=session) (METHOD=basic) (RETRIES=10) (DELAY=3))))
    Note: Ensure that this entry appears as a single line in the oracle-ds.xml file.
  7. (Only for Oracle RAC) Replace the following text from the connection URL in step 6 with values that are specific to your database:

    • yourhost1: The name, IP address, or fully-qualified domain name of the first node in the cluster that hosts the database.

    • yourhost2: The name, IP address, or fully-qualified domain name of the second node in the cluster that hosts the database.

      Note: The cluster hosting the database could have n nodes. yourhost1 and yourhost2 are examples in the case of a two-node cluster.
    • service.yourcompany.com: The service name for the Oracle RAC database.

  8. Save and close the file.

9.6.2.4 Edit the login-config.xml file

  1. Open the [appserver root]/server/<profile_name>/conf/login-config.xml file in a text editor and add the following text within the <policy> element:

    <application-policy name = "OracleDbRealm">  
        <authentication>  
            <login-module code =  
            "org.jboss.resource.security.ConfiguredIdentityLoginModule" flag =  
            "required">  
            <module-option name = "principal">adobe</module-option>  
            <module-option name = "userName">adobe</module-option>  
            <module-option name = "password">adobe</module-option>  
            <module-option name ="managedConnectionFactoryName">  
            jboss.jca:service=LocalTxCM,name=DefaultDS</module-option>  
            </login-module>  
        </authentication>  
    </application-policy>
  2. Replace the bold values with values that are specific to your database.

  3. Save and close the file.

  4. Start JBoss.

// Ethnio survey code removed