# 恢复/迁移ROMA Connect实例资产 #### 业务场景 ROMA Connect支持把实例的应用和任务以资产文件形式导出，也可以把资产文件导入ROMA Connect，实现集成资产的快速恢复或迁移，资产文件的导入导出操作请参见[导入导出ROMA Connect实例资产](https://support.huaweicloud.com/usermanual-roma/roma_03_0045.html)。 - **资产恢复** ：从ROMA Connect实例导出集成资产进行数据备份，若后续因实例故障或数据丢失需要恢复资产数据，可将备份的资产文件再导入实例进行资产恢复。 建议定期导出资产文件进行数据备份（如按月导出资产文件），以供数据恢复使用。 - **资产迁移**：把其他ROMA Connect实例导出的集成资产文件导入新建的实例，实现集成资产的快速部署和使用。 ROMA Connect的资产导入功能仅支持集成资产数据导入，不支持资产相关的实例配置数据导入。在完成集成资产的导入后，还需要完成资产相关的实例配置。 表1实例配置 | 分类 | 数据项 | 说明 | 处理方式 | |:---|:---|:---|:---| | 实例公共 | 集成应用的Secret | 集成应用的Secret为非资产数据。 | 资产导入后系统自动生成新的Secret，需要通知业务应用更新Secret。 | | 实例公共 | 集成应用的授权信息 | 集成应用的用户授权信息为非资产数据。 | 资产导入后重新配置用户授权。 | | 数据集成 | 数据源的连接信息 | 数据源的连接信息包括地址、账号和密码，为非资产数据。 | 资产导入后重新为对应数据源配置连接信息。 | | 服务集成 | 未发布RELEASE环境的API | 未发布RELEASE环境的API包括未发布的API和发布在非RELEASE环境的API，为非资产数据。 | 资产导入后根据需要重新创建和发布API。 | | 服务集成 | API的环境类信息 | API的环境类信息包括独立域名、环境变量、负载通道的云服务器信息、非默认的环境，为非资产数据。 | 资产导入后需重新配置环境类信息。 | | 服务集成 | API的控制策略信息 | API的控制策略信息包括流量控制策略、访问控制策略、客户端访问控制策略和客户端配额策略，为非资产数据。 | 资产导入后重新配置控制策略信息。 | | 服务集成 | API的密钥类信息 | API的密钥类信息包括签名密钥、客户端的AppCode、自定义后端的密码和证书类型配置值，为非资产数据。 | 资产导入后： - 系统自动为签名密钥生成新的Key和Secret，需要通知后端服务更新Key和Secret。 - 重新配置客户端的AppCode。 - 重新为自定义后端配置项配置密码和证书的值。 | | 服务集成 | API授权的黑白名单 | API授权的黑白名单信息为非资产数据。 | 资产导入后重新配置黑白名单信息。 | | 设备集成 | 设备信息 | 设备信息非资产数据。 | 资产导入后重新创建设备信息。 | | 设备集成 | 设备的规则信息 | 设备的规则信息非资产数据。 | 资产导入后重新创建设备的规则信息。 | #### 业务流程 集成资产的恢复/迁移流程如下表所示。 表2业务流程 | 序号 | 操作 | 说明 | |:---|:---|:---| | 1 | [准备工作] | 获取集成资产包，并收集周边系统（如数据源、后端服务、业务应用）的对接信息。 | | 2 | [修改实例配置] | 修改待恢复或新实例的安全组、配置参数等配置。 | | 3 | [导入集成资产] | 在待恢复或新实例中导入集成资产包。 | | 4 | [修改集成应用配置] | 修改集成应用的授权配置。 | | 5 | [修改数据源配置] | 修改数据源的连接配置。 | | 6 | [修改API配置] | 修改API的环境、控制策略、密钥、黑白名单等配置。 | | 7 | [修改设备配置] | 批量创建设备和规则。 | | 8 | [业务对接适配和验证] | 周边业务系统的对接适配和业务验证。 | #### 准备工作 在进行集成资产的恢复或迁移前，您需要做如下准备： - 准备集成资产包。 获取用于导入的集成资产包。 - 获取资产包所属源实例的配置信息，仅资产迁移场景需要。 主要包括实例的安全组配置、实例配置参数和数据字典信息。 - 获取周边系统的对接信息，仅资产迁移场景需要。 | 系统 | 数据项 | 用途 | |:---|:---|:---| | 数据源 | 数据源的访问IP、用户名和密码。 | 用于ROMA Connect对接数据源。 | | 业务应用 | 业务应用的网段信息。 | 用于打通ROMA Connect到业务应用的网络。 | #### 修改实例配置 在导入集成资产前，需要修改要导入集成资产实例参数配置，包括安全组、路由、实例配置参数、数据字典等。 在资产迁移场景，实例配置参数应与资产包所属的源实例一致，否则会导致资产导入失败。 1. 登录[ROMA Connect控制台](https://console.huaweicloud.com/roma3)，在左侧导航栏选择"资源管理"，在实例页面单击实例，进入实例控制台。 2. 修改安全组配置，仅资产迁移场景需要，否则跳过此步。 1. 在"实例信息"页面的"基本信息"页签下，单击安全组的名称。 2. 在安全组配置页面中，根据[准备工作]中获取的源实例安全组信息和新实例的实际组网需求，修改安全组的规则配置。 3. 修改实例路由信息，仅资产迁移场景需要，否则跳过此步。 在"实例信息"页面的"基本信息"页签下，更改路由信息。 4. 修改实例配置参数，仅资产迁移场景需要，否则跳过此步。 在"实例信息"页面的"配置参数"页签下，根据[准备工作]中获取的源实例配置参数信息，修改配置参数。 5. 添加数据字典配置。 在"实例信息"页面的"数据字典"页签下，根据[准备工作]中获取的源实例数据字典信息，添加数据字典配置。 具体创建字典的操作请参见[创建ROMA Connect实例数据字典](https://support.huaweicloud.com/usermanual-roma/roma_03_0044.html)。 #### 导入集成资产 通过ROMA Connect的资产导入功能，把获取到的集成资产包快速导入ROMA Connect实例。 1. 在实例控制台的"实例信息"页面，单击右上角的"导入资产"。 2. 在"导入资产"弹窗中根据实际情况选择"新增导入"或"覆盖导入"。 - 资产恢复场景，选择"覆盖导入"。 - 资产迁移场景，选择"新增导入"。 3. 当选择"覆盖导入"时，根据是否需要覆盖环境配置选择"覆盖"或"不覆盖"。 - 覆盖：当导入的数据源存在同名数据源时，选择更新数据源。 - 不覆盖：当导入的数据源存在同名数据源时，不做更新。 4. 输入前缀。 同一实例的数据集成任务名不可以重复，如含有相同名称的FDI任务，请输入前缀。 5. 在弹窗中选择本地保存的资产文件，并导入。 6. 完成后单击"关闭"，您可以在实例中查看已导入的资产。 #### 修改集成应用配置 集成应用的用户授权信息为非资产数据，在导入集成资产后根据需要重新配置。 - 对于资产恢复场景，需要对导入的集成应用进行配置。 - 对于资产迁移场景，可根据实际使用逐步配置。 1. 在实例控制台的"集成应用"页面，单击集成应用右侧的"应用授权管理"。 2. 在应用授权管理弹窗中，配置应用的授权信息。 具体的授权配置操作和权限说明请参见[配置ROMA Connect集成应用授权](https://support.huaweicloud.com/usermanual-roma/authorize-application.html)。 3. 完成后单击"确认"。 #### 修改数据源配置 数据源的连接信息包括地址、账号和密码，为非资产数据，在导入集成资产后需要重新配置。 1. 在实例控制台的"数据源管理"页面，单击数据源右侧的"编辑"。 2. 在编辑数据源页面修改数据源的连接信息配置。 - 对于资产恢复场景，修改密码配置。 - 对于资产迁移场景，修改实际数据源的地址、用户名和密码配置。 具体的数据源配置参数说明请参见[接入数据源概述](https://support.huaweicloud.com/usermanual-roma/fdi-ug-190429002.html)。 3. 修改完成后，单击"开始检测"，验证ROMA Connect和数据源的连通性。 4. 完成后单击"保存"。 #### 修改API配置 API的环境类信息、控制策略信息、密钥类信息、API授权的黑白名单以及未发布到RELEASE环境的API，为非资产数据，在导入集成资产后需要重新配置。 - 环境类信息包括独立域名、环境变量、负载通道的云服务器信息、非默认的环境。 - 控制策略信息包括流量控制策略、访问控制策略、客户端访问控制策略和客户端配额策略。 - 密钥类信息包括客户端的AppCode、自定义后端的密码和证书类型配置值。 **配置环境类信息** 1. 绑定独立域名。 1. 在实例控制台的"服务集成 APIC \> API分组"页面，单击API分组的名称进入API运行页面。 2. 在页面左上角选择"分组信息"页签，在"域名管理"下单击"绑定独立域名"，为API分组绑定独立域名。 具体配置参数说明请参见[为API分组绑定域名](https://support.huaweicloud.com/usermanual-roma/roma_03_2109.html)。 3. 完成后单击"确定"。 2. 新建发布环境。 1. 在实例控制台的"服务集成 APIC \> API策略"页面，选择"环境管理"页签。 2. 单击"创建环境"，新建API的发布环境。 3. 完成后单击"确定"。 3. 添加环境变量。 1. 在实例控制台的"服务集成 APIC \> API分组"页面，单击API分组的名称进入API运行页面。 2. 在页面左上角选择"分组信息"页签，在"环境变量"下的"环境"参数中选择要添加变量的环境，然后单击"添加环境变量"。 具体配置参数说明请参见[创建环境变量](https://support.huaweicloud.com/usermanual-roma/roma_03_2107.html#roma_03_2107__section155781394118)。 3. 完成后单击"确定"。 4. 修改负载通道的服务器信息。 1. 在实例控制台的"服务集成 APIC \> API策略"页面，选择"负载通道"页签。 2. 单击负载通道右侧的"编辑"。 3. 在编辑负载通道页面，修改通道内服务器配置。 - 对于"服务器添加方式"为"选择云服务器"的负载通道，单击"添加云服务器"，添加负载通道内的服务器。 - 对于"服务器添加方式"为"指定服务器地址"的负载通道，根据实际使用的后端服务器，修改后端服务地址。 具体配置参数说明请参见[创建API的负载通道（可选）](https://support.huaweicloud.com/usermanual-roma/roma_03_2104.html)。 4. 完成后单击"完成"。 **配置控制策略信息** 1. 配置流量控制策略。 1. 在实例控制台的"服务集成 APIC \> API策略"页面，选择"策略管理"页签。 2. 单击"创建策略"，在选择策略类型弹窗中选择"传统策略 \> 流量控制"。 具体配置参数说明请参见[创建流量控制策略](https://support.huaweicloud.com/usermanual-roma/roma_03_2142.html#roma_03_2142__section8731554122615)。 3. 完成后单击"确定"。 4. 参考[配置API的流量控制](https://support.huaweicloud.com/usermanual-roma/roma_03_2142.html)为API、应用或租户绑定流量控制策略。 2. 配置访问控制策略。 1. 在实例控制台的"服务集成 APIC \> API策略"页面，选择"策略管理"页签。 2. 单击"创建策略"，在选择策略类型弹窗中选择"传统策略 \> 访问控制"。 具体配置参数说明请参见[创建访问控制策略](https://support.huaweicloud.com/usermanual-roma/roma_03_2143.html#roma_03_2143__section18514104361017)。 3. 完成后单击"确定"。 4. 参考[配置API的访问控制](https://support.huaweicloud.com/usermanual-roma/roma_03_2143.html)为API绑定访问控制策略。 3. 配置凭据访问控制策略。 1. 在实例控制台的"服务集成 APIC \> 凭据管理"页面，选择"凭据管理"页签。 2. 在凭据右侧单击"设置访问控制"，设置凭据的访问控制策略。 具体配置参数说明请参见[配置API的凭据访问控制](https://support.huaweicloud.com/usermanual-roma/roma_03_2145.html)。 3. 完成后单击"确定"。 4. 配置凭据配额策略。 1. 在实例控制台的"服务集成 APIC \> 凭据管理"页面，选择"凭据配额策略"页签。 2. 单击"创建凭据配额策略"，添加凭据配额策略。 具体配置参数说明请参见[创建凭据配额策略](https://support.huaweicloud.com/usermanual-roma/roma_03_2144.html#roma_03_2144__section8731554122615)。 3. 完成后单击"确定"。 4. 参考[配置API的凭据配额控制](https://support.huaweicloud.com/usermanual-roma/roma_03_2144.html)为凭据绑定配额策略。 **配置密钥类信息** 1. 添加简易认证凭据。 1. 在实例控制台的"服务集成 APIC \> 凭据管理"页面，选择"凭据管理"页签。 2. 单击凭据的名称，进入凭据详情页面。 3. 在"AppCodes"下，单击"添加AppCode"，为凭据添加AppCode。 4. 完成后单击"确定"。 2. 配置自定义后端的密码和证书类型配置的值。 1. 在实例控制台的"服务集成 APIC \> 自定义后端"页面，选择"配置管理"页签。 2. 单击配置右侧的"编辑"。 - 密码类型配置需要修改密码的配置值。 - 证书类型配置需要修改证书内容和私钥。 3. 完成后单击"确定"。 **修改API授权的黑白名单** 仅"APP认证"类型的API支持进行授权配置。 1. 在实例控制台的"服务集成 APIC \> API列表"页面，单击API右侧的"更多 \> 授权"。 2. 在"授权历史"弹窗中，单击授权凭据右侧的"绿色通道 \> 编辑"，根据实际需要修改黑白名单。 3. 完成后单击"确定"。 **创建API并发布到非RELEASE环境** 1. 在实例控制台的"服务集成 APIC \> API列表"页面，单击"创建API"，根据实际需要新建API。 具体配置过程和参数说明请参见[通过APIC创建REST API](https://support.huaweicloud.com/usermanual-roma/roma_03_2105.html)。 2. 完成后参考[发布APIC创建的API](https://support.huaweicloud.com/usermanual-roma/roma_03_2108.html)，把API发布到环境。 #### 修改设备配置 设备信息和设备的规则信息为非资产数据，在导入集成资产后需要重新配置。可通过设备导入和规则导入功能，批量恢复或新建设备和规则信息。 1. （可选）准备设备列表和规则列表文件。 从资产包所属的源实例获取导出的设备列表和规则列表文件。 2. 创建设备。 1. 在实例控制台的"设备集成 LINK \> 设备管理"页面。 - 若获取到设备列表文件，则单击"导入设备"，通过导入设备列表文件创建设备。 - 若未获取到设备列表文件，则单击"创建设备"，手动创建设备。 具体配置参数说明请参见[创建设备](https://support.huaweicloud.com/usermanual-roma/register-device.html#register-device__section1144873772813)。 2. 完成后，在页面的设备列表中可查看创建的设备。 3. 创建规则。 1. 在实例控制台的"设备集成 LINK \> 规则引擎"页面。 - 若获取到规则列表文件，则单击"导入规则"，通过导入规则列表文件创建规则。 - 若未获取到规则列表文件，则单击"创建规则"，手动创建规则。 具体配置参数说明请参见[创建规则](https://support.huaweicloud.com/usermanual-roma/rule-engine-basic.html#rule-engine-basic__section13651325142313)。 2. 完成后，在页面的规则列表中可查看创建的规则。 #### 业务对接适配和验证 在ROMA Connect实例中完成集成资产的恢复或迁移后，周边对接的业务应用也需要完成相应的对接适配，才能正常处理业务。 与ROMA Connect对接的业务应用或设备，需要修改如下对接配置。 | 分类 | 业务场景 | 配置数据 | |:---|:---|:---| | 服务集成 | 调用API | - API的调用地址（仅资产迁移场景需要）。 - API的认证信息，包括集成应用/客户端的Key和Secret、AppCode、AK/SK。 - 后端服务签名密钥的Key和Secret。 | | 消息集成 | 发送和接收消息 | - Topic的连接地址（仅资产迁移场景需要）。 - 启用SASL认证时使用的认证Key和Secret。 | | 设备集成 | 设备上报消息和下发命令 | - 设备的连接地址（仅资产迁移场景需要）。 - 设备的接入认证信息，包括客户端ID、用户名和密码。 | 业务应用完成对接适配后，需验证业务是否正常。 - 业务应用调用API是否正常。 - 业务应用向ROMA Connect的Topic收发消息是否正常。 - 设备向ROMA Connect收发数据是否正常，规则引擎是否正常转发数据。