Distcc/ko

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

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

젠투 설치 초기에 도움을 받기 위해 distcc를 사용하려 한다면, 설치 초기에 distcc 사용하기 섹션을 읽어보십시오.

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

Distcc 설치하기
distcc 설치를 시작하기 전에 알아두어야 할 몇가지 옵션이 있습니다.

Distcc ships with a graphical monitor to monitor tasks that a computer is sending away for compilation, enabled with the    flag.

Distcc를 사용하도록 포티지 설정하기
distcc를 사용하도록 portage를 설정하는 것은 쉽습니다. 각 시스템이 분산 컴파일 작업에 참여하도록 하려면 다음 단계를 실행하십시오:

이제  변수와   변수를 아래처럼 설정하십시오. 일반적인 전략은 CPU 전체(로컬+원격) 갯수 + 1 을 N의 값으로 설정하고 로컬 CPU의 갯수를 M으로 설정하는 것입니다. distcc 호스트를 사용할 수 없거나, ebuild에서 로컬 전용 컴파일(gcc)을 필요로 한다면,  플래그를 적용하여 과도한 작업을 분담하지 않도록 막으십시오.

참여 호스트 지정
호스트의 목록을 설정하려면  명령을 사용하십시오. 설정값이 될 몇가지 호스트 예제가 있습니다.

호스트 정의 예제

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

만약 여러분들이 지역 장치에서 컴파일 하기를 원한다면 여러분들은 'localhost'를 호스트 목록에 추가해야 합니다. 반대로 지역 장치가 컴파일을 하기를 원치 않으신다면(대부분의 경우) 호스트 목록에서 생략해야 합니다. 느린 장치에서 로컬호스트를 사용하는 것은 실제로 컴파일을 느리게 만듭니다. 성능을 위해 설정을 시험하여 확인하십시오.

모든 것이 복잡한 것 같지만, 대부분 첫번째 줄 또는 두번째 줄로도 충분히 작동합니다.

대부분 3번째 혹은 4번째의 줄을 쓰지 않으므로, distcc 실행을 SSH 연결을 통할 수 있게 하는 설정내용이 들어간 distcc 설명서를 참조하겠습니다.

예를 들어 앞의 예제에서 첫 줄을 설정한다면:

여러분의 필요에 따라 를 편집하십시오. 그리고 여러분이 신뢰하는 호스트들만 허용하도록  지시자를 설정하였는지 확인하십시오. 보안성을 더하기 위해, 여러분은 distcc 데몬이 (여러 군데에 위치한 시스템들에 대해) 어떤 IP로 수신받고 있는지 알려줄  지시자를 사용할 수 있습니다. distcc 보안에 대한 더 많은 정보는 Distcc 보안 설계에서 찾을 수 있습니다.

이제 distcc 데몬을 모든 참여 머신에서 시작하십시오:

automake가 동작하도록 Distcc 설정
이 경우 포티지 설정보다 쉽습니다. 여러분이 해야 할 일은 여러분의  변수에 gcc를 포함하는 디렉터리앞에  을 포함하도록 업데이트 하는 것입니다. 하지만 여기서 주의할 점이 있습니다. 만약 여러분이 ccache를 사용한다면 여러분들은 ccache 다음에 distcc를 놓아야 합니다:

로그인 할 때마다 PATH를 설정하기 위해 ~/.bashrc같은 파일에 추가할 수 있습니다.

그런 다음, 여러분이 보통 라고 입력하는 바와 같이,  (N은 정수형 숫자)을 입력합니다. N의 값은 여러분의 네트워크와 여러분이 컴파일에 사용하는 컴퓨터의 형식에 달려있습니다. 최고의 성능을 부여할 숫자를 찾기 위해 여러분의 설정을 시험해보십시오.

Setting up Distcc to Work With ssh
Setting up distcc via ssh includes some pitfalls you should be aware of. First, generate a ssh key pair without password setup. Be aware that portage compiles programs as user portage. The home folder of the user portage is, which means the keys need to be stored in.

Second, generate a section for each host in the ssh config file:

Also make sure that each host is available in the file and append your public key to the  file of the hosts. To set up the hosts test1 and test2 run

Please not the '@'-sign, which specifies ssh hosts for.

Cross-Compiling
Cross-compiling is using one architecture to build programs for another architecture. This can be as simple as using an Athlon (i686) to build a program for a K6-2 (i586), or using a Sparc to build a program for a ppc. This is documented in our DistCC Cross-compiling Guide.

Step 1: Configure Portage
Boot your new box with a Gentoo Linux LiveCD and follow the installation instructions up until the bootstrapping part. (See the Gentoo FAQ for more information about bootstrapping.) Then configure Portage to use distcc:

Step 2: Getting Distcc
Install distcc:

Step 3: Setting Up Distcc
Run  to setup distcc; substitute   with the IP addresses or hostnames of the participating DistCC nodes.

Distcc is now set up to bootstrap! Continue with the official installation instructions and do not forget to re-emerge distcc after. This is to make sure that all of the dependencies you want are installed as well.

Some Packages Don't Use Distcc
As you emerge various packages, you'll notice that some of them aren't being distributed (and aren't being built in parallel). This may happen because the package's Makefile doesn't support parallel operations or the maintainer of the ebuild has explicitly disabled parallel operations due to a known problem.

Sometimes distcc might cause a package to fail to compile. If this happens for you, please report it to us.

Mixed GCC Versions
If you have different GCC versions on your hosts, there will likely be very weird problems. The solution is to make certain all hosts have the same GCC version.

Recent Portage updates have made Portage use  instead of. This means that if you're mixing i686 machines with other types (i386, i586) you will run into problems. A workaround for this may be to  or to put it in.

-march=native
Starting with GCC 4.3.0, the compiler supports the  switch which turns on CPU autodetection and optimizations that are worth being enabled on the processor the GCC is running at. This is a problem with  as it allows mixing of code optimized for different processors (like AMD Athlon and Intel Pentium). Don't use  or   in your   or   when compiling with.

To know the flags that GCC would enable when called with, execute the following:

Distcc Monitors
Distcc ships with two monitors. The text-based one is always built and is called. Running it for the first time can be a bit confusing, but it is really quite easy to use. If you run the program with no parameter it will run once. However, if you pass it a number it will update every N seconds, where N is the argument you passed.

The other monitor is only enabled through the    flag. This one is GTK+ based, runs in an X environment and it is quite lovely. For Gentoo, the GUI monitor has been called  for less confusion. Elsewhere it may be referred to as.

or run :

To monitor Portage's distcc usage you can use:

감사문
이 안내서에 제공한 노고에 대해 다음 작성자와 편집자분들께 감사의 말을 전하고자 합니다:


 * Lisa Seelye
 * Mike Frysinger
 * Erwin
 * Sven Vermeulen
 * Lars Weiler
 * Tiemo Kieft
 * nightmorph