Besides the Application Server Database, the Application Server also uses the local file system for storing and reading data. With the exception of the Binary directory all data stored on the file system is reproducible i.e. needs no backup. Table 1 shows directories used by the Application Server.
Directory |
Description |
If not changed during installation the application server directory is <ProgramFiles>\Redbex\Application Server\ All executable files some configuration files and other accompanying files are installed here. <ProgramFiles> is a Windows special folder that is usually points to something like C:\Program Files. The Windows environment variable %ProgramFiles% can be evaluated to show the location of this special folder. Type echo %ProgramFiles% in a console window. |
|
Used for storing binary data. This directory must be backed up together with the Application Server Database for a full backup. Depending on your usage of Redbex this directory might contain a large volume of files and may grow to huge size. Contents of this directory need to be included in your Backup! |
|
Directory where the Application Server will cache data for faster data retrieval. This data needs no backup since it is just a temporary copy of data stored in the Application Server Database. |
|
Directory where log files are stored if you use the default logging configuration. On start up the Application Server will delete all files in this folder older than 10 days. |
|
Directory where modules that extend the Application Servers functionality are stored. The Application Server will create sub directories in this directory as needed. |
|
Directory where optional logs are stored. The user can decide if optional logs will be written or not from within Redbex. Optional logs like the data change log can grow to huge sizes. |
|
Folder where the Application Server will store temporary data. This folder needs no backup. Old files are automatically deleted from this folder on every start up of the Application Server. |
Table 1: Directories used by the Redbex Application Server
The location of the binary, cache, log and temporary directories is configured in the instance configuration file. If you manually change the directories make sure that different instances of the Application Server will use different directories!
Files in the binary, cache, log and temporary directories are solely managed by the Application Server. Manually adding, modifying, deleting, modifying or renaming files or sub-folders within these folders will result in fatal errors and possible data loss.
Files in the binary, cache, log and temporary directories might contain confident information, therefore we recommend that only the user running the Application Server Windows Service shall have read/write access rights to these folders.
All directories are created during Setup of the Application Server. On startup of the Application Server checks the existence of the binary, cache, log and temporary directories. If they do not exist the Application Server will try to create these directories and if it fails (due to missing operating system permissions) to do so will not start. During startup the Application Server also checks if it can modify files in this directory, if not the Application Server will fail to start.
If you change the Application Server Directories we recommend that you always create these directories yourself and assign the appropriate windows permissions before starting the Application Server.