Better "getting started" documentation hiding somewhere? Can't get console.

Started by riz94107, March 13, 2015, 07:22:14 PM

Previous topic - Next topic

riz94107

I'm trying to evaluate NetXMS for a small network, and I'm having a remarkable amount of trouble getting going - primarily (I think) due to a lack of examples or documentation of early-on issues.  I have looked at:

- the Server Installation Guide: https://wiki.netxms.org/wiki/Server_Installation_Guide
- the user manual
- the administrator guide

I managed to get the server compiled and (I think?) running on a FreeBSD host in Amazon EC2 (just trying it out, you know), and I want to test drive the management console on MacOS.  That is, I think I do.  I haven't seen a lot of discussion about "this is what the management console does" and "this is how you connect it to the server", so I'm having to do a lot of guessing.

Since I'm just test-driving at this point, I built things for SQLite, to minimize complexity.  I have the agent and the server (I think?  there is no good description of what I'm supposed to have running that I can find) running on the FreeBSD host thus:

/usr/local/bin/netxmsd -D 9
/usr/local/bin/nxagentd -D 9

(I added debugging once I realized I wasn't getting anywhere)

From what I've gleaned from the docs, I had *thought* that port 4700 was the primary port used by the management console, so I added the IP my management console maps to into MasterServers in /etc/nxagentd.conf - but I can't actually see any indication that it's actually trying to connect from the MacOS client. If I telnet to port 4700 on the server, I see a connection message in the debug output, but not otherwise.  Seems like I'm missing something crucial.  :)

Is there a walkthrough of initial setups somewhere?  This seems much more frustrating than it needs to be. :)  Troubleshooting tips especially appreciated, or "here's how to get started using it" - all the docs I see seem to gloss over the basic "I've never touched this software before" steps. :/


tomaskir


Alex Kirhenshtein

Hello.

Yes, it's known issue. We are rewriting documentation at the moment, it will include complete quick start guide.
While it's not available, please check these video tutorials from Tomas Kirnak: https://www.youtube.com/playlist?list=PLt3aE2eGS5P9L72H82S83MrKx2uz5x8gv

Components:
Server – collects data from agents and SNMP devices, process this data, react on threshold violations, etc.
Agent – daemon, which provide OS-specific metrics to server (e.c. CPU usage, file system information, process information, etc.). In SNMP-only environment agent is optional; however it's recommended to run agent alongside with netxmsd

Ports:

4700 – is used by the agent, server (or debug tools like nxget) connects to agent on this port.
4701 – is used by management console for connection to netxmsd.

Management console always connect only to the server, not to agents directly.
Server connect to agents.

"MasterServer" is a whitelist of the IP addresses, which are allowed to connect to the agent. You need to have at least netxmsd's IP in this list. If it's running on the same machine, I'd recommend to add "127.0.0.1" as well. List is separated by comma, you can also use CIDR notation to specify subnets (e.g. "MasterServers=127.0.0.1, 10.0.0.0/24").

Download link for management console is https://www.netxms.org/download/nxmc/nxmc-2.0-M2.dmg
If you using version 1.2.17, download link is https://www.netxms.org/download/archive/nxmc/nxmc-1.2.17.dmg

riz94107

Great!  I will peruse these videos as I start using the system.  And port 4701 was the missing piece.  :)

Thanks,
+j