diff --git a/docs/8.0/ayanova/docs/img/ops-install-windows-server-iis-app-pool-idle-timeout.png b/docs/8.0/ayanova/docs/img/ops-install-windows-server-iis-app-pool-idle-timeout.png new file mode 100644 index 00000000..6fe8a726 Binary files /dev/null and b/docs/8.0/ayanova/docs/img/ops-install-windows-server-iis-app-pool-idle-timeout.png differ diff --git a/docs/8.0/ayanova/docs/img/ops-install-windows-server-iis-app-pool-recycling-minutes.png b/docs/8.0/ayanova/docs/img/ops-install-windows-server-iis-app-pool-recycling-minutes.png new file mode 100644 index 00000000..ae59b2c3 Binary files /dev/null and b/docs/8.0/ayanova/docs/img/ops-install-windows-server-iis-app-pool-recycling-minutes.png differ diff --git a/docs/8.0/ayanova/docs/img/ops-install-windows-server-iis-app-pool-recycling-time.png b/docs/8.0/ayanova/docs/img/ops-install-windows-server-iis-app-pool-recycling-time.png new file mode 100644 index 00000000..7b646999 Binary files /dev/null and b/docs/8.0/ayanova/docs/img/ops-install-windows-server-iis-app-pool-recycling-time.png differ diff --git a/docs/8.0/ayanova/docs/ops-form-backup.md b/docs/8.0/ayanova/docs/ops-form-backup.md index 626137f6..b85c83e5 100644 --- a/docs/8.0/ayanova/docs/ops-form-backup.md +++ b/docs/8.0/ayanova/docs/ops-form-backup.md @@ -55,6 +55,10 @@ To restore from backup see the [restore guide](ops-restore.md). Choose a time for the automatic backup when the server will be least busy. Usually this will be set to a value just before midnight for most sites. +**IIS Warning** if you are hosting AyaNova via IIS on Windows be aware that there is a setting in IIS that will restart AyaNova automatically every day and it must be adjusted to not conflict with the backup time and general usage. + +This should already be correctly configured if the [IIS installation instructions](ops-install-windows-iis.md#edit-application-pool) Application Pool settings were properly implemented, if you're not sure double check now. + ### Backup attachment files Attached files are stored by the AyaNova server separately from the AyaNova database in a special location in the file system. 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 98fefbda..ae0213ab 100644 --- a/docs/8.0/ayanova/docs/ops-install-windows-iis.md +++ b/docs/8.0/ayanova/docs/ops-install-windows-iis.md @@ -204,17 +204,45 @@ 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. + 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: ![edit app pool](img/ops-install-windows-server-iis-edit-app-pool.png) -In the application pool dialog set the .NET CLR version to "No Managed Code": +##### Adjust CLR Version + +In the application pool dialog "(General)" section set the .NET CLR version to "No Managed Code": ![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) -Click on Ok to save and continue to the next step +##### 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. + +The default is 20 minutes but we need it to be set to zero to completely turn off idle timeouts: +![idle timeout](img/ops-install-windows-server-iis-app-pool-idle-timeout.png) + +##### Adjust recycle + +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. + +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. + +There are two settings to configure in the "Recycling" section of the Application Pool settings. + +First we need to turn off the 1740 minute recycle by setting it to zero: +![recycle minutes](img/ops-install-windows-server-iis-app-pool-recycling-minutes.png) + +Next we need to add a "Specific Time", the entry box is in 24 hour time format so we will enter `03:00:00` for 3am (again set accordingly for your site needs): + +![recycle time](img/ops-install-windows-server-iis-app-pool-recycling-time.png) + +Save the recycle time once entered and click on Ok to save and continue to the next step. #### Open AyaNova app through IIS