♻️ restructure addition docs (#145)

* ♻️ restructure addition docs

* fix image for approved agent

* there is no cog icon anymore, I think it was replaced with the table row's menu

* just typos

* repaired the link

* Fix example service variable definitions

* just typos

* fixed broken link

* Put the sentence " If CONFIG_INSTANCE_n_QUERY_LOG_PORT is not set, the feature is treated as disabled. The rest of NOM still works." to the description of CONFIG_INSTANCE_n_QUERY_LOG_PORT.

Then moved "The location of server log configuration ..." including the IMPORTANT section to "Query log collection" on the page "Neo4j instance requirements" including adjusting the links from CONFIG_INSTANCE_n_LOG_CONFIG_PATH to point there.

* it should be clear that the rest would work

* Apply suggestions from code review

Co-authored-by: Jessica Wright <[email protected]>

* Apply suggestions from code review

Co-authored-by: Jessica Wright <[email protected]>

* editorial changes as suggested

---------

Co-authored-by: Alexander Bouriakov <[email protected]>
Co-authored-by: Jessica Wright <[email protected]>

Author: 3 people

modules/ROOT/content-nav.adoc

@@ -26,9 +26,9 @@
 * xref:addition/index.adoc[]
 ** xref:addition/instance-requirements.adoc[]
 ** xref:addition/agent-installation/index.adoc[]
+*** xref:addition/agent-installation/agent-install.adoc[]
 *** xref:addition/agent-installation/manual.adoc[]
 *** xref:addition/agent-installation/self-registered.adoc[]
-*** xref:addition/agent-installation/install-packaged.adoc[]
 *** xref:addition/agent-installation/agent-config-file.adoc[]
 *** xref:addition/agent-installation/agent-self-signed-certificates.adoc[]
 ** xref:addition/docker/index.adoc[]

modules/ROOT/pages/addition/agent-installation/agent-install.adoc

@@ -0,0 +1,40 @@
+= Install agent
+
+* Download platform specific binary: https://neo4j.com/download-center/#ops-manager[Download]
++
+[NOTE]
+==== 
+In certain environments, downloading agents is not an option.
+Therefore, NOM agent binaries are also bundled with Neo4j packages.
+NOM agent packages can be found in the `products` folder in the Neo4j home directory. 
+These binaries have support for the Neo4j version that they are bundled with.
+====
+
+* Extract the archive
+
+* This step is only required if using *SELinux*.
+To permanently change the SELinux context of the agent binary, run the following commands:
++
+[source, terminal, role=noheader]
+----
+sudo semanage fcontext -a -t bin_t <EXTRACTED_DIRECTORY_PATH>/bin/agent
+sudo restorecon -v <EXTRACTED_DIRECTORY_PATH>/bin/agent
+----
++
+<EXTRACTED_DIRECTORY_PATH> should be replaced with the path to the extracted directory.
+
+* Add the `bin` folder in the extracted directory to `PATH`
+
+* To verify the installation, run the following command:
++
+[source, terminal, role=noheader]
+----
+agent version
+----
++
+Which should output:
++
+[source, terminal, role=noheader]
+----
+<agent name> <agent version> <agent revision>
+----

modules/ROOT/pages/addition/agent-installation/index.adoc

@@ -9,8 +9,8 @@ NOM agents should be installed for every host in the managed estate:
 * An agent can and should manage all instances on a single host even if they are members of different DBMSs.
 
 == NOM agent setup process
-* Register agent with NOM server    [xref:./manual.adoc#register[Manual]]   [xref:./self-registered.adoc#register[Self-Registered]]
-* Install agent on Neo4j instance host  [xref:./manual.adoc#install[Manual]]    [xref:./self-registered.adoc#install[Self-Registered]]
-* Configure agent   [xref:./manual.adoc#configure[Manual]]  [xref:./self-registered.adoc#configure[Self-Registered]]
+* Install agent on Neo4j instance host  [xref:./agent-install.adoc[Install]]
+* Register agent with NOM server    [xref:./manual.adoc#register[Manual]]
 * Run agent     [xref:./manual.adoc#running-agent[Manual]]  [xref:./self-registered.adoc#running-agent[Self-Registered]]
-* Verify agent setup    [xref:./manual.adoc#verify[Manual]]     [xref:./self-registered.adoc#verify[Self-Registered]]
+* Verify agent setup    [xref:./manual.adoc#verify[Manual]]     [xref:./self-registered.adoc#verify[Self-Registered]]
+* Configuration reference  [xref:./manual.adoc#configuration[Manual]]  [xref:./self-registered.adoc#configuration[Self-Registered]]