Installation & Basic Settings

Contents

Overview

Welcome to ManageEngine Network Configuration Manager!

This section provides information on how to install Network Configuration Manager solution in your system. This section also deals with the system requirements for Network Configuration Manager, how to install the solution, how to start and shutdown the product, the ports occupied by Network Configuration Manager and licensing information. 

Prerequisite Software

There is no prerequisite software installation required to use Network Configuration Manager. The standard system (hardware and software) requirements as mentioned below plus an external mail server (SMTP server) are essential for the functioning of Network Configuration Manager server, to send various notifications to users. 

Components of Network Configuration Manager

The ManageEngine Network Configuration Manager consists of the following components:

  • The Network Configuration Manager server consisting of server and database

  • Built-in TFTP server running on port 69

  • Built-in syslog server running on port 514

  • JRE 1.8.181 bundled with Network Configuration Manager

  • PostgreSQL 10.12 bundled with Network Configuration Manager

  • SSH server

Editions & scalability

Network Configuration Manager comes in two editions:

    - Free edition : 2 devices, free forever

    - Trial edition : unlimited devices, free for 30 days

    - Professional edition and Enterprise edition: unlimited devices, paid version.

Network Configuration Manager can monitor upto 5000 devices. 

 

Installing Network Configuration Manager

In Windows

  • Download and execute ManageEngine_NetworkConfigurationManager.exe. The installation wizard will guide you through the installation process

  • Choose an installation directory - by default, it will be installed in C:/ManageEngine/NCM; Henceforth, this installation directory path shall be referred as "NCM_Home".

  • While installing Network Configuration Manager, you have the option to install Network Configuration Manager as a service. Just uncheck the checkbox, in case, you do not wish to install it as service

  • In the final step, you will see two check-boxes - one for viewing ReadMe file and the other one for starting the server immediately after installation; if you choose to start the server immediately, it will get started in the background. As unpacking of jars will be done during the first startup, it will take sometime to fully start.

  • If you choose to start the server later, after installation, you can start it from the Start >> Programs >> ManageEngine Network Configuration Manager menu. 

In Linux

  1. Download ManageEngine_NetworkConfigurationManager_64bit.bin for Linux.

  2. Login as root user.

  3. Assign executable permission using command chmod a+x <file-name>

  4. Execute the following command with administrator privileges (sudo):

    ./<file_name>
  5. Follow the instructions as they appear on the screen

  6. Network Configuration Manager is installed in your machine in the desired location. Henceforth, this installation directory path shall be referred as "NCM_Home".

Installing Network Configuration Manager on Linux using console mode/silent mode

Step 1: Execute ManageEngine_NetworkConfigurationManager_64bit.bin with administrator privileges (sudo) and -i console option.

Step 2: Go through the license agreement and enter 'Y' to proceed.

Step 3: You can register for technical support by providing the required details (Name, E-mail ID, Phone, Company Name).

Step 4: Select your location.

Step 5: Choose the installation directory.

Step 6: Configure the web server port.

Step 7: Verify the installation details and press 'Enter' to complete the installation.

Starting & Shutting Down Network Configuration Manager

Windows:

Click on Start > Programs > ManageEngine Network Configuration Manager to start the server.

Alternatively you can navigate to the <NCM_Home>\bin folder and invoke the run.bat file.

Linux:

Navigate to the <NCM Home>/bin directory and execute the run.sh file.

When the server is started, a command prompt window opens up showing startup information on several modules of Network Configuration Manager. Once all the modules have been successfully created, the following message is displayed:

Server started.

Please connect your client at http://localhost:8080

where 8080 is replaced by the port you have specified as the web server port during installation.

Starting as Service :

Windows:

If you have chosen the Start as Service option during installation, Network Configuration Manager will run as a service on Windows.\

Linux:

  1. Login as root user.

  2. Navigate to the <NCM_Home>\bin directory.

  3. Execute the linkAsService.sh file

  4. Then execute the command /etc/init.d/opmanager start


This starts Network Configuration Manager as a service on Linux.

 

To check if the ports required by Network Configuration Manager are free:
 

The ports mentioned above should be free while starting the server. It is quite possible that any of the above ports might already be in use and as a result, Network Configuration Manager server would not start.

 

In Windows, you can invoke the 'Port Check' option through Start >> Programs >> Network Configuration Manager >> Port Check  (or) Right click the Network Configuration Manager tray icon and 'Port Check' option. A prompt will open and it will provide the status of the required ports.>

 

In Linux, to invoke the 'port check' option, navigate to /bin directory and invoke "sh portcheck.sh".

 

Using MSSQL Database

Network Configuration Manager supports PostgreSQL, MySQL and MSSQL databases as backend. PostgreSQL database is bundled with the product and by default, it is configured to run with PostgreSQL. In  case, you wish to use MSSQL databases, follow the steps detailed below:

Important Note:

  • MSSQL backend is supported from Network Configuration Manager version 5500 only. Earlier versions do not have provision to run with MSSQL

  • At present, data migration from MySQL to MSSQL is not supported. You need to start afresh only. That means, if you already using MySQL and wish to switch to MSSQL, the current configurations, settings and other data cannot be migrated to MSSQL

Steps to Change to MSSQL

  1. Stop Network Configuration Manager Server, if running.

  2. Open a console and navigate to <deviceexpert_home>/bin directory (as root user).

  3. In Windows, execute the batch file "ChangeDB.bat". In Linux, execute the script "sh ChangeDB.sh".

  4. The DB Configuration window pops up. Select MSSQL option. Configure the following information:

    • DB Host: The name or the IP address of the machine where MSSQL is installed.

    • Port: The port number in which Network Configuration Manager must connect with the database. Default is 1433.

    • User Name and Password: The user name and password with which Network Configuration Manager needs to connect to the database.

    • Click 'OK'

    • Start Network Configuration Manager. It will run with MSSQL.

Moving Network Configuration Manager installation to another machine or Moving to a different location within the same machine

If you want to move the Network Configuration Manager installed in one machine to another or to a different location within the same machine, follow the procedure detailed below:

Prerequisite

  1. Do not remove existing installation of Network Configuration Manager until the new installation works fine. This is to ensure backup, to overcome disasters/data corruption during the movement.

Procedure

  • Stop Network Configuration Manager server / service, if running

  • If you have installed Network Configuration Manager to run as a startup service, remove it as service before proceeding further. See the table below for the procedure to remove it as service.

  • Take a zip of the entire Network Configuration Manager installation folder; move the zip to a different machine or to a different location in the same machine as required

  • Then, install it to run as service.

 

Installing as Startup Service in Windows

Installing as Startup Service in Linux


To install as service using batch file

  • Open a console and navigate to<NCM_Installation_Folder>/bin directory

  • Execute the command networkconfigurationmanager.bat install

 


To remove as service using batch file

  • Open a console and navigate to<NCM_Installation_Folder>/bin directory

  • Execute the command networkconfigurationmanager.bat remove

 

 


To Install as Service

  • Login as root user

  • Open a console and navigate to<NCM_Installation_Folder>/bin directory

  • Execute "sh networkconfigurationmanager.sh install"



To Remove as Service

  • To uninstall, execute the script "sh networkconfigurationmanager.sh remove"

 

 

 

 

Note:

  • In this option, you will not be able to uninstall the program through windows Add/Remove programs console. If you want to uninstall anytime, just delete the entire installation folder.

  • You need not reapply the license after moving the installation.

Licensing

There are three license types:

  • Evaluation download is valid for 30 days and supports unlimited devices during the time period. After 30 days, one can manage up to 2 devices.

  • Free Edition - licensed software allows you to manage up to 2 devices. To get a free license for additional 2 devices, please fill the form in this link - https://www.manageengine.com/network-configuration-manager/download-free.html

  • Professional Edition and Enterprise Edition - need to buy license based on the number of devices to be supported

  • For more information and to get license, contact sales@manageengine.com

 

Acknowledgement: This product includes software developed by SSHTools (http://www.sshtools.com/).

 


 

Was this article helpful?