The Release work directory

The XL_RELEASE_SERVER_HOME/work directory is used to store temporary data that cannot be stored in the memory.

Example: The items that are temporarily stored in the work directory are the files that are being uploaded when configuration items (CIs) are being created

Location of the work directory

The work directory is in the Release server installation directory (XL_RELEASE_SERVER_HOME). Release uses this directory instead of an operating system-specific temporary directory because:

  • Read access to the work directory must be limited since it may contain sensitive information.
  • Operating system-specific temporary directories are not large enough to contain all the files that Release needs for more information about disk space,see Requirements for installing Release.

Work directory size

The work directory can grow for several reasons:

There are many unarchived releases. After a release finishes, you must archive the release so that Release can remove the release from the work directory.

Important: To check for unarchived Releases (including those owned by other users), login to Release as an administrator, go to the Releases, and click archived.

Large artifacts are being created, imported, or exported. This may also cause a temporary increase in the size of the work directory. To prevent the work directory from growing, we recommended that you always archive complete Releases and avoid leaving an incomplete release open.

Clean up the work directory

When the Release server is running, files in the work directory may be in use. In addition, if a release is not finished before you stop the Release server, Release will recover the release when the server is restarted. After recovery, the Release needs access to the files that were created previously in the work directory.

Note: Before cleaning up the work directory, verify that all running releases are finished and archived. To do so, login to Release as an administrator, go to the releases, and ensure that all releases are archived or not.

Important: Ensure that there are no running releases in server, you can shut down the Release server and safely delete the files in the work directory.

Change the location of the work directory

You can change the location of the work directory. To do so, change the workDir setting in the xl/repository block of the xl-release.conf file. After saving the file, restart the Releases server.