Installing CT-V Java Web Services (REST/SOAP) on Wildfly

Deploying CT-V REST APIs on WildFly includes the following steps:

1. Access the modules directory of WildFly (<wildfly_home>/modules).

2. Create a directory named main in the <wildfly_home>/modules/com/CTV/tmproject directory. The directories com, CTV, and tmproject should be created in the order as mentioned in the path <wildfly_home>/modules/com/CTV/tmproject.

   Note

   The JDBC drivers for the supported databases are no longer part of the CT-V package. Download the JDBC drivers compatible with your database and copy them to the <wildfly_home>/modules/com/CTV/tmproject/main directory. Refer to the below table for the download links:

   Database	Driver Name	Download Link
   MySQL	mysql-connector-j-x.x.x.jar	MySQL website
   Informix	jdbc-x.x.x.x.jar	Maven repository
   Oracle	ojdbc8-x.x.x.x.x.jar	Maven repository
   SQL Server	mssql-jdbc-x.x.x.jre8.jar	Maven repository

3. Copy the following jar files to the <wildfly_home>/modules/com/CTV/tmproject/main directory.

   • Jar files to be copied from the SafeNetTokenization/Tokenization/lib/ext directory:

     • bson-5.1.0.jar

     • c3p0-0.10.1.jar

     • jtds-1.3.1.jar

     • mchange-commons-java-0.3.1.jar

     • SafeNetTokenService-8.13.2.000.jar

     • SafeNetTVM.jar

     • TVMInformix.jar

     • TVMMySQL.jar

     • TVMOracle.jar

     • TVMSQLServer.jar

   • Jar files to be copied from the SafeNetTokenization/IngrianJCE/lib/ext directory:

     *commons-lang3-3.14.0.jar

     • commons-collections4-4.4.jar

     • gson-2.10.1.jar

     • log4j-api-2.23.1.jar

     • log4j-core-2.23.1.jar

     • CADP_for_JAVA-8.17.0.002.jar

4. Create an XML file named module.xml in the <wildfly_home>/modules/com/CTV/tmproject directory, and copy the following content to the module.xml file:

   <?xml version="1.0" encoding="UTF-8"?>
   <module xmlns="urn:jboss:module:1.1" name="com.CTV.tmproject">
   <dependencies>
   <module name="javaee.api"/>
   </dependencies>
   <resources>
   <resource-root path="SafeNetTokenService-8.17.0.002.jar"/>
   <resource-root path="SafeNetTVM.jar"/>
   <resource-root path="gson-2.10.1.jar"/>
   <resource-root path="commons-lang3-3.14.0.jar"/>
   <resource-root path="commons-collections4-4.4.jar"/>
   <resource-root path="log4j-api-2.23.1.jar"/>
   -->
   <resource-root path="log4j-core-2.23.1.jar"/>
   <resource-root path="CADP_for_JAVA-8.17.0.002.jar"/>
   <resource-root path="c3p0-0.10.1.jar "/>
   <resource-root path="jtds-1.3.1.jar"/>
   <resource-root path="mchange-commons-java-0.3.1.jar"/>
   <resource-root path="mssql-jdbc-x.x.x.jre8.jar"/>
   <!-- <resource-root path="TVMOracle.jar"/> --> <!-- Uncomment this if using Oracle
   database -->
   <!-- <resource-root path="ojdbc8-x.x.x.x.x.jar "/> --> <!-- Uncomment this if using Oracle
   database -->
   <!-- <resource-root path="TVMSQLServer.jar"/> --> <!-- Uncomment this if using SQL
   Server database -->
   <!-- <resource-root path="TVMMySQL.jar"/> --> <!-- Uncomment this if using MySQL
   database -->        
   <!-- <resource-root path="mysql-connector-java-8.x.x.jar"/> --><!-- Uncomment this
   if using MySQL database and runtime Java version is 8 or above
   <!-- <resource-root path="TVMInformix.jar"/> --> <!-- Uncomment this if using
   Informix database -->
   <!-- <resource-root path="jdbc-x.x.x.x.jar"/> --> <!-- Uncomment this if
   using Informix database -->
   <!-- <resource-root path="bson-5.1.0.jar"/> --> <!-- Uncomment this if using
   Informix database -->
   </resources>
   

5. Add the following content to the standalone.xml file.

   <global-modules>
   <module name="com.CTV.tmproject" slot="main"/>
   </global-modules>
   

   Note

   Ensure to uncomment the resource-root path for the database being used.

6. Create a directory where WildFly will be deployed. For example, CT-Vconfiguration (c:/CT-Vconfiguration).

7. Copy the following properties files to the CT-Vconfiguration directory:

   • SafeNetToken.properties and SfntDbp.properties from SafeNetTokenization/Tokenization/lib/ext.

   • CADP_for_JAVA.properties from SafeNetTokenization/CADP_for_JAVA/lib/ext.

8. Update HostName, PortNumber, DatabaseName, and DatabaseType parameters in SafeNetToken.properties file.

9. Update NAE_IP.1, NAE_Port, and Log_File parameters in the CADP_for_JAVA.properties file.

10. Edit the <wildfly_home>/bin/standalone.bat file and set the JAVA_OPTS variable for the properties files copied to the CT-Vconfiguration directory as shown here.

    set JAVA_OPTS=%JAVA_OPTS% -Dcom.safenet.SafeNetToken_Properties_Conf_Filename="c:/CT-Vconfiguration/SafeNetToken.properties" -Dcom.safenet.SfntDbp_Properties_Conf_Filename="c:/CTVconfiguration/SfntDbp.properties" - Dcom.ingrian.security.nae.CADP_for_JAVA_Properties_Conf_Filename="c:/CT-Vconfiguration/CADP_for_JAVA.properties"
    

11. Restart the WildFly server.

12. Deploy the SafeNetTokenization/Tokenization/restfulService/tmrest.war file on the WildFly server.

Deploying SOAP APIs on WildFly

Deploying CT-V SOAP APIs on WildFly includes the following steps:

1. Follow the Steps 1 through 10 as described in the section for the REST APIs.

2. Download axis2 version 1.8.2 binary distribution and extract axis2-1.8.2-war.zip to a directory referred to as <axis_home>.

3. Extract <axis_home>/axis2.war file using the following command:

   jar -xvf axis2.war
   

4. Delete the <axis_home>/axis2.war file.

5. Create SafeNetTokenizer/lib folder in the <axis_home>/WEB-INF/services directory.

6. Copy the SafeNetTokenizer.class file from SafeNetTokenization/Tokenization/lib/ext to the <axis_home>;WEB-INF/services/SafeNetTokenizer/lib directory.

7. In the <axis_home> directory create the axis2.war file by running the following command:

   jar -cvf axis2.war *
   

8. Deploy the <axis_home>/axis2.war file on the WildFly server.