chmaster

오브젝트의 마스터쉽을 전송합니다.
관련 개념
마스터쉽 관리
관련 참조
describe
syncreplica

적용

제품 명령 유형
MultiSite multiutil 하위 명령
플랫폼
UNIX®
Windows®

개요

chmaster

[ –cl/an clan-name ] [ –site site-name ] –fam/ily family-name
–u/ser username [–p/assword ] password
new-master-replica  { { entity-selector... | { –all[ –l/ong] |
–working/master } [ –f/orce obsolete-replica | –forceall] }
}

설명

이 명령은 한 복제본에서 다른 복제본으로 하나 이상의 오브젝트의 마스터쉽을 전송합니다. 현재 복제본만이 즉시 영향을 받습니다. 다른 복제본에는 업데이트 패킷의 정상 교환을 통해 마스터쉽 전송이 알려집니다.

제한

ID: 수퍼 유저 권한이 있어야 합니다.

마스터쉽: 현재 복제본이 오브젝트를 마스터해야 합니다. –force 또는 –forceall을 사용하면 이 제한이 대체되지만, 특별한 상황을 제외하고 이들 옵션을 사용해서는 안됩니다.

옵션 및 인수

클랜, 사이트 및 패밀리 지정

기본값
클랜: 이 사이트에서 복제된 첫 번째 클랜입니다. 이 호스트에 둘 이상의 dbset 연결이 등록된 경우 –clan이 필요합니다.

사이트: 현재 사이트. 이 호스트에 둘 이상의 사이트가 있는 경우 –site가 필요합니다.

패밀리: 기본값 없음. 사용자가 패밀리를 지정해야 합니다.

–cl/an clan-name
복제본 클랜의 이름입니다.
–site site-name
복제본 사이트의 이름입니다.
–fam/ily family-name
사용자 데이터베이스 패밀리: 사용자 데이터베이스가 작성될 때 부여된 데이터베이스 이름입니다.

스키마 저장소 패밀리: 패밀리 이름은 MASTR입니다. –workingmaster 옵션을 사용할 때 MASTR을 지정해야 합니다.

사용자 이름 및 비밀번호 지정

기본값
사용자 이름 및 비밀번호를 지정해야 합니다.
–u/ser user
수퍼 유저 권한을 갖는 사용자의 이름입니다.
–p/assword password
지정된 사용자와 연관된 비밀번호입니다.

새 마스터 복제본 지정

기본값
없음.
new-master-replica
마스터쉽을 전송하려는 복제본의 이름입니다.

오브젝트 지정

기본값
없음. 특정 오브젝트(entity-selector), 복제본의 모든 오브젝트(–all) 또는 작업 스키마 저장소를 지정해야 합니다.
entity-selector
마스터쉽을 변경하려는 오브젝트를 지정합니다. 다음 오브젝트의 마스터쉽을 변경할 수 있습니다.
오브젝트
구문
레코드
record-type:record-id
사용자 또는 그룹
user:username

group:group-name

공용 작업공간 항목
"workspace:Public Queries\folder-name\query-name"
개인용 작업공간 항목
"workspace:Personal Queries(username)\folder-name\query-name"
이름이 고유하지 않은 Stateless 레코드
record-type:record-id<keysite-name>
이름이 고유하지 않은 작업공간 항목
"workspace:query-name<keysite-name>"
이름이 고유하지 않은 사용자 또는 그룹
user:username<keysite-name>

group:group-name<keysite-name>

이름을 고유하게 만드는 방법에 대한 정보는 이 안내서의 "MultiSite 오퍼레이션 문제점 해결 - 이름 지정 충돌 해결"을 참조하십시오.

–a/ll [ –l/ong ]
–clan, –site–family로 지정하는 복제본에 있고 이 복제본의 지배를 받는 모든 오브젝트의 new-master-replica 마스터쉽으로 전송합니다. 오류가 발생하는 경우 명령이 계속되지만 완료한 후 모든 마스터쉽 변경이 성공하지는 않았음을 보고합니다.

–long을 사용하면 chmaster는 마스터쉽이 변경되는 오브젝트를 나열합니다.

주: 작업 스키마 저장소의 마스터쉽을 변경하려면 –workingmaster를 사용하십시오.
–working/master
작업 스키마 저장소의 마스터쉽을 사용자가 지정하는 사이트로 전송합니다. 작업 스키마 저장소의 사이트에서만 –workingmaster 옵션을 사용할 수 있습니다.

이 옵션을 사용할 때 –family MASTR을 지정해야 합니다.

–f/orce obsolete-replica
중요: –force 옵션을 잘못 사용하면 패밀리의 복제본 사이에 차이가 생길 수 있습니다.

–force를 사용하면 chmasterobsolete-replica로 지정되는 복제본에 있는 모든 오브젝트의 마스터쉽을 전송합니다. 복제본 obsolete-replica를 더 이상 사용할 수 없을 때만(예를 들어, 실수로 삭제되었을 때) 이 양식의 chmaster를 사용하십시오.

–forceall
중요: –forceall 옵션을 잘못 사용하면 패밀리의 복제본 사이에 차이가 생길 수 있습니다.

–forceall을 사용하면 chmaster는 현재 복제본이 해당 오브젝트를 마스터하지 않는 경우에도 오브젝트의 마스터쉽을 지정된 복제본으로 전송합니다.

예제

이들 예제에서 행은 읽기 쉽도록 구분되어 있습니다. 실제로는 한 행에 명령을 입력해야 합니다.

  • boston_hub 복제본에서 sanfran_hub로 사용자 admin의 마스터쉽을 전송하십시오.

    multiutil chmaster -clan telecomm -site boston_hub -family DEV -user
    susan -p passwd sanfran_hub user:admin

    Multiutil: The mastership of record 'admin' of type 'user' has been
    changed from 'BOSTON_HUB' to 'SANFRAN_HUB'.
    Multiutil: The mastership of some users or groups has been transferred
    from this site. The local user administrator must update user
    databases at the new mastering site 'sanfran_hub' before these changes
    will be visible to any user database.

  • 작업 스키마 저장소를 포함하는 tokyo 복제본에서, 모든 스키마 및 작업 스키마 저장소 태스크의 마스터쉽을 sydney 복제본으로 전송하십시오.

    multiutil chmaster -clan testclan -site tokyo -family MASTR
    -user masako -p passwd sydney -workingmaster

    Multiutil: The working master has been changed from 'TOKYO' to 'SYDNEY'.

  • sanfran_hub 복제본이 마스터하는 DEV 데이터베이스의 모든 오브젝트의 마스터쉽을 boston_hub 복제본으로 전송하십시오.

    multiutil chmaster -clan telecomm -site sanfran_hub -family DEV
    -user jcole -p passwd boston_hub -all

    Multiutil: Total number of objects changed: 5.

  • 앞의 예제와 비슷하지만 –long 옵션을 사용하십시오.

    multiutil chmaster -clan telecomm -site sanfran_hub -family DEV
    -user jcole -p passwd boston_hub -all -long

    Multiutil: The mastership(s) of the following object(s) in database
    'DEV' was(were) changed from 'SANFRAN_HUB' to 'BOSTON_HUB'.

    Multiutil: Type: customer, display Name: John Smith.
    Multiutil: Type: customer, display Name: Ethan Hunt.
    Multiutil: Type: customer, display Name: Jane Smith.
    Multiutil: Type: customer, display Name: Anne Johnson.
    Multiutil: Type: customer, display Name: Joe Lee.

  • boston_hub 복제본에서, bangalore 복제본이 마스터하는 모든 항목의 마스터쉽을 boston_hub 복제본으로 전송하십시오. bangalore를 더 이상 사용할 수 없다고 가정하십시오.

    multiutil chmaster -clan telecomm -site boston_hub -family DOC
    -user susan -password passwd boston_hub -all -force bangalore

    bangalore 스키마 저장소의 사용자 및 그룹의 마스터쉽을 boston_hub로 변경하십시오.

    multiutil chmaster -clan telecomm -site boston_hub -family MASTR
    -user susan -password passwd boston_hub -all -force bangalore

    작업 스키마 저장소의 마스터쉽을 bangalore에서 boston_hub로 변경하십시오.

    multiutil chmaster -clan telecomm -site boston_hub -family MASTR
    -user susan -password passwd boston-hub -workingmaster -force bangalore

  • boston_hub에서 –forceall을 사용하여 사용자 admin의 마스터쉽을 sanfran_hub에서 tokyo로 변경하십시오.

    multiutil chmaster -clan telecomm -site boston_hub -family DEV
    -user susan -p passwd tokyo user:admin –forceall

    Multiutil: The mastership of record 'admin' of type 'user' has
    been changed from 'SANFRAN_HUB' to 'TOKYO'.


피드백