Advanced Properties

THE INFORMATION IN THIS ARTICLE APPLIES TO:

• EFT v8.0 and later
• Refer to the attached PDF (scroll to bottom of page) for a list and descriptions of the Advanced Properties.

DISCUSSION

In v8 and later, EFT is using a file named AdvancedProperties.JSON. Prior to version 8, EFT would read the Advanced Properties settings from the Windows Registry; when you upgrade from 7.4.x to 8.x, the registry settings in the previous version that are not using the default settings are copied to AdvancedProperties.json and then deleted from the registry.

JSON is an open-standard file format similar to XML that is human-readable and easy to edit. The JSON file contains name/value pairs or objects surrounded by " (double quotation marks). An object begins with { (left curly brace) and ends with} (right curly brace). Each name is followed by : (colon) and the value. (See an example in the procedure below.) Refer to https://tools.ietf.org/html/rfc8259#section-3 for more information about JSON files.

• AdvancedProperties.json is created for you during installation in the ProgramData folder for EFT (e.g., C:\ProgramData\Globalscape\EFT Server Enterprise). You donot have to create the file. If you change the file name, introduce a typo, or created a duplicate file with a different name, EFT will ignore it.

• EFT reads AdvancedProperties.jsonanytime the EFT server service is started.

• If you don't see the ProgramData folder, in Windows File Explorer, click View, then select the check box next to Hidden items. You could also select the check box for File name extensions to see the JSON extension.

• Before you start editing this file (if it is not blank, meaning you have non-default settings defined), please make a backup copy with a different name in case you need to roll it back.

• A JSON value MUST be an object, array, number, string, or one of the following three literal names: false, null, or true. (The literal names must be lowercase. No other literal names are allowed.)

• JSON file entries are case sensitive. You must enter the format as expected, otherwise the EFT service will fail to start.

• EFT doesn't validate the JSON file itself for acceptable or unacceptable names and values. It only reads names and validates their values.

  • If the "value" is wrong or malformed, the EFT server service will not start, and an error is written to the log.

  • If the Advanced Property name is misspelled, it is ignored, but the service will start. That is, if EFT was expecting for "EncryptPersonalData" but you spelled it "EncryptPersonelData" EFT will ignore it.

To edit or view the Advanced Properties file

1. Navigate to the EFT installation folder, then open AdvancedProperties.json in a text editor (such as Notepad). In a new installation of EFT, or in an upgrade with only default EFT-related registry settings defined, the file will be blank, except for two curly brackets: {}

If you are upgrading from a prior version with non-default registry settings, EFT will import them and you can view them in the JSON file.

2. As shown above, to add a new name/value pair:

1. Add a new line after the opening bracket.

2. Type the name of the object, with the name surrounded by double quotation marks, followed by a colon (:), then a space, then the value. Strings must be enclosed in quotation marks; numbers and literal names (false, null, or true) do not need quotation marks. (See screenshot above.)

3. For multiple objects, add a comma before the next object.

4. Add a new line after the name/value pair, before the closing bracket.

3. Save the file.

4. Stop and restart the EFT server service, and then refresh the user database (View > Refresh User Database).

FAQ

1. If a I have (for example) 100 EFT-related registry settings in EFT v7.4.13, then decide to upgrade to v8.x do my EFT registry settings become ineffective?
   No. The existing registry settings that are non-default values are migrated to the JSON file and then deleted from the registry. EFT will still read the registry, but it's recommend that you only add new items to the JSON file instead of the registry.

2. Do I have to recreate/reenable each of my EFT registry settings in the JSON file?
   Upon upgrade to EFT v8.x, any EFT registry entry that is configured as a non-defaultvalue will be migrated to the JSON file. Anything that is configured with a default value (the equivalent of it not being enabled) will be ignored and not added to the JSON file.

3. Do I have to remove the old registry settings?
   Upon upgrade from 7.4.x to EFT v8.x, any registry entry that is migrated to the JSON file will be removed from the registry.

4. Are the advanced properties logged in EFT.log?
   Only non-default advanced properties are logged.

5. Is JSON file backup/restore supported?
   Yes.