_Prepare an Application Server

The User Data Service (UDS) and Administration Console are Web-based components of CA Risk Authentication. Deploy them on any of the supported application servers.
aa813test
The User Data Service (UDS) and Administration Console are Web-based components of CA Risk Authentication. Deploy them on any of the supported application servers.
Before you deploy the WAR files for these web applications on the application server, copy the files for the UDS and Administration Console to your application server. 
 
 
2
 
 
Set Java Home
The section provides the setup for Java Home environment.
 
Follow these steps:
 
  1. Verify that you set the JAVA_HOME environment variable. The JAVA_HOME must be your application server JAVA_HOME.
  2. Add %JAVA_HOME%\bin\ to the PATH variable.
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 (Windows) or libArcotAccessKeyProvider.so (Linux and Solaris Sparc) available at:
    <
    install_location
    >\Arcot Systems\
    native\<win_
    or
    _linux_
    or
    _solsparc>\<32bit_
    or
    _64bit>\
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>
    \lib\ext\. 
    <Tomcat_JAVA_HOME> 
    specifies the JAVA_HOME used by your Apache Tomcat instance.
  2. Copy ArcotAccessKeyProvider to
     <Tomcat_JAVA_HOME>
    \bin\.
  3. 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: 
      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.
  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. Click Java and Process Management. Click Class Loader.
    4. Click New.
    5. Select default Classes loaded with parent class loader first, and click OK.
    6. Click the auto-generated Class Loader ID.
    7. Click Shared Library References.
    8. Click Add and select ArcotJNI. Click Apply.
    9. Save the changes.
  5. Copy ArcotAccessKeyProvider.dll to <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.dll to 
    <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\.
    Ensure that you use the appropriate 
    <JAVA_HOME>
     used by WebLogic.
    When the following error appears while deploying applications(Arcotadmin, ArcotUDS and Sample Applications) in WebLogic 12cR1, copy the <ARCOT_HOME>/java/lib/bcprov-jdk15-146.jar to <JAVA_HOME>/jre/lib/ext directory. This JAVA_HOME should be the same as the one configured with weblogic 12cR1.
    Error: 
    "java.lang.NoSuchMethodError: org.bouncycastle.asn1.DERSequence.<init>(Lorg/bouncycastle/asn1/ASN1EncodableVector;)V"
     
  3. Log in to WebLogic Administration Console.
  4. Navigate to Deployments.
  5. Enable the Lock and Edit option.
  6. Click Install. Navigate to the directory that contains the arcot-crypto-util.jar file.
  7. Click Next.
  8. Click Next to display the Summary page.
  9. Click Finish.
  10. Activate the changes.
  11. Restart the application server.
JBoss Application Server
 
Follow these steps:
 
  1. Copy ArcotAccessKeyProvider.dll to <JBoss_JAVA_H
    OME>\jre\bin\.
    Here, <JBoss_JAVA_HO
    ME> 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 in this folder location:
    • arcot-crypto-util.jar.
    • Copy the Bouncy Castle JAR file (bcprov-jdk15-146.jar) from <install_location>\Arcot Systems\java\lib\
  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 the JDBC JAR Files to Application Server
CA Risk Authentication requires the following JDBC JAR files for the supported databases:
  •  
    Oracle:
     Oracle JDBC Driver (11.2.0.2.0)
  •  
    Microsoft SQL Server:
     MSSQL JDBC Driver (1.2.2828)
The following sections walk you through the steps for copying the JDBC JAR required for your database:
Apache Tomcat
 
Follow these steps:
 
  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 6.x and 7.x:
       
      <TOMCAT_HOME>
      \lib\
  3. Restart the server.
IBM WebSphere
 
Follow these steps:
 
  1. Log in to the WebSphere Administration Console.
  2. Click Environment, and click Shared Libraries. Do the following steps:
    1. From the Scope list, 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: 
      JDBCJAR.
    4. Specify the Classpath.
      This path 
      must
       point to the location where the 
      <Database_JAR>
       file is present and 
      must
       include the file name.
    5. Click Apply.
  3. Configure server-level class loaders, and do the following steps:
    1. Navigate to Servers, Server Types, WebSphere Application Servers.
    2. Under Application Servers, access the settings page.
    3. Click Java and Process Management. Click 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, and select JDBCJAR. Click Apply.
    9. Save the changes.
  4. Restart the application server.
Oracle WebLogic
 
Follow these steps:
 
 Oracle databases, 
skip 
this section. WebLogic supports Oracle databases 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.
  7. Click Next to display the Summary page.
  8. Click Finish.
  9. Activate the changes.
  10. Restart the application server.
JBoss Application Server
 
Follow these steps:
 
  1. Copy the JDBC JAR file to the following location on the JBOSS installation directory:
    <JBOSS_HOME>\server\default\lib\
    Here, <JBoss_JAVA_HOME> represents the JAVA_HOME used by your JBoss Application Server instance.
  2. Restart the application server.
Create Enterprise Archive Files
 
Valid on Oracle WebLogic 10.1
 
Most enterprise Application Servers support bundling the related JAR or WAR files from one vendor (Example: CA) to a single enterprise application (or archive).
As a result, all the related JARs or WARs can be deployed together, and loaded by a class loader. This archive also contains an application.xml file, which is generated automatically and describes how to deploy each bundled module.
Provide the default WAR files to deploy UDS and Administration Console. You can also change the format of these files to Enterprise ARchive (EAR) and then deploy the EAR files.
One of following subsections helps you to either generate separate EAR files for both UDS and Administration Console, or to generate a single EAR file that contains both web archives.
To create a separate EAR file each for UDS and Administration Console, 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 <
    filename.war
    >
    The preceding command generates individual EAR files that are available at:
    <
    install_location
    >\Arcot Systems\
    java
    \
    webapps
    \
To create a single EAR file that contains UDS and Administration Console Web archives, 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 preceding command generates a single EAR file that is available at:
    <
    install_location
    >\Arcot Systems\
    java
    \
    webapps
    \