Netxms Install Guide
Netxms Install Guide
Table of Contents
1 Preface ......................................................................................................................4 1.1 Audience..............................................................................................................4 1.2 Additional Documentation......................................................................................4 2 Requirements..............................................................................................................5 2.1 Server Requirements.............................................................................................5 2.1.1 Hardware......................................................................................................5 2.1.2 Operating System..........................................................................................5 2.1.3 Database......................................................................................................5 2.2 Console Requirements...........................................................................................5 2.2.1 Hardware......................................................................................................5 2.2.2 Operating System..........................................................................................6 2.3 Agent Requirements..............................................................................................6 2.3.1 Hardware......................................................................................................6 2.3.2 Operating System..........................................................................................6 3 Server Installation and Upgrade....................................................................................7 3.1 Installing NetXMS Server on UNIX...........................................................................7 3.2 Upgrading NetXMS Server on UNIX.......................................................................10 3.3 Installing NetXMS Server on Windows....................................................................11 3.4 Upgrading NetXMS Server on Windows..................................................................17 4 Console Installation....................................................................................................18 4.1 Installing NetXMS Console....................................................................................18 4.2 Connecting to the NetXMS Server for the first time..................................................19 5 Agent Installation and Upgrade....................................................................................20 5.1 Installing NetXMS Agent on UNIX..........................................................................20 5.2 Upgrading NetXMS Agent on UNIX........................................................................21 5.3 Installing NetXMS Agent on Windows.....................................................................22 5.4 Upgrading NetXMS Agent on Windows...................................................................24 5.5 Unattended installation of NetXMS Agent on Windows..............................................24 5.6 Installing NetXMS Agent on NetWare.....................................................................25 5.7 Upgrading NetXMS Agent on NetWare....................................................................26 6 NetXMS Web Server Installation and Upgrade................................................................27 6.1 Installing NetXMS Web Server on UNIX..................................................................27 6.2 Upgrading NetXMS Web Server on UNIX................................................................28 6.3 Installing NetXMS Web Server on Windows.............................................................29 6.4 Upgrading NetXMS Web Server on Windows...........................................................31
1 Preface
This manual provides instructions for installing NetXMS components for UNIX, Windows, and NetWare.
1.1 Audience
This manual is intended for network administrators, responsible for NetXMS deployment and maintenance. The person installing NetXMS components must have a working knowledge of the appropriate operating system (UNIX, Windows, or NetWare).
2 Requirements
Read this chapter and perform a thorough review of the system or systems onto which you are planning to install NetXMS software. The system/s must meet software, hardware, and configuration requirements listed in this chapter.
2.1.3 Database
The following database engines can be used as a backend: Microsoft SQL Oracle MySQL PostgreSQL SQLite Database size and load is very hard to predict, because it is dependent on a number of monitored nodes and collected parameters. If you plan to install database engine on the same machine as NetXMS server, increase your hardware requirements accordingly.
If you installed NetXMS with non-default prefix (default is /usr/local), you should change the path to database driver appropriately. DBServer DBName DBLogin DBPassword LogFile Database server to connect to (for ODBC driver, name of ODBC source). Database name (for SQLite driver, database file name). Database user name. Database user's password. Server's log file. To write a log to syslog (or Event Log on Windows), use {syslog} as file name.
LogFailedSQLQueries Controls logging of failed SQL queries. Possible values are "yes" (default) or "no". It is recommended to keep this parameter set to "yes" to simplify diagnostics of database-related problems and bugs. 8. Modify agent's configuration file (/etc/nxagentd.conf). For detailed description of possible parameters, please consult NetXMS User's Manual. For the normal server's operation, you should add at least the following line to your agent's configuration file: MasterServers = 127.0.0.1, your_server_IP_address
10
If you plan to use web interface, also select Web Server component, and if you plan to run NetXMS console from the same machine, select Administrator's Console option as well. 4. Follow the prompts until Ready to Install window opens. If the Web Server option was selected, you will be prompted for master server address. Set it to localhost (Figure 2):
11
5. On Ready to Install window, check whether everything is correct, then press the Install button. 6. After copying files, Server Configuration Wizard will open (Figure 3).
12
Press the Next button to start NetXMS server configuration. 7. Database selection window will open (Figure 4):
13
Select the desired database engine and driver. For most databases, you will have two drivers available native and ODBC. Please note that if you select ODBC, you will have to manually configure ODBC source. Enter the name of database server or ODBC source. In DBA login name and DBA password fields, enter database administrators login name and password. You have to fill these fields only if you have chosen Create new database option. Enter the desired database name, database user name and password. If you are not using ODBC, the wizard will create database and a user for you. If ODBC is used, database and user should be created beforehand.
Microsoft SQL note: If you wish to use Windows authentication for database connectivity, use * (asterisk) as a login name and leave the password field blank. If you specify asterisk as DBA login, user with which you are logged in to Windows should have administrative rights to the database server. If you use asterisk as DB login, you should run NetXMS Server service as a user with appropriate rights to the database. Oracle note: We recommend to use native database driver (oracle.ddr). 8. On the next window, you will be prompted for various polling parameters (Figure 5):
14
Check Run IP autodiscovery process check-box, if you wish NetXMS server to automatically discover your IP network. Increase number of status and configuration pollers if you plan to monitor large number of nodes.
9. On the next window, enter address of your SMTP server. NetXMS will use it to send notification e-mails. If you have mobile phone attached to management server via serial cable or USB, select mobile phone driver and COM port; otherwise, select "<none>". 10.Then next window will prompt you for logging method. Either check Event Log or select file, and press the Next button. 11.Windows service configuration window will appear (Figure 6):
15
In most situations, you can run NetXMS server under Local System account. You may need to run it under specific account if you are using Microsoft SQL database and Windows authentication, or for security reasons. 12.Follow the prompts until server configuration will be complete. After successful server configuration, installation will be finished, and you will have NetXMS server up and running.
16
17
4 Console Installation
4.1 Installing NetXMS Console
1. Download the latest version from http://www.netxms.org/download, if you don't have it. You will need Windows installer (named netxms-console-VERSION.exe, for example netxmsconsole-1.0.5.exe). 2. Run the installer package on your workstation. Installation wizard will be shown. Follow the prompts until the Select Components window (Figure 7) opens. 3. On the Select Components window, select the Administrator's Console option. Figure 7: Select Components window
Press the Next button and follow the prompts until installation finishes.
18
2. Enter the address of your NetXMS server, or leave the default address (127.0.0.1), if you are starting console on the server machine. Use admin as login name and netxms as password.
19
20
21
Enter IP address or host name of your NetXMS server. You can specify multiple management servers, separating them by commas. Press the Next button to continue. 3. Subagent Selection window will open (Figure 10):
22
In this window, you can select which subagents you wish to load. Each subagent extends agent's functionality, as described below: ecs.nsm ping.nsm logwatch.nsm portcheck.nsm winperf.nsm wmi.nsm ups.nsm Adds possibility to calculate checksum of web pages; Adds possibility to send ICMP pings from monitored host. Ping round-trip times can be collected by management server; Adds possibility to monitor Windows Event Log and textual log files; Adds possibility to check network services (like FTP or HTTP) from monitored host; Adds access to Windows performance counters. This subagent is required if you need to collect CPU utilization from monitored host; Adds access to WMI counters; Adds support for UPS monitoring. UPS can be attached to host via serial cable or USB.
Please note that this page only controls what subagents will be added to the generated configuration file. It will not affect subagent installation all subagents will be installed and you will be able to activate them later. For more information about subagents, please refer to NetXMS User's Manual. 4. Follow the prompts to complete the installation.
23
Valid subagent names are ECS, LOGWATCH, PING, PORTCHECK, WINPERF, WMI, and UPS. By default WINPERF is enabled and all others are disabled. For example, to install agent silently (without any messages or progress bars), use Windows Performance and UPS management subagents, and set NetXMS management server address to 10.0.0.1, run the following command (it should be on one line): C:\> nxagent-1.0.5.exe /VERYSILENT /SUPPRESSMSGBOXES /SERVER=10.0.0.1 /SUBAGENT=UPS
24
25
26
27
28
Press the Next button and follow the prompts until the Select Master Server window (Figure 12) opens. 4. On the Select Master Server window, enter DNS name or IP address of your NetXMS server.
29
Press the Next button and follow the prompts until installation finishes.
30
31