Web Interface Installation Guide

From NetXMS Wiki
Jump to: navigation, search

Preface

NetXMS web interface is java based and should be deployed into servlet container to run. Tested containers: Tomcat6, Jetty7.

Installation into existing instance

Download latest version of WAR file from Web Interface Binaries section http://www.netxms.org/download/

Tomcat

Copy nxmc.war to webapps directory, in a few seconds it will be autodeployed and available at http://SERVER_IP:SERVER_PORT/nxmc/

Known default locations of webapps

  • Debian, Ubuntu: /var/lib/tomcat6/webapps
  • Windows: INSTALLATION_DIR\webapps

Jetty

Copy nxmc.war to webapps directory, in a few seconds it will be autodeployed and available at http://SERVER_IP:SERVER_PORT/nxmc/

(Windows only) Using netxmsd-webui.exe installer

Download latest version of installer from http://www.netxms.org/latest/netxms-webui.exe
Deselect "JRE" during install if you already have one installed.
Open http://localhost:8787/ with your browser.

Installing web interface on remote system

By default nxmc.war will try to connect to NetXMS server at address 127.0.0.1. To change that, create configuration file called nxmc.properties as following:

server = 127.0.0.1
sessionTimeout = 120
enableAdvancedSettings = true

Change server property to IP address or host name of your NetXMS server and put properties file to class path of your application server. Default locations for different servers are following:

Jetty


Tomcat

Depending on version and Linux distribution. For Debian it will be /usr/share/tomcat7/lib.


Oracle Weblogic

$WEBLOGIC_HOME/user_projects/domains/YOURDOMAIN

Custom logo on login screen

It is possible to change default logo on login screen to custom image by setting loginFormImage property in nxmc.properties file. Image file must be located within application server's class path and file name must be given relative to class path root with leading slash. For example, if custom image is in file logo.jpg located in the same directory as nxmc.properties, correct entry will be

loginFormImage = /logo.jpg