Skip to content

Troubleshooting 6.8.0 upgrades

The following procedures can be used to correct issues with your Resource Manager 6.8.0 upgrade.

Docker image tags

Early versions of the zenoss/resmgr_6.8 Docker image shipped with an error in one of the upgrade migration scripts. Specifically, the migrate-services.txt file contains references to pre-release versions of Resource Manager Docker images.

During the execution of the upgrade-resmgr.sh script, the migrate-services.txt script is called to pass the tagged image names to Docker for import. When the Docker service can't find images matching these tags, it may show the following error message:

pull access denied for zenoss/resmgr_6.8, repository does not exist or may require 'docker login': denied: requested access to the resource is denied

These errors can be found on lines 34 and 37 of the migrate-services.txt file:

/root/6.8.x/migrate-services.txt
28
29
30
31
32
33
34
35
36
37
38
39
40
DESCRIPTION Zenoss Service Dynamics 6.8.0 WITH_IMPACT Service Migrations
VERSION resmgr-6.8.0
REQUIRE_SVC
SNAPSHOT preupgrade-resmgr-6.8.0

# Choose images to upgrade to
SVC_USE zenoss/resmgr_6.8:6.8.0_1834_unstable zenoss/resmgr_5.0 zenoss/resmgr_5.1 zenoss/resmgr_5.2 zenoss/resmgr_5.3 zenoss/resmgr_6.0 zenoss/resmgr_6.1 zenoss/resmgr_6.2 zenoss/resmgr_6.3 zenoss/resmgr_6.4 zenoss/resmgr_6.5 zenoss/resmgr_6.6 zenoss/resmgr_6.7
SVC_USE zenoss/hbase:24.0.10
SVC_USE zenoss/opentsdb:24.0.10
SVC_USE zenoss/mariadb-resmgr:6.8.0_1834_unstable zenoss/mariadb
SVC_USE zenoss/memcached:cc38f31
SVC_USE zenoss/redis:760f98c
UPGRADE_RABBITMQ_IMAGE

The zenoss/resmgr_6.8 and zenoss/mariadb-resmgr images are followed with the 6.8.0_1834_unstable tag. The should be followed with the latest tag, as shown in the following example:

/root/6.8.x/migrate-services.txt
28
29
30
31
32
33
34
35
36
37
38
39
40
DESCRIPTION Zenoss Service Dynamics 6.8.0 WITH_IMPACT Service Migrations
VERSION resmgr-6.8.0
REQUIRE_SVC
SNAPSHOT preupgrade-resmgr-6.8.0

# Choose images to upgrade to
SVC_USE zenoss/resmgr_6.8:latest zenoss/resmgr_5.0 zenoss/resmgr_5.1 zenoss/resmgr_5.2 zenoss/resmgr_5.3 zenoss/resmgr_6.0 zenoss/resmgr_6.1 zenoss/resmgr_6.2 zenoss/resmgr_6.3 zenoss/resmgr_6.4 zenoss/resmgr_6.5 zenoss/resmgr_6.6 zenoss/resmgr_6.7
SVC_USE zenoss/hbase:24.0.10
SVC_USE zenoss/opentsdb:24.0.10
SVC_USE zenoss/mariadb-resmgr:latest zenoss/mariadb
SVC_USE zenoss/memcached:cc38f31
SVC_USE zenoss/redis:760f98c
UPGRADE_RABBITMQ_IMAGE

You can edit these lines manually or use the following procedure.

  1. Make a backup copy of the migrate-services.txt file.

    cp /root/6.8.x/migrate-services.txt /root/6.8.x/migrate-services.txt.orig

  2. Run the following sed commands to edit the file.

    sed -i 's/SVC_USE zenoss\/resmgr_6\.8:6\.8\.0_1834_unstable/SVC_USE zenoss\/resmgr_6\.8:latest/' /root/6.8.x/migrate-services.txt
sed -i 's/SVC_USE zenoss\/mariadb-resmgr:6\.8\.0_1834_unstable/SVC_USE zenoss\/mariadb-resmgr:latest/' /root/6.8.x/migrate-services.txt

  3. Restart the upgrade script.

    /root/6.8.x/upgrade-resmgr.sh