CA AuthMinder UNIX Installation Guide › Deploying AuthMinder on a Single System › Performing Post-Installation Tasks › Deploying User Data Service

Deploying User Data Service

AuthMinder can access user data either from a relational database (RDBMS) or directly from an LDAP server:

You need the file arcotuds.war to deploy the User Data Service (UDS). This file is available at:

<install_location>/arcot/java/webapps/

To deploy User Data Service:

1. Install arcotuds.war in the appropriate directory on the application server.

   Note: The deployment procedure depends on the application server that you are using. Refer to your application server vendor documentation for detailed instructions.
   For example, in case of Apache Tomcat, you must deploy the WAR file at <APP_SERVER_HOME>/webapps/.

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.
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/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 Deploying Administration Console:

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

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

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

   7. Save and close the file.
4. Restart the application server.
5. Perform the following steps to verify if UDS started correctly:
   1. Navigate to the following location:

      <install_location>/arcot/logs
      

   2. Open the arcotuds.log file in any editor and locate the following lines:

      User Data Service (Version: 2.0.3)  initialized successfully. 
      

      This line indicates that UDS was deployed successfully

Note: Check and resolve if there are any FATAL and ERROR messages, and review all the WARNING messages for unexpected conditions.