Difference between revisions of "Web Interface Installation Guide"

From NetXMS Wiki
Jump to navigation Jump to search
Line 30: Line 30:
= Custom logo on login screen =
= 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 it points to valid image file (PNG, JPEG, or GIF), then it will be displayed instead of standard logo.
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.

Revision as of 01:54, 6 January 2013

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.