サポートコンソール開発者トライアルの開始お問い合わせ

付録B cephadm コマンド

cephadm は、Cephadm Orchestrator のローカルホストを管理するコマンドラインツールです。現在のホストの状態を調査および変更するコマンドを提供します。

通常、コマンドの一部はデバッグに使用されます。

注記

cephadm はすべてのホストでは必要ありませんが、特定のデーモンを調査するときに便利です。cephadm-ansible-preflight Playbook はすべてのホストに cephadm をインストールし、cephadm-ansible purge Playbook では、適切に機能させるには、全ホストに cephadm をインストールする必要があります。

adopt
説明
アップグレードしたストレージクラスターデーモンを変換して、cephadm を実行します。
構文
cephadm adopt [-h] --name DAEMON_NAME --style STYLE [--cluster CLUSTER] --legacy-dir [LEGACY_DIR] --config-json CONFIG_JSON] [--skip-firewalld] [--skip-pull]
例
[root@host01 ~]# cephadm adopt --style=legacy --name prometheus.host02
ceph-volume
説明
このコマンドは、特定のホスト上の全デバイスをリスト表示に使用されます。コンテナー内で ceph-volume コマンドを実行します。これにより、lvm や物理ディスクなど、さまざまなデバイス技術を持つ OSD を、プラグ可能なツールを用いてデプロイします。また、OSD の準備、有効化起動のプロセスは、予測可能かつ強固な手順に従って実行されます
構文
cephadm ceph-volume inventory/simple/raw/lvm [-h] [--fsid FSID] [--config-json CONFIG_JSON] [--config CONFIG, -c CONFIG] [--keyring KEYRING, -k KEYRING]
例
[root@nhost01 ~]# cephadm ceph-volume inventory --fsid f64f341c-655d-11eb-8778-fa163e914bcc
check-host
説明
Ceph クラスターに適したホスト設定を確認します。
構文
cephadm check-host [--expect-hostname HOSTNAME]
例
[root@host01 ~]# cephadm check-host --expect-hostname host02
deploy
説明
デーモンをローカルホストにデプロイします。
構文
cephadm shell deploy DAEMON_TYPE [-h] [--name DAEMON_NAME] [--fsid FSID] [--config CONFIG, -c CONFIG] [--config-json CONFIG_JSON] [--keyring KEYRING] [--key KEY] [--osd-fsid OSD_FSID] [--skip-firewalld] [--tcp-ports TCP_PORTS] [--reconfig] [--allow-ptrace] [--memory-request MEMORY_REQUEST] [--memory-limit MEMORY_LIMIT] [--meta-json META_JSON]
例
[root@host01 ~]# cephadm shell deploy mon --fsid f64f341c-655d-11eb-8778-fa163e914bcc
enter
説明
実行中のデーモンコンテナー内でインタラクティブシェルを実行します。
構文
cephadm enter [-h] [--fsid FSID] --name NAME [command [command …]]
例
[root@host01 ~]# cephadm enter --name 52c611f2b1d9
help
説明
cephadm によってサポートされるすべてのコマンドを表示します。
構文
cephadm help
例
[root@host01 ~]# cephadm help
install
説明
パッケージをインストールします。
構文
cephadm install PACKAGES
例
[root@host01 ~]# cephadm install ceph-common ceph-osd
inspect-image
説明
ローカルの Ceph コンテナーイメージを検査します。
構文
cephadm --image IMAGE_ID inspect-image
例
[root@host01 ~]# cephadm --image 13ea90216d0be03003d12d7869f72ad9de5cec9e54a27fd308e01e467c0d4a0a inspect-image
list-networks
説明
IP ネットワークをリスト表示します。
構文
cephadm list-networks
例
[root@host01 ~]# cephadm list-networks
ls
説明
ホストの cephadm が認識するデーモンインスタンスをリスト表示します。コマンド実行時間を短縮するには --no-detail を使用できます。これにより、デーモンごとの名前、fsid、スタイル、および systemd ユニットの詳細が提供されます。--legacy-dir オプションを使用して、デーモンを検索するレガシーベースディレクトリーを指定できます。
構文
cephadm ls [--no-detail] [--legacy-dir LEGACY_DIR]
例
[root@host01 ~]# cephadm ls --no-detail
logs
説明
デーモンコンテナーの journald ログを出力します。これは journalctl コマンドに似ています。
構文
cephadm logs [--fsid FSID] --name DAEMON_NAME
cephadm logs [--fsid FSID] --name DAEMON_NAME -- -n NUMBER # Last N lines
cephadm logs [--fsid FSID] --name DAEMON_NAME -- -f # Follow the logs
例
[root@host01 ~]# cephadm logs --fsid 57bddb48-ee04-11eb-9962-001a4a000672 --name osd.8
[root@host01 ~]# cephadm logs --fsid 57bddb48-ee04-11eb-9962-001a4a000672 --name osd.8 -- -n 20
[root@host01 ~]# cephadm logs --fsid 57bddb48-ee04-11eb-9962-001a4a000672 --name osd.8 -- -f
prepare-host
説明
cephadm のホストを準備します。
構文
cephadm prepare-host [--expect-hostname HOSTNAME]
例
[root@host01 ~]# cephadm prepare-host
[root@host01 ~]# cephadm prepare-host --expect-hostname host01
pull
説明
Ceph イメージをプルします。
構文
cephadm [-h] [--image IMAGE_ID] pull
例
[root@host01 ~]# cephadm --image 13ea90216d0be03003d12d7869f72ad9de5cec9e54a27fd308e01e467c0d4a0a pull
registry-login
説明
認証されたレジストリーの cephadm ログイン情報を提供します。Cephadm はそのレジストリーに呼び出したホストのログ記録を試行します。
構文
cephadm registry-login --registry-url [REGISTRY_URL] --registry-username [USERNAME] --registry-password [PASSWORD] [--fsid FSID] [--registry-json JSON_FILE]
例
[root@host01 ~]# cephadm registry-login --registry-url registry.redhat.io --registry-username myuser1 --registry-password mypassword1

また、以下のようにフォーマットされたログイン情報が含まれる JSON レジストリーファイルを使用することもできます。

構文
cat REGISTRY_FILE

{
 "url":"REGISTRY_URL",
 "username":"REGISTRY_USERNAME",
 "password":"REGISTRY_PASSWORD"
}
例
[root@host01 ~]# cat registry_file

{
 "url":"registry.redhat.io",
 "username":"myuser",
 "password":"mypass"
}

[root@host01 ~]# cephadm registry-login -i registry_file
rm-daemon
説明
特定のデーモンインスタンスを削除します。cephadm rm-daemon コマンドをホスト上で直接実行すると、コマンドによってデーモンは削除されますが、cephadm mgr モジュールはデーモンが欠落していることを認識し、デーモンを再デプロイします。このコマンドは問題が含まれており、実験的な目的およびデバッグにのみ使用する必要があります。
構文
cephadm rm-daemon [--fsid FSID] [--name DAEMON_NAME] [--force ] [--force-delete-data]
例
[root@host01 ~]# cephadm rm-daemon --fsid f64f341c-655d-11eb-8778-fa163e914bcc --name osd.8
rm-cluster
説明
実行先の特定のホストのストレージクラスターからすべてのデーモンを削除します。rm-daemon と同様に、この方法でいくつかのデーモンが削除され、Ceph Orchestrator は一時停止されず、これらのデーモンでマネージド外ではないサービスに所属するものがある場合は、cephadm オーケストレーターにより、そこに再デプロイされます。
構文
cephadm rm-cluster [--fsid FSID] [--force]
例
[root@host01 ~]# cephadm rm-cluster --fsid f64f341c-655d-11eb-8778-fa163e914bcc
重要

クラスターの削除実行の一環としてノードをより適切にクリーンアップするために、cephadm rm-cluster コマンドの実行時に /var/log/ceph ディレクトリーの下のクラスターログが削除されます。--keep-logs が rm-cluster コマンドに指定されていない限り、クラスターログは削除されます。

注記

ホストが Cephadm によって管理され、Cephadm Manager モジュールが有効になって実行されている既存のクラスタの一部であるホストで cephadm rm-cluster コマンドを実行すると、Cephadm がすぐに新しいデーモンのデプロイを開始し、さらにログが表示される可能性があります。これを回避するには、クラスターをパージする前に cephadm mgr モジュールを無効にします。 

# ceph mgr module disable cephadm
rm-repo
説明
パッケージリポジトリーの設定を削除します。これは主に Red Hat Ceph Storage の非接続インストールに使用されます。
構文
cephadm rm-repo [-h]
例
[root@host01 ~]# cephadm rm-repo
run
説明
フォアグラウンドのコンテナーで Ceph デーモンを実行します。
構文
cephadm run [--fsid FSID] --name DAEMON_NAME
例
[root@host01 ~]# cephadm run --fsid f64f341c-655d-11eb-8778-fa163e914bcc --name osd.8
shell
説明
推論または指定した Ceph クラスターを使用して、Ceph コマンドにアクセスできるインタラクティブシェルを実行します。cephadm shell コマンドを使用してシェルに移動し、シェル内ですべてのオーケストレーターコマンドを実行できます。
構文
cephadm shell  [--fsid FSID] [--name DAEMON_NAME, -n DAEMON_NAME] [--config CONFIG, -c CONFIG] [--mount MOUNT, -m MOUNT] [--keyring KEYRING, -k KEYRING] [--env ENV, -e ENV]
例
[root@host01 ~]# cephadm shell -- ceph orch ls
[root@host01 ~]# cephadm shell
unit
説明
この操作でデーモンを起動、停止、再起動、有効化、および無効にします。これは、デーモンの systemd ユニットで動作します。
構文
cephadm unit [--fsid FSID] --name DAEMON_NAME start/stop/restart/enable/disable
例
[root@host01 ~]# cephadm unit --fsid f64f341c-655d-11eb-8778-fa163e914bcc --name osd.8 start
version
説明
ストレージクラスターのバージョンを提供します。
構文
cephadm version
例
[root@host01 ~]# cephadm version
Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

Legal Notice

Theme

© 2026 Red Hatトップに戻る