From f5c1a5256406c901e564d7be3a800830ecde349b Mon Sep 17 00:00:00 2001 From: John Cardinal Date: Wed, 22 May 2024 20:52:09 +0000 Subject: [PATCH] --- docs/8.0/ayanova/docs/ops-install-windows-iis.md | 8 +++++--- docs/8.0/ayanova/docs/ops-install-windows-lan.md | 9 +++++---- 2 files changed, 10 insertions(+), 7 deletions(-) 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 cc435d42..8301407c 100644 --- a/docs/8.0/ayanova/docs/ops-install-windows-iis.md +++ b/docs/8.0/ayanova/docs/ops-install-windows-iis.md @@ -95,6 +95,8 @@ AyaNova requires access to a PostgreSQL database server version 12 or newer. It If you need to install PostgreSQL follow this installation guide [https://www.postgresqltutorial.com/install-postgresql/](https://www.postgresqltutorial.com/install-postgresql/) +Note: we have seen cases during testing where the PostgreSQL installer will show error messages related to Visual C++ runtime file installation on the latest Windows server platforms however this appears to be cosmetic only and doesn't affect operation of PostgreSQL. + #### PostgreSQL server password If you are installing PostgreSQL you will be prompted to provide a password to access it. Be sure to make a note of this password as AyaNova will need it to be specified later in the `AYANOVA_DB_CONNECTION` [configuration setting](ops-config-environment-variables.md) after installing the AyaNova server. @@ -227,7 +229,7 @@ OPTIONAL EDIT: Modify the 32 character [AYANOVA_JWT_SECRET](ops-config-jwt-secret.md) property of the configuration which ensures that the logged in User's session can survive a restart of the AyaNova server. If this is not set AyaNova will invalidate all login tokens any time the server restarts by generating a new random JWT secret on boot which under IIS happens frequently. -Change this from the default of "11111YourRandom32CharacterSecret" to be unique to your site (must be 32 characters). +Change this from the default of "11111YourRandom32CharacterSecret" to be unique to your site (must be 32 characters). ```json { @@ -265,9 +267,9 @@ You should see a console window open and some text that indicates the server ver In some cases where there is a critical error completely preventing AyaNova server from running, the server console may display the error but close too quickly to read it. In this case you can view the message by opening a shell / command line prompt and starting `AyaNova.exe` manually from it's program files ayanova folder. -If you see an error about the `config.json` file there is likely a comma missing or some other format issue from when it was edited in the earlier step. Double check that it's not missing a comma or has an extra comma at the end that is not required or anything else that stands out. +If you see an error about the `config.json` file there is likely a comma missing or some other format issue from when it was edited in the earlier step. Double check that it's not missing a comma or has an extra comma at the end that is not required or anything else that stands out. -If you receive an error that mentions `Microsoft.NETCore.App` it may be that the .net installation did not complete properly even though the display runtimes command executed properly. In this case the issue is often resolved by redoing the .net installation instructions above. +If you receive an error that mentions `Microsoft.NETCore.App` it may be that the .net installation did not complete properly even though the display runtimes command executed properly. In this case the issue is often resolved by redoing the .net installation instructions above. #### 6\.2 Double-click the AyaNova App shortcut 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 94610770..7fe898fb 100644 --- a/docs/8.0/ayanova/docs/ops-install-windows-lan.md +++ b/docs/8.0/ayanova/docs/ops-install-windows-lan.md @@ -37,6 +37,8 @@ PostgreSQL is open source and free to use. If you need to install PostgreSQL follow this installation guide [https://www.postgresqltutorial.com/install-postgresql/](https://www.postgresqltutorial.com/install-postgresql/) +Note: we have seen cases during testing where the PostgreSQL installer will show error messages related to Visual C++ runtime file installation on the latest Windows server platforms however this appears to be cosmetic only and doesn't affect operation of PostgreSQL. + #### PostgreSQL server Password If you are installing PostgreSQL you will be prompted to provide a password to access it. Be sure to make a note of this password as AyaNova will need it to be specified later in the `AYANOVA_DB_CONNECTION` [configuration setting](ops-config-environment-variables.md) after installing the AyaNova server. @@ -159,7 +161,7 @@ OPTIONAL EDIT: Modify the 32 character [AYANOVA_JWT_SECRET](ops-config-jwt-secret.md) property of the configuration which ensures that the logged in User's session can survive a restart of the AyaNova server. If this is not set AyaNova will invalidate all login tokens any time the server restarts by generating a new random JWT secret on boot. -Change this from the default of "11111YourRandom32CharacterSecret" to be unique to your site (must be 32 characters). +Change this from the default of "11111YourRandom32CharacterSecret" to be unique to your site (must be 32 characters). ```json { @@ -195,10 +197,9 @@ You should see a console window open and some text that indicates the server ver In some cases where there is a critical error completely preventing AyaNova server from running, the server console may display the error but close too quickly to read it. In this case you can view the message by opening a shell / command line prompt and starting `AyaNova.exe` manually from it's program files ayanova folder. -If you see an error about the `config.json` file there is likely a comma missing or some other format issue from when it was edited in the earlier step. Double check that it's not missing a comma or has an extra comma at the end that is not required or anything else that stands out. - -If you receive an error that mentions `Microsoft.NETCore.App` it may be that the .net installation did not complete properly even though the display runtimes command executed properly. In this case the issue is often resolved by redoing the .net installation instructions above. +If you see an error about the `config.json` file there is likely a comma missing or some other format issue from when it was edited in the earlier step. Double check that it's not missing a comma or has an extra comma at the end that is not required or anything else that stands out. +If you receive an error that mentions `Microsoft.NETCore.App` it may be that the .net installation did not complete properly even though the display runtimes command executed properly. In this case the issue is often resolved by redoing the .net installation instructions above. #### 5\.2 Double-click the AyaNova App shortcut