Deploying CT-V REST APIs on Oracle WebLogic 12c Server

Deploying CT-V REST APIs on the Oracle WebLogic 12c Server includes the following steps:

1. Updating the JAVA_HOME files

2. Configuring CT-V Related Files

3. Recreating the tmrest.war file

   Note

   If CT-V is already installed on the Oracle WebLogic 12c Server, remove all the instances of previously installed CT-V from the JAVA_HOME location of the Oracle WebLogic 12c Server.

Updating the JAVA_HOME Files

Follow the steps described here to update the JAVA_HOME files:

1. Copy the following files from the /SafeNetTokenization/IngrianJCE/lib/ext directory to the /JAVA_HOME/jre/lib/ext location. These files are used by the Oracle WebLogic 12c Server:

   • commons-lang3-3.1.jar

   • commons-collections4-4.1.jar

   • gson-2.1.jar

   • Ingrianlog4j-api-2.10.0.jar

   • Ingrianlog4j-core-2.10.0jar

   • IngrianNAE.properties

   • IngrianNAE-8.12.2.000.jar

2. Update the following parameters of the IngrianNAE.properties file:

   • NAE_IP.1: <IP address of the Key Manager>

   • NAE_PORT: 9000

   • Log_File: <Path of the log file with required permissions>

Configuring CT-V Related Files

Follow the steps described here to configure CT-V specific files:

1. Create a myconfig folder at location, where is the Oracle WebLogic home directory, such as C:/Oracle/Middleware/Oracle_Home.

2. Copy the following files from the /SafeNetTokenization/Tokenization/lib/ext directory to the <wl_home>/myconfig location:

   • SafeNetToken.properties

   • SfntDbp.properties

3. Update the following parameters of the SafeNetToken.properties file:

   • HostName: <IP address of the database>

   • Port Number: <Port number of the database server>

   • DatabaseType: <Type of the database to be used; for example, Oracle>

   • DatabaseName: <Database instance>

4. Open the setDomainEnv file located at <wl_home>/user_projects/domains/<Your_domain_name>/bin and update

   "set JAVA_PROPERTIES=-Dwls.home=%WLS_HOME% -Dweblogic.home=%WLS_HOME%" to "set JAVA_PROPERTIES=-Dwls.home=%WLS_HOME% -Dweblogic.home=%WLS_HOME% -Dcom.safenet.SfntDbp_Properties_Conf_Filename=C:/Oracle/Middleware/Oracle_Home/myconfig/SfntDbp.properties -Dcom.safenet.SafeNetToken_Properties_Conf_Filename=C:/Oracle/Middleware/Oracle_Home/myconfig/SafeNetToken.properties"
   

Recreating the tmrest.war File

Follow the steps described here to recreate the tmrest.war file:

1. Extract the existing tmrest.war file from SafeNetTokenization\Tokenization\restfulService to any user location using the following command:

   jar -xvf tmrest.war
   

   The following screen displays the extracted location of the tmrest.war file:

   Note

   • If Java runtime environment version is 8 or above, then copy the mysql-connector-java-5.1.48.jar file from the /SafeNetTokenization/Tokenization/lib/ext directory to the /WEB-INF/ lib folder.

   • For MySQL 8.0, the Java runtime environment version must be 8 or above.

2. Copy the following files from the /SafeNetTokenization/Tokenization/lib/ext directory to the / WEB-INF/lib folder extracted in the preceding step.

   -	-	-
   bson-2.5.1.jar	MultiSite.properties	SilentInstallation.properties
   c3p0-0.9.5.4.jar	mysql-connector-java-5.1.42-bin.jar or mysql- connector-java-5.1.48.jar	sqljdbc41.jar
   detokenization.properties	ojdbc7.jar	TVMInformix.jar
   jdbc-4.10.6.20151104.jar	oraclepki.jar	TVMMySQL.jar
   jtds-1.2.8.jar	osdt_cert.jar	TVMOracle.jar
   masking.properties	osdt_core.jar	TVMSQLServer.jar
   mchange-commons-java-0.2.11.jar	SafeNetTokenService-8.12.4.000.jar	unicode.properties
   migration.properties	SafeNetTVM.jar

3. Navigate to the extracted location and create the tmrest.war file using the following command:

   jar –cvf tmrest.war *
   

4. Deploy the tmrest.war file on the Oracle WebLogic 12c Server.

   Note

   For details on the usage of the CT-V REST APIs, refer to CipherTrust Vaulted Tokenization REST APIs.