2 MySQL Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65

       2.1 Quick Standard Installation of MySQL. . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . 65
              2.1.1 Installing MySQL on Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
              2.1.2 Installing MySQL on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
              2.1.2.1 Installing the Binaries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .67
              2.1.2.2 Preparing the Windows MySQL Environment . . . . . . . . . . . . . . . . . . . . . 67
              2.1.2.3 Starting the Server for the First Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
       2.2 General Installation Issues . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . .69
              2.2.1 How to Get MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
              2.2.2 Operating Systems Supported by MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . .69
              2.2.3 Which MySQL Version to Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
              2.2.4 Installation Layouts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
              2.2.5 How and When Updates Are Released. . . . . . . . . . . . . . . . . . . . . . . . . . . . .74
              2.2.6 MySQL Binaries Compiled by MySQL AB. . . . . . . . . . . . . . . . . . . . . . . . . . . .75
              2.2.7 Installing a MySQL Binary Distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
       2.3 Installing a MySQL Source Distribution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
              2.3.1 Quick Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .80
              2.3.2 Applying Patches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83
              2.3.3 Typical configure Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
              2.3.4 Installing from the Development Source Tree. . . . . . . . . . . . . . . . . . . . . . . 86
              2.3.5 Problems Compiling? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
              2.3.6 MIT-pthreads Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
              2.3.7 Windows Source Distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90
       2.4 Post-installation Setup and Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91
              2.4.1 Problems Running mysql_install_db . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
              2.4.2 Problems Starting the MySQL Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
              2.4.3 Starting and Stopping MySQL Automatically . . . . . . . . . . . . . . . . . . . . . . . . 98
       2.5 Upgrading/Downgrading MySQL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99
              2.5.1 Upgrading From Version 3.23 to Version 4.0 . . . . . . . . . . . . . . . . . . . . . . 100
              2.5.2 Upgrading From Version 3.22 to Version 3.23 . . . . . . . . . . . . . . . . . . . . . 102
              2.5.3 Upgrading from Version 3.21 to Version 3.22 . . . . . . . . . . . . . . . . . . . . . .103
              2.5.4 Upgrading from Version 3.20 to Version 3.21 . . . . . . . . . . . . . . . . . . . . . .104
              2.5.5 Upgrading to Another Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105
       2.6 Operating System Specific Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106
              2.6.1 Linux Notes (All Linux Versions) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
              2.6.1.1 Linux Notes for Binary Distributions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
              2.6.1.2 Linux x86 Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111
              2.6.1.3 Linux SPARC Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
              2.6.1.4 Linux Alpha Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112
              2.6.1.5 Linux PowerPC Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
              2.6.1.6 Linux MIPS Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
              2.6.1.7 Linux IA64 Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113
              2.6.2 Windows Notes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113
              2.6.2.1 Starting MySQL on Windows 95, 98 or Me . . . . . . . . . . . . . . . . . . . . . . .113
              2.6.2.2 Starting MySQL on Windows NT, 2000 or XP . . . . . . . . . . . . . . . . . . . . 114
              2.6.2.3 Running MySQL on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
              2.6.2.4 Connecting to a Remote MySQL from Windows with SSH . . . . . . . . .117
              2.6.2.5 Splitting Data Across Di erent Disks on Windows . . . . . . . . . . . . . . . .117
              2.6.2.6 Compiling MySQL Clients on Windows . . . . . . . . . . . . . . . . . . . . . . . . . 118
              2.6.2.7 MySQL-Windows Compared to Unix MySQL . . . . . . . . . . . . . . . . . . . . . 118
              2.6.3 Solaris Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120
              2.6.3.1 Solaris 2.7/2.8 Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
              2.6.3.2 Solaris x86 Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
              2.6.4 BSD Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .124
              2.6.4.1 FreeBSD Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .124
              2.6.4.2 NetBSD notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
              2.6.4.3 OpenBSD 2.5 Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125
              2.6.4.4 OpenBSD 2.8 Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126
              2.6.4.5 BSD/OS Version 2.x Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
              2.6.4.6 BSD/OS Version 3.x Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
              2.6.4.7 BSD/OS Version 4.x Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
              2.6.5 Mac OS X Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
              2.6.5.1 Mac OS X Public Beta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127
              2.6.5.2 Mac OS X Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
              2.6.6 Other Unix Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128
              2.6.6.1 HP-UX Notes for Binary Distributions . . . . . . . . . . . . . . . . . . . . . . . . . . .128
              2.6.6.2 HP-UX Version 10.20 Notes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
              2.6.6.3 HP-UX Version 11.x Notes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .129
              2.6.6.4 IBM-AIX notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131
              2.6.6.5 SunOS 4 Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132
              2.6.6.6 Alpha-DEC-UNIX Notes (Tru64). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132
              2.6.6.7 Alpha-DEC-OSF/1 Notes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
              2.6.6.8 SGI Irix Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135
              2.6.6.9 Caldera (SCO) Notes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
              2.6.6.10 Caldera (SCO) Unixware Version 7.0 Notes . . .. . . . . . . . . . . . . . . . . 138
              2.6.7 OS/2 Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138
              2.6.8 BeOS Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139
              2.6.9 Novell NetWare Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139
       2.7 Perl Installation Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139
              2.7.1 Installing Perl on Unix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
              2.7.2 Installing ActiveState Perl on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . .140
              2.7.3 Installing the MySQL Perl Distribution on Windows . . . . . . . . . . . . . . . . .141
              2.7.4 Problems Using the Perl DBI/DBD Interface . . . . . . . . . . . . . . . . . . . . . . .141