INSTALLING NETVIOS

There are two parts to NetVIOS

(1) the dlls, each installed with a single command

(2) the web template files (*.asp) which are basically html with calls to the dlls.

Download the installation executable (netviosinstall.exe or as a zip file netviosinstall.zip) or insert the NetVIOS CD into your computer CD drive. For the zip file, unzip to obtain the file netviosinstall.exe. Execute the file netviosinstall.exe.

 

INSTALLATION

There are three stages to the installation. Some of the stages would be completed (or already have been completed) by your hosting provider (server administrator).

A. Install the dll components (this needs to be done only once per server) and the website files
B Set up your website
C. Initialize your website.

Execute the installation program (netviosinstall.exe) or the CD file CDDriveletter:\setup.exe (usually the CD will automatically start the installation program).

    A. Installing the NetVIOS dlls and the website files 

    Get your service provider to install the component NetVIOS.dll on your server (Most ASP or Windows hosting outfits will do this for youst no cost. If you run into problems here, contact NetVIOS and we will arrange with your host to install this component). When prompted, select Custom installation to decide whether to include the dll programs or not.

    If the dlls are already installed on your hosting server, perform a custom installation of the Web Files only to your local computer and upload the installed files to your website. When prompted, select Custom installation to choose to install only the Web Files.

    In both cases, simply follow the onscreen installation instructions. You will be asked to provide the website installation path (you may need to ask your hosting provider what the exact path to your website on its server is), as well as your website URL.

    NOTE: If you are installing on Windows 2000 Professional or a system allowing only one website, install NetVIOS in a subdirectory of the default website (usually C:\Inetpub\wwwroot\). Enter the default website as your website URL and append the installation folder eg. http://defaultsiteurl/installdirectory or http://127.0.0.1/installdirectory if your default site has no URL in which case you can only access your website locally or via an Intranet.

    Providing Access Permissions to the Intenet User
    1. 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
    2. Give the IUSR user modify control over the installation directory

     

    B. Setting Up The Website

    NOTE: If you installed NetVIOS on Windows 2000 Professional Edition as a virtual folder (or in a subdirectory of the default website, usually C:\Inetpub\wwwroot), you may skip this section and access your site as http://defaultsite/subdirectory or http://127.0.0.1/subdirectory.

  1. Set up your website (this task is performed by the hosting provider - procedure below)
  2. If you did not install directly on your hosting server, upload the installed NetVIOS directory into your web directory (probably by ftp).

    3. FOR THE WEB HOSTING PROVIDER

    1. Set up an Internet Information Services (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. Right click on your server in the IIS console as shown in the figure below to create a new website
      3. Select an IP address appropriate to the website from the list of IPs available to your server
      4. For the host header, enter a domain name (such as www.yourcompany.com) for your website previously pointed to the selected IP. If you have no domain name leave the host header blank. You will be accessing the site over the internet or intranet via the IP.


        Provide Permissions to Access the Website to the Internet User
    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 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

        Set up the default document
    3. In the IIS console, right click on the web site you just created
    4. Select the Document tab
    5. Set the default document as "_sitehome.asp"

      6.
    6. If you do not have a domain name pointed to your site, you will access the site from a web browser using the IP e.g. http://11.22.33.44. If the default website is also using this IP, stop the default website by right clicking on it in the IIS console and selecting Stop.

     

    C Initialize Your Website

    Editing the global.asa file

  3. Open the global.asa file in the web directory.
  4. Set the following variables (see figure below):
    1. Application("siteurl") – e.g. "http://www.netvios.com/". Notice the http: must be included as well as the ending "/".
    2. Application("sitepath") the path to the web directory e.g. D:\netvios
    3. Application("streepath") – same as the site path above
    4. Application("StartPage") – the home page. Leave as default during the setup stage
    5. Application("SiteName") – name of site
    6. Upload the edited global.asa file to your website if you edited it remotely.

    Set up your website

    There are two ways to set up the site and site pages. 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 express setup simply to set up the templates. The auto setup will then skip the steps you have completed in the express setup.

    Express

  5. Access the page of your website - siteurl/_initializedatabase.asp (e.g http://www.netvios.com/_initializedatabase.asp or http://11.22.33.44/_initializedatabase.asp)
  6. Log in as the Administrator (default username: SiteOwner, password: 123456, unless you edited this entry in the database User table. You should change your password in the Manage Users area at the earliest opportunity )
  7. Copy the file _initializedatabase.asp to a diskette and delete it from your website.
  8. If you will not be running the auto setup option, copy the file _registernewsite.asp to a diskette and delete it from your website.

    9. OR

    AutoSetup
    1. Access the page siteurl/_registernewsite.asp (e.g http://www.netvios.com/_registernewsite.asp or http://11.22.33.44/_registernewsite.asp). You may need to provide an OS level log in information to access this page.
    2. Complete the options in the GUI set up process and select a site template.
    3. Copy the file _registernewsite.asp to a diskette and delete it from your website.
    4. Access the page siteurl/_initializedatabase.asp (e.g http://www.netvios.com/_initializedatabase.asp or http://11.22.33.44/_initializedatabase.asp)
    5. Log in as the Administrator (default username: SiteOwner, password: 123456, unless you edited this entry in the database User table. You should change your password in the Manage Users area at the earliest opportunity )
    6. Go to the WebManager and check that the file system has been properly set up. If it is not, rerun the _initializedatabase.asp page.
    7. Set up the default site user type and role
    8. Copy the file _initializedatabase.asp to a diskette and delete it from your website.

You have completed the installation process! From a web browser, access your site now using its URL or IP e.g. http://11.22.33.44/ or http://111.netvios.com.

 

 

Uninstalling NetVIOS dll
  1. 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.
  2. 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.

 

To Use DSNs as a means of connecting to the site's NetVIOS Database

You may optionally decide to use a DSN rather than the direct connection to the database (which is located in \Database folder) of your website. To do this follow the instructions below. The instructions assume you also wish to move the database to a different folder on the server. If not, omit the steps that relate to moving the location of 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 Frontpage extensions is enabled for your site). You may rename the database file as you wish.
  2. Get your hosting provider to set up a DSN for your database with a name determined by you (you may also use a DSN-less connection. See the FAQ pages for info on the procedure to do this).

    3. OR (FOR THE WEB HOSTING PROVIDER)

    Providing Database Access Permissions to the Intenet User
    1. 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 database directory and select Properties
      2. Select the Security tab
      3. Click the Add button and add the IUSR user
    2. Give the IUSR user read control over the database directory


      Creating a DSN to enable the website access the database
    3. From the Windows Start button, click on Settings and select the Control Panel
    4. Open the Administrative Tools or the ODBS Data Sources program
    5. Open the Data Sources (ODBC) program
    6. Click the System DSN tab
    7. Click the Add button to add a system database
    8. Enter a data source name
    9. Click the Select button and locate the database in the database directory
    10. Click on Ok to set up the DSN.
      11.
  3. Open the file "global.asa" in your website root folder and modify the lines below (where nameofDSN is the name of the DSN created for your database).
    sdsn = "nameofDSN"
    Application("IOS_Db") = sdsn

 

TroubleShooting

A. ACCESSING  YOUR WEBSITE YIELDS 800A006 or PERMISSION ERRORS

You may need to additionally provide permission access to the Internet user to access the dlls. This is usually necessary for the set up of some Windows server using NTFS. This task must be performed by the server administrator or one with administrative access to the server. Follow the steps below:

Providing Script Access Permissions to the DLLs for Sites Over the Internet

  1. 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 each dlls in the directory in which they are installed (usually C:\WinNT\System32\ and select Properties. The dlls are ubvios.dll and IOSChat.dll
    2. Select the Security tab
    3. Click the Add button and add the IUSR user
  2. Give the IUSR user read control over the directory

 

 

B. COMPONENT INSTALLATION ISSUES (for web server hosts or hosting providers)

For some Windows 2000 servers, you may need to go into component services to declare the component. (Let us know if you have this problem) This is the procedure:

  1. Open up the Component Services (Start → Programs → Administrative Tools → Component Services).
  2. Expand the Computer and My Computer folder until you see the COM+ folder.
  3. Right Click on COM+ Applications and Select New (Open in a new window if this option is unavailable).
  4. Select Application from the New menu
  1. Click Next
  2. Select Create An Empty Application
  3. Give the application a name such as "NetVIOS" and select the Library Application option
  4. Allow the Interactive User to access the application by selecting the Next button
  5. Click Finish to complete the new application creation
  6. Now expand the COM+ Application List
  7. Expand the application you just created
  8. Select the Component folder under this application
  9. Right click on the Components folder (when it is selected) and click on the New option (click Open in a New Window if this option is unavailable)
  10. Select the Component Option
  11. A New Component Wizard is presented
  12. Select the "Install New Component" option and locate the dll.
  13. Follow the steps to complete the process.
  14. When completed, right click on the exact component you have created.
  15. Under the Security tab, make sure to turn off the option to enforce component level security checks
  16. Recheck to ensure that on the Application level (COM+Application), the Activation Type of the entire application is "Library". (If when you right click the Application "NetVIOS" after selecting its folder package and there is an option to Start or Stop the application, then the Activation type is not set to "Library").