2.8. Instalación de MySQL usando una distribución de código fuente

1. Descargar el cliente gratuito BitKeeper desde http://www.bitmover.com/bk-client.shar.

2. En Unix, instalar el cliente gratuito de esta manera:

   shell> sh bk-client.shar
   shell> cd bk_client-1.1
   shell> make all
   shell> PATH=$PWD:$PATH
   

   En Windows, instalarlo de esta manera:

   • Descargar e instalar Cygwin desde http://cygwin.com.

   • Asegurarse de que gcc fue instalado bajo Cygwin. Esto se comprueba emitiendo which gcc. Si no está instalado, ejecutar el gestor de paquetes (package manager) de Cygwin, seleccionar gcc, e instalarlo.

   • Bajo Cygwin, llevar a cabo estos pasos:

     shell> sh bk-client.shar
     shell> cd bk_client-1.1
     

     Luego, editar el fichero Makefile y modificar la línea que lee $(CC) $(CFLAGS) -o sfio -lz sfio.c para que quede así:

     $(CC) $(CFLAGS) -o sfio sfio.c -lz
     

     Ejecutar el comando make y establecer la ruta:

     shell> make all
     shell> PATH=$PWD:$PATH
     

3. Después que el cliente gratuito BitKeeper se haya instalado, dirigirse en primer lugar al directorio desde donde se desea trabajar y utilizar el siguiente comando para hacer una copia local de la rama de MySQL 5.0:

   shell> sfioball -r+ bk://mysql.bkbits.net/mysql-5.0 mysql-5.0
   

   Normalmente, no es necesario generar la documentación, dado que ya es suministrada en una variedad de formatos en http://dev.mysql.com/doc/. Los formatos que pueden descargarse allí (HTML, PDF, etc.) están generados diariamente, de modo que no se gana gran cosa generándola en base a los documentos en formato XML DocBook que hay en el directorio mysqldoc. Si de todos modos se deseara copiar el repositorio de documentación, debe emplearse el siguiente comando:

   shell> sfioball -r+ bk://mysql.bkbits.net/mysqldoc mysqldoc
   

   En el ejemplo anterior, el árbol de código fuente se establece dentro del subdirectorio mysql-5.0/ dentro del

   Si se está detrás de un firewall y solamente pueden iniciarse conexiones HTTP, BitKeeper también puede usarse sobre HTTP.

   Si se necesita usar un servidor proxy, establecer la variable de entorno http_proxy para apuntar al mismo:

   shell> export http_proxy="http://your.proxy.server:8080/"
   

   Reemplazar bk:// con http:// cuando se copie un repositorio. Ejemplo:

   shell> sfioball -r+ http://mysql.bkbits.net/mysql-5.0 mysql-5.0
   

   La descarga inicial del árbol de código fuente puede llevar un tiempo, dependiendo de la velocidad de la conexión. Si es así, habrá que tener paciencia hasta completar la descarga.

4. Para actualizar la copia local del repositorio MySQL 5.0, debe emplearse este comando:

   shell> update bk://mysql.bkbits.net/mysql-5.0
   

5. Son necesarios: GNU make, autoconf 2.58 (o posterior), automake 1.8, libtool 1.5, y m4 para ejecutar la siguiente serie de comandos. Aún cuando muchos sistemas operativos vienen con su propia implementación de make, hay muchas posibilidades de que la compilación falle con extraños mensajes de error. Por consiguiente, es muy recomendable utilizar GNU make (a veces llamado gmake) en lugar de otros.

   Afortunadamente, un gran número de sistemas operativos se distribuyen con las herramientas GNU preinstaladas o proveen paquetes instalables de las mismas. En cualquier caso, pueden descargarse de las siguientes direcciones:

   • http://www.gnu.org/software/autoconf/

   • http://www.gnu.org/software/automake/

   • http://www.gnu.org/software/libtool/

   • http://www.gnu.org/software/m4/

   • http://www.gnu.org/software/make/

   Para configurar MySQL 5.0, también se necesitará GNU bison 1.75 o posterior. Las versiones antiguas de bison pueden producir este error:

   sql_yacc.yy:#####: fatal error: maximum table size (32767) exceeded
   

   Nota: El mensaje es: "Error fatal: se ha excedido el tamaño máximo para la tabla (32767)". El tamaño máximo de la tabla no está realmente excedido, el mensaje es consecuencia de errores en versiones antiguas de bison.

   El siguiente ejemplo muestra los comandos típicamente requeridos para configurar un árbol de código fuente. El primer comando cd es para posicionarse en el directorio de más alto nivel en el árbol, debe reemplazarse mysql-5.0 con el nombre de directorio apropiado.

   shell> cd mysql-5.0
   shell> bk -r edit
   shell> aclocal; autoheader
   shell> libtoolize --automake --force
   shell> automake --force --add-missing; autoconf
   shell> (cd innobase; aclocal; autoheader; autoconf; automake)
   shell> (cd bdb/dist; sh s_all)
   shell> ./configure  # Add your favorite options here
   shell> make
   

   O bien puede usarse BUILD/autorun.sh como un atajo para la siguiente secuencia de comandos:

   shell> aclocal; autoheader
   shell> libtoolize --automake --force
   shell> automake --force --add-missing; autoconf
   shell> (cd innobase; aclocal; autoheader; autoconf; automake)
   shell> (cd bdb/dist; sh s_all)
   

   La línea de comandos que cambia el directorio dentro de innobase y bdb/dist se usa para configurar los motores de almacenamiento InnoDB y Berkeley DB (BDB). Pueden omitirse si no se necesita soporte para InnoDB o BDB.

   Si se obtienen algunos mensajes de error extraños durante este paso, debe verificarse si verdaderamente se encuentra instalado libtool.

   En el subdirectorio BUILD/ se encuentra una colección de scripts de configuración estándar utilizados por MySQL AB. Es posible que resulte más conveniente utilizar el script BUILD/compile-pentium-debug que el conjunto de comandos antes mencionado. Para compilar en una arquitectura diferente, debe modificarse el script eliminando los flags que son específicos de Pentium.

6. Cuando la generación esté concluida, debe ejcutarse make install. Debe tenerse cuidado con esto al aplicarlo en un ordenador en producción; los comandos pueden sobreeescribir la instalación en uso. Si hay otra instalación de MySQL, se recomienda ejecutar ./configure con valores diferentes para las opciones --prefix, --with-tcp-port, y --unix-socket-path que aquellos empleados en el servidor en producción.

7. Ahora se debe "jugar" con la nueva instalación e intentar que las nuevas características colapsen con algún error. Debe comenzarse por ejecutar make test. Consulte Sección 27.1.2, “El paquete de pruebas MySQL Test”.

8. Si se ha llegado a la etapa de make y la distribución no se compila, debe informarse en la base de datos de errores en http://bugs.mysql.com/. Si se han instalado las últimas versiones de las herramientas GNU necesarias, y estas caen al intentar procesar los ficheros de configuración provistos, también debe informarse. Sin embargo, si se ejecuta aclocal y se obtiene un error command not found o similar, no debe informarse. En su lugar, hay que asegurarse de que todas las herramientas necesarias estén instaladas y que la variable PATH está correctamente establecida para que el shell las pueda localizar.

9. Luego de la copia inicial del repositorio (sfioball) para obtener el árbol de código fuente, se debe actualizar el repositorio (update) periódicamente para obtener novedades.

10. Para examinar la historia de cambios del árbol, con todas las diferencias, puede verse el fichero BK/ChangeLog localizado en el árbol de código fuente y observar las descripciones ChangeSet listadas. Para examinar una descripción changeset en particular, se utiliza el comando sfioball para extraer dos revisiones del árbol de código fuente, y luego se utiliza un comando externo diff para compararlas. En caso de hallar diferencias poco claras o tener preguntas acerca del código, no debe dudarse en enviar un correo electrónico a la lista de correo internals de MySQL. Consulte Sección 1.6.1.1, “Las listas de correo de MySQL”. Asimismo, si se considera que se tiene una mejor idea sobre cómo realizar algo, debe enviarse un mensaje de correo a la misma lista con la corrección.

11. El cliente gratuito BitKeeper es ditribuido con su código fuente. La única documentación disponible para el cliente gratuito es el propio código fuente.

• Si se ejecuta configure después de habérselo ejecutado anteriormente, éste puede emplear información recogida durante la primera vez. Esta información se almacena en config.cache. Cuando se inicia configure, busca aquel fichero y lee su contenido si existe, suponiendo que la información continúa siendo válida. Esa suposición es incorrecta cuando se ha reconfigurado.

• Cada vez que se ejecuta configure, se debe ejecutar make nuevamente para recompilar. Sin embargo, primero se podría desear eliminar ficheros objeto antiguos, pertenecientes a procesos de generación anteriores, ya que fueron compilados utilizando diferentes opciones de configuración.

• Si se obtienen errores como los que se muestran cuando se compila sql_yacc.cc, probablemente se trate de memoria insuficiente o espacio de intercambio insuficiente:

  Internal compiler error: program cc1plus got fatal signal 11
  Out of virtual memory
  Virtual memory exhausted
  

  El problema es que gcc necesita enormes cantidades de memoria para compilar sql_yacc.cc con funciones "inline". Inténtese ejecutar configure con la opción --with-low-memory:

  shell> ./configure --with-low-memory
  

  Esta opción causa que -fno-inline se agregue a los argumentos del compilador si se está utilizando gcc, y -O0 si se está utilizando cualquier otro. Se debería probar la opción --with-low-memory aún si se tiene tanta cantidad de memoria de espacio de intercambio que no parece posible que sean insuficientes. Este problema se ha observado inclusive en sistemas con configuraciones de hardware generosas. y la opción --with-low-memory usualmente lo repara.

• Por defecto, configure asume c++ como nombre del compilador y GNU c++ enlaza con -lg++. Si se está empleando gcc, tal comportamiento puede causar problemas como este durante la configuración:

  configure: error: installation or configuration problem:
  C++ compiler cannot create executables.
  

  También se podrían observar problemas durante la compilacion relacionados con g++, libg++, o libstdc++.

  Una causa para estos problemas es que no se tenga g++, o quizá se tenga g++ pero no libg++, o libstdc++. Se debe inspeccionar el fichero config.log. Este debería contener el motivo exacto por el cual el compilador de C++ no está funcionando. Para eludir estos problemas, se puede utilizar gcc como compilador de C++. Debe ponerse en la variable de entorno CXX el valor "gcc -O3". Por ejemplo:

  shell> CXX="gcc -O3" ./configure
  

  Esto funciona porque gcc compila código C++ tan bien como g++, pero no enlaza por defecto con las bibliotecas libg++ o libstdc++.

  Otra forma de solucionar el problema es instalar g++, libg++, y libstdc++. Sin embargo, se recomiendo no emplear libg++ o libstdc++ con MySQL porque sólo incrementará el tamaño del ejecutable sin obtener ningún beneficio. Algunas versiones de estas bibliotecas también han causado en el pasado problemas extraños a los usuarios de MySQL.

• Si la compilación fallara por errores como cualquiera de los siguientes, se debe actualizar la versión de make a GNU make:

  making all in mit-pthreads
  make: Fatal error in reader: Makefile, line 18:
  Badly formed macro assignment
  

  O bien:

  make: file `Makefile' line 18: Must be a separator (:
  

  O bien:

  pthread.h: No such file or directory
  

  Se sabe que los programas make de Solaris y FreeBSD son problemáticos.

  La versión 3.75 de GNU make funciona correctamente.

• Si se desean definir flags para ser usados por los compiladores de C o C++, se debe hacer agregando los flags a las variables de entorno CFLAGS y CXXFLAGS. De este mismo modo pueden especificarse los nombres del compilador utilizando CC y CXX. Por ejemplo:

  shell> CC=gcc
  shell> CFLAGS=-O3
  shell> CXX=gcc
  shell> CXXFLAGS=-O3
  shell> export CC CFLAGS CXX CXXFLAGS
  

  Consulte Sección 2.1.2.5, “Binarios de MySQL compilados por MySQL AB” para una lista de definiciones de flags que han resultado útiles en varios sistemas.

• Si se obtiene un mensaje de error como este, se necesitará actualizar el compilador gcc:

  client/libmysql.c:273: parse error before `__attribute__'
  

  gcc 2.8.1 funciona correctamente, pero se recomienda utilizar gcc 2.95.2 o egcs 1.0.3a en su lugar.

• Si se obtienen errores como los siguientes al compilar mysqld, configure no está detectando correctamente el tipo del último argumento pasado a accept(), getsockname(), o getpeername():

  cxx: Error: mysqld.cc, line 645: In this statement, the referenced
       type of the pointer value ''length'' is ''unsigned long'',
       which is not compatible with ''int''.
  new_sock = accept(sock, (struct sockaddr *)&cAddr, &length);
  

  Para corregir esto, debe modificarse el fichero config.h (el cual es generado por configure). Deben buscarse estas líneas:

  /* Define as the base type of the last arg to accept */
  #define SOCKET_SIZE_TYPE XXX
  

  Hay que cambiar XXX por size_t o int, dependiendo del sistema operativo. (Tener en cuenta que esto debe hacerse cada vez que se ejecuta configure, porque este regenera el fichero config.h.)

• El fichero sql_yacc.cc se genera a partir de sql_yacc.yy. Normalmente el proceso de compilación no necesita crear sql_yacc.cc, porque MySQL viene con una copia ya generada. Sin embargo, si se necesita crearlo de nuevo, se podría hallar este error:

  "sql_yacc.yy", line xxx fatal: default action causes potential...
  

  Este es un síntoma de que se posee una versión deficiente de yacc. Posiblemente se necesite instalar en su lugar bison (la versión GNU de yacc).

• En Linux Debian 3.0, se necesita instalar gawk en lugar del predeterminado mawk si se desea compilar MySQL 5.0 con soporte para Bases de Datos Berkeley.

• Si se necesita depurar mysqld o un cliente MySQL, ejecutar configure con la opción --with-debug, luego recompilar y enlazar los clientes con la nueva biblioteca. Consulte Sección D.2, “Depuración de un cliente MySQL”.

• Si se obtiene un error de compilación en Linux (por ejemplo, en Linux SuSE 8.1 o Linux RedHat 7.2) similar a los siguientes:

  libmysql.c:1329: warning: passing arg 5 of `gethostbyname_r' from
  incompatible pointer type
  libmysql.c:1329: too few arguments to function `gethostbyname_r'
  libmysql.c:1329: warning: assignment makes pointer from integer
  without a cast
  make[2]: *** [libmysql.lo] Error 1
  

  Por defecto, el script configure intenta determinar el número correcto de argumentos empleando g++, el compilador C++ GNU. Este proceso arroja resultados incorrectos si no está instalado g++. Hay dos formas de solucionar esto:

  • Asegurarse de que GNU C++ g++ está instalado. En algunas distribuciones de Linux, el paquete que se necesita se llama gpp; en otras, se llama gcc-c++.

  • Para utilizar gcc como compilador de C++ se debe poner en la variable de entorno CXX el valor gcc:

    export CXX="gcc"
    

  Después debe volver a ejecutarse configure.

• En la mayoría de los sistemas, para forzar el uso de MIT-pthreads se debe ejecutar configure con la opción --with-mit-threads.

  shell> ./configure --with-mit-threads
  

  La generación (building) en un directorio que no sea de código fuente no está soportada cuando se usan MIT-pthreads porque se desea minimizar los cambios al código.

• La comprobación que determina si se utilizará MIT-pthreads sucede únicamente durante la parte del proceso de configuración que tiene que ver con el código del servidor. Si se ha configurado la distribución empleando --without-server para generar solamente el código del cliente, los clientes no saben si se está utilizando MIT-pthreads y emplean conexiones socket Unix por defecto. Dado que los ficheros socket de Unix no funcionan bajo MIT-pthreads en algunas plataformas, esto significa que se deberá utilizar -h o --host cuando se ejecuten programas cliente.

• Cuando se compila MySQL empleado MIT-pthreads, el bloqueo de sistema se deshabilita por defecto por razones de rendimiento. Se le puede indicar al servidor que emplee bloqueo de sistema con la opción --external-locking. Esto es necesario solamente si se desea poder ejecutar dos servidores MySQL sobre los mismos ficheros de datos, lo cual no es recomendable.

• Algunas veces, el comando bind() de pthread falla al adosarse a un socket sin emitir mensajes de error (al menos en Solaris). El resultado es que todas las conexiones al servidor fallan. Por ejemplo:

  shell> mysqladmin version
  mysqladmin: connect to server at '' failed;
  error: 'Can't connect to mysql server on localhost (146)'
  

  La solución a esto es finalizar el servidor mysqld y reiniciarlo. Esto ha ocurrido solamente cuando se ha detenido el servidor por la fuerza y se lo ha reiniciado inmediatamente.

• Con MIT-pthreads, la llamada de sistema sleep() no es interrumpida con SIGINT (interrupción). Esto solamente es perceptible cuando se ejecuta mysqladmin --sleep. Se debe esperar a que la llamada sleep() termine antes de que el pedido de interrupción sea atendido y el proceso se detenga.

• Durante el enlazado, se pueden recibir mensajes de advertencia como los siguientes (al menos en Solaris); deben ser ignorados.

  ld: warning: symbol `_iob' has differing sizes:
      (file /my/local/pthreads/lib/libpthread.a(findfp.o) value=0x4;
  file /usr/lib/libc.so value=0x140);
      /my/local/pthreads/lib/libpthread.a(findfp.o) definition taken
  ld: warning: symbol `__iob' has differing sizes:
      (file /my/local/pthreads/lib/libpthread.a(findfp.o) value=0x4;
  file /usr/lib/libc.so value=0x140);
      /my/local/pthreads/lib/libpthread.a(findfp.o) definition taken
  

• Algunas otras advertencias también deben ignorarse:

  implicit declaration of function `int strtoll(...)'
  implicit declaration of function `int strtoul(...)'
  

• No se ha podido hacer funcionar readline con MIT-pthreads. (Esto no es necesario, pero podría ser de interés para alguien).

• Compilador VC++ 6.0 (actualizado con SP4 o SP5 y paquete pre-procesador). El paquete pre-procesador se necesita para el macro assembler. Para más detalles consulte http://msdn.microsoft.com/vstudio/downloads/updates/sp/vs6/sp5/faq.aspx.

• Aproximadamente 45MB de espacio en disco.

• 64MB de RAM.

1. Obtener una distribución de código fuente preparada por MySQL AB desde http://dev.mysql.com/downloads/.

2. Preparar una distribución de código fuente a partir del último arbol BitKeeper de código en desarrollo. Si se planea hacer esto, habrá que crear el paquete en un sistema Unix y luego transferirlo al sistema Windows. (La razón para esto es que algunas de las configuraciones y etapas de la generación requieren herramientas que funcionan solamente en Unix.) El uso de BitKeeper requiere:

   • Un sistema ejecutando Unix o un sistema operativo similar, como Linux.

   • Bitkeeper 3.0 instalado en ese sistema. Consulte Sección 2.8.3, “Instalar desde el árbol de código fuente de desarrollo” para instrucciones sobre la descarga e instalación de BitKeeper.

Note: Los ficheros de espacio de trabajo (workspace) de VC++ para MySQL 5.0 son compatibles con Microsoft Visual Studio 6.0 y ediciones posteriores (7.0 / .NET); estos ficheros son probados por el personal de MySQL AB antes de cada release.

Debe seguirse este procedimiento para generar MySQL:

Cuando se esté satisfecho con el funcionamiento de los programas compilados, detener el servidor. Entonces, instalar MySQL de la siguiente manera:

Configurar e iniciar el servidor del mismo modo que para la distribución binaria para Windows. Consulte Sección 2.3, “Instalar MySQL en Windows”.

Para crear un paquete de código fuente Windows a partir del árbol BitKeeper actual, deben seguirse las siguientes instrucciones. Este procedimiento debe llevarse a cabo en un sistema con Unix o un sistema operativo estilo Unix. Por ejemplo, este procedimiento funciona bien en Linux.