Go to Home Page Installation Guide
  Go to Home Page
 All Products Index   CyberTeams Customers   CyberTeams Partners   How to Contact CyberTeams   About CyberTeams 
 

Windows® Sites running the Apache Web Server

About This Guide

This guide describes how to install WebSite Director Lite (WSD) for sites using Windows®  and running the Apache Server. The sections in the Guide provide step-by-step instructions for each part of the installation process. 

Important Note: The WSD Lite Installation Program must be executed from your web browser, as instructed  in Step 2. Install WSD below. The WSD  Installation Program will not install correctly if run from the command line or via the Windows "Run" option. 

Audience

This guide is for any person who intends to install WSD, and for anyone wanting to familiarize themselves with the WSD installation and/or configuration process. The reader should have a reasonable familiarity with web server terminology, and specific knowledge of Windows and the Apache Server. 

The reader should also be familiar with directory structures and the server's installation options. 

Review this section carefully.  If you are installing WSD in an Internet Service Provider (ISP) environment, it may be necessary to contact their representative to verify or alter some of these settings. References (like "Click the Groups Tab...") refer to the user interface at the time this document was published. Your interface should be similar, but may not be identical. 

E-mail your comments and suggestions regarding this guide to: wsdlite-support@cyberteams.com

Before you Begin...

Make sure you have created your WSD Installation Directory and downloaded your WSD Installation Program using the instructions on the WSD Download page. 

You will also need the following installation materials: 

  • The completed Installation Planning Form
  • The following Installation Worksheet
    • It provides a place to write down the information you will be instructed to enter during your download and installation of WSD.
Worksheet Item Description
Worksheet Item Data
(value used during WSD Installation)
1.  CGI ScriptAlias name assigned to the WSD Installation Directory  

Contents

The following outline provides links to all sections in this Installation Guide.  1.  Server Configuration

If you have an existing Apache Web Server, you must modify the httpd.conf server file before you install WSD.

Note 1: Older versions of the Apache web server put some configuration commands in files called access.conf and srm.conf.  If you cannot find the configuration commands mentioned below in the httpd.conf file, look for them and make the appropriate changes to the access.conf or srm.conf files. See Step 3 and 4 below.
Note 2. All directory references in these instructions should use "forward" slashes (UNIX style) as directory separators. 
Note 3: If a directory contains spaces (such as "Program Files"), the entire directory path must be enclosed within quotes.

To access these files, complete the following steps:

1. Use Windows Explorer to locate the Apache web server root directory in the left panel, and click on the directory name.

  • If the Apache destination directory was not changed during setup, you should find it installed in the following directory:
    • c:\Program Files\Apache Group\Apache
  • If you don't know the root directory of your Apache Web Server, contact your Server Administrator. 
2. Locate and click on Apache, then on conf in the left panel

3. Change the httpd.conf file

If your Apache Web Server is not configured for CGI access and a Script Alias, you must make the following two changes to the httpd.conf file to add the name of  the Apache web server CGI directory and to change the AllowOverride statement.

a. Locate and click on Apache, then on conf in the left panel (see steps 1 and 2 above)

b. In the right panel, locate and double-click on httpd.conf to bring it up in your text editor

c. Find the line that contains 

    "<Directory /apache/cgi-bin>"
and change it to point to the cgi-bin directory. For example: 
<Directory "C:/Program Files/Apache Group/Apache/cgi-bin">
d. On the next line, change "AllowOverride None" to "AllowOverride All"

4. Point to the WSD Installation Directory.

We recommend you add an alias to point to the WSD Installation Directory. To do so, complete the steps below. 

a. In the httpd.conf file, find the line starting with "ScriptAlias". The line contains three parts:

    Script Alias <alias> <real directory>
b. Create a new line immediately following the last "ScriptAlias" line.

c. Assign the alias you intend to use to access WSD as the <alias> value, and write down the Alias name as Item 1 on your Installation worksheetFor example: /wsd/

d. Assign the WSD Installation Directory Name (see the WSD Lite Installation Planning Form) as the <real directory> value. For example:

ScriptAlias /wsd/ "C:/Program Files/Apache Group/Apache/cgi-bin/wsd/"
(note that you must use quotes as indicated)

e. Click Save to save your changes.

2.  Install WSD
The following instructions will complete the installation of the WSD software on your server. After you have completed this section, you must still complete Sections 3, 4 and 5 before allowing your users to access WSD. 

    Important Note: The WSD Installation Program must be executed from your web browser. The WSD Installation Program will not install correctly if run from the command line or via the Windows "Run" option. 
Before you begin installing WSD, make sure the Apache Web Server is loaded and running: 
  • If you did not set up your Apache Web Server as an automatic Windows Service, manually start the server before you continue. See the Download and Install the Apache Web Server for instructions on how to manually start your server.
a. Start up your web browser.  Make sure the Username used to run the installation program has write and execute privileges to the directories in which you are installing WSD.

b. Type the full URL of the WSDInstallation Program in the area provided by your browser.  If you created an alias named "/wsdlite/marketing" (Installation Worksheet Item 1), you would use the following URL: 

http://<domain name>/wsdlite/marketing/wsdlite-install.exe 

c. Press [Enter]. The Software License Agreement displays. 

  • If you get a "File Not Found" message, check the URL you entered and make sure it matches the location of the WSD Installation Program.
  • If you get a "Server Error" message, contact CyberTeams by e-mail at wsdlite-support@cyberteams.com, or call Technical support at 1.301.682.8885 with details of your server configuration.
d. Read the Software License Agreement, and click [Accept]. The WebSite Director Lite Software Installation form leads you through all of the configuration options for WSD. The options are in the same order as the Installation Planning Form. 

e. Complete the WSD Lite Software Installation form. Unless you are installing WSD in a different directory from the Installation Program, do not change the default directory name. 

f. Click [Install]. The WSD Lite Installation Program extracts the various WSD component files and installs them in the directories specified on the Software Installation form. The results of the installation display on an Installation Report web page. 

  • If the Installation was not successful, the errors display in the report. Use the "back" function on your browser to return to the installation process and correct the cause of the error.
g. Print the Installation Report and save it for later use as a reference document.

3.  Start Up WSD for the First Time
If the installation completed successfully, you are now ready to start up WSD for the first time using your web browser. 

Important Note: Before you start up WSD, make sure the Apache Web Server is loaded and running: 

  • If you did not set up your Apache Web Server as an Automatic Windows Service, manually start the server before you continue. See the Download and Install the Apache Web Server for instructions on how to manually start your server. 
a. Start up your web browser.

b. Type the full URL of the WSD Installation Program in the area provided by your browser.  If you created an alias named "/wsdlite/marketing" (Installation Worksheet Item 1), you would use the following URL: 

http://<domain name>/wsdlite/marketing/wsd.exe

c. Enter the initial userid and password you specified during the installation. The WSD Application Desktopscreen displays. 

  • If WSD fails to start, or you have problems using WSD, send us an e-mail message at wsdlite-support@cyberteams.com or call our technical support line at 1.301.682.8885 with details about your web server configuration.
4.  Set Initial User Permissions

After starting WSD for the first time, it is important that you go to the User Administration screen (select User Administration on the WSD Application Desktop screen) and set up permissions for the Initial User. See the User Administration Tutorial for information about establishing User Administration, Write Access and Private Directory Access permissions.

5.  WSD Tutorials

WSD provides tutorials to introduce you to the major functions, and link you to help screens for each of the functions. The Help button on each of the WSD screens links you to an Index which provides an alphabetical listing of all of the help screens and tutorials in the system. The WSD Tutorial Introduction also links you to the following tutorials: 

Microsoft, Windows and Windows NT are registered trademarks of Microsoft Corporation. All other brand and product names are trademarks or registered trademarks of their respective companies.
 All Products Index   CyberTeams Customers   CyberTeams Partners   How to Contact CyberTeams   About CyberTeams 
Go to Home Page  
Copyright © 1997-2005 CyberTeams, Inc. All rights reserved.
Maintained with WebSite Director® by CyberTeams®.

Updated Wed, Dec 13, 2000.