Difference between revisions of "Web Interface Installation Guide"

From NetXMS Wiki
Jump to navigation Jump to search
Line 21: Line 21:
= Installing web interface on remote system =
= 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:
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:


* Extract file WEB-INF\plugins\org.netxms.webui.core_''version''.jar from nxmc.war
server = 127.0.0.1
* Extract file org\netxms\webui\core\nxmc.properties from extracted jar file
sessionTimeout = 120
* Change '''server''' property in nxmc.properties file
enableAdvancedSettings = true
* Pack everything back
 
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 =
= 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.
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 14:21, 18 December 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, 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. 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.