Instalando o MySQL a partir do Fonte no Windows

Estas instru¸c˜oes descrevem como construir o bin´ario do MySQL a partir do fonte paras vers˜oes 4.1 e acima no Windows. As instru¸c˜oes s˜ao fornecidas para construir bin´arios a partir de uma distribui¸c˜ao fonte padr˜ao ou a partir da ´arvore do BitKeeper que cont´em o fonte do desenvolvimento mais atuais.

Nota: As instru¸c˜oes neste documento est˜ao restritas aos usu´arios que queiram testar o MySQL no Windows a partir da ´ultima distribui¸c˜ao fonte ou da ´arvore do BitKeeper.

Para uso em produ¸c˜ao, a MySQL AB n˜ao aconselha que vocˆe utilize um servidor MySQL constru´ido por vocˆe mesmo a partir de um fonte. Normalmente ´e melhor usar uma dis-tribui¸c˜ao bin´aria precompilada do MySQL que ´e constru´ida especificamente para

desem-penho otimizado no Windows pela MySQL AB. Instru¸c˜oes para instalar uma distribui¸c˜ao bin´aria est´a dispon´ivel em Se¸c˜ao 2.1.1 [Windows installation], P´agina 60.

Para construir o MySQL no Windows a partir do fonte, vocˆe precisa dos seguintes compi-ladores e recursos dison´iveis em seu sistema Windows:

• Compilador VC++ 6.0 (atualizado com o SP 4 ou 5 e pacote Pre-processador) O pacote Pre-processador ´e necess´ario para a macro assembler. Mais detalhes em:

http://msdn.microsoft.com/vstudio/downloads/updates/sp/vs6/sp5/faq.aspx.

• Aproximadamente 45 MB de espa¸co em disco.

• 64 MB de RAM

Vocˆe tamb´em precisar´a de um distribui¸c˜ao fonte para o Windows. Existem dois modos de conseguir uma distribui¸c˜ao fonte do MySQL vers˜ao 4.1 e acima:

1. Obtenha um pacote de uma distribui¸c˜ao fonte pela MySQL AB para a vers˜ao do MySQL que vocˆe est´a particularmente interessado. Distribui¸c˜oes fontes empacotadas est˜ao dispon´iveis para vers˜oes distribu´idas do MySQ e podem ser obtidas em http://www.mysql.com/downloads/.

2. Vocˆe pode empacotar um distribui¸c˜ao fonte vocˆe mesmo a partir da ultima ´arvore fonte de desenvolvimento do BitKeeper. Se vocˆe planeja fazer isto, vocˆe deve criar o pacote em um sistema Unix e ent˜ao transfr´i-lo para seu sistema Windows. (A raz˜ao para isto ´e que alguns dos passos de configura¸c˜ao e constru¸c˜ao exigem ferramentas que funcionam apenas no Unix.) A abordagem do BitKeeper, exige:

• Um sistema executando Unix ou um sistema tipo Unix, como o Linux

• BitKeeper 3.0 instalado neste sistema. Vocˆe pode obter o BitKeeper em http://www.bitkeeper.com/.

Se vocˆe estiver usando uma distribui¸c˜ao fonte do Windows, vocˆe pode ir diretamente para Se¸c˜ao 2.3.7.1 [Windows VC++ Build], P´agina 108. Para contruir a partir da ´arvore do BitKeeper, v´a para Se¸c˜ao 2.3.7.2 [Windows BitKeeper Build], P´agina 110.

Se vocˆe encontrar alguma coisa que n˜ao est´a funcionando como esperado, ou tiver sugest˜oes sobre o mode de melhorar o processo de constru¸c˜ao atual no Windows, envie uma mensagem para a lista de emailwin32. Veja Se¸c˜ao 1.7.1.1 [Mailing-list], P´agina 33.

2.3.7.1 Construindo o MySQL Usando VC++

Nota: O MySQL 4.1 e arquivos do espe¸co de trabalho do VC++ s˜ao compat´iveis com o Microsoft Visual Studio 6.0 e as edi¸c˜oes acima (7.0/.NET) e testados pela equipe da MySQL AB antes de cada distribui¸c˜ao.

Siga este procedimento para construir o MySQL:

1. Crie um diret´orio de trabalho (ex.: ‘workdir’).

2. Descompacte a distribui¸c˜ao fonte no diret´orio mencionado acima usando Winzip ou outra ferramenta que possa ler arquivos ‘.zip’.

3. Inicie o compilador VC++ 6.0.

4. No menuFile, selecioneOpen Workspace.

5. Abra o workspace ‘mysql.dsw’ que vocˆe encontrar no diret´orio de trabalho.

6. No menuBuild, selcione o menu Set Active Configuration.

7. Clique sobre a tela selecionada mysqld - Win32 Debuge clique OK.

8. Pressione F7 para iniciar a constru¸c˜ao da depura¸c˜ao do servidor, bibliotecas e alguns aplicativos clientes.

9. Compile as vers˜oes distribu´idas que vocˆe desejar, do mesmo modo.

10. Vers˜oes depuradas dos programas e bibliotecas s˜ao colocados nos diret´orios

‘client_debug’ e ‘lib_debug’. Vers˜oes liberadas dos programas e bibliotecas s˜ao colocados nos diret´orios ‘client_release’ e ‘lib_release’. Note que se vocˆe quiser construir tanto vers˜oes liberadas quanto depuradas vocˆe pode selecionar a op¸c˜ao

“build all” do menu Build.

11. Teste o servidor. O servidor constru´ido usando as instru¸c˜oes anteriores ir´a esperar que o diret´orio base e de dados do MySQL seja ‘C:\mysql’ e ‘C:\mysql\data’ por padr˜ao.

Se vocˆe quiser testar o seu servidor usando o diret´orio raiz de uma ´arvore fonte e seu diret´orio de dados como o diret´orio base e o diret´orio de dados, vocˆe precisar´a dizer ao servidor os seus caminhos. Vocˆe tamb´em pode fazer into na linha de comando com as op¸c˜oes --basedire--datadir, ou colocar op¸c˜oes apropriadas no arquivo de op¸c˜oes (o arquivo ‘C:\my.cnf’ ou ‘my.ini’ no diret´orio do Windows). Se vocˆe tiver um diret´orio de dados existente em qualquer lugar que vocˆe queira usar, vocˆe pode especific´a-lo no se caminho.

12. Inicie o ser servidor a partir do diret´orio ‘client_release’ ou ‘client_debug’, depen-dendo de qual servidor vocˆe queira usar. O instru¸c˜oes gerais de inicializa˜ao do servidor est˜ao em Se¸c˜ao 2.1.1 [Windows installation], P´agina 60. Vocˆe precisar´a adaptar as instru¸c˜oes de forma apropriada se vocˆe quiser usar um diret´orio base ou diret´orio de dados diferente.

13. Quando o servidor est´a em execu¸c˜ao de modo independente ou como um servi¸co daseado em sua configura¸c˜ao, tente se conectar a ele pelo utilit´ario interativomysqlde linha de comando que existe em seu diret´orio ‘client_release’ ou ‘client_debug’.

Quando vocˆe estiver certo de que os programas que vocˆe construiu est˜ao funcionando cor-retamente, pare o servidor. Ent˜ao instale o MySQL da seguinte forma:

1. Crie o diret´orio para instalar os arquivos do MySQL. Por exemplo, para instalar dentro de ‘C:\mysql’), use estes comandos:

C:

mkdir \mysql mkdir \mysql\bin mkdir \mysql\data mkdir \mysql\share mkdir \mysql\scripts

Se vocˆe quiser compilar outros clientes e lig´a-los ao MySQL, vocˆe tamb´em deve criar diversos diret´orios adicionais:

mkdir \mysql\include mkdir \mysql\lib

mkdir \mysql\lib\debug mkdir \mysql\lib\opt

Se vocˆe quiser fazer um benchamrk do MySQL, crie este diret´orio:

mkdir \mysql\sql-bench Benchmark exigem suporte Perl.

2. Copie do diret´orioworkdir para o diret´orioc:\mysqlos seguintes diret´orios:

copy client_release\*.exe C:\mysql\bin

copy client_debug\mysqld.exe C:\mysql\bin\mysqld-debug.exe xcopy scripts\*.* C:\mysql\scripts /E

xcopy share\*.* C:\mysql\share /E

Se vocˆe quiser compilar outros clientes e lig´a-los ao MySQL, vocˆe tamb´em deve fazer isto:

copy lib_debug\mysqlclient.lib C:\mysql\lib\debug copy lib_debug\libmysql.* C:\mysql\lib\debug copy lib_debug\zlib.* C:\mysql\lib\debug

copy lib_release\mysqlclient.lib C:\mysql\lib\opt copy lib_release\libmysql.* C:\mysql\lib\opt copy lib_release\zlib.* C:\mysql\lib\opt copy include\*.h C:\mysql\include

copy libmysql\libmysql.def C:\mysql\include

Se vocˆe quiser fazer um benchmark do MySQL, vocˆe tamb´em deve fazer isto:

xcopy sql-bench\*.* C:\mysql\bench /E

Configure e inicie o servidor da mesma forma que a distribui¸c˜ao bin´aria do Windows. Veja Se¸c˜ao 2.1.1.3 [Windows prepare environment], P´agina 62.

2.3.7.2 Criando um Pacote Fonte do Windows a partir da ´ Ultima Fonte de Desenvolvimento

Para construir o ´ultimo pacote fonte do Windows a partir da arvor´e fonte atual do Bit-Keeper, use as seguintes instru¸c˜oes. Por favor, note que este procedimento deve ser real-izado em um sistema executando um sistema opercional Unix ou similar. (Sabe-se que este procedimento funciona bem com o Linux, por exemplo.)

1. Clone a ´arvore fonte do BitKeeper para o MySQL (vers˜ao 4.1 ou acima, como dese-jado). Para mais informa¸c˜oes sobre como clonar a ´arvore fonte veja as instru¸c˜oes em Se¸c˜ao 2.3.4 [Installing source tree], P´agina 100.

2. Configure e construa as distribui¸c˜oes para que vocˆe tenha um bin´ario do servidor para trabalhar. Um modo de se fazer isto ´e executar o seguinte comando no diret´orio de mais alto n´ivel de sua ´arvore fonte:

shell> ./BUILD/compile-pentium-max

3. After making sure that the build process completed successfully, run the following utility script from top-level directory of your source tree:

shell> ./scripts/make_win_src_distribution

This script creates a Windows source package, to be used on your Windows system.

You can supply different options to the script based on your needs. It accepts the following options:

--debug Debug, without creating the package --tmp Specify the temporary location --suffix Suffix name for the package

--dirname Directory name to copy files (intermediate) --silent Do not list verbosely files processed

--tar Create tar.gz package instead of .zip --help Show this help message

By default, make_win_src_distribution creates a zipped archive with the name

‘mysql-VERSION-win-src.zip’, whereVERSIONrepresents the version of your MySQL source tree.

4. Copy or upload to your Windows machine the Windows source package that you have just created. To compile it, use the instructions in Se¸c˜ao 2.3.7.1 [Windows VC++Build], P´agina 108.