These are testing docs for our new RPC to get around issues with net-snmp
Installing the daemon
...
Info | ||
---|---|---|
| ||
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:
Code Block | ||
---|---|---|
| ||
wget https://dl-nmis.opmantek.com/spacelift/latest/nmis-rpc-linux |
now give it a bit of executeMake the file executable:
Code Block | ||
---|---|---|
| ||
chmod +x nmis-rpc-linux |
Then check Verify the installation by checking the version:
Code Block | ||
---|---|---|
| ||
./nmis-rpc-linux -version |
You should see output similar to: nmis-rpc
...
version
...
v0.0.
...
3 (built
...
2024-07-
...
25 06:
...
34:
...
20)
Then you will need the service file and install into
2. Set Up the NMIS RPC Service
Create a service file at /etc/systemd/system/nmis-rpc.service
with the following content:
Code Block | ||
---|---|---|
| ||
[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 | ||
---|---|---|
| ||
sudo systemctl enable nmis-rpc.service |
3. Install NMIS 9.5.1 or Later
Install nmis9.5.1 or greater
Code Block | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
sudo nano /usr/local/nmis9/conf |
...
/Config.nmis |
Locate the nmis_rpc_url
and add this.... setting and set it to:
Code Block | ||
---|---|---|
| ||
'nmis_rpc_url' => "http://localhost:9000", |
Save the file and exit the editor.
Restart nmis9d
find a node and change its engine
on its next poll it should use rpc over classic
RPC being the new daemon classic being net::snmp
Happy NMISing!!!the NMIS service:
Code Block |
---|
sudo systemctl restart nmis9d |
5. Enable RPC for a Node
To use the new RPC service for a specific node:
- Navigate to the node's configuration in the NMIS web interface.
- Change the node's engine setting to use RPC instead of classic.
- Save the changes.
Next poll cycle this node will use the new engine.