Distcc/ja

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

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

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

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

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

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

distcc デーモンの自動起動
を自動的に起動するためには、次の方法に従ってください. ただし、ご使用のinitシステムによって、やり方が違います.

OpenRC をご使用中の場合
を編集して  ディレクティブに信頼できるクライアントがセットされいるかどうかを確認してください. 例えば multi-homded　システムを採用しているなどのように、さらにセキュリティを高めるには  ディレクティブで  デーモンにどのIPを受け付けるのかを知らせください. のセキュリティについてもっと詳しく知りたいならば、Distcc security notes を参照してください.

次の設定例では、 と で実行されている distcc クライアントは、ローカルで実行されている サーバへの接続が許されます:

それでは、分散コンパイルに参加する全てのコンピュータで デーモンを起動しましょう:

systemd をご使用中の場合
を編集して、CIDRフォーマットにて許可するクライアントを追加してください. 例をあげますと:

このような変更した後は、ユニット・ファイルをリロードしましょう.

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

設定
それでは、の設定をしていきましょう.

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

ホストのリストの書き方の一例を下に記します. ほとんどのケースでは、１行目と２行目の書き方で十分でしょう. ２行目の書き方のように シンタックスを使えば、にこのノードで最大いくつのジョブを起動できるかを知らせることができます. distcc マニュアルページ では、3行目や4行目のような書き方の詳しい説明が載っています.

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

ローカルマシンでもコンパイル作業をさせたいのなら、ホストのリストに  と記入しましょう. 逆に、ローカルマシンにコンパイル作業をさせたくない場合には、リストから外しましょう. 遅いマシンでlocalhostを設定してると、実際すべてのことが遅くなってしまうでしょう. また、設定したものをテストするのも忘れないでください.

例の中の最初の一行目で書かれたホストを使用して、 の環境を設定してみましょう.

Portageでdistccを使用する
Portage が を利用できるように設定するのは簡単です. feature を有効にして、同時にビルドに参加するジョブ数を設定する変数があるのですがこれに適当な数をいれてやるだけです (この数に従って はビルドするリソースの量を増やします).

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

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

MAKEOPTS 変数で を使用すると過剰なタスクが起動されてしまうのを防ぐことができます. 例えば、クラスタホストのいくつかが利用できなくなった時(他のシステムでの並列ジョブの量が増加した場合)や、ebuild でリモートビルドを禁止している時(gccなど)です. この仕組みは、システム負荷が 値以上になった時に、それ以上のジョブの追加を拒否することによって行われます.

例えば、４コアＰＣのホスト２台と２コアＰＣのローカルがあったと仮定しましょう. すると MAKEOPTS 変数は次のようになります.

ファイルを編集するとき、 CFLAGS や CXXFLAGS で を設定してはいけません. これはよく確認してください. が に設定されていると、は作業を他のマシンにうまく分散しなくなるでしょう. そのかわり、次のコマンドを実行すれば適切な の値がわかります.

詳しくは、 Inlining  for distcc をご覧ください.

automake で distcc を使用する
これは、場合によもりますが、Portageのセットアップよりも簡単です. PATH 変数の のあるディレクトリよりも先頭にを書き込むだけでよいのです. ただし、ちょっと注意が必要です. もし をご使用の場合は、の後にを配置してください:

これをユーザの 等のようなファイルに書き込んでおき、ユーザがログインするたびに設定されるようにしておきましょう. もしくは、 ファイルに書き込んでグローバルに設定するのもよいかもしれません.

何もつけずにを呼び出すより、 ( は整数)をつけましょう. は、コンパイルに使用するコンピュータのネットワークとタイプによって違います. このアーティクルの最初のところで適切な値の見つけ方をすでに書いておきましたのでご参考ください.

ブートストラップにdistccを使う
をブートストラップに使う（たとえば、システムの残りをインストールする前にワーキングツールチェーンをビルドする）には、いくつか手間をかける必要があります.

Step 1: Portage の設定
Gentoo Linux LiveCDで新しくマシンを立ち上げてinstallation instructionsに従ってください. さらに、ブートストラップについての情報もGentoo FAQにありますので参考にしましょう. その次にを使用してPortageを初期設定してください.

インストレーションセッションで 変数を次のように更新:

Step 2: distcc をゲット
をインストール:

Step 3: distcc のセッティング
を実行してdistccをセットアップしましょう. 例中の には実際のIPアドレスやホスト名を入れてください.

これでdistccはブートストラップ用に新しく設定されました. 以降はインストレーションの手順に従ってください. の後にを実行するのをお忘れなく. これは、すべての必要な依存関係のあるパッケージがインストールされているのかを確認するために行います.

Distcc に付属するツール群
アプリケーションには、環境での作業をサポートするための機能やアプリケーションがあります.

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

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

Portageでのの使用をモニタするには:

DISTCC_DIR を環境変数にセットするための良い方法：

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

最後に、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 ownership as follows:

To set up the hosts  and , run:

Please note the  (@ sign), which specifies ssh hosts for distcc.

Finally, tell which SSH binary to use:

It is not necessary to run the initscript on the hosts when  communicates via SSH.

トラブルシューティング
をご使用中に問題が発生したときには、このセクションをお読みになれば問題解決の糸口となるかもしれません.

ERROR: failed to open
2015年1月22日以降、emergeすると に適切な  ファイルを作るのに失敗します. これは、 distcc ver.3.1-r8 のみに起こることが明らかにされています. このバグは現在修正中ですが(参照:)、手作業でそのログファイルを作成し、適切な所有者を設定し、distccデーモンを再起動することで何とかうまく動くようにできます.

次に、にあるコンフィグレーションファイルのの値を先ほど作成したディレクトリに更新してください：

最後に distccd サービスを再起動します.

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 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 CC and CXX variables in to the values list in the command above.

-march=native
Starting with GCC 4.3.0, the compiler supports the  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 because it allows the mixing of code optimized for different processors. For example, running with   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:

を指定したとき、GCCがどのようなフラグを有効にしているのかを知りたいときには、次のコマンドを実行してください:

参考

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