2.2. 在 OpenShift Container Platform 4.6 及更新的版本上安装 Web 控制台
您可以使用 Migration Toolkit for Runtimes Operator 在 OpenShift Container Platform 4.6 和更新的版本上安装 Web 控制台。
先决条件
- 6 个 vCPU、8 GB RAM 和 40 GB 持久性存储。
您可以在其中安装 Web 控制台的一个或多个项目。
重要不要在 default 项目中安装 Web 控制台。
-
cluster-admin权限，用来为 Runtimes Operator 安装 Migration Toolkit。 -
project-admin-user特权，以便在项目中安装 Web 控制台应用程序。
配置 Red Hat Single Sign-on (SSO)
您必须在安装时决定 Web 控制台是否需要身份验证。如果这样做，您必须首先安装和配置 Red Hat SSO，并在实例化 MTR Operator 时输入一些 RH SSO 设置。
在安装后无法添加或删除身份验证。
- 打开 Red Hat SSO 管理控制台。
- 添加名为 windup 的域。
- 在域中，创建一个名为 windup-web 的客户端。
检查 Access Type 是否已设置为
public。将 Valid Redirect URI 和 Web Origins 设置为*。点 *Save*。请注意，在 MTR 操作器实例化 Valid Redirect URI 和 Web Origins 字段后，必须将 secure-mtr-web-console 路由设置为 secure-mtr-web-console 路由。
- 创建名为 user 的角色。
- 创建一个具有任何名称的用户。
- 设置用户的凭据，禁用 Temporary，并将角色"user"分配给用户。
安装 MTR Operator
-
以具有
cluster-admin权限的用户身份登录 OpenShift Web 控制台。 -
点 Operators
OperatorHub。 - 使用 Search by keyword 字段找到 Migration Toolkit for Runtimes Operator。
- 点 Install。
- 从 Installed Namespace 列表中选择一个项目，再点 Install。
-
点 Operators
Installed Operators 来验证是否安装了 Operator。
安装 Web 控制台应用程序
-
以具有
project-admin-user特权的用户身份登录 OpenShift Web 控制台。 - 切换到 Developer 视角，然后点 +Add。
- 在 Add 视图中，点 Operator Backed。
- 点 Migration Toolkit for Runtimes Operator。
- 点 Create。
- 检查应用设置。如果 Web 控制台需要身份验证，请输入 RH SSO 设置，然后点 Create。
-
在 Topology 视图中，点
mtr-web-console应用，然后点 Resources 选项卡。 - 如果需要身份验证，请将 RH SSO Valid Redirect URI 和 Web Origins 字段设置为 secure-mtr-web-console 路由。
-
点
secure-mtr-web-console路由，以在新的浏览器窗口中打开 Web 控制台。
2.2.1. 对 OpenShift 中的 Web 控制台安装进行故障排除
本节论述了如何在 OpenShift Container Platform 上安装 web 控制台。
2.2.1.1. 使用 OpenShift 控制台下载日志
您可以使用 OpenShift 控制台下载 pod 日志。
流程
-
打开 OpenShift 控制台，再进入到 Applications
Pods。 -
点
mtr-web-consolepod。 - 点 Logs。
- 点 Download 下载并保存日志。
2.2.1.2. 使用 CLI 下载日志
您可以使用 CLI 下载 pod 日志。
流程
获取 pod 名称：
$ oc get pods -n <project-name>
输出类似于以下：
NAME READY STATUS RESTARTS AGE eap-builder-1-build 0/1 Completed 0 1d mtr-postgresql-1-hfbdn 1/1 Running 0 1d mtr-sso-1-build 0/1 Completed 0 1d mtr-web-console-1-build 0/1 Completed 0 1d mtr-web-console-1-vt7s5 1/1 Running 1 1d sso-1-wjl2n 1/1 Running 1 1d
使用
oc logs来检查 pod 日志：$ oc logs <pod>
注意您可以重定向输出来获取当前日志的副本：
$ oc logs <pod> > ./<pod>.log
2.2.1.3. No route to host 错误
mtr-web-console-executor 日志中的 No route to host 错误表示 mtr-web-console-executor pod 无法连接到 mtr-web-console pod:
13:44:03,501 SEVERE [org.jboss.windup.web.messaging.executor.ExecutorBootstrap] (main) Could not start messaging listener due to: Failed to connect to any server. Servers tried: [http-remoting://192.0.2.4:8080 (java.net.NoRouteToHostException: No route to host)]: javax.naming.CommunicationException: Failed to connect to any server. Servers tried: [http-remoting://192.0.2.4:8080 (java.net.NoRouteToHostException: No route to host)]
发生此错误的原因是 mtr-web-console-executor pod 在 mtr-web-console pod 之前开始运行。
在 mtr-web-console pod 运行后的几分钟后，检查 mtr-web-console-executor 日志。
2.2.1.4. 解决资源不足的问题
以下条件表示资源不足：
mtr-web-consolepod 没有运行，OpenShift 控制台中的 Pod Details 屏幕的事件标签页中会显示以下错误：0/9 nodes are available: 4 Insufficient cpu, 4 MatchNodeSelector, 9 Insufficient memory.
mtr-web-console-deploy,mtr-web-console-executor-deploy, 和mtr-web-console-postgresql-deploypod 超时，并在日志中显示以下错误：error: update acceptor rejected mtr-web-console-executor-1: Pods for rc 'mtr/mtr-web-console-executor-1' took longer than 600 seconds to become available
2.2.1.5. 报告问题
MTR 使用 JIRA 作为其问题跟踪系统。如果您在执行 MTR 时遇到问题，请提交 JIRA 问题。
