本页内容

  • 前提条件
  • 在 Debian 11 上安装 Java
  • 在 Debian 11 上安装 OpenNMS
  • 在 PostgreSQL 中创建数据库
  • 配置 OpenNMS
  • 启动 OpenNMS 服务
  • 为 OpenNMS 配置 Nginx 作为反向代理
  • 访问 OpenNMS 仪表板
  • 结论

OpenNMS 是一款免费、开源且功能最为强大的网络监控与网络管理平台之一,用于从中心位置监控远程设备。它支持许多功能,包括 Provisioning、Services Monitoring、Event managing、chart support 等。OpenNMS 使用 SNMP 和 JMX 从远程系统收集信息。它运行于 Linux 和 Windows 操作系统之上,并提供基于 Web 的界面以便轻松进行监控。

在本教程中,我将向你展示如何在 Debian 11 上安装 OpenNMS。

前提条件

  • 一台运行 Debian 11 的服务器。
  • 一个指向你服务器 IP 的有效域名。
  • 服务器上已配置 root 密码。

在 Debian 11 上安装 Java

OpenNMS 是一款基于 Java 的应用程序。因此你的服务器上必须安装 Java。如果尚未安装,可以运行以下命令进行安装:

apt-get install default-jdk -y

安装 Java 后,使用以下命令验证 Java 版本:

java --version

你将在以下输出中看到 Java 版本:

openjdk 11.0.13 2021-10-19
OpenJDK Runtime Environment (build 11.0.13+8-post-Debian-1deb11u1)
OpenJDK 64-Bit Server VM (build 11.0.13+8-post-Debian-1deb11u1, mixed mode, sharing)

在 Debian 11 上安装 OpenNMS

默认情况下,OpenNMS 未包含在 Debian 11 主仓库中。因此你需要将 OpenNMS 官方仓库添加到 APT。

首先,使用以下命令安装所有必需的依赖项:

apt-get install curl gnupg2 wget -y

安装完所有软件包后,使用以下命令创建一个 OpenNMS 仓库文件:

nano /etc/apt/sources.list.d/opennms.list

添加以下行:

deb https://debian.opennms.org stable main
deb-src https://debian.opennms.org stable main

保存并关闭文件,然后使用以下命令导入 GPG 密钥:

wget -O - https://debian.opennms.org/OPENNMS-GPG-KEY | apt-key add -

你将看到以下输出:

Connecting to debian.opennms.org (debian.opennms.org)|3.214.84.83|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 1335 (1.3K)
Saving to: ‘STDOUT’

-                                   100%[=================================================================>]   1.30K  --.-KB/s    in 0s      

2021-11-28 07:58:07 (16.0 MB/s) - written to stdout [1335/1335]

OK

接下来,更新仓库缓存并使用以下命令安装 OpenNMS:

apt-get update -y
apt-get install opennms -y

安装过程中你将遇到以下错误:

Failed to install iplike into the template1 or opennms databases. See /tmp/install_iplike.log for details. To skip this step and install manually, set the         
environment variable SKIP_IPLIKE_INSTALL before installing this package. To install iplike into your database, use the /usr/sbin/install_iplike.sh script.  See    
`install_iplike.sh -h` for more details.

要解决此错误,你需要在 PostgreSQL 中为 OpenNMS 创建一个数据库和用户。

在 PostgreSQL 中创建数据库

PostgreSQL 服务器会在 OpenNMS 安装过程中自动安装。

首先,使用以下命令启动 PostgreSQL 服务:

systemctl start postgresql

接下来,使用以下命令连接到 PostgreSQL 实例:

su - postgres

连接成功后,使用以下命令为 OpenNMS 创建一个用户并设置密码:

createuser opennms
psql -c "ALTER USER opennms WITH PASSWORD 'opennms';"

接下来,为 OpenNMS 创建一个数据库并为 postgres 用户设置密码:

createdb -O opennms opennms
psql -c "ALTER USER postgres WITH PASSWORD 'securepassword';"

接下来,使用以下命令退出 PostgreSQL shell:

exit

完成后,即可继续下一步。

配置 OpenNMS

接下来,你需要编辑 OpenNMS 数据源文件并定义数据库凭据:

nano /usr/share/opennms/etc/opennms-datasources.xml

如下所示定义你的数据库凭据:

  <jdbc-data-source name="opennms"
                    database-name="opennms"
                    class-name="org.postgresql.Driver"
                    url="jdbc:postgresql://localhost:5432/opennms"
                    user-name="opennms"
                    password="opennms" />

  <jdbc-data-source name="opennms-admin"
                    database-name="template1"
                    class-name="org.postgresql.Driver"
                    url="jdbc:postgresql://localhost:5432/template1"
                    user-name="postgres"
                    password="securepassword" />
</datasource-configuration>

完成后保存并关闭文件,然后运行以下命令检测 Java 环境:

sudo -u opennms /usr/share/opennms/bin/runjava -s

你将看到以下输出:

runjava: Looking for an appropriate JVM...
runjava: Checking for an appropriate JVM in JAVA_HOME...
runjava: Skipping... JAVA_HOME not set.
runjava: Checking JVM in the PATH: "/etc/alternatives/java"...
runjava: Did not find an appropriate JVM in the PATH: "/etc/alternatives/java"
runjava: Searching for a good JVM...
runjava: Found a good JVM in "/usr/lib/jvm/java-11-openjdk-amd64/bin/java".
runjava: Value of "/usr/lib/jvm/java-11-openjdk-amd64/bin/java" stored in configuration file.

接下来,运行以下命令完成 OpenNMS 的安装配置:

sudo -u opennms /usr/share/opennms/bin/install -dis

你将看到以下输出:

Finished in 0 seconds

Processing RemotePollerServiceConfigMigratorOffline: Remove deprecated RemotePoller service entry from service-configuration.xml, see NMS-12684
- Running pre-execution phase
  Creating backup of /usr/share/opennms/etc/service-configuration.xml
    Zipping /usr/share/opennms/etc/service-configuration.xml
- Running execution phase
  Current configuration: 32 services.
  A service entry named 'OpenNMS:Name=PerspectivePoller' already exists.
  Final configuration: 32 services.
- Saving the execution state
- Running post-execution phase
  Removing backup /usr/share/opennms/etc/service-configuration.xml.zip

Finished in 0 seconds

Upgrade completed successfully!

启动 OpenNMS 服务

完成 OpenNMS 配置后,使用以下命令启动 OpenNMS 服务并使其在系统重启时自动启动:

systemctl start opennms
systemctl enable opennms

你可以使用以下命令验证 OpenNMS 的状态:

systemctl status opennms

你将看到以下输出:

? opennms.service - OpenNMS server
     Loaded: loaded (/lib/systemd/system/opennms.service; disabled; vendor preset: enabled)
     Active: active (running) since Sun 2021-11-28 08:10:51 UTC; 16s ago
    Process: 22990 ExecStart=/usr/share/opennms/bin/opennms -s start (code=exited, status=0/SUCCESS)
   Main PID: 24106 (java)
      Tasks: 68 (limit: 4679)
     Memory: 559.2M
        CPU: 48.083s
     CGroup: /system.slice/opennms.service
             ??24105 bash /usr/share/opennms/bin/opennms -s start
             ??24106 /usr/lib/jvm/java-11-openjdk-amd64/bin/java --add-modules=java.base,java.compiler,java.datatransfer,java.desktop,java.in>

Nov 28 08:11:02 debian11 opennms[24106]: [DEBUG] System property 'opennms.library.jicmp' set to '/usr/lib/jni/libjicmp.so.  Attempting to loa>
Nov 28 08:11:02 debian11 opennms[24106]: [INFO] Successfully loaded jicmp library.
Nov 28 08:11:02 debian11 opennms[24106]: [DEBUG] System property 'opennms.library.jicmp6' set to '/usr/lib/jni/libjicmp6.so.  Attempting to l>
Nov 28 08:11:02 debian11 opennms[24106]: [INFO] Successfully loaded jicmp6 library.
Nov 28 08:11:02 debian11 opennms[24106]: [DEBUG] System property 'opennms.library.jicmp' set to '/usr/lib/jni/libjicmp.so.  Attempting to loa>
Nov 28 08:11:02 debian11 opennms[24106]: [INFO] Successfully loaded jicmp library.
Nov 28 08:11:02 debian11 opennms[24106]: [DEBUG] System property 'opennms.library.jicmp6' set to '/usr/lib/jni/libjicmp6.so.  Attempting to l>
Nov 28 08:11:02 debian11 opennms[24106]: [INFO] Successfully loaded jicmp6 library.
Nov 28 08:11:07 debian11 opennms[24106]: Nov 28, 2021 8:11:07 AM org.hibernate.validator.internal.util.Version 

Nov 28 08:11:07 debian11 opennms[24106]: INFO: HV000001: Hibernate Validator 4.3.2.Final

此时,OpenNMS 已启动并监听端口 8980。你可以使用以下命令进行检查:

ss -antpl | grep 8980

你将看到以下输出:

LISTEN 0      50                      *:8980             *:*    users:(("java",pid=24106,fd=1046))     

为 OpenNMS 配置 Nginx 作为反向代理

接下来,建议安装并配置 Nginx 作为 OpenNMS 的反向代理。首先,使用以下命令安装 Nginx 服务器:

apt-get install nginx -y

安装 Nginx 后,创建一个 Nginx 虚拟主机配置文件:

nano /etc/nginx/conf.d/opennms.conf

添加以下配置:

server {
  listen 80;
  server_name opennms.example.com;
    access_log /var/log/nginx/opennms.access.log;
    error_log /var/log/nginx/opennms.error.log;

  location /

  {
    proxy_set_header Host $http_host;
    proxy_set_header X-Forwarded-Host $host;
    proxy_set_header X-Forwarded-Server $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-OpenNMS-Server-URL https://nms.hacc.edu/;
    proxy_pass http://server-ip:8980;

  }
}

保存并关闭文件,然后检查 Nginx 是否存在语法配置错误:

nginx -t

你将看到以下输出:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

接下来,重启 Nginx 服务以应用更改:

systemctl restart nginx

要检查 Nginx 的运行状态,请运行以下命令:

systemctl status nginx

你应该会看到以下输出:

? nginx.service - A high performance web server and a reverse proxy server
     Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
     Active: active (running) since Sun 2021-11-28 08:17:14 UTC; 6s ago
       Docs: man:nginx(8)
    Process: 25964 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
    Process: 25965 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
   Main PID: 25967 (nginx)
      Tasks: 3 (limit: 4679)
     Memory: 3.2M
        CPU: 53ms
     CGroup: /system.slice/nginx.service
             ??25967 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
             ??25968 nginx: worker process
             ??25969 nginx: worker process

Nov 28 08:17:14 debian11 systemd[1]: Starting A high performance web server and a reverse proxy server...
Nov 28 08:17:14 debian11 systemd[1]: Started A high performance web server and a reverse proxy server.

访问 OpenNMS 仪表板

现在,打开你的 Web 浏览器,使用 URL http://opennms.example.com 访问 OpenNMS Web 界面。你应该会看到 OpenNMS 登录页面:

在Debian 11上安装并配置OpenNMS Horizon网络监控系统

输入默认用户名和密码 admin,然后点击 Login 按钮。你应该会在以下界面看到 OpenNMS 仪表板:

在Debian 11上安装并配置OpenNMS Horizon网络监控系统

现在,点击 admin > Change Password 以更改默认的 admin 密码,如下所示:

在Debian 11上安装并配置OpenNMS Horizon网络监控系统

更改你的默认密码并点击 Submit 按钮。你应该会看到以下界面:

在Debian 11上安装并配置OpenNMS Horizon网络监控系统

结论

恭喜!你已在 Debian 11 服务器上成功安装了以 Nginx 作为反向代理的 OpenNMS。现在你可以将远程设备添加到 OpenNMS,并从 Web 浏览器开始监控它们。如果有任何问题,欢迎随时问我。