Setup/Installation Web App

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.

 

image.webp

 

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
}
PropertyValueComment
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
IgnoreSslErrorstrue / false 
AllowCors (ab 9.3)true / falseOptional. Only for development purposes. Should not be set in production which defaults to false.

Was this article helpful?

/

Comments

0 comments

Please sign in to leave a comment.