升级
升级可能会令人望而生畏，特别是在生产部署中，即使在这些场景中，我们也致力于提供流畅的体验。
也就是说，有多种不同的升级和迁移场景取决于多种因素。
在本页中，我们将解释我们支持的升级和迁移路径，并提供一步一步的说明来执行成功的升级或迁移。
支持的升级和迁移路径
首先，让我们建立现有的不同类型的部署:
- 独立的RapidMiner服务器:手动安装，而不是容器化(9.7以下的任何版本)
- RapidMiner平台:容器化(9.4到9.6之间的任何版本)
- 具有集中身份的RapidMiner平台: containerized(9.7版)
我们支持升级到最新版本的独立的RapidMiner服务器，并迁移到最新版本的具有集中身份的RapidMiner平台(都来自于…的旧版本独立的RapidMiner服务器从旧版本的RapidMiner平台）.
从…的一个版本升级独立的RapidMiner服务器要获取最新版本，请遵循服务器升级指南。
迁移到的最新版本具有集中身份的RapidMiner平台，请遵循我们的迁移向导在下面。
以集中身份迁移到最新版本的RapidMiner平台
根据要迁移的源版本和部署风格的不同，您需要遵循的步骤略有不同。为下面的部署选择正确的章节。
从单机RapidMiner服务器迁移
- 下载一个部署模板最新版本
- RapidMiner服务器主文件夹:您将在RapidMiner平台部署中使用您现有的主文件夹。要做到这一点，您需要更改docker卷定义
docker-compose.yml指向主机磁盘上的主文件夹的绑定挂载。 - 确保使用UID 1000的用户可以在主机上访问RapidMiner Server主文件夹。要做到这一点，请运行
chown -R 1000:1000 ./your-rmserver-home-folder。即使系统上不存在这样的用户，该命令也可以工作。这是必需的，以便docker容器中的用户可以正确访问文件夹内容。 - RapidMiner服务器数据库:您可以选择以下三个选项之一:
- 转储旧SQL数据库的内容，并将其加载到将作为docker容器运行的新数据库中。这只适用于使用PostgreSQL数据库的情况。
- 创建一个绑定挂载，指向磁盘上的数据库存储。这只适用于使用PostgreSQL数据库的情况。
- 如果您打算保留现有的数据库后端(可能是因为您希望将其与平台分开管理，或者它不是PostgreSQL数据库)，请编辑您的
.env文件以包含此数据库的地址和凭据。你需要修改这些变量:SERVER_DBHOST，SERVER_DBSCHEMA，SERVER_DBUSER，SERVER_DBPASS。
- 在主机上，通过运行来初始化部署堆栈
Docker-compose up -d rm-init-svc - 您可以通过运行来检查初始化过程何时完成
Docker-compose日志rm-init-svc。当看到初始化成功完成的消息时，点击ctrl - c回到你的终点站。 - 通过运行启动堆栈
Docker-compose up -d - 一切启动后，您将能够登录在步骤5中指定的地址。一开始只有默认值
管理用户可以进行身份验证，用户迁移需要单独进行。
要完成迁移，还需要两个手动步骤。
- 如果需要，在RapidMiner Server中执行数据库模式迁移。当您第一次登录到平台并导航到RapidMiner服务器时，会提示您这样做。
- 创建用户它存在于旧的装置中。我们正在编写一个迁移脚本，使其自动化，但目前还必须手动完成。如果可以的话，我们也鼓励配置身份联合。
从旧版本的RapidMiner平台迁移
- 备份Python环境从平台管理工具。
- 备份你的旧文件
docker-compose.yml和.env文件(.env仅在版本中引入9.6）. - 下载一个部署模板最新版本
- 使用您喜欢的文本编辑器根据旧的定义文件修改模板。这些是你应该迁移的东西:
- 环境变量值(注:前版本)9.6，将变量值存储在
docker-compose.yml文件，并已被转移到.env文件) - 任何额外的容器定义及其配置(例如额外的Job Agent容器)
确保您迁移了所有以前生成和存储的秘密和密码(所有变量)
秘密，用户或密码以他们的名字)从你的老.env文件，否则升级后将无法登录。
- 环境变量值(注:前版本)9.6，将变量值存储在
- 将部署的公共DNS名称(如果没有配置DNS项，则为IP地址)添加到
PUBLIC_URL和SSO_PUBLIC_URL的变量.env文件。 - 如果您还没有这样做，请重写
docker-compose.yml和.env在运行旧部署的主机上。 - 在主机上，通过运行来初始化部署堆栈
Docker-compose up -d rm-init-svc - 您可以通过运行来检查初始化过程何时完成
Docker-compose日志rm-init-svc。当看到初始化成功完成的消息时，点击ctrl - c回到你的终点站。 - 通过运行启动堆栈
Docker-compose up -d - 一切启动后，您将能够登录在步骤5中指定的地址。一开始只有默认值
管理用户可以进行身份验证，用户迁移需要单独进行。
要完成迁移，还需要两个手动步骤。
- 重新创建备份的Python环境使用平台管理。
- 如果需要，在RapidMiner Server中执行数据库模式迁移。当您第一次登录到平台并导航到RapidMiner服务器时，会提示您这样做。
- 创建用户它存在于旧的装置中。我们正在编写一个迁移脚本，使其自动化，但目前还必须手动完成。如果可以的话，我们也鼓励配置身份联合。
在服务器REST端点上启用旧的HTTP基本身份验证
通过引入KeyCloak组件在RapidMiner平台上实现身份和安全，增加了我们的安全性REST端点上可用的安全级别。
当从现有版本的RapidMiner平台或独立的RapidMiner服务器迁移时，现有的web服务可能已经嵌入到客户端应用程序中，不可能或不希望进行更改。
在这些情况下，可以重新启用以前在这些REST端点上可用的HTTP Basic身份验证。
要启用它，必须设置环境变量LEGACY_REST_BASIC_AUTH_ENABLED来真正的在您的平台部署中。该变量存储在.env文件。您可以使用Docker部署管理器，或手动编辑文件，然后发出Docker-compose up -d来应用更改。
