Offline Upgrade of Operations Management Module¶

This page provides instructions on how to install or upgrade the Operations Management module after downloading it from the Download Center.

Loading Image from the Installation Package¶

You can load the image using either of the following methods. It is recommended to choose the chart-syncer method when an image repository already exists in the environment, as it is more efficient and convenient.

Synchronizing Images to Image Repository using chart-syncer¶

1. Create load-image.yaml .

   Note

   All parameters in this YAML file are mandatory. You need a private image repository and modify the relevant configurations accordingly.

   Installed chart repoChart Repo Not Installed

   If you have an installed chart repo in the current environment, chart-syncer also supports exporting the chart as a tgz file.

   load-image.yaml

   source:
     intermediateBundlesPath: gmagpie-offline # Use the relative path to run the `charts-syncer` command, not the relative path
   target:
     containerRegistry: 10.16.10.111 # Modify it to your image repository URL.
     containerRepository: release.daocloud.io/gmagpie # Modify it to your image repository.
     repo:
       kind: HARBOR # It can also be any other supported Helm Chart repository category.
       url: http://10.16.10.111/chartrepo/release.daocloud.io # Modify it to the chart repo URL.
       auth:
         username: "admin" # Your image repository username.
         password: "Harbor12345" # Your image repository password.
     containers:
       auth:
         username: "admin" # Your image repository username.
         password: "Harbor12345" # Your image repository password.
   

   If a chart repo is not installed in the current environment, chart-syncer also supports exporting the chart as a tgz file and storing it in the specified path.

   load-image.yaml

   source:
     intermediateBundlesPath: gmagpie-offline # (1)
   target:
     containerRegistry: 10.16.10.111 # (2)
     containerRepository: release.daocloud.io/gmagpie # (3)
     repo:
       kind: LOCAL
       path: ./local-repo # (4)
     containers:
       auth:
         username: "admin" # (5)
         password: "Harbor12345" # (6)
   

   1. Use the relative path to run the charts-syncer command, not the relative path between this YAML file and the offline package.
   2. Modify it to your image repository URL.
   3. Modify it to your image repository.
   4. Local path of the chart.
   5. Your image repository username.
   6. Your image repository password.

2. Run the command to synchronize images.

   charts-syncer sync --config load-image.yaml
   

Loading directly with Docker or containerd¶

Unpack and load the image file.

1. Unpack the tar archive.

   tar xvf gmagpie.bundle.tar
   

   After a successful unpacking, you will obtain 3 files:

   • hints.yaml
   • images.tar
   • original-chart

2. Load the image from the local source into Docker or containerd.

   Dockercontainerd

   docker load -i images.tar
   

   ctr -n k8s.io image import images.tar
   

Upgrade¶

There are two ways to upgrade. You can choose the corresponding upgrade method based on the preconditions:

USER-SUPPLIED VALUES:
global:
  database:
    host: 127.0.0.1
    port: 3306
    dbname: gmagpie
    password: passowrd
    user: gmagpie

USER-SUPPLIED VALUES:
global:
  storage:
    gmagpie:
    - driver: mysql
      accessType: readwrite
      dsn: {global.database.apiserver.user}:{global.database.apiserver.password}@tcp({global.database.host}:{global.database.port})/{global.database.apiserver.dbname}?charset=utf8mb4&multiStatements=true&parseTime=true

Comments