5.4.1 Configuring MySQL for Adobe pre-configured JBoss 5.1

To enable Adobe pre-configured JBoss to connect to the MySQL 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 mysql-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.1.1 Edit adobe-ds.xml file

Before configuring the MySQL data source, you must have already created the database on MySQL as described in 4.6 Creating a MySQL database.

  1. Open the [appserver root]/server/lc_mysql/deploy/adobe-ds.xml file in a text editor and locate this line for both IDP_DS and EDC_DS:

    <connection-url>jdbc:mysql://localhost:3306/adobe</connection-url> 
    <driver-class>com.mysql.jdbc.Driver</driver-class> 
    <security-domain>MySqlDbRealm</security-domain>
  2. Replace the following text in the file 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.

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

    • adobe: The name of the database that stores the data. Replace the default value, adobe, with your database name.

  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. 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 maximum number of 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.
  5. Save and close the file.

5.4.1.2 Edit mysql-ds.xml file

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

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

    <jndi-name>DefaultDS</jndi-name> 
    <connection-url>jdbc:mysql://localhost:3306/adobe/</connection-url> 
    <driver-class>com.mysql.jdbc.Driver</driver-class> 
    <security-domain>MySqlDbRealm</security-domain>
  2. Replace the following text in the file with values that are specific to your database:

    • localhost: Replace this value with the name of the server hosting the database.

    • 3306:Replace this value with the port number for your database server.

    • adobe: Replace this value with the database that will connect with LiveCycle.

  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. Save and close the file.

5.4.1.3 Edit login-config.xml file

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

    <application-policy name="MySqlDbRealm"> 
        <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=Default DS </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.

  3. Save and close the file.

  4. Start JBoss.

// Ethnio survey code removed