From f8520622d80b2127e1510ae6b13dd574997bba67 Mon Sep 17 00:00:00 2001 From: John Cardinal Date: Sat, 11 Feb 2023 22:53:41 +0000 Subject: [PATCH] --- docs/8.0/ayanova/docs/ops-import-v7.md | 10 ++++- .../ayanova/docs/ops-install-windows-iis.md | 11 ++++- .../ayanova/docs/ops-install-windows-lan.md | 42 +++++++++++-------- .../docs/ops-install-windows-single.md | 25 +++++++---- docs/8.0/ayanova/mkdocs.yml | 2 +- 5 files changed, 61 insertions(+), 29 deletions(-) diff --git a/docs/8.0/ayanova/docs/ops-import-v7.md b/docs/8.0/ayanova/docs/ops-import-v7.md index 96ee3527..feba66eb 100644 --- a/docs/8.0/ayanova/docs/ops-import-v7.md +++ b/docs/8.0/ayanova/docs/ops-import-v7.md @@ -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 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 9688add6..3d3c5ced 100644 --- a/docs/8.0/ayanova/docs/ops-install-windows-iis.md +++ b/docs/8.0/ayanova/docs/ops-install-windows-iis.md @@ -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) 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 16b98bf4..124aca2e 100644 --- a/docs/8.0/ayanova/docs/ops-install-windows-lan.md +++ b/docs/8.0/ayanova/docs/ops-install-windows-lan.md @@ -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. - diff --git a/docs/8.0/ayanova/docs/ops-install-windows-single.md b/docs/8.0/ayanova/docs/ops-install-windows-single.md index 189fbfff..34023cb2 100644 --- a/docs/8.0/ayanova/docs/ops-install-windows-single.md +++ b/docs/8.0/ayanova/docs/ops-install-windows-single.md @@ -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. - diff --git a/docs/8.0/ayanova/mkdocs.yml b/docs/8.0/ayanova/mkdocs.yml index 1f7a07e5..6d7668b2 100644 --- a/docs/8.0/ayanova/mkdocs.yml +++ b/docs/8.0/ayanova/mkdocs.yml @@ -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