SilverPlume Web (SPWeb)
Technical Requirements
SilverPlume Web is a Windows NT server application, comprised of three major components which run on the server:
- Spserver.exe, a CGI compliant stub program
- Spdaemon.exe, a daemon program
- Spserv32.dll, a 32-bit ActiveX DLL
The spserver.exe is a small program intended to load quickly on receipt of a URL invoking SilverPlume. This program creates an entry in a disk-based queue for each user request for SilverPlume. When the request has been processed by the daemon program and stored in the user request queue, spserver.exe retrieves the daemon's output, passes it back to the user, and is unloaded from the server's memory.
The daemon.exe is a larger program which is loaded once and remains in memory. The daemon constantly monitors the queue for processing requests. When a request appears, the daemon processes the request (utilizing spserv32.dll) and returns an appropriate HTML page as an output entry in the queue.
The HTML page could be a document from the SilverPlume library, a table of contents, the results of a search, or any other valid SilverPlume document. Documents in the SilverPlume library are stored in a proprietary, encrypted, compressed format. When retrieved by the daemon, SilverPlume library documents are decompressed and converted on the fly into HTML format.
Materials
SilverPlume supplies the following materials for the SilverPlume Web installation:
- SilverPlume CD
- Startup floppy disk
Workstation Requirements
SilverPlume Web requires the following workstation software:
- Microsoft Internet Explorer (version 5.0 or better)
- Netscape Navigator (version 4.0 or better)
Server Requirements
SilverPlume Web requires the following server components:
- 700 megabytes of free server disk space for the regular SilverPlume Library, plus 1 additional megabyte per additional user
- Intel-based server running one of the following:
--Windows NT 4.0 with Service Pack 6 or higher
--Windows 2000 with Service Pack 1 or higher
--Windows 2003 is not a supported platform for SPWeb
- 8x CD-ROM drive with a capacity of 74 minutes (680 MB)
- Microsoft IIS 4.0 or 5 is the recommended web server software. Any CGI compliant web server software will work with SPWeb; however SilverPlume will only provide technical support for these IIS versions.
Installation Instructions
Copy the SilverPlume CD: An image of the SilverPlume CD must be downloaded to your server hard drive. We recommend allocating 700 MB of hard drive space to allow for growth in the library material.
- Select the drive where you will copy the contents of the SilverPlume CD.
- Prepare a place to copy the contents by creating a directory named SPDATA at the root of this drive. (Example C:\SPDATA )
- Copy the entire contents of the SilverPlume CD to the SPDATA directory.
Setup
- Run setup.exe from the SPDATA\SPWEB directory.
- The setup program will execute and the Welcome screen appears. Click NEXT.
- The Choose Destination Location screen appears. Make sure the SilverPlume start up floppy disk is in the floppy drive. Click NEXT.
- Another Choose Destination Location screen appears. Change the default drive letter as necessary so the program files will be installed to the desired location of your server hard drive. Click NEXT.
- The Confirm Settings screen appears confirming the current settings. Click NEXT, files will be copied.
- A Question Box is displayed asking if you would like to view the Readme file. Choose YES or NO.
- The Setup Complete message box will appear indicating that the installation is complete. Click FINISH. This will restart your server.
Additional Required Setup
The following virtual directories are required for SilverPlume to access certain data.
spweb
The spweb virtual directory is necessary to direct the browser to spserver.exe (the CGI program). The case chosen for the alias name must match the directory name specified in the browser address line.
- Alias name: spweb
- Map spweb to the following directory: \SilverPlume Web Server\Spweb
- Permissions: execute and read
CUST1
The CUST1 virtual directory is necessary to retrieve graphics. The alias name must be all caps.
- Alias name: CUST1
- Map CUST1 to the following directory: \Silver Plume Web Server\Spweb\Customer\Cust1
- Permissions: execute and read
sphome
The sphome virtual directory is necessary to retrieve graphics from the Spview32\Home directory on the CD image. The alias name must be lower case.
- Alias name: sphome
- Map sphome to the following directory:
Spdata\Spview32\Home
- Permissions: read
For instruction on how to create virtual directories for IIS, go to Microsoft Internet Information Server version 4.0
Accessing SilverPlume
- The URL to access SilverPlume is: http://IP address/spweb/spserver.exe
- An Authorization screen comes up when you access SilverPlume for the first time. You will need to enter the following information to log into the program:
- Enter your customer code: cust1
- Enter your customer password: pass
- Enter your administrative user code: custadmin (this was created automatically during the installation)
- Enter your user password: pass
Adding / Deleting Users
Adding Users
- From the SilverPlume home page, click the blue Options button.
- Scroll down to Maintain User Information and for each authorized user, complete the form as follows:
User Code: (eight character unique user identifier - letters or numbers)
User Password: (eight character user password)
User Class: (normal user should be default)
User name (optional): firstname lastname
- Click Submit to enter information.
Note: Only Site Class users have rights to add additional users to SilverPlume.
User Classes
Site Class
SilverPlume System Administrator
- Rights to add and delete users
- Rights to add and change Shared Notes
- Rights to add and remove Frames of Reference
Default Class
Typical SilverPlume User
- Cannot add and delete users
- Rights to only view Shared Notes
- Rights to only view Frames of Reference
Deleting Users
- From the SilverPlume home page, click the blue Options button.
- Scroll down to Select user to maintain. Select the appropriate user code
and click Submit.
- The user code you selected is now displayed in the Maintain User
information box.
On the user class line, drop down the arrow and select Delete.
Click Submit.
Note: Only Site Class users have rights to delete users in SilverPlume
Monthly Updates
We provide the updated library on a new CD-ROM, therefore monthly maintenance on your system is required. All users must exit SilverPlume during the update procedures. It is highly recommended that these update procedures be performed during off-peak times (typically at the end of the day after all users have finished using the system).
- In the Spuser.ini (typically located in the C:\WINNT directory on the web server), remove the semi-colon in front of the Available=False line and save the file. This makes the site unavailable while you update the library. Verify that all SPDaemon processes (viewable via Windows NT task manager) have shutdown (this may take a few minutes). Frame of Reference customers should ensure that no background processes are running before making the site unavailable (this can be viewed by going to the options screen and selecting the Display Batch Logs link).
- Delete the contents of the \SPDATA directory on your web server.
- Copy the entire contents of the SilverPlume CD to the \SPDATA directory on your web server.
- Copy the contents of the \SPDATA\SPWEB\PROGRAMS directory to the SPWeb installation directory (typically C:\Silver Plume Web Server\SPWeb).
- In the Spuser.ini, replace the semi-colon in front of the Available=False line and save the file. This will make the site available to your users. After making the site available, you should go into the library home page to verify library availability. The first time into a new or updated library may take a minute or two to respond as the system will need to regenerate control files. Frame of Reference customers should enter the library the first time without a frame activated to start the frame reconciliation process.
Periodically, you will receive new daemon (SPDaemon.exe), and/or stub files (SPServer.exe) via e-mail or floppy disk. Instructions will be included with the new files.
Please be sure to have a current version of Acrobat Reader. It is needed to view certain items in SilverPlume. Click here to install.
Microsoft, Windows 95, 98 Windows for Workgroups and Windows NT are registered trademarks of the Microsoft Corporation. IBM is a registered trademark of IBM. Novell is a registered trademark of Novell, Inc. Adobe Acrobat Reader is a registered trademark of Adobe Systems Incorporated.