Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Info
titleBeta

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:

These are testing docs for our new RPC to get around issues with net-snmp

Installing the daemon

...

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


Make the file executable:

Code Block
languagebash
chmod +x nmis-rpc-linux


Then check Verify the installation by checking the version:

Code Block
languagebash
./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 Then you will need the service file and install into /etc/systemd/system/nmis-rpc.service with the following content:

Code Block
languagebash
[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 Reload the systemd or whatever and start the service

...

daemon and start the service:

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

Enable the service to start on boot:

Code Block
languagebash
sudo systemctl enable nmis-rpc.service

3. Install NMIS 9.5.1 or Later

Install nmis9.5.1 or greater

Code Block
languagebash
httpwget https://dl-nmis.opmantek.com.s3.amazonaws.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:

Code Block
languageperl
sudo nano /usr/local/nmis9/conf/Config.nmis

Locate the , find nmis_rpc_url and add this.... setting and set it to:

Code Block
languageperl
 'nmis_rpc_url' => "http://localhost:9000",

Save the file and exit the editor.

Restart the NMIS service:

Code Block
sudo systemctl restart nmis9d

...

 find a node and change its engine

Image Removed

on its next poll it should use rpc over classic

RPC being the new daemon classic being net::snmp

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.

Image Added

Next poll cycle this node will use the new engine.Happy NMISing!!!