Rate This Document
Findability
Accuracy
Completeness
Readability

Upgrade

  • 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.

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.
  • You have verified that the upgrade package is consistent with that on the website. For details, see Verifying the Digital Signature.
  • The Kunpeng DevKit can be used properly.
  • The tool installation directory (/opt/DevKit by default) has at least 8 GB 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.
  • Upgrade the tool based on the installation mode of the Kunpeng DevKit (CLI or WebUI). The tool in WebUI mode can be upgraded by the root user only. The tool in CLI mode can be upgraded by common users and the root user.
  • 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 installation directory of source version. /home is a custom directory.

  3. Check the Kunpeng DevKit upgrade result.
    The following information is displayed (WebUI mode for example):
      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
    109
    110
    111
    112
    113
    114
    115
    116
    117
    118
    119
    120
    121
    122
    123
    124
    125
    126
    127
    128
    129
    130
    131
    132
    133
    134
    135
    136
    137
    138
    139
    140
    141
    142
    143
    144
    145
    146
    147
    148
    149
    150
    151
      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.
    
    Check the environment.
      Check the file tool package: OK
      Check the passwd tool package: OK
    ...
    ...
    ...
    Check the zlib-devel tool package: OK
    
    Check whether DevKit is installed.
      DevKit is not installed, continue
    
    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.
    
    The following parameters will be used for deployment:
      ++++++++++++++++++++++++++++++++++++++++++++++++
      OS_TYPE                       : CentOS
      TOOL_VERSION                  : x.x.x
      INSTALL_TOOL                  : framework
      INSTALL_PATH                  : /opt
      NGINX_IP                      : x.x.x.x
      EXTERNAL_IP                   : x.x.x.x
      NGINX_PORT                    : 8086
      PLUGIN_GUNICORN_PORT          : 7996
      GRPC_SERVER_IP                : x.x.x.x
      GRPC_LISTEN_PORT              : 50052
      HTTP_LISTEN_PORT              : 8002
      ++++++++++++++++++++++++++++++++++++++++++++++++
    
    DevKit Configuration Generation
    Locking password for user devkit.
    passwd: Success
    
    Deal devkit user env
      The environment of the devkit user is configured successfully.
    
    Decompressing files ...
      Decompressing files success
    
    Start to create multiple users.
      devkitworker1 is created successfully.
      devkitworker2 is created successfully.
      devkitworker3 is created successfully.
      devkitworker4 is created successfully.
      devkitworker5 is created successfully.
      devkitworker6 is created successfully.
      devkitworker7 is created successfully.
      devkitworker8 is created successfully.
      devkitworker9 is created successfully.
      devkitworker10 is created successfully.
    
    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 devkit
    
    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.
    
    Migrations for 'certificatemanager':
      /opt/DevKit/devkitframework/certificatemanager/migrations/0001_initial.py
        - Create model CertStatus
    ...
    ...
    ...
    /opt/DevKit/devkitplugins/java-perf-backup /home/devkit_package/DevKit-upgrade/DevKit-All-x.x.x-Linux-Kunpeng/DevKit-All-24.0.RC1-Linux-Kunpeng/plugin_java_perf_upgrade/DevKit-Java-Perf-x.x.x-Linux-Kunpeng
    /home/devkit_package/DevKit-upgrade/DevKit-All-x.x.x-Linux-Kunpeng/DevKit-All-x.x.x-Linux-Kunpeng/plugin_java_perf_upgrade/DevKit-Java-Perf-x.x.x-Linux-Kunpeng
    applying REPORT_ALARM_JFR_COUNT=8
    applying THOR_SERVER_LOG_LEVEL=INFO
    applying THOR_CERTIFICATE_EARLY_WARNING_DAYS=90
    applying HEAP_ALARM_COUNT=8
    applying REPORT_MAX_JFR_COUNT=15
    applying STACK_DEPTH_NUM=16
    applying DEFAULT_SALT=QejPWKzJj8RSYBuKBCj5gGJShM4TEKRH
    applying HEAP_MAX_COUNT=10
    applying HEAP_MAX_SIZE=1024
    applying REFRESH_WORKING_KEY_IS_SUCCEED=
    applying REFRESH_WORKING_KEY_DATE=
    registering service DevKit for Java as id java_perf to systemd
    
    Created symlink from /etc/systemd/system/multi-user.target.wants/java_perf.service to /usr/lib/systemd/system/java_perf.service.
    service registration towards systemd as OK.
    starting the service
    service DevKit for Java is active
    
    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
      Start devkit nginx service, please wait...
      Start DevKit service success
      Successfully upgraded the porting plug-in in /opt/DevKit/devkitplugins/porting.
      Successfully upgraded the affinity plug-in in /opt/DevKit/devkitplugins/affinity.
      Successfully upgraded the devtools plug-in in /opt/DevKit/devkitplugins/devtools.
      Successfully upgraded the debugger plug-in in /opt/DevKit/devkitplugins/debugger.
      Successfully upgraded the sys_perf plug-in in /opt/DevKit/devkitplugins/sys_perf.
      Successfully upgraded the java_perf plug-in in /opt/DevKit/devkitplugins/java_perf.
      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.