This commit is contained in:
2023-02-11 22:53:41 +00:00
parent 458e9ad6c7
commit f8520622d8
5 changed files with 61 additions and 29 deletions

View File

@@ -174,7 +174,7 @@ Download the V8 Migrate plugin self extracting installer package for AyaNova 7.6
#### Smart screen warning #### Smart screen warning
The self-extracting installer package file is _not_ digitally signed so the first time you run it you may receive a "Smart Screen" warning from Windows such as the following: You may receive a "Smart Screen" warning from Windows such as the following:
![Smart screen dire warning](img/ops-install-windows-smart-screen-warning.png) ![Smart screen dire warning](img/ops-install-windows-smart-screen-warning.png)
@@ -188,6 +188,14 @@ Use the **`Run anyway`** button to start the self extraction of the setup file.
Note that Windows may prompt you that the installer is "unsigned" from an "unknown publisher" and you may need to select the option to allow the installer to "run anyway". Note that Windows may prompt you that the installer is "unsigned" from an "unknown publisher" and you may need to select the option to allow the installer to "run anyway".
**Why is the installer blocked by SmartScreen?**
Windows SmartScreen blocks all files that it does not know. When a new version is released, these files are unknown to SmartScreen and thus SmartScreen warns about them.
As more and more users install the new version, SmartScreen learns that the files are good. As soon as enough users have installed the new version, SmartScreen does not warn about it anymore.
SmartScreen does not support allowing software developers to request adding to a 'whitelist' when a new version of their software is published.
Continue with the next step: Continue with the next step:
## How to break the migration ## How to break the migration

View File

@@ -131,7 +131,7 @@ Once you have ensured the three requirements above are installed and available,
#### Smart screen warning #### Smart screen warning
The setup file is _not_ digitally signed so the first time you run setup you may receive a "Smart Screen" warning from Windows such as the following: You may receive a "Smart Screen" warning from Windows such as the following:
![Smart screen dire warning](img/ops-install-windows-smart-screen-warning.png) ![Smart screen dire warning](img/ops-install-windows-smart-screen-warning.png)
@@ -141,6 +141,15 @@ Clicking on **More info** will reveal the following:
Use the **`Run anyway`** button to start the installation. Use the **`Run anyway`** button to start the installation.
**Why is the installer blocked by SmartScreen?**
Windows SmartScreen blocks all files that it does not know. When a new version is released, these files are unknown to SmartScreen and thus SmartScreen warns about them.
As more and more users install the new version, SmartScreen learns that the files are good. As soon as enough users have installed the new version, SmartScreen does not warn about it anymore.
SmartScreen does not support allowing software developers to request adding to a 'whitelist' when a new version of their software is published.
**IMPORTANT**: You **MUST UNCHECK** the option 'Start AyaNova server when Windows starts' **IMPORTANT**: You **MUST UNCHECK** the option 'Start AyaNova server when Windows starts'
![SCREENSHOT OF setup window un checked server start with windows](img/ops-install-windows-lan-uncheck.png) ![SCREENSHOT OF setup window un checked server start with windows](img/ops-install-windows-lan-uncheck.png)

View File

@@ -17,17 +17,17 @@ An up to date modern web browser (not Internet Explorer) with Javascript enabled
## AyaNova server system requirements ## AyaNova server system requirements
- OS : Windows 64 bit operating system - OS : Windows 64 bit operating system
- Internet connection : required to install license and to automatically download the Chromium report rendering engine - Internet connection : required to install license and to automatically download the Chromium report rendering engine
- Disk space: minimum 2GB of free disk space - Disk space: minimum 2GB of free disk space
- RAM : 1GB (minimum), 2+ GB (recommended) - RAM : 1GB (minimum), 2+ GB (recommended)
- PostgreSQL Server: installation guide [https://www.postgresqltutorial.com/install-postgresql/](https://www.postgresqltutorial.com/install-postgresql/) - PostgreSQL Server: installation guide [https://www.postgresqltutorial.com/install-postgresql/](https://www.postgresqltutorial.com/install-postgresql/)
- ASP.NET Core Runtime Hosting bundle v6.x : Download [https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-6.0.13-windows-hosting-bundle-installer](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-6.0.13-windows-hosting-bundle-installer) - ASP.NET Core Runtime Hosting bundle v6.x : Download [https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-6.0.13-windows-hosting-bundle-installer](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-6.0.13-windows-hosting-bundle-installer)
## Folders ## Folders
- Program files : By default (and recommended) AyaNova server program files will be installed to `C:\Program Files\ayanova` folder - Program files : By default (and recommended) AyaNova server program files will be installed to `C:\Program Files\ayanova` folder
- Data files: All data aside from attachment files is stored in the PostgreSQL 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). - Data files: All data aside from attachment files is stored in the PostgreSQL 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 ## Installation procedure
@@ -51,7 +51,7 @@ Download the runtime here [https://dotnet.microsoft.com/en-us/download/dotnet/th
Run the installer and take the defaults. Run the installer and take the defaults.
Confirm your ASP.NET Core runtime is installed and running by opening a DOS command / Windows Shell window and typing Confirm your ASP.NET Core runtime is installed and running by opening a DOS command / Windows Shell window and typing
```dos ```dos
dotnet --list-runtimes dotnet --list-runtimes
@@ -67,7 +67,7 @@ Once you have ensured the two requirements above are installed and available; do
#### Smart screen warning #### Smart screen warning
The setup file is _not_ digitally signed so the first time you run setup you may receive a "Smart Screen" warning from Windows such as the following: You may receive a "Smart Screen" warning from Windows such as the following:
![Smart screen dire warning](img/ops-install-windows-smart-screen-warning.png) ![Smart screen dire warning](img/ops-install-windows-smart-screen-warning.png)
@@ -77,6 +77,15 @@ Clicking on **More info** will reveal the following:
Use the **`Run anyway`** button to start the installation. Use the **`Run anyway`** button to start the installation.
**Why is the installer blocked by SmartScreen?**
Windows SmartScreen blocks all files that it does not know. When a new version is released, these files are unknown to SmartScreen and thus SmartScreen warns about them.
As more and more users install the new version, SmartScreen learns that the files are good. As soon as enough users have installed the new version, SmartScreen does not warn about it anymore.
SmartScreen does not support allowing software developers to request adding to a 'whitelist' when a new version of their software is published.
Keep the checkmark on _Start AyaNova server when Windows starts_ and click on _next_. Keep the checkmark on _Start AyaNova server when Windows starts_ and click on _next_.
![SCREENSHOT OF setup window checkmarked server start with windows](img/ops-install-windows-lan-startup.png) ![SCREENSHOT OF setup window checkmarked server start with windows](img/ops-install-windows-lan-startup.png)
@@ -115,12 +124,12 @@ The default installed `config.json` file will initially have the following:
```json ```json
{ {
"AYANOVA_USE_URLS": "http://*:7575", "AYANOVA_USE_URLS": "http://*:7575",
"AYANOVA_DB_CONNECTION": "Server=localhost;Username=postgres;Password=YOUR_PASSWORD_HERE;Database=AyaNova;", "AYANOVA_DB_CONNECTION": "Server=localhost;Username=postgres;Password=YOUR_PASSWORD_HERE;Database=AyaNova;",
"AYANOVA_DEFAULT_TRANSLATION": "en", "AYANOVA_DEFAULT_TRANSLATION": "en",
"AYANOVA_BACKUP_PG_DUMP_PATH": "C:\\Program Files\\PostgreSQL\\14\\bin", "AYANOVA_BACKUP_PG_DUMP_PATH": "C:\\Program Files\\PostgreSQL\\14\\bin",
"AYANOVA_DATA_PATH": "%ProgramData%\\ayanova", "AYANOVA_DATA_PATH": "%ProgramData%\\ayanova",
"AYANOVA_LOG_LEVEL": "Info" "AYANOVA_LOG_LEVEL": "Info"
} }
``` ```
@@ -217,4 +226,3 @@ The next step is to [login](ay-start-login.md), request or install a [license](a
To ensure AyaNova runs smoothly and data is safe and secure be sure to look over the [Server operations](ops-intro.md) configuration and maintenance guide. To ensure AyaNova runs smoothly and data is safe and secure be sure to look over the [Server operations](ops-intro.md) configuration and maintenance guide.
For Business administration and setting things up from a business perspective, review the [Getting started - Set up for production use](tour-bootstrap-configure.md) step in our Getting started guided tour. For Business administration and setting things up from a business perspective, review the [Getting started - Set up for production use](tour-bootstrap-configure.md) step in our Getting started guided tour.

View File

@@ -14,11 +14,11 @@ For simplicity of use, the "single" installation is intended for users who will
## System requirements ## System requirements
- OS : Windows 64 bit operating system - OS : Windows 64 bit operating system
- Internet connection : required to install license and to automatically download the Chromium report rendering engine - Internet connection : required to install license and to automatically download the Chromium report rendering engine
- Disk space: minimum 2GB of free disk space - Disk space: minimum 2GB of free disk space
- RAM : 1GB (minimum), 2+ GB (recommended) - RAM : 1GB (minimum), 2+ GB (recommended)
- Modern web browser (not Internet Explorer) with Javascript enabled - Modern web browser (not Internet Explorer) with Javascript enabled
## Existing PostgreSQL server ## Existing PostgreSQL server
@@ -30,8 +30,8 @@ The single user installer will use TCP/IP ports 6432 for the PostgreSQL server a
## Folders ## Folders
- Program files : By default (and recommended) AyaNova server program files will be installed to `C:\Program Files\ayanova` folder - Program files : By default (and recommended) AyaNova server program files will be installed to `C:\Program Files\ayanova` folder
- Data files: AyaNova will store all data in the %ProgramData% folder under `ayanova` which on most computers will be located at `C:\ProgramData\ayanova`. This includes all logs, backups and User attachment files. - Data files: AyaNova will store all data in the %ProgramData% folder under `ayanova` which on most computers will be located at `C:\ProgramData\ayanova`. This includes all logs, backups and User attachment files.
## Installation procedure ## Installation procedure
@@ -41,7 +41,7 @@ The single user installer will use TCP/IP ports 6432 for the PostgreSQL server a
#### Smart screen warning #### Smart screen warning
The setup file is _not_ digitally signed so the first time you run setup you may receive a "Smart Screen" warning from Windows such as the following: You may receive a "Smart Screen" warning from Windows such as the following:
![Smart screen dire warning](img/ops-install-windows-smart-screen-warning.png) ![Smart screen dire warning](img/ops-install-windows-smart-screen-warning.png)
@@ -51,6 +51,14 @@ Clicking on **More info** will reveal the following:
Use the **`Run anyway`** button to start the installation. Use the **`Run anyway`** button to start the installation.
**Why is the installer blocked by SmartScreen?**
Windows SmartScreen blocks all files that it does not know. When a new version is released, these files are unknown to SmartScreen and thus SmartScreen warns about them.
As more and more users install the new version, SmartScreen learns that the files are good. As soon as enough users have installed the new version, SmartScreen does not warn about it anymore.
SmartScreen does not support allowing software developers to request adding to a 'whitelist' when a new version of their software is published.
2\. Follow the prompts, accepting the license agreement and the defaults. 2\. Follow the prompts, accepting the license agreement and the defaults.
3\. Complete the setup 3\. Complete the setup
@@ -98,4 +106,3 @@ The next step is to [login](ay-start-login.md), request or install a [license](a
To ensure AyaNova runs smoothly and data is safe and secure be sure to look over the [Server operations](ops-intro.md) configuration and maintenance guide. To ensure AyaNova runs smoothly and data is safe and secure be sure to look over the [Server operations](ops-intro.md) configuration and maintenance guide.
For Business administration and setting things up from a business perspective, review the [Getting started - Set up for production use](tour-bootstrap-configure.md) step in our Getting started guided tour. For Business administration and setting things up from a business perspective, review the [Getting started - Set up for production use](tour-bootstrap-configure.md) step in our Getting started guided tour.

View File

@@ -7,7 +7,7 @@ theme:
site_name: AyaNova manual site_name: AyaNova manual
site_dir: '../../../server/AyaNova/wwwroot/docs' site_dir: '../../../server/AyaNova/wwwroot/docs'
strict: true strict: true
copyright: Copyright © 2023 Ground Zero Tech-Works Inc. REV-2023-02-10 copyright: Copyright © 2023 Ground Zero Tech-Works Inc. REV-2023-02-11
extra: extra:
generator: false generator: false
# Extensions # Extensions