This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# AYANOVA HOSTED VIA IIS INSTALL GUIDE
|
||||
|
||||
This installer includes the AyaNova server application only and depends on an IIS server, a PostgreSQL server be installed or accessible and the .net Core framework to be installed in the correct order (detailed below).
|
||||
This installer includes the AyaNova server application only and depends on an IIS server, a PostgreSQL server be installed or accessible and the .net Core framework to be installed in the correct order (detailed below).
|
||||
|
||||
This type of installation is suitable for both outside internet access and inside the local network.
|
||||
|
||||
@@ -33,7 +33,7 @@ Note that external access should be configured _after_ AyaNova server is set up
|
||||
## 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 Postgre 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
|
||||
|
||||
@@ -138,7 +138,7 @@ Start the server by using the "AyaNova server" shortcut on the Windows desktop.
|
||||
|
||||
Use the AyaNova App shortcut to open the server and get started with AyaNova.
|
||||
|
||||
If the server closes immediately upon running with an error:
|
||||
#### If the server closes immediately upon running with an error
|
||||
|
||||
In some cases where a critical configuration value is completely missing, the server console may display the error but close too quickly to read it. In this case you can view the message by starting AyaNova.exe manually from a command line prompt. For example if AyaNova is installed to the default location open a command prompt (press WIN-x, select "command prompt" from the menu) and type `"c:\Program Files\ayanova\AyaNova.exe"` (note the quotation marks) to run AyaNova and see the error and make the necessary changes.
|
||||
|
||||
@@ -186,9 +186,13 @@ Click on Ok to save and continue to the next step
|
||||
- Open AyaNova app through IIS
|
||||
Right click on the AyaNova site created earlier in IIS Manager and select "Manage website" and then "Browse". The AyaNova web app should open to the login page.
|
||||
|
||||
If you receive an error message from IIS "HTTP Error 500.19 - Internal Server Error The requested page cannot be accessed because the related configuration data for the page is invalid." This means you did not follow the steps in the correct order and asp.net core was installed before IIS was enabled. In order to fix this run the hosting bundle setup again that was installed previously to ensure it recognizes IIS and enables proper operation.
|
||||
If you receive an error message from IIS "HTTP Error 500.19 - Internal Server Error The requested page cannot be accessed because the related configuration data for the page is invalid." This generally means you did not follow the steps in the correct order and ASP.NET Core was installed **before** IIS was enabled which means IIS doesn't have the proper handlers to run an ASP.NET Core application. In order to fix this run the hosting bundle setup again that was installed previously (repair installation) to ensure it recognizes IIS and enables proper operation.
|
||||
|
||||
#### Next steps
|
||||
### Starting and stopping AyaNova server
|
||||
|
||||
IIS will automatically manage starting and stopping AyaNova as required.
|
||||
|
||||
### Next steps
|
||||
|
||||
Server installation under IIS for internal access is complete. Users will require the URL to use in their browser to access the AyaNova APP that was opened in the last step to test AyaNova substituting the server's IP address for the "localhost" part of the URL.
|
||||
|
||||
@@ -196,12 +200,4 @@ For connection from the internet your network adminstrator will need to setup II
|
||||
|
||||
For Server Operations role review the [Server operations](ops-intro.md) configuration and maintenance guide.
|
||||
|
||||
For the Business administration role, now that the server is up and running AyaNova business settings can be configured, review the [Getting started](adm-getting-started.md) guide for Administrators.
|
||||
|
||||
## Starting and stopping AyaNova server
|
||||
|
||||
IIS will manage starting and stopping AyaNova as required. There should be no reason to start AyaNova server directly.
|
||||
|
||||
## Getting started and using AyaNova
|
||||
|
||||
The next step is to follow the [getting started](adm-getting-started.md) guide for using and administrating AyaNova from a business point of view and also the [operations maintenance](ops-maintenance.md) guide to ensure AyaNova runs smoothly and data is safe and secure.
|
||||
For the Business administration role review the [Getting started](adm-getting-started.md) guide for Administrators.
|
||||
|
||||
@@ -22,7 +22,7 @@ Any modern browser (not Internet Explorer) with Javascript enabled on any device
|
||||
## 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 Postgre 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
|
||||
|
||||
@@ -65,7 +65,7 @@ This setting affects the address users will use to connect to the AyaNova server
|
||||
|
||||
#### Boot and test the server
|
||||
|
||||
The AyaNova installer creates two shortcuts in the Start Menu under "AyaNova Server" and also on the Windows desktop titled "AyaNova server" and "AyaNova App". The AyaNova Server shortcut will start AyaNova by running AyaNova.exe in the program files folder where AyaNova was installed and the AyaNova App shortcut will start a batch file which in turn will open the default browser to the AyaNova server's landing page at the default address.
|
||||
The AyaNova installer creates two shortcuts in the Start Menu under "AyaNova Server" and also on the Windows desktop titled "AyaNova server" and "AyaNova App". The AyaNova Server shortcut will start a local copy of PostgreSQL, then AyaNova by running AyaNova.exe in the program files folder where AyaNova was installed. The AyaNova App shortcut will start a batch file which in turn will open the default browser to the AyaNova server's landing page at the default address.
|
||||
|
||||
Start the server by using the "AyaNova server" shortcut on the Windows desktop. You should see a console window open and some text that indicates the server version and that it is booting. Any problems found that prevent boot up will be displayed here. If all is well then the console window will display "BOOT: COMPLETED - SERVER OPEN" as well as some other configuration data.
|
||||
|
||||
@@ -73,29 +73,23 @@ Start the server by using the "AyaNova server" shortcut on the Windows desktop.
|
||||
|
||||
Use the AyaNova App shortcut to open the server and get started with AyaNova.
|
||||
|
||||
If the server closes immediately upon running with an error:
|
||||
#### If the server closes immediately upon running with an error
|
||||
|
||||
In some cases where a critical configuration value is completely missing, the server console may display the error but close too quickly to read it. In this case you can view the message by starting AyaNova.exe manually from a command line prompt. For example if AyaNova is installed to the default location open a command prompt (press WIN-x, select "command prompt" from the menu) and type `"c:\Program Files\ayanova\AyaNova.exe"` (note the quotation marks) to run AyaNova and see the error and make the necessary changes.
|
||||
|
||||
#### Next steps
|
||||
|
||||
### Starting and stopping AyaNova server
|
||||
|
||||
To shut down the AyaNova server press the ctrl-c key combination in the ayanova-launcher window.
|
||||
To start the AyaNova server use the installed desktop or start menu icon to run the ayanova-launcher.
|
||||
If you chose the "Start with Windows" option during installation AyaNova will start automatically on Windows login.
|
||||
|
||||
### Next steps
|
||||
|
||||
Server installation is complete. Users will require the URL to use in their browser to access the AyaNova APP, see the AYANOVA_USE_URLS in the configuration section above.
|
||||
|
||||
For Server Operations role review the [Server operations](ops-intro.md) configuration and maintenance guide.
|
||||
|
||||
For the Business administration role, now that the server is up and running AyaNova business settings can be configured, review the [Getting started](adm-getting-started.md) guide for Administrators.
|
||||
For the Business administration role review the [Getting started](adm-getting-started.md) guide for Administrators.
|
||||
|
||||
After the installation has completed the configuration must
|
||||
|
||||
### Adjust defaults
|
||||
|
||||
At the end of setup the ayanova-launcher application will start if selected (or you can run it from the desktop icon) and in turn it will start the Postgres server, AyaNova server and then open the default web browser to both the AyaNova server interface and the AyaNova User interface.
|
||||
|
||||
## Starting and stopping AyaNova server
|
||||
|
||||
To shut down the AyaNova server press the ctrl-c key combination in the ayanova-launcher window.
|
||||
To start the AyaNova server use the installed desktop or start menu icon to run the ayanova-launcher.
|
||||
|
||||
## Getting started and using AyaNova
|
||||
|
||||
The next step is to follow the [getting started](adm-getting-started.md) guide for using and administrating AyaNova from a business point of view and also the [operations maintenance](ops-maintenance.md) guide to ensure AyaNova runs smoothly and data is safe and secure.
|
||||
|
||||
@@ -19,7 +19,7 @@ By default when AyaNova creates it's database it will take this parameter from t
|
||||
|
||||
## Searching
|
||||
|
||||
The AyaNova Search feature (search form) *always* searches case **in**-sensitive by default. There is no setting to change this to case sensitive as that is not supported for searching. In practice this means that all text is treated as lower case for searching. Text entered is converted to lower case and searched for by relying on the server's host operating system locale setting in conjunction with the Postgre server's AyaNova database locale setting `lc_ctype` (see Overview above for how to view these settings in AyaNova).
|
||||
The AyaNova Search feature (search form) *always* searches case **in**-sensitive by default. There is no setting to change this to case sensitive as that is not supported for searching. In practice this means that all text is treated as lower case for searching. Text entered is converted to lower case and searched for by relying on the server's host operating system locale setting in conjunction with the PostgreSQL server's AyaNova database locale setting `lc_ctype` (see Overview above for how to view these settings in AyaNova).
|
||||
|
||||
## Filtering
|
||||
|
||||
|
||||
Reference in New Issue
Block a user