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 925d80f0..eeac799c 100644 --- a/docs/8.0/ayanova/docs/ops-install-windows-internet.md +++ b/docs/8.0/ayanova/docs/ops-install-windows-internet.md @@ -20,6 +20,13 @@ Any modern browser (not Internet Explorer) with Javascript enabled and a minimum - PostgreSQL Server: installation guide [https://www.postgresqltutorial.com/install-postgresql/](https://www.postgresqltutorial.com/install-postgresql/) - ASP.NET Core Runtime Hosting bundle v6.0.0 or newer : Download [https://dotnet.microsoft.com/permalink/dotnetcore-current-windows-runtime-bundle-installer](https://dotnet.microsoft.com/permalink/dotnetcore-current-windows-runtime-bundle-installer) +## 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 as well as configuration of the router to allow incoming connections to the IIS server. + +Network router configuration and security settings are complex and require the assistance of a networking professional familiar with exposing an IIS server to the Internet. Support 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. + +Note that external access can 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. ## Folders @@ -28,7 +35,7 @@ Any modern browser (not Internet Explorer) with Javascript enabled and a minimum ## Installation procedure -Follow the steps below **in the order** they are presented here. +Follow the steps below **in the order** they are presented here. ### Enable IIS Internet Information Server @@ -54,8 +61,8 @@ If IIS was already enabled, double check the default settings for Role Services Reboot is not required at this point, continue on to the PostgreSQL installation below. - #### Windows Desktop operating systems + Enable the IIS Role and selected Role settings: Open the Apps & Features settings page from the Apps shortcut in Settings: @@ -67,7 +74,12 @@ In Apps & Features select the "Programs and Features" link under "Related settin In "Programs and Features" dialog box select "Turn Windows features on or off" link: ![Apps](img/ops-install-windows-internet-iis-win10-features-turn-on.png) +Select the IIS Feature: +![Select IIS Feature](img/ops-install-windows-internet-iis-win10-features-turn-on-iis.png) +If IIS is being enabled for the first time you can accept the defaults. If IIS was already enabled, double check the defaults for IIS are enabled. + +Select the OK button and Windows will enable IIS. Reboot is not required at this point, continue on to the PostgreSQL installation below. ### PostgreSQL server @@ -77,7 +89,9 @@ If you are installing PostgreSQL you will be prompted to provide a password to a ### ASP.NET Core Runtime -IIS **MUST** be installed **before** the ASP.NET Core runtime. AyaNova will not work if IIS is installed after the ASP.NET Core runtime. +IIS **MUST** be installed **before** the ASP.NET Core runtime. AyaNova will not work if IIS is installed after the ASP.NET Core runtime. + +If IIS is not already enabled and running do not proceed until it is. The ASP.NET Core runtime will see IIS and install appropriate components but only if IIS is present during the ASP.NET Core runtime installation. @@ -106,20 +120,28 @@ The AyaNova installer will create a `config.json` file in it's program files fol The `AYANOVA_DB_CONNECTION` property must be edited and where it has "mypasswordforpostgres" substitute the actual PostgreSQL password to be used. If the database server is located on a different computer then the `Server=` connection string property must be set to the address of that computer. -The `AYANOVA_USE_URLS` property specifies which TCP / IP Port that AyaNova server should listen on for connections from web browsers. The default value is port 7575 which should be free in most cases, however if you need to use an alternate port due to conflict it must be set here. We recommend using the default 7575 to avoid current or future confusion or conflict with other servers that may be installed or present elsewhere on the network. - -This setting affects the address users will use to connect to the AyaNova server in their web browser. For example, to access the AyaNova server from the same computer the server is running on with the default port 7575 you would use this link in your browser [http://localhost:7575](http://localhost:7575), however from _another_ computer on the network you would access the server via it's IP address, so, for example if the AyaNova Server computer's IP Address on your network was 192.168.1.10 users on another computer might connect via this address [http://192.168.1.10:7575](http://192.168.1.10:7575). +The `AYANOVA_USE_URLS` property specifies which TCP / IP Port that AyaNova server should listen on for connections from IIS. The default value is port 7575 which should be free in most cases, however if you need to use an alternate port due to conflict it must be set here. We recommend using the default 7575 to avoid current or future confusion or conflict with other servers that may be installed or present elsewhere on the network. #### Boot and test the server +It is important and necessary to confirm AyaNova is able to run properly _BEFORE_ the final configuration in IIS to connect to AyaNova. Follow the steps in this section carefully to confirm AyaNova is working before moving on the final step of configuration IIS below. + The AyaNova installer creates two shortcuts in the Start Menu under "AyaNova Server" and also on the Windows desktop titled "AyaNova server" and "AyaNova App". The AyaNova Server shortcut will start AyaNova by running AyaNova.exe in the program files folder where AyaNova was installed and the AyaNova App shortcut will start a batch file which in turn will open the default browser to the AyaNova server's landing page at the default address. +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. Use the AyaNova App shortcut to open the server and get started with AyaNova. If the server closes immediately upon running with an error: In some cases where a critical configuration value is completely missing, the server console may display the error but close too quickly to read it. In this case you can view the message by starting AyaNova.exe manually from a command line prompt. For example if AyaNova is installed to the default location open a command prompt (press WIN-x, select "command prompt" from the menu) and type `"c:\Program Files\ayanova\AyaNova.exe"` (note the quotation marks) to run AyaNova and see the error and make the necessary changes. +Only after you have confirmed that AyaNova server is working and you can login should you proceed to the next step of enabling IIS to work with AyaNova. + +### IIS final configuration to work with AyaNova + +At this point there is a working AyaNova server and all that is left is to connect IIS to it so users can access AyaNova from inside or outside of your network. + #### Next steps Server installation is complete. Users will require the URL to use in their browser to access the AyaNova APP, see the AYANOVA_USE_URLS in the configuration section above. @@ -142,9 +164,3 @@ To start the AyaNova server use the installed desktop or start menu icon to run ## Getting started and using AyaNova The next step is to follow the [getting started](adm-getting-started.md) guide for using and administrating AyaNova from a business point of view and also the [operations maintenance](ops-maintenance.md) guide to ensure AyaNova runs smoothly and data is safe and secure. - - - - - -