This article is only relevant for v0.9.6 to v0.9.8.

Upgrading v0.9.6 to v0.9.7/v0.9.8

During the Helm Chart upgrade from v0.9.6 to 0.9.7/8 the following steps need to executed additionally to the following guide.

Instructions on upgrading

During the Helm chart upgrade from v0.9.6 to 0.9.7/8 the following steps need to executed additionally to the following guide:

Upgrading the Helm Chart

Upgrading (after upgrading the Helm Chart)

  1. Open UMHLens

  2. Select Workloads → Pods

  3. Click on one of the factoryinsight pods

  4. Check that “VERSION” is set to 2

    Lens, show current version
    Lens, show current version

    1. If this is not the case:

    2. Select Workloads → Deployments

    3. Click on the factoryinsight deployment and select “edit”

      Lens, edit factoryinsight deployment
      Lens, edit factoryinsight deployment

    4. Search for the “Version” tag and set it to 2

      Lens, edit factoryinsight api version
      Lens, edit factoryinsight api version

    5. Click “Save & Close”

    6. Go back to Workloads → Pods

  5. Click on the Grafana pod

  6. Check that the Init Container’s image is unitedmanufacturinghub/grafana-plugin-extrator:0.1.3

    Lens, grafana plugin extractor version
    Lens, grafana plugin extractor version

    1. If this is not the case:

    2. Remove the Stateful & Deployments, listed in the normal upgrade guid

    3. Goto Helm → Releases and click on the 3 dots left to united-manufacturing-hub

    4. Select “upgrade”

    5. Replace the extraInitContainers from grafana with:

      extraInitContainers:
          - name: init-umh-datasource
            image: unitedmanufacturinghub/grafana-plugin-extractor:0.1.3
            volumeMounts:
              - name: storage
                mountPath: /var/lib/grafana
            imagePullPolicy: IfNotPresent
      
    6. Replace

      GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS: umh-datasource,umh-factoryinput-panel
      

      with

      GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS: umh-datasource,umh-factoryinput-panel,umh-v2-datasource
      
    7. Replace

      datasources:
          datasources.yaml:
            apiVersion: 1
            datasources:
            - access: proxy
              editable: false
              isDefault: true
              jsonData:
                apiKey: $FACTORYINSIGHT_PASSWORD
                apiKeyConfigured: true
                customerId: $FACTORYINSIGHT_CUSTOMERID
                serverURL: http://united-manufacturing-hub-factoryinsight-service/
              name: umh-datasource
              orgId: 1
              type: umh-datasource
              url: http://united-manufacturing-hub-factoryinsight-service/
              version: 1
      

      With

      datasources:
          datasources.yaml:
            apiVersion: 1
            datasources:
            - access: proxy
              editable: false
              isDefault: true
              jsonData:
                apiKey: $FACTORYINSIGHT_PASSWORD
                apiKeyConfigured: true
                customerId: $FACTORYINSIGHT_CUSTOMERID
                serverURL: http://united-manufacturing-hub-factoryinsight-service/
              name: umh-datasource
              orgId: 1
              type: umh-datasource
              url: http://united-manufacturing-hub-factoryinsight-service/
              version: 1
            - access: proxy
              editable: false
              isDefault: false
              jsonData:
                apiKey: $FACTORYINSIGHT_PASSWORD
                apiKeyConfigured: true
                baseURL: http://united-manufacturing-hub-factoryinsight-service/
                customerID: $FACTORYINSIGHT_CUSTOMERID
              name: umh-v2-datasource
              orgId: 1
              type: umh-v2-datasource
              url: http://united-manufacturing-hub-factoryinsight-service/
              version: 1
      
    8. Press “Upgrade”

    9. Go to Workloads → Pods

    10. Check in UMHLens if your timescaledb version is pg13.8-ts2.8.0-p1

      1. If not, make sure to place the following code in the timescale-single section
      image:
          repository: timescale/timescaledb-ha
          tag: pg13.8-ts2.8.0-p1
          pullPolicy: Always
      
    11. Open a pod shell inside timescaledb

      1. Execute

        psql -X
        ALTER EXTENSION timescaledb UPDATE;
        \dx timescaledb
        
      2. It should show 2.8.0 as timescaledb version

      3. Kill the timescaledb & factoryinsight pods

New Grafana plugins

UMH-datasource-v2 is included and enabled by default.

Last modified May 5, 2023: feat: finishing touches (1147002)