                       MySQL Administrator for Windows

                          Version 1.04 - 11/08/1998

                      David B. Mansel <david@zhadum.org>

  1 Introduction

    MySQL Administrator for Windows is a simple front-end graphical administration
    program for Microsoft Windows users. 

    MySQL Administrator for Windows works on Windows 95/98 and Windows NT 4/5.

    The program allows a number of server connections to be set up and displayed
    in a tree view. Each server connection can be configured with a required host,
    login username and password and port address, as well as being given a friendly
    free format display name. These server connections can be added, removed and
    edited, and are automatically saved to the system registry upon program exit.
    All stored passwords are encrypted with Blowfish, and this should be quite
    good enough in the majority of cases. If you are running on Windows NT, the
    combined security of Blowfish, NTFS rights and registry rights should be more
    than enough - stronger than the chances of cleartext passwords on a LAN/WAN
    being intercepted.

    Once one or more server connections have been configured, a connection can be
    made to the MySQL service on the local or remote machine. Note that all client
    to server communications are done using a resident Winsock. Apart from
    disconnecting again from the server, the following actions can be performed:

    - Descend the tree view to reveal databases and tables on the server. A full
      list of database tables is only available if you have the correct permissions

    - Request the server to stop

    - View server statistics

    - Display a real time list of server processes/threads

    - View server variables

    - Display table structures

    - Display table keys/indexes

    - Reload privilege tables, refresh open database tables, reopen the log
      file and flush the server's host cache.

    - Create a new database

    - Drop an existing database (two confirmations required)

    - Create, edit, rename and drop tables

    - Run an SQL command against a database


  2 Installation

    To install MySQL Administrator for Windows, simply create a new directory
    anywhere on your system. Extract the following files from the distribution
    zip file into this directory:

    MySQLWinAdmn.exe
    libmySQL.dll

    You could of course add MySQLWinAdmn.exe as a shortcut, either to a menu
    or on to your desktop.

    If you wish to remove the program, just delete your directory and any
    shortcuts that you might have created. You may also wish to delete the
    associated registry key...

    HKEY_CURRENT_USER/Software/David Mansel/MySQLWinAdmn

    Currently, I don't think that this very simple program warrants a full
    installation package. Further to this, newer versions of this program
    should just be installed straight over any current installation.

    If you have previously used versions 1.01 or 1.02, I'm afraid at this one
    point you will have to scrap your previous server list. This is due to a
    better technique being used in verison 1.03 onwards to secure the server list.
    Carefully follow the new start up boxes, as you will be prompted to enter
    a key to use to encrypt your new server list.

    NOTE - This key is never stored, or anything that can be used to derive
    the key. However, a simple function is used to check whether you have entered
    the correct key upon starting the program.
    
    (At the request of Pierre Pichet <pichet.pierre@uqam.ca>)

    If you are running the MySQL server under one of the flavours of Win32 and
    running this program on the same machine, you can connect to the test
    database before even making any modifications to the grant tables.

    At present, MySQL initially allows access to the database 'test' as user
    'root' with no password, using the server name 'localhost'. So, to get
    started, simply select the 'Add Server' option, and enter these values
    in to the appropriate boxes! This should at least get you started and 
    confirm that both your server and this program can talk to each other.

  3 Copyright

    None! Do as you wish with this program. The MySQL client part (libmysql.dll)
    has also kindly been placed in the public domain by Monty.

    I would ask a few things:

    - If anyone could to put together a Windows help file, that would be great!

    - If you actually use this program properly, especially anyone State Side,
    I have a real passion for JellyBelly jelly beans - hideously expensive in the
    UK. If a pack of these were to land on my door mat one morning, it would be a
    pleasant suprise! :)


  4 Version History

    Version 1.05 - ??/??/1998
    -------------------------

    Fixed a problem with unescaping enumerated type elements in table maintenance
    Built the code with patched Delphi libraries - this prevents 16 byte leaks
    Changed the distribution name to reflect the version number

    Version 1.04 - 11/08/1998
    -------------------------

    Added the option to select compression. NOTE that the DLL that is required
    for this version seems to have been built without the necessary support
    At the request of Pablo Godel <godel@iwcc.com>, readded the table and index
    structure dialogues and associated menu options
    At the request of Kai Peters <kpeters@silk.net>, allowed for semicolons at
    the end of SQL statements entered into the SQL Console
    Added open and save SQL options to the SQL Console, which also prompts
    about unsaved SQL when the dialogue is about to be closed
    Added two shortcut keys to the SQL Console

    Version 1.03 - 13/07/1998
    -------------------------

    Corrected year from 1996 to 1998 on history for Version 1.02 (below)
    Corrected 'id address' to 'IP address' in New Server dialogue hint
    Reorganised menu structures, and added the Tables menu
    Changed all references to columns and rows to fields and records
    Left aligned all text labels
    Changed to graphical buttons
    Improved spacing and alignments in dialogues
    Changed several OK/CANCEL prompts to YES/NO prompts
    Added drop, edit, create and rename table
    Added table maintenance
    Added an option to flush the server's hosts cache
    Found and fixed a nasty leek in a key class (the MySQLResult class)
    Reworked server list security, by encrypting with Blowfish
    With Blowfish encryption, MySQL passwords are now always needed

    Version 1.02 - 11/05/1998
    -------------------------

    Fixed a bug that caused the host list not to be saved and
    restored correctly. This only happened on Windows 95, and
    didn't affect Windows NT. This was spotted by Martin Hubert
    <mhubert@ediidea.com>

    Version 1.01 - 22/04/1998
    -------------------------

    Changed to work with client version 3.21.29a-gamma
    Internally, all DLL calls are now stdcall rather than cdecl
    Added better results box cell sizing logic, although it's a bit slow
    Added row count truncation to the results box, set at 1000 rows
    Various spelling/grammar corrections in dialogues and hints
    Readme.txt added to distribution archive

    Version 1.00 - 01/03/1998
    -------------------------

    First release, using client version 3.21.25a-gamma
