INSTALLING NETVIOS WEBFACES

There are four parts to installing Webfaces:

A. Setting up the Webfaces dll. (This is done by the web server administrator and is done one time on every server intended to use webfaces).

B. Setting up Webface Files (Optional). This is done per website intended to use parts of Webfaces that require the script files (such as the richtext element).

C. Adding Webface Location Entries to global.asa file. This is done per website.

The procedures for completing these steps are detailed below:

 

A. Setting up the Webfaces dll
(FOR THE WEB HOSTING PROVIDER)
 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).

  1. Create a directory for the Webfaces dll
  2. Copy the dll (Webfaces.dll) into the directory
  3. Activate the dll by typing the following command in the command environment "regsvr32 Path\Webfaces.dll". To obtain a command environment, click the Windows Start button and select Run…
  4. You will be informed that the dll was successfully loaded. The NetVIOS programs are now available for your website
  5. For systems running NTFS you may additionally need to provide read and execute access to the IUSR user (as described 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 the web directory in which the dll is installed 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 directory

 

     

    B. Setting Up The Webfaces Files on Your Website

    Some webface elements require additional script files. These include the richtext element and elements such as color, upload etc. These script files must be copied into two folders - /Netbox and /WOS folders of your website. Simply unzip the zip file WebfaceFiles.zip into the webfolder of your exisiting website and the files will be installed.

     

    C. Adding Webface Location Entries in Your Website's global.asa file

  1. Open the global.asa file in the web directory.
  2. 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("NetVIOSVer") = 2.2
    5. Application("GeneralUploadFolder") the default folder in which you wish uploads be sent (when the Upload element is used).
    6. Upload the edited global.asa file to your website if you edited it remotely.

 

Uninstalling the Webfaces dll
  1. To uninstall a Webfaces 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…). 
  2. Once NetVIOS dlls are uninstalled, you may delete them and delete Webfaces script files from your website as well as the Webfaces database.

 

TroubleShooting

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