Segfault Research > Projects > Server > NetXMS Simple Dashboard > NetXMS Simple Dashboard - Installation
First published on: 02-Nov-2013

App: Linux & Windows

  • Download the zip-file.
  • Copy the file to the place where you're hosting your web applications:
    # cp -iv /tmp/ /var/www/localhost/htdocs/
  • Unpack the file
    # cd /var/www/localhost/htdocs
    # unzip
  • You should now have the main directory, with the 2 subdirectories "app" and "config" immediately below it:
    # cd netxms-simple-dashboard
    # ls -lh
    total 44K
    -rw-r--r-- 1 root root  18K Oct 29 22:33 COPYING
    -rw-r--r-- 1 root root  18K Oct 29 22:33 LICENSE
    drwxr-xr-x 8 root root  119 Oct 31 16:35 app
    drwxr-xr-x 2 root root 4.0K Oct 30 15:09 config
  • Optional: depending on your setup (webserver, users...) set the permissions accordingly (only read-access is required):
    # chown -R apache:apache app

Windows: do practically the same.

Webserver: Apache / Linux

The simpliest configuration, assuming that you're using virtual hosts, is as follows:

<VirtualHost *:80>
        DocumentRoot "/var/www/localhost/htdocs/netxms-simple-dashboard/app"
        <Directory "/var/www/localhost/htdocs/netxms-simple-dashboard/app">
                Options Indexes FollowSymLinks
                AllowOverride All
                Order allow,deny
                Allow from all
                DirectoryIndex index.php

Please note that the Directory & DocumentRoot is not set to "netxms-simple-dashboard" but to "netxms-simple-dashboard/app".

You can add of course any kind of authentication as you usually do for other websites.
Here an example of how to to enable authentication, but allow passthrough if the request originates from the webserver itself (if you e.g. want to set up a cronjob to regularly download single graphs to then make them available directly through other websites, email them, etc...):

Satisfy any
AuthType Digest
AuthName "Password needed"
AuthDigestDomain /
AuthUserFile /var/www/mysecretdir/.htusers_digest
Require user joe
#IP (so that I can download graphs to the local server using cronjobs)
Order Deny,Allow
deny from All
allow from

If you now restart your webserver and try to access the app you should see a message saying...
ERROR DETECTED - (in function "index.php")
Custom error message is: The user "noauth" is not authorized to access this application.
...which is great => see the "Setup" page on how to continue with the configuration.

Webserver: IIS / Windows

<coming soon>