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:
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:
|
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 |