XP 7.16 docs #555

Author: rymsha

docs/deployment/distro.adoc

@@ -1,6 +1,6 @@
 = XP distributions
 :toc: right
-:imagesdir: config
+:imagesdir: ../images
 
 This chapter investigates the anatomy of the XP distribution files (aka the XP runtime)
 
@@ -53,7 +53,7 @@ XP_HOME/
    |- index/  // <5>
    |- blob/  // <6>
 |- snapshots/ *  // <7>
-|- work/ *  // <8>
+|- work/   // <8>
 ----
 
 <1> `config/` holds all configuration files, including vhost.cfg and system.properties. XP supports hot reloading of all files ending with .cfg
@@ -75,7 +75,14 @@ NOTE: Requires a persisted volume. For clusters, this must be a shared volume, a
 +
 NOTE: For clusters, this must be mounted to a shared volume, accessible by all nodes.
 +
-<8> `work/` Cache and generated bundles (apps etc) are stored here.
+<8> `work/` Cache and generated bundles (apps etc) are stored here. It is also a default location for temporary files (from version image:xp-7160.svg[XP 7.16.0,opts=inline]).
 +
-NOTE: For optimal performance ,mount this to a local persisted volume. Caches do not need to be re-generated after each restart.*
+NOTE: For optimal performance ,mount this to a local persisted volume. Caches do not need to be re-generated after each restart.
 +
+
+
+== XP_TMP
+image:xp-7160.svg[XP 7.16.0,opts=inline]
+
+By default, Enonic XP uses `XP_HOME/work` as temporary folder.
+You may override this by setting the `XP_TMP` environment variable to point to a different location.

docs/images/xp-7160.svg

@@ -3,6 +3,20 @@ include::.variables.adoc[]
 :toc: right
 :imagesdir: release/images
 
+== XP7 Update 16
+
+This release includes a selection of new features, as well as several smaller improvements, bugfixes and stability improvements.
+
+=== GraalVM for JDK 21
+
+XP is now powered by GraalVM for JDK 21
+
+WARNING: XP 7.16.0 is the final release with Mac x64 support. This is due Oracle's discontinuation of x64 builds for Mac.
+
+=== Temporary folder relocation
+
+Startup script relocates the Java defined temporary folder to `<xp-home>/work` by default. To override this behavior, set the `XP_TMP` environment variable to the desired location before starting XP.
+
 == XP7 Update 15
 
 This release includes a selection of new features, as well as several smaller improvements, bugfixes and stability improvements.

docs/release.adoc

@@ -45,6 +45,15 @@ When upgrading to new feature versions of Enonic XP, new versions of standard ap
 After upgrading XP, check for new versions of your installed applications from Enonic market.
 We generally always recommend updating your apps to the latest version!
 
+== v7.16 notes
+
+* Java 21 is now the bundled JDK. Other JDK versions are not supported, although they may also work. We recommend testing your applications before upgrading to this version as always. Consult with https://docs.oracle.com/en/java/javase/21/migrate/getting-started.html[JDK Migration Guide] for more information about migrating from JDK 17 to JDK 21 in case you experience any issues.
+
+* XP 7.16.0 is the final release with Mac x64 support. This is due Oracle's discontinuation of x64 builds for Mac.
+
+* Temporary files are now created in `XP_HOME/work` directory instead of system temp directory. This may increase space requirements in `XP_HOME/work` location.
+It is possible to change the temp directory by setting `XP_TMP` environment variable.
+
 == v7.15 notes
 
 * The image service now generates progressive JPEG images by default. This can be changed back in <<../deployment/config#image>> by setting `progressiveJpeg` to empty string.