このサイトは、もともと作者の自分用メモとして書き始めたものです。書いてあることが全て正しいとは限りません。他の文献、オフィシャルなサイトも確認して、自己責任にて利用してください。

Yum

Yum は RPM 版の apt のようなもので、その実体は python で書かれたスクリプト群。 YellowDog Updater Modified の略だそうだが、「もぐもぐ美味ちぃ」の` yum yum' に無理矢理こじつけたとしか思えない名前が傑作だ。

Yum をインストールしたら、パッケージの検索先 (レポジトリと呼ぶ) を設定してやらなければならない。設定は、yum 2.0.x の場合は /etc/yum.conf で行う。それに対して yum 2.2 以降の場合、通常は yum.conf にはグローバルな設定 ( [main] 部分) だけ書き、各レポジトリ定義は /etc/yum.repos.d/ 下にあるファイル fedora.repo, fedora-updates.repo などに記述する。 extras レポジトリや updates-testing レポジトリのパッケージなども引いてこれるようにしたい場合は、上記レポディレクトリに例えば fedora-extras.repo などというファイルを新設して各々の定義を記述すればよい。

日本国内で、同期のタイムラグが少なく信頼できるミラーサイトは 2 箇所：

• http://ring.riken.jp/
• http://ftp.kddilabs.jp/

※ Fedora Core 4 までと RedHat (Enterpriseでない) Linux にアップデートパッケージを提供してきた Fedora Legacy Project は 2007年 1月、閉鎖となった。それら古いバージョンのディストリビューションを使っている人は早急に Fedora Core 5 以降へアップグレードした方がいい。当サイトの Fedora Upgrade HOWTO がお役に立てるかもしれない。

※ RedHat Enterprise Linux では永いこと up2date という使いにくいアップデーターが使われてきたが、 5 からはやっと Yum が標準となった。動作時のメッセージを見ていると、認証の問題には特別なプラグインで対処しているようだ。

Table of Contents

• RHEL4へのインストール
• 設定ファイル
  • 設定例
    • yum 2.2 以降の場合
    • RHEL4でサードパーティのレポジトリを使用する
    • [参考] 既にLegacy入りしたリリースの場合
    • 設定ディレクティブの詳細
• キャッシュの整備
• yumの使い方
• yumレポジトリの作り方
  • ツール
  • yumレポジトリ(サーバ)の構築
  • クライアント側の設定

RHEL4へのインストール

Fedora Core や RHEL5 以降なら yum は標準でインストールされるが、Red Hat Enterprise Linux 4 では yum の純正パッケージが提供されていないので、あれこれとインストールする必要がある。RHEL4.5 (旧称 4 Update-5) で検証した結果をまとめておく。

必要なパッケージ

先にも述べたように Yum は python スクリプトを中核としている。 Yum 関連のパッケージバージョンは、インストールされている python と rpm-libs のバージョンを軸にして選択しなくてはいけない。RHEL4 の python は 2.3系である。

※ 過去の遺物だが、yum-2.0.x のビルド済みパッケージをここに置いておく。2.0.x なら上記の sqlite 以下はインストールしなくて済むが、はなはだ時代遅れでいろいろと不都合の方が多い。

先に yum 以外をインストールしてから、下記のようにして yum の RPMパッケージを作成し、それをインストールする。 rpmbuild について不明な人はこちらを参照。

hoge$ rpmbuild --rebuild yum-2.4.X-X.src.rpm

設定ファイル

設定例

yum 設定ファイルの、一般的に言ってお勧めの設定は以下。わざわざ HTTP でつないでいるのは、経験上 HTTP のほうが接続が確実なため。

yum 2.2 以降の場合

yum は 2.2 や 3 以降では、/etc/yum.conf にはグローバル設定のみを書く。そして各レポジトリ定義は /etc/yum.repos.d/ 下のファイルに分割して書く。CentOS 5.4 での例を示す。

yum.conf

[main]
cachedir=/var/cache/yum
keepcache=0
debuglevel=2
logfile=/var/log/yum.log
distroverpkg=fedora-release
tolerant=1
exactarch=1
retries=5
obsoletes=1
gpgcheck=1
plugins=1

CentOS-Base.repo

[base]
name=CentOS-$releasever - Base
failovermethod=roundrobin
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=os&cc=jp
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-5
enabled=1
 
[updates]
name=CentOS-$releasever - Updates
failovermethod=priority
baseurl=http://ftp.riken.jp/Linux/centos/$releasever/updates/$basearch/
        http://www.ftp.ne.jp/Linux/packages/CentOS/$releasever/updates/$basearch/
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-5
enabled=1
 
[addons]
name=CentOS-$releasever - Addons
failovermethod=roundrobin
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=addons&cc=jp
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-5
enabled=1
 
[extras]
name=CentOS-$releasever - Extras
failovermethod=roundrobin
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=extras&cc=jp
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-5
enabled=1
 
[centosplus]
name=CentOS-$releasever - Plus
failovermethod=roundrobin
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=centosplus&cc=jp
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-5
enabled=0

上記の CentOS-Base.repo では、説明のために、[base] と [updates] でレポジトリ参照先指定方法を変えてみた。通例使われるのは [base] で書いた mirrorlist による指定方法。mirrorlist 右辺に指定されている URL は一種の CGI らしく、release, arch などのリクエスト引数に応じてレポジトリサイトの URLリストを返してくるようにできている。赤字で示した CGI 引数 `cc=jp' を加えてやると、日本にあるレポジトリのリストが確実に返ってくるのでダウンロードがスムーズになる。ただし、yum 付属プラグイン `fastestmirror (yum-fastestmirror パッケージ) の旧バージョンでは、cc による国コード指定が無視される現象が見受けられた。最近の fastestmirror プラグインでは改善されたが、相変わらず cc=jp が効かない場合は、 /etc/yum/pluginconf.d/fastestmirror.conf 内の enable=1 を 0 にするといい。
一方、baseurl のリストを直接書くやり方は、ディストリビューション標準でない外部レポジトリや、独自に作成したローカルレポジトリを参照させる場合に向いている。

他にもうひとつ、CentOS 5 あたりからデフォルトで設定されているレポジトリ定義がある。ローカルの CDROM/DVD をレポジトリとして参照するためのものだ。これは、インターネット接続のできない環境で、RedHat Enterprise Linux (RHEL) などにインストールメディアそのものからパッケージを追加する時に、真似すると便利だ。

fedora-media.repo

[fedora-media]
name=Fedora Core $releasever - $basearch - Media
failovermethod=priority
baseurl=file:///mnt/cdrom/
gpgcheck=1
enabled=0

ただし、メディアレポジトリ定義には幾つか注意点がある。まず、enabled=0 にして、メディアが光学ドライブに挿入されていない時のエラーを避けること。ローカルレポを使いたい時には yum のコマンドラインオプションに明示的に --enablerepo=fedora-media を添えてコールするわけだ。もうひとつは、最近の Ferora Core, CentOS, RHEL 5以降のように、光学メディアが /media/ 下に動的なメディアラベル名でマウントされるディストリビューションの場合。挿入するメディアによって、例えば "/media/RHEL_5.2 i386 DVD" のようにディレクトリ名が変わるので、メディアレポ定義ではカバーしきれないのだ。その場合は、

root# mount --bind /media/RHEL_5.2\ i386\ DVD /mnt/cdrom

のように別名マウントしてから yum をコールする。また、そういうディストリビューションでは元々 /mnt/cdrom/ ディレクトリが存在しないので、あらかじめ作成しておく必要がある。なお、RHEL 5 のインストールメディアは、baseurl を file:///mnt/cdrom/Server/ と指定しなければならない造りになっている。

yum 設定ファイルができたら、汚染チェックのための GPG キーをインポートする (下記は Fedora Core 5の例)。インストールCD/DVD からインポートしてもいい：

root# rpm --import \
 http://ring.riken.jp/pub/linux/fedora/linux/core/5/i386/os/RPM-GPG-KEY-fedora

Extras も利用するなら専用の署名も必要。例えば下記の URL で取れる。例えば：

http://ftp.kddilabs.jp/Linux/packages/fedora/extras/RPM-GPG-KEY-Fedora-Extras

RHEL4 でサードパーティのレポジトリを使用する

信頼できる有名レポジトリとして DAG WIEERS と EPEL がある。 EPEL (Extra Packages for Enterprise Linux) は、Red Hat Enterprise Linux 4 以降にアドオンパッケージを提供しようという、Fedora Project が立ち上げたプロジェクトだ。これらふたつのレポジトリを使用するには下記のパッケージをダウンロードしてインストールするだけでいい。これらによって yum.repos.d/ 下に適切なレポジトリ定義ファイルがインストールされ、GPGキーもインポートされる。

[参考] 既にLegacy入りしたリリースの場合

Fedora Legacy Project は閉鎖となったため、この項目は過去の遺物。参考のため引き続き置いておく。ここでは yum 2.0.x を例とするので、 /etc/yum.conf で全ての設定を行う。

[main]
cachedir=/var/cache/yum
debuglevel=2
logfile=/var/log/yum.log
pkgpolicy=newest
distroverpkg=fedora-release
tolerant=1
exactarch=1
retries=5
 
[base]
name=Fedora Core $releasever base
failovermethod=priority
baseurl=http://ftp.kddilabs.jp/Linux/packages/fedora.legacy/fedora/$releasever/os/$basearch
gpgcheck=1
 
[updates]
name=Fedora Core $releasever updates
failovermethod=priority
baseurl=http://ftp.kddilabs.jp/Linux/packages/fedora.legacy/fedora/$releasever/updates/$basearch
gpgcheck=1
 
[legacy-utils]
name=Fedora Legacy utilities for Fedora Core $releasever
failovermethod=priority
baseurl=http://ftp.kddilabs.jp/Linux/packages/fedora.legacy/fedora/$releasever/legacy-utils/$basearch
gpgcheck=1

設定後、RPM の汚染チェックのための GPG キーを Fedora Legacy 本家からダウンロードし rpm にインポートする：

root# rpm --import http://www.fedoralegacy.org/FEDORA-LEGACY-GPG-KEY

設定ディレクティブの詳細

主なものだけ述べる。yum 2.0.x と 2.2 以降では若干仕様が異なるので、それについても触れておく。

キャッシュの整備

baseurl を書き換えただけなら必要ないが、レポジトリ定義を追加や削除した場合には yum のキャッシュをクリーンナップする：

root# yum clean all 

上記で「header.info が見つからない」というエラーが出るかも知れないが、気にする必要はない。次回レポジトリを照会させた時にそれらキャッシュデータは整備される。そのために、ここで一度、下記コマンドを発行しておこう：

root# yum list updates

yumの使い方

主なコマンド

PkgStr 部分のパッケージ文字列にはシェルスタイルのワイルドカードが使える。例えば mod_* は mod_perl-x.x.x-x.x や mod_python-x.x.x-x.x などにマッチする。それに対して perl と指定すると perl-suidperl や perl-debuginfo などはヒットせず、 perl-x.x.x-x.x だけがヒットする。他に、 1 文字を置き換える "?" も使える。ただし 2.0.x ではこうしたグロブ動作に曖昧さがあり少々注意が必要。

主なコマンドラインオプション

※1 check-update のリターンコードの受け取り方

例えばこんな要領でシェルスクリプトを書けば、不要なメッセージなしに状態に応じた処理ができる：

#!/bin/bash
yum -d 0 -e 0 check-update 1>/dev/null 2>&1
RETVAL=$?

if [ $RETVAL = 100 ]; then
    echo There should be one or more available updates
fi

if [ $RETVAL = 0 ]; then
    echo No Available Updates for now
fi

yumレポジトリの作り方

これをまとめたのは、インターネットから隔絶された閉鎖LAN内で、プリプロダクションの数台の RedHat Enterprise Linux 4 マシンと取り組んでいた時、パッケージのアップデートや追加/削除を行うのに苦心したからだ。困ったことに、アップデートパッケージディスクは (いつもの如く) CD-ROM 4枚に分割されており、今ほしいパッケージが何枚目の CD に入っているか探すだけでも手間がかかる。そこで考えたのが、マシンの 1台にローカルレポジトリを作成し、同マシン上の Apache で内輪に公開するという方策だ。こうすれば CD を出し入れする手間もないし、どのマシン (レポジトリマシン自身も含めて) も、 yum の短いコマンドだけでアップデートやパッケージの追加/削除、パッケージ情報の検索などが行える。まず知っておかなくてはならないのは、 yumレポジトリの構造が、 yum 2.0.x クライアントを使う場合と 2.2 以降とで大幅に異なるということだ。 yum-2.2 以降では、パッケージメタデータ (ファイルインデックスのようなもの) を XML で管理する。ここに用意したシェルスクリプトは 2.0 以前でも 2.2 以降でも利用できる。

RHEL5 以降ではこんな込み入った手間は要らない。必要なパッケージをひとつのディレクトリに集めてから、createrepo を実行するだけで事足りる。 その際には、-g オプションでグループファイル (comps.xml) も取り込んでやるとより完全。グループファイルは、インストール DVD の repodata ディレクトリにある。あとはそのディレクトリを Apache で解放するだけだ。ただし、RHEL6 からパッケージングの仕様が変わったため、RHEL6 で RHEL5 以前用の yum レポジトリをホスティングするのは難しい。

これをまとめるにあたっては Creating a Redhat Yum Repository (WebMO) が大変参考になった。構築に利用しているシェルスクリプトも、一部を除き、同サイトから頂戴して手を加えたものだ。

※ この記事を書いた少し後になって、ここでやっていることをもっと洗練された筋道で実現してくれる Cobbler という正式なパッケージが登場した。レポジトリを RedHat Enterprise Linux 4 (RHEL4) 以降か Fedora Core 6 以降のサーバ上に構築するなら Cobbler の活用も検討してみてはいかがだろうか。

ツール

バージョン共通のツール

RHEL4 の場合 (yum-2.2以降を使用)

RHEL4 への yum のインストール で述べた以外に、下記のパッケージが必要。各々 `rpmbuild --rebuild xxx.src.rpm' して RPMパッケージを作成してから、それをインストールする。

yumレポジトリ (サーバ) の構築

安全性を考慮して、レポジトリは yumadm という専任ユーザの足下に作成し、そこを Apache の alias 機能で公開することにする。以下手順の /home/yumadm が yumadm ユーザのホームディレクトリだ。当例では全てのマシンのディストリビューションは RHEL 4 ES と仮定する。 AS の場合は以降の `4ES' を `4AS' に読み替えればいい。また、 x86 32bit 環境でしか試していないので、もしかすると x86_64 環境で使うにはスクリプトに細工が必要な可能性もある。

1. 何は兎も角 yumadm グループ/ユーザを作成する。べつに専用ユーザを作らなくても構わないし、違う名前でもいっこうに構わないが、その場合は以後の説明中の yumadm を読み替え、構築スクリプトの中に登場する yumadm も全て置き換える必要がある。
2. Apache の実行ユーザ apache を yumadm グループにも属させる。つまり usermod -G yumadm apache
3. /home/yumadm/ のパーミションを 0750 にする。 apache がアクセスできるようにするため。もっと厳格にしたければ 0710。ここまでの作業は root で行うが、以後の手順は全て yumadm ユーザ権限で行う。
4. 構築ツールを置く ~yumadm/repotools/ ディレクトリと、公開ディレクトリの根本となる ~yumadm/pub/ ディレクトリを作成。
5. repotools/ へ cd して make-redhat-mirror, make-apt, get-updates シェルスクリプトを配置し、ともに実行ビットを立てる。また、yum-2.2以降で使う人は make-apt へのシンボリックリンク make-yum2 も作成しておく。
6. ./make-redhat-mirror full 4ES を実行する -> ~yumadm/pub/package/ 下のディレクトリツリーが出来上がる。引数の意味は make-redhat-mirror を引数なしで実行してみれば分かる。
7. アップデートCD からパッケージを吸い上げる行程に入る。まず RedHatアップデートCDをマウントする。マウントポイントが /media/cdrom 以外の場合は get-updates スクリプト冒頭の MOUNTP 変数の値を変えていただきたい。さらに、 CD-ROM などではなく、全く別のところ (例えば自身の yum クライアントのキャッシュ済みRPMパッケージ) から拾ってくることも可能で、そうしたい場合には、デフォルトでは "" になっている RPMSOURCE 変数にそのディレクトリを絶対指定すると、 MOUNTP を無視してそこがソースとして使用される。
8. ./get-updates 4ES を実行する -> RPMがメディアから ~yumadm/pub/package/ 配下にアーキテクチャ別にコピーされる。これを CD枚数分繰り返す。アップデートでなく、システムのインストールに使用したフルセット (つまり yum の [base] 定義で参照するためのもの) をコピーしておきたい時には ./get-updates 4ES os とコマンド。ディストリビューション基本データ (comps.xml など、オリジナルインストールCD の /base/ディレクトリの内容) をコピーしたい場合には ./get-updates 4ES base とコマンドする (base についてはCD枚数分でなく1度だけでいい)。
9. シンボリックリンクやメタデータを生成する。 yum-2.2以降用のレポジトリを整備する場合には、./make-yum2 full 4ES と行程 5 で作成したシンボリックリンクのほうをコールする。 2.0 系の場合は./make-apt full 4ES' を実行する (~yumadm/pub/up2date/ 以下の構造ができ、 ~yumadm/pub/package からのシンボリックリンクやら、必要なメタデータやらが作られる)。 なお、今回の用途では extra 区分はレポジトリにコピーしていないため 「extra ディレクトリにはパッケージがないので空のメタデータを作った」 という警告メッセージが出るが、実害はない。
10. この ~yumadm/pub/up2date/ を Apache の alias機能で /up2date/ として公開する。そのための Apache設定の肝は；

<Directory "/home/yumadm/pub/up2date">
 Options Indexes SymlinksIfOwnerMatch
 AllowOverride None
 Order allow,deny
 Allow from 127.0.0.1 192.168.0
</Directory>
 
alias /up2date/ "/home/yumadm/pub/up2date/"

Apache がシンボリックリンクを辿れることが必須だが、 FollowSymlinks よりは、多少なりとも安全性の高い SymlinksIfOwnerMatch のほうがいいだろう。また、Apache のその他の設定要件として以下の設定が必要だということが分かった；

• mod_mime_magic をロードしていると、yum がメタデータファイルにアクセスするたびに「MIMEタイプが判定できない」という旨のログが残るので、ロードしないほうがいい。
• KeepAlive=On でなければならない。

クライアント側の設定

RedHat Enterprise Linux 4 ES + yum-2.2 以降の場合

1. yum をインストール。
2. yum.repos.d/redhat.repo を作成。下記の /4ES/ の部分は /$releasever/ でも行ける。

   [updates]
   name=Red Hat Updates - $basearch
   baseurl=http://local_repo_uri/up2date/redhat/4ES/en/$basearch/updates/

   また、サーバ構築の行程 8 でベース(os) パッケージを取り込んだ場合は、下記のように [base] 定義を書けば、それも参照することができる。取り込まなかったのに書いてしまうと、エラーが出る。

   [base]
   name=Red Hat Base - $basearch
   baseurl=http://local_repo_uri/up2date/redhat/4ES/en/$basearch/os/

3. yumレポジトリサーバ自身の yum.conf だけは、レポジトリ参照先が自分自身なので、上記の local_repo_uri 部分を localhost にしたほうがいいかもしれない。ただし、DNS や hosts ファイルでリゾルブできるのならば (普通はできるだろう)、敢えて localhost にしなければならない理由はない。

Fedora Core + yum-2.2以降の場合

1. yum-2.2 以降をインストール。おそらく既にインストールされているだろう。
2. yum.repos.d/fedora-updates.repo を編集。[updates-released] の baseurl は下のような塩梅。これはレポジトリサーバ構築の時に yum公開ディレクトリを make-yum2 full FC4 などとして整備した場合だ。

   baseurl=http://local_repo_uri/up2date/redhat/FC$releasever/en/$basearch/updates/

   サーバ構築の行程 8 でベースパッケージを取り込まなかった場合は yum.repos.d/fedora.repo を fedora.repo.old などへリネームする。取り込んだ場合は、前記 RHEL 4 ES と同様に baseurl の最後を /os/ にすげ替えた [base] 定義を書く。
3. yumレポジトリサーバ自身の yum.conf だけは、レポジトリ参照先が自分自身なので、上記の local_repo_uri 部分を localhost にしたほうがいいかもしれない。ただし、DNS や hosts ファイルでリゾルブできるのならば (普通はできるだろう)、敢えて localhost にする必要はない。