Skip to main content

Appendix C: Installation and Configuration for Enscribe Files

PK Protect supports detection on Enscribe Files. For this purpose, we need Files IDP to be installed on tandem environment. Controller will be on a remote machine.


Pre-requisites for files IDP installation:

  1. LocalFilesAgent_x.x.x.x.x.tar and should be available on the Tandem box.

  2. There should be a two-way connectivity between Tandem box and the remote machine where the controller is installed.


Perform the below steps to install the Files IDP for Enscribe Files.

  1. Connect to the Tandem OSS and go to the location where the above tar and Korn shell file exists.

  2. Provide execution rights to the Korn shell file and invoke it . Run to start the installation.

  3. Accept the license agreement and select the following options:

    1. Installation path

    2. Path of LocalFilesAgent_8.x.x.x.x.tar

    3. Path of tdmext.jar

  4. Enable SSL

  5. Controller ID

  6. Click enter to complete the installation by untarring the tar file at the specified installation path. This would automatically set filesystem.type property in to non-stop.


Below are the configuration settings to support detection on Enscribe files.

  1. Open file located at …/DgSecure/Agents/LocalFilesAgent/ and add -Xmx16g -Xms4g -d64 to the java options.

    For example,
    JavaOptions=-Dlog4j.configurationFile=./expandedArchive/WEB-INF/classes/log4j2.xml -Xmx16g -Xms4g -d64.

    *Note:  The Xmx/Xms values will be determined based on the Tandem box configuration and can be changed.

  2. Open ‘’ file located at ‘…/DgSecure/Agents/LocalFilesAgent/expandedArchive/WEB-INF/classes/’ and update the property nonstop.datadictionary.path=<Location of the data dictionary>.

    Also Update the property enscribe.reporting.level=F (default value). This property denotes the Field Name Prefix Level. The value for this property can be one out of three values, F (Only field name), G (Group name + Field name), and R (Full qualified field name).

  3. Update ‘file_mapping’ file located at ‘…/DgSecure/Agents/LocalFilesAgent/expandedArchive/WEB-INF/classes/structure_info/enscribe/’. This file contains the mapping of a fixed layout enscribe file to its layout in the data dictionary. The entries need to be done in the following format.

    Physical File-Name Name or Wildcard (req'd)||Dictionary Layout Name (req'd)||Logical Name (opt)

  4. Restart the IDP.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.