CA RiskMinder Windows Installation Guide › Deploying RiskMinder on a Distributed System › Performing Post-Installation Tasks on the First System › 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.

You need the arcotuds.war file to deploy UDS, as follows:

1. Deploy arcotuds.war on the application server. This file is available at:

   <install_location>\Arcot Systems\java\webapps\
   

   For example, in the case of Apache Tomcat, you must 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.

2. (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 to save the changes.
3. (For JBoss Only) Perform the following steps if you have deployed UDS on JBoss application server:
   1. Copy the Bouncy Castle JAR file (bcprov-jdk15-146.jar) from <install_location>\Arcot Systems\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 in Step  of "Deploying Administration Console" section:

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

   6. Add the following line in the cryptographic category that you created in Step  of "Deploying Administration Console" section:

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

   7. Save and close the file.
4. Restart the application server.
5. 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 Systems\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.