CA Risk Authentication UNIX Installation Guide › How to Deploy CA Risk Authentication on Distributed System › How to Prepare the Application Server › Copy Database Access Files to Application Server

Copy Database Access Files to Application Server

UDS and Administration Console use the following files to access the CA Risk Authentication database securely:

• arcot-crypto-util.jar available at:

  <install_location>\Arcot Systems\java\lib\
  

• ArcotAccessKeyProvider.dll available at:

  <install_location>\Arcot Systems\native\win\<32bit-or-64bit>\
  

As a result, copy these files to the appropriate location on the application server where you have deployed the CA Risk Authentication components. The following subsections provide information about copying these files for:

Apache Tomcat

Follow these steps:

1. Copy arcot-crypto-util.jar to <Tomcat_JAVA_HOME>\jre\lib\ext\.

   <Tomcat_JAVA_HOME>

   Specifies the JAVA_HOME used by your Apache Tomcat instance.

2. Copy ArcotAccessKeyProvider.so to one of the following location:
   • For Solaris: Tomcat_JAVA_HOME/jre/bin/
   • For RHEL: Tomcat_JAVA_HOME/jre/bin/
3. Set and export the LD_LIBRARY_PATH to the directory where the libArcotAccessKeyProvider.so file is copied.
4. Restart the application server.

IBM WebSphere

Follow these steps:

1. Log in to WebSphere Administration Console.
2. Click Environment, and click Shared Libraries.
   1. From the Scope drop-down, select a valid visibility scope. Include the target server or node on which the application is deployed.
   2. Click New.
   3. Enter the Name.

      Example: ArcotJNI.

   4. Enter the Classpath.

      This path must point to the location where the arcot-crypto-util.jar file is present and must also include the file name.

      Example: nstall_location/arcot/java/lib/arcot-crypto-util.jar.

   5. Enter the JNI Library path.

      This path must point to the location where the ArcotAccessKeyProvider.dll file is present.

3. Click Apply.
4. Configure the server-level class loaders.
   1. Navigate to Servers, Server Types, WebSphere Application Servers.
   2. Under Application Servers, access the settings page of the server.
   3. Select Java and Process Management. Select Class Loader.
   4. Select New.
   5. Select default Classes loaded with parent class loader first, and click OK.
   6. Select the auto-generated Class Loader ID.
   7. Select Shared Library References.
   8. Select Add and select ArcotJNI. Click Apply.
   9. Save the changes.
5. Copy ArcotAccessKeyProvider.so to one of the following location:
   • For Solaris: WebSphere_JAVA_HOME/jre/bin/
   • For RHEL: WebSphere_JAVA_HOME/jre/bin/

   Here, <WebSphere_JAVA_HOME> represents the JAVA_HOME used by your IBM WebSphere instance.

6. Restart the application server.

Oracle WebLogic

Follow these steps:

1. Copy ArcotAccessKeyProvider.so to one of the following location:
   • For Solaris: WebLogic_JAVA_HOME/jre/bin/
   • For RHEL: WebLogic_JAVA_HOME/jre/bin

   Here, <Weblogic_JAVA_HOME> represents the JAVA_HOME used by the Oracle WebLogic instance.

2. Copy arcot-crypto-util.jar to <WebLogic_JAVA_HOME>\jre\lib\ext\.

   Note: Ensure that you use the appropriate <JAVA_HOME> used by WebLogic.

3. Log in to WebLogic Administration Console.
4. Navigate to Deployments.
5. Enable the Lock and Edit option.
6. Select Install. Navigate to the directory that contains the arcot-crypto-util.jar file.
7. Press Enter.
8. Press Enter to display the Summary page.
9. Select Finish.
10. Activate the changes.
11. Set and export the LD_LIBRARY_PATH to the directory where the libArcotAccessKeyProvider.so file is copied.
12. Restart the application server.

JBoss Application Server

Follow these steps:

1. Copy libArcotAccessKeyProvider.so to:
   • For RHEL: JBoss_JAVA_HOME/jre/bin/

   Here, JBoss_JAVA_HOME represents the JAVA_HOME used by your JBoss Application Server instance.

2. Create a folder structure as <JBOSS_HOME>\modules\advauth-admin-libs\main\ and copy the following JARs from <ARCOT_HOME>\java\lib to this folder:
   • arcot-crypto-util.jar.
   • bcprov-jdk15-146.jar
3. Create a file with the name module.xml in the same folder location (<JBOSS_HOME>\modules\advauth-admin-libs\main\) with the following codes:

   <?xml version="1.0" encoding="UTF-8"?>
   <module xmlns="urn:jboss:module:1.1" name="advauth-admin-libs">
   <resources>
   <resource-root path="arcot-crypto-util.jar"/> 
   <resource-root path="bcprov-jdk15-146.jar"/> 
   </resources>
       <dependencies>
           <module name="javax.api"/>
       </dependencies>
   	              </module>
   

Restart the application server.

Copy JDBC JAR Files to the Application Server

CA Risk Authentication requires the following JDBC JAR files for the supported databases:

• Oracle 10g: Oracle JDBC Driver (10.2.0.1.0)
• Oracle 11g: Oracle JDBC Driver (11.2.0.2.0)
• Microsoft SQL Server: MSSQL JDBC Driver (1.2.2828)
• MySQL: MySQL JDBC Driver (5.1.22)

The following sections walk you through the steps for copying the JDBC JAR required for your database to the following application server:

Apache Tomcat

To copy the required JDBC JAR file, do the following:

1. Navigate to the location where you have downloaded the <Database_JAR> file.
2. Copy the <Database_JAR> file to the following directory:
   • On Apache Tomcat 5.5.x: <TOMCAT_HOME>\common\lib\
   • On Apache Tomcat 6.x and 7.x: <TOMCAT_HOME>\lib\
3. Restart the application server.

IBM WebSphere

To copy the required JDBC JAR file do the following:

1. Log in to the WebSphere Administration Console.
2. Click Environment, and click Shared Libraries. Perform the following steps:
   1. From the Scope list, select a valid visibility scope. The scope must include the target server or node on which the application is deployed.
   2. Click New.
   3. Enter the Name, say, JDBCJAR.
   4. Specify the Classpath.

      Important! This path must point to the location where the <Database_JAR> file is present and must include the file name.

   5. Click Apply.
3. To configure server-level class loaders, do the following steps:
   1. Navigate to Servers, Server Types, WebSphere Application Servers .
   2. Under Application Servers, access the settings page of the server for which the configuration is performed.
   3. Click Java and Process Management, and Class Loader.
   4. Click New.
   5. Select default Classes loaded with parent class loader first.

      Click OK.

   6. Click the auto-generated Class Loader ID.
   7. Click Shared Library References.
   8. Click Add, select JDBCJAR, and click Apply.
   9. Save the changes.
4. Restart the application server.

Oracle WebLogic

To copy the required JDBC JAR file do the following steps:

Note: If you are using Oracle database, then do not perform the configurations that are mentioned in this section, because WebLogic supports Oracle database by default.

1. Copy the <Database_JAR> file to <Weblogic_JAVA_HOME>\lib\ext\.

   Here, <WebLogic_JAVA_HOME> represents the JAVA_HOME used by your Oracle WebLogic instance.

2. Log in to the WebLogic Administration Console.
3. Navigate to Deployments.
4. Enable the Lock and Edit option.
5. Click Install and navigate to the directory that contains the required <Database_JAR> file.
6. Click Next to display the Application Installation Assistant page.
7. Click Next to display the Summary page.
8. Click Finish.
9. Activate the changes.
10. Restart the application server.

JBoss Application Server

To copy the required JDBC JAR file, do the following steps:

Follow these steps:

1. Create a folder structure as <JBOSS_HOME>\modules\advauth-jdbc-driver\main\ and copy JDBC Jar file in this folder location.
2. Create a file in with the name module.xml at the following location: <JBOSS_HOME>\modules\advauth-jdbc-driver\main\
3. Add the following codes to the file:

   <?xml version="1.0" encoding="UTF-8"?>

   <module xmlns="urn:jboss:module:1.1" name="advauth-jdbc-driver">
   <resources>
   <resource-root path="<JDBC Jar Name>"/>
   </resources>
       <dependencies>
           <module name="javax.api"/>
   <module name="javax.transaction.api"/>
       </dependencies>
   </module>
   

4. Edit the tag ‘<JDBC Jar Name>’with JDBC Jar file name.

   Example:sqljdbc.jar

Restart the application server.

Create Enterprise Archive Files

Valid on Oracle WebLogic 10.1

By default, WAR files are provided to deploy UDS and Administration Console. If necessary, you can also change the format of these files to Enterprise ARchive (EAR) and then deploy the EAR files.

You can generate separate EAR files for both UDS and Administration Console, or you can generate a single EAR file that contains both Web archives.

Generate Separate EAR Files

Follow these steps:

1. Open the Command Prompt window.
2. Navigate to the <install_location>\Arcot Systems\tools\common\bundlemanager\ directory.
3. To create the EAR file, run the following command:

   java -jar bundle-manager.jar -ear <filename.ear> -warList <filename.war>
   

   The command generates individual EAR files that are available at:

   <install_location>\Arcot Systems\java\webapps\
   

Generate a Single EAR File

Do the following steps:

1. Open the Command Prompt window.
2. Navigate to the <install_location>\Arcot Systems\tools\common\bundlemanager\ directory.
3. To create the EAR file, run the following command:

   java -jar bundle-manager.jar -ear <filename.ear> -warList arcotadmin.war arcotuds.war
   

   The command generates a single EAR file that is available at:

   <install_location>\Arcot Systems\java\webapps\