diff --git a/docs/8.0/ayanova/docs/changelog.md b/docs/8.0/ayanova/docs/changelog.md index dfdd4b07..5df77f69 100644 --- a/docs/8.0/ayanova/docs/changelog.md +++ b/docs/8.0/ayanova/docs/changelog.md @@ -12,7 +12,7 @@ See the [upgrade instructions](ops-upgrade.md) section of this manual for detail In progress... -- Docs: fixed outdated installation step setting directory rights in [linux server install](ops-install-linux-server.md) for post 8.2.0 changes (hat tip to Steven L. for spotting this) +- Docs: fixed outdated and missing installation steps for setting directory rights and ownership in [linux server install](ops-install-linux-server.md) for post 8.2.0 changes (hat tip to Steven L. for spotting this) ### AyaNova 8.2.2 diff --git a/docs/8.0/ayanova/docs/ops-install-linux-server.md b/docs/8.0/ayanova/docs/ops-install-linux-server.md index 04fc3e46..ea56a9b2 100644 --- a/docs/8.0/ayanova/docs/ops-install-linux-server.md +++ b/docs/8.0/ayanova/docs/ops-install-linux-server.md @@ -10,9 +10,12 @@ Once the AyaNova server is up and running users can access it with their web bro No installation is required at the user end to access the AyaNova web app with a supported browser. +These instructions are targeted towards getting a new Linux server installation of AyaNova up and running in a simple and quick manner and assume the server is physically secure. If you have existing Linux infrastructure and / or are a larger organization or have special security considerations be sure to use these instructions as a guide only and modify to suit your specific needs. + ## Linux distributions -These instructions were compiled and tested on an Ubuntu 22.04 and 24.04 server 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 22.04 and 24.04 lts server OS however any Linux x64 distribution should work provided the ASP.NET Core framework can be installed to it. +We strongly recommend using an LTS long term support release of Linux in order to minimize business disruption of the non lts versions that need to be upgraded more frequently. ## Hosted linux @@ -40,6 +43,11 @@ An up to date modern web browser (not Internet Explorer) with Javascript enabled - Domain or subdomain name if AyaNova will be used from the internet - Curl package **installed** (`sudo apt install curl`) - Unzip package **installed** (`sudo apt-get install zip unzip`) +- Time zone set correctly in Linux (ensures backup and other automated operations happen at the expected time) + +## Recommendations + +- Unattened upgrades : off. We recommend turning off unattended upgrades and setting yourself a schedule to manually upgrade and restart the server at a convenient time for the business. In some cases unattended upgrades of the .net runtime or it's dependencies can cause issues with the .net runtime and the operation of the AyaNova server until the linux server is next rebooted. ## Installation procedure @@ -124,7 +132,6 @@ sudo apt-get install -y libatk1.0-0 libatk-bridge2.0-0 libcups2 libxcomposite1 l sudo apt-get install -y libatk1.0-0t64 libc6 libcairo2 libdbus-1-3 libexpat1 libfontconfig1 libgcc-s1 libgdk-pixbuf2.0-0 libglib2.0-0t64 libgtk-3-0t64 libnspr4 libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 libxtst6 ca-certificates fonts-liberation libnss3 lsb-release libgbm-dev xdg-utils \ sudo apt-get update \ sudo apt-get install -y libatk-bridge2.0-0t64 libcups2t64 libxcomposite1 libxdamage1 libpangocairo-1.0-0 libxfixes3 libxrandr2 libgbm1 libcairo2 libpango-1.0-0 libasound2t64 wget - ``` #### Fonts / layout @@ -141,7 +148,7 @@ Create the AyaNova binary files directory. We recommend `/var/ayanova`: sudo mkdir /var/ayanova ``` -Create the data directory. We recommend and AyaNova defaults to '/var/ayanova/data' in it's configuration: +Create the data directory. AyaNova will automatically create subfolders under this folder that it manages. We recommend the default AyaNova uses '/var/ayanova/data' in it's default configuration so you don't need to modify the configuration file: ```bash sudo mkdir /var/ayanova/data @@ -239,6 +246,12 @@ Set permissions to read / write / execute for the .ChromeHeadlessShell directory chmod -R g+rwx /var/ayanova/ChromeHeadlessShell ``` +Set permissions for the AyaNova folder + +```bash +chmod g+rw /var/ayanova/ +``` + ### 10\. Create and install a service to run AyaNova automatically As AyaNova is a server application running on a server operating system it needs to start automatically when the Linux server boots and restart automatically in the (unlikely) event that it crashes. diff --git a/docs/8.0/ayanova/mkdocs.yml b/docs/8.0/ayanova/mkdocs.yml index afade891..9377749b 100644 --- a/docs/8.0/ayanova/mkdocs.yml +++ b/docs/8.0/ayanova/mkdocs.yml @@ -8,7 +8,7 @@ site_name: AyaNova manual site_dir: "../../../server/AyaNova/wwwroot/docs" site_url: https://ayanova.com/docs/ strict: true -copyright: Copyright © 2022-2024 Ground Zero Tech-Works Inc. REV-2024-11-24 +copyright: Copyright © 2022-2024 Ground Zero Tech-Works Inc. REV-2024-12-02 extra: generator: false # Extensions