Web Portvision/NSLinkadmin
Jason Jorgensen 
Version 1.5

1. Introduction
2. Installation
3. Usage
4. Copyright

-----------------------------------------

1. Introduction

This is a web interface to nslinkadmin, a linux tool for devicemasters similar 
to PortVision for windows. http://www.comtrol.com/products/software/portvision.asp

This was written because the Portvision GUI tool is very handy for managing
DeviceMasters, but I dislike using windows. I have always preferred nice simple
web based interfaces so I can use any client operating system I want. 

This interface just makes system calls to the nslinkadmin binary written by Comtrol
but released as GPL.

I realize there are some security problems with the way its currently implemented.
If you have good suggestions for changing it, I would love to hear them.

Features:
- Displays a list of all detected devices
- Works with RPSH SI/IA, DeviceMaster RTS/Pro/SH
- Reset (reboot) devices
- Change network information
- Upload firmware
- Filter the list of devices by name, ip, mac, ready status.
- Create nslink.conf configuration files for linux nslink driver
- Create DeviceMasterInstaller.ini profile files for automated windows nslink driver installation

-----------------------------------------

2. Installation

The php file has to exist in a web server directory where php can be executed 
or interpreted. It must have write permissions to the nslinkadmin binary, and 
[TOTAL SECURITY HOLE!!!!!] the nslinkadmin binary must be SETUID root since
the functions it uses can only be used by root.


- Put webportvision.php and images/ into a directory your webserver serves 
  and make sure it can interpret PHP code.
- Compile and install nslinkadmin as root
  su -
  make
  make install
- Make nslinkadmin SUID root. :(
  chmod u+s /usr/sbin/nslinkadmin

-----------------------------------------

3. Usage

Point your web browser to your webserver and the directory you created
ie http://www.domain.com/webportvision/webportvision.php

-----------------------------------------

4. Copyright

Copyright 2005 Jason Jorgensen, jasonj@innominatus.com

This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published
by the Free Software Foundation; either version 2 of the License, or (at your
option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
License for more details.

You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.



PortVision is a registered by Comtrol Corporation.