付録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]
cephadm adopt [-h] --name DAEMON_NAME --style STYLE [--cluster CLUSTER] --legacy-dir [LEGACY_DIR] --config-json CONFIG_JSON] [--skip-firewalld] [--skip-pull]
Copy to Clipboard Copied! - 例
cephadm adopt --style=legacy --name prometheus.host02
[root@host01 ~]# cephadm adopt --style=legacy --name prometheus.host02
Copy to Clipboard Copied!
ceph-volume
- 説明
-
このコマンドは、特定のホスト上の全デバイスをリスト表示に使用されます。プラグ可能なツールを使用して、
lvm
や物理ディスクなど、さまざまなデバイス技術を持つ Deploys OSD コンテナー内でceph-volume
を実行するか、推測可能かつ強固な方法で、OSD の準備、有効化、開始する方法を進めていきます。 - 構文
cephadm ceph-volume inventory/simple/raw/lvm [-h] [--fsid FSID] [--config-json CONFIG_JSON] [--config CONFIG, -c CONFIG] [--keyring KEYRING, -k KEYRING]
cephadm ceph-volume inventory/simple/raw/lvm [-h] [--fsid FSID] [--config-json CONFIG_JSON] [--config CONFIG, -c CONFIG] [--keyring KEYRING, -k KEYRING]
Copy to Clipboard Copied! - 例
cephadm ceph-volume inventory --fsid f64f341c-655d-11eb-8778-fa163e914bcc
[root@nhost01 ~]# cephadm ceph-volume inventory --fsid f64f341c-655d-11eb-8778-fa163e914bcc
Copy to Clipboard Copied!
check-host
- 説明
- Ceph クラスターに適したホスト設定を確認します。
- 構文
cephadm check-host [--expect-hostname HOSTNAME]
cephadm check-host [--expect-hostname HOSTNAME]
Copy to Clipboard Copied! - 例
cephadm check-host --expect-hostname host02
[root@host01 ~]# cephadm check-host --expect-hostname host02
Copy to Clipboard Copied!
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]
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]
Copy to Clipboard Copied! - 例
cephadm shell deploy mon --fsid f64f341c-655d-11eb-8778-fa163e914bcc
[root@host01 ~]# cephadm shell deploy mon --fsid f64f341c-655d-11eb-8778-fa163e914bcc
Copy to Clipboard Copied!
enter
- 説明
- 実行中のデーモンコンテナー内でインタラクティブシェルを実行します。
- 構文
cephadm enter [-h] [--fsid FSID] --name NAME [command [command …]]
cephadm enter [-h] [--fsid FSID] --name NAME [command [command …]]
Copy to Clipboard Copied! - 例
cephadm enter --name 52c611f2b1d9
[root@host01 ~]# cephadm enter --name 52c611f2b1d9
Copy to Clipboard Copied!
help
- 説明
-
cephadm
によってサポートされるすべてのコマンドを表示します。 - 構文
cephadm help
cephadm help
Copy to Clipboard Copied! - 例
cephadm help
[root@host01 ~]# cephadm help
Copy to Clipboard Copied!
install
- 説明
- パッケージをインストールします。
- 構文
cephadm install PACKAGES
cephadm install PACKAGES
Copy to Clipboard Copied! - 例
cephadm install ceph-common ceph-osd
[root@host01 ~]# cephadm install ceph-common ceph-osd
Copy to Clipboard Copied!
inspect-image
- 説明
- ローカルの Ceph コンテナーイメージを検査します。
- 構文
cephadm --image IMAGE_ID inspect-image
cephadm --image IMAGE_ID inspect-image
Copy to Clipboard Copied! - 例
cephadm --image 13ea90216d0be03003d12d7869f72ad9de5cec9e54a27fd308e01e467c0d4a0a inspect-image
[root@host01 ~]# cephadm --image 13ea90216d0be03003d12d7869f72ad9de5cec9e54a27fd308e01e467c0d4a0a inspect-image
Copy to Clipboard Copied!
list-networks
- 説明
- IP ネットワークをリスト表示します。
- 構文
cephadm list-networks
cephadm list-networks
Copy to Clipboard Copied! - 例
cephadm list-networks
[root@host01 ~]# cephadm list-networks
Copy to Clipboard Copied!
ls
- 説明
-
ホストの
cephadm
が認識するデーモンインスタンスをリスト表示します。コマンド実行時間を短縮するには--no-detail
を使用できます。これにより、デーモンごとの名前、fsid、スタイル、および systemd ユニットの詳細が提供されます。--legacy-dir
オプションを使用して、デーモンを検索するレガシーベースディレクトリーを指定できます。 - 構文
cephadm ls [--no-detail] [--legacy-dir LEGACY_DIR]
cephadm ls [--no-detail] [--legacy-dir LEGACY_DIR]
Copy to Clipboard Copied! - 例
cephadm ls --no-detail
[root@host01 ~]# cephadm ls --no-detail
Copy to Clipboard Copied!
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
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
Copy to Clipboard Copied! - 例
cephadm logs --fsid 57bddb48-ee04-11eb-9962-001a4a000672 --name osd.8 cephadm logs --fsid 57bddb48-ee04-11eb-9962-001a4a000672 --name osd.8 -- -n 20 cephadm logs --fsid 57bddb48-ee04-11eb-9962-001a4a000672 --name osd.8 -- -f
[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
Copy to Clipboard Copied!
prepare-host
- 説明
-
cephadm
のホストを準備します。 - 構文
cephadm prepare-host [--expect-hostname HOSTNAME]
cephadm prepare-host [--expect-hostname HOSTNAME]
Copy to Clipboard Copied! - 例
cephadm prepare-host cephadm prepare-host --expect-hostname host01
[root@host01 ~]# cephadm prepare-host [root@host01 ~]# cephadm prepare-host --expect-hostname host01
Copy to Clipboard Copied!
pull
- 説明
- Ceph イメージをプルします。
- 構文
cephadm [-h] [--image IMAGE_ID] pull
cephadm [-h] [--image IMAGE_ID] pull
Copy to Clipboard Copied! - 例
cephadm --image 13ea90216d0be03003d12d7869f72ad9de5cec9e54a27fd308e01e467c0d4a0a pull
[root@host01 ~]# cephadm --image 13ea90216d0be03003d12d7869f72ad9de5cec9e54a27fd308e01e467c0d4a0a pull
Copy to Clipboard Copied!
registry-login
- 説明
- 認証されたレジストリーの cephadm ログイン情報を提供します。Cephadm はそのレジストリーに呼び出したホストのログ記録を試行します。
- 構文
cephadm registry-login --registry-url [REGISTRY_URL] --registry-username [USERNAME] --registry-password [PASSWORD] [--fsid FSID] [--registry-json JSON_FILE]
cephadm registry-login --registry-url [REGISTRY_URL] --registry-username [USERNAME] --registry-password [PASSWORD] [--fsid FSID] [--registry-json JSON_FILE]
Copy to Clipboard Copied! - 例
cephadm registry-login --registry-url registry.redhat.io --registry-username myuser1 --registry-password mypassword1
[root@host01 ~]# cephadm registry-login --registry-url registry.redhat.io --registry-username myuser1 --registry-password mypassword1
Copy to Clipboard Copied! また、以下のようにフォーマットされたログイン情報が含まれる JSON レジストリーファイルを使用することもできます。
- 構文
cat REGISTRY_FILE { "url":"REGISTRY_URL", "username":"REGISTRY_USERNAME", "password":"REGISTRY_PASSWORD" }
cat REGISTRY_FILE { "url":"REGISTRY_URL", "username":"REGISTRY_USERNAME", "password":"REGISTRY_PASSWORD" }
Copy to Clipboard Copied! - 例
cat registry_file { "url":"registry.redhat.io", "username":"myuser", "password":"mypass" } cephadm registry-login -i registry_file
[root@host01 ~]# cat registry_file { "url":"registry.redhat.io", "username":"myuser", "password":"mypass" } [root@host01 ~]# cephadm registry-login -i registry_file
Copy to Clipboard Copied!
rm-daemon
- 説明
-
特定のデーモンインスタンスを削除します。ホストで
cephadm rm-daemon
コマンドを直接実行すると、コマンドはデーモンを削除しますが、cephadm mgr
モジュールは、デーモンがないことを通知して再デプロイします。このコマンドは問題が含まれており、実験的な目的およびデバッグにのみ使用する必要があります。 - 構文
cephadm rm-daemon [--fsid FSID] [--name DAEMON_NAME] [--force ] [--force-delete-data]
cephadm rm-daemon [--fsid FSID] [--name DAEMON_NAME] [--force ] [--force-delete-data]
Copy to Clipboard Copied! - 例
cephadm rm-daemon --fsid f64f341c-655d-11eb-8778-fa163e914bcc --name osd.8
[root@host01 ~]# cephadm rm-daemon --fsid f64f341c-655d-11eb-8778-fa163e914bcc --name osd.8
Copy to Clipboard Copied!
rm-cluster
- 説明
-
実行先の特定のホストのストレージクラスターからすべてのデーモンを削除します。
rm-daemon
と同様に、この方法でいくつかのデーモンが削除され、Ceph Orchestrator は一時停止されず、これらのデーモンでマネージド外ではないサービスに所属するものがある場合は、cephadm
オーケストレーターにより、そこに再デプロイされます。 - 構文
cephadm rm-cluster [--fsid FSID] [--force]
cephadm rm-cluster [--fsid FSID] [--force]
Copy to Clipboard Copied! - 例
cephadm rm-cluster --fsid f64f341c-655d-11eb-8778-fa163e914bcc
[root@host01 ~]# cephadm rm-cluster --fsid f64f341c-655d-11eb-8778-fa163e914bcc
Copy to Clipboard Copied! 重要クラスターの削除実行の一環としてノードをより適切にクリーンアップするために、
cephadm rm-cluster
コマンドの実行時に/var/log/ceph
ディレクトリーの下のクラスターログが削除されます。--keep-logs
がrm-cluster
コマンドに指定されていない限り、クラスターログは削除されます。注記ホストが Cephadm によって管理され、Cephadm Manager モジュールが有効になって実行されている既存のクラスタの一部であるホストで
cephadm rm-cluster
コマンドを実行すると、Cephadm がすぐに新しいデーモンのデプロイを開始し、さらにログが表示される可能性があります。これを回避するには、クラスターをパージする前に cephadm mgr モジュールを無効にします。ceph mgr module disable cephadm
# ceph mgr module disable cephadm
Copy to Clipboard Copied!
rm-repo
- 説明
- パッケージリポジトリーの設定を削除します。これは主に Red Hat Ceph Storage の非接続インストールに使用されます。
- 構文
cephadm rm-repo [-h]
cephadm rm-repo [-h]
Copy to Clipboard Copied! - 例
cephadm rm-repo
[root@host01 ~]# cephadm rm-repo
Copy to Clipboard Copied!
run
- 説明
- フォアグラウンドのコンテナーで Ceph デーモンを実行します。
- 構文
cephadm run [--fsid FSID] --name DAEMON_NAME
cephadm run [--fsid FSID] --name DAEMON_NAME
Copy to Clipboard Copied! - 例
cephadm run --fsid f64f341c-655d-11eb-8778-fa163e914bcc --name osd.8
[root@host01 ~]# cephadm run --fsid f64f341c-655d-11eb-8778-fa163e914bcc --name osd.8
Copy to Clipboard Copied!
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]
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]
Copy to Clipboard Copied! - 例
cephadm shell -- ceph orch ls cephadm shell
[root@host01 ~]# cephadm shell -- ceph orch ls [root@host01 ~]# cephadm shell
Copy to Clipboard Copied!
unit
- 説明
-
この操作でデーモンを起動、停止、再起動、有効化、および無効にします。これは、デーモンの
systemd
ユニットで動作します。 - 構文
cephadm unit [--fsid FSID] --name DAEMON_NAME start/stop/restart/enable/disable
cephadm unit [--fsid FSID] --name DAEMON_NAME start/stop/restart/enable/disable
Copy to Clipboard Copied! - 例
cephadm unit --fsid f64f341c-655d-11eb-8778-fa163e914bcc --name osd.8 start
[root@host01 ~]# cephadm unit --fsid f64f341c-655d-11eb-8778-fa163e914bcc --name osd.8 start
Copy to Clipboard Copied!
version
- 説明
- ストレージクラスターのバージョンを提供します。
- 構文
cephadm version
cephadm version
Copy to Clipboard Copied! - 例
cephadm version
[root@host01 ~]# cephadm version
Copy to Clipboard Copied!