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.

Configuración
Before configuring distcc, let's first look into the installation of the package on all hosts.

Dependencias
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 distcc
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-starting the distcc daemon
In order to have distccd started automatically, follow the next set of instructions, depending on the init system used.

Using OpenRC
Modifique y asegúrese de usar la directiva   para permitir únicamente máquinas de confianza. Para mayor seguridad debería utilizar también la directiva  para indicarle al demonio distcc 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 en las notas sobre seguridad de distcc.

The following example allows the distcc clients running at 192.168.0.4</tt> and 192.168.0.5</tt> to connect to the distccd</tt> server running locally:

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

Using systemd
Edit and add the allowed clients in CIDR format. Here is an example:

Reload the unit files after making such changes:

Enable auto-starting distcc</tt> and then start the service:

Configuration
Let's now look into the configuration of distcc</tt>.

Especificar las máquinas participantes
Utilice la orden distcc-config 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:

Configurar Portage para utilizar distcc
Configurar Portage para usar distcc</tt> es fácil. Siga estos sencillos pasos en cada sistema que vaya a participar en la compilación distribuida.

A continuación, ajuste la variable  y la variable   tal y como se describe abajo. Una estrategia común es definir  como el doble del número total de CPUs disponibles (locales y remotas) más uno y definir   como el número de CPUs locales. En el caso en el que las máquinas participantes no estén disponibles o cuando el ebuild a instalar requiera un compilación exclusivamente local (por ejemplo gcc), entonces el ajuste  evitará que se lancen demasiadas tareas.

A common strategy is to
 * set the value of  to twice the number of total (local + remote) CPU cores + 1, and
 * set the value of  to the number of local CPU cores

The use of  in the   variable will prevent spawning too many tasks when some of the distcc</tt> cluster hosts are unavailable (increasing the amount of simultaneous jobs on the other systems) or when an ebuild is configured to disallow remote builds (such as with gcc). This is accomplished by refusing to start additional jobs when the system load is at or above the value of M</tt>.

Por ejemplo, cuando hay dos equipos PC anfitriones con cuatro núcleos que corren 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  en las variables   o. distcc</tt> no distribuirá trabajos a otras máquinas si  está definido a. El valor adecuado para  se puede obtener lanzando la siguiente orden:

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

Configurar distcc para trabajar 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 gcc</tt>. No obstante, hay un problema. Si se utiliza 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

En lugar de llamar únicamente a make, agregue -jN (donde  es un número entero). El valor de  depende de la red y de la tipología de los computadores que se utilizan para compilar. Una aproximación heurística a los valores correctos se ha dado anteriormente en este artículo.

Utilizar distcc para realizar el bootstrap
Using distcc</tt> to bootstrap (i.e. build a working toolchain before installing the remainder of the system) requires some additional steps to take.

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
Lance distcc-config --install para configurar distcc. Sustituya la cadena  del ejemplo por las direcciones IP o nombres de la máquinas que participan como nodos DistCC.

¡Distcc ya está configurado para hacer bootstrap! Continúe con las instrucciones de instalación adecuadas y no olvide lanzar kbd>emerge distcc después de lanzar emerge @system. Esto asegurará que las dependencias necesarias también se instalarán.

Extras de distcc
The <tt>distcc</tt> application has additional features and applications to support working in a <tt>distcc</tt> environment.

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:

A trick is to set  in environment variables:

Now update the environment:

Finally, start the GUI application:

Configurar distcc para trabajar con ssh
La configuración de distcc a través de ssh incluye algunos detalles. En primer lugar, genere un par de claves SSH sin contraseña. Observe que portage compila los programas con el usuario <tt>portage</tt>. La carpeta de inicio del usuario <tt>portage</tt> es lo que implica que las claves se deben almacenar en.

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

Send the public key to each compilation node:

También asegúrese de que todas las máquinas están listadas en el fichero y añada la clave pública al fichero  de todas las máquinas. Para configurar las máquinas <tt>test1</tt> y <tt>test2</tt> lance:

Fix the file permissions as follows:

To set up the hosts <tt>test1</tt> and <tt>test2</tt>, run:

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

Solución a problemas
If a problem occurs while using <tt>distcc</tt>, then this section might help in resolving the problem.

ERROR: failed to open
As of January 22nd, 2015 emerging fails to create the proper file in. This apparently only effects version 3.1-r8 of distcc. This bug is in the process of being corrected (see ). It is possible to work around this by manually creating the log file, giving it proper ownership, and restarting the distccd daemon:

Next update the path of the <tt>distccd</tt> configuration file in  to the  directory created in the step before:

Finally, restart the distccd service:

Algunos paquetes no utilizan 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.

Las actualizaciones de Portage más recientes utilizan  (menos gcc) en lugar de. Esto significa que si se mezclan máquinas i686 con otros tipos de máquina (i386, i586) entonces las construcciones darán problemas. Una solución temporal a esto es lanzar export CC='gcc' CXX='c++' en un terminal de root o ponerlo en.

-march=native
A partir de la versión 4.3.0 de GCC, el compilador ofrece soporta para la opción  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  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, lance lo siguiente:

Compilación cruzada
La compilación cruzada consiste en construir programa para otra arquitectura. Esto puede ser tan simple como usar un Athlon (i686) para construir un programa para un K6-2 (i586) o usar un SPARC para construir un programa para un PowerPC. Esto se documenta en la guía de compilación cruzada.

Recursos externos

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