Skip to main content

Deployment on Windows

Arik Katz
  • Updated

SkylineGlobe Server for Windows can be deployed in two different ways. Each method requires the same basic setup and prerequisites, but offers different options for integration, automation, and control:

Option 1: Manual Running of SGS

To manually run:

  1. Download and extract the SGS application files.
  2. Copy the license file to the SkylineGlobe Server application files folder.
  3. Prepare the configuration file:
    1. Copy the appsettings.sample.jsonc file from the \SG folder in the SGS package you downloaded in step 1.
    2. Rename the file to appsettings.json and place it in the root of the SkylineGlobe Server application folder.
  4. Enable TLS (commonly referred to as SSL) to secure SGS and ensure access to TerraExplorer Fusion, which operates exclusively over HTTPS. More about: Security Configuration Options for SkylineGlobe Server Deployment >
  5. Open the appsettings.json file and uncomment and update the parameters you need to configure. More about: SGS Deployment Settings> 
    Common parameters include:
    • CatalogDBType: The type of database to use. Options: SQLite (default) or PostgreSQL.
    • PublicUrl: The public-facing service URL used in WMS/WFS/WMTS responses.
    • LicenseServerURL: The URL of the floating license server. This parameter is required only when using a floating license. The license file must be placed in the root of the server directory, and this parameter should be set to that location, e.g., "LicenseServerURL": https://cloud.skylineglobe.com/sws/[YOUR_LICENSE_TOKEN]. 
  6. Double-click SkylineGlobeServer.exe. The server will launch in a console window.
  7. Access SGS at: http://localhost:5000, or the port you configured if different. The SkylineGlobe Server Manager Login page is displayed.
  8. Enter your user name and password in the respective fields. The default user name and password after deployment are admin and admin (lower-case). The Change default administrator password page is displayed.
  9. Enter a new password for the admin user.
  10. To stop SGS, close the console window or press Ctrl+C in the command prompt window.

Option 2: Running SGS as a Windows Service

To run as a Windows Service:

  1. Download and extract the SGS application files.
  2. Place the SkylineGlobe Server application folder and license file on the target machine.
  3. Enable TLS (commonly referred to as SSL) to secure SGS and ensure access to TerraExplorer Fusion, which operates exclusively over HTTPS. More about: Security Configuration Options for SkylineGlobe Server Deployment >
  4. Open the appsettings.json file and uncomment and update the parameters you need to configure. More about: SGS Deployment Settings> 
    Common parameters include:
    • CatalogDBType: The type of database to use. Options: SQLite (default) or PostgreSQL.
    • PublicUrl: The public-facing service URL used in WMS/WFS/WMTS responses.
    • LicenseServerURL: The URL of the floating license server. This parameter is required only when using a floating license. The license file must be placed in the root of the server directory, and this parameter should be set to that location, e.g., "LicenseServerURL": https://cloud.skylineglobe.com/sws/[YOUR_LICENSE_TOKEN].
  5. Double-click the StartService.bat file included in the application folder, to install and start SGS as a service. The service will run under the account associated with the entered credentials. This opens the command prompt.
  6. Press any key. The script opens the NSSM Service Editor dialog.
    nssm.png
  7. In the Log on tab, type your Windows user name and password to specify the service account under which SGS should run.
  8. Click Edit service to finish setup.
  9. To stop and remove the service, use StopService.bat. Note that NSSM (Non-Sucking Service Manager) is bundled for managing the Windows service.
  10. Unless defined otherwise in step 3, access SGS at: http://localhost:5000

 

Related articles