Modifying Configuration of Business Logic Tier (BLT) Components

You can modify the configuration of Business Logic Tier (BLT) components belonging to a BLTHost application. These settings are saved in the JSON file format, and are installed to %DNAInstallRoot%\<Application>\Config\BLT, where <Application> is the name of an application (for example, RealTime). Do not modify configuration settings in the %DNAInstallRoot% directory. Instead, you must define override settings in the %DNADataRoot% directory, as detailed below. For information on modifying JSON files associated with configuration settings, refer to Modifying Configuration Settings.

To modify configuration settings

Note: In the procedure that follows, the JSON file you place and customize in the %DNADataRoot% directory is an override file: any keys defined will override those in the %DNAInstallRoot% directory. As a result, only include settings you wish to override.

1. Locate the JSON file containing the settings you want to modify in %DNAInstallRoot%\<Application>\config\BLT (the install root).

2. Check if the JSON file already exists in %DNADataRoot%\<Application>\Config\BLT (the data root) and do one of the following:

   • If the JSON file already exists, proceed to step 3.

   • If the JSON file doesn't already exist, proceed to step 4.

3. Proceed as follows:

   1. Do not overwrite the existing JSON file in the data root.

   2. Check if the key-value pair you want to modify already exists in the JSON file located at the data root.

   3. If the key-value pair you want to modify already exists in the JSON file located at the data root, do nothing.

   4. If the key-value pair you want to modify does not already exist in the JSON file located at the data root, copy the item from the install root file and paste it into the file at the data root.

   5. Do not proceed to step 4.

4. Proceed as follows:

   1. Copy and paste the JSON file whose settings you want to modify from the install root to the data root.

   2. In the JSON file located at the data root, remove all key-value pairs whose values you don't want to modify.

      You can remove whole JSON objects within the file if none of the key-value pair values you want to modify are contained therein.

Example 1: JSON file doesn't already exist at the data root

Currently on install root:

{

"bobjArchiveSupport.dll": {

"Archive": [ "DNA Permission - View" ],

"Cleanup": [ "DNA Permission - View" ],

"Dearchive": [ "DNA Permission - View" ],

"Initialization": [ "DNA Permission - View" ]

}

}

Currently on data root:

Nothing.

You want to modify the Cleanup key's value, so the JSON file on the data root will be:

{

"bobjArchiveSupport.dll": {

"Cleanup": [ "DNA Permission - Supervise_SCADA" ],

}

}

Example 2: JSON file already exists at the data root

Currently on install root:

{

"bobjArchiveSupport.dll": {

"Archive": [ "DNA Permission - View" ],

"Cleanup": [ "DNA Permission - View" ],

"Dearchive": [ "DNA Permission - View" ],

"Initialization": [ "DNA Permission - View" ]

}

}

Currently on data root:

{

"bobjArchiveSupport.dll": {

"Initialization": [ "DNA Permission - Supervise_SCADA" ]

}

}

You want to modify the Cleanup key's value, so the JSON file on the data root will be:

{

"bobjArchiveSupport.dll": {

"Cleanup": [ "DNA Permission - Supervise_SCADA" ],

"Initialization": [ "DNA Permission - Supervise_SCADA" ]

}

}

Notes: A null or empty ([]) permission list disables the BLT (that is, it will be neither loaded nor accessible).

The component name does not require the bobj prefix.