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
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)
@@ -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".
**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:
## 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
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)
@@ -141,6 +141,15 @@ Clicking on **More info** will reveal the following:
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'
![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
- OS : Windows 64 bit operating system
- Internet connection : required to install license and to automatically download the Chromium report rendering engine
- Disk space: minimum 2GB of free disk space
- RAM : 1GB (minimum), 2+ GB (recommended)
- 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)
- OS : Windows 64 bit operating system
- Internet connection : required to install license and to automatically download the Chromium report rendering engine
- Disk space: minimum 2GB of free disk space
- RAM : 1GB (minimum), 2+ GB (recommended)
- 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)
## Folders
- 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).
- 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).
## 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.
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
dotnet --list-runtimes
@@ -67,7 +67,7 @@ Once you have ensured the two requirements above are installed and available; do
#### 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)
@@ -77,6 +77,15 @@ Clicking on **More info** will reveal the following:
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_.
![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
{
"AYANOVA_USE_URLS": "http://*:7575",
"AYANOVA_DB_CONNECTION": "Server=localhost;Username=postgres;Password=YOUR_PASSWORD_HERE;Database=AyaNova;",
"AYANOVA_DEFAULT_TRANSLATION": "en",
"AYANOVA_BACKUP_PG_DUMP_PATH": "C:\\Program Files\\PostgreSQL\\14\\bin",
"AYANOVA_DATA_PATH": "%ProgramData%\\ayanova",
"AYANOVA_LOG_LEVEL": "Info"
"AYANOVA_USE_URLS": "http://*:7575",
"AYANOVA_DB_CONNECTION": "Server=localhost;Username=postgres;Password=YOUR_PASSWORD_HERE;Database=AyaNova;",
"AYANOVA_DEFAULT_TRANSLATION": "en",
"AYANOVA_BACKUP_PG_DUMP_PATH": "C:\\Program Files\\PostgreSQL\\14\\bin",
"AYANOVA_DATA_PATH": "%ProgramData%\\ayanova",
"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.
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
- OS : Windows 64 bit operating system
- Internet connection : required to install license and to automatically download the Chromium report rendering engine
- Disk space: minimum 2GB of free disk space
- RAM : 1GB (minimum), 2+ GB (recommended)
- Modern web browser (not Internet Explorer) with Javascript enabled
- OS : Windows 64 bit operating system
- Internet connection : required to install license and to automatically download the Chromium report rendering engine
- Disk space: minimum 2GB of free disk space
- RAM : 1GB (minimum), 2+ GB (recommended)
- Modern web browser (not Internet Explorer) with Javascript enabled
## Existing PostgreSQL server
@@ -30,8 +30,8 @@ The single user installer will use TCP/IP ports 6432 for the PostgreSQL server a
## Folders
- 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.
- 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.
## Installation procedure
@@ -41,7 +41,7 @@ The single user installer will use TCP/IP ports 6432 for the PostgreSQL server a
#### 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)
@@ -51,6 +51,14 @@ Clicking on **More info** will reveal the following:
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.
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.
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_dir: '../../../server/AyaNova/wwwroot/docs'
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:
generator: false
# Extensions