diff --git a/docs/8.0/ayanova/docs/img/ops-install-windows-server-iis-app-pool.png b/docs/8.0/ayanova/docs/img/ops-install-windows-server-iis-app-pool.png index dffafb4c..d1b91067 100644 Binary files a/docs/8.0/ayanova/docs/img/ops-install-windows-server-iis-app-pool.png and b/docs/8.0/ayanova/docs/img/ops-install-windows-server-iis-app-pool.png differ diff --git a/docs/8.0/ayanova/docs/img/ops-install-windows-server-iis-edit-app-pool.png b/docs/8.0/ayanova/docs/img/ops-install-windows-server-iis-edit-app-pool.png index f24b5bec..0d2c4e2e 100644 Binary files a/docs/8.0/ayanova/docs/img/ops-install-windows-server-iis-edit-app-pool.png and b/docs/8.0/ayanova/docs/img/ops-install-windows-server-iis-edit-app-pool.png differ 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 970651df..b209d1c0 100644 --- a/docs/8.0/ayanova/docs/ops-install-linux-server.md +++ b/docs/8.0/ayanova/docs/ops-install-linux-server.md @@ -20,6 +20,10 @@ These instructions were compiled and tested on an Ubuntu 20 server OS however an There is no significant difference in setup between a linux server physically on premise or hosted from a hosting provider such as [Digitalocean](https://www.digitalocean.com/) or [Linode](https://www.linode.com/) with shell root access. +The largest demand put on an AyaNova server is report rendering so if it will be common to render reports with dozens or hundreds of pages you will find that more memory and cpu's will be beneficial. However a small shop that renders smaller page count reports can often be served with a 2gb memory single cpu virtual server. Since it's easy to scale up a virtual server we recommend starting with the minimum requirements and scaling up as necessary. + +The hosting providers cpu and memory monitoring tools will be helpful here to determine if more ram or cpu's are required. + ## AyaNova web app system requirements Any modern browser (not Internet Explorer) with Javascript enabled on any device with a minimum display width of 360 pixels. diff --git a/docs/8.0/ayanova/docs/ops-install-linux.md b/docs/8.0/ayanova/docs/ops-install-linux.md index 329a5d5b..7d234874 100644 --- a/docs/8.0/ayanova/docs/ops-install-linux.md +++ b/docs/8.0/ayanova/docs/ops-install-linux.md @@ -10,7 +10,7 @@ This type of install is appropriate for using AyaNova locally on a single person ## Shared multiple user server installation -When more than one user will be accessing AyaNova it can be set up on a Linux server either on-premise or with a Linux hosting provider such as [Digitalocean](https://www.digitalocean.com/) or [Linode](https://www.linode.com/) that provides full shell access to a virtual or physical server. +When more than one user will be accessing AyaNova it can be set up on a Linux server either on-premise or with a Linux hosting provider, for example [Digitalocean](https://www.digitalocean.com/) or [Linode](https://www.linode.com/) that provides full shell access to a virtual or physical server. [Server install guide](ops-install-linux-server.md) diff --git a/docs/8.0/ayanova/docs/ops-install-windows-iis.md b/docs/8.0/ayanova/docs/ops-install-windows-iis.md index b4052302..fdcdb5e9 100644 --- a/docs/8.0/ayanova/docs/ops-install-windows-iis.md +++ b/docs/8.0/ayanova/docs/ops-install-windows-iis.md @@ -206,9 +206,11 @@ Click on OK to save the settings and procede to the next step. #### Edit Application Pool -Several settings **must** be made in the Application Pool for AyaNova. +Three settings must be changed in the Application Pool for AyaNova to work properly. -Under the Server's node in the Connections panel select "Application Pools" then right click the sites application pool which will have the same name as the Site name configured in the previous step ("AyaNova") and select "Basic settings" from the context menu: +Under the Server's node in the Connections panel select "Application Pools" then right click the AyaNova site application pool which will have the same name as the Site name configured in the previous step ("AyaNova") to open the application pool context menu. + +Select "Advanced settings" from the context menu: ![edit app pool](img/ops-install-windows-server-iis-edit-app-pool.png) @@ -218,11 +220,11 @@ In the application pool dialog "(General)" section set the .NET CLR version to " ![set clr version](img/ops-install-windows-server-iis-app-pool.png) -(this may seem counterintuitive since AyaNova uses .net but AyaNova uses .net Core, not the .net referred to here) +This may seem counterintuitive since AyaNova uses .NET but AyaNova uses .NET Core, which is not the same .NET referred to here. ##### Adjust Idle timeout -In the application pool dialog "Process Model" section the Idle timeout setting must be set to zero to prevent IIS from shutting down AyaNova when usage is low which would prevent AyaNova from processing background tasks like the daily backup or generating Workorders from PM's etc. +In the application pool dialog "Process Model" section the Idle timeout setting must be set to zero to prevent IIS from shutting down AyaNova when usage is low which would prevent AyaNova from processing background tasks like the [daily backup](ops-form-backup.md) or generating Workorders from PM's etc. The default is 20 minutes but we need it to be set to `0` to completely turn off idle timeouts: ![idle timeout](img/ops-install-windows-server-iis-app-pool-idle-timeout.png) @@ -231,7 +233,7 @@ The default is 20 minutes but we need it to be set to `0` to completely turn off In the application pool dialog "Recycling" section there are two settings that must be configured to prevent AyaNova from being restarted when it's actively processing a backup job or generally busy with Users. -It's a good idea to allow IIS to recycle periodically however, by default it will do it every 1740 minutes which eventually will conflict with AyaNova's scheduled daily backup job or at a time when usage is high during the day so we need to turn that off and instead set it to recycle at a specific time of day that will not conflict with the daily backup or a busy time for AyaNova usage. +It's a good idea to allow IIS to recycle periodically however, by default it will do it every 1740 minutes which eventually will conflict with AyaNova's scheduled [daily backup](ops-form-backup.md) job or at a time when usage is high during the day so we need to turn that off and instead set it to recycle at a specific time of day that will not conflict with the daily backup or a busy time for AyaNova usage. For the purposes of this document we'll assume the AyaNova server is not in peak demand overnight and the backup will be configured for 11:59pm making 3am a good time to recycle, however you should adjust this based on your specific site needs. @@ -244,7 +246,7 @@ Next we need to add a "Specific Time", the entry box is in 24 hour time format s ![recycle time](img/ops-install-windows-server-iis-app-pool-recycling-time.png) -Typically 3am is a good time as the backup in our scenario starts at 11:59pm and should be completed by 3am and users won't be accessing the server at 3am however you must adjust this time to be appropriate for your site specific needs. The AyaNova server will restart in well under a minute but it would break the backup if it was in progress and potentially interfere with active users. +Typically 3am is a good time as the backup in our scenario starts at 11:59pm and should be completed by 3am and users won't be accessing the server at 3am however you must adjust this time to be appropriate for your site specific needs. The AyaNova server should completely restart in less than a minute but it will affect the backup if it was in progress and potentially interfere with active users. Save the recycle time once entered and click on Ok to save and continue to the next step. diff --git a/docs/8.0/ayanova/docs/ops-install.md b/docs/8.0/ayanova/docs/ops-install.md index 9f420b7b..493dae34 100644 --- a/docs/8.0/ayanova/docs/ops-install.md +++ b/docs/8.0/ayanova/docs/ops-install.md @@ -1,14 +1,12 @@ # AYANOVA SERVER INSTALLATION -Only the AyaNova server needs to be installed, there is nothing required to be installed for each user other than a modern web browser on their device / computer. +The AyaNova server will run on Windows or Linux. -Choose your server platform for specific instructions: +Choose your operating system for specific instructions: - [Windows 64bit](ops-install-windows.md) - [Linux 64bit](ops-install-linux.md) ## Other platforms -The AyaNova server can potentially run on any platform supported by the ASP.NET CORE framework however we currently only officially test on and support Windows 64 bit or Linux 64 bit operating systems. If you wish to experiment with other operating systems or platforms supported by the ASP.NET CORE framework contact AyaNova technical support to request a specific build for that platform. - - +The AyaNova server can potentially run on any platform supported by the ASP.NET CORE framework however we currently only officially test on and support Windows 64 bit or Linux 64 bit operating systems. If you wish to experiment with other operating systems or platforms supported by the ASP.NET CORE framework contact AyaNova technical support to request a specific build for that platform.