The ServiceControl installation file consists of an MSI bootstrapper EXE and an embedded MSI. This installation can be executed standalone or via the Platform Installer. The installation package includes a utility to manage the installation, upgrade, and removal of ServiceControl services, including monitoring instances. This utility is launched as the final step in the installation process and is also available via the Windows Start Menu.
The ServiceControl installation has the following prerequisites:
If ServiceControl is installed via the Platform Installer, then the installer will manage installation and configuration of the prerequisites.
Monitoring instances can be configured to use one of the supported transports listed below using the ServiceControl Management application:
- Azure Service Bus
- Azure Service Bus - Endpoint-oriented topology
- Azure Service Bus - Forwarding topology
- Azure Storage Queues
- Amazon Simple Queue Service (SQS)
- Microsoft Message Queuing (MSMQ)
- RabbitMQ - Conventional routing topology
- RabbitMQ - Direct routing topology
- SQL Server
Certain transport features are not supported natively by ServiceControl and will require a transport adapter. Contact firstname.lastname@example.org for further guidance.
Adding third-party transports via the ServiceControl Management application is not supported.
If MSMQ is the selected transport, ensure the service has been installed and configured as outlined in Installing The Platform Components Manually.
Installing MSMQ is optional in the Platform Installer. See Platform Installer - MSMQ.
ServiceControl Management provides a simple means of setting up one or more monitoring instances.
ServiceControl Management can be launched automatically at the end of the installation process to enable adding or upgrading ServiceControl or monitoring instances.
ServiceControl Management will display the list of installed ServiceControl and monitoring instances. If the version of the binaries used by an instance are older that those shipped with ServiceControl Management, an upgrade link will be shown against the version label.
To upgrade the service, click the upgrade link next to the service name.
Clicking the upgrade link will:
- Prompt for any new information that is required to run properly on the transport of choice.
- Stop the monitoring instance Windows Service.
- Remove the old binaries.
- Run the new binaries to upgrade the instance by applying new settings and/or creating any required additional queues.
- Start the monitoring instance Windows Service.
Click on the
+ NEW link at the top of the screen and select "Monitoring instance" to launch the "New instance form". Complete the form to register a new monitoring instance service.
When adding the first monitoring instance service, the default service name is
Particular.. It is possible to change this name to a custom service name. In doing so this is also changing the queue name associated with this instance.
The metrics endpoint plugin will need the monitoring instance name in order to send metric data to the monitoring instance.