场景

用户可以将当前DM服务从低版本（X）升级到高版本（Y），还可以删除现有服务或安装新服务。

安装包中包含dmServer_upgrade.json文件，即待升级、删除或安装的服务列表。

 说明：

• DM升级后，请刷新浏览器使更新生效。
• DM升级后，请升级DMAgent。详情请参见表2中“升级”相关描述。从服务器升级包中选择Agent软件包，具体路径如下：

  software/Agent/APA_InfraAgent/APA_InfraAgent.tar.gz

前提条件

升级前，遵循以下条件：

• 仅支持从低版本到高版本的升级。
• 仅支持对存量服务进行升级或删除。
• 升级过程中仅安装新服务或当前版本未安装的服务（详见installed_summary文件的更新内容）。
• 同一服务不可同时在两个进程中进行：
  • 删除+升级
  • 删除+安装
  • 升级+安装
• 升级DM仅需执行升级包中的update.sql文件。
• 如果发生任何故障，系统将完全回滚到之前的状态。
• 服务升级后，版本信息必须为dmServer_upgrade.json文件的dmversion区域中显示的新版本。
• 压缩包必须包含dmServer_upgrade.json和upgrade.py文件，并包含待安装、升级或删除的服务列表及其相关软件包的详细信息。
• 仅当低版本到高版本升级时，解压升级包才会生成dmServer_upgrade.json和upgrade.py文件。

操作步骤

1. 执行以下命令进行升级：

   python upgrade.py upgrade

   [dminstalluser@blrlabvm_171_29 ~]$ python upgrade.py upgrade
   [ 2/2 ] Taking DB schema backup                            COMPLETED
   [ 8/8 ] Pre Check for upgrade -                            COMPLETED
   [ 8/8 ] Stopping for Upgrade -                             COMPLETED
   [ 8/8 ] Verify Stop -                                      COMPLETED
   [ 8/8 ] Backup -                                           COMPLETED
   [ 8/8 ] Preparing for Upgrade -                            COMPLETED
   [ 8/8 ] Deploying Upgrade -                                COMPLETED
   [ 8/8 ] Configuring Upgrade -                              COMPLETED
   [ 8/8 ] Staring after Upgrade -                            COMPLETED
   [ 8/8 ] Verify Start -                                     COMPLETED
   Registering services...
   . . .
   Database Manager has been upgraded successfully.

2. 执行以下命令打印软件工具的帮助信息：

   python upgrade.py (help | --help | -h)

   该工具为DMServer的日常运营提供支持。

   [dminstalluser@blrlabvm_171_29 ~]$ python upgrade.py help
   Database Manager(DM) Server Upgrade help:
   Utility to support upgrade of DM server.
   This script should not be run with root permission.
   Usage:
       upgrade.py upgrade   [-a | --apadminpasswd <db-admin-password>] [ --upgrade-log <log file> ]
       upgrade.py           (version | --version | -v)
       upgrade.py           [help | --help | -h]
   Commands:
       upgrade                perform the upgrade of the installed services. This process may include
                              upgrade of existing services, deletion of existing services or  installation of new service
   help                   Prints this help text.
   version                Prints version string.
   Options:
       --apadminpasswd | -a     Password for DB admin user accepted via command line argument. Same as given during installation.
                                It is Mandatory argument
       --upgrade-log            Log file to store the logs for the Upgrade process. Recommended to give for ease of debugging
   NOTE:
   1. The backup during upgrade is created in base installed directory and is deleted after successful upgrade or rollback
   [dminstalluser@blrlabvm_171_29 ~]$