GAS installation and application data directories

The two main directories of the GAS are:

• The installation directory. See GAS Installation directory.
• The application data directory. See GAS application data directory.
  Important: The application data directory needs to be on the same file system. For more information read the section on Prerequisites for application data directory.

The installation directory contains the installation files. It is defined by the FGLASDIR environment variable and set by the resource $(res.path.as) in the GAS configuration file. The directories and files of the GAS installation directory are described in Table 1.

Table 1. FGLASDIR directories and files

Directory

GAS installation directory

$FGLASDIR

Subdirectories Files or Details Description / Contains script for setting environment variables: On Linux/UNIX: envas On Windows: envas.bat Root directory /bin *.exe GAS dispatchers and VMProxy executables. /Docker *.exe, Dockerfile Contains scripts for working with Docker containers. /etc as.xcf Gas configuration files. /tpl Subdirectories Files or details Description /shortcut *.gdc Shortcuts for applications that can be run by the Genero Desktop Client using /da/r URLs. See Running desktop applications from URL with da protocol No additional information /web demos.html, etc. Root directory for direct communication to the application server. The demos.html file provides access to Demos applications.

The application data directory, or appdata, is where the application data files managed by the GAS are located. The appdata directory is set by the resource $(res.appdata.path) in the GAS configuration file. The directories and files of the appdata directory are described in Table 2

Table 2. appdata directories and Files

Directory

GAS application data directory

appdata

On Windows: C:\ProgramData\FourJs\gas\gas_version On Linux/UNIX: $FGLASDIR/appdata Subdirectories Files or Details Description /app *.xcf Default application group; the default location for your application configuration files. /deployment Contains a directory for each application. Applications deployed with Genero Archive. /gbc_deployment Contains a directory for each GBC. Genero Browser Clients deployed on the GAS. /public Note: Public images should not be placed in the /public root directory as the fglrun does not look for images to be served via the GAS there. Searches start in its sub-directory paths. Subdirectories Files Description /common Image files and resources Stores common images used by applications. It is the default PUBLIC_IMAGEPATH directory. /deployment Image files and resources A directory is created for each application. A public resource path for all applications. /log vm, proxy, and dispatcher logs. Important: Users need write permissions for this directory. Users who installed the GAS have write permissions. If users that start the GAS (for example Apache®) are not in that group, then you need to grant them write permission. A directory is created for each dispatcher, for example, httpdispatch (for the standalone GAS). The logs for a given day are stored in a directory named for that date. Note: DVM logs are redirected to files when DAILYFILE is set for the log output type. /session Persistent session table information. Important: Users need write permissions for this directory. Users who installed the GAS have write permissions. If users that start the GAS (for example Apache®) are not in that group, then you need to grant them write permission. A directory is created for each dispatcher. /tmp Important: Users need write permissions for this directory. Users who installed the GAS have write permissions. If users that start the GAS (for example Apache®) are not in that group, then you need to grant them write permission. Subdirectories Files Description /dispatcher_name Transferred files Default file transfer directory.A directory is created for each dispatcher. /gasadmin Stores gasadmin actions. Example actions include exploring the configuration (xcf) files. No additional information. /services *.xcf Default services group; the default directory for your Web services configuration files.

GAS requires that all appdata files are located on the same file system. This requirement is based on the following:

• The appdata directory and all the search paths for VM server image files defined by the FGLIMAGEPATH environment variable must be located on the same file system. For more information, see the Genero Business Development Language User Guide.
• The DVM uses hard links to avoid file copies. As hard links are direct pointers to data on the disk, they can not span file systems.

If you need to customize the application directory location due to, for example, disk space constraints, it is recommended that you move the entire directory hierarchy starting from the root directory at appdata and ensure that all appdata files are relocated on the same file system.

To implement a location change for appdata, there are two recommended options:

• You can reset the resource $(res.appdata.path) in the GAS configuration file with an absolute path reference to the new location. The example shows appdata located in the path of the GAS installation resource, $(res.path.as):

  <RESOURCE Id="res.appdata.path" Source="INTERNAL">$(res.path.as)/appdata</RESOURCE>

• Or alternatively, at the command line you can override the GAS configuration file $(res.appdata.path) resource with dispatcher option -E.