Web Interface Installation Guide

From NetXMS Wiki
Revision as of 01:54, 6 January 2013 by Victor (talk | contribs)
Jump to navigation Jump to 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, do the following before deploying new war file:

  • Extract file WEB-INF\plugins\org.netxms.webui.core_version.jar from nxmc.war
  • Extract file org\netxms\webui\core\nxmc.properties from extracted jar file
  • Change server property in nxmc.properties file
  • Pack everything back

Custom logo on login screen

It is possible to change default logo on login screen to custom. When login screen is displayed, web server checks URL http://127.0.0.1/netxms_login.dat . If this URL points to valid image file (PNG, JPEG, or GIF), then it will be displayed instead of standard logo.

Retrieved from "https://wiki.netxms.org/index.php?title=Web_Interface_Installation_Guide&oldid=790"