This commit is contained in:
2022-03-30 19:51:58 +00:00
parent 186e03254f
commit 78dc608003
2 changed files with 64 additions and 58 deletions

View File

@@ -15,16 +15,16 @@ 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
- Curl package **installed** (`sudo apt install curl`)
- Unzip package **installed** (`sudo apt-get install zip unzip`)
## Installation procedure
### 1/. 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.
Install the **"ASP.NET CORE RUNTIME"** (NOT SDK VERSION) using this guide for your specific OS version [https://docs.microsoft.com/en-us/dotnet/core/install/linux](https://docs.microsoft.com/en-us/dotnet/core/install/linux)
Install the **"ASP.NET CORE RUNTIME" (NOT SDK VERSION)** using this guide for your specific OS version [https://docs.microsoft.com/en-us/dotnet/core/install/linux](https://docs.microsoft.com/en-us/dotnet/core/install/linux)
There are different procedures for different versions of Linux so be sure to read through the instructions carefully.
@@ -45,7 +45,7 @@ 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.
### 2/. 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).
@@ -53,7 +53,7 @@ We recommend _not_ using the version of PostgreSQL provided by your OS package m
To install PostgreSQL directly start here [https://www.postgresql.org/download/linux/](https://www.postgresql.org/download/linux/)
### Set the PostgreSQL password
### 3\. Set the PostgreSQL password
If you are installing a local copy of PostgreSQL for the first time to use with AyaNova a password will need to be set for secure access. PostgreSQL on linux defaults to no password and must be secured. If you have an existing PostgreSQL server then you can skip this step but will need a PostgreSQL server password in a later step.
@@ -71,7 +71,7 @@ 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.
### 3/.n Create folders for AyaNova
### 4\. Create folders for AyaNova
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.
@@ -89,7 +89,26 @@ Create the AyaNova binary files folder. For desktop linux we recommend `/opt/aya
sudo mkdir /opt/ayanova
```
### Download the AyaNova binaries archive
### 5\. Download / unzip and run the AyaNova binaries archive
The following shell script will automatically download and unzip the latest AyaNova files then start the server.
You *must* have the Curl and Unzip utilities installed before running this command.
From a terminal window run the following commands:
```bash
cd /opt/ayanova && \
sudo curl -O https://www.ayanova.com/download/ayanova-linux-x64-desktop.zip && \
sudo unzip -o ayanova-linux-x64-desktop.zip && \
sudo chmod 777 ./AyaNova && \
sudo ./AyaNova
```
If there is an issue or error break apart the commands and execute each one individually to find the error.
AyaNova server should start with the final command.
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)