PC World 2001 March

home *** CD-ROM | disk | FTP | other *** search

/ PC World 2001 March / PCWorld_2001-03_cd.bin / KOMUNIK / progweb / progweb.exe / mysql / DATA1.CAB / Help_Files / Readme < prev

Wrap

Text File | 2001-01-22 | 12.8 KB | 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 mysql-win32@mysql.com 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 mdomo@mysql.com. 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 your@address.your-domain" or "unsubscribe mysql-win32 your@address.your-domain". One behalf of the TcX gang, Michael Widenius & David Axmark