Distcc/ko

distcc 는 네트워크를 통해 호스트가 참여하여 분산 컴파일 작업을 수행하도록 설계한 프로그램입니다. distccd 서버와 distcc 클라이언트로 구성되어 있습니다. distcc는 ccache, 포티지en, 약간의 설정 과정을 거치는 automake로 눈에 띄지 않도록 처리할 수 있습니다.

젠투 설치 초기에 도움을 받으려 distcc를 사용한다면, 부트스트랩 과정에 distcc 사용 섹션을 읽어보십시오.

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

Requirements across all hosts
distcc를 사용하려면 네트워크상의 모든 컴퓨터에 같은 gcc 버전이 있어야 합니다. 예를 들어 3.3.x(x는 바뀔 수 있음)는 괜찮지만 3.3.x와 3.2.x를 같이 사용하면, 컴파일 오류 또는 실행시간 오류가 나타날지도 모릅니다.

Installing the software
distcc에는 컴파일 작업을 보내는 컴퓨터의 작업을 지켜볼 때 사용하는 그래픽 감시 프로그램이 있습니다. 이 감시 프로그램은    플래그를 설정했을 때 쓸 수 있습니다.

설정 후, 꾸러미를 설정하십시오:

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
Edit and make sure to set the --allow directive to allow only trusted clients. For added security, use the --listen</tt> directive to tell the distccd</tt> daemon what IP to listen on (for multi-homed systems). More information on distcc</tt> security can be found at Distcc security notes.

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:

이제 distccd</tt> 데몬을 모든 참여 머신에서 시작하십시오:

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>.

참여 호스트 지정
호스트의 목록을 설정하려면 distcc-config 명령을 사용하십시오.

다음 예제는 호스트 정의 목록의 예제입니다. 대부분 첫번째 두번째 값을 약간 바꾸는걸로 충분합니다. 세번째 네번째 줄에서 사용하는 문법 내용은 distcc 설명서 페이지<sup style="color:#ff0077">en 에서 찾아볼 수 있습니다.

호스트를 설정하는데 다른 여러가지 방법도 있습니다. 자세한 내용은 distcc</tt> 맨 페이지( man distcc )를 보십시오.

만약 로컬 머신에서도 컴파일해야한다면 호스트 목록에 를 추가해야 합니다. 반대로 로컬 머신을 컴파일할 때 활용하지 않으면 호스트 목록에서 생략해야 합니다. 느린 장치에서 로컬호스트를 사용하는 것은 실제로 컴파일을 느리게 만듭니다. 성능을 위해 설정을 시험하여 확인하십시오.

앞의 예제의 첫 줄에 언급한 호스트를 사용하도록 distcc</tt>를 설정해보겠습니다:

Using distcc with Portage
Setting up Portage to use distcc</tt> is easy. It is a matter of enabling the distcc</tt> feature, and setting a decent value for the number of simultaneous build jobs (as distcc</tt> increases the amount of build resources).

Set the  variable and   variable as shown below.

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>.

예컨대, distccd</tt>를 실행 중인 두 대의 쿼드코어 호스트 PC에 듀얼 코어 CPU를 붙인 로컬 PC를 연결했다면, 변수값을 다음과 같이 설정할 수 있습니다:

While editing the file, make sure that it does not have <tt>-march=native</tt> in the   or   variables. <tt>distccd</tt> will not distribute work to other machines if  is set to. The appropriate <tt>-march=</tt> value can be obtained by running the following command:

See Inlining <tt>-march=native</tt> for distcc for more information.

Using distcc with automake
어쩌면 이 방법은 포티지 설정보다 쉽습니다. 여러분이 해야 할 일은 여러분의  변수에 <tt>gcc</tt>가 있는 디렉터리앞에 을 넣어 업데이트 하는 것입니다. 하지만 여기서 주의할 점이 있습니다. 만약 여러분이 <tt>ccache</tt>를 사용한다면 여러분들은 ccache 다음에 distcc의 위치를 놓아야 합니다:

사용자의 파일 또는 사용자 로그인시 매번 를 설정할 비슷한 파일에 이 값을 추가하거나,  파일에 전역 값으로 설정하십시오.

make 라고 입력하는 대신, -jN ( 은 정수형 숫자)을 추가하십시오. 값은 여러분의 네트워크와 여러분이 컴파일에 사용하는 컴퓨터의 형식에 달려있습니다. 이 글 초반부에 제대로된 값을 직접 찾아보는 방법을 언급했습니다.

부트스트랩 과정에 distcc 사용
Using <tt>distcc</tt> to bootstrap (i.e. build a working toolchain before installing the remainder of the system) requires some additional steps to take.

1단계: 포티지 설정
Boot the new box with a Gentoo Linux LiveCD and follow the installation instructions, while keeping track of the instructions in the Gentoo FAQ for information about bootstrapping. Then configure Portage to use <tt>distcc</tt>:

마찬가지로 설치 세션에서  변수를 업데이트하십시오:

2단계: distcc 가져오기
를 설치하십시오:

3단계: distcc 설정
distcc를 설정하려면 distcc-config --install 을 실행하십시오. 예제의  부분을 참여하는 distcc 노드의 IP 주소 또는 호스트 이름으로 바꾸십시오.

이제 distcc 부트스트랩을 설정했습니다! 적당한 설치 절차를 따르시고, emerge @system 을 실행한 후에 distcc를 다시 이머지하는 것을 잊지 마십시오. 이 절차는 필요한 모든 의존성을 설치했는지 확인하는 과정입니다.

추가 distcc 요소
The <tt>distcc</tt> application has additional features and applications to support working in a <tt>distcc</tt> environment.

distcc 감시 프로그램
distcc에는 두 가지 감시 프로그램이 들어있습니다. 항상 빌드하는 텍스트 기반 프로그램을 <tt>distccmon-text</tt>라고 합니다. 처음 실행하는게 약간 혼동스러울 수도 있지만, 사용 방법은 아주 쉽습니다. 프로그램을 아무런 매개 변수없이 실행하면 단 한번만 실행합니다. 하지만, 숫자를 전달하면 매 초마다 업데이트 합니다. 여기에서 은 여러분이 전달한 숫자 인자입니다.

다른 감시 유틸리티는 를   플래그로 설정했을 때만 실행할 수 있습니다. GTK+ 기반의 프로그램이며, X 환경에서 구동되고 정말 사랑스럽습니다 *-_-*. 젠투에서의 GUI 감시 프로그램은 혼동을 피하기 위해 <tt>distccmon-gui</tt>로 이름을 바꾸었습니다(보통 <tt>distccmon-gnome</tt>이라고 합니다).

포티지의 <tt>distcc<tt> 사용 상태를 감시하려면:

A trick is to set  in environment variables:

Now update the environment:

Finally, start the GUI application:

Using SSH for distcc communication
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

두번째로, SSH 설정 파일에 각 호스트에 대한 섹션을 만드십시오:

Send the public key to each compilation node:

Also make sure that each host is available in the file:

Fix the file permissions as follows:

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

<tt>@</tt> 기호는 distcc용 ssh 호스트를 지정할 때 사용하는 기호임을 참고하십시오.

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.

문제 해결
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:

일부 패키지가 distcc를 활용하지 않음
다양한 꾸러미를 emerge 할 때, 꾸러미 일부를 분산처리하지 않는다는 점(그리고 병렬로 빌드하지 않는다는 점)을 주의하셔야 합니다. 이것은 패키지의 이 병렬 처리를 지원하지 않거나 ebuild의 관리자가 알려진 문제점때문에 확실하게 병렬 처리를 사용하지 않도록 했기 때문입니다.

때론 <tt>distcc</tt>가 컴파일의 실패 요인이기도 합니다. 이런 일이 일어난다면, 저희에게 알려주십시오.

혼합 GCC 버전
각각의 환경에서 다른 GCC 버전을 사용하면, 이상한 문제가 생길 수 있습니다. 해결 방법은 모든 호스트의 GCC 버전을 같게 하는 것입니다.

최근 포티지에서는  대신  (마이너스 gcc)를 사용하도록 업데이트 했습니다. 이는 i686 머신을 다른 형식(i386, i586)의 머신과 혼용해서 사용한다면, 빌드한 결과에 문제가 생김을 의미합니다. 이에 대한 해결책은, 루트 권한으로 터미널에서 export CC='gcc' CXX='c++' 를 실행하거나 이 변수값을 에 넣는 것입니다.

-march=native
Starting with GCC 4.3.0, the compiler supports the <tt>-march=native</tt> option which turns on CPU auto-detection and optimizations that are worth being enabled on the processor on which GCC is running. This creates a problem when using <tt>distcc</tt> because it allows the mixing of code optimized for different processors. For example, running <tt>distcc</tt> with <tt>-march=native</tt> on a system that has an AMD Athlon processor and doing the same on another system that has an Intel Pentium processor will mix code compiled on both processors together.

다음 경고에 주의하십시오:

To know the flags that GCC would enable when called with <tt>-march=native</tt>, execute the following:

외부 자료

 * Inlining <tt>-march=native</tt> for distcc
 * Distcc homepage