The Release work directory
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
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](/release/concept/requirements-for-installing-xl-release/)).
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.
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: After you have verified that there are no running releases, you can shut down the Release server and safely delete the files in 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.