From 0f919d9706115041cfef15782aeba255ab718103 Mon Sep 17 00:00:00 2001 From: John Cardinal Date: Mon, 21 Feb 2022 18:01:26 +0000 Subject: [PATCH] --- docs/8.0/ayanova/docs/ops-install-linux-server.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) 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 4f293710..6888a267 100644 --- a/docs/8.0/ayanova/docs/ops-install-linux-server.md +++ b/docs/8.0/ayanova/docs/ops-install-linux-server.md @@ -4,7 +4,7 @@ Please read through all the instructions below **before** proceeding with instal These instructions assume shell access to a Linux server and a working knowledge of Linux adminstration tasks. -We also offer "Turnkey" solutions for AyaNova hosting, see our website at [AyaNova.com](https://ayanova.com) for details. +We also offer installation services, contact AyaNova support for details and pricing. The "SERVER" installation configuration is appropriate for use both within a private office network or from the internet. @@ -36,12 +36,21 @@ Any modern browser (not Internet Explorer) with Javascript enabled on any device - Internet connection : required to install license and to automatically download the Chromium report rendering engine - Disk space: minimum 2GB of free disk space - RAM : 1GB (minimum), 2+ GB (recommended) +- Sufficient swap space if a low memory server is used ( < 4gb) - Modern web browser with Javascript enabled - Static IP address if AyaNova will be used from the internet - Domain or subdomain name if AyaNova will be used from the internet ## Installation procedure +### Swap space + +If your server has 2 GB of RAM or less or will be rendering many reports simultaneously it's important to set a swap file to ensure your server doesn't completely run out of memory during report rendering. Report rendering is memory intensive and it's easily possible to completely run out of memory, particularly on a 2GB or less RAM scenario with no swap space available which can crash the server or render it completely unresponsive. + +Swap memory should be considered a stopgap emergency measure only and not relied upon regularly to ensure sufficient memory. If the swap file is being accessed regularly it's a clear indication that more ram needs to be installed or allocated. + +DigitalOcean [has a guide](https://www.digitalocean.com/community/tutorials/how-to-add-swap-space-on-ubuntu-20-04) for Ubuntu droplets that walks through the process or see your distribution documentation for setting this. We recommend double the size of ram allocated to swap space so if you have 1GB of ram then a 2GB swap space is appropriate. + ### Install 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.