OpenResty XRay Agent 安装和卸载

# 安装

# 首次安装

第一次登录控制台的时候，你会看到如下的安装引导界面。你可以选择容器安装方式或者是二进制包安装方式。

接下来，你只要根据安装向导的步骤进行安装即可顺利完成安装。

# 再次安装

后续再安装 OpenResty XRay Agent 的时候，你可以通过点击下图上方的加号。

OpenResty XRay 控制台会记住你上次安装的方式，因此点击加号后你将得看到如下界面。

一般情况下，你还是会按照同样的方式安装 OpenResty XRay Agent，因此直接按照引导界面的步骤安装即可。

如果你想要使用不同的安装方式或者不同的操作系统，那么你可以点击 Install on other operation systems 的按钮。这样将回到跟首次安装一样的界面。

# 在 Kubernetes 上安装

如果你想要在 Kubernetes 集群上安装 OpenResty XRay Agent，你可以点击 Install on Kubernetes 按钮。这样将会跳转到如下界面。

然后添加 secret 并拷贝 yaml 并将其应用到你的 Kubernetes 集群，OpenResty XRay Agent 将会作为 DaemonSet 安装到你的 Kubernetes 集群中。

或者你可以使用 nodeSelector 来指定 OpenResty XRay Agent 安装的节点：

spec:
  template:
    spec:
      nodeSelector:
        role: monitoring

# bottlerocket 系统上关闭 kernel lockdown

默认情况下，bottlerocket 系统是启用了 kernel lockdown 的。这会导致 OpenResty XRay Agent 无法正常加载内核模块。你可以通过以下命令来关闭 kernel lockdown：

# 通过 SSH 登录 admin 容器

1. 使用 SSH 登录 admin 容器
2. 执行 apiclient set kernel.lockdown=none 关闭 kernel.lockdown
3. 重启 AWS EC2 实例

# 通过控制台登录 admin 容器

如果没有开启 SSH 的登录方式，那么可以通过如下方式登录控制台容器

1. 登录 AWS EC2 控制台

2. 选择 EC2 实例

3. 选择 EC2 实例右上角的连接按钮

   

4. 选择 Session Manager 标签页

   

5. 输入 enter-admin-container

   

6. 执行 apiclient set kernel.lockdown=none 关闭 kernel.lockdown

7. 重启 AWS EC2 实例

# 通过编辑 user data 关闭 kernel lockdown

1. 登录 AWS EC2 控制台

2. 选择 EC2 实例

3. 选择实例的 Actions 按钮

4. 选择 Instance settings 标签页

5. 选择 Edit user data 按钮

   

6. 在 User data 文本框中添加如下配置

   

   [settings.kernel]
   lockdown = "none"
   

7. 启动 AWS EC2 实例

# 卸载

如果想要卸载 OpenResty Xray Agent 软件，点击顶部中间的的减号按钮并按照提示执行即可。

OpenResty XRay 控制台会根据当前 `OpenResty XRay Agent`` 的安装方式给出对应的卸载命令。

比如，对于在线的二进制包方式安装的 OpenResty XRay Agent，您将得到如下提示。只要单击 Uninstall 即可完成卸载。

比如，对于在线的容器方式安装的 OpenResty XRay Agent，您将得到如下提示。 根据实际情况拷贝对应的卸载命令到目标机器上执行。

如果是已经离线的 OpenResty XRay Agent，您将得到如下的提示。您需要拷贝卸载命令到目标机器上执行。

如果机器的数量已经达到授权数量的限制，但是想在其它新的机器分析问题。你可以先卸载已经不使用的机器上的 OpenResty XRay Agent, 然后在新的机器上安装 OpenResty XRay Agent。