Default Paths
EFT allows you to change the default the location of some of its configuration files.
-
You can specify the default location for EFT's configuration files. Any changes to the file path take effect the next time the EFT service is started. You should ensure the configuration file exists in the new location prior to restarting the service.
-
The default paths for all user- and Server-generated files rely on Windows-recommend paths.
-
In HA installations, when configuration changes are made to SSH, trusted SSL certificates, OpenPGP key materials, and AML files (Advanced Workflow Engine workflows), those files are cached locally (at the default path), and MSMQ uploads are safely synchronized to the shared config path. The other nodes then update their local cache from the central location. Thus, the central share always contains the current version of those files. When, for example, a new SSL Cert or AML file is created, the creator directly adds/modifies the files on the network share then tells the other nodes via MSMQ broadcasting that the file was modified/created and they need to update their local cache (i.e., copy the file to their local ProgramData directory).
If your existing data path is set to the same path as your EFT installation directory, then do NOT follow these steps. Instead, contact support for assistance.
To specify the file path for configuration files (local cache)
-
On the computer on which EFT is installed, as a precaution, back up EFT's configuration, and make note of the backup location:
-
In EFT Enterprise, use the Backup Configuration wizard in the administration interface.
-
-
Open the administration interface and connect to EFT.
-
On the Server tab, click the Server whose configuration settings you want to change.
-
In the right pane, click the General tab.
-
Under Server configuration settings, make note of the current path. If an error occurs, you will need to change it back to the original path. (e.g., copy and paste into a text file).
-
In the Server configuration settings box, provide the new path at which you want to store EFT's configuration files.
-
Click Apply to save the changes. A message appears indicating that you need to restart the EFT service for the changes to take effect.
-
Click OK to dismiss the message, then STOP the EFT service (NOT restart).
-
In Windows Explorer copy (do NOT move) the entire contents (files and folders) from the original path to the new path.
-
After you have copied the server configuration to the new location, start the EFT service.
-
Open the administration interface and connect to EFT.
-
Each of the Sites and other customizations should be visible. Verify that the path in Server configuration settings is the new path.
If the Server Setup wizard or Site Setup wizard appears, that means there was an error connecting to the new configuration path or you missed a step in this procedure.
To correct this, do one of the following:
-
Change the data path back to its original location and restart the EFT service.
-
- OR -
-
In EFT Enterprise, use the Migration Wizard to restore the previous configuration with the .BAK file you created in step 1, selecting Automatic Restore when prompted.
Once you've verified everything is back to the original configuration (after logging in), retry each of the steps above, making sure to carefully follow each step.
Related Topics