1.0.1升级至2.X.X/5.X.X版本
=====================

升级至2.X.X版本与升级至5.X.X版本步骤一致，本文以升级至2.X.X版本为例。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/14/v3/Jyj7LlnYRuuHYfWZ9BtxMg/notice_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073822Z&HW-CC-Expire=86400&HW-CC-Sign=6109D735A788A05C38C50D3E03DB99EF02EFF16F5A4F21D90C31A5B8A7B2BA4B)

在升级之前，请务必备份好ohpm-repo 私仓工具中的历史数据，避免因升级操作失误，导致数据丢失。备份的内容包括ohpm-repo中[<deploy\_root>](#li10435216234)部署根目录内的数据、db元数据以及store三方包数据，详细可参考[数据备份](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-ohpm-repo-data-backup)。

1.  旧版本服务停止：如果旧版本的服务还在运行，升级版本前请停止，进入1.0.1版本ohpm-repo私仓工具包解压目录下的bin目录，执行stop。
    
    ohpm-repo stop
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/72/v3/LmMfTX37Q-2z7daMRL-2-A/caution_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073822Z&HW-CC-Expire=86400&HW-CC-Sign=0243FD953CBB8789B6DE95FF46622A1F5DD6977BE7BC70C7565E2D69AB21675B)
    
    若您想在其他目录使用ohpm-repo，请将对应版本ohpm-repo工具包解压目录中bin目录的路径配置到[系统环境变量](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-ohpm-repo-faq#section24117279211)path中。
    

2.  下载并解压工具包：下载版本2.X.X的ohpm-repo私仓工具包，并解压（请解压到一个空文件夹中）。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/60/v3/pI0lEtZuROOXwyNyHgbJPw/zh-cn_image_0000002594632030.png?HW-CC-KV=V1&HW-CC-Date=20260612T073822Z&HW-CC-Expire=86400&HW-CC-Sign=E9DDEA798B019917AE08F351C94D070C23660D9EAC374EEEAA05C6970405D4EE)
    

3.  安装完成之后，进入ohpm-repo 私仓工具包解压目录下的bin目录，执行如下命令：
    
    ohpm-repo -v
    
    终端输出版本号2.X.X，则表示解压成功。
    

4.  移植配置文件信息：版本2.X.X的配置文件与版本1.0.1相比有较大差异，需要提取旧版本配置文件信息至新版本配置文件中，移植的具体内容如下：
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/99/v3/hIhTzADuSP-gUKXdyHnxEg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073822Z&HW-CC-Expire=86400&HW-CC-Sign=D7BC3DA364CEE0238075684271917B2B952F8E3935294EAA8C41EF8EEC439F67)
    
    *   如果ohpm-repo版本1.0.1使用的配置文件，配置项均为默认项，则无需移植配置文件信息，直接执行下一步启动操作。
    *   旧版本1.0.1配置文件路径为：\`<deploy\_root>/conf/config.yaml\`；新版本2.X.X配置文件路径为：<2.X.X版本ohpm-repo解压目录>/conf/config.yaml。
    *   <deploy\_root>：ohpm-repo部署根目录
        1.  windows系统: ~/AppData/Roaming/Huawei/ohpm-repo
        2.  其他操作系统：~/ohpm-repo
    
    *   **[listen](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-ohpm-repo-configuration#zh-cn_topic_0000001745376470_listen)**：旧版本listen值拷贝替换到新版本listen中。如果旧版本是在执行start时指定的listen值，需要把对应的listen值填入新版本配置文件中，新版本中listen值不支持命令行指定。
    *   **[https](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-ohpm-repo-configuration#zh-cn_topic_0000001745376470_https)**：如果listen配置的协议是https，需要拷贝https的值：旧版本https.key和https.cert路径信息对应拷贝替换到新版本https\_key和https\_cert中。
        
        \# 旧版本 \`1.0.1\`
        https:
          key: ./ssl/server.key     
          cert: ./ssl/server.crt
        
        # 新版本 \`2.X.X\`
        https\_key: ./ssl/server.key       
        https\_cert: ./ssl/server.crt  
        
    *   **[server](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-ohpm-repo-configuration#zh-cn_topic_0000001745376470_server)**： 旧版本server有八个参数信息，对应拷贝到新版本server numeric limit section模块下，拷贝替换对应数字。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a3/v3/0CIqfd2fQ9ayGvirCnOM2g/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073822Z&HW-CC-Expire=86400&HW-CC-Sign=B359FEC752D5A15559C8CCAA36F3582CCE2E17E52BED0429ECB6ABAC3C933F83)
        
        *   版本1.1.0开始，新增参数api\_timeout。
        *   版本升级时，参数信息会有变化，具体信息可在<解压目录>/conf/config.yaml文件中获取。
        
        \# 旧版本 \`1.0.1\`
        server:
          max\_package\_size: 10
          max\_extract\_size: 50
          max\_extract\_file\_num: 10240
          user\_rate\_limit: 100
          fetch\_timeout: 60
          keep\_alive\_timeout: 60
          upload\_lock\_hour: 24
          upload\_max\_times: 100     
        
        # 新版本 \`2.X.X\`
        max\_package\_size: 10
        max\_extract\_size: 50
        max\_extract\_file\_num: 10240
        user\_rate\_limit: 100
        fetch\_timeout: 60
        keep\_alive\_timeout: 60
        api\_timeout: 60
        upload\_lock\_hour: 24
        upload\_max\_times: 100     
        
    *   **[db](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-ohpm-repo-configuration#zh-cn_topic_0000001745376470_db)**：旧版本仅支持本地filedb存储，不支持mysql，故使用新版本db.type为filedb的模板，拷贝替换旧版本db.plugin\_config.path路径信息至新版本db.config.path中。
        
        \# 旧版本 \`1.0.1\`
        db:
          plugin\_name: ohpm-repo-plugin-filedb
          plugin\_config:
            path: ./db  
        
        # 新版本 \`2.X.X\`
        db:
          type: filedb
          config:
            path: ./db     
        
    *   **[store](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-ohpm-repo-configuration#zh-cn_topic_0000001745376470_store)**：旧版本仅支持本地storage存储，不支持sftp，故使用新版本store.type为fs的模板，拷贝替换旧版本store.plugin\_config.path路径信息和store.plugin\_config.server值至新版本对应的store.config.path和 store.config.server中。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/06/v3/2uZg5OdVTOKjZGM7LRUjCA/caution_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073822Z&HW-CC-Expire=86400&HW-CC-Sign=C69B56050DCBBBD9452FEBC09BA92049D9FB01D22E26A0BC0E7B3C40677C0227)
        
        在ohpm-repo 2.0.0版本中，listen的默认值已更改为listen: 0.0.0.0:8088，如果listen的host配置为0.0.0.0，则字段store.config.server不可省略**，必须**配置为详细地址，例如_http://localhost:8088_。
        
        _\# 旧版本 \`1.0.1\`_
        _store:_
          _plugin\_name: ohpm-repo-plugin-fs_
          _plugin\_config:_
            _path: ./storage_
            _#server: http://localhost:8088_
        
        _\# 新版本 \`2.X.X\`_
        _store:_
          _type: fs_
          _config:_
            _path: ./storage_
            _#server: http://localhost:8088_
        
    *   **[uplink](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-ohpm-repo-configuration#zh-cn_topic_0000001745376470_uplink)**：拷贝旧版本uplink.store\_path路径信息和uplink.cache\_time缓存时间信息至新版本对应的uplink\_store\_path和uplink\_cache\_time中
        
        \# 旧版本 \`1.0.1\`
        uplink:
          store\_path: ./uplink
          cache\_time: 168
          
        # 新版本 \`2.X.X\`
        uplink\_store\_path: ./uplink
        uplink\_cache\_time: 168
        
5.  （可选项）新版本如果需要使用新的部署目录<new\_deploy\_root>，需要手动迁移数据。
    
    *   解压与替换配置信息：按照步骤1-4，解压和拷贝替换配置文件信息。
    *   建立新部署目录：判断指定的新部署目录<new\_deploy\_root>是否存在，不存在则新建，新部署目录需存在且为空。
    *   拷贝数据文件：拷贝旧版本部署目录[<deploy\_root>](#li10435216234)下的全部文件至新部署目录<new\_deploy\_root>中。
    *   修改新版本ohpm-repo配置文件：打开新版本ohpm-repo 2.0.0的解压目录，进入conf目录下，修改新配置文件config.yaml，修改配置项deploy\_root为新的部署目录<new\_deploy\_root>。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b7/v3/FGmKrRVARn2g1mLHK9dyFg/caution_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073822Z&HW-CC-Expire=86400&HW-CC-Sign=864DAD7F9D4604D7CE3DBECF3AF7BC89BC5CB247BB4B599F137D2A11E4810799)
    
    在使用新部署目录时，旧版本部署目录中meta文件一定要迁移到新版本部署目录中，否则使用meta加密组件加密的数据无法被正确解密。
    
6.  新版本服务启动：正确拷贝替换配置文件信息后，进入ohpm-repo私仓工具包解压目录下的bin目录，执行下面语句启动新版本服务：
    *   执行安装命令：
        
        ohpm-repo install
        
        结果示例：
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/16/v3/3U7VWwIvScWZeoTcswmBTw/zh-cn_image_0000002594472110.png?HW-CC-KV=V1&HW-CC-Date=20260612T073822Z&HW-CC-Expire=86400&HW-CC-Sign=C36ACFC3BBA983DE417593B28B2465766B2A4C412B758F23826F3A006408868F "点击放大")
        
    *   刷新环境变量：安装成功后，必须根据给出的提示信息刷新环境变量，针对Windows系统和Linux/Mac系统，有不同处理方式：
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/1e/v3/T6j6lvUrTDCh4chVGNW5Ug/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073822Z&HW-CC-Expire=86400&HW-CC-Sign=8137CFDA29FE63D03FE871E7C50B826E758C58C38898E4BEEC52B7F94B227A12)
        
        *   Windows系统： 关闭当前窗口，重新开启一个窗口
            
        *   Linux系统或Mac系统：在命令行中执行刷新命令：_source ~/.bashrc_或者. _~/.bashrc_。
            
        
    *   执行启动start命令：
        
        ohpm-repo start
        
        结果示例：
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d6/v3/LSGn0U6ISRCuDPpFgWEShg/zh-cn_image_0000002624991465.png?HW-CC-KV=V1&HW-CC-Date=20260612T073822Z&HW-CC-Expire=86400&HW-CC-Sign=D8D29904BD1109AB8B065DC644A14B211E2B5295A746447DF670D89B8662C6FC "点击放大")
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/bd/v3/LX5CcJkcRNuFiUB3gJjkkA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073822Z&HW-CC-Expire=86400&HW-CC-Sign=8783C631FC09B599EB33F3085B7108E1B5DECD76D752428E8E77B30748524121)
        
        版本升级之前，如果浏览器中已访问ohpm-repo页面，版本升级之后请刷新ohpm-repo页面。