NetXMS Administrator GuideRelease 2.0.2

Raden Solutions, SIA

January 27, 2016

Contents

1 Introduction 11.1 Product Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.2 Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.3 Changelog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

2 Concepts 32.1 Architecture overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32.2 Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32.3 Event Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62.4 Polling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62.5 Data Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72.6 Discovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82.7 Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

3 Installation 93.1 Planing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93.2 Installing on Debian or Ubuntu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103.3 Installing on Red Hat, Fedora, CentOS or ScientificLinux . . . . . . . . . . . . . . . . . . . . . 113.4 Installing on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153.5 Install on Android . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213.6 Generic installation, upgrade and downgrade using source tarball . . . . . . . . . . . . . . . . . 213.7 Customizing the compilation process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233.8 WebUI additional configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

4 Upgrade 254.1 Upgrading on Debian or Ubuntu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254.2 Upgrading on Red Hat, Fedora, CentOS or ScientificLinux . . . . . . . . . . . . . . . . . . . . . 254.3 Upgrading on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274.4 Generic upgrade using source tarball . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284.5 Centralized agent upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

5 Quick start 315.1 Default Credentials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315.2 Basic agent configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315.3 Basic server tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325.4 SMTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335.5 SNMP Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335.6 Actions and Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345.7 Passive discovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355.8 Manually add node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365.9 Add DCI thresholds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

6 Agent management 45

i

6.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456.2 Agent configuration files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456.3 Agent configuration options from server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476.4 Agent registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506.5 Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506.6 Subagents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526.7 Agent Proxy node configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546.8 Agent External Metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

7 Server management 597.1 Configuration file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597.2 Configuration variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597.3 Synchronization between servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597.4 netxmsd commandline options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607.5 Server debug console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607.6 Configuring self-monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617.7 Database connection pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617.8 ICMP proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

8 SNMP 638.1 MIB Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638.2 SNMP Trap Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 648.3 Setting default SNMP credentials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658.4 Using ifTable and ifXTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658.5 Configure SNMP Proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658.6 Configure SNMP Trap Proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698.7 Import MIB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

9 User management 719.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719.2 Terms and Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719.3 User Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 749.4 Integration with LDAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769.5 Managing User Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 809.6 Audit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

10 Object management 8310.1 Object browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8310.2 Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8310.3 Common object properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8710.4 Object Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9210.5 Object Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9210.6 Predefined Object Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

11 Network discovery 10511.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10511.2 Configuring Network Discovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

12 Data collection 10912.1 How data collection works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10912.2 DCI configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10912.3 Offline data collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11312.4 Last DCI values View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11312.5 Thresholds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11312.6 Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11712.7 Instance Discovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11912.8 Working with collected data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

13 Event processing 121

ii

13.1 Event Processing Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12113.2 Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12313.3 Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13013.4 NXLS Persistent Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13113.5 Macros for Event Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

14 Data and Network visualisation 13514.1 Network maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13514.2 Dashboards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14114.3 Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14914.4 History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15114.5 Summary table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

15