Adding and Modifying Resources Directories
(Non-FME Cloud customers only.) You can change the location of Resources directories, or add new top-level directories. Newly-created directories appear with existing ones at the top level of the Resources page.
On Windows, the default location of the Resources folders are C:\ProgramData\Safe Software\FME Server\resources.
C:\ProgramData is the default value of the %ALLUSERSPROFILE% environment variable. If this location is modified, the location specified above is modified accordingly.
On Linux, the Backup, Data, Logs,and Temp folders are located directly under the root directory of your FME Server installation (<FMEServerDir>). The Engine folder references the following location: <FMEServerDir>\Resources\shared.
When performing a backup and restore, shared resource directories containing large amounts of data require considerable time to back up, and result in large configuration files. We recommend defining large directories as non-migratable (false). For information about migrating large resource directories, see Backup & Restore.
For information on troubleshooting shared resources, see fmesharedresource.log.
To Add or Modify Top-Level Resources Folders
- Open the FME Server configuration file at <FMEServerDir>Server\fmeServerConfig.txt.
- Under FME SERVER SETTINGS START > Shared Resource Management, add your own shared resource definition, using the following syntax:
ConfigNumber
: Shared resource configurations are sequential, beginning with 1. For example, if you are adding a new configuration to the existing set of five default configurations, specify 6.Name
: Specify a unique name for the configuration.DisplayName
: Specify how you want the name of the configuration to display on the Resources page.Description
: Provide a description of the configuration.Migratable
: If true, the folder is migrated during an FME Server backup and restore operation. If false, the folder is not migrated. If not specified, this parameter is assumed to be false (not migrated).Directory
: The shared resource path, using either LFS or UNC syntax.defaultRoleName
: If not specified, all available roles are granted access to the shared resource. Otherwise, only the specified roles are granted access. Separate multiple roles with a pipe (|).- If the FME Engines require direct access to the shared resource (for example, a workspace run by the Job Submitter service, rather than using the Data Upload Service to supply the resource), you must also add an entry for the shared resource definition to fmeEngineConfig.txt (also located in <FMEServerDir>Server\). This entry must be added on the machine that hosts the FME Server Core, as well as any other machines on which FME Engines are installed.
- Restart the FME Server Core and FME Server Engines services.
SHAREDRESOURCE_TYPE_<ConfigNumber>=FILE
SHAREDRESOURCE_NAME_<ConfigNumber>=<Name>
SHAREDRESOURCE_DISPLAYNAME_<ConfigNumber>=<DisplayName>
SHAREDRESOURCE_DESCRIPTION_<ConfigNumber>=<Description>
(Optional)SHAREDRESOURCE_ISMIGRATABLE_<ConfigNumber>=<Migratable>
SHAREDRESOURCE_DIR_<ConfigNumber>=<Directory>
(Optional)SHAREDRESOURCE_SECURITY_DEFAULT_ROLES_<ConfigNumber>=<defaultRoleName>
Parameters
Escape backslashes with an extra backslash. For example, instead of SHAREDRESOURCE_DIR_6=f:\, specify SHAREDRESOURCE_DIR_6=f:\\.
File Example
This example creates a shared resource folder called SERVER_TEMP (displayed as 'Server Temp') on the local C:\ drive. It is not migratable. Only users belonging to the fmeadmin role can access it.
SHAREDRESOURCE_TYPE_6=FILE
SHAREDRESOURCE_NAME_6=SERVER_TEMP
SHAREDRESOURCE_DISPLAYNAME_6=Server Temp
SHAREDRESOURCE_DESCRIPTION_6=This shared resource is for temporary files
SHAREDRESOURCE_ISMIGRATABLE_6=false
SHAREDRESOURCE_DIR_6=C:/Server/Temp/
SHAREDRESOURCE_SECURITY_DEFAULT_ROLES_6=fmeadmin
File Example Specifying a UNC path
This example creates a shared resource folder called FME_SHAREDRESOURCE_UNCDATA (displayed as 'UNC Data') on a network share. It is not migratable. Any user can access it.
SHAREDRESOURCE_TYPE_7=FILE
SHAREDRESOURCE_NAME_7=FME_SHAREDRESOURCE_UNCDATA
SHAREDRESOURCE_DISPLAYNAME_7=UNC Data
SHAREDRESOURCE_DESCRIPTION_7=This is a UNC data folder
SHAREDRESOURCE_ISMIGRATABLE_7=false
SHAREDRESOURCE_DIR_7=//servername/Data/
Use the following syntax:
MACRO_DEF <Name> "<Directory>"
Example:
MACRO_DEF SERVER_TEMP "C:/Server"
Example (specifying a UNC path):
MACRO_DEF FME_SHAREDRESOURCE_UNCDATA "//servername/Data/"