Documentation
Rate This Document
Findability
Accuracy
Completeness
Readability
SubmitClose

Upgrade

This section describes how to upgrade the Kunpeng DevKit full installation package on the Kunpeng platform running openEuler 20.03 LTS SP1. The upgrade method also applies on other hardware platforms and OSs.

  • The tool can be upgraded from 23.0.0 to 23.0.T30.
  • The tool can be upgraded from 23.0.0 to 24.0.RC1.
  • The tool can be upgraded from 24.0.RC1 to 24.0.RC2.
  • The tool can be upgraded from 24.0.RC2 to 24.0.RC3.
  • The tool can be upgraded from 24.0.RC3 to 24.0.0.
  • The tool can be upgraded from 24.0.0 to 25.0.0.
  • The tool can be upgraded from 25.0.0 to 25.1.RC1.
  • The tool can be upgraded from 25.1.RC1 to 25.1.0.
  • The tool can be upgraded from 25.1.RC1 or 25.1.0 to 25.2.RC1.
  • The tool can be upgraded from 25.3.0 to 26.0.RC1.

Cross-version upgrades are not supported.

Prerequisites

  • You have downloaded the software package of the target Kunpeng DevKit version to the local PC and confirmed that the package is compatible with the server hardware platform.
  • After obtaining the software package, verify that it is consistent with that provided on the corresponding website.
  • Check that the Kunpeng DevKit is running properly and umask is set to 0022.
  • The tool installation directory (/opt/DevKit by default) has at least 15 GB of free space.
  • The upgrade cannot be performed when an analysis task is being performed. Ensure that no analysis task is running during the upgrade.
  • Dot not press Ctrl+Z, Ctrl+C, or restart the OS during the upgrade.
  • If a port conflict occurs, the system automatically allocates a port from the ports available.

Upgrade Procedure

  1. Use an SSH tool to remotely log in to the Linux OS CLI as the DevKit installation user.
  2. Copy the Kunpeng DevKit package to a custom directory on the server and run the following commands to perform the upgrade:
    1
2
    cd /opt/DevKit/tools
./upgrade.sh /home/DevKit-All-x.x.x-Linux-kunpeng.tar.gz

    /opt/DevKit/tools is the source version installation directory. /home is the custom directory for the uploaded upgrade package, and the permission on this directory must be set to 755.

  3. Check the Kunpeng DevKit upgrade result.
    The following information is displayed:
      1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
      Start upgrading, please wait ...
  Decompressing files ...
  Decompressing files success.
  Start upgrading Kunpeng DevKit, please wait ...
  Do not press Ctrl+Z or Ctrl+C or restart the system during the upgrade.
  The system uses yum to manage packages.
  Start upgrading the DevKit Framework, please wait ...
  The system uses yum to manage packages.
  Entry parameter mode
  Selected install_path: /opt


Checking install path permission...
  The permission check of the installation path is successful.


Checking install path space...
  The space check of the installation path is successful.
  The access mode with the user name and password will be used for the installation.
...
...
...
Please enter the installation port (default: 8086):
  Selected Nginx port: 8086
  Selected HTTP server port: 8002
  Selected RPC cluster server port: 50051
  Selected the internal port of the tool: 7996




The following parameters will be used for deployment:
  ++++++++++++++++++++++++++++++++++++++++++++++++
  OS_TYPE                       : OpenEulerOS
  TOOL_VERSION                  : 25.3.0
  INSTALL_TOOL                  : porting,affinity,devtools,debugger,sys_perf,java_perf,sys_diagnosis
  INSTALL_PATH                  : /opt
  NGINX_IP                      : xx.xx.xx.xx
  NGINX_PORT                    : 8086
  PLUGIN_GUNICORN_PORT          : 7996
  GRPC_SERVER_IP                : xx.xx.xx.xx
  GRPC_LISTEN_PORT              : 50051
  HTTP_LISTEN_PORT              : 8002
  ++++++++++++++++++++++++++++++++++++++++++++++++


DevKit Configuration Generation


Decompressing files ...
  Decompressing files success


Install python environment
  Install python3
  Install python_venv


Config libffi path
  The libffi path is configured successfully.


Configure venv packages path
  Configure venv packages path success
no crontab for root


Install third-party tools.
  Configure nginx... please wait
  Make nginx... please wait
  Make install nginx... please wait
  Install nginx success


It may take a few minutes to generate the certificate. Please wait...
  Encrypting passphase success!
  Generate the certificate success
  Certificate generated successfully. You can import the root certificate to the browser to mask security alarms when you access the tool. The root certificate is stored in opt/DevKit/rsa/ca.crt.
...
...
...
  Applying diagnostic_importexporttasks.0001_initial... OK
  Applying diagnostic_nodemanager.0001_initial... OK
  Applying diagnostic_sysconfig.0001_initial... OK
  Applying diagnostic_taskmanager.0001_initial... OK
  Applying storageio_diagnostic_task.0001_initial... OK
  Run sys_diagnosis install script
  Check disk space
  Check install path disk space Success
  Install iperf3 Success
  Install trace_net_flow Success
  Load database success
  Copy doctor files to devkit success
  Generate plugins agent package success
  Run sys_diagnosis install script success
  install sys_diagnosis success
  Generate agent package success
  The porting plugin is successfully installed in the /opt/DevKit/devkitplugins/porting directory.
  The affinity plugin is successfully installed in the /opt/DevKit/devkitplugins/affinity directory.
  The devtools plugin is successfully installed in the /opt/DevKit/devkitplugins/devtools directory.
  The debugger plugin is successfully installed in the /opt/DevKit/devkitplugins/debugger directory.
  The sys_perf plugin is successfully installed in the /opt/DevKit/devkitplugins/sys_perf directory.
  The java_perf plugin is successfully installed in the /opt/DevKit/devkitplugins/java_perf directory.
  The sys_diagnosis plugin is successfully installed in the /opt/DevKit/devkitplugins/sys_diagnosis directory.
  To ensure that the DevKit runs properly, you need to grant the OS permissions of the user account used to install the DevKit to the devadmin user.
  The Kunpeng DevKit Advisor is successfully installed in the /opt/DevKit directory.
  The DevKit Web console is running. Log in at https://xx.xx.xx.xx:8086 and set a password to ensure your account security.
  If xx.xx.xx.xx:8086 has mapping IP, please use the mapping IP.

    If the upgrade fails, the upgrade script automatically rolls back the tool to the source version.

Parent topic: Tool Installation