Configure

Default user

After installing the Application Workspace Satellite Server, you can access it using a web browser on http://localhost/.

The following login screen will be displayed:

AW43-satellite-authentication-screen.png

The default username is 'admin' with an empty password.

Connectivity

All Application Workspace Servers that belong to a zone need to be able to directly connect to a Application Workspace Satellite Server. We recommend you set up the connectivity using a DNS record. By default, the Application Workspace Satellite Server will register itself with its local IP address. To change this, the URL can be reconfigured on the Settings page to include a proper DNS name instead of an IP address.

Pair zone

A zone can be paired after configuring the SSL certificate and the connectivity URL for the Application Workspace System.
See Zones for more information on how to pair a Application Workspace System so it can be used by connectors.

Satellite JSON

Satellite.json is the configuration file of the Application Workspace Satellite Server.

It's default location path is C:\Program Files (x86)\Liquit Workspace\Satellite

The config file is always specific to a single server so we recommend you do not copy it to another server unless you want to migrate an existing Application Workspace Satellite Server installation to a new server.

The values in a JSON file should always be escaped. For example, C:\temp should be C:\\temp.

Example of a complete Satellite.json configuration

 { 
    "Log": { 
        "Level": 1, 
        "Path": "Satellite.log", 
        "RotateCount": 5, 
        "RotateSize": 5242880 
      }, 
    "Redirect": true, 
    "Database": { 
        "Path": "Satellite.db", 
        "Compress": true 
    }, 
    "Contents": { \
        "Enabled": true,
        "Cache": true, 
        "Replication": true,
        "Concurrent": 8, 
        "Interval": 5,
        "Path": "Content",
    },
    "Listeners": [
    {
        "Required": true,
        "Secure": true, 
        "Address": "*", 
        "Port": 80, 
        "OffloadingPort": 443 
    }, 
    { 
        "Required": true, 
        "Certificate": "Satellite", 
        "Address": "*", 
        "Port": 443 
    } 
    ], 
    "ServiceCredential": { 
            "UserName": "service-user", 
        "Encrypted": false, 
        "Password": "SecretPassword" 
    } 
} 

Example of objects you can use in a Satellite.json config file

Log

The Application Workspace Satellite Server logs events that are initiated.

"Log": { 
    "Level": Info, 
    "Path": "Satellite.log", 
    "RotateCount": 5, 
    "RotateSize": 5242880 
  } 

Property Description Default value
level Defines the level of logging:
  • None Nothing will be logged to the log file
  • Critical only critical errors will be logged to the log file.
  • Error Only errors and critical errors will be logged to the log file.
  • Warning Only warnings, errors and critical errors will be logged to the log file.
  • Info Basic information and warnings, errors and critical errors will be logged to the log file.
  • Debug Detailed information will be logged to the log file about all actions. You can use this information when troubleshooting.
Info
path You can define an alternate path of the Agent log files here. C:\ProgramData\Liquit Workspace\Satellite\Logs
rotateCount The number of log files that will be archived. 5
rotateSize The limit of log file size in bytes. When this limit is reached, a new log file will be created and the old file will be archived. 5242880

Redirect

When set to true, the server will redirect incoming insecure requests to the secure port (by default 443), as configured within the listeners. When set to false, the server will NOT redirect insecure requests.

"redirect": true 

Database

"Database": { 
    "Path": "Satellite.db", 
    "Compress": true 
  } 
Property Description Default
Path The path to the database. Satellite.db
Compress If enabled, the database is compressed in the gzip format. true

Contents

Defines how the Application Workspace Satellite Server should handle its content.

 "Contents": { 
    "Enabled": true, 
    "Cache": true, 
    "Replication": true, 
    "Concurrent": 8, 
    "Interval": 5, 
    "Path": "Content", 
} 
Property Description Default
cache Defines whether or not the content of files that are smaller than 1 MB should be cached in memory. true
replication Enables the replication of the local server content across Application Workspace Satellite Servers. true
Concurrent Nr of workers to replicate content (how many files can be synched in parallel. 5
interval The number of seconds between idle checks performed to see if any content needs to be replicated. 5
path The path where contents are stored. The path is relative, but can be absolute. C:\ProgramData\Liquit Workspace\Server\Content

Listeners

The listeners property defines which IP and/or ports Application Workspace will receive and handle requests.

"Listeners": [ 
    { 
      "Required": true, 
      "Secure": true, 
      "Address": "*", 
      "Port": 80, 
      "OffloadingPort": 443 
    }, 
    { 
      "Required": true, 
      "Certificate": "Satellite", 
      "Address": "*", 
      "Port": 443 
    } 
  ] 
Property Description Default
required When the required value is set to true, the Application Workspace Satellite Server will not continue to start up when it can't be registered false
secure This option is overruled by the certificate option, if a certificate is set then this option will be handled as being set to true. Only required/needed if customers uses TLS Termination / Offloading
certificate The friendly name of the certificate Application Workspace Satellite Server should use. SSL/TLS is only used when this property has a value set.
address The address of the Application Workspace Satellite Server. Wildcards (*) are permitted. *
port The port used by the Application Workspace Satellite Server to receive and handle requests.. 80
offloadingPort Indicates that the listener is HTTPS offloaded (TLS termination). The webserver will use an HTTP listener but will handle incoming traffic as secure. 0