nv_logo

Return To Help Topics List


Installation on Windows XP

nandView requires a web service, database service and PHP to operate. These programs are not included with Windows XP. Fortunately, free and open source solutions exist.

You will need to install several pieces of software in addition to nandView. The following instructions will show you how to install and configure Apache, MySQL, PHP and nandView.

We'll be utilizing a project called WampServer to install the supporting software. The instructions assume that WampServer is bundled with Apache 2.2.11, MySQL 5.1.26 and PHP 5.3.0. If the version numbers are slightly different, please modify the commands to reflect the installed version.

Installing nandView
If the suite is still compressed, unzip the archive. Move the nandview directory into "C:\Program Files\". You should notice the following files and directories:

C:\Program Files\nandview\bin\ <- Contains the poller and emailer
C:\Program Files\nandview\html\ <- Contains the web user interface
C:\Program Files\nandview\include\ <- Contains the php support files
C:\Program Files\nandview\LICENSE.TXT <- Contains the license agreement
C:\Program Files\nandview\nv_db.sql <- Used to create the nandview database

You are now ready to install and configure the supporting software, WampServer. This can be downloaded, legally and for free, from http://www.wampserver.com/en/download.php

Run the install program, choosing the default values. At one point, you will be prompted for your SMTP server and a valid email address. You will need to set these to allow nandView to send out email notifications. If you are unsure of these values, you can change this later.

Start the services. From the start menu, choose WampServer -> start WampServer

You can now open a web browser and go to http://localhost

Verify you see the WampServer page. Click the link phpinfo() near the bottom of the page. You should see information about the PHP build.

Open up a command prompt and change to the mysql directory. Note that the version number listed below may change if you are using a more recent release of WampServer.
cd c:\wamp\bin\mysql\mysql5.1.36\bin

Run the mysql executable
mysql.exe -u root

At the prompt, type "show databases". You should see two databases listed (information_schema and mysql).

If the above steps worked, you have a good install of Apache, MySQL and PHP.

Configuring MySQL
You will now import the nandview database schema. Leave the mysql database from the previous step (type 'exit'), so that you're at the command prompt in the mysql5.1.36\bin directory, and execute the following command:
mysql -u root < "C:\Program Files\nandview\nv_db.sql"

The database should now be imported. Log in as the nand user:
mysql -u nanduser -p nandview

When prompted for a password, enter "n@ndUs3r" (without the quotes). You should now be connected to the nandview database. Issue the 'show tables' command. You should see 7 tables.

Configuring PHP
There are two php.ini files. You will need to make the following changes to both. These are located at:
C:\wamp\bin\php\php5.3.0\php.ini
C:\wamp\bin\apache\Apache2.2.11\bin\php.ini

Open the php.ini file and search for "include_path". You'll see an entry as follows:
; Windows: "\path1;path2"
;include_path = ".;c:\php\includes"

Modify this section by adding the following line below it:
include_path = ".;c:\Program Files\nandview\include"

Note: If you need to change the mail server settings, you'll find them in these two files. Look for the "SMTP =" and "smtp_port" and "sendmail_from" directives.

Make these changes in both php.ini files. You'll need to restart Apache for these changes to take effect, however there are some other Apache configurations that need to be made first.

Configuring Apache
Edit the httpd.conf file. You can find it at:
C:\wamp\bin\Apache2.2.11\conf\httpd.conf

If you are planning on using the web server for just nandview, change the DocumentRoot entry.
DocumentRoot "C:/wamp/www"
Change this to:
DocumentRoot "C:/Program Files/nandview/html/"

Now change the Directory line
<Directory "C:/wamp/www">
Change this to:
<Directory "C:/Program Files/nandview/html">

Looking down a few lines, you'll see lines that say
Order Deny, Allow
Deny from all
Allow from 127.0.0.1
</Directory>


Change this to:
#Order Deny, Allow
#Deny from all
#Allow from 127.0.0.1
Allow from all
</Directory>


For advanced users and administrators: You can lock this service down by specifying specific IP addresses. Another option is to configure SSL support, although that goes beyond the scope of this guide. You can also configure a virtual host instead. Use the below configuration as an example.
<VirtualHost nandview.yourdomain.com:80>
   DocumentRoot C:/Program Files/nandview/html
   ErrorLog C:/Program Files/nandview/nandview-error
   TransferLog C:/Program Files/nandview/nandview-access

   ServerName nandview.yourdomain.com
   UserDir disabled
</VirtualHost>


You will now need to restart Apache. Use the WampService tray icon in the lower right corner, or reboot the system.

Verification
Check that the poller and emailer scripts work. Run the following commands:
C:\wamp\bin\php\php5.3.0\php.exe "C:\Program Files\nandview\bin\nv_poller.exe"
C:\wamp\bin\php\php5.3.0\php.exe "C:\Program Files\nandview\bin\nv_emailer.exe"


These should run without any output or error messages. You can now log into the nandView web interface. Open a web browser and check
http://127.0.0.1/login.html

You should see the login screeen. Enter the default credentials.
Username: admin
Password: n@ndView

You should be able to see the dashboard. The last poll should show the current time, as opposed to 0000-00-00 00:00:00

Scheduling
You can now schedule the poller and emailer to run every 10 minutes. Type in the following two commands on a prompt:
schtasks /create /st 00:00:00 /sc minute /mo 10 /tn "NV Poller" /ru "System" /tr "C:\wamp\bin\php\php5.3.0\php.exe \"C:\Program Files\nandview\bin\nv_poller.php\""

schtasks /create /st 00:05:00 /sc minute /mo 10 /tn "NV Emailer" /ru "System" /tr "C:\wamp\bin\php\php5.3.0\php.exe \"C:\Program Files\nandview\bin\nv_emailer.php\""


Note that the nandview scripts are enclosed inside \"   \"

You can view or edit these in the Scheduled Tasks control panel. It will also show when they last ran, or if there was an error.

For advanced users and administrators: If you are going to use multiple run groups, you can add it after the second \". You will need to do this for every run group you wish to use.
Example: schtasks /create ........ \bin\nv_poller.php\" 2"

At this point, you should have nandView successfully installed. You will now be able to configure users, email lists and tests.

Please see topic Getting Started with nandView.


Return To Help Topics List