Distcc/ja

Distccはネットワーク上のホストで分散コンパイルを行うためのプログラムで、サーバー側であるdistccdとクライアント側であるdistccで構成されています. またccache、Portage、Automakeとの連携機能も備えています.

Gentooのインストールにdistccを使いたい場合は、Using distcc to bootstrapを参照してください.

インストール
distccを構築するには、まずは使用するすべてのホストに パッケージのが導入されているかどうか見てみましょう.

全てのホストで必要なこと
distccに使う全てのホストに同じバージョンのGCCを用意するようにしてください. 例として、3.3.x (xは任意の数字) を混在させるのは問題ありませんが、3.3.xと3.2.xを混在させた場合コンパイルエラーや実行時エラーが起きるかもしれません.

ソフトウェアのインストール
Distccには分散コンパイルしているタスクを監視するグラフィカルモニタが付属しています. これを使うには USEフラグをセットします.

USEフラグの設定が終わったらパッケージをインストールします.

distcc デーモンの自動起動
distccdが自動で開始されるようにするためには、次の説明文の中で、使用しているinitシステムに適合したものに従ってください.

OpenRC をご使用中の場合
Edit and make sure to set the --allow directive to allow only trusted clients. For added security, use the --listen 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.

次の例では、192.168.0.4</tt>と192.168.0.5</tt>で実行されているdistccクライアントが、ローカルで実行されているdistccd</tt>サーバに接続を許可されます:

それでは、参加しているすべてのコンピュータでdistccd</tt>デーモンの実行を開始しましょう:

systemd をご使用中の場合
Edit and add the allowed clients in CIDR format. Here is an example:

Reload the unit files after making such changes:

distccd</tt>の自動起動を有効にして、サービスを開始します:

設定
それでは、distcc</tt>の設定をしていきましょう.

参加するホストを記述する
distcc-config</tt>コマンドを使用すれば、ホストのリストを設定することができます.

ホストのリストの書き方の一例を下に記します. ほとんどのケースでは、一行目と2行目の書き方で十分でしょう. distcc マニュアルページ では、3行目や4行目のような書き方の詳しい説明が載っています.

ホストをセッティングする方法にはここで挙げたほかにもいくつかやり方ありますので、詳細については、distcc</tt> man ページをご覧ください.

If compilations should also occur on the local machine, put  in the hosts list. Conversely if the local machine is not to be used to compile, omit it from the hosts list. On a slow machine using localhost may actually slow things down. Make sure to test the settings for performance.

Let's configure distcc</tt> to use the hosts mentioned on the first line in the example:

Portageでdistccを使用する
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).

下に示したように、 変数と 変数を設定してください.

一般的な戦略としては、
 * の値を「トータルの」(ローカルとリモートの)CPUコアの個数の2倍 + 1に設定し、
 * の値を「ローカルの」CPUコアの個数に設定します.

変数での の使用は、 一部のdistcc</tt>クラスタホストが使用できない時(他のシステムでの並列ジョブが増加され)、あるいは、(gccなど)ebuildがリモートビルドを許可しない設定になっている時に、あまりにも多くのタスクを開始してしまうことを防ぎます. これは、システムの負荷がM</tt>の値以上である時に追加のジョブを開始しないことによって成立します.

For instance, when there are two quad-core host PCs running <tt>distccd</tt> and the local PC has a dual core CPU, then the  variable could look like this:

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.

automake で distcc を使用する
This is, in some cases, easier than the Portage setup. All that is needed is to update the  variable to include  in front of the directory that contains <tt>gcc</tt>. However, there is a caveat. If <tt>ccache</tt> is used, then put the distcc location after the ccache one:

Put this in the user's or equivalent file to have the   set every time the user logs in, or set it globally through an  file.

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.

ブートストラップに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.

Step 1: Portage の設定
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>:

Update the  variable in the installation session as well:

Step 2: distcc をゲット
Install :

Step 3: 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.

Distcc に付属するツール群
The <tt>distcc</tt> application has additional features and applications to support working in a <tt>distcc</tt> environment.

Distcc の監視
Distccには2つの監視ユーティリティが付属しています. テキストベースの監視ユーティリティは必ずビルドされ、<tt>distccmon-text</tt>という名前です. 最初に実行するときは少々混乱するかもしれませんが、実際とても簡単に使うことができます. パラメータなしで実行したときは、プログラムは1回だけ実行されますが、引数に数字を与えると、与えた引数が<tt>N</tt>ならば、<tt>N</tt>秒ごとに更新が行われます.

もうひとつの監視ユーティリティは フラグがセットされた時のみ有効になります. これはGTK+ベースで、X環境で動作し、ナイスな外見をしています. Gentooでは、このGUIモニタは混乱を避けるため<tt>distccmon-gui</tt>にリネームされています(もともとの名前は<tt>distccmon-gnome</tt>です).

Portageでの<tt>distcc</tt>の使用をモニタするには:

A trick is to set  in environment variables:

ここで、環境を更新します:

ようやく、GUIアプリケーションを開始することができます:

distccの通信に SSH を使いたい時
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

Second, create a section for each host in the SSH configuration file:

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:

Please note the <tt>@</tt> (@ sign), which specifies ssh hosts for 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.

トラブルシューティング
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をつかえないパッケージもあります
As various packages are installed, users will notice that some of them aren't being distributed (and aren't being built in parallel). This may happen because the package' doesn't support parallel operations, or the maintainer of the ebuild has explicitly disabled parallel operations due to a known problem.

Sometimes <tt>distcc</tt> might cause a package to fail to compile. If this happens, please report it.

GCC のバージョンが混在する場合
If the environment hosts different GCC versions, 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  (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
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.

Heed the following warning:

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

参考

 * The DistCC Cross-compiling guide explains how using one architecture to build programs for another architecture is done through <tt>distcc</tt>. 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 PowerPC.

外部の情報

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