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.

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 CLI.
  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
      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.
devkit:x:1124:1124::/home/devkit:/sbin/nologin
userdel: user devkit is currently used by process 44671
userdel: devkit home directory (/home/devkit) not found
  Start upgrading the DevKit Framework, please wait ...
  The system uses yum to manage packages.
  Entry parameter mode
  Selected install_path: /opt

Check install path permission
  Check install path permission Success

Check install path space
  Check install path space Success
The user name and password-based access mode will be used for installation.
...
...
...
Installation environment check result:
  SequenceNumber     CheckItem                           CheckResult    Suggestion
  [1]                installation user                   ok             N/A
  [2]                sudo permission                     ok             N/A
  [3]                su permission                       ok             N/A
  [4]                pam_rootok                          ok             N/A
  [5]                sudoers configuration file          ok             N/A
  [6]                devkit user                         ok             N/A
  [7]                service configuration file          ok             N/A
  [8]                tool installation path              ok             N/A
  [9]                user home directory                 ok             N/A
  [10]               framework dependency                ok             N/A
  [11]               devkitworkers                       ok             The tool will create 10 users (default devkitworker1-10) to execute background tasks. All the users belong to the devkit user group and have the same user permissions.

  Check environment success

Start obtaining installation parameters.
  Selected IP address of the web server: xx.xx.xx.xx
  Selected the internal port of the tool: 7996


The following parameters will be used for deployment:
  ++++++++++++++++++++++++++++++++++++++++++++++++
  OS_TYPE                       : OpenEulerOS
  TOOL_VERSION                  : x.x.x
  INSTALL_TOOL                  : framework
  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
  ++++++++++++++++++++++++++++++++++++++++++++++++
...
...
...
checking service status
service status DevKit for Java is OK.
remove java-perf-backup folder
DevKit for Java has been upgraded successfully on your system.

  Upgrade java_perf succeeded.
Delete /home/devkit_package/DevKit-upgrade/DevKit-All-x.x.x-Linux-Kunpeng/DevKit-All-x.x.x-Linux-Kunpeng/plugin_java_perf_upgrade successful
  Prepare to start upgrading the remote node.
  Completing the Remote Node Upgrade.
  Start devkit nginx service, please wait...
  Start DevKit service success
  Successfully upgraded the sys_diagnosis plug-in in /opt/DevKit/devkitplugins/sys_diagnosis.
  Successfully upgraded the java_perf plug-in in /opt/DevKit/devkitplugins/java_perf.
  Successfully upgraded the sys_perf plug-in in /opt/DevKit/devkitplugins/sys_perf.
  Successfully upgraded the debugger plug-in in /opt/DevKit/devkitplugins/debugger.
  Successfully upgraded the devtools plug-in in /opt/DevKit/devkitplugins/devtools.
  Successfully upgraded the affinity plug-in in /opt/DevKit/devkitplugins/affinity.
  Successfully upgraded the porting plug-in in /opt/DevKit/devkitplugins/porting.
  Successfully upgraded the Kunpeng DevKit Advisor in /opt/DevKit.

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