NMIS9 RPC

Beta

Note this is currently beta functionality.

Installing and Configuring NMIS RPC Service

The NMIS RPC Service is a new daemon designed to enhance SNMP functionality in NMIS 9.5.1 and later versions. This guide will walk you through the installation and configuration process.

1. Install the NMIS RPC Daemon

Download the latest version of the NMIS RPC daemon:

wget https://dl-nmis.opmantek.com/spacelift/latest/nmis-rpc-linux


Make the file executable:

chmod +x nmis-rpc-linux


Verify the installation by checking the version:

./nmis-rpc-linux -version

You should see output similar to: nmis-rpc version v0.0.3 (built 2024-07-25 06:34:20)

2. Set Up the NMIS RPC Service

Create a service file at /etc/systemd/system/nmis-rpc.service with the following content:

[Unit]
Description=NMIS RPC Service
After=network.target

[Service]
ExecStart=/usr/local/nmis9/bin/nmis-rpc-linux
WorkingDirectory=/usr/local/bin
Restart=always
RestartSec=10
Environment=PATH=/usr/local/bin:/usr/bin:/bin

[Install]
WantedBy=multi-user.target

Reload the systemd daemon and start the service:

sudo systemctl daemon-reload
sudo systemctl start nmis-rpc.service

Enable the service to start on boot:

sudo systemctl enable nmis-rpc.service

3. Install NMIS 9.5.1 or Later

Install nmis9.5.1 or greater

wget https://dl-nmis.opmantek.com/nmis9-9.5.1a.run
chmod +x nmis9-9.5.1a.run
sudo ./nmis9-9.5.1a.run

4. Configure NMIS to Use RPC

Edit the NMIS configuration file:

sudo nano /usr/local/nmis9/conf/Config.nmis

Locate the nmis_rpc_url setting and set it to:

'nmis_rpc_url' => "http://localhost:9000",

Save the file and exit the editor.

Restart the NMIS service:

sudo systemctl restart nmis9d

5. Enable RPC for a Node

To use the new RPC service for a specific node:

  1. Navigate to the node's configuration in the NMIS web interface.
  2. Change the node's engine setting to use RPC instead of classic.
  3. Save the changes.

Next poll cycle this node will use the new engine.