nodetool repair_admin — 증분 복구 세션 관리

nodetool repair_admin — 증분 복구 세션 관리

repair_admin 명령은 증분 복구(incremental repair) 세션을 나열하고 실패시키는 nodetool 명령이에요. 복구 세션의 목록/취소/정리 및 요약을 관리합니다.

출처: nodetool repair_admin

본문

이 명령은 증분 복구 세션을 관리하는 하위 명령(list, cancel, cleanup, summarize-pending, summarize-repaired)을 제공해요. 인자 없이 실행하면 복구 세션 목록을 보여 줍니다.

원문의 사용법은 다음과 같습니다.

NAME
        nodetool repair_admin - list and fail incremental repair sessions
SYNOPSIS
        nodetool [(-h <host> | --host <host>)]
                [(-pwf <passwordFilePath> | --password-file <passwordFilePath>)]
                [(-u <username> | --username <username>)] [(-pp | --print-port)]
                [(-p <port> | --port <port>)] [(-pw <password> | --password <password>)]
                repair_admin
        nodetool [(-h <host> | --host <host>)]
                [(-pwf <passwordFilePath> | --password-file <passwordFilePath>)]
                [(-u <username> | --username <username>)] [(-pp | --print-port)]
                [(-p <port> | --port <port>)] [(-pw <password> | --password <password>)]
                repair_admin cancel [(-f | --force)]
                (-s <session> | --session <session>)
        nodetool [(-h <host> | --host <host>)]
                [(-pwf <passwordFilePath> | --password-file <passwordFilePath>)]
                [(-u <username> | --username <username>)] [(-pp | --print-port)]
                [(-p <port> | --port <port>)] [(-pw <password> | --password <password>)]
                repair_admin cleanup [(-et <end_token> | --end-token <end_token>)]
                [(-st <start_token> | --start-token <start_token>)] [(-f | --force)]
        nodetool [(-h <host> | --host <host>)]
                [(-pwf <passwordFilePath> | --password-file <passwordFilePath>)]
                [(-u <username> | --username <username>)] [(-pp | --print-port)]
                [(-p <port> | --port <port>)] [(-pw <password> | --password <password>)]
                repair_admin list [(-a | --all)]
                [(-et <end_token> | --end-token <end_token>)]
                [(-st <start_token> | --start-token <start_token>)]
        nodetool [(-h <host> | --host <host>)]
                [(-pwf <passwordFilePath> | --password-file <passwordFilePath>)]
                [(-u <username> | --username <username>)] [(-pp | --print-port)]
                [(-p <port> | --port <port>)] [(-pw <password> | --password <password>)]
                repair_admin summarize-pending
                [(-et <end_token> | --end-token <end_token>)] [(-v | --verbose)]
                [(-st <start_token> | --start-token <start_token>)]
        nodetool [(-h <host> | --host <host>)]
                [(-pwf <passwordFilePath> | --password-file <passwordFilePath>)]
                [(-u <username> | --username <username>)] [(-pp | --print-port)]
                [(-p <port> | --port <port>)] [(-pw <password> | --password <password>)]
                repair_admin summarize-repaired
                [(-et <end_token> | --end-token <end_token>)] [(-v | --verbose)]
                [(-st <start_token> | --start-token <start_token>)]
OPTIONS
        -h <host>, --host <host>
            Node hostname or ip address
        -p <port>, --port <port>
            Remote jmx agent port number
        -pp, --print-port
            Operate in 4.0 mode with hosts disambiguated by port number
        -pw <password>, --password <password>
            Remote jmx agent password
        -pwf <passwordFilePath>, --password-file <passwordFilePath>
            Path to the JMX password file
        -u <username>, --username <username>
            Remote jmx agent username
COMMANDS
        With no arguments, list repair sessions
        list
            list repair sessions
            With --all option, include completed and failed sessions
            With --end-token option, Use -et to specify a token at which repair
            range ends
            With --start-token option, Use -st to specify a token at which the
            repair range starts
        cancel
            cancel an incremental repair session. Use --force to cancel from a
            node other than the repair coordinator Attempting to cancel
            FINALIZED or FAILED sessions is an error.
            With --force option, Force a cancellation.
            With --session option, The session to cancel
        cleanup
            cleans up pending data from completed sessions. This happens
            automatically, but the command is provided for situations where it
            needs to be expedited. Use --force to cancel compactions that are
            preventing promotion
            With --end-token option, Use -et to specify a token at which repair
            range ends
            With --start-token option, Use -st to specify a token at which the
            repair range starts
            With --force option, Force a cleanup.
        summarize-pending
            report the amount of data marked pending repair for the given token
            range (or all replicated range if no tokens are provided
            With --end-token option, Use -et to specify a token at which repair
            range ends
            With --verbose option, print additional info
            With --start-token option, Use -st to specify a token at which the
            repair range starts
        summarize-repaired
            return the most recent repairedAt timestamp for the given token
            range (or all replicated ranges if no tokens are provided)
            With --end-token option, Use -et to specify a token at which repair
            range ends
            With --verbose option, print additional info
            With --start-token option, Use -st to specify a token at which the
            repair range starts

하위 명령을 하나씩 살펴볼게요.

  • list — 복구 세션을 나열해요. --all 옵션으로 완료·실패한 세션도 포함하고, --end-token/--start-token으로 범위를 지정할 수 있어요.
  • cancel — 증분 복구 세션을 취소해요. 복구 코디네이터가 아닌 노드에서 취소하려면 --force를 사용해요. FINALIZED 또는 FAILED 상태의 세션을 취소하는 것은 오류예요.
  • cleanup — 완료된 세션의 대기(pending) 데이터를 정리해요. 자동으로 이루어지지만 촉진(promotion)을 막는 컴팩션을 취소하려면 --force를 쓸 수 있어요.
  • summarize-pending — 주어진 토큰 범위에서 복구 대기(pending repair)로 표시된 데이터 양을 보고해요. 토큰이 없으면 모든 복제 범위를 대상으로 해요.
  • summarize-repaired — 주어진 토큰 범위의 최근 repairedAt 타임스탬프를 반환해요. 토큰이 없으면 모든 복제 범위를 대상으로 해요.

공통 연결 옵션은 다음과 같아요.

  • -h <host>, --host <host> — 대상 노드의 호스트명 또는 IP 주소를 지정해요.
  • -p <port>, --port <port> — 원격 JMX 에이전트 포트 번호를 지정해요.
  • -pp, --print-port — 호스트를 포트 번호로 구분하는 4.0 모드로 동작해요.
  • -pw <password>, --password <password> — 원격 JMX 에이전트 비밀번호를 지정해요.
  • -pwf <passwordFilePath>, --password-file <passwordFilePath> — JMX 비밀번호 파일의 경로를 지정해요.
  • -u <username>, --username <username> — 원격 JMX 에이전트 사용자 이름을 지정해요.

더 알아보기