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/netxms-simple-dashboard-0.1.0.zip /var/www/localhost/htdocs/
  • Unpack the file
    # cd /var/www/localhost/htdocs
    # unzip netxms-simple-dashboard-0.1.0.zip
  • 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>
        ServerName mysubdomain.mydomain.com
 
        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
       </Directory>
</VirtualHost>

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...):

#===START AUTHENTICATION BY USER OR IP===
Satisfy any
 
#User
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 127.0.0.1
#===END AUTHENTICATION BY USER OR IP===

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>