INSTALLING NETVIOS

There are three parts to NetVIOS

(1) a database which houses all the info such as user name, password and other site-related data. This is an Ms Access file but could be implemented in any SQL, ODBC compatible database.

(2) a dll, which is quite easy to install with just one command

(3) the template files (*.asp) which are basically html with some calls to the dll.

Download the three parts - NetVIOS_database.zip, ubvios.zip and NetVIOSFiles.zip.

Unzip the files and then follow the installation instructions below.

Setting Up the Database

  1. Create a directory in which you wish to store the NetVIOS database. Preferably create this directory away from your IIS and web folders or in the _private folder (if Server extensions is enabled for your site). You may rename the database file as you wish.
  2. For Windows 2000 running the NTFS system, you will also need to give permission to the IUSR_ComputerName. To do this:
    1. In Windows Explore, right click on the web directory and select Properties
    2. Select the Security tab
    3. Click the Add button and add the IUSR user
  3. Give the IUSR user read control over the database directory
  4. From the Windows Start button, click on Settings and select the Control Panel
  5. Open the Administrative Tools program
  6. Open the Data Sources (ODBC) program
  7. Click the System DSN tab
  8. Click the Add button to add a system database
  9. Enter a data source name
  10. Click the Select button and locate the database in the database directory.

    11. Activating the NetVIOS programs

  11. Create a directory for the NetVIOS dll or use the WinNT\system32\ folder
  12. Copy the dlls (ubvios.dll and IOSchat.dll) into the directory
  13. Activate the dll by typing the following command in the command environment "regsvr32 Path\ubvios.dll " (to obtain a command environment, click the Windows Start button and select Run…)
  14. You will be informed that the dll was successfully loaded. The OS programs are now available for your website
  15. For systems running NTFS you will additionally need to provide read and execute access to the IUSR user.

    16. Setting Up The Web Directory

  16. Create the web directory
  17. Unzip the content of the file netvios.zip into this web directory
  18. Set up an IIS Website. This may be a virtual directory or a web site for a Windows 2000 server
    1. Select the directory you created earlier as the web directory
    2. Allow read and run (scripts such as ASP)
  19. For Windows 2000 running the NTFS system, you will also need to give permission to the IUSR_ComputerName. To do this:
    1. In Windows Explorer, right click on the web directory and select Properties
    2. Select the Security tab
    3. Click the Add button and add the IUSR user
    4. Give the IUSR user full control to the directory
  20. In the IIS console, right click on the web site you just created
  21. Select the Document tab
  22. Set the default document as "_sitehome.asp"

    23. Editing the global.asa file

  23. Open the global.asa file in the web directory.
  24. Set the following variables:
    1. Application("IOS_Db") – the DSN name you provided the database e.g. "netvios"
    2. Application("IOS_DbUserName") – database user name if login required
    3. Application("IOS_DbPassword") – database password if required
    4. Application("siteurl") – e.g. "http://www.netvios.com/". Notice the http: must be included as well as the ending "/".
    5. Application("sitepath") the path to the web directory e.g. D:\netvios
    6. Application("streepath") – same as the site path above
    7. Application("StartPage") – the home page. Leave as default during the setup stage
    8. Application("SiteName") – name of site

    There are two ways to set up the site and site pages. If you are comfortable with databases, you may choose the manual. If you wish to use site templates, you will need to use the Automatic setup. You can also us the Automatic set up after running the manual simply to set up the templates. The auto setup will then skip the steps you have manually completed.

    Manual

  25. Open the NetVIOS database
  26. Open the Users table
  27. Edit the entry for the SiteOwner. Actually, you may choose any log in name for the site owner. This user will be the Administrator
  28. Close the database
  29. Access the page siteurl/_initializedatabase.asp (e.g http://www.netvios.com/_initializedatabase.asp)
  30. Access the site using the site url (e.g. http://www.netvios.com/)
  31. Log in as the Administrator (see step 27)
  32. Set up the default site user type and role
  33. Copy the file _initializedatabase.asp to a diskette to reuse if you ever need to reset your site. Delete the file.
  34. If you will not be running the auto setup option, copy the file _registernewsite.asp to a diskette and delete it.

    35. AutoSetup

  35. Access the page siteurl/_registernewsite.asp (e.g http://www.netvios.com/_registernewsite.asp). You may need to provide an OS level log in information to access this page.
  36. Complete the options in the GUI set up process.
  37. Copy the file _registernewsite.asp to a diskette and delete it.
  38. Access the page siteurl/_initializedatabase.asp (e.g http://www.netvios.com/_initializedatabase.asp)
  39. Access the site using the site url (e.g. http://www.netvios.com/)
  40. Log in as the Administrator
  41. Go to the WebManager and check that the file system has been properly set up. If it is not, rerun the _initializedatabase.asp file.
  42. Set up the default site user type and role
  43. Copy the file _initializedatabase.asp to a diskette to reuse if you ever need to reset your site. Delete the file.
  44. If you will not be running the auto setup option, copy the file _registernewsite.asp to a diskette and delete it.

    45.  

     

    Uninstalling NetVIOS dll
  45. To uninstall a NetVIOS dll, type in the following command in the command environment "regsvr32 Path\ubvios.dll /unregserver" (to obtain a command environment, click the Windows Start button and select Run…). You may use a similar command for IOSChat.dll.
  46. Once NetVIOS dlls are uninstalled, you may delete them and delete NetVIOS asp files.

 

If you choose not to use NetVIOS Native Chat Application

If you choose not to use NetVIOS Native Chat Application:

  1. Do not install NetVIOs chat dll.
  2. Also delete the NetVIOS chat subdirectory from the your website.
  3. Remove every line that refers to IOSChat from your "global.asa" file.