5.4.2 Configuring Oracle for Adobe-preconfigured JBoss

To enable JBoss to connect to the Oracle database that stores LiveCycle data, you must create a data source file and deploy it to the instance of JBoss where you will deploy LiveCycle.

Note: Encrypt the password in the data source files (adobe-ds.xml and oracle-ds.xml) and the login-config.xml file using one of the methods described at http://community.jboss.org/wiki/EncryptingDataSourcePasswords. You can also use the instructions available on http://blogs.adobe.com/livecycle/2009/10/livecycle_-_encrypting_clearte.html.

5.4.2.1 Edit adobe-ds.xml file

  1. Open the [appserver root]/server/lc_oracle/deploy/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> 
    <security-domain>OracleDbRealm</security-domain>
  2. Replace the following text from the above line 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: The SID of the database that stores the LiveCycle data. Replace the default value, adobe, with your database SID.

  3. 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.

  4. (Only for Oracle RAC) Replace the connection URL mentioned in step 1 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.
  5. (Only for Oracle RAC) Replace the following text from the connection URL in step 4 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.

  6. Ensure that the minimum and maximum values for the data source connections are set as follows:

    • For IDP_DS:

      <min-pool-size>1</min-pool-size> 
      <max-pool-size>30</max-pool-size>
    • For 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.
  7. Save and close the file.

5.4.2.2 Edit oracle-ds.xml file

If you are running LiveCycle with an Oracle database, you must set Oracle as the default data source for JBoss. This procedure assumes that the Oracle JDBC driver is installed in the [appserver root]/server/lc_oracle/lib directory.

  1. Open the [appserver root]/server/lc_oracle/deploy/oracle-ds.xml file in a text editor and modify the <local-tx-datasource> element with your Oracle connection settings:

    <jndi-name>DefaultDS</jndi-name> 
    <connection-url>jdbc:oracle:thin@localhost:1521:adobe</connection-url> 
    <driver-class>oracle.jdbc.driver.OracleDriver</driver-class> 
    <security-domain>OracleDbRealm</security-domain>
  2. Replace the bold text in the above lines with values that are specific to your database:

    localhost: 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.

    adobe: Replace this value with your database SID.

  3. 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.

  4. (Only for Oracle RAC) Replace the connection settings mentioned in the first step 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.
  5. (Only for Oracle RAC) Replace the following text from the connection URL in the previous step 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.

  6. Save and close the file.

5.4.2.3 Edit login-config.xml file

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

    <application-policy name="OracleDbRealm"> 
        <authentication> 
            <login-module 
            code="org.jboss.resource.security.SecureIdentityLoginModule" 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 text with values that are specific to your database so that the application server can access your database.

    Note: For Oracle RAC, replace adobe with the service name specific to your database.
  3. Save and close the file.

  4. Start JBoss.

// Ethnio survey code removed