1. 准备工作

1.1 确保系统符合要求

首先，请确保你的 IBM S390x 设备已经安装了以下基础软件：

• Go 语言环境：Komari Agent 是用 Go 编写的，因此你需要先安装 Go 编译器。
• Git：用于克隆 Komari Agent 的代码。
• Node.js 和 npm：用于构建前端部分，如果需要。

你可以按照以下步骤安装所需的软件。

安装 Go

在 S390x 上安装 Go 的命令如下：

sudo apt update
sudo apt install golang-go

安装完成后，可以使用以下命令确认安装的 Go 版本：

go version

安装 Git

Git 用于克隆 Komari Agent 的代码仓库，安装命令如下：

sudo apt install git

安装 Node.js 和 npm（如果需要）

如果你的 Komari Agent 项目中包含前端部分，你需要安装 Node.js 和 npm：

sudo apt install nodejs npm

2. 获取 Komari Agent 源码

2.1 克隆 Komari Agent 仓库

使用 Git 克隆 Komari Agent 项目：

git clone https://github.com/komari-monitor/komari-agent.git
cd komari-agent

2.2 切换到正确的分支

如果你需要使用特定的分支或版本，确保切换到合适的分支。例如：

git checkout main

3. 编译 Komari Agent

3.1 编译 Go 源码

在 IBM S390x 上，确保你的 Go 环境已经正确配置。然后，你可以使用 go build 命令编译 Komari Agent：

go build -o komari-agent

这会生成名为 komari-agent 的二进制文件，确保该文件具有执行权限：

chmod +x komari-agent

3.2 解决依赖问题

如果在编译时遇到依赖问题，可以使用以下命令来安装缺失的 Go 依赖：

go mod tidy

这样会自动下载所有缺失的依赖并更新你的项目。

4. 配置 Komari Agent

Komari Agent 需要一些配置，例如服务端地址和认证信息。在编译后的二进制文件启动时，你需要传递这些配置参数：

• -e：指定服务端的 URL。
• -t：提供认证 Token。

启动命令示例如下：

./komari-agent -e https://你的前端通讯地址.com -t xxxxxx(你的通讯密钥自行替换)

这将启动 Komari Agent，并连接到指定的服务端。

5. 使用 systemd 管理 Komari Agent

为了让 Komari Agent 在后台常驻运行并在系统重启后自动启动，可以将其配置为 systemd 服务。

5.1 创建 systemd 服务文件

在 /etc/systemd/system/ 目录下创建一个名为 komari-agent.service 的文件：

sudo nano /etc/systemd/system/komari-agent.service

在文件中添加以下内容：

[Unit]
Description=Komari Agent Service
After=network.target

[Service]
ExecStart=/root/komari/komari-agent -e https://你的前端通讯地址.com -t xxxxxx(你的通讯密钥)
Restart=always
RestartSec=10
StartLimitIntervalSec=500
StartLimitBurst=3
User=root
WorkingDirectory=/root/komari
StandardOutput=journal
StandardError=journal
SyslogIdentifier=komari-agent

[Install]
WantedBy=multi-user.target

5.2 启动并启用服务

重新加载 systemd 配置并启动服务：

sudo systemctl daemon-reload
sudo systemctl start komari-agent
sudo systemctl enable komari-agent

这样，Komari Agent 就会在系统启动时自动启动，并且在服务崩溃时自动重启。

6. 排查常见问题

6.1 检查 systemd 服务日志

如果 Komari Agent 无法启动，可以查看 systemd 服务的日志：

journalctl -u komari-agent -f

这将显示服务的实时日志，帮助你找到问题的根本原因。

6.2 手动启动 Komari Agent

如果你不想通过 systemd 启动，也可以手动运行 Komari Agent，以查看是否有错误：

./komari-agent -e https://你的前端通讯地址.com -t xxxxxx(你的通讯密钥)

查看输出信息，确保代理能够正常启动。

6.3 网络和权限问题

• 确保 Komari Agent 能够访问指定的服务端 URL。
• 确保执行 Komari Agent 的用户（如 root）具有足够的权限访问所需的文件和网络资源。

7. 总结

通过以上步骤，你已经成功在 IBM S390x 上安装并配置了 Komari Agent 节点。你可以通过手动运行或配置为 systemd 服务来让 Komari Agent 常驻后台。通过 systemd，你还可以确保代理在系统重启后自动启动，并在发生崩溃时自动重启。

如果你在安装过程中遇到问题，检查日志和配置，确保所有依赖项已正确安装，并确保网络连接正常。