          ==============================================
          DOLIST MAILING LIST SERVER SOFTWARE - VER 4 PR
          ==============================================
                All right reserved - DOLIST.NET
                 Document update - 7.Jan.2002

=====================================================================
INTRODUCTION
=====================================================================

Welcome to DOLIST E-Mail List Server 4, the next powerful generation of
our mailing list server. This a pre-release, so many points aren't yet detailed, so
you need to understand quite well the D3 server to go ahead with this
installation. Database and IIS web server knowledge is required too.

=====================================================================
NOTATIONAL CONVENTIONS
=====================================================================

D3 = DOLIST 3.x
D4 = DOLIST 4.x
ROOT = Dolist root directory, where is installed the DOLIST.EXE file.
ID = Identification number

=====================================================================
PREPARING YOUR ENVIRONNEMENT
=====================================================================

First of all, stop D3 service, backup your existing D3 installation.
D4 uses only database via ODBC, so you will need to have a base server as Access, SQL Server, Oracle, MySQL
for Win32. Also update to the latest MDAC component, you will find it
at http://www.microsoft.com/data.

Then create a ROOT\INI directory, and move all .INI files in ROOT folder to it.
Also create a ROOT\TEMPLATE directory. Move in it all COMMON-XX response file folders,
located in D3 under ROOT\LIST directory.

=====================================================================
INSTALLING THE SOFTWARE
=====================================================================

If you have already D3, stop the service and replace it with the D4 executable.
Don't restart the DOlist service at this time.

=====================================================================
PREPARING THE DATABASE
=====================================================================

D4 has been successfully tested with common ODBC drivers on:

- Microsoft Access 97
- Microsoft Access 2000
- Microsoft SQL Server 7
- Microsoft SQL Server 2000
- MySQL 3.23.32 win32 

All tables samples are listed into DOLIST.MDB and DOLIST97.MDB.
If you need to converter it to another base server, be aware that the format
could be different. The following must be checked after conversion:

- Access MEMO fields should be converted to varchar(4096) under SQL Server.

- Auto-incremented fields aren't always converted.

- Some servers doesn't support UNION SQL language token. We have suppressed
  them, but this is very useful when you need for example to retrieve the default
  list parameter value from [dolist_list_parameter] when the original one isn't
  defined in [dolist_list_configuration] table.
  
  If you need such query, just ask in dolist-discuss mailing list.

Then edit the ROOT\BASE.INI file in INI directory and add your base connection string.

=====================================================================
MICROSOFT ACCESS DATABASE
=====================================================================

Connection string
-----------------
DBQ=c:\dolist\dolist.mdb;DRIVER={Microsoft Access Driver (*.mdb)}

=====================================================================
MICROSOFT SQL SERVER DATABASE
=====================================================================

Connection string
-----------------
DRIVER={SQL Server};UID=login;PWD=password+;DATABASE=DOLIST;SERVER=server;WSID=DOLIST

=====================================================================
MYSQL DATABASE
=====================================================================

Connection string
-----------------
DRIVER={MySQL};DATABASE=DOLIST;SERVER=server;UID=login;PWD=password;

=====================================================================
CREATING A NEW SERVER ID
=====================================================================

Edit [dolist_server] table and create a new entry, such as:

- ID = 1.

- FQDN = your complete TCP/IP machine name (prefix.domain.ext).
  You should get it by making "ping -a localhost" on the command line.
       
- NetbiosName = Name of your machine on your local network.

Then edit the table [dolist_server_parameter], and modify
the ServerPassword entry (id=2) and the Webmaster entry (id=10).
They will be used to log you on the interface.

=====================================================================
CREATING A NEW LIST ID
=====================================================================

Edit [dolist_list] table and add the newly created ServerID, such as:

- Name = "test" (without the quotes).

- ServerID = 1, to identify the server we have created before.
       
- Enable = 1 or check the box.

Repeat the same thing for "newsletter" and "space-l" pre-defined lists.

"test" list should have ListID=1
"newsletter" list should have ListID=2
"space-l" list should have ListID=3

=====================================================================
INSTALLING THE INTERFACE
=====================================================================

You need for this to have an Microsoft IIS web server with ASP (Active Server Page).
Create a subfolder in Dolist root directory, then decompress the interface.zip 
archive in it.

Then edit the ROOT\INTERFACE\INI\INTERFACE.INI file and add your
base connection string.

Then define for the ROOT\INTERFACE directory a virtual directory on your IIS web server.
Run it and log on with Webmaster e-mail and server password.

=====================================================================
CONVERTING YOUR OLD D3 CONFIGURATION TO D4 DATABASE FORMAT
=====================================================================

For this you must use CONVERTER.EXE utility. It will parse all your
initial D3 configuration and fill tables with correct values.
If you have defined a list in D4 [dolist_list], suppress it.

CONVERTER will do the following jobs:

    - Converting DOLIST.INI 
    - Converting LIST.INI 
    - Converting all your LIST.CFG
    - Converting CHECKSUM.DAT

CONVERTER won't do the following jobs:

    - Converting BADWORDS.INI
    - Converting BLACKLIST.INI
    - Converting DOMAINS.INI
    - Converting NOTAGS.INI

    This should be done in the interface.

All this files are not used anymore. Please keep them in a save place until
your D4 installation is running well.

=====================================================================
FINISHING THE D4 INSTALLATION
=====================================================================

Read carefully the UPDATE-4.0.RTF file D4 section, in ROOT\README folder.
When all is done, restart the service.

=====================================================================
MEMBER FORMAT CONSIDERATION
=====================================================================

Although D4 can use both database and text member format, you should move
your existing members to a unique table format under your base server.
D4 will evoluate in few month to a upgraded member format, so it will be
more simple to maintain it unless you have many member files around.

=====================================================================
QUESTION AND SUPPORT
=====================================================================

If you have problem installing D4, please subscribe to dolist discussion
forum on the site, so everyone would help each other. Here and only here will
be posted new material, helpers and announcements concerning D4 during the final.
Any suggestion are welcome directly to support@dolist.net if this 
concerns corrections or modifications to existing material.
