Manage connector upgrades

05/30/2025 Contributors

When you use standard mode or restricted mode, BlueXP automatically upgrades your Connector to the latest release, as long as the Connector has outbound internet access to obtain the software update.
If you need to manually manage when the connector is upgraded, you can disable automatic upgrades for standard mode or restricted mode.

When running BlueXP in private mode, you must always upgrade the connector yourself.

Disable automatic upgrades

Disabling auto-upgrade for your connector consists of two steps. First you need to ensure that your Connector is healthy and up-to-date. Then you'll edit a configuration file to turn off the automatic upgrade feature.

You can only disable automatic upgrades if you have connector version 3.9.48 or higher.

Verify the health of your connector

You should verify that your connector is stable and all containers running on your connector VM are healthy and running. After you disable automatic upgrades, your connector VM stops checking for new services or upgrade packages.

Use one of the following commands to verify your connector. All services should have a status of Running. If this isn't the case, contact NetApp support before disabling auto-upgrade.

Docker

docker ps -a

Podman

podman ps -a

Disable auto-upgrade for the connector

You disable automatic upgrades by setting the isUpgradeDisabled flag in the com/opt/application/netapp/service-manager-2/config.json file. By default, this flag is set to false and your connector is automatically upgraded. You can set this flag to true to disable automatic upgrades. You should be familiar with JSON syntax before completing this step.

To re-enable auto-upgrade, use these steps and set the isUpgradeDisabled flag to false.

Steps

Ensure you have verified that your connector is up-to-date and healthy.
Create a backup copy of the /opt/application/netapp/service-manager-2/config.json file to ensure you can revert your changes.
Edit the /opt/application/netapp/service-manager-2/config.json file and change the value of the isUpgradeDisabled flag to true.
```
  "isUpgradeDisabled": true,
```
Save your file.
Restart the service manager 2 service by running the following command:
```
systemctl restart netapp-service-manager.service
```
Run the following command and verify that the Connector status shows as active(running):
_
```
systemctl status netapp-service-manager.service
```

Upgrade the connector

The Connector needs to restart during the upgrade process so the web-based console will be unavailable during the upgrade.