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

Copy Database Access Files to the Application Server

UDS and Administration Console use the following files to access the 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>\
  

You copy these files to the appropriate location on the application server where you have deployed the CA Risk Authentication components.

Apache Tomcat

To copy the files, perform the following steps:

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

   Note: Here, <Tomcat_JAVA_HOME> represents the JAVA_HOME used by your Apache Tomcat instance.

2. Copy ArcotAccessKeyProvider.dll to <Tomcat_JAVA_HOME>\jre\bin\.
3. Restart the application server.

IBM WebSphere

To copy the files, perform the following steps:

1. Log in to WebSphere Administration Console.
2. Click Environment, and click Shared Libraries.
   1. 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.

      Example: ArcotJNI.

   4. Specify the Classpath.

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

      Example: C:\Program Files\Arcot Systems\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 to save the changes.
4. Configure the server-level class loaders.
5. Navigate to Servers, Server Types, WebSphere Application Servers.
   1. Under Application Servers, access the settings page of the server.
   2. Click Java and Process Management and then click Class Loader.
   3. Click New.
   4. Select default Classes loaded with parent class loader, and click OK.
   5. Click the auto-generated Class Loader ID.
   6. On the class loader Configuration page, click Shared Library References.
   7. Click Add, select ArcotJNI, and then click Apply.
   8. Save the changes.
6. Copy ArcotAccessKeyProvider.dll to <WebSphere_JAVA_HOME>\jre\bin\.

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

7. Restart WebSphere.

Oracle WebLogic

To copy the files, perform the following steps:

1. Copy ArcotAccessKeyProvider.dll to <WebLogic_JAVA_HOME>\jre\bin\.

   Here, <WebLogic_JAVA_HOME> represents the JAVA_HOME used by your 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. Click Install and navigate to the directory that contains the arcot-crypto-util.jar file.
7. Click Next to open the Application Installation Assistant.
8. Click Next to open the Summary page.
9. Click Finish.
10. Activate the changes.
11. Restart the server.

JBoss Application Server

To copy the files, perform the following steps:

1. Copy ArcotAccessKeyProvider.dll to <JBoss_JAVA_HOME>\jre\bin\.

   Note: 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>
   

4. 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\