Installing CADViewer
on a Microsoft Windows IIS server

This page covers the setup of a Web server and the installation of CADViewer, for use in publishing drawings for collaborative viewing and comment. If you have already set up a functioning Web server (with either Perl or a script function), you need only install CADViewer, at which time you can start publishing.


Installing CADViewer

  1. Download the CADViewer Zip.
  2. Open the Zip archive file and extract the contents into this directory:

    C:\Inetpub\wwwroot

    This directory serves as the default document root for IIS Server.

    The extraction process will automatically create a new "CADViewerPRO" directory and copy all the CADViewer files into this directory.

  3. When this process is complete, quit the Zip utility. You can now configure CADViewer for basic use, focussing especially on activating the "redline" markup features.

RETURN to top of page


Configuring CADViewer

  1. Create a new directory in the main "CADViewerPRO" directory, entitled "redlines".

    ALERT! You can create this directory in any other location—including another networked server. You must, however, note down the exact directory pathway including the IP address of that machine, so that you can configure CADViewer to locate and use this directory.

  2. Start any text editor and open the file "demo.html" — located inside the "CADViewerPRO" directory.

  3. Between the "<APPLET>" tags, enter the following parameters — on separate lines:

    <param name="redline_cgi" value="/cgi-bin/redsaver.pl">

    <param name="redline_file" value="/CADViewerPRO/redlines/">

  4. Save these changes and close this file.

  5. Open the "CADViewerPRO" directory and locate this file:

    redsaver.pl

    NOTE: These files contain the same information, but work with different processes.

  6. If you installed Perl on your server, copy the file "redsaver.pl" into this directory:

    C:\Inetpub\wwwroot\cgi-bin

  7. If you have already configured your server to utilize another cgi-bin, copy the "redsaver.cgi" file into that directory—if other than "C:\Inetpub\wwwroot\cgi-bin".

  8. Start a text editor and open the newly copied "redsaver" script in its new home directory.

  9. Insert a blank first line and type the following text:

    #!perl

  10. Use the Terminal application's Search feature to find the text string "CHANGE ME".

  11. Delete CHANGE ME and replace it with the pathway to the CADViewer redline directory—making sure that quote-marks wrap the pathway text. The entry should resemble (with some variations) this example:

    "C:\\Inetpub\\wwwroot\\CADViewerPRO\\redlines\\"

    ALERT! Make sure that you type double back-slash characters between items.

  12. Save your changes and close this file.

    This completes the installation and basic configuration of CADViewer.

RETURN to top of page


Verify that the Host information is correct

When you purchase a license for CADViewer use, the viewer will have been configured to run only on the web server URL you specified when you purchased the viewer. To make sure that the configuration is correct, follow these steps:

  1. Try using the viewer by connecting to the demo page on the current server — as described in the previous section.

    If you installed the CADViewer on the wrong host, a warning window will pop up and the viewer will not appear in the browser window.

Some browsers will not display the warning window while displaying the viewer. Do not assume that the viewer was installed and configured correctly because it appears in this one browser. To verify that the viewer was installed correctly, follow these steps:

  1. Use a Java-capable Web browser (on a different computer) to reopen "demo.html".

  2. Open that browser's Java console by doing the following:

    Netscape Communicator 4x and later: Choose "Communicator | Tools | Java console".
    Internet Explorer 4.x and later: Choose "View | Java Console".

    The Java console, after opening, should display the status message, "Host verified", and will also display the host name. This verifies that the viewer was configured correctly.

    ALERT! If the viewer does not say "Host verified" or a warning window appears, yet the CADViewer application is running on the Web server it was licensed for, please contact Tailormade Software Support (via e-mail) for a new version.

RETURN to top of page


Testing the redline features

At this time, you should test the CADViewer "redline" features, as described in the following steps:

NOTE: If this procedure does not work, you can test the cgi script that enables redline file saving by following the procedure detailed in LINK.

  1. Click in any of the Redline tools (shown below) and create a markup anywhere on the drawing.

    Redline tool palette

  2. Click the disk icon (shown below) in the Redline toolbar.

    A Save Current Redlines dialog box appears, as shown below.

  3. Click Server(if it has not already been selected.)

  4. Change the name of the redline file if you don't want the default name and the type of redline file to save.

  5. Click Save.

    If the dialog box closes and no error window appears, your redline file was saved in the redline directory.

  6. To verify that the file exists, click the Open button in the Redline toolbar — as shown below.

    The "Load Redlines for this drawing" dialog box appears, as shown below.

  7. To view a list of the names of any redline files, click the button by "Use Web Server, File Name", then click OK.

  8. A "Redline File" dialog box appears, listing this "demo" redline filename.

  9. To view the redlines for this drawing, select the file name and click Load.

  10. Click Cancel to close this dialog box without opening a redline file.

    This concludes all of your preliminary tests. Your CADViewer server is ready for use.

RETURN to top of page


Uninstalling CADViewer

To uninstall CADViewer from your Web servers, follow these steps:

    Delete the CADViewer installation directory and its subdirectories.

RETURN to top of page