Update the TAR/ZIP steps to include decoupling of files from binaries (neo4j#2092)

Author: renetapopova

modules/ROOT/pages/installation/linux/tarball.adoc

@@ -42,6 +42,13 @@ chown -R neo4j:adm /opt/neo4j-enterprise-{neo4j-version-exact}
 ----
 chown -R neo4j /opt/neo4j-enterprise-{neo4j-version-exact}
 ----
+. xref:configuration/file-locations.adoc#file-locations-file-locations[Change the default locations] of the _data_, _conf_, _certificates_, _licenses_, and _plugins_ (if you plan to use custom plugins) directories by setting the environment variable `NEO4J_CONF` and the respective xref:configuration/configuration-settings.adoc#_server_directories_settings[`server.directories.*`] settings to point to the desired locations.
++
+[NOTE]
+====
+Storing your Neo4j files outside `NEO4J_HOME` will simplify the upgrade process later because you will be able to replace the DBMS binaries without affecting the configuration and state.
+Otherwise, these Neo4j files will remain in the old installation folder and may be accidentally overwritten during an upgrade or deleted during a subsequent uninstall.
+====
 . Accept either the commercial or the evaluation license agreement before running the Neo4j Enterprise Edition.
 If you are using Community Edition, you can skip this step.
 * Use one of the following options to accept the commercial license agreement.
@@ -53,8 +60,6 @@ See the link:https://neo4j.com/terms/licensing/[Neo4j licensing] page for detail
 +
 ** Set the environment variable `NEO4J_ACCEPT_LICENSE_AGREEMENT=eval`.
 ** Run `<NEO4J_HOME>/bin/neo4j-admin server license --accept-evaluation`.
-. (Optional) Decouple the data and configuration directories from the binary files by setting the environment variable `NEO4J_CONF` and `server.directories.data` to point to the desired locations.
-Storing your data and configuration on a separate disk or partition can simplify the upgrade process later.
 . Before starting up the database for the first time, it is recommended to use the `set-initial-password` command of `neo4j-admin` to define the password for the native user `neo4j`.
 +
 If the password is not set explicitly using this method, it will be set to the default password `neo4j`.

modules/ROOT/pages/installation/osx.adoc

@@ -19,6 +19,13 @@ Select the appropriate tar.gz distribution for your platform.
 . Extract the contents of the archive, using `tar -xf` <filename>.
 For example, `tar -xf neo4j-community-{neo4j-version-exact}-unix.tar.gz`.
 . Place the extracted files in a permanent home on your server and set the environment variable `NEO4J_HOME` to point to the extracted directory, for example, `export NEO4J_HOME=/path/to/_<NEO4J_HOME>` to make it easier to refer to it later.
+. xref:configuration/file-locations.adoc#file-locations-file-locations[Change the default locations] of the _data_, _conf_, _certificates_, _licenses_, and _plugins_ (if you plan to use custom plugins) directories by setting the environment variable `NEO4J_CONF` and the respective xref:configuration/configuration-settings.adoc#_server_directories_settings[`server.directories.*`] settings to point to the desired locations.
++
+[NOTE]
+====
+Storing your Neo4j files outside `NEO4J_HOME` will simplify the upgrade process later because you will be able to replace the DBMS binaries without affecting the configuration and state.
+Otherwise, these Neo4j files will remain in the old installation folder and may be accidentally overwritten during an upgrade or deleted during a subsequent uninstall.
+====
 . Accept either the commercial or the evaluation license agreement before running the Neo4j Enterprise Edition.
 If you are using Community Edition, you can skip this step.
 * Use one of the following options to accept the commercial license agreement.
@@ -30,8 +37,6 @@ See the link:https://neo4j.com/terms/licensing/[Neo4j licensing] page for detail
 +
 ** Set the environment variable `NEO4J_ACCEPT_LICENSE_AGREEMENT=eval`.
 ** Run `$NEO4J_HOME/bin/neo4j-admin server license --accept-evaluation`.
-. (Optional) Decouple the data and configuration directories from the binary files by setting the environment variable `NEO4J_CONF` and `server.directories.data` to point to the desired locations.
-Storing your data and configuration on a separate disk or partition can simplify the upgrade process later.
 . Before starting up the database for the first time, it is recommended to use the `set-initial-password` command of `neo4j-admin` to define the password for the native user `neo4j`.
 +
 If the password is not set explicitly using this method, it will be set to the default password `neo4j`.

modules/ROOT/pages/installation/windows.adoc

@@ -17,7 +17,14 @@ Select the appropriate ZIP distribution.
 .. Using the appropriate commands for your platform, display the `SHA-256` hash for the file that you downloaded.
 .. Ensure that the two are identical.
 . Right-click the downloaded file and click *Extract All*.
-. Place the extracted files in a permanent home on your server and set the environment variable `NEO4J_HOME` to point to the extracted directory, for example, `export NEO4J_HOME=/path/to/_<NEO4J_HOME>` to make it easier to refer to it later.
+. Place the extracted files in a permanent home on your server and set the environment variable `NEO4J_HOME` to point to the extracted directory, for example, `export NEO4J_HOME=\path\to\_<NEO4J_HOME>` to make it easier to refer to it later.
+. xref:configuration/file-locations.adoc#file-locations-file-locations[Change the default locations] of the _data_, _conf_, _certificates_, _licenses_, and _plugins_ (if you plan to use custom plugins) directories by setting the environment variable `NEO4J_CONF` and the respective xref:configuration/configuration-settings.adoc#_server_directories_settings[`server.directories.*`] settings to point to the desired locations.
++
+[NOTE]
+====
+Storing your Neo4j files outside `NEO4J_HOME` will simplify the upgrade process later because you will be able to replace the DBMS binaries without affecting the configuration and state.
+Otherwise, these Neo4j files will remain in the old installation folder and may be accidentally overwritten during an upgrade or deleted during a subsequent uninstall.
+====
 . Accept either the commercial or the evaluation license agreement before running the Neo4j Enterprise Edition.
 If you are using Community Edition, you can skip this step.
 * Use one of the following options to accept the commercial license agreement.
@@ -29,8 +36,6 @@ See the link:https://neo4j.com/terms/licensing/[Neo4j licensing] page for detail
 +
 ** Set it as an environment variable using `set NEO4J_ACCEPT_LICENSE_AGREEMENT=eval`.
 ** Run `$NEO4J_HOME\bin\neo4j-admin server license --accept-evaluation`.
-. (Optional) Decouple the data and configuration directories from the binary files by setting the environment variable `NEO4J_CONF` and `server.directories.data` to point to the desired locations.
-Storing your data and configuration on a separate disk or partition can simplify the upgrade process later.
 . Before starting up the database for the first time, it is recommended to use the `set-initial-password` command of `neo4j-admin` to define the password for the native user `neo4j`.
 +
 If the password is not set explicitly using this method, it will be set to the default password `neo4j`.