9.6.3 Configuring SQL Server for manually installed JBoss

To enable JBoss to connect to the SQL Server database that stores LiveCycle data, you must complete the following tasks:

9.6.3.1 Configuring the SQL Server database connectivity

Before you configure the SQL Server data source, you must have the LiveCycle database created on SQL Server. (See Creating a SQL Server database.)

9.6.3.2 Install the SQL database driver for JBoss

  1. Obtain the SQL Server JDBC 4.0 database driver from the Microsoft website.

    Note: Use SQL Server JDBC Driver 4.0 for both Microsoft SQL Server 2008 and Microsoft SQL Server 2012.
  2. (Windows) Download the *.exe file and run it, and then extract the files to a temporary directory (referred to as the [SQL_root] directory in the remainder of this section).

  3. (Linux) Extract the *.tar.gz files to a temporary directory (referred to as the [SQL_root] directory in the remainder of this section).

  4. Copy the sqljdbc.jar file from the [SQL_root] /sqljdbc_4.0/enu directory to the [appserver root] /server/ <profile_name>/lib directory.

  5. Delete the mysql-connector-java-3.1.12-bin.jar file located in the [appserver root] /server/<profile_name>/lib directory.

9.6.3.3 Edit lc_turnkey.xml file

  1. Copy the lc_turnkey.xml file from the [DVD_root] /third_party/additional/datasources/lc_sqlserver/deploy directory to the [appserver root] /standalone/configuration/ directory.

  2. Open the adobe-ds.xml file in a text editor and modify the <local-tx-datasource> element with your SQL Server connection settings:

    <connection-url>jdbc:sqlserver://localhost:1433;DatabaseName=adobe</connection-url> 
    <driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver</driver-class> 
  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 .

    • 1433 : The port used to access the database.

    • adobe : The name of the database that stores the LiveCycle data. You will need to update the default value, adobe , with your database name.

  4. Change the <driver-class> element as follows:

    <driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver</driver-class>
  5. In the lines that follow the <driver-class> 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. 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>30</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.
  6. Save and close the file.

9.6.3.4 Edit the lc_turnkey.xml file

  1. Open the [appserver root] /standalone/configuration/lc_turnkey.xml file in a text editor and add the following lines within the <authentication> element:

    Replace :� 
    � 
    <security-domain name="EncryptDBPassword">� 
                        <authentication>� 
                            <login-module code="org.picketbox.datasource.security.SecureIdentityLoginModule" flag="required">� 
                                <module-option name="userName" value="adobe"/>� 
                                <module-option name="password" value="-3bfaa32dfe43f65b207a6df87216de44"/>� 
                                <module-option name="managedConnectionFactoryName" value="jboss.jca:name=DefaultDS,service=LocalTxCM"/>� 
                            </login-module>� 
                        </authentication>� 
                    </security-domain>� 
              <security-domain name="EncryptDBPassword_IDP_DS">� 
                        <authentication>� 
                            <login-module code="org.picketbox.datasource.security.SecureIdentityLoginModule" flag="required">� 
                                <module-option name="userName" value="adobe"/>� 
                                <module-option name="password" value="-3bfaa32dfe43f65b207a6df87216de44"/>� 
                                <module-option name="managedConnectionFactoryName" value="jboss.jca:name=IDP_DS,service=LocalTxCM"/>� 
                            </login-module>� 
                        </authentication>� 
                    </security-domain>� 
            <security-domain name="EncryptDBPassword_EDC_DS">� 
                        <authentication>� 
                            <login-module code="org.picketbox.datasource.security.SecureIdentityLoginModule" flag="required">� 
                                <module-option name="userName" value="adobe"/>� 
                                <module-option name="password" value="-3bfaa32dfe43f65b207a6df87216de44"/>� 
                                <module-option name="managedConnectionFactoryName" value="jboss.jca:name=EDC_DS,service=LocalTxCM"/>� 
                            </login-module>� 
                        </authentication>� 
                    </security-domain>�
  2. Replace the bold values with values that are specific to your database.

  3. Save and close the file.

  4. Start JBoss.

9.6.3.5 Configure Integrated Security on Windows

  1. Modify the adobe-ds.xml and mssql-ds.xml files, located in [appserver root] \server\<profile_name>\deploy, to add integratedSecurity=true to the connection URL, as shown in this example:

    <connection-url>jdbc:sqlserver://<serverhost>:<port>; databaseName=<dbname>;integratedSecurity=<true></connection-url>

  2. Add the sqljdbc_auth.dll file to the Windows systems path (C:\Windows) on the computer that is running JBoss. The sqljdbc_auth.dll file is located within the Microsoft SQL JDBC 3.0 driver installation. The default location is [ SQL_root ]/sqljdbc_3.0/enu/auth/x86 for 32-bit operating systems and [SQL_root]/sqljdbc_3.0/enu/auth/x64 for 64-bit operating systems.

  3. Open the properties for the JBoss for Adobe LiveCycle ES3 service or the JBoss service that you configured, and click the Log On tab.

  4. Select This Account and type the value of a valid user account. This change is not required if you are running JBoss from the command line.

  5. Change SQL Server Security from Mixed mode to Windows Authentication only.

// Ethnio survey code removed