From 0a665dc8b205930a55160dfd1f0278baf1e54b2c Mon Sep 17 00:00:00 2001 From: John Cardinal Date: Mon, 6 Dec 2021 22:15:32 +0000 Subject: [PATCH] --- .../docs/ops-install-windows-internet.md | 40 ++++++++----------- .../ayanova/docs/ops-install-windows-lan.md | 2 +- 2 files changed, 18 insertions(+), 24 deletions(-) diff --git a/docs/8.0/ayanova/docs/ops-install-windows-internet.md b/docs/8.0/ayanova/docs/ops-install-windows-internet.md index 50a3f9b5..037e3409 100644 --- a/docs/8.0/ayanova/docs/ops-install-windows-internet.md +++ b/docs/8.0/ayanova/docs/ops-install-windows-internet.md @@ -1,12 +1,11 @@ # AYANOVA INSTALLATION - INTERNET ACCESS VIA IIS INSTALL GUIDE -This installer includes the AyaNova server application only and requires an IIS server, a PostgreSQL server be installed or accessible and the .net Core framework to be installed separately first. Once the AyaNova server is hosted on IIS users from the internet as well as on a local area network can access the AyaNova web app with their browsers. +This installer includes the AyaNova server application only and requires an IIS server, a PostgreSQL server be installed or accessible and the .net Core framework to be installed separately first. Once the AyaNova server is hosted on IIS and along with the route, properly configured, users from the internet as well as on a local area network can access the AyaNova web app with their browsers. This type of installation is suitable for both outside internet access and inside the local network. Once the AyaNova server is installed and hosted within IIS, nothing needs to be installed for the end users who will access the AyaNova app on a computer or device with a modern web browser with Javascript enabled. - ## AyaNova web app system requirements Any modern browser (not Internet Explorer) with Javascript enabled and a minimum device screen width of 360 pixels. @@ -23,19 +22,18 @@ Any modern browser (not Internet Explorer) with Javascript enabled and a minimum ## Security and Network requirements to access IIS from the internet -In order to access the AyaNova server through IIS from the internet a static IP address is required, optionally a registered domain name as well as appropriate configuration of IIS and the router to allow secure, incoming connections to the IIS server from anywhere. +In order to access the AyaNova server through IIS from the internet a static IP address is required, optionally a registered domain name as well as appropriate configuration of IIS and the router to allow secure, incoming connections to the IIS server from anywhere. -IIS, domain name settings and network router configuration and security settings for external internet access are complex and require the assistance of a networking professional familiar with the process of exposing an IIS server to the internet. +IIS, domain name settings and network router configuration and security settings for external internet access are complex and require the assistance of a networking professional familiar with the process of exposing an IIS server to the internet. -Support and/or instructions for this process are highly equipment and situationally dependent and therefore beyond the scope of this manual or the support we can provide. If you are not familiar with this process it is highly advised to hire a professional to set that part up. We provide the instructions here to get IIS running with AyaNova *inside* your network so it's ready for the next steps of exposing it to the outside world which will require site and equipment specific steps best done by a network professional. - -Note that external access should be configured _after_ AyaNova server is set up and working via IIS _inside_ the network and it may save time to have that ready before getting the assitance of a network technician to enable and _confirm_ outside access to AyaNova by configuring IIS to use HTTPS a domain name and appropriate port exposure through the router. +Support and/or instructions for this process are highly equipment and situationally dependent and therefore beyond the scope of this manual or the support we can provide. If you are not familiar with this process it is highly advised to hire a professional to set that part up. We provide the instructions here to get IIS running with AyaNova _inside_ your network so it's ready for the next steps of exposing it to the outside world which will require site and equipment specific steps best done by a network professional. +Note that external access should be configured _after_ AyaNova server is set up and working via IIS _inside_ the network and it may save time to have that ready before getting the assistance of a network technician to enable and _confirm_ outside access to AyaNova by configuring IIS to use HTTPS a domain name and appropriate port exposure through the router. ## Folders - Program files : By default (and recommended) AyaNova server program files will be installed to `C:\Program Files\ayanova` folder -- Data files: By default AyaNova will store attachment files, logs and backup files in the %ProgramData% folder under `ayanova` which on most computers will be located at `C:\ProgramData\ayanova`. Each folder location can be changed via [configuration](ops-config-environment-variables.md). +- Data files: All data aside from attachment files is stored in the Postgre database. By default AyaNova will store attachment files, logs and backup files in the %ProgramData% folder under `ayanova` which on most computers will be located at `C:\ProgramData\ayanova`. Each folder location can be changed via [configuration](ops-config-environment-variables.md). ## Installation procedure @@ -134,7 +132,7 @@ The AyaNova installer creates two shortcuts in the Start Menu under "AyaNova Ser Note that the AyaNova App shortcut is only relevant to this initial configuration testing, once AyaNova is confirmed to be working via IIS you will no longer access it directly but through IIS instead so the AyaNova App shortcut and address it uses will no longer be required and should not be used execept for diagnostic purposes only. -Start the server by using the "AyaNova server" shortcut on the Windows desktop. You should see a console window open and some text that indicates the server version and that it is booting. Any problems found that prevent boot up will be displayed here. If all is well then the console window will display "BOOT: COMPLETED - SERVER OPEN" as well as some other configuration data. +Start the server by using the "AyaNova server" shortcut on the Windows desktop. You should see a console window open and some text that indicates the server version and that it is booting. Any problems found that prevent boot up will be displayed here. If all is well then the console window will display "BOOT: COMPLETED - SERVER OPEN" as well as some other configuration data. ![AyaNova server console running](img/ops-install-windows-server-console-open.png) @@ -150,9 +148,7 @@ Only after you have confirmed that AyaNova server is working and you can login s At this point there is a working AyaNova server and all that is left is to set up a Site within IIS management console to host AyaNova in IIS so users can access AyaNova from inside or outside of your network. -Stop AyaNova server if it is still running from the previous step by following the instructions in the server console window. From this point on IIS will be controlling the starting and stopping of the AyaNova server. - - +Stop AyaNova server if it is still running from the previous step by following the instructions in the server console window. From this point on IIS will be controlling the starting and stopping of the AyaNova server. - Open IIS manager: @@ -165,21 +161,21 @@ Access IIS manager from the Start menu Administrative tools menu item: ![Open IIS manager from start menu administrative tools](img/ops-install-windows-server-open-iis-manager.png) - Create the AyaNova IIS site: -In the Connections panel open the server's node, right click on Sites to add a new site. -![add site](img/ops-install-windows-server-iis-add-site.png) + In the Connections panel open the server's node, right click on Sites to add a new site. + ![add site](img/ops-install-windows-server-iis-add-site.png) In the Add Website dialog box configure the website settings, the Site Name, Physical Path and Port are the only required settings to be changed. Here is an example configuration that is suitable to allow internal users to access AyaNova over port 8080 via HTTP (not https) and is suitable to test AyaNova internally but is not suitable for outside access: ![configure site](img/ops-install-windows-server-iis-add-site-config.png) -Note that the Site name was set to "AyaNova", the physical path is set to the program files folder where AyaNova.exe resides after installation, the image shows the default location. The Port setting here has been set to 8080 which is intended to not conflict with a default website that comes with IIS which is already on port 80 the web browser http default port. Do not choose the same port number as AyaNova (by default 7575), that port must be left free for AyaNova to use to communicate with IIS. +Note that the Site name was set to "AyaNova", the physical path is set to the program files folder where AyaNova.exe resides after installation, the image shows the default location. The Port setting here has been set to 8080 which is intended to not conflict with a default website that comes with IIS which is already on port 80 the web browser http default port. Do not choose the same port number as AyaNova (by default 7575), that port must be left free for AyaNova to use to communicate with IIS. Click on OK to save the settings and procede to the next step. - Edit Application Pool -Under the Server's node in the connections panel select Application Pools right click the sites application pool which will have the same name as the Site name configured in the previous step and select "Basic settings" from the context menu: -![edit app pool](img/ops-install-windows-server-iis-edit-app-pool.png) + Under the Server's node in the connections panel select Application Pools right click the sites application pool which will have the same name as the Site name configured in the previous step 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": ![set clr version](img/ops-install-windows-server-iis-app-pool.png) @@ -188,25 +184,23 @@ In the application pool dialog set the .NET CLR version to "No Managed Code": Click on Ok to save and continue to the next step - Open AyaNova app through IIS -Right click on the AyaNova site created earlier in IIS Manager and select "Manage website" and then "Browse". The AyaNova web app should open to the login page. - -If you receive an error message from IIS "HTTP Error 500.19 - Internal Server Error The requested page cannot be accessed because the related configuration data for the page is invalid." This means you did not follow the steps in the correct order and asp.net core was installed before IIS was enabled. In order to fix this run the hosting bundle setup again that was installed previously to ensure it recognizes IIS and enables proper operation. + Right click on the AyaNova site created earlier in IIS Manager and select "Manage website" and then "Browse". The AyaNova web app should open to the login page. +If you receive an error message from IIS "HTTP Error 500.19 - Internal Server Error The requested page cannot be accessed because the related configuration data for the page is invalid." This means you did not follow the steps in the correct order and asp.net core was installed before IIS was enabled. In order to fix this run the hosting bundle setup again that was installed previously to ensure it recognizes IIS and enables proper operation. #### Next steps Server installation under IIS for internal access is complete. Users will require the URL to use in their browser to access the AyaNova APP that was opened in the last step to test AyaNova substituting the server's IP address for the "localhost" part of the URL. -For connection from the internet your network adminstrator will need to setup IIS with the correct port and optionally domain name and open the port on the router to allow outside connections and finally provide your users with the correct URL to access AyaNova from outside your network. +For connection from the internet your network adminstrator will need to setup IIS with the correct port and optionally domain name and open the port on the router to allow outside connections and finally provide your users with the correct URL to access AyaNova from outside your network. For Server Operations role review the [Server operations](ops-intro.md) configuration and maintenance guide. For the Business administration role, now that the server is up and running AyaNova business settings can be configured, review the [Getting started](adm-getting-started.md) guide for Administrators. - ## Starting and stopping AyaNova server -IIS will manage starting and stopping AyaNova as required. There should be no reason to start AyaNova server directly. +IIS will manage starting and stopping AyaNova as required. There should be no reason to start AyaNova server directly. ## Getting started and using AyaNova diff --git a/docs/8.0/ayanova/docs/ops-install-windows-lan.md b/docs/8.0/ayanova/docs/ops-install-windows-lan.md index ec5f512e..0798e4b6 100644 --- a/docs/8.0/ayanova/docs/ops-install-windows-lan.md +++ b/docs/8.0/ayanova/docs/ops-install-windows-lan.md @@ -22,7 +22,7 @@ Any modern browser (not Internet Explorer) with Javascript enabled and a minimum ## Folders - Program files : By default (and recommended) AyaNova server program files will be installed to `C:\Program Files\ayanova` folder -- Data files: By default AyaNova will store attachment files, logs and backup files in the %ProgramData% folder under `ayanova` which on most computers will be located at `C:\ProgramData\ayanova`. Each folder location can be changed via [configuration](ops-config-environment-variables.md). +- Data files: All data aside from attachment files is stored in the Postgre database. By default AyaNova will store attachment files, logs and backup files in the %ProgramData% folder under `ayanova` which on most computers will be located at `C:\ProgramData\ayanova`. Each folder location can be changed via [configuration](ops-config-environment-variables.md). ## Installation procedure