Chip 2001 January/Chip_2001-01_cd1.bin/tema/mysql/mysql-3.23.28g-win.exe/DATA1.CAB/Help_Files/Readme

Text File | 2000-11-22 | 13KB | 307 lines

The MySQL server is distributed under the GPL license. Please refer to
the file COPYING for the license information.

The MySQL client library is distributed under the LGPL license.
Please refer to the file COPYING for the license information.

Most of the MySQL clients are distributed under the GPL license, but
some files may be in the public domain.

The latest information about MySQL can be found at: http://www.mysql.com

To see what MySQL can do, take a look at the features section in the
included manual.

For future plans see the TODO appendix in the manual.

New features/bug fixes history is in the news appendix in the manual.

For the currently known bugs/misfeatures (known errors) see the bugs
appendix in the manual.  The Win32 section contains notes that are
specific to the MySQL win32 version.

You can find information how to do a correct bug report at:
http://www.mysql.com/Manual_chapter/manual_Questions.html#Asking_questions
PLEASE read the above before posting your questions/bug reports, this
will save us all a lot of time!  When you send us a bug report, please use
the mysqlbug.txt form, that you can find in the MySQL installation directory,
as a base for your bug report!

For examples of SQL and benchmarking information see the bench
directory.

The manual mentioned above can be found in the Docs directory of this
MySQL distribution. The manual is available in the following formats:
as text in Docs/manual.txt, as HTML in Docs/manual_toc.html, as GNU
Info in Docs/mysql.info and as PostScript in Docs/manual.ps.

MySQL is brought to you by: TcX DataKonsult AB & MySQL Finland AB

For the contributors see the Credits appendix in the manual.

At http://www.mysql.com/Downloads you can find a port of perl, with
DBI, DBD-MySQL and DBD-ODBC that works under Win32 against a Win32
or Unix mysqld server!

*************************************************************************

Notes for this version:

Starting with 3.22.21 we are now using internal character maps (ISO559-1)
for character mapping/sorting to avoid problems with the Win95 character maps!
If you are upgrading from an older MySQL version, it's recommended that you
run isamchk -rq on all old tables!

Starting with 3.23.14 the mysqld server can be use one of many different
character sets.  You can find an index of these at:
\mysql\share\charsets\index.  If you want to use MySQL with another
character set than the default one (latin1 = windows default character set),
you can start mysqld with the option --default-character-set="character set"
You can of course also specify "default-character-set" in the my.cnf
option file.

There is 3 different SQL servers included with this package:

mysqld        Compiled with full debugging and automatic memory allocation
        checking.  Requires TCP/IP.
mysqld-opt    Optimized for a Pentium processor. Requires TCP/IP.
mysqld-nt    Optimized for a Pentium pro processor. Has support for
        named pipes. One can run this version on Win98, but in
        this case no named pipes are created and one must
        have TCP/IP installed.

All of the above versions should work on any Intel processor >= i386.

The default privilige tables on Win32 gives all local users full privileges
to all databases.  When one wants to make MySQL more secure one should set
a password for all users and remove the row in the mysql.user table that
has host='localhost' and user=''.

MySQL supports TCP/IP on all Win32 platforms and named pipes on NT.
The default is to use named pipes for local connections on NT and use
TCP/IP in all other cases if the client has TCP/IP installed.  The
host name specifies which protocol is used:

Host name        protocol
NULL (none)        NT: First named pipe, if this doesn't work TCP/IP
            Win95/Win98: TCP/IP
.            named pipes
localhost        TCP/IP to current host
hostname        TCP/IP

One can force a MySQL client to use named pipes by specifying the
--pipe option.  The --socket option specifies the name of the pipe.

Note that Win95/Win98 doesn't support creation of named pipes.  One
can on Win95/Win98 only use named pipes to connect to a remote MySQL running
on a NT server.

*************************************************************************

This distribution of MySQL includes the new winmysqladmin.exe
by Miguel A. Sol≤rzano.  With this you can install MySQL as a service,
start the service and monitor MySQL.  This will also automaticly shut down
MySQL on Win9x when the machine needs to be rebooted.

To start MySQL the first time with winmysqladmin.exe:
(Note that we will shortly add an option to automatize this!)

- start winmysqladmin.exe from the MySQL install directory
  (probably c:\mysql\bin\winmysqladmin?)
- Click on the red traffic light on the panel and choose 'show me'.
- Choose the My.INI setup screen.
- Choose the server you want to use;  Probably mysqld-nt on NT and mysqld-opt
  on Win9x.
- Choose 'Create my.ini' file.
- If you want your site a bit more secure:
  - Remove the '#' before #user and #password and write your MySQL
    administrator user and password information. (This doesn't have anything to
    do with your normal user name and password).
- Choose 'Save Modification'
- Choose 'Create ShortCut on Start Menu' if you in the future want to
  quickly be able to use winmysqladmin.exe.

- If you are using WinNT, you should now click the right button to first
  install mysqld-nt.exe as a service and then again use the right button to
  start mysqld.  If you are using Win9x, you should click the right button and
  use the option under the Win9x menu to start mysqld.

- If you have done everything correctly the traffic light should go
  from red to green.  This means that the MySQL daemon is up and running.

- If you choosed above to added a new user and password, you need now create
  to create the new MySQL user.

  - Start mysqlmanager.exe
    - If you have problems connection, you can try to modify the connect
      options under 'tools -> register server'
  - Click on the MySQL 'directory' label to go the the mysql privilege
    database.
  - Choose 'Tools->SQL Query' from the menu.
  - Enter the following query in the Query screen:

    GRANT ALL PRIVILEGES ON *.* to 'user name'@localhost identified by
    'password' with grant option
   and click on the small green '>' on the top of the query screen.

***********************************************************************

If you don't use winmysqladmin.exe, the following information should
help you install and start mysqld.

Starting MySQL (this will start mysqld in the background without a window):

  bin\mysqld

or on NT if you don't want to start mysqld as a service:

  bin\mysqld-nt --standalone

Killing the MySQL server:

  bin\mysqladmin -u root shutdown

Testing MySQL:

  bin\mysqlshow
  bin\mysqlshow -u root mysql
  bin\mysqladmin version status proc
  bin\mysql test

On NT mysqld can be installed as a service with:

  bin\mysqld-nt --install        # Install MySQL as a service
  bin\mysqld-nt --remove        # remove MySQL as a service

and start/stoped with

  NET START mysql
  NET STOP mysql

Note that in this case you can't use any other options for mysqld!

You can also run mysqld as a standalone program on NT if you start
mysqld with any other options!  If you start mysqld without options on
NT, mysqld tries to starts itself as a service with the default
service options.  If you have stopped mysqld, you have to start it with
'NET START mysql'.

The service is installed with the name "MySql". Once installed it must
be started using Services Control Manager (SCM) Utility (found in
Control Panel) or by using the 'NET START MySQL' command. If some
options are wanted they must be specified as "Startup parameters" in
the SCM utility before start.  Once running mysqld can be stopped
using mysqladmin or from SCM utility or by using the command 'NET STOP
MySQL'. In case of stopping from SCM, there is a strange message from
SCM about 'mysqld shutdown normally'. Running as service mysqld has
not access to a console and so no messages can be seen.
If you have problems starting mysqld on NT, try starting it with the
--standalone switch;  By doing this you will see error messages that doesn't
show if mysqld is started as a service.

On NT you can get the following service error messages:

Permission Denied - Means that it cannot find mysqld.exe
Cannot Register   - Means that the path is incorrect

- You can also use MyODBC or perl to connect to mysqld.

- This version is configured to be installed in c:\mysql.  You can however
  copy this anywhere as long as you don't change the directory structure.
  For example:
  mkdir d:\mysql
  xcopy c:\mysql\*.* d:\mysql

  mysqld should be able to automaticly find its files based on where
  mysqld is located.  If you want to use files from some other place, you
  can tell mysqld to use some other directory with --basedir='path'.
  You can also create a c:\\my.cnf file that holds any default options for
  the MySQL server.

- If you have problems installing mysqld as a service, try starting mysqld
  with the full path:  'C:\mysql\bin\mysqld --install'.
  If this doesn't work, you can get mysqld to start properly by fixing
  the path in the registry!

- If mysqld is slow to answer to connections on Win9# this is probably a
  problem with your DNS. In this case start mysqld with --skip-name-resolve
  and use only 'localhost' and IP numbers in the MySQL privilege tables.
  You can also avoid DNS by connecting to a MySQL server on NT, running
  mysqld-nt, with named pipes by using the --pipe argument to most
  MySQL clients.

- Most things appears to work nicely on Win32.  We use the MySQL
  benchmarks and crash-me to check each version before releasing it.

- The distributed default MySQL version is compiled with debugging information
  so one can get a trace file with: mysqld --debug.  After one has verified
  mysqld works correctly one can switch to the optimized version:
  mysqld-opt or mysql-nt.

- There are two versions of the 'mysql' command line tool; 'mysql', compiled
  on native Win32, which offers very limited text editing capabilities and
  'mysqlc', compiled with the Cygnus gnu compiler and libraries, which offers
  readline editing.

- The default permission is that anyone can use any database that
  starts with 'test' from any host and anyone running on the same machine
  as mysqld is running can take it down.
  mysqladmin shutdown.

- Normally one should add a password for the 'root' user and take mysqld down
  with:
  mysqladmin --user=root --password=your_password shutdown

  In this case one should remove the entry with host='localhost' and user=''
  from the user database.

  The above is most easly done with:

shell> mysql mysql
mysql> delete from user where host='localhost' and user='';
mysql> quit
shell> mysqladmin reload
shell> mysqladmin -u root password your_password

- This distribution includes the a prototype of a the GUI tool,
  MySQLManager, by James Pereria.  This has still some rough edges,
  but it can serve as a great base for further development!

- MySQLWinAdmn is a Delphi program, by David B. Mansel, to administrate
  MySQL databases. (Binary only).  We are waiting for an updated version that
  will work with the current libmysql.dll

- This distribution includes two small helper programs:

  - mysqlshutdown  ; If one installs this program on Win95 / Win96 in the
    Programs/Startup folder then it will automaticly take down the mysqld
    daemon on reboot
  - mysqlwatch     ;  If you have problems on NT that MySQL dies (this should
    only happen when you testing/developing MySQL), this service will
    automaticly restart the mysqld service if notices that the mysqld server
    isn't running.

(Thanks to Irena for the above programs!)

If you would like to work on the MySQL win32 version, you can find a list
of open issues in the reference manual. We are not that used with the
Win32 environment so many of the issues may be real easy to solve for
someone familiar with Win95/Win98/NT):

If you want to help us develop MySQL for Win#/NT please mail to
[e-mail] to get help to set up your environment!

All questions that are specific to the windows version should be
posted to this list!  Please remember to include all relevant
information that may help solve your problem.

Requests to be added or dropped from the mysql-win32 list should be
sent to the electronic mail address [e-mail]. Sending a one-line
message with body text of either "subscribe mysql-win32" or
"unsubscribe mysql-win32" will suffice. If your reply address is not
valid, you may use "subscribe mysql-win32 [e-mail]-domain" or
"unsubscribe mysql-win32 [e-mail]-domain".

One behalf of the TcX gang,
Michael Widenius & David Axmark