Installation
This section covers the following topics:
CipherTrust Vaulted Tokenization Package Details
CT-V Bulk Utility is distributed along with the CT-V Package archive file in zip format. Extracting the archive creates the SafeNetTokenization directory, which contains IngrianJCE and Tokenization directories. The following tables describe the contents of the IngrianJCE and the Tokenization directories.
Tip
Be sure to explore the samples directory! CT-V includes many items in the SafeNetTokenization/Tokenization/samples directory to simplify the installation, build, and preparation of the samples.
The IngrianJCE/lib/ext directory contains the following files:
| Filename | Description |
|---|---|
| Ingrianlog4j-api-2.10.0.jar | Thales log4j logging application. Required for all installations. |
| Ingrianlog4j-core-2.10.0.jar | Thales log4j logging application. Required for all installations. |
| commons-lang3-3.1.jar | Apache Commons reusable Java components. Lang provides methods for manipulation of core classes in the standard Java library, utilities for the java.lang API, and helps with building methods, such as hashCode to String and equals. |
| commonscollections4-4.1.jar | Apache Commons reusable Java components. Extends or augments the Java Collections Framework. |
| gson-2.1.jar | A java library to convert JSON to Java objects and vice versa. |
| guava-20.0.jar | Library used for key caching. |
| IngrianNAE-8.12.2.000.jar | The Java components of the CADP JCE Provider. Required for all installations. |
| IngrianNAE.properties | Contains the parameters used by the CADP JCE Provider. Controls logging level, log file location, communication with the Key Manager, among other features. |
The Tokenization/doc directory contains the javadoc for CT-V, which gives a complete description of all of its public classes and methods.
The Tokenization/lib/ext directory contains the following files:
| Filename | Description |
|---|---|
| c3p0-0.9.5.4.jar | Library used to augment jdbc drivers with JNDI-bindable DataSources, including DataSources that implement connection and statement pooling. Required for all installations. |
| detokenization.properties | Contains the parameters used to set up the detokenization feature. |
| migration.properties | Contains the parameters used to set up the bulk migration feature using the token vault. |
| masking.properties | Contains the parameters used to set up the bulk migration feature without using the token vault. |
| MultiSite.properties | Contains the parameters used to configure the multi-site feature. |
| mysql-connector-java-5.1.42-bin.jar | The MySQL JDBC driver. Required when the token vault resides on an MySQL database and CT-V Java runtime environment version is 7. |
| mysql-connector-java-5.1.48.jar | The MySQL JDBC driver. Required when a token vault resides on MySQL database and CT-V Java runtime environment version is 8 or above. |
| ojdbc7.jar | The Oracle JDBC driver. Required when the token vault resides on an Oracle database. |
| SafeNetToken.properties | Contains the parameters used by the CT-V. Required for all installations. |
| SafeNetTokenService-8.12.3.000.jar | The Java components of the CT-V. Required for all installations. |
| services.xml | The services.xml file for Axis2. |
| SfntDbp.properties | Contains the following database connection pooling parameters used by c3p0 for local database settings. Required for all installations. • com.mchange.v2.log.MLog • com.mchange.v2.log.FallbackMLog.DEFAULT_CUTOFF_LEVEL • c3p0.initialPoolSize • c3p0.maxStatementsPerConnection • c3p0.acquireRetryAttempts • c3p0.checkoutTimeout • breakAfterAcquireFailure • testConnectionOnCheckin • c3p0.minPoolSize • c3p0.maxPoolSize • c3p0.maxIdleTime Click here to find details of the C3p0 settings. Note: • When these parameters are enabled, the DatabaseRetryTime parameter of SafeNetToken.properties file gets enabled, which allows the CT-V to retry the connection to a database server only after 120seconds of first failure.• These properties have been moved from the SafeNetToken.properties.• These properties have been moved from the SafeNetToken.properties file.• Applying any property, other than the ones mentioned above, are ignored. • c3p0 logging related property ( com.mchange.v2.log) can be set only once. |
| SilentInstallation.properties | Contains the parameters used to configure the silent installation of CT-V for Java API and Web Services. |
| sqljdbc41.jar | The SQL Server JDBC driver. Requires when the token vault resides on an MS SQL Server database. |
| TokenizationInstaller-8.12.3.000.jar | The installation program for the CT-V. Required for all installations. (But not required after installation.) |
| TVMMySQL.jar | Contains classes needed to communicate with a MySQL database. |
| TVMOracle.jar | Contains the classes needed to communicate with an Oracle database. |
| TVMSQLServer.jar | Contains the classes needed to communicate with a SQL Server database. |
| TVMInformix.jar | Contains the classes needed to communicate with Informix database. |
| unicode.properties | Contains the parameters used by CT-V to recognize and apply Unicode characters. |
| Utility.properties | Contains the properties to run the SearchPurgeUtility. |
Installing Bulk Utility
There is no explicit installation required for CT-V Bulk Utility, it gets installed along with CT-V.
Refer to CT-V Installation for details.
To configure the IngrianNAE.properties file, refer to Configuring NAE Properties File.
