CA RiskMinder UNIX Installation Guide › Deploying RiskMinder On a Single System › Performing Post-Installation Tasks › Deploying User Data Service (UDS)

Deploying User Data Service (UDS)

RiskMinder can access user data either from a relational database (RDBMS) or directly from an LDAP server by using UDS, which is an abstraction layer that provides RiskMinder seamless access to the third-party data repositories deployed by your organization.

To deploy UDS:

1. Change the working directory to:

   install_location/arcot/sbin/
   

2. Type source arrfenv and press Enter to set the required environment variables.
3. Deploy arcotuds.war on the application server. This file is available at:

   install_location/arcot/java/webapps/
   

   For example, in the case of Apache Tomcat, deploy the WAR file at APP_SERVER_HOME/webapps/.

   Note: The deployment procedure depends on the application server that you are using. See the application server vendor documentation for detailed instructions.

4. (For WebSphere Only) Configure to reload the UDS class when the application files are updated.
   1. Navigate to Application, Enterprise Applications and access the UDS settings page.
   2. Under Class loader order, select the Classes loaded with local class loader first (parent last) option.
   3. Under WAR class loader policy, select the Single class loader for application.
   4. Click Apply.
5. (For JBoss Only) Perform the following steps if you have deployed UDS on a JBoss application server:
   1. Copy the Bouncy Castle JAR file (bcprov-jdk15-146.jar) from install_location/arcot/java/lib/ to the following location:

      JBOSS_HOME/common/lib/
      

   2. Navigate to the following location:

      JBOSS_HOME/server/default/conf/
      

   3. Open jboss-log4j.xml file in a text editor.
   4. Add the following log configuration in the <log4j:configuration> section:

      <appender name="arcotudslog" class="org.apache.log4j.RollingFileAppender">
      <errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"></errorHandler>
      <param name="Threshold" value="INFO"/>
      <param name="MaxFileSize" value="10MB"/>
      <param name="MaxBackupIndex" value="100"/>
      <param name="Encoding" value="UTF-8"/>
      <param name="Append" value="true"/>
      <param name="File" value="${arcot.home}/logs/arcotuds.log"/>
      <layout class="org.apache.log4j.PatternLayout">
      <param name="ConversionPattern" value="%d{yyyy-MM-dd hh:mm:ss,SSS z} : [%t] : %-5p : %-5c{3}(%L) : %m%n"/>
      </layout>
      <filter class="org.jboss.logging.filter.TCLMCFilter">
      <param name="AcceptOnMatch" value="true"/>
      <param name="DeployURL" value="arcotuds.war"/>
      </filter>
      <!-- end the filter chain here -->
      <filter class="org.apache.log4j.varia.DenyAllFilter"></filter>
      </appender>
      

   5. Add the following line in the com.arcot category that you created while Deploying Administration Console:

      <appender-ref ref="arcotudslog"></appender-ref>
      

   6. Add the following line in the cryptographic category that you created while Deploying Administration Console:

      <appender-ref ref="arcotudslog"></appender-ref>
      

   7. Save and close the file.
6. Restart the application server.
7. Verify if UDS was deployed successfully:

   Note: The arcotuds.log file is used for logging UDS-related information.

   1. Navigate to the following location:

      install_location/arcot/logs/
      

   2. Open the arcotuds.log file in any editor and locate the following line:
      • User Data Service (Version: 2.0.3) initialized successfully.

      This line indicates that UDS was deployed successfully.

   3. Also ensure that the log files do not contain any FATAL and WARNING messages.
   4. Close the file.