コンテンツにスキップ

インストール

Mikagami は RPM で導入します。配布している RPM は Rocky Linux 10(el10)の aarch64 版だけです。

配布物 場所
RPM・ソース RPM・チェックサム(SHA256SUMS) GitHub Releases(v0.8.0)
ソースコード github.com/hagix9/mikagami-public

試験の実績は Rocky Linux 10.2(aarch64)です。Rocky Linux 9 と x86_64 の RPM は配布しておらず、未検証です(検証状況)。RPM に署名はありません。ダウンロードした後に SHA-256 を確かめてください。

ターミナルウィンドウ
base=https://github.com/hagix9/mikagami-public/releases/download/v0.8.0
curl -LO "$base/mikagami-0.8.0-1.el10.aarch64.rpm"
curl -LO "$base/SHA256SUMS"
sha256sum -c SHA256SUMS --ignore-missing

mikagami-0.8.0-1.el10.aarch64.rpm: OK と出ることを確かめます。

ソースから RPM を作る(他の環境)

Section titled “ソースから RPM を作る(他の環境)”

Rocky Linux 9 や x86_64 では、ソースから RPM を作ります(未検証)。ビルドには Rocky Linux(el9 なら el9、el10 なら el10)のホストと、rpm-build、systemd-rpm-macros、gcc、python3、Rust(rust-toolchain.toml で固定した版)が要ります。

ターミナルウィンドウ
git clone https://github.com/hagix9/mikagami-public.git && cd mikagami-public
# ソースの tarball(依存のソースを含む)を作る(macOS でも可)
packaging/rpm/build.sh sources --out ~/mkg-rpm
# RPM を作る(Rocky Linux で)
packaging/rpm/build.sh rpm --out ~/mkg-rpm

el10 で作った RPM は glibc 2.39 を要するので、el9 では el9 で作ってください。

ターミナルウィンドウ
dnf install ./mikagami-0.8.0-1.el10.aarch64.rpm

入るもの:

path 内容
/usr/bin/mikagami、/usr/bin/mkg CLI と daemon(mkg は同じプログラム)
/usr/lib/systemd/system/mikagami.service ノードの daemon
/usr/lib/systemd/system/mikagami-witness.service 補助ノード(Witness)の daemon
/usr/libexec/mikagami/check-http HTTP のヘルスチェックの script
/etc/mikagami/mikagami.toml、witness.toml 注釈だけの雛形(そのままでは起動を拒否します)
/usr/share/licenses/mikagami/ LICENSE(Apache-2.0)と第三者のライセンス
/usr/share/doc/mikagami/ 文書と設定例

依存:/usr/sbin/arping(iputils)、/usr/bin/curl、systemd。

ターミナルウィンドウ
mikagami --version
mkg --version
systemctl is-enabled mikagami # disabled(自動では有効にしません)

2 台(補助ノード付き構成では 3 台)で同じ共有鍵を使います。1 台で作り、他のノードへ安全に写します。

ターミナルウィンドウ
umask 077
head -c 32 /dev/urandom | od -An -tx1 | tr -d ' \n' > /etc/mikagami/cluster.psk
chmod 600 /etc/mikagami/cluster.psk

形式は 64 文字の 16 進数、mode 0600、所有者 root です。

  1. 両ノードで systemctl stop mikagami、補助ノード(Witness)では systemctl stop mikagami-witness で HA を止めます。
  2. dnf upgrade ./mikagami-0.8.0-N.el10.aarch64.rpm
  3. /etc/mikagami/*.rpmnew があれば差分を確かめます。
  4. 起動します(補助ノード付き構成では 補助ノード → node-b → node-a の順)。

版の混在した 2 台での運転(rolling upgrade)はできません。

ターミナルウィンドウ
systemctl stop mikagami # 補助ノードでは mikagami-witness
dnf remove mikagami

/var/lib/mikagami* の状態と、編集した設定(.rpmsave)は残ります。