# Upgrade from ServiceControl.Plugin.NsbX.Heartbeat to NServiceBus.Heartbeat



## Connecting to ServiceControl

The **NServiceBus.Heartbeat** package replaces the **ServiceControl.Plugin.Nsb5.Heartbeat** and **ServiceControl.Plugin.Nsb6.Heartbeat** packages. It also introduces a new version compatible with NServiceBus version 7.

To update, remove the deprecated package and install the NServiceBus.Heartbeat package.

```ps1
Uninstall-Package ServiceControl.Plugin.Nsb6.Heartbeat
Install-Package NServiceBus.Heartbeat -Version 2.0.0
```

## Configuration

The deprecated packages allowed configuration of the ServiceControl queue via a convention in which an application setting `ServiceControl/Queue` was picked up automatically. The new package requires explicit configuration. When upgrading, the following code needs to be added to the endpoint configuration code to retrieve the ServiceControl queue from the configuration file and pass it to the plugin.

```csharp
var endpointConfiguration = new EndpointConfiguration("MyEndpoint");

var setting = ConfigurationManager.AppSettings["ServiceControl/Queue"];

endpointConfiguration.SendHeartbeatTo(
    serviceControlQueue: setting);
```

## Heartbeats feature made internal

The deprecated packages contained a public feature class called `Heartbeats`. This feature was enabled by default and exposed publicly so that it could be disabled using the features API.

```csharp
if (!shouldSendHeartbeat)
{
    endpointConfiguration.DisableFeature<Heartbeats>();
}
```

This feature is no longer enabled by default and requires explicit configuration (above) in order to activate. The feature class itself has been made internal and any code referencing it to disable the feature can be removed.