부록 B. cephadm 명령
cephadm
은 Cephadm Orchestrator의 로컬 호스트를 관리하는 명령줄 도구입니다. 현재 호스트의 상태를 조사하고 수정하는 명령을 제공합니다.
일부 명령은 일반적으로 디버깅에 사용됩니다.
참고
모든 호스트에 cephadm
이 필요하지는 않지만 특정 데몬을 조사할 때 유용합니다. cephadm-ansible-preflight
플레이북에서는 모든 호스트에 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]
Copy to clipboardCopiedcephadm adopt [-h] --name DAEMON_NAME --style STYLE [--cluster CLUSTER] --legacy-dir [LEGACY_DIR] --config-json CONFIG_JSON] [--skip-firewalld] [--skip-pull]
- 예제
cephadm adopt --style=legacy --name prometheus.host02
Copy to clipboardCopied[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]
Copy to clipboardCopiedcephadm 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 --fsid f64f341c-655d-11eb-8778-fa163e914bcc
Copy to clipboardCopied[root@nhost01 ~]# cephadm ceph-volume inventory --fsid f64f341c-655d-11eb-8778-fa163e914bcc
check-host
- 설명
- Ceph 클러스터에 적합한 호스트 구성을 확인합니다.
- 구문
cephadm check-host [--expect-hostname HOSTNAME]
Copy to clipboardCopiedcephadm check-host [--expect-hostname HOSTNAME]
- 예제
cephadm check-host --expect-hostname host02
Copy to clipboardCopied[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]
Copy to clipboardCopiedcephadm 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 mon --fsid f64f341c-655d-11eb-8778-fa163e914bcc
Copy to clipboardCopied[root@host01 ~]# cephadm shell deploy mon --fsid f64f341c-655d-11eb-8778-fa163e914bcc
Enter
- 설명
- 실행 중인 데몬 컨테이너 내에서 대화형 쉘을 실행합니다.
- 구문
cephadm enter [-h] [--fsid FSID] --name NAME [command [command …]]
Copy to clipboardCopiedcephadm enter [-h] [--fsid FSID] --name NAME [command [command …]]
- 예제
cephadm enter --name 52c611f2b1d9
Copy to clipboardCopied[root@host01 ~]# cephadm enter --name 52c611f2b1d9
help
- 설명
-
cephadm
에서 지원하는 모든 명령을 확인합니다. - 구문
cephadm help
Copy to clipboardCopiedcephadm help
- 예제
cephadm help
Copy to clipboardCopied[root@host01 ~]# cephadm help
install
- 설명
- 패키지를 설치합니다.
- 구문
cephadm install PACKAGES
Copy to clipboardCopiedcephadm install PACKAGES
- 예제
cephadm install ceph-common ceph-osd
Copy to clipboardCopied[root@host01 ~]# cephadm install ceph-common ceph-osd
inspect-image
- 설명
- 로컬 Ceph 컨테이너 이미지를 검사합니다.
- 구문
cephadm --image IMAGE_ID inspect-image
Copy to clipboardCopiedcephadm --image IMAGE_ID inspect-image
- 예제
cephadm --image 13ea90216d0be03003d12d7869f72ad9de5cec9e54a27fd308e01e467c0d4a0a inspect-image
Copy to clipboardCopied[root@host01 ~]# cephadm --image 13ea90216d0be03003d12d7869f72ad9de5cec9e54a27fd308e01e467c0d4a0a inspect-image
list-networks
- 설명
- IP 네트워크를 나열합니다.
- 구문
cephadm list-networks
Copy to clipboardCopiedcephadm list-networks
- 예제
cephadm list-networks
Copy to clipboardCopied[root@host01 ~]# cephadm list-networks
ls
- 설명
-
호스트의
cephadm
에 알려진 데몬 인스턴스를 나열합니다. 명령에--no-detail
을 사용하면 데몬 이름, fsid, 스타일 및 데몬당 systemd 단위에 대한 세부 정보를 제공하는 명령에 --no-detail을 사용할 수 있습니다.--legacy-dir
옵션을 사용하여 데몬을 검색할 기존 기본 디렉터리를 지정할 수 있습니다. - 구문
cephadm ls [--no-detail] [--legacy-dir LEGACY_DIR]
Copy to clipboardCopiedcephadm ls [--no-detail] [--legacy-dir LEGACY_DIR]
- 예제
cephadm ls --no-detail
Copy to clipboardCopied[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
Copy to clipboardCopiedcephadm 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 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
Copy to clipboardCopied[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]
Copy to clipboardCopiedcephadm prepare-host [--expect-hostname HOSTNAME]
- 예제
cephadm prepare-host cephadm prepare-host --expect-hostname host01
Copy to clipboardCopied[root@host01 ~]# cephadm prepare-host [root@host01 ~]# cephadm prepare-host --expect-hostname host01
pull
- 설명
- Ceph 이미지를 가져옵니다.
- 구문
cephadm [-h] [--image IMAGE_ID] pull
Copy to clipboardCopiedcephadm [-h] [--image IMAGE_ID] pull
- 예제
cephadm --image 13ea90216d0be03003d12d7869f72ad9de5cec9e54a27fd308e01e467c0d4a0a pull
Copy to clipboardCopied[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]
Copy to clipboardCopiedcephadm registry-login --registry-url [REGISTRY_URL] --registry-username [USERNAME] --registry-password [PASSWORD] [--fsid FSID] [--registry-json JSON_FILE]
- 예제
cephadm registry-login --registry-url registry.redhat.io --registry-username myuser1 --registry-password mypassword1
Copy to clipboardCopied[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" }
Copy to clipboardCopiedcat REGISTRY_FILE { "url":"REGISTRY_URL", "username":"REGISTRY_USERNAME", "password":"REGISTRY_PASSWORD" }
- 예제
cat registry_file { "url":"registry.redhat.io", "username":"myuser", "password":"mypass" } cephadm registry-login -i registry_file
Copy to clipboardCopied[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]
Copy to clipboardCopiedcephadm rm-daemon [--fsid FSID] [--name DAEMON_NAME] [--force ] [--force-delete-data]
- 예제
cephadm rm-daemon --fsid f64f341c-655d-11eb-8778-fa163e914bcc --name osd.8
Copy to clipboardCopied[root@host01 ~]# cephadm rm-daemon --fsid f64f341c-655d-11eb-8778-fa163e914bcc --name osd.8
rm-cluster
- 설명
-
특정 호스트가 실행되는 특정 호스트의 스토리지 클러스터에서 모든 데몬을 제거합니다.
rm-daemon
과 유사하게 이러한 방식으로 데몬을 제거하고 Ceph Orchestrator가 일시 중지되지 않고 일부 데몬이 관리되지 않는 서비스에 속하는 경우cephadm
orchestrator는 해당 데몬을 다시 배포합니다. - 구문
cephadm rm-cluster [--fsid FSID] [--force]
Copy to clipboardCopiedcephadm rm-cluster [--fsid FSID] [--force]
- 예제
cephadm rm-cluster --fsid f64f341c-655d-11eb-8778-fa163e914bcc
Copy to clipboardCopied[root@host01 ~]# cephadm rm-cluster --fsid f64f341c-655d-11eb-8778-fa163e914bcc
rm-repo
- 설명
- 패키지 리포지토리 구성을 제거합니다. 이는 주로 Red Hat Ceph Storage의 연결이 끊어진 설치에 사용됩니다.
- 구문
cephadm rm-repo [-h]
Copy to clipboardCopiedcephadm rm-repo [-h]
- 예제
cephadm rm-repo
Copy to clipboardCopied[root@host01 ~]# cephadm rm-repo
run
- 설명
- 컨테이너에서 Ceph 데몬을 foreground에서 실행합니다.
- 구문
cephadm run [--fsid FSID] --name DAEMON_NAME
Copy to clipboardCopiedcephadm run [--fsid FSID] --name DAEMON_NAME
- 예제
cephadm run --fsid f64f341c-655d-11eb-8778-fa163e914bcc --name osd.8
Copy to clipboardCopied[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]
Copy to clipboardCopiedcephadm 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 -- ceph orch ls cephadm shell
Copy to clipboardCopied[root@host01 ~]# cephadm shell -- ceph orch ls [root@host01 ~]# cephadm shell
단위
- 설명
-
이 작업을 사용하여 데몬을 시작, 중지, 다시 시작, 활성화 및 비활성화합니다. 데몬의
systemd
장치에서 작동합니다. - 구문
cephadm unit [--fsid FSID] --name DAEMON_NAME start/stop/restart/enable/disable
Copy to clipboardCopiedcephadm unit [--fsid FSID] --name DAEMON_NAME start/stop/restart/enable/disable
- 예제
cephadm unit --fsid f64f341c-655d-11eb-8778-fa163e914bcc --name osd.8 start
Copy to clipboardCopied[root@host01 ~]# cephadm unit --fsid f64f341c-655d-11eb-8778-fa163e914bcc --name osd.8 start
version
- 설명
- 스토리지 클러스터의 버전을 제공합니다.
- 구문
cephadm version
Copy to clipboardCopiedcephadm version
- 예제
cephadm version
Copy to clipboardCopied[root@host01 ~]# cephadm version