---
title: 配置迁移路径
description: "在进行系统迁移时，支持用户手动修改迁移路径。修改完成后就可以在添加成分时，选择配置的迁移路径。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengdevps/portingadvisor/systemmigration/DevKit_Porting_0078.html
sourcePath: /source/zh/kunpengdevps/portingadvisor/systemmigration/DevKit_Porting_0078.html
indexId: f4dde93fe5d13550c1c74d275699931efd1681e8288bc0839002dc92181c705579
---
# 配置迁移路径

在进行系统迁移时，支持用户手动修改迁移路径。修改完成后就可以在添加成分时，选择配置的迁移路径。

- mapping_rules.json：用于配置系统迁移的路径，包含源软件版本和目标软件版本。
- component_config.json：用于配置目标成分包，包含目标成分包名称及SHA256值。

在进行自定义跨版本迁移时，可能存在版本兼容性问题，请谨慎使用该功能。


#### 操作步骤

以Redis 4.*增加迁移目标版本Redis 5.0.10为例，需要同步修改Server端（即DevKit安装节点）和Agent端（即迁移工程节点）配置文件。

1. 使用 SSH 远程登录工具，以安装DevKit使用的用户登录目标节点。
2. 配置迁移路径。

  a. 打开mapping_rules.json文件。

    - Server端

```
vi
/opt
/DevKit/devkitplugins/porting/config/mapping_rules.json
```


    - Agent端

```
vi
/opt
/DevKit/devkitplugins/porting/cmd/bin/mapping_rules.json
```


/opt：工具安装目录，请根据实际情况替换。


  b. 按“i”进入编辑模式，新增如下加粗内容。

    - 在version_mapping中，新增4.*（source_version）迁移至5.0.10（target_version）。
    - 若target_version_list中存在5.0.10，则无需修改，且不用执行      配置目标成分包
；若不存在，请添加5.0.10并执行      配置目标成分包
。

```
"Redis": [
{
"target_type": "Redis",
"version_mapping": [
{"source_version": "2.*","target_version":"2.8.24"},
{"source_version": "3.*","target_version":"3.2.13"},
{"source_version": "4.*","target_version":"4.0.14"},
{"source_version": "5.*","target_version":"6.2.14"},
{"source_version": "6.*","target_version":"6.2.14"},
{"source_version": "7.0.*","target_version":"7.0.15"}
,
{"source_version": "4.*","target_version":"
5.0.10
"}
],
"target_version_list": ["2.8.24","3.2.13","4.0.14","6.2.14","7.0.15"
,"5.0.10"
],
"default_version": "2.8.24",
"need_license": false,
"need_mirror_url": true
}
]
```

  c. 按“Esc”键退出编辑模式，输入:wq!，按“Enter”键保存并退出文件。
3. （可选）配置目标成分包。

  a. 打开component_config.json文件。

    - Server端

```
vi
/opt
/DevKit/devkitplugins/porting/config/component_config.json
```


    - Agent端

```
vi
/opt
/DevKit/devkitplugins/porting/cmd/bin/component_config.json
```


  b. 按“i”进入编辑模式，新增如下加粗内容。

```
"Redis":{
"migration_config":{
"download": {
"2.8.24": [{
"name": "redis-2.8.24.tar.gz",
"sha256": "78d17bb989e884879a39216be46a2a13e4f367ecfe1a954815bc929b1e96ff43"
}],
"3.2.13": [{
"name": "redis-3.2.13.tar.gz",
"sha256": "18ff35a2ada48330610b73b4448b2feb3c5896e943a7634fe6274ba51b86e6b5"
}],
"4.0.14": [{
"name": "redis-4.0.14.tar.gz",
"sha256": "8d8194f6e278e48a2f36319d6a697dee7cc82aadc965f9905b085ab51b42901b"
}],
"6.2.14": [{
"name": "redis-6.2.14.tar.gz",
"sha256": "7a729d4bcee7e9ded4d114540734ada7bae3f8b7b4290d50b4cd78df0d5405a0"
}],
"7.0.15": [{
"name": "redis-7.0.15.tar.gz",
"sha256": "d08dcc20b5144fa432742dd0fb53fdafafb53f65268a3a6c1ab81b377a5e33cb"
}]
,
"5.0.10": [{
"name": "redis-5.0.10.tar.gz",
"sha256": "f798eb1324a55f1c0b1e1c62a27ee823efea816d4639cf086f92713d7ce5a694"
}]
}
}
},
```


    5.0.10：表示新增目标软件版本号。 name：表示新增目标软件包名称。 sha256：表示新增目标软件包的SHA256值，可通过sha256sum filename命令获取。

  c. 按“Esc”键退出编辑模式，输入:wq!，按“Enter”键保存并退出文件。
4. 配置完成后，重启Server端DevKit服务。

  - root用户安装
    1 systemctl restart gunicorn_plugin

  - 普通用户安装

```
bash
/home/test01
/DevKit/tools/service_management.sh restart gunicorn_plugin
```


- /home/test01：表示DevKit安装目录，请根据实际路径替换。
- 如果在容器中安装工具，可参考普通用户安装方式通过service_management.sh重启服务。