ArchWiki - 利用者の投稿記録 [ja]

カーネルライブパッチ

2022-12-11T13:01:27Z

Ryanak:

[[Category:カーネル]]
[[en:Kernel live patching]]
{{Related articles start}}
{{Related|カーネルモジュール}}
{{Related|カーネル/コンパイル}}
{{Related|Kexec}}
{{Related articles end}}

カーネルライブパッチ (Kernel Live Patching, KLP) を使うことでシステムを再起動することなくカーネル空間に即座に修正を適用することができます。バージョン 4.0 から、ライブパッチに関連するパッチが上流にマージされたことで [https://lwn.net/Articles/619390/][https://lwn.net/Articles/622936/][https://lwn.net/Articles/634649/]、誰でもライブパッチ機能を使えるようになりました。一般的に、KLP は以下の手順で行います:
# 実行中のカーネルのソースツリーを取得。
# カーネルに適用するパッチを用意。
# ツールを使ってパッチを変換・ロード。

KLP が公式にサポートされる前から、ライブパッチ機能を提供するプロジェクトはいくつか存在していました。Oracle の [[#ksplice|ksplice]] や SuSE の [[#kGraft|kGraft]]、RedHat の [[#kpatch|kpatch]] などです。それぞれ異なる方法で KLP 機能を実装しています。メインストリームカーネルに取り込まれたパッチセットは kpatch と kGraft 由来のものです。

== kpatch ==

=== インストール ===

カーネルとして {{AUR|kpatch}}を、ユーザースペースツールとして {{AUR|kpatch-git}} をインストールしてください。

{{ic|CONFIG_LIVEPATCH}}, {{ic|CONFIG_DEBUG_INFO}}, {{ic|CONFIG_KALLSYMS}} を有効にすることで kpatch が使用できるカーネルを手動でビルドすることも可能です。

{{Note|カーネルをインストールしたら必ずブートローダーを更新してください。}}

=== 使用方法 ===

パッケージのビルドが完了したら再起動後に以下のコマンドを実行:

$ export ROOTDIR=some/dir/aur/linux-kpatch/src/linux-x-y
$ cd $ROOTDIR

作業ディレクトリでカーネルに修正を加えて ''some.patch'' パッチを作成したら (標準カーネルの ''x.y'' バージョンではなく {{ic|makepkg -o}} の後にソースツリーに対してパッチを作成します)、kpatch ユーティリティを起動:

$ kpatch-build -s $(pwd) -t $(pwd)/vmlinux ''some.patch''

上記のコマンドはオリジナルのカーネルとパッチ済みのカーネルの両方をビルドするため、完了するまでしばらく時間がかかります。ビルドが完了すると同じディレクトリに ''kpatch-some.ko'' モジュールが出来ているはずです。そうしたら以下のコマンドでパッチを適用できます:

# insmod ''kpatch-some.ko''

詳しくは man ページや [https://github.com/dynup/kpatch github リポジトリ] を参照してください。

== kGraft ==

KGraft は Arch 環境ではテストされておらず、サポートされていません。

== ksplice ==

Ksplice はオペレーティングシステムを再起動することなく、システム管理者が実行中のカーネルにセキュリティパッチを適用できるようにする Linux カーネルのオープンソース拡張です。2011年から Ksplice は Oracle に取得され、Oracle のプレミアムサポート下でのみ利用できる状態です。

=== インストール ===

[[Arch User Repository]] から {{AUR|ksplice-git}} パッケージをインストールしてください。

== 使用方法 ==
まず、使用しているカーネルのソースツリーと、以前にカーネルをビルドした時のファイルが必要です: {{ic|System.map}} と {{ic|.config}}。

前のビルドで使用した {{ic|System.map}} が存在しない場合は、{{ic|/proc/kallsyms}} をコピーして使うことができます。{{ic|kernel.kptr_restrict}} カーネルパラメータが有効になっている場合は、必ず root でコピーしてください。

この例では {{ic|--diffext}} オプションを利用して、新旧ソースファイルの差異からパッチを作成します。

カーネルのソースツリーに {{ic|ksplice}} ディレクトリを作成して、前のビルドの {{ic|System.map}} をコピーして、{{ic|.config}} をツリーにコピーしてください (ソースツリーに存在しない場合):

# mkdir -p src/ksplice
# cp System.map src/ksplice
# cp .config src/

ksplice パッチを作成してカーネルがリビルドされるのを待ちます。{{ic|new}} で終わるファイルが全て ksplice のパッチに組み込まれます。例えば、C のソースファイルなら、diffext が直接追加されて {{ic|.cnew}} になります。

# ksplice-create --diffext=new src/

新しく生成したパッチを実行中のカーネルに適用:

# ksplice-apply ksplice-*.tar.gz

{{ic|ksplice-apply}}, {{ic|ksplice-create}}, {{ic|ksplice-view}}, {{ic|ksplice-undo}} の man ページを参照してください。

== 参照 ==

* [https://www.kernel.org/doc/Documentation/livepatch/livepatch.txt ライブパッチのカーネルドキュメント]
* [[wikipedia:Kpatch]]
* [[wikipedia:KGraft]]
* [[wikipedia:Ksplice]]

Munin

2017-09-17T12:22:05Z

Ryanak: 誤字

[[Category:状態監視と通知]]
[[en:Munin]]
[http://munin-monitoring.org/ プロジェクトウェブページ] より:

:''Munin'' はコンピュータに何があったのか調べる事ができるモニタリングツールです。調べた全ての情報をウェブインターフェースを介して表示する事ができます。インストールが完了した後は、沢山のモニタリングプラグインたちがあなたに代わって仕事をしてくれる事でしょう。

:Munin を使えばネットワーク、SAN、アプリケーション、気象状況等による計算機の性能評価が簡単になります。性能の問題について「おや、この日は何が違ったのかな？」とか簡単に分かるようになります。リソース毎の過不足を簡単に判断できるようになるでしょう。

:Munin は優れた [http://oss.oetiker.ch/rrdtool/ RRDTool] (著 Tobi Oetiker) と Perl で書かれたフレームワーク、それと様々な言語で書かれたプラグインたちによって構成されています。Munin はマスター/ノードアーキテクチャーを採っていて、マスターが全てのノードに対し定期的にデータ収集を行います。データは RRDファイルに記録され、必要に応じてグラフを更新します。とりあえずの目標としてプラグイン（グラフ）を自在に扱える様になりましょう。

と、いうわけで、 Munin はシステムの統計を採りグラフに図示してくれるものです。詳しくはオスロ大学の [http://munin.ping.uio.no/ Munin install] など見ると良いでしょう。

== インストール作業 ==

Munin はクライアント−サーバーモデルです。クライアントを munin-node 、サーバーを munin と称します(ドキュメントでは "munin-master"となっていたりもするけど)。

munin-master は1台のマシンにインストールし、 munin-node は監視したい全てのマシンにインストールします。ここでは、とりあえず1台のマシンについてのみインストールする事を考えてみるとしましょう。より詳しく知りたいのならば [http://munin-monitoring.org/wiki/Documentation Munin documentation wiki] を見ましょうね。

=== munin と munin-node について ===

執筆現在に於いて munin (munin-master) と munin-node は extra リポジトリにパッケージがあります。

==== パッケージの確認 ====

# pacman -Ss munin

extra/munin 1.4.6-2
A distributed monitoring/graphing tool
extra/munin-node 1.4.6-2
A distributed monitoring/graphing tool

==== インストール ====

# pacman -S munin munin-node

=== ウェブサーバーの必要性について ===

このガイドでは Munin で静的な HTML とグラフ画像を設定されたディレクトリへ出力する様にセットアップを行います。生成されたファイルはローカルのブラウザからならそのまま見ることも出来るでしょう。しかし、もしリモートのマシンから見たいのならば適当なウェブサーバーを予めセットアップしておく必要があります。例えば、

*[[LAMP|Apache]]
*[[Lighttpd]]
*[[Nginx]]

などなど。他にサーバーについては詳しく知りたければ[[:Category:ウェブサーバー|ウェブサーバーカテゴリ]]も参考になるかもしれません。

=== IPv6 ===

munin-node で IPv6 をサポートするには ({{ic|/etc/munin/munin-node.conf}} で {{ic|host :::1}} を使う) 以下のパッケージをインストールする必要があります:

*{{Pkg|perl-socket6}}
*{{Pkg|perl-io-socket-inet6}}

== 設定 ==

=== デーモン ===

デーモンを追加して

# systemctl enable munin-node

起動して置きましょう

# systemctl start munin-node

詳しくは[[デーモン]]を見て下さい。

=== プラグイン ===

{{ic|munin-node-configure}} を実行しましょう。{{ic|--suggest}} オプションを付けると、インストールしたマシンで使えそうなプラグインのお勧めリストが表示されます:

# munin-node-configure --suggest

使用したいプラグインがあれば、もう一度コマンドを実行します。{{ic|--shell}} オプションを付けると {{ic|munin-node-configure}} によってお勧めされたプラグインが設定されるでしょう:

# munin-node-configure --shell | sh

==== SNMP について設定したい場合 ====

例えば SNMP サーバーが SERVER というホスト名で、バージョン v2c 、コミュニティ名 COMMUNITY で稼働している際は次の様にお勧めリストの確認を行います:

# munin-node-configure --suggest --snmp SERVER --snmpversion snmpv2c --snmpcommunity COMMUNITY

この結果をシェル用に出力し、その出力をシェルに渡すには次の様にします:

# munin-node-configure --shell --snmp SERVER --snmpversion snmpv2c --snmpcommunity COMMUNITY | sh

=== ディレクトリ ===

munin-master がHTMLやグラフ画像を生成する為のディレクトリを設定し、作成して於きましょう。

{{ic|/etc/munin/munin.conf}} の以下の {{ic|htmldir}} のコメントを外します:

htmldir /srv/http/munin

これで {{ic|/srv/http/munin}} へ出力が設定されます。

ディレクトリについては作成するだけでなく、ユーザー munin がこのディレクトリへの書き込み権限を満たす様にするのも忘れないようにしましょう。

# mkdir /srv/http/munin
# chown munin:munin /srv/http/munin

適当なウェブサーバーが標準設定のまま (ドキュメントルートが {{ic|/srv/http}})で稼働していれば、このディレクトリを [http://localhost/munin/ http://localhost/munin/] で表示する事が出来るでしょう。

=== ホスト名 ===

munin を実行する前に、システムのホスト名を設定しておくと良いでしょう。{{ic|/etc/munin/munin.conf}} で標準では {{ic|myhostname}} となっている筈です。お好みの名前を付けてあげて下さいね。ホスト名は {{ic|/var/lib/munin}} の .rrdファイル、HTML やグラフ画像のグループ化に適用されます。

=== Cron ===

次の設定で5分措きに munin がデータを更新し、HTMLとグラフ画像を生成します:

# crontab /etc/munin/munin-cron-entry -u munin

ユーザー munin へのメール配送のエイリアスも設定して措くと良いでしょう。もしも postfix を使っているのならば {{ic|/etc/postfix/aliases}} に次のように設定し、

munin: root

それから

# newaliases

とかコマンドを実行すると良いでしょう。

=== systemd タイマー ===

cron ジョブではなく systemd のタイマーを使うこともできます。

タイマーにはサービスユニットの設定が必要です:

{{hc|/etc/systemd/system/munin-cron.service|2=
[Unit]
Description=Survey monitored computers
After=network.target

[Service]
User=munin
ExecStart=/usr/bin/munin-cron
}}

タイマーユニットの設定:

{{hc|/etc/systemd/system/munin-cron.timer|2=
[Unit]
Description=Survey monitored computers every five minutes

[Timer]
OnCalendar=*-*-* *:00/5:00

[Install]
WantedBy=multi-user.target
}}

systemd の設定を[[systemd#ユニットを使う|リロード]]して、{{ic|munin-cron.timer}} を[[起動]]し、問題が発生しないことを確認してください:

$ journalctl --unit munin-cron.service
$ less /var/log/munin/munin-update.log

最後に、{{ic|munin-cron.timer}} を有効化してください。

=== ユーザー munin へのアクセス権の設定 ===

多くのプラグインがログファイルを読もうとします。そう云う訳でユーザー munin を log グループに追加して措きましょう:

# usermod -aG log munin

== テスト ==

Munin は既に使える状態になっています。さあ、{{ic|munin-node}} を稼働させましょう:

# systemctl start munin-node

もしも手作業で HTML とグラフ画像を生成したいのならば、

# munin --shell=/bin/bash
$ munin-cron

とかすると良いでしょう。後はブラウザで出力ディレクトリ或いは [http://localhost/munin/ http://localhost/munin/] を表示する等してインターフェースをテストしましょう。

{{Note|グラフにデータが集まりだすのには時間がかかるので30分くらい待って見ましょうね。}}

== プラグイン ==

Munin には沢山のプラグインがあってキミにインストールされるのを待っているよ！手始めに [http://muninexchange.projects.linpro.no/ MuninExchange] を見るといいよ、素敵だろ？まあ、時にはお目当てのプラグインを見付けられない事もあるだろうけど…そんな時は自分で書けばいいよ！簡単だから [http://munin-monitoring.org/wiki/HowToWritePlugins HowToWritePlugins] を見ながらやってみるといいよ。

=== 追加 ===

基本的には全てのプラグインはマナーに則って追加されるよ(いやまあ勿論、例外はあるからプラグイン毎によく確認してね！):

先ずはプラグインをダウンロードするなどして、それを {{ic|/usr/lib/munin/plugins}} に複製なり移動なりしよう。

# cp <plugin> /usr/lib/munin/plugins/

そして {{ic|/etc/munin/plugins}} にシンボリックリンクを張るんだ:

# ln -s /usr/lib/munin/plugins/<plugin> /etc/munin/plugins/<plugin>

{{Note|ワイルドカードプラグインと云われる幾つかのプラグインについては… - 別々の名前でリンクを張る事で複数のデバイスを扱えたりもするよ。こんな様なプラグインたちはプラグインの末尾がアンダースコアで終わっていて、{{ic|<plugin>_<device>}} とかリンクを張る事で {{ic|<device>}} に対応する様に動作するんだ。例としては {{ic|if_}} プラグインとかを見るといいよ。}}

さあ、プラグインをテストしよう。プラグインのフルパスを入れる必要は無いよ、次にように munin-run を実行しよう:

# munin-run <plugin>

それから munin-node を再起動するんだ:

# systemctl restart munin-node

後はウェブページが更新されれば完了さ。

=== 削除 ===

プラグインを削除したいのなら、{{ic|/etc/munin/plugins}} のシンボリックリンクを削除すればいい。{{ic|/usr/lib/munin/plugins}} から削除する必要は無いよ。

# rm /etc/munin/plugins/<plugin>

=== デバッグ作業 ===

思惑通りに動いてくれないプラグイン(何も出力されてないっぽいとか)に出会してしまったなら、そのプラグインを直接実行して見るというのも良いかもしれません。例えば、{{ic|apache_accesses}} プラグインを直接実行するには、

# munin-run apache_accesses

とかします。

エラーがあれば、例えば "LWP::UserAgent not found at /etc/munin/plugins/apache_accesses line 86." だとか出力されるかもしれません。ちなみにこの場合は、Perlの関数が見つからないという問題で、不足しているライブラリ {{Pkg|perl-libwww}} をインストールしてあげると良いかもしれません。

==Tips and Tricks==

===MySQL===

MySQL プラグインは AUR のパッケージに依存しています: {{Pkg|perl-dbi}}, {{AUR|perl-cache-cache}}, {{AUR|perl-ipc-sharelite}}

また、データベースにアクセスするときは専用の [[MySQL]] ユーザーを使うことが推奨されています。ユーザーを作成するには以下の MySQL コマンドを実行:
{{bc|<nowiki>MariaDB> CREATE USER 'muninuser'@'localhost' IDENTIFIED BY 'muninpassword';
MariaDB> GRANT SUPER,PROCESS ON *.* TO 'muninuser'@'localhost';
MariaDB> GRANT SELECT ON mysql.* TO 'muninuser'@'localhost';
MariaDB> FLUSH PRIVILEGES;</nowiki> }}

この新しいユーザーを使うように Munin を設定するには、以下を作成:

{{hc|/etc/munin/plugin-conf.d/mysql_|<nowiki>[mysql_*]
env.mysqlconnection DBI:mysql:mysql;host=127.0.0.1;port=3306
env.mysqluser muninuser
env.mysqlpassword muninpassword</nowiki>}}

===S.M.A.R.T.===

S.M.A.R.T. データの監視を有効にするには {{Pkg|smartmontools}} パッケージをインストールして、以下を使用:

{{hc|/etc/munin/plugin-conf.d/munin-node|[smart_*]
user root
group disk}}

そして監視するディスクのシンボリックリンクを適切に作成してください。{{ic|sda}} の場合: {{bc|# ln -s /usr/lib/munin/plugins/smart_ /etc/munin/plugins/smart_'''sda'''}}

===lm_sensors===

{{Pkg|lm_sensors}} をインストールして [[Lm sensors#lm_sensors の設定]] に従って設定を行って下さい。それが全て終わったら、シンボリックリンクを作成:
{{bc|# ln -s /usr/lib/munin/plugins/sensors_ /etc/munin/plugins/sensors_fan
# ln -s /usr/lib/munin/plugins/sensors_ /etc/munin/plugins/sensors_temp
# ln -s /usr/lib/munin/plugins/sensors_ /etc/munin/plugins/sensors_volt}}