Distcc/es

Distcc es un programa diseñado para distribuir tareas de compilación a través de la red hacia máquinas participantes. Consiste en un servidor, distccd y un programa cliente, distcc. Distcc puede trabajar de forma transparente con ccache, Portage y Automake realizando una sencilla configuración.

Cuando planee utilizar distcc para ayudarle a realizar el bootstrap en una instalación Gentoo, asegúrese de leer Utilizar distcc para realizar el bootstrap.

Instalación
Antes de configurar distcc, echémos un vistazo a la instalación del paquete  en todos los equipos.

Requisitos para todos los equipos
Para utilizar distcc, todas las máquinas en la red deben tener la misma versión de GCC. Mezclar 3.3.x (variando la x) es correcto, pero mezclar 3.3.x y 3.2.x "puede" resultar en errores en tiempo de compilación o ejecución.

Instalar el software
Distcc incluye un monitor gráfico para monitorizar las tareas que un computador está enviando para compilación. Este monitor se habilita cuando el ajuste    está activado.

Después de configurar el ajuste, instale el paquete :

Auto iniciar el demonio distcc
Para que distccd arranque de forma automática se debe seguir las instrucciones siguientes dependiendo del sistema de inicio utilizado.

Usar OpenRC
Modifique y asegúrarse de usar la directiva --allow para permitir únicamente máquinas cliente de confianza. Para mayor seguridad debería utilizar también la directiva --listen para indicarle al demonio distcc</tt> en qué dirección IP debe escuchar (en sistemas con más de una dirección IP). Se puede encontrar más información acerca de seguridad en distcc</tt> en las notas sobre seguridad de distcc.

En el siguiente ejemplo se permite a los clientes distcc correr en 192.168.0.4</tt> y 192.168.0.5</tt> para conectarse al servidor distccd</tt> que corre en la máquina local:

Ahora inicie el demonio distcc</tt> en todas las máquinas participantes:

Usar systemd
Editar y añadir los clientes permitidos en formato CIDR. A continuación se muestra un ejemplo:

Recargar los fichero de unidad después de realizar estos cambios:

Habilitar el auto arranque de distcc</tt> y a continuación arrancar el servicio:

Configuración
Echemos un vistazo a la configuración de distcc</tt>.

Especificar las máquinas participantes
Utilice la orden distcc-config</tt> para indicar la lista de máquinas.

A continuación se muestra una lista ejemplo de definiciones de equipos. En la mayoría de los casos, serán suficientes variaciones de las líneas 1 y 2. Se puede encontrar más información sobre la sintaxis de las líneas 3 y 4 en la página del manual de distcc.

Hay otras formas de configurar máquinas. Eche un vistazo a la página del manual de distcc</tt> ( man distcc ) para obtener más información.

Si se van a realizar compilaciones en la máquina local debería escribir  en la lista de máquinas. Contrariamente, si no se va a utilizar la máquina local para compilar, omítala de la lista de máquinas. En una máquina lenta usar localhost puede de hecho hacer las cosas más lentas. Asegúrese de comprobar los ajustes para mejorar el rendimiento.

Configuraremos distcc</tt> para que usar los equipos mencionados en la primera línea del ejemplo:

Usar distcc con Portage
Configurar Portage para usar distcc</tt> es fácil. Es cuestión de habilitar la característica distcc</tt> y definir un valor correcto para el número de trabajos simultáneos (ya que así distcc</tt> incrementará la cantidad de recursos disponibles para la construcción)

Ajuste la variable  y la variable   tal y como se describe abajo.

Una estrategia común es
 * Definir el valor de  al doble del número total (local + remotas) de núcleos de CPU + 1, y
 * Definir el valor de  al número de núcleos de CPU locales

El uso de  en la varialble   evitará lanzar demasiadas tareas cuando alguno de los equipos del cluster de distcc</tt> no estén disponibles (incrementando la cantidad de trabajos simultáneos en el resto de los sistemas) o cuando se configure un ebuild para no permitir construcciones en remoto (como con gcc). Esto se logra rechazando el inicio de trabajos adicionales cuando la carga del sistema están en el valor de M</tt> o por encima de éste.

Por ejemplo, cuando hay dos equipos PC anfitriones con cuatro núcleos que corren <tt>distcc</tt> y el equipo PC local tiene una CPU con doble núcleo entonces la variable  podría ser:

Cuando edite el fichero, asegúrese de que no se ha definido <tt>-march=native</tt> en las variables  o. <tt>distcc</tt> no distribuirá trabajos a otras máquinas si  está definido a. El valor adecuado para <tt>-march=</tt> se puede obtener lanzando la siguiente orden:

Lea <tt>-march=native</tt> en línea para distcc para ampliar la información.

Usar distcc con automake
Esto es más fácil de configurar en algunos casos que con Portage. Todo lo que se necesita hacer es actualizar la variable de entorno   para incluir  delante del directorio que contiene <tt>gcc</tt>. No obstante, hay un problema. Si se utiliza <tt>ccache</tt>, entonces deberá poner la localización de distcc después de la de ccache:

Coloque esto en el archivo del usuario  o fichero equivalente para tener configurada la variable   cada vez que que el usuario entre en el sistema o defínala globlamente en un fichero en

Instead of calling <tt>make</tt> alone, add in  (where   is an integer). The value of  depends on the network and the types of computers that are used to compile. A heuristic approach to the right value is given earlier in this article.

Utilizar distcc para realizar el bootstrap
El uso de <tt>distcc</tt> para el inicio (esto es, construir una cadena de herramientas antes de instalar el resto del sistema) requiere realizar algunas acciones adicionales.

Paso 1: Configurar Portage
Inicie la nueva máquina con un LiveCD de Gentoo Linux y siga las instrucciones de instalación mientras se siguen las instrucciones en las FAQ de Gentoo para obtener más información sobre el bootstrap. A continuación configure Portage para que utilice <tt>distcc</tt>:

Actualice también la variable  en la sesión de instalación:

Paso 2: Obtener distcc
Instale :

Paso 3: Configurar distcc
Run <tt>distcc-config --install</tt> to setup distcc; substitute the  in the example with the IP addresses or hostnames of the participating nodes.

Distcc is now set up to bootstrap! Continue with the proper installation instructions and do not forget to run <tt>emerge distcc</tt> after running <tt>emerge @system</tt>. This is to make sure that all of the necessary dependencies are installed.

Extras de distcc
La aplicación <tt>distcc</tt> tiene características adicionales y aplicaciones para dar soporte al trabajo en un entorno <tt>distcc</tt>.

Monitores de distcc
Distcc se distribuye con dos herramientas de monitorización. La basada en texto se construye siempre y se llama <tt>distccmon-text</tt>. Al lanzarlo la primera puede resultar confuso, pero es muy fácil de utilizar. Si el programa se lanza sin parámetros, correrá solo una vez. Sin embargo si se le pasa un número, actualizará la información cada  segundos, donde   es el argumento indicado.

La otra utilidad de monitorización solo se habilita cuando se habilita el ajuste. Esta herramienta está basada en GTK+, corre en un entorno X y es bastante encantador. En Gentoo, se ha cambiado el nombre a <tt>distccmon-gui</tt> para evitar confusiones (originalmente se llamaba <tt>distccmon-gnome</tt>).

Para monitorizar el uso de <tt>distcc</tt> por parte de Portage:

Un truco consisten en definir  en variables de entorno:

Ahora actualice el entorno:

Para terminar, arranque la aplicación GUI:

Usar SSH para la comunicación de distcc
Setting up distcc via SSH includes some pitfalls. First, generate an SSH key pair without password setup. Be aware that portage compiles programs as the Portage user (or as root if  is not set). The home folder of the Portage user is, which means the keys need to be stored in

A continuación cree una sección para cada máquina en el fichero de configuración de SSH:

Envíe la clave pública a cada nodo de compilación:

También asegúrese de que todas las máquinas están listadas en el fichero :

Corrija los permisos del fichero como se muestra a continuación:

Para configurar los equipos <tt>test1</tt> y <tt>test2</tt>, lance:

Por favor, observe que el símbolo <tt>'@'</tt>, especifica las máquinas ssh para distcc.

Finally, tell <tt>distcc</tt> which SSH binary to use:

It is not necessary to run the initscript on the hosts when <tt>distcc</tt> communicates via SSH.

Solución a problemas
Si se produce cualquier problema mientras se utiliza <tt>distcc</tt>, entonces esta sección puede ser de ayuda.

ERROR: failed to open
A partir del 22 de enero de 2015 la instalación no crea el fichero apropiado en. Esto afecta aparentemente solo a la versión 3.1-r8 de distcc. Esta incidencia está en proceso de solución (ver ). Es posible evitar este problema creando manualmente el fichero de registro, asignarle el propietario adecuado y reiniciando el demonio distccd:

A continuación actualice la ruta del fichero de configuración de <tt>distccd</tt> en  para definirla al directorio de  creado en el paso anterior:

Para terminar, reinicie el servicio distccd:

Some packages do not use distcc
A medida que se instalan algunos paquetes, los usuarios observarán que la construcción de algunos de ellos no se está realizando (y por tanto no se están construyendo en paralelo). Esto puede ocurrir porque el fichero del paquete no soporta operaciones en paralelo o el mantenedor del ebuild ha deshabilitado explícitamente dichas operaciones en paralelo debido un problema conocido.

En algunas ocasiones, <tt>distcc</tt> puede causar que un paquete falle en su compilación. Si sucede esto, por favor informe de ello.

Versiones mezcladas de GCC
Si el entorno aloja versiones diferentes de GCC, probablemente tenga problemas extraños. La solución es asegurarse de que todas las máquinas tengan la misma versión.

Recent Portage updates have made Portage use  (minus gcc) instead of. This means that if i686 machines are mixed with other types (i386, i586) then the builds will run into troubles. A workaround for this may be to run:

It is also possible to set the  and   variables in  to the values list in the command above.

-march=native
A partir de la versión 4.3.0 de GCC, el compilador ofrece soporta para la opción <tt>-march=native</t> que habilita la detección automática de la CPU y de las optimizaciones que merece la pena activar en el procesador sobre el que está corriendo GCC. Esto es un problema cuando se utiliza <tt>distcc</tt>, ya que permite mezclar código optimizado para diferentes procesadores. Por ejemplo, al correr <tt>distcc</tt> con <tt>-march=native</tt> en un sistema que tiene un procesador AMD Athlon y haciendo lo mismo en otro sistema que tiene un procesador Intel Pentium processor se mezclará el código compilado en ambos procesadores.

Preste atención a la siguiente advertencia:

Para conocer los ajustes que GCC habilitaría cuando se llama con <tt>-march=native</tt>, lance lo siguiente:

Ver también

 * La guía de compilación cruzada de DistCC explica cómo se utiliza una arquitectura para construir programas para otra arquitectura mediante <tt>distcc</tt>. Esto puede ser tan simple como utilizar una máquina Athlon (i686) para construir un programa para una K6-2 (i586) o utilizar una máquinaSPARC para construir un programa para una basada en PowerPC.

Recursos externos

 * Uso de <tt>-march=native</tt> en línea para distcc
 * Página oficial de Distcc