Skip to content

Installing Configuration Server on Windows

Server Selection

The Configuration Server is optional and can be installed on Linux or Windows, and it can be installed on any system that is network accessible from the systems that host the other components. If your system of record is Linux or Windows, that's a reasonable place to also host the Configuration Server. The overhead of Configuration Server on its host system is very low.

Installation

Installing Configuration Server on a Windows system involves downloading and running a Windows MSI installer. The installation can be downloaded from the Synergex Resource Center.

The name of the installation file will be as shown below, where n.n.n.n is the version number of the product you've downloaded.

Windows Configuration Server installer
Synergex-SIP-ConfigServer-n.n.n.n.msi

Executing the installation requires administrator privileges.

The product will be installed into the directory

Installation location
C:\Program Files\Synergex\SIP\config-server

Configuration

During the installation you will be prompted to enter three pieces of information:

  • Configuration Server port (required, default is 5121)
  • Default profile name to create/use (required, default is default)
  • Configuration Server URL (optional)

If you're using Configuration Server in your environment, it should be installed and started, and your profile's configuration files should be fully configured before installing or starting other components.

Service Management

Configuration Server runs as a Windows service and will be configured to run under the unprivileged NetworkService account and to be started automatically during system boot.

The Windows service is named sip-config-server and can be controlled via all of the normal Windows service management tools.

Upgrades

To upgrade the Configuration Server to a new version:

  • Review the release notes for the new version so you're aware of any prerequisite tasks or tasks that must be completed after the upgrade.
  • Download the installer for the new version and copy it to the target system.
  • Make sure you still have the installer for the version you're currently running, in case you need to revert to that version for any reason. If you don't have it, you can download it from Synergex Resource Center.
  • Perform any prerequisite tasks as defined in the release notes.
  • When you're ready to perform the upgrade, stop the Configuration Server service.
  • Execute the installer for the new version. You don't need to remove the old version; the installer for the new version will perform an in-place upgrade.
  • Perform any post-upgrade tasks as defined in the release notes.
  • Restart the Configuration Server service.

Removal

To remove the Configuration Server from a Windows system:

  • Ensure the Configuration Server service is stopped.
  • Use either Installed Apps in the Windows Settings App or Programs and Features in the Windows Control panel to remove the product from the system. Look for the product name Streaming Integration Platform Configuration Server.