Update Service Server Settings
By default, the settings file for the Update Service server is located at
C:\inetpub\wwwroot\Update Service Server\appsettings.json
The settings can be updated directly within the file but also using the server interface, under settings or by using the Set-UssServerSettings cmdlet.
Updating the file directly will have no input validation.
Most settings are applied immediately, with few exceptions.
URL
The server exposes a REST API for server and client operations, which is by default on port 8060 when hosted with Internet Information Services (IIS). However, the port and SSL settings can be configured within IIS to suit the specific needs of the deployment environment.
To ensure all clients can access the server's API, it is important to verify network connectivity. Generally, clients use a URL to access the server, which can be obtained from an installer generated by the server. This URL can be configured using the PublicUrl setting.
| Setting | Description |
|---|---|
| Public URL | Specifies the server's URL for client connections. |
Note
Making changes the PublicUrl setting or network access to the server after deploying an Update Service client, you need to manually update the client connection settings to reflect these changes.
Database
The database behind the server is in the server settings file as a connection string.
Installer Code Signing
To automatically code sign installers generated on the server, you must provide and install a code signing certificate on the machine hosting Update Service server. It is recommended to obtain X.509 service certificates from a trusted provider.
Specify the installed service certificate with the following fields:
| Setting | Description |
|---|---|
| Enable Client Services SSL | Specifies if client services should enable SSL. |
| Certificate Find Type | Specifies the type of value to search for. |
| Certificate Store Name | Specifies the name of the X.509 certificate store to open. |
| Certificate Store Location | Specifies the location of the X.509 certificate store. |
| Certificate Find Value | Specifies the value to search for. |
| Certificate Identity | Specifies the identity of the certificate. The value of this field is embedded in all generated installers as part of the server connection information. |
Other Settings
ServerName
A user-friendly name for the server. Can appear in the server management interface, server to server and clients.
FileStorageDir
Location of the file storage directory where files in packages available on the server are stored. The default location is C:\ProgramData\LS Retail\GoCurrent\Server\FileStorage. If the location is changed you must move any existing files manually to the new location.