home *** CD-ROM | disk | FTP | other *** search
/ Chip 2001 January / Chip_2001-01_cd1.bin / tema / mysql / mysql-3.23.28g-win-source.exe / docs / readme
Text File  |  1999-10-12  |  10KB  |  246 lines
  1. This is a release of MySQL for Win32.
  2.  
  3. This release is only for users that has a MySQL license, has MySQL support
  4. or has contributed something to the MySQL project.
  5.  
  6. If you have a MySQL licence or MySQL support, you have the right to
  7. install and use the MySQL-Win32 server (mysqld, mysqld-opt and
  8. mysqld-nt) on one computer / license.  A MySQL developer has the right
  9. to install a copy of MySQL-Win32 on all of his personal computers.
  10.  
  11. You are allowed to copy and redistribute all MySQL client programs and
  12. MySQL libraries.
  13.  
  14. If you don't belong to any of the above categories you are still free
  15. to evaluate the MySQL-win32 version, but you should get a MySQL
  16. license when you start using MySQL for real or after an evaluation
  17. period of no more than 30 days.
  18.  
  19. Sometimes in the future as we get more revenue from MySQL customers,
  20. we will make MySQL for Win32 available for free download under the
  21. same conditions that the other MySQL distributions. As Win32 is a new
  22. platform for us and the development time is MUCH higher on Win32
  23. we really need the revenue from this version to be able too
  24. give support to MySQL users and port new things to Win32.
  25.  
  26. The latest information about MySQL can be found at: http://www.tcx.se
  27.  
  28. To see what it can do take a look at the features section in the
  29. manual.
  30.  
  31. For future plans see the TODO appendix in the manual.
  32.  
  33. New features/bug fixes history is in the news appendix in the manual.
  34.  
  35. For the currently known bugs/misfeatures (known errors) see the bugs
  36. appendix in the manual.  The Win32 section contains notes that are
  37. specific to the MySQL win32 version.
  38.  
  39. For examples of SQL and benchmarking information see the bench
  40. directory.
  41.  
  42. The manual mentioned above can be found in the Docs directory. The
  43. manual is available in the following formats: as text in
  44. Docs/manual.txt, as HTML in Docs/manual_toc.html, as GNU Info in
  45. Docs/mysql.info and as PostScript in Docs/manual.ps.
  46.  
  47. For a contributed user manual see http://www.turbolift.com/mysql.
  48.  
  49. MySQL is brought to you by: Michael (Monty) Widenius at TcX
  50. DataKonsult AB.
  51.  
  52. For the other contributors see the Credits appendix in the manual.
  53.  
  54. At http://www.mysql.com/Downloads you can find a port of perl, with
  55. DBI, DBD-MySQL and DBD-ODBC that works under Win32 against a Win32
  56. or Unix mysqld server!
  57.  
  58. *************************************************************************
  59.  
  60. Notes for this version:
  61.  
  62. Starting with 3.22.21 we are now using internal character maps (ISO559-1)
  63. for character mapping/sorting to avoid problems with the Win95 character maps!
  64. If you are upgrading from an older MySQL version, it's recommended that you
  65. run isamchk -rq on all old tables!
  66.  
  67. There is 3 different SQL servers included with this package:
  68.  
  69. mysqld        Compiled with full debugging and automatic memory allocation
  70.         checking.  Requires TCP/IP.
  71. mysqld-opt    Optimized for a Pentium processor. Requires TCP/IP.
  72. mysqld-nt    Optimized for a Pentium pro processor. Has support for
  73.         named pipes. One can run this version on Win98, but in
  74.         this case no named pipes are created and one must
  75.         have TCP/IP installed.
  76.  
  77. All of the above versions should work on any Intel processor >= i386. 
  78.  
  79. The default privilige tables on Win32 gives all local users full privileges
  80. to all databases.  When one wants to make MySQL more secure one should set
  81. a password for all users and remove the row in the mysql.user table that
  82. has host='localhost' and user=''.
  83.  
  84. MySQL supports TCP/IP on all Win32 platforms and named pipes on NT.
  85. The default is to use named pipes for local connections on NT and use
  86. TCP/IP in all other cases if the client has TCP/IP installed.  The
  87. host name specifies which protocol is used:
  88.  
  89. Host name        protocol
  90. NULL (none)        NT: First named pipe, if this doesn't work TCP/IP
  91.             Win95/Win98: TCP/IP 
  92. .            named pipes
  93. localhost        TCP/IP to current host
  94. hostname        TCP/IP
  95.  
  96. One can force a MySQL client to use named pipes by specifying the
  97. --pipe option.  The --socket option specifies the name of the pipe.
  98.  
  99. Note that Win95/Win98 doesn't support creation of named pipes.  One
  100. can on Win95/Win98 only use named pipes to connect to a remote MySQL running
  101. on a NT server.
  102.  
  103. Starting MySQL (this will start mysqld in the background without a window):
  104.  
  105.   bin\mysqld
  106.  
  107. or on NT if you don't want to start mysqld as a service:
  108.  
  109.   bin\mysqld-nt --standalone
  110.  
  111. Killing the MySQL server:
  112.  
  113.   bin\mysqladmin -u root shutdown
  114.  
  115. Testing MySQL:
  116.  
  117.   bin\mysqlshow
  118.   bin\mysqlshow -u root mysql
  119.   bin\mysqladmin version status proc
  120.   bin\mysql test
  121.  
  122. On NT mysqld can be installed as a service with:
  123.  
  124.   bin\mysqld-nt --install        # Install MySQL as a service
  125.   bin\mysqld-nt --remove        # remove MySQL as a service
  126.  
  127. and start/stoped with
  128.  
  129.   NET START mysql
  130.   NET STOP mysql
  131.  
  132. Note that in this case you can't use any other options for mysqld!
  133.  
  134. You can also run mysqld as a standalone program on NT if you start
  135. mysqld with any other options!  If you start mysqld without options on
  136. NT, mysqld tries to starts itself as a service with the default
  137. service options.  If you have stopped mysqld, you have to start it with
  138. 'NET START mysql'.
  139.  
  140. The service is installed with the name "MySql". Once installed it must
  141. be started using Services Control Manager (SCM) Utility (found in
  142. Control Panel) or by using the 'NET START MySQL' command. If some
  143. options are wanted they must be specified as "Startup parameters" in
  144. the SCM utility before start.  Once running mysqld can be stopped
  145. using mysqladmin or from SCM utility or by using the command 'NET STOP
  146. MySQL'. In case of stopping from SCM, there is a strange message from
  147. SCM about 'mysqld shutdown normally'. Running as service mysqld has
  148. not access to a console and so no messages can be seen.
  149. If you have problems starting mysqld on NT, try starting it with the
  150. --standalone switch;  By doing this you will see error messages that doesn't
  151. show if mysqld is started as a service.
  152.  
  153. On NT you can get the following service error messages:
  154.  
  155. Permission Denied - Means that it cannot find mysqld.exe
  156. Cannot Register   - Means that the path is incorrect
  157.  
  158. - You can also use MyODBC or perl to connect to mysqld.
  159.  
  160. - This version is configured to be installed in c:\mysql.  You can however
  161.   copy this anywhere as long as you don't change the directory structure.
  162.   For example:
  163.   mkdir d:\mysql
  164.   xcopy c:\mysql\*.* d:\mysql
  165.  
  166.   mysqld should be able to automaticly find its files based on where
  167.   mysqld is located.  If you want to use files from some other place, you
  168.   can tell mysqld to use some other directory with --basedir='path'.
  169.   You can also create a c:\\my.cnf file that holds any default options for
  170.   the MySQL server.
  171.  
  172. - If you have problems installing mysqld as a service, try starting mysqld
  173.   with the full path:  'C:\mysql\bin\mysqld --install'.
  174.   If this doesn't work, you can get mysqld to start properly by fixing
  175.   the path in the registry!
  176.  
  177. - If mysqld is slow to answer to connections on Win9# this is probably a
  178.   problem with your DNS. In this case start mysqld with --skip-name-resolve
  179.   and use only 'localhost' and IP numbers in the MySQL privilege tables.
  180.   You can also avoid DNS by connecting to a MySQL server on NT, running
  181.   mysqld-nt, with named pipes by using the --pipe argument to most
  182.   MySQL clients.
  183.  
  184. - Most things appears to work nicely on Win32.  We use the MySQL
  185.   benchmarks and crash-me to check each version before releasing it.
  186.  
  187. - The distributed default MySQL version is compiled with debugging information
  188.   so one can get a trace file with: mysqld --debug.  After one has verified
  189.   mysqld works correctly one can switch to the optimized version:
  190.   mysqld-opt or mysql-nt.
  191.  
  192. - There are two versions of the 'mysql' command line tool; 'mysql', compiled
  193.   on native Win32, which offers very limited text editing capabilities and
  194.   'mysqlc', compiled with the Cygnus gnu compiler and libraries, which offers
  195.   readline editing.
  196.  
  197. - The default permission is that anyone can use any database that
  198.   starts with 'test' from any host and anyone running on the same machine
  199.   as mysqld is running can take it down.
  200.   mysqladmin shutdown.
  201.  
  202. - Normally one should add a password for the 'root' user and take mysqld down
  203.   with:
  204.   mysqladmin --user=root --password=your_password shutdown
  205.  
  206.   In this case one should remove the entry with host='localhost' and user=''
  207.   from the user database.
  208.  
  209.   The above is most easly done with:
  210.  
  211. shell> mysql mysql
  212. mysql> delete from user where host='localhost' and user='';
  213. mysql> quit
  214. shell> mysqladmin reload
  215. shell> mysqladmin -u root password your_password
  216.  
  217. - This distribution includes the a prototype of a new GUI tool,
  218.   MySQLManager, by James Pereria.  This has still some rough edges,
  219.   but it can serve as a great base for further development!
  220.  
  221. - MySQLWinAdmn is a Delphi program, by David B. Mansel, to administrate
  222.   MySQL databases. (Binary only).  We are waiting for an updated version that
  223.   will work with the current libmysql.dll
  224.  
  225. If you would like to work on the MySQL win32 version, you can find a list
  226. of open issues in the reference manual. We are not that used with the
  227. Win32 environment so many of the issues may be real easy to solve for
  228. someone familiar with Win95/Win98/NT):
  229.  
  230. If you want to help us develop MySQL for Win95 please mail to
  231. mysql-win32@tcx.se to get help to set up your environment!
  232.  
  233. All questions that are specific to the windows version should be
  234. posted to this list!  Please remember to include all relevant
  235. information that may help solve your problem.
  236.  
  237. Requests to be added or dropped from the mysql-win32 list should be
  238. sent to the electronic mail address mdomo@tcx.se. Sending a one-line
  239. message with body text of either "subscribe mysql-win32" or
  240. "unsubscribe mysql-win32" will suffice. If your reply address is not
  241. valid, you may use "subscribe mysql-win32 your@address.your-domain" or
  242. "unsubscribe mysql-win32 your@address.your-domain".
  243.  
  244. One behalf of the TcX gang,
  245. Michael Widenius & David Axmark
  246.