From 3f0692a2abc1d11975d4eeb9133d074aee8b323d Mon Sep 17 00:00:00 2001 From: John Cardinal Date: Thu, 9 Dec 2021 21:18:32 +0000 Subject: [PATCH] --- .../8.0/ayanova/docs/ops-install-linux-lan.md | 31 +++++++++++++++---- 1 file changed, 25 insertions(+), 6 deletions(-) diff --git a/docs/8.0/ayanova/docs/ops-install-linux-lan.md b/docs/8.0/ayanova/docs/ops-install-linux-lan.md index 8b973e49..b676882a 100644 --- a/docs/8.0/ayanova/docs/ops-install-linux-lan.md +++ b/docs/8.0/ayanova/docs/ops-install-linux-lan.md @@ -58,12 +58,16 @@ 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. -### Install Chromium browser +### Install Chromium browser support libraries -AyaNova uses a "headless" Chromium browser to render report templates. +AyaNova uses a "headless" Chromium browser to render report templates. Server versions of Linux do not have the required support libraries for Chromium to render reports so they must be installed in advance. ```bash -sudo apt-get install chromium-browser +sudo apt-get install -yq gconf-service libasound2 libatk1.0-0 libc6 libcairo2 libcups2 libdbus-1-3 \ +libexpat1 libfontconfig1 libgcc1 libgconf-2-4 libgdk-pixbuf2.0-0 libglib2.0-0 libgtk-3-0 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 libgbm1 \ +ca-certificates fonts-liberation libappindicator1 libnss3 lsb-release xdg-utils wget ``` ### Create folders for AyaNova @@ -82,6 +86,22 @@ Create the data folder, for server linux we recommend and AyaNova defaults to '/ sudo mkdir /var/ayanova/data ``` +### Set data folder group ownership and permissions + +AyaNova will be assumed for these instructions to run under the `www-data` user which needs permission to write to the data folder and (in a later step) execute permission on the AyaNova executable binary. + +Give www-data ownership of the data folder + +```bash +sudo chown -vR :www-data /var/ayanova/data +``` + +Set permissions to read / write for the AyaNova data folder: + +```bash +sudo chmod -R g+rw /var/ayanova/data +``` + ### Download the AyaNova binaries archive Switch to the AyaNova binary folder @@ -113,7 +133,7 @@ sudo unzip ayanova-linux-x64-server.zip In the AyaNova binary files folder: ```bash -sudo chmod 777 ./AyaNova +sudo chmod g+rwx ./AyaNova ``` ### Server configuration @@ -128,8 +148,7 @@ The AyaNova bin folder has a `config.json` file which is AyaNova's initial sourc "AYANOVA_DB_CONNECTION": "Server=localhost;Username=postgres;Password=YOUR_PASSWORD_HERE;Database=AyaNova;", "AYANOVA_DEFAULT_TRANSLATION": "en", "AYANOVA_DATA_PATH": "/var/ayanova/data/", - "AYANOVA_LOG_LEVEL": "Info", - "AYANOVA_REPORT_RENDER_BROWSER_PATH": "/usr/bin/chromium-browser" + "AYANOVA_LOG_LEVEL": "Info" } ```