从经典版迁移到 Standard Edition

Standard Edition 的优势

借助 Standard Edition ，您可以：

可使用 Instana 的新功能，包括基础设施分析、智能警报和自定义仪表盘，以及日志、合成监控、 OpenTelemetry, 自动化、AI代理和大型语言模型（LLM）可观测性等
使用命令行 stanctl 界面 (CLI) 管理您的部署
随着监控需求的增加，扩展您的环境
选择最符合您需求的部署拓扑，包括单节点系统、三节点集群或五节点集群

迁移方法

请按照以下步骤将系统迁移至 Standard Edition。为降低迁移风险，请在过渡期间并行运行经典版和 Standard Edition。

根据您现有的经典版环境配置 Standard Edition。
配置代理，使其向这两个环境发送数据。
在 Standard Edition 中，用两到四周的时间对数据采集、配置和运维工作流进行验证。
当您对验证结果满意后，请重新配置代理，使其仅向 Standard Edition 发送数据，并停用经典版。

您可以自主掌控迁移时间表，并在确信 Standard Edition 部署已满足您的需求后完成过渡。

准备工作

在开始迁移之前，请检查部署拓扑的规格要求，并完成安装的先决条件。有关更多信息，请参阅以下主题：

如果您在规格选择或部署规划方面需要帮助，请通过 IBM® 支持门户或联系您的 IBM 客户代表。

先决条件

您可以从自托管经典版（ Docker ）迁移租户单元配置数据。其中包括用户设置、仪表板、事件、警报、应用程序视图、EUM 网站和移动应用程序。其中还包含其他数据。

重要信息：

来自您的 Instana 代理的分析和指标数据无法迁移。

支持以下迁移路径：

从经典版到单节点、三节点或五节点的 Standard Edition

注：

您可以使用 Classic Edition 的同一份许可证迁移至 Standard Edition。

重要信息：

您无法将经典版的数据迁移到已安装 Standard Edition 的主机上。您必须使用新的主机。

完成以下先决条件：

请按照 “准备单节点环境 ”或 “准备多节点环境 ”中的说明，准备您的新主机。
- Standard Edition 所需的最低硬件配置高于基础安装版本，因为它支持更广泛的功能和可扩展性选项。有关详细要求，请参阅 “单节点要求 ”。
安装该 stanctl 二进制文件。有关安装的详细信息，请参阅 Stanctl 安装说明。
请确保旧主机和新主机上的 Instana 后端的主发布版本相同。要在经典版上查看后端版本，请运行以下命令：
```
instana images version
```
要确定 Standard Edition 的对应版本 stanctl ，请参阅您所用 Instana 版本的发布说明中的兼容性对照表。如有必要，请升级后端：
- 要在经典版上升级 Instana 后端，请参阅《升级经典版》。 Classic Edition 上的 Instana 后端必须是 271 版或更高版本。
- 若要升级 Standard Edition 上的 Instana 后端，请参阅《升级 Standard Edition 》。
对于物理隔离环境下的迁移，请在堡垒主机上创建一个物理隔离环境包，将该包传输到物理隔离主机，在物理隔离主机上安装 stanctl ，然后在物理隔离主机上导入该包。

迁移至 Standard Edition

要迁移数据，请完成以下步骤：

从 Postgres 数据存储中提取租户单元配置数据。
- 在 Classic Edition 主机上运行以下命令：
```
instana dump config-data
```
在该 ./dump 目录下创建了一个 dump.tar.gz 文件。该文件包含以可执行 SQL 查询形式呈现的租户单元配置数据。
将该软件包 dump.tar.gz 从旧主机迁移到您的新 Standard Edition 主机上。

在您的全新 Standard Edition 主机上，将数据从文件 dump.tar.gz 中迁移过来。

Migration parameters

参数	用法	示例
--volume-data =<自定义目录>	指定用于存储 Elasticsearch、 PostgreSQL, 和 Kafka 数据存储的配置和运行数据的目录缺省值： /mnt/instana/stanctl/data	--volume-data=/custom/data/path
--volume-metrics =<自定义目录>	指定用于存储 Cassandra 和 BeeInstana 数据存储中指标和时间序列数据的目录缺省值： /mnt/instana/stanctl/metrics	--volume-metrics=/custom/metrics/path
--volume-analytics =<自定义目录>	指定用于存储 ClickHouse 数据存储中分析数据的目录缺省值： /mnt/instana/stanctl/analytics	--volume-analytics=/custom/analytics/path
--volume-objects =<自定义目录>	指定用于存储对象存储数据（包括跟踪信息和监控数据）的目录缺省值： /mnt/instana/stanctl/objects	--volume-objects=/custom/objects/path

对于单节点部署，请运行以下命令：

在线迁移
```
stanctl migrate -f </path/to/tar.gz>
```

物理隔离迁移

stanctl migrate --air-gapped -f </path/to/tar.gz>

对于多节点部署，请运行以下命令：

在线迁移

stanctl migrate --file=</path/to/tar.gz> --multi-node-enable --multi-node-ips=<node0IPaddress,node1IPaddress,node2IPaddress>

物理隔离迁移

stanctl migrate --air-gapped --file=</path/to/tar.gz> --multi-node-enable --multi-node-ips=<node0IPaddress,node1IPaddress,node2IPaddress>

将显示以下对话框。

Are you migrating from the Classic offering?

输入“是”。所有服务均保留单域名模式。
执行该命令后，你会看到以下提示符：
```
? Choose installation type:
 demo <
 production
```

选择 production.

注：

演示安装类型仅适用于测试和演示环境。请勿 demo 在生产环境中使用。

当迁移成功完成后，会显示一条确认消息，如下例所示：


   ╭──────────────────────────────────────────────╮ 
   │                                              │ 
   │ Migration completed successfully!            │ 
   │ You can now install Instana Standard Edition. │ 
   │                                              │ 
   ╰──────────────────────────────────────────────╯

使用从旧主机迁移过来的租户单元配置数据，安装 Standard Edition。如需了解更多信息，请参阅《在在线环境中安装 Standard Edition 》或《在隔离环境中安装 Standard Edition 》。

注：
如果您想配置其他设置（例如自定义证书、SMTP 配置、代理等），请参阅 Instana 中的后端配置。您可以使用该 stanctl up 命令配合配置标志来配置这些设置，包括所需的功能标志。

安装成功完成后，将显示类似以下示例的消息：

*****************************************************************
* Successfully installed Instana Self-Hosted Standard Edition! *
*                                                               *
* URL: https://instana.example.com                              *
* Username: admin@instana.local                                 *
*****************************************************************

您可以使用在旧版经典版环境中使用的同一租户密码登录新的 Standard Edition 用户界面。

迁移后的任务

迁移完成后，如有必要，您可能需要重新进行旧主机上的一些配置。您可以按照以下列表中的建议进行重新配置，以使 Standard Edition 正常运行。

默认情况下，新的 Standard Edition 实例未连接到任何代理。请将代理配置为同时向旧的 Classic Edition 环境和新的 Standard Edition 环境发送数据，以便您在验证期间能够并行运行这两个环境。若要将代理连接到新旧后端，请参阅 “配置多个后端”。
迁移完成后，当新旧环境均与您的代理连接时， Instana 的两个环境都会针对相同的事件触发警报。为避免警报重复，您可以在其中一个 Instana 实例上设置维护时段。如需了解更多信息，请参阅 “安排维护时段 ”。
在旧环境中启用的功能开关并未迁移到 Standard Edition。您必须在新环境中手动重新启用该功能开关。如需了解更多信息，请参阅 “可选功能”。
将 Classic Edition 迁移至 Standard Edition 时，所有 Ingress 流量（包括代理、UI 以及 API 流量）默认均由单个域名（即基础域名）处理。若要恢复此行为，请在迁移完成后运行以下命令：
```
stanctl backend apply \
--core-use-tu-url-path=false \
--core-acceptors-agent-host=<desired-agent-acceptor-domain> \
--core-acceptors-agent-port=<desired-agent-acceptor-port>
```

并行迁移操作的局限性

当经典版和 Standard Edition 同时运行且均已连接到您的代理时，将适用以下限制：

代理端限制
- Instana 代理中的 Kubernetes 传感器不支持两个 Instana 后端配置。有关解决方法，请参阅《针对 Kubernetes 监控向多个后端提交报告》。
- EUM（最终用户监控）客户端不支持向两个 Instana 后端发送报告。
- 无服务器客户端实现不支持向两个 Instana 后端发送报告。
后端方面的限制
- 迁移完成后所做的配置更改不会在两个 Instana 后端之间自动同步。

故障诊断

迁移后，您可能会遇到一些问题。如果您无法解决这些问题，请联系 IBM 客服。

无法使用旧密码访问 Standard Edition

如果您使用环境文件（.env）安装了 Standard Edition ，并且指定了'STANCTL_UNIT_INITIAL_ADMIN_PASSWORD'，则该密码将被忽略。请参阅以下示例。

STANCTL_UNIT_INITIAL_ADMIN_PASSWORD=instana1

相反，系统会将您迁移前使用的经典版管理员密码作为初始管理员密码。

如果您无法获取旧版经典版的管理员密码，可以重置管理员密码。如需了解更多信息，请参阅 “更改管理员或用户密码”。

重置 IdP 配置

若要在迁移至 Standard Edition 后重置 IdP 的配置，请参阅《重置 IdP 的配置》。