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 17574819..d5bd9d09 100644 --- a/docs/8.0/ayanova/docs/ops-install-windows-iis.md +++ b/docs/8.0/ayanova/docs/ops-install-windows-iis.md @@ -103,13 +103,13 @@ AyaNova is built upon the ASP.NET Core runtime version 6.0 or newer and it shoul ### AyaNova server installation -Once you have ensured the two requirements above are installed and available; download and run the AyaNova network installer: [https://www.ayanova.com/Downloads/v8/ayanova-lan-setup.exe](https://www.ayanova.com/Downloads/v8/ayanova-lan-setup.exe). Follow the prompts to complete installation but **DO NOT** select to start AyaNova with Windows, IIS will be responsible for starting and stopping AyaNova. +Download and run the AyaNova network installer: [https://www.ayanova.com/Downloads/v8/ayanova-lan-setup.exe](https://www.ayanova.com/Downloads/v8/ayanova-lan-setup.exe). Follow the prompts to complete installation but **DO NOT** select to start AyaNova with Windows, IIS will be responsible for starting and stopping AyaNova. If you do select start with windows re-run the installer and uncheck it. #### Server configuration The server **must** be configured before it will be able to start properly and find the database server. -The AyaNova installer will create a `config.json` file in it's program files folder (default is `c:\Program Files\ayanova\config.json`) as its initial source for [configuration settings](ops-config-environment-variables.md) required for the server to start. It is necessary to edit this file (or provide an [alternative source of configuration](ops-config-environment-variables.md) and specify the password to connect to the PostgreSQL server. For example, if editing the default config.json file: +The AyaNova installer will create a `config.json` file in it's program files folder. By default the location is `c:\Program Files\ayanova\config.json`. The config.json file is AyaNova's initial source for [configuration settings](ops-config-environment-variables.md) required for the server to start. It is necessary to edit this file (or provide an [alternative source of configuration](ops-config-environment-variables.md) and specify the password to connect to the PostgreSQL server. For example, if editing the default config.json file: ```json { @@ -128,7 +128,7 @@ The `AYANOVA_USE_URLS` property specifies which TCP / IP Port that AyaNova serve #### 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. +AyaNova must be confirmed to run properly _before_ the final configuration in IIS to host AyaNova. 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. @@ -136,6 +136,8 @@ Note that the AyaNova App shortcut is only relevant to this initial configuratio 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. +If there is an issue it will be reported in this console window. + ![AyaNova server console running](img/ops-install-windows-server-console-open.png) Use the AyaNova App shortcut to open the server and get started with AyaNova. @@ -144,15 +146,15 @@ Use the AyaNova App shortcut to open the server and get started with AyaNova. 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. +Only after you have confirmed that AyaNova server is working and you can login to the AyaNova web app should you proceed to the next step of enabling IIS to work with AyaNova. ### IIS AyaNova site configuration -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. +Now that AyaNova server has been confirmed to boot properly IIS needs to be set up to host it. 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: +#### Open IIS manager From a server version of Windows: Tools->Manage menu item from server manager: @@ -162,9 +164,10 @@ From a non-server version of Windows: 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) +#### 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 Add Website dialog box configure the website settings, the Site Name, Physical Path and Port are the only required settings to be changed. @@ -175,9 +178,10 @@ Note that the Site name was set to "AyaNova", the physical path is set to the pr 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) +#### 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) 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) @@ -185,8 +189,9 @@ 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. +#### 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 generally means you did not follow the steps in the correct order and ASP.NET Core was installed **before** IIS was enabled which means IIS doesn't have the proper handlers to run an ASP.NET Core application. In order to fix this run the hosting bundle setup again that was installed previously (repair installation) to ensure it recognizes IIS and enables proper operation. 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 c83e67b4..c93f0702 100644 --- a/docs/8.0/ayanova/docs/ops-install-windows-lan.md +++ b/docs/8.0/ayanova/docs/ops-install-windows-lan.md @@ -46,7 +46,7 @@ Once you have ensured the two requirements above are installed and available; do The server **must** be configured before it will be able to start properly and find the database server. -The AyaNova installer will create a `config.json` file in it's program files folder (default is `c:\Program Files\ayanova\config.json`) as its initial source for [configuration settings](ops-config-environment-variables.md) required for the server to start. It is necessary to edit this file (or provide an [alternative source of configuration](ops-config-environment-variables.md) and specify the password to connect to the PostgreSQL server. For example, if editing the default config.json file: +The AyaNova installer will create a `config.json` file in it's program files folder. By default the location is `c:\Program Files\ayanova\config.json`. The config.json file is AyaNova's initial source for [configuration settings](ops-config-environment-variables.md) required for the server to start. It is necessary to edit this file (or provide an [alternative source of configuration](ops-config-environment-variables.md) and specify the password to connect to the PostgreSQL server. For example, if editing the default config.json file: ```json {