This guide describes how to install WebSite Director (WSD) for Windows NT Sites running the Domino Server. The sections in the Guide provide step-by-step instructions for each part of the installation process. 
 

Audience

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:  wsd-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.  
• You received the URL for this form on the WSD Registration web page. Be sure you have reviewed and completed the necessary information on this form using the WSD Installation Reference Guide.
• 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 the MiniSQL database and WSD.The first three items on this worksheet are referenced in the following Installation Guides: 
• MySQL Database Download & Install Guide for Windows NT 
• MiniSQL 2.x Database Download & Install Guide for Windows NT.

Contents

1. Choose Installation Directory
2. Create the Database
    a. ODBC
    b. MySQL/mSQL
3. Before You Install WSD
4. Install WSD
5. Configure Authentication
6. Start Up WSD for the First Time
7. Set Initial User Permissions
8. WSD Tutorials

2.  Create the Database

When you downloaded the WSD software, you chose either the MySQL, mSQL or ODBC version of WSD. Depending on which you chose, you must either create a MySQL database, an mSQL database, or define, select, and possibly create an ODBC data source.WSD will use the database/data source for storing document information regarding the documents WSD is managing on your site. Please read all of the instructions carefully for whichever type of database you are installing.

2a.  ODBC You must define an ODBC data source for use by WSD. Depending on the type of data source you will be using, you may have to create your database before you can configure your ODBC Data Source. While a Microsoft Access database can be created while setting up the ODBC Data Source, other databases (like a Microsoft SQL Server database, for example) must be created using the specific SQL Server's database administration tools before the associated ODBC Data Source can be defined and created. Some database servers (such as Microsoft SQL Server), require you to specify the maximum size of the database as part of creating the database. If your database requires you to estimate a size, use the following sizes for tables in the WSD database to calculate the correct size for your database. Multiply the sizes given for each of the items below by estimates of the number of corresponding documents and update volumes for your web site: System Configuration and User Data - 300K bytes (Fixed overhead)  Directories on the web site - 1k bytes per directory (multiply X estimated number of directories)  Documents on the web site - 1k bytes per document (multiply X estimated number of documents)  Update requests and request history - 5k bytes per request (multiply X estimated maximum number of document requests you will be archiving before you begin deleting request activity history)
Step	Action	Additional Information
a.	Start up "Control Panel" and start (Double click) the ODBC configuration program icon in the Control Panel	The "Control Panel " program can be accessed from the Windows Taskbar
b.	Click on the SystemDSN tab, then click on the Add button	The WSD database must be defined as a System DSN so it will be visible to all users including NT services
c.	Select the appropriate database driver for the database server you wish to use for WSD.
d.	Click Finish	You will be presented with a new window to record additional information regarding your newly defined data source. The contents of this window will vary depending on the driver you selected in step c. above. The following steps assume that you have selected Microsoft SQL database driver.
e.	Enter the Data Source Name (this is the WSD database name you recorded on the WSD Installation Planning Form)	The default name used during installation is wsd
f.	Specify other data source options based on the database driver selected	For Microsoft SQL databases you must select an existing database. If Microsoft Access is being used, you could either create a new database or select an existing database
g.	When finished configuring the Data Source, click OK to exit the ODBC configuration program, then exit Control Panel	Your ODBC data source is now ready for use by the WSD installation process and WSD itself.

2b.  MySQL/mSQL You must create the database so that it can be initialized by WSD during installation. Until this initialization takes place, you will be unable to complete the installation of WSD.  Note 1: The database server must be loaded and running before you can create the database. If you did not set up the database server as an automatic NT Service, make sure you have manually started the database server before you continue!  Note 2: If you have an existing WSD database that you plan to use, do not complete the following instructions and select NO when prompted during installation. See Database Information on your WSD Installation Planning Form. To create a NEW WSD database you must you must execute the DOS program named msqladmin.exe or mysqladmin.exe located in the database installation directory (Worksheet Item 2).   Step Action Additional Information a. Go to the database installation directory Item 2 on your Installation worksheet b. Execute the applicable DOS program  with the parameters  create <database-name for MySQL:  mysqladmin create wsd for mSQL 2.x:  msqladmin create wsd Note: Because this is a DOS program, you may choose to do this by executing it from within a DOS Window with parameters of "create" followed by"<database-name", or create a shortcut using the following instructions:   How to do this Use Windows Explorer to locate the database server installation folder (Worksheet Item 2) in the left panel, and click once on the Folder name.  In the right panel, right-mouse click on  msqladmin.exe or mysqladmin.exe  and select "Create Shortcut"  Left-mouse click once on the shortcut and type a new name for the shortcut (for example, "Create WSD Database")  Right-mouse click on the shortcut and select "Properties"  In the Properties window, select the "Shortcut" tab  In the "Target" window (displays the msqladm.exe or mysqladmn.exe name),   position to the end of the line,   type  a space and then type:  create <database-name where database-name is the name that you will enter in the "Database Name" field when you install WSD (see the Database Information section of the Installation Planning Form).  For example:  msqladm create<database-name, or msqladmin create<database-name, or mysqladm create <database-name Click OK.  Double-click on the shortcut.  A message will confirm installation, but the DOS window may close before you can read the message Note: you may have to manually close the DOS window depending on your system settings.  IMPORTANT NOTE: If you have already installed WSD, you must re-run the WSD Installation Program so that WSD can initialize the database. For more information about MySQL for Windows, visit the MySQL Home Page.   For more information about mSQL for Windows, visit the mSQL PC Home Page.

3.  Before You Install WSD Although WebSite Director 1.3 (WSD) will install and run properly on a Domino Web Server, WSD is not yet able to directly manage the list of users authorized to access WSD.  Consequently, it is necessary to synchronize users between the Domino Web Server access control configuration and WSD's User Administration screen.  To add an authenticated user to WSD, you must add an existing Domino user to the access control list for WSD, or create a new Domino user. You must also add the user to WSD using the WSD User Administration screen.   During the WSD installation process, you must specify an "Initial User" that will be given administration privileges within WSD.  Before installing WSD, you should identify or create a Domino user that will be used as the WSD "Initial User". To create a new Domino user,  Start up the Lotus Domino Administrator.  Select the "Peoples & Groups" tab.  Click [Add Person]. Note: The user can be an existing Domino user, or you may create a new Domino user to be the WSD "Initial User."

After starting WSD for the first time, it is important that you go to the User Administration screen (select User Administration on the WSD Main screen) and set up the following permissions for the Initial User:

• User Administration 
• System Administration

8. WSD Tutorials

The WSD Tutorial Introduction links you to tutorials that will assist you in using WSD on your server. A link to these tutorials is provided on each WSD screen.

• Each screen also has a Help button/icon that provides help with the screen in addition to an index to all of the Help screens in the WSD system.