Web Library Backend installation (>= 9.2)
Prerequisite:
Backend: Balut (9.2) or newer is already installed.
Introduction
The backend installer does not install the WebLibrary. A manual installation is necessary.
The current release can be found at:
Q:\empower cross platform\empower web library\_Installer\Stable Releases\XXXXX
There you will find
installer-config.json: the template of a configuration file. This must be adapted before installation.
WebLibrary_Installer.exe: the installer.
Web Library installation
First, the WebLibrary_Installer.exe and the installer-config.json must be placed in the current installation directory of the backend,
z. e.g. F:\Program Files (x86)\empower\backend\ServiceHost\Services
If the ProgramDataLocation of the backend is not in the default location, this can be adjusted in installer-config.json. The following value is preset by default:
{ "programDataLocation":"C:\\ProgramData\\empower\\backend\\empower" }
As soon as the change has been saved, the installation process can be started by double-clicking on the installer.
After the installation, the installer, the configuration file and a new folder WebLibrary_Installer remain in the installation directory. All three can now be removed.
In the standard configuration, the WebLibrary can now be accessed at: https://<BASEURL>/empower/websync/app.
WebLibrary update
An update of the WebLibrary is no different from a new installation. The installer recognizes if an instance of WebSync already exists, takes it offline and replaces the corresponding files. You can therefore follow the instructions for installing the WebLibrary without making any changes.
Attention: As the WebLibrary is published together with the suite release, ALWAYS update the backend first and then the WebLibrary. Otherwise the installation of the backend will overwrite the WebLibrary.
Configure Web Sync (>= 9.2)
The application should already be configured correctly after installation. In the event that something needs to be changed, you will find a sample configuration below.
To configure the empower® web sync, locate the configuration file /WebSync/appsettings.json in the backend installation folder.
/WebSync/appsettings.json { "ServiceDefinition": { "ServiceName": "websync", "ServiceDomain": "empower", "ServiceInstanceId": "websync_1", "ServiceInstanceUrl": "http://127.0.0.1:12603/" }, "LaunchSettings": { "Command": "Services\WebSync\\websync.exe", "LogLocation": "\temp\Logs\WebSync", "Arguments": "" }, "ApiGatewayOptions": { "PublicEndpoint": "https://empowerdevserver.dev.mio:8003/" }, "IgnoreSslErrors": true }
Property | Value | Comment |
---|---|---|
ServiceDefinition | ||
ServiceName | ||
ServiceDomain | ||
ServiceInstanceId | ||
ServiceInstanceUrl | ||
LaunchSettings | ||
Command | Absolute path to websync.exe. | |
LogLocation | Absolute path to log location. | |
Arguments | Additional arguments | |
ApiGatewayOptions | ||
PublicEndpoint | empower Backend URI | |
IgnoreSslErrors | true / false | |
AllowCors (ab 9.3) | true / false | Optional. Only for development purposes. Should not be set in production which defaults to false. |
Comments
0 comments
Please sign in to leave a comment.