wsadmin 스크립트를 사용하는 AdminTask 오브젝트의 RepositoryCheckpointCommands 명령 그룹

Jython 또는 Jacl 스크립트 언어를 사용하여 wsadmin 도구로 체크포인트를 작성, 복원, 삭제 및 관리할 수 있습니다. 저장소 체크포인트는 구성이 변경되기 전에 저장소의 저장된 이미지를 나타냅니다. RepositoryCheckpointCommands 그룹의 명령은 wsadmin 로컬 모드와 연결 모드에서 저장소 체크포인트 기능을 지원합니다.

마스터 구성 저장소에서 파일 사본을 백업하도록 체크포인트를 구성할 수 있습니다. 전체 체크포인트는 전체 구성 저장소의 전체 사본입니다. 델타 체크포인트는 제품 구성을 변경할 때 작성되는 구성 저장소에 대한 서브세트 스냅샷입니다. 체크포인트를 사용하여 구성 저장소를 다시 이전 상태로 복원할 수 있습니다.

자동 체크포인트를 사용으로 설정하려면 setAutoCheckpointEnabled 명령을 사용하고 -autoCheckpointEnabled를 true로 설정하십시오. 구성 저장소에서 변경된 사항이 있을 때마다 델타 체크포인트가 작성됩니다. 이 명령을 실행한 후 서버를 다시 시작할 필요가 없습니다. 자동 체크포인트 기능이 사용으로 설정된 경우, 구성이 변경되어 구성 저장소에 저장되면 profile_root/checkpoints 디렉토리에 델타 체크포인트가 자동으로 작성됩니다. 구성 저장소는 profile_root/config 디렉토리에 저장됩니다. 애플리케이션 서버 작성, 구성 변경사항 저장 등의 조치를 수행하면 델타 체크포인트가 작성됩니다. 이 체크포인트는 구성이 변경되기 이전의 저장소 이미지를 보존합니다.

구성 저장소를 변경하는 명령을 실행하면 구성 변경사항이 자동으로 저장됩니다. 따라서 createFullCheckpoint, deleteCheckpoint, restoreCheckpoint, setAutoCheckpointDepth, setAutoCheckpointEnabled, setCheckpointLocation 등의 명령을 실행한 후 AdminConfig.save()를 실행할 필요가 없습니다.

createFullCheckpoint

createFullCheckpoint 명령을 사용하여 전체 체크포인트를 작성할 수 있습니다. -checkpointName 값을 제공하여 전체 체크포인트의 이름을 지정하십시오.

대상 오브젝트

없음

필수 매개변수

-checkpointName
전체 체크포인트의 이름을 지정합니다(문자열, 필수)

명령이 성공적으로 실행되면 -checkpointName 값이 리턴됩니다.

선택적 매개변수

-checkpointDesc
전체 체크포인트에 대한 설명을 지정합니다(문자열, 선택적)

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.createFullCheckpoint('[-checkpointName full2 -checkpointDesc "a test"]')
  • Jython 목록 사용:
    AdminTask.createFullCheckpoint(['-checkpointName', 'full2'])

대화식 모드 사용법 예제

  • Jython 사용:
    AdminTask.createFullCheckpoint('[-interactive]')

deleteCheckpoint

deleteCheckpoint 명령을 사용하여 -checkpointName 값으로 지정된 체크포인트를 삭제할 수 있습니다. 전체 체크포인트는 모두 삭제할 수 있습니다. 델타 체크포인트의 경우 가장 오래된 델타 체크포인트만 삭제할 수 있습니다.

대상 오브젝트

없음

필수 매개변수

-checkpointName
삭제할 체크포인트의 이름을 지정합니다. 삭제할 전체 체크포인트의 이름을 지정할 수 있습니다(문자열, 필수)
참고: 델타 체크포인트를 삭제하려면 가장 오래된 델타 체크포인트의 이름을 지정해야 합니다.

선택적 매개변수

없음

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.deleteCheckpoint('[-checkpointName full2]')
  • Jython 목록 사용:
    AdminTask.deleteCheckpoint(['-checkpointName', 'full2'])

대화식 모드 사용법 예제

  • Jython 사용:
    AdminTask.deleteCheckpoint('[-interactive]')

extractRepositoryCheckpoint

extractRepositoryCheckpoint 명령을 사용하여 델타 저장소 체크포인트를 추출할 수 있습니다. -checkpointName 값을 제공하여 추출할 저장소를 지정하고, -extractToFile 값을 제공하여 추출된 체크포인트 파일을 포함하는 압축 파일의 전체 경로 이름을 지정하십시오.

대상 오브젝트

없음

필수 매개변수

-checkpointName
추출할 저장소 체크포인트의 이름을 지정합니다델타 저장소 체크포인트만 추출할 수 있습니다. (문자열, 필수)
-extractToFile
저장소 체크포인트를 추출할 압축 파일의 이름 및 대상 위치를 지정합니다. 압축 파일 이름에 확장자로 .zip 또는 .jar가 사용되거나, 파일 이름에 확장자가 없을 수 있습니다(문자열, 필수)

선택적 매개변수

없음

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    [AIX][HP-UX][Linux][Solaris][z/OS]
    AdminTask.extractRepositoryCheckpoint('[-checkpointName Delta-132 -extractToFile /temp/test1.zip]')
    [Windows]
    AdminTask.extractRepositoryCheckpoint('[-checkpointName Delta-132 -extractToFile c:/temp/test1.zip]')
  • Jython 목록 사용:
    [AIX][HP-UX][Linux][Solaris][z/OS]
    AdminTask.extractRepositoryCheckpoint(['-checkpointName', 'Delta2', '-extractToFile', '/temp/test1.zip'])
    [Windows]
    AdminTask.extractRepositoryCheckpoint(['-checkpointName', 'Delta2', '-extractToFile', 'c:/temp/test1.zip'])

대화식 모드 사용법 예제

  • Jython 사용:
    AdminTask.extractRepositoryCheckpoint('[-interactive]')

getAutoCheckpointDepth

getAutoCheckpointDepth 명령을 사용하여 보존되는 자동 델타 체크포인트 수를 확인할 수 있습니다. 델타 체크포인트 수에 도달한 후 제품은 새로운 델타 체크포인트가 작성될 때마다 가장 오래된 델타 체크포인트를 삭제합니다. 이 명령은 보존할 자동 델타 체크포인트 수를 리턴합니다.

대상 오브젝트

없음

필수 매개변수

없음

선택적 매개변수

없음

사용법 예제

print AdminTask.getAutoCheckpointDepth()

getAutoCheckpointEnabled

getAutoCheckpointEnabled 명령을 사용하여 델타 체크포인트 자동 작성이 사용으로 설정되었는지 여부를 확인할 수 있습니다. 자동 체크포인트가 사용으로 설정된 경우 true가 리턴되고, 자동 체크포인트가 사용 안함으로 설정된 경우 false가 리턴됩니다.

대상 오브젝트

없음

필수 매개변수

없음

선택적 매개변수

없음

사용법 예제

print AdminTask.getAutoCheckpointEnabled()

getCheckpointLocation

getCheckpointLocation 명령을 사용하여 체크포인트가 저장되는 디렉토리 경로를 확인할 수 있습니다. 이 명령은 디렉토리 경로를 리턴합니다. 체크포인트는 profile_root/checkpoints 디렉토리에 저장됩니다.

대상 오브젝트

없음

필수 매개변수

없음

선택적 매개변수

없음

사용법 예제

print AdminTask.getCheckpointLocation()

getConfigRepositoryLocation

getConfigRepositoryLocation 명령을 사용하여 구성 저장소가 저장되는 디렉토리 경로를 확인할 수 있습니다. 이 명령은 디렉토리 경로를 리턴합니다. 구성 저장소는 profile_root/config 디렉토리에 저장됩니다.

대상 오브젝트

없음

필수 매개변수

없음

선택적 매개변수

없음

사용법 예제

print AdminTask.getConfigRepositoryLocation()

listCheckpoints

listCheckpoints 명령을 사용하여 기존 체크포인트 목록을 확인할 수 있습니다.

대상 오브젝트

없음

필수 매개변수

없음

선택적 매개변수

없음

사용법 예제

print AdminTask.listCheckpoints()

출력 예제

full1(cells/MyCell/repository/checkpoints/full1|checkpoint.xml)
Delta-1323948371187(cells/MyCell/repository/checkpoints/Delta-1323948371187|checkpoint.xml)
Delta-1323904606781(cells/MyCell/repository/checkpoints/Delta-1323904606781|checkpoint.xml)
Delta-1323904256625(cells/MyCell/repository/checkpoints/Delta-1323904256625|checkpoint.xml)

listCheckpointDocuments

listCheckpointDocuments 명령을 사용하여 체크포인트 저장소에 있는 문서 목록 확인할 수 있습니다. -checkpointName 값을 제공하여 문서 목록을 가져올 체크포인트를 지정하십시오.

대상 오브젝트

없음

필수 매개변수

-checkpointName
문서 목록을 검색할 체크포인트의 이름을 지정합니다(문자열, 필수)

선택적 매개변수

없음

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.listCheckpointDocuments('[-checkpointName Delta-132]')
  • Jython 목록 사용:
    AdminTask.listCheckpointDocuments(['-checkpointName', 'Delta-132'])

대화식 모드 사용법 예제

  • Jython 사용:
    AdminTask.listCheckpointDocuments('[-interactive]')

출력 예제

authorizationgroup.xml(cells/MyCell/repository/checkpoints/Delta-132|checkpoint.xml#CheckpointDocument_1325)
audit-authz.xml(cells/MyCell/repository/checkpoints/Delta-132|checkpoint.xml#CheckpointDocument_1326)
admin-authz.xml(cells/MyCell/repository/checkpoints/Delta-132|checkpoint.xml#CheckpointDocument_1327)

restoreCheckpoint

restoreCheckpoint 명령을 사용하여 체크포인트가 작성될 당시의 상태로 구성 저장소를 다시 복원할 수 있습니다. -checkpointName 값을 제공하여 복원할 전체 또는 델타 체크포인트를 지정하십시오.

전체 체크포인트가 작성된 시점의 상태로 전체 구성 저장소를 다시 복원하려면 전체 체크포인트를 사용합니다.

최근 변경사항을 실행 취소하려면 델타 체크포인트를 사용하십시오. 작성된 반대 순서로만 델타 체크포인트를 복원합니다. 각각의 델타 체크포인트에는 순서 번호가 있습니다. 가장 높은 순서 번호는 최근 델타 체크포인트를 나타냅니다. 따라서 내림차순 순서 번호로만 델타 체크포인트를 복원합니다.
참고: 구성 저장소가 델타 체크포인트에서 복원된 후 제품에서 복원 전의 구성을 포함하는 체크포인트를 작성합니다.
참고: 복원하려는 델타 체크포인트가 가장 오래 전에 저장된 체크포인트인 경우, 델타 체크포인트 수를 늘려야 할 수 있습니다. getAutoCheckpointDepth 명령을 실행하여 보존되는 델타 체크포인트 수를 확인할 수 있습니다. 델타 체크포인트 수에 도달한 후 제품은 새로운 델타 체크포인트가 작성될 때마다 가장 오래된 델타 체크포인트를 삭제합니다. 저장된 델타 체크포인트 수를 늘리려면 setAutoCheckpointDepth 명령을 사용하십시오.

체크포인트를 복원할 때 작업공간에서 변경사항을 커미트 취소한 경우 저장 충돌이 발생합니다. 체크포인트는 복원되지만 커미트 취소된 변경사항을 저장할 경우 해당 변경사항에 저장 충돌 플래그가 지정됩니다. 또한 둘 이상의 사용자가 저장소에 대한 구성 변경을 수행 중인 경우, 다른 사용자가 변경사항을 커미트하지 않은 경우와 한 사용자가 체크포인트 복원을 수행하는 경우 저장 충돌이 발생합니다.

대상 오브젝트

없음

필수 매개변수

-checkpointName
복원할 체크포인트의 이름을 지정합니다(문자열, 필수)

선택적 매개변수

없음

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.restoreCheckpoint('[-checkpointName Delta-132]')
  • Jython 목록 사용:
    AdminTask.restoreCheckpoint(['-checkpointName', 'Delta-132'])

대화식 모드 사용법 예제

  • Jython 사용:
    AdminTask.restoreCheckpoint('[-interactive]')

setAutoCheckpointDepth

setAutoCheckpointDepth 명령을 사용하여 보존할 델타 체크포인트 수를 지정할 수 있습니다. 저장된 델타 체크포인트 수가 지정된 체크포인트 깊이를 초과하면 지정된 체크포인트 깊이를 초과하지 않도록 가장 오래된 델타 체크포인트가 삭제됩니다.

대상 오브젝트

없음

필수 매개변수

-autoCheckpointDepth
보존할 자동 델타 체크포인트 수를 지정합니다(정수, 필수)

선택적 매개변수

없음

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.setAutoCheckpointDepth('[-autoCheckpointDepth 5]')
  • Jython 목록 사용:
    AdminTask.setAutoCheckpointDepth(['-autoCheckpointDepth', '5'])

대화식 모드 사용법 예제

  • Jython 사용:
    AdminTask.setAutoCheckpointDepth('[-interactive]')

setAutoCheckpointEnabled

setAutoCheckpointEnabled 명령을 사용하여 자동 델타 체크포인트를 사용 또는 사용 안함으로 설정할 수 있습니다. 자동 저장소 체크포인트가 사용으로 설정된 경우, 구성 저장소에서 변경된 사항이 있을 때마다 델타 체크포인트가 작성됩니다. 델타 체크포인트 압축 파일에는 구성 파일의 변경 이전 및 이후 버전이 포함되어 있습니다. 압축 파일의 컨텐츠를 추출한 다음 추출된 파일에서 구성 변경사항을 판별할 수 있습니다.

setAutoCheckpointEnabled를 실행한 후 설정 변경사항을 적용하기 위해 서버를 다시 시작할 필요가 없습니다.

대상 오브젝트

없음

필수 매개변수

-autoCheckpointEnabled
구성 변경 이전의 제품 구성을 자동으로 저장소 체크포인트에 저장할지 여부를 지정합니다. true 값을 지정할 경우 자동 체크포인트가 사용으로 설정됩니다. 기본값인 false를 지정할 경우 자동 체크포인트가 사용 안함으로 설정됩니다(부울, 필수)

선택적 매개변수

없음

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.setAutoCheckpointEnabled('[-autoCheckpointEnabled true]')
  • Jython 목록 사용:
    AdminTask.setAutoCheckpointEnabled(['-autoCheckpointEnabled', 'true'])

대화식 모드 사용법 예제

  • Jython 사용:
    AdminTask.setAutoCheckpointEnabled('[-interactive]')

setCheckpointLocation

setCheckpointLocation 명령을 사용하여 체크포인트가 저장되는 디렉토리 경로를 설정할 수 있습니다. 기본적으로 체크포인트는 profile_root/checkpoints 디렉토리에 저장됩니다.

대상 오브젝트

없음

필수 매개변수

-checkpointLocation
체크포인트가 저장되는 디렉토리 경로를 지정합니다(문자열, 필수)

선택적 매개변수

없음

일괄처리 모드 사용법 예제

  • Jython 문자열 사용:
    AdminTask.setCheckpointLocation('[-checkpointLocation ${USER_INSTALL_ROOT}/checkpoints/temp]')
  • Jython 목록 사용:
    AdminTask.setCheckpointLocation(['-checkpointLocation', '${USER_INSTALL_ROOT}/checkpoints/temp'])

대화식 모드 사용법 예제

  • Jython 사용:
    AdminTask.setCheckpointLocation('[-interactive]')

주제 유형을 표시하는 아이콘 참조 주제



시간소인 아이콘 마지막 업데이트 날짜: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_checkpoint_repository
파일 이름:rxml_checkpoint_repository.html