docs/8.0/ayanova/docs/ops-install-linux-desktop.md

@@ -1,4 +1,4 @@
-# AyaNova installation - linux desktop
+# AyaNova installation - Linux desktop
 
 Please read through all the instructions below **before** proceeding with installation to be sure everything is available and ready.
 
@@ -6,7 +6,7 @@ The "desktop" installation is appropriate for a single user of AyaNova on a Linu
 
 ## Linux distributions
 
-These instructions were compiled and tested on an Ubuntu 21.10 Desktop OS however any Linux x64 distribution should work provided the ASP.NET Core framework can be installed to it.
+These instructions were compiled and tested on an Ubuntu 21.10 Desktop OS however any Linux x64 distribution should work provided the ASP.NET Core framework can be installed to it, you may need to substitute your Linux distribution's package manager and shell equivalent to the Apt package manager and Bash shell script commands shown here.
 
 ## System requirements
 
@@ -15,10 +15,12 @@ These instructions were compiled and tested on an Ubuntu 21.10 Desktop OS howeve
 - Disk space: minimum 2GB of free disk space
 - RAM : 1GB (minimum), 2+ GB (recommended)
 - Modern web browser with Javascript enabled
+- Curl package installed
+- Unzip package installed
 
 ## Installation procedure
 
-### ASP.NET Core runtime
+### 1/. ASP.NET Core runtime
 
 AyaNova requires the ASP.NET Core runtime version 6.0 or newer and Microsoft provides a step by step guide to install it properly on each version of Linux.
 
@@ -37,13 +39,13 @@ dotnet --list-runtimes
 The AspNetCore runtime should be displayed with version 6 or newer:
 
 ```
-Microsoft.AspNetCore.App 6.0.2 [/usr/share/dotnet/shared/Microsoft.AspNetCore.App]
-Microsoft.NETCore.App 6.0.2 [/usr/share/dotnet/shared/Microsoft.NETCore.App]
+Microsoft.AspNetCore.App 6.0.3 [/usr/share/dotnet/shared/Microsoft.AspNetCore.App]
+Microsoft.NETCore.App 6.0.3 [/usr/share/dotnet/shared/Microsoft.NETCore.App]
 ```
 
 If you do not see this go through the installation steps above again.
 
-### PostgreSQL server
+### 2/. PostgreSQL server
 
 AyaNova requires access to a PostgreSQL database server version 12 or newer. If you do not have a PostgreSQL server already available then it must be installed to a location visible to the AyaNova server (same computer or a local computer on the same network).
 
@@ -69,9 +71,9 @@ ALTER USER postgres PASSWORD 'YOUR_PASSWORD_HERE';
 
 If successful psql will display "ALTER ROLE" in response and you can close the psql console by typing `\q` to quit.
 
-### Create folders for AyaNova
+### 3/.n Create folders for AyaNova
 
-AyaNova requires two folders to be created, one to hold the AyaNova binary and other server and web application files and one to hold the AyaNova data. AyaNova will need to write to both these locations so be sure you choose locations with appropriate permissions.
+AyaNova requires two folders to be created, one to hold the AyaNova binary and other AyaNova server and web application files and one to hold the AyaNova data. AyaNova will need to write to both these locations so be sure you choose locations with appropriate permissions.
 
 From the terminal:
 
@@ -81,20 +83,35 @@ Create the data folder, for desktop linux we recommend your user home folder and
 sudo mkdir ~/.ayanova-data
 ```
 
-Create the AyaNova binary files folder. For desktop linux we recommend `/usr/bin/ayanova`.
+Create the AyaNova binary files folder. For desktop linux we recommend `/opt/ayanova`.
 
 ```bash
-sudo mkdir /usr/bin/ayanova
+sudo mkdir /opt/ayanova
 ```
 
 ### Download the AyaNova binaries archive
 
+The AyaNova binaries are located here:
 [https://www.ayanova.com/download/ayanova-linux-x64-desktop.zip](https://www.ayanova.com/download/ayanova-linux-x64-desktop.zip)
 
+While you can download with a browser and move the files we strongly recommend using the Linux Curl utility instead so that you can download from the terminal.
+
+Install Curl if not already installed:
+
+```bash
+sudo apt install curl
+```
+
+Using curl utility:
+
+```bash
+sudo curl -O https://www.ayanova.com/download/ayanova-linux-x64-desktop.zip
+```
+
 Download the AyaNova server binary files to the folder created in the previous step or copy it there from the terminal:
 
 ```bash
-sudo cp ayanova-linux-x64-desktop.zip /usr/bin/ayanova/
+sudo cp ayanova-linux-x64-desktop.zip /opt/ayanova/
 ```
 
 ### Unzip the archive
@@ -145,6 +162,8 @@ Make changes and save with `ctr-x` and type `y` to answer "Save modified buffer?
 
 Start the server from the AyaNova bin folder in a terminal windows (ctrl-alt-t)
 
+(Note: you must be **in** the AyaNova folder for AyaNova server to start without error `/opt/ayanova/`)
+
 ```bash
 sudo ./AyaNova
 ```
@@ -164,6 +183,10 @@ Open your web browser and navigate to the AyaNova server URL. Assuming the defau
 To shut down the AyaNova server cleanly use the AyaNova web app form accessed from Server Operations -> Server State and the menu item Shut down server.  
 Alternatively you can hard shut down AyaNova using the ctrl-c key combination in the terminal console window where AyaNova is running however this is not recommended.
 
+To start the server from a terminal follow the [boot](#boot-and-test-ayanova-server) instructions above.
+
+To start the server from
+
 ## Report rendering first time delay
 
 The very first time a report is rendered in AyaNova there will be a delay while the Chromium browser report rendering components are installed.