This commit is contained in:
2
.vscode/launch.json
vendored
2
.vscode/launch.json
vendored
@@ -39,7 +39,7 @@
|
|||||||
// },
|
// },
|
||||||
"env": {
|
"env": {
|
||||||
// "ASPNETCORE_ENVIRONMENT": "Development",
|
// "ASPNETCORE_ENVIRONMENT": "Development",
|
||||||
// "AYANOVA_JWT_SECRET": "UNLICENSED5G*QQJ8#bQ7$Xr_@sXfHq4",
|
"AYANOVA_JWT_SECRET": "1111111MyRandom32CharacterSecret",
|
||||||
// //"AYANOVA_SET_SUPERUSER_PW": "l3tm3in",
|
// //"AYANOVA_SET_SUPERUSER_PW": "l3tm3in",
|
||||||
"AYANOVA_LOG_LEVEL": "Info",
|
"AYANOVA_LOG_LEVEL": "Info",
|
||||||
// //"AYANOVA_LOG_LEVEL": "Debug",
|
// //"AYANOVA_LOG_LEVEL": "Debug",
|
||||||
|
|||||||
@@ -29,6 +29,8 @@ Here is an example config.json file contents, note that each property and value
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
If you add a property to this file **be sure** to place a comma after the preceding item or the config.json file will be invalid.
|
||||||
|
|
||||||
## ENVIRONMENT VARIABLES
|
## ENVIRONMENT VARIABLES
|
||||||
|
|
||||||
Set the AyaNova environment variables in the manner appropriate for your operating system, either from the command line or as a host setting. For example:
|
Set the AyaNova environment variables in the manner appropriate for your operating system, either from the command line or as a host setting. For example:
|
||||||
|
|||||||
@@ -167,13 +167,11 @@ The [AYANOVA_DB_CONNECTION](ops-config-db.md) property must be edited and where
|
|||||||
|
|
||||||
The [AYANOVA_USE_URLS](ops-config-use-urls.md) 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.
|
The [AYANOVA_USE_URLS](ops-config-use-urls.md) 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.
|
||||||
|
|
||||||
The [AYANOVA_REPORT_RENDER_BROWSER_PATH](ops-config-report-render-browser-path.md) property specifies the path to the Chromium browser previously installed. The default path _may_ need to be changed if reports do not render and Chromium can not be found at the default location.
|
Optional but recommended: Add a 32 character [AYANOVA_JWT_SECRET](ops-config-jwt-secret.md) property to the configuration if you want to ensure that 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.
|
||||||
|
|
||||||
Optional but recommended: Add a 32 character [AYANOVA_JWT_SECRET](ops-config-jwt-secret.md) property to the configuration if you want to ensure that logged in User's session can survive a restart of the AyaNova server. If this is not set AyaNova will invalidate all login tokens when the server restarts.
|
|
||||||
|
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
...existing properties, don't forget the comma...
|
...existing properties...
|
||||||
"AYANOVA_LOG_LEVEL": "Info",
|
"AYANOVA_LOG_LEVEL": "Info",
|
||||||
"AYANOVA_JWT_SECRET": "1111111MyRandom32CharacterSecret"
|
"AYANOVA_JWT_SECRET": "1111111MyRandom32CharacterSecret"
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -128,9 +128,19 @@ 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 "YOUR_PASSWORD_HERE" 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_DB_CONNECTION](ops-config-db.md) property must be edited and where it has "YOUR_PASSWORD_HERE" substitute the actual PostgreSQL password to be used that was previously set. 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 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.
|
The [AYANOVA_USE_URLS](ops-config-use-urls.md) 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.
|
||||||
|
|
||||||
|
Optional but recommended: Add a 32 character [AYANOVA_JWT_SECRET](ops-config-jwt-secret.md) property to the configuration if you want to ensure that 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.
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
...existing properties...
|
||||||
|
"AYANOVA_LOG_LEVEL": "Info",
|
||||||
|
"AYANOVA_JWT_SECRET": "1111111MyRandom32CharacterSecret"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
#### Boot and test the server
|
#### Boot and test the server
|
||||||
|
|
||||||
@@ -224,7 +234,7 @@ For connection from the internet your network adminstrator will need to setup II
|
|||||||
|
|
||||||
** AyaNova can only be securely accessed from the internet if it's secured with an SSL certificate and only allows an HTTPS connection and not an unsecured HTTP connection. **
|
** AyaNova can only be securely accessed from the internet if it's secured with an SSL certificate and only allows an HTTPS connection and not an unsecured HTTP connection. **
|
||||||
|
|
||||||
Let's Encrypt provides free SSL certificates and lists [several Windows clients](https://letsencrypt.org/docs/client-options/#clients-windows-/-iis) for use with Let's Encrypt on Windows.
|
Let's Encrypt provides free SSL certificates and lists [several Windows clients](https://letsencrypt.org/docs/client-options/#clients-windows-/-iis) for use with Let's Encrypt on Windows.
|
||||||
|
|
||||||
For Server Operations role review the [Server operations](ops-intro.md) configuration and maintenance guide.
|
For Server Operations role review the [Server operations](ops-intro.md) configuration and maintenance guide.
|
||||||
|
|
||||||
|
|||||||
@@ -64,11 +64,21 @@ 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 "YOUR_PASSWORD_HERE" 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_DB_CONNECTION](ops-config-db.md) property must be edited and where it has "YOUR_PASSWORD_HERE" substitute the actual PostgreSQL password to be used that was previously set. 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.
|
The [AYANOVA_USE_URLS](ops-config-use-urls.md) 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 USE URLS 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).
|
||||||
|
|
||||||
|
Optional but recommended: Add a 32 character [AYANOVA_JWT_SECRET](ops-config-jwt-secret.md) property to the configuration if you want to ensure that 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.
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
...existing properties...
|
||||||
|
"AYANOVA_LOG_LEVEL": "Info",
|
||||||
|
"AYANOVA_JWT_SECRET": "1111111MyRandom32CharacterSecret"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
#### Boot and test the server
|
#### Boot and test the server
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user