이 장에서는 DIVAnet의 DIVArchive API 지원에 대해 살펴보고 DIVArchive API를 사용해서 DIVAnet 특정 정보를 제공하는 방법에 대한 정보를 제공합니다. 이 장은 DIVArchive C++ API, DIVArchive Java API 또는 DIVArchive Web Service API 설명서와 함께 사용해야 합니다.
DIVAnet은 전체 DIVArchive API 명령 세트의 하위 세트를 지원합니다. 일부 DIVArchive API 명령(예: EjectTape)은 DIVAnet MultiDiva 모드에서 거부됩니다. DIVAnet 2.1은 DIVArchive API 클라이언트 릴리스 7.3 이하의 클라이언트 연결을 지원합니다. 7.3 이후에 API에 추가된 새로운 기능은 DIVAnet 2.1에서 지원되지 않습니다.
DIVAnet 서버에 대한 DIVA API 호출은 DIVArchive에 대한 호출과 대부분 동일합니다. 하지만 DIVAnet이 일부 경우에 잘 알려진 DIVA API 매개변수를 약간 다른 방식으로 수락하는 일부 차이점이 있습니다. 또한 DIVAnet에서 반환되는 필드 내용이 DIVArchive와 조금 다르거나, 형식이 다를 수 있습니다. 이 절에서는 이러한 차이점에 대해 설명합니다.
DIVAnet 2.1은 연결된 DIVArchive 사이트가 DIVArchive 7.3.1 이상으로 설치되어 있어야 합니다. 그런 다음에는 DIVAnet을 업그레이드할 필요 없이 DIVArchive 사이트를 독립적으로 업그레이드할 수 있습니다.
이 절에서는 아카이브, 복원, 삭제 및 복사를 포함해서 아카이브된 컨텐츠의 전송(또는 삭제)과 관련된 요청에 대해 설명합니다. 이러한 명령은 DIVArchive API를 통해 호출할 수 있습니다. 일부는 DIVAnetUI에서 호출할 수도 있습니다. DIVArchive API 내의 각 명령이 수행하는 기능에 대한 자세한 내용은 Oracle DIVArchive C++ API Reference Manual을 참조하십시오.
주:
DIVAnet MultiDiva 모드에서 DIVAnet 요청에는 DIVArchive에 대해 직접 실행된 요청에 필요하지 않은 일부 정보가 필요할 수 있습니다.DIVAnet 요청에는 지원되는 기능으로 인해 추가 정보가 필요한 경우가 자주 있습니다. 예를 들어, DIVAnet의 복사 명령을 사용하면 한 DIVA 시스템에서 다른 시스템으로 컨텐츠를 복사할 수 있습니다. DIVAnet은 최소한 대상 사이트가 무엇인지 알아야 합니다. 하지만 DIVA API CopyToGroup 명령은 target site 매개변수를 포함하지 않습니다. 아래 절에서는 이러한 추가 정보를 지정하는 방법에 대해 자세히 설명합니다. DIVAnet MultiDiva 모드 구성에 대한 자세한 내용은 클라이언트 API 포트 구성을 참조하십시오.
테이블 7-1에서는 DIVAnet에서 지원되는 DIVArchive API 컨텐츠 요청을 보여줍니다. 이러한 요청을 실행하는 클라이언트에는 요청 상태를 주기적으로 질의할 수 있는 요청 ID가 제공됩니다.
테이블 7-1 지원되는 DIVArchive 컨텐츠 요청
| 요청 |
DIVAnet의 동작 |
|---|---|
|
Archive |
로컬 DIVArchive 사이트 또는 다른 선택한 사이트(선택사항)로 아카이브합니다. 자세한 내용은 아카이브 요청을 참조하십시오. |
|
Restore Restore Instance |
아카이브된 객체를 특정 Source/Destination에 복원합니다. 특정 인스턴스 및(또는) 특정 사이트를 복원 소스 컨텐츠로 사용할 수 있습니다. DIVAnet은 (1) 로컬 DIVArchive에서 객체를 복원할지, (2) 원격 DIVArchive를 사용해서 객체를 직접 복원할지 또는 (3) 원격 DIVArchive에서 객체를 가져와서 선택한 Source/Destination으로 전송할지를 결정합니다. Restore Instance는 특정 사이트의 특정 인스턴스를 복원할 수 있게 해줍니다. 오류가 발생하면 다른 사이트에서 재시도하도록 DIVAnet을 구성할 수 있습니다. 자세한 내용은 복원 요청을 참조하십시오. |
|
Partial Restore Partial Restore Instance |
전체 복원과 비슷한 방법으로 객체를 부분적으로 복원합니다. 부분 파일 복원에는 특정 인스턴스(특정 사이트에 있는)를 소스로 사용할 수 있습니다. 원격 시스템에서 부분 파일 복원을 실행할 경우, 로컬 사이트와 비슷한 방식으로 부분 복원에 맞게 DIVA 사이트를 구성해야 합니다. 자세한 내용은 Oracle Partial File Restore 요청을 참조하십시오. |
|
Copy(CopyToGroup) |
한 DIVA 사이트에서 다른 사이트로 컨텐츠를 복사하거나(사이트 간 복사), 객체의 또 다른 인스턴스를 DIVA 사이트에 만듭니다(단일 DIVA 시스템에서 특정 인스턴스를 대상 사이트에 복사할 수 있습니다. 자세한 내용은 복사 요청을 참조하십시오. |
|
Delete DeleteInstance |
모든 사이트나 특정 사이트에서 컨텐츠를 삭제하거나 특정 사이트에서 특정 인스턴스를 삭제합니다. 삭제할 객체가 사이트에서 잠겨 있는 경우 지정된 기간 동안 재시도하도록 DIVAnet을 구성할 수 있습니다. 자세한 내용은 삭제 요청을 참조하십시오. |
아카이브 요청은 호출자가 특정 Source/Destination(DIVArchive에 구성됨)에 존재하는 컨텐츠를 아카이브할 수 있도록 허용합니다. DIVA API는 Source/Destination에서 DIVArchive로 전송이 수행되도록 준비합니다. 이러한 API는 컨텐츠가 HTTPS를 통해 요청자로부터 직접 전송되는 웹 기반 클라우드 API와 다릅니다. 기본적으로 DIVAnet은 로컬 사이트로 아카이브합니다.
DIVAnet에 대해 실행되는 아카이브 요청은 DIVArchive로 직접 실행되는 요청과 비슷하지만 Target Sitename에 몇 가지 특성이 추가되었습니다. DIVArchive 사이트에서는 사용자가 컨텐츠를 아카이브합니다. 일반적으로 DIVAnet은 로컬 사이트로 아카이브합니다. 하지만 다음 두 가지 방법 중 하나로 다른 사이트로 직접 아카이브할 수 있습니다.
옵션 필드에 -site [sitename] 옵션을 제공합니다. 예: -site diva1.
아카이브 요청에서 매체 매개변수에 대상 사이트 이름을 접두어로 추가합니다. 예를 들어, sitename1_TapeGroup1은 sitename1이라는 대상 사이트와 TapeGroup1 매체를 나타냅니다.
DIVAnet은 아카이브 명령에 대해 연속 재시도를 지원하지 않지만, BackupArchiveSite 옵션을 지원합니다. 이 옵션은 주 사이트가 작동 중지되었을 때를 대비해서 대체 아카이브 사이트를 제공합니다.
복원 요청은 클라이언트가 아카이브 시스템에 존재하는 컨텐츠를 복원할 수 있게 해줍니다. 컨텐츠는 요청에서 선택된 특정 Source/Destination에 도착합니다. DIVA API는 DIVArchive 사이트에서 Source/Destination(예: FTP 또는 CIF 디스크)으로의 직접 전송을 준비합니다. 이러한 API는 컨텐츠가 HTTPS를 통해 요청자로 직접 전송되는 웹 기반 클라우드 API와 다릅니다.
DIVAnet을 사용해서 컨텐츠를 복원할 때 호출자는 해당 컨텐츠를 갖고 있는 특정 DIVA 시스템을 알 필요가 없습니다. 그리고 한 DIVA 사이트에서 컨텐츠를 검색할 때 오류가 발생하면 다른 DIVA 사이트를 자동으로 참조해서 컨텐츠를 검색할 수 있습니다.
DIVAnet은 DIVAnet 사이트에서 Source/Destination으로 복원을 지원합니다. DIVAnet은 요청을 충족시키기 위해 필요에 따라 다른 사이트에서 컨텐츠를 검색하고, 결과적으로 컨텐츠를 대상 Source/Destination으로 전송합니다.
DIVAnet에 대해 실행되는 복원 요청은 DIVArchive로 직접 실행되는 요청과 비슷하지만, 몇 가지 추가사항이 있습니다. 일반적으로 DIVAnet은 복원할 최적의 사이트를 선택합니다. 그러나 DIVAnet을 사용할 경우 복원에 사용할 특정 사이트를 클라이언트가 지정할 수 있습니다. 이를 수행하는 방법에는 몇 가지가 있습니다.
-site: 일반적으로 DIVAnet은 복원할 사이트를 선택합니다. 하지만 요청의 옵션 필드에 -site [sitename] 옵션을 제공하여 특정 사이트로부터 복원을 시도할 수 있습니다. 선택된 사이트에 컨텐츠가 실제로 존재하지 않으면 작업이 실패합니다.
Instance Id: 소스에 대해 완전한 제어가 필요한 경우에는 복원 요청에 인스턴스 번호를 제공할 수 있습니다. 이렇게 하면 소스 사이트를 선택하고, 복원을 수행할 DIVA 인스턴스를 선택할 수 있습니다(다음 절 참조). 인스턴스 ID는 getObjectInfo() API 호출을 수행하거나 DIVAnet UI에서 객체를 확인하여 얻을 수 있습니다.
두 경우 모두 재시도는 사용 안함으로 설정됩니다.
복원 요청을 충족시키기 위해 DIVAnet은 테이블 7-2의 복원 방법을 사용합니다. DIVAnet은 대상 Source/Destination 및 소스 객체와 같은 매개변수를 기준으로 사용할 복원 워크플로우를 동적으로 선택합니다. 복원에 사용할 사이트를 결정하기 위해 DIVAnet은 다음과 같은 일련의 항목을 질문합니다.
로컬 DIVArchive 시스템에서 객체를 사용할 수 있습니까?
객체에 디스크 인스턴스가 포함됩니까?
Source/Destination을 원격 DIVArchive 시스템에서 액세스할 수 있습니까?
Source/Destination을 로컬 사이트에서 액세스할 수 있습니까?
DIVArchive가 소스 또는 대상 사이트에서 실행됩니까?
구성 파일에서 다른 사이트에 비해 선호되는 사이트가 있습니까?
| 방법 |
설명 |
|---|---|
|
로컬 |
객체가 로컬 사이트에 존재할 경우에 사용됩니다. 로컬 사이트는 사용자가 메시지를 전송하는 DIVArchive 시스템 사이트 이름입니다. 로컬 DIVArchive 시스템은 또한 로컬 사이트의 일부로 간주됩니다. |
|
직접 원격 |
DIVAnet은 원격 DIVA 시스템이 복원 작업을 수행하도록 준비할 수 있습니다. 이러한 준비는 대상 Source/Destination이 원격 DIVA 시스템에도 구성된 경우에만 수행됩니다. Source/Destination은 이름이 일치해야 하며, 두 항목 모두 동일한 서버 또는 디스크(및 가능한 경우 해당 디스크의 경로)를 참조해야 합니다. 가능한 경우 DIVAnet은 사이트 간 복사를 사용해서 복원을 수행하는 방법보다 이 방법을 선호합니다. |
|
사이트 간 복사 사용 |
컨텐츠가 로컬이 아니고 원격 DIVA 시스템이 대상 Source/Destination으로 직접 복원할 수 없는 경우, DIVAnet은 컨텐츠가 두 번의 홉으로 전달되도록 준비할 수 있습니다. 먼저, 원격 DIVA가 소스 및 대상 사이트 간에 공유되는 Source/Destination으로 복원합니다. 그런 다음 로컬 DIVA가 객체를 아카이브하고, 마지막으로 대상 Source/Destination으로 복원합니다. 이렇게 하면 컨텐츠에 대한 이후 요청이 더 빠르게 검색됩니다. 니어라인 복사본을 만들어서 원격 복원을 항상 수행하려는 경우에는 워크플로우 프로파일에서 |
|
사이트 간 전송 사용 |
특정 경우에 DIVAnet이 직접 원격 복원을 수행할 수 없으면, DIVAnet이 컨텐츠를 두 번의 홉으로 전달하지만(사이트 간 복사를 사용한 복원) 실제로 컨텐츠를 로컬로 아카이브하지 않습니다. 이러한 경우 중 하나가 Oracle Partial File Restore입니다. 첫째, DIVAnet은 소스 및 대상 DIVA 사이트가 모두 액세스할 수 있는 Source/Destination에 소스 DIVA가 컨텐츠를 전송하도록 지시합니다. 그런 다음 로컬 DIVA 사이트가 컨텐츠를 아카이브하지 않고 대상 Source/Destination에 전송합니다. |
DIVAnet은 모든 사이트에서 사용 가능한 Source/Destination으로 복원할 수 있게 해줍니다. DIVAnet은 Source/Destination이 두 사이에 모두 존재할 경우, 두 구성이 모두 동일한 물리적 Server\Device\Path를 가리킨다고 가정합니다. 사용자는 사이트에서 Source/Destination에 지정되는 이름에 주의해야 합니다.
원격 DIVA 시스템이 대상 Source/Destination으로 직접 복원할 수 없는 경우, DIVAnet은 컨텐츠가 두 번의 홉으로 전달되도록 준비할 수 있습니다(사이트 간 전송을 사용하여 복원 참조). Source/Destination이 특정 Source/Destination의 선호 사이트인 경우에만 DIVAnet이 이를 준비합니다(선호하는 Source/Destination 매핑 참조).
첫번째 복원이 실패할 경우 여러 번 재시도하도록 복원 명령을 구성할 수 있습니다. 복원할 컨텐츠가 여러 사이트에 존재하는 경우 DIVAnet은 이러한 사이트에서 복원을 자동으로 재시도합니다. 최대 재시도 횟수를 구성할 수 있습니다. 일부 경우에는 DIVAnet이 다른 사이트로 이동하기 전에 동일 사이트에서 재시도를 결정합니다. 이 경우 DIVAnet은 RestoreRetryIntervalMins 값을 검사해서 동일 사이트에서 재시도하기 전에 기다려야 하는 시간을 결정합니다.
DIVAnet 2.1은 DIVArchive API의 하위 세트를 지원합니다. 지원되는 메시지 목록은 이 장을 참조하십시오.
DIVAnet 2.1은 다중 복원에 대한 지원이 제한적입니다. DIVAnet은 원격 Source/Destinations에 대해 다중 복원을 허용하지 않으며, UI를 통한 다중 Source/Destinations의 표시 또는 모니터링을 허용하지 않습니다. 객체가 로컬에 존재하지만 액세스할 수 없는 경우(예: 로컬에서 외부화됨)에는 다중 복원을 사용할 수 있습니다.
DIVAnet 2.1은 로드 균형 조정을 포함해서 피어 투 피어 사이트 관계를 지원하지 않습니다.
컨텐츠에 대한 전체 복원 외에도 DIVAnet은 부분 파일 복원을 지원합니다. DIVAnet은 컨텐츠가 위치한 사이트를 확인하고 해당 부분이 복원되도록 준비합니다.
객체가 원격 DIVA 시스템에 존재하고, 원격 DIVA 시스템이 복원할 대상 Source/Destination에 액세스할 수 없는 경우, DIVAnet은 컨텐츠를 두 단계로 전송합니다. 처음에는 원격 DIVA를 사용해서 로컬 DIVA로 컨텐츠를 가져오고(전체 객체를 전송하지 않음), 그런 다음에는 로컬 DIVA를 사용해서 컨텐츠를 대상 Source/Destination에 복원합니다.
복원할 때와 같이, 인스턴스 번호 또는 -site 매개변수를 지정해서 특정 사이트로부터 복원을 수행하거나 초기 사이트 실패 시 재시도를 지정합니다. 또한 복원할 때와 같이, 동일한 복원 요청 내에서 여러 대상으로의 복원은 지원되지 않습니다.
복사 요청은 기존 인스턴스로부터 아카이브된 컨텐츠의 새로운 인스턴스를 만듭니다. DIVAnet은 컨텐츠를 한 DIVA 사이트에서 다른 사이트로 복사하도록 허용합니다. DIVArchive API CopyToGroup 명령은 (1) 한 DIVA 사이트에서 다른 사이트로 객체를 복사하거나 (2) 단순히 단일 사이트에 새 인스턴스를 만듭니다. 복사의 경우 DIVAnet은 DIVA API에서 사용할 수 없는 일부 매개변수를 파생해야 합니다. 테이블 7-3에서는 이러한 매개변수를 설명합니다.
| 파생 속성 | 설명 |
|---|---|
|
대상 사이트 이름 |
객체를 복사해야 하는 사이트를 나타냅니다. 대상 사이트 이름은 DIVA API에서 구축된 필드로 존재하지 않습니다. 이 이름은 다음 두 가지 방법 중 하나로 DIVAnet에 전달할 수 있습니다.
사이트 이름을 지정하지 않을 경우 로컬 사이트로 간주됩니다. -site 키워드는 API 릴리스 7.3 이상에서만 작동합니다. |
|
매체 |
Media는 복사된 객체를 저장하기 위해 사용할 매체 유형을 나타냅니다. DIVAnet에서는 또한 DIVA 스토리지 계획을 매체 이름으로 제공할 수 있습니다. Storage Plan은 복사가 사이트 간 복사인 경우에만 작동합니다. 대상 사이트 이름을 매체에 접두어로 지정하여 대상 사이트 이름도 나타낼 수 있습니다. 제공할 매체가 확실하지 않은 경우, any 매체를 제공해서 시스템이 대상 사이트에서 저장할 매체를 선택하도록 할 수 있습니다. 예를 들어, diva1_any 매체는 diva1 사이트에 복사되지만, DIVAnet이 매체를 선택합니다. DIVAnet이 제공하는 기본값은 일부 용례에 적합하지 않을 수 있습니다. 객체가 이미 대상 사이트에 있고 any가 지정된 경우 시스템은 단순히 성공을 반환합니다. |
|
소스 사이트 이름 |
일반적으로 DIVAnet은 복사를 수행할 원본 사이트를 선택합니다. 하지만 소스에 대해 완전한 제어가 필요한 경우에는 복사 요청에 인스턴스 번호를 제공할 수 있습니다. 이렇게 하면 소스 사이트 및 복사하려는 원본 DIVA 인스턴스를 선택할 수 있습니다(다음 절 참조). 이 ID는 복사하려는 대상 객체에서 |
DIVAnet 복사 요청에서 소스 사이트가 대상 사이트와 동일한 경우, DIVAnet은 단순히 대상 DIVA 사이트에 대해 CopyToGroup을 실행할 수 있습니다. 사이트 간 복사의 경우 DIVAnet은 이러한 복사를 수행하는 데 사용되는 방법을 구성할 수 있습니다. 각 소스 및 대상 사이트 이름 쌍(예: 사이트 1과 사이트 2)에 대해 테이블 7-4에서는 사용 가능한 전송 방법을 보여줍니다.
복사 방법 외에도, 각 소스 및 대상 사이트 이름 쌍에는 공통 스토리지 영역에 사용되는 실제 Source/Destinations가 포함됩니다. 기본 대상 매체(RestoreAndArchive), 옵션 매개변수(DIVArchive에 전달) 및 기타 매개변수도 구성 가능합니다.
| 유형 |
설명 |
|---|---|
|
RestoreAndArchive |
이 옵션을 사용할 경우 DIVAnet은 소스 사이트에서 소스 및 대상 사이트에 공통인 Source/Destination으로 컨텐츠를 복원합니다. 그런 후 DIVAnet은 대상 DIVArchive 시스템이 이제 공통 스토리지 영역에 컨텐츠를 아카이브하도록 지시합니다. 이 방법은 드롭 폴더를 사용하는 방법의 대안입니다. |
|
RestoreAndMonitor |
이 방법을 사용하면 DIVAnet이 먼저 컨텐츠를 특정 대상으로 복원하여 복사를 수행합니다. 그런 다음 DIVAnet은 대상 DIVArchive 시스템을 모니터하여 대상 사이트에서 컨텐츠가 성공적으로 아카이브되는지 확인합니다. 대상 사이트에서 컨텐츠가 성공적으로 아카이브될 때만 요청이 성공적으로 완료됩니다. 물론 이를 위해서는 컨텐츠를 가져와서 대상 DIVA 시스템에 아카이브하는 다른 프로세스 또는 프로그램이 필요합니다. 이 옵션은 DIVArchive DFM(드롭 폴더 모니터) 소프트웨어와 함께 사용할 때 유용합니다. 각 DFM 폴더는 사전 선택된 매체를 사용해서 아카이브를 수행하도록 구성됩니다. 즉, 복사를 위해 DFM을 사용할 경우 매체 매개변수는 실제로 무시됩니다. |
|
Restore |
이 방법을 사용하면 DIVAnet이 특정 대상으로 복원을 수행하고 성공을 반환하는 방식으로 복사를 수행합니다. 이 방법은 컨텐츠가 대상 사이트에 성공적으로 아카이브되었는지 확인하지 않으며, 사이트 간 복사를 사용한 복원 워크플로우를 시도할 경우 오류를 일으킬 수 있습니다. |
요청된 매체의 대상 사이트에 객체 인스턴스가 존재할 경우 DIVAnet 복사 명령은 성공을 반환합니다. DIVArchive는 이 경우 요청을 종료합니다.
객체가 존재하지만 요청된 매체가 없는 사이트에 객체를 복사하도록 요청할 경우, DIVAnet은 요청에 지정된 매체를 사용해서 해당 사이트에 또 다른 객체 인스턴스를 만듭니다. 이에 대한 예외사항은 매체로 any가 제공된 경우입니다. 이 경우 DIVAnet은 다른 인스턴스를 만들지 않습니다.
DIVAnetUI에는 DIVAnet이 복사 작업에 대상 매체를 지정할 수 있게 하는 옵션이 있습니다(Selected By DIVAnet 매체 사용). DIVA API 요청에서는 복사 요청에 any 매체를 지정하여 동일한 효과를 얻을 수 있습니다. DIVAnet은 해당 구성을 사용해서 복사에 사용할 매체를 결정합니다(자세한 내용은 사이트 간 매핑 참조).
any가 전달되었고 객체가 대상 사이트에 존재하면, DIVAnet이 또 다른 객체 인스턴스를 만들지 않습니다. 추가 작업은 수행되지 않으며, 요청이 성공합니다.
DIVAnet은 또한 복사에 대해 주기적인 재시도를 지원합니다. 워크플로우 프로파일에서 사용으로 설정된 경우 DIVAnet은 실패한 복사 작업을 재시도합니다. 워크플로우 프로파일에서는 DIVAnet이 요청을 재시도할 기간 및 재시도 사이의 간격을 구성할 수 있습니다. 자세한 내용은 워크플로우 프로파일 구성을 참조하십시오.
DIVArchive 삭제 요청은 호출자가 아카이브된 객체를 제거할 수 있도록 허용합니다. DIVAnet 삭제 요청은 기본적으로 모든 DIVArchive 사이트에서 객체를 삭제합니다. DIVAnet DeleteInstance 요청은 단일 DIVA 사이트에서 특정 또는 모든 인스턴스를 삭제할 수 있습니다. 실제로 DIVAnet은 세 가지 유형의 삭제를 수행할 수 있습니다. 테이블 7-5에서는 삭제 유형 및 필요한 매개변수에 대해 설명합니다.
| 유형 |
파생 속성 | 설명 |
|---|---|---|
|
전역 삭제 |
NA |
모든 사이트에서 모든 객체 인스턴스를 삭제합니다. API에서 요청에 매체 또는 인스턴스 ID를 지정하지 않으면 지정된 객체가 모든 사이트에서 삭제됩니다. |
|
인스턴스 삭제 |
대상 사이트 이름 |
특정 사이트에서 단일 객체 인스턴스를 삭제합니다. API에서 인스턴스 ID 또는 매체를 지정하여 특정 사이트로부터 특정 객체 인스턴스를 삭제합니다. 인스턴스 ID를 지정하면, 특정 사이트에서 특정 인스턴스가 대상으로 지정됩니다. 매체 또는 옵션 매개변수는 전달할 필요가 없습니다. 매체를 지정할 경우, DIVAnet은 삭제하려는 원본 사이트를 확인해야 합니다. 다음 세 가지 방법 중 하나로 사이트를 지정할 수 있습니다.
|
|
사이트 삭제 |
대상 사이트 이름 |
특정 사이트에 있는 객체의 모든 인스턴스를 삭제합니다. 이 작업은 다음 세 가지 방법 중 하나로 수행할 수 있습니다.
|
위 표에서 설명한 것처럼 사이트 이름이 제공되었고 매체 유형이 any인 경우, 해당 객체의 모든 인스턴스가 선택된 사이트에서 삭제됩니다. 이 작업은 옵션 필드에 -site [sitename]을 전달하여 수행할 수도 있습니다.
DIVAnet은 아카이브된 객체의 마지막 인스턴스(즉, DIVAnet 데이터베이스에 존재하는 마지막 인스턴스)를 삭제하려고 시도할 때 인스턴스 삭제가 성공하도록 허용하지 않습니다. 이 경우에는 전역 삭제 또는 사이트 삭제 요청을 실행해야 합니다. 하지만 사이트 삭제는 마지막 인스턴스가 삭제되도록 허용하므로 주의해야 합니다. 액세스 규칙을 사용하면 실제로 전역 삭제 효과를 갖는 인스턴스 삭제 또는 사이트 삭제를 방지할 수 있습니다(자세한 내용은 액세스 규칙 구성 참조).
또한 사용자가 DIVArchive에 직접 삭제를 실행할 경우에는 DIVAnet이 마지막 인스턴스의 보존 여부를 확인할 수 없는 경우가 존재할 수 있습니다.
DIVAnet이 현재 객체에 대해 사이트 간 복사를 수행하고 있는 중일 때 DIVAnet에서 삭제가 수신되면, 복사를 시작했던 DIVAnet 요청이 취소됩니다. 복사는 복사 명령의 결과일 수도 있고, 복원을 충족시키기 위해 복사를 수행하는 복원 명령의 결과일 수도 있습니다. 다른 유형의 DIVAnet 요청은 취소되지 않습니다.
DIVAnet 요청을 대신해서 DIVArchive 요청이 수행 중일 때, DIVArchive는 해당 객체를 잠그고 객체가 삭제되지 않도록 방지합니다. 따라서, DIVAnet이 DIVArchive에 삭제 메시지를 전송하기 전에 객체가 잠긴 경우에는 삭제 요청이 실패합니다.
DIVAnet은 삭제가 실패할 때 삭제에 대한 주기적인 재시도를 지원합니다. 예를 들어, 워크플로우 프로파일에서 사용으로 설정된 경우, DIVAnet은 삭제할 인스턴스/객체가 잠긴 사이트에서 삭제를 계속 시도합니다. DIVAnet 내에서 재시도 기간을 구성할 수 있습니다.
테이블 7-6에서는 컨텐츠와 관련이 없는 DIVArchive API 명령을 보여줍니다. 이러한 명령은 객체 또는 요청에 대한 정보를 가져오며, 요청 ID가 지정되지 않습니다.
테이블 7-6 컨텐츠와 관련이 없는 기타 지원되는 DIVArchive 명령
| 요청 |
설명 |
DIVAnet의 동작 |
|---|---|---|
|
|
DIVAnet 요청을 취소합니다. |
-site 옵션은 이 명령에 적용되지 않습니다. |
|
|
DIVAnet 데이터베이스를 사용해서 아카이브된 객체에 대한 정보를 가져옵니다. DIVAnet은 모든 DIVAnet 사이트에서 객체의 모든 인스턴스를 반환합니다. 사용자가 객체 이름 및 객체 범주를 제공합니다(범주는 공백으로 둘 수 있지만, 여러 객체가 동일한 객체 이름을 포함할 경우, 호출이 실패함). DIVAnet은 DIVAnet 데이터베이스를 사용해서 아카이브된 객체에 대한 정보를 반환합니다.
|
-site 옵션은 이 명령에서 지원되지 않습니다. |
|
|
DIVAnet 데이터베이스에서 DIVAnet 요청 관련 정보를 검색합니다. 주: 추가 정보 매개변수는 제한 사항이 있습니다. 추가 정보는 DIVArchive에 의해 제공되며, 마지막으로 처리된 DIVA 요청의 정보를 나타냅니다. 이 정보는 DIVAnet 네트워크에 있는 다른 사이트를 반영하지 않습니다. |
DIVAnet이 -site 옵션은 이 명령에 적용되지 않습니다. |
|
|
DIVArchive에서 직접 특정 아카이브된 객체 내의 파일 및 폴더에 대한 정보를 검색합니다. |
-site 옵션을 수락해서 특정 사이트를 질의하거나, DIVAnet이 선택할 수 있도록 사이트를 질의하지 않습니다(권장). |
|
|
DIVArchive에서 객체 및 객체 이벤트 관련 정보를 검색합니다. DIVAnet은 한 번에 한 사이트씩, 라운드 로빈 방식으로, 사이트당 하나의 일괄 처리로 각 DIVArchive 시스템에서 직접 객체 정보를 검색합니다. 각 일괄 처리에는 하나의 DIVA 사이트의 정보가 포함됩니다. 동일한 객체가 두 사이트에 존재할 경우, 각 일괄 처리에 한 번씩, 해당 객체가 두 번(각 사이트당 한 번) 수신됩니다. 주: 반환되는 항목의 순서는 보장되지 않습니다. 하나의 DIVA 사이트가 작동 중지된 경우, |
밑줄(_)을 구분 문자로 사용해서 매체 필드에 사이트 이름을 접두어로 지정하면 한 사이트에서 정보를 검색할 수 있습니다. 매체에 대해 질의를 수행하지 않지만 한 사이트에서 정보를 검색하려는 경우에는 매체 필드에 사이트 이름만 제공하면 됩니다. 이 명령은 -site 옵션을 수락하지 않습니다. |
|
|
DIVAnet 데이터베이스를 질의하여 객체 이름 및 범주 목록을 가져옵니다( |
DIVAnet 내에서 이 명령은 제한적으로만 지원됩니다. 테이프 정보 질의는 지원되지 않으며, 동시 질의 수도 제한됩니다. -site 옵션은 지원되지 않습니다. |
|
|
각 배열을 구성하는 디스크를 포함하여 모든 사이트로부터 배열 이름 목록을 반환하고, 현재 디스크 용량을 반환합니다. |
옵션 필드에 전달된 -site 매개변수는 특정 사이트에 대한 정보를 반환할 수 있습니다. |
|
|
모든 사이트로부터 테이프 그룹 이름 목록을 반환합니다. 사이트 이름은 그룹 이름에 접두어로 표시됩니다. |
주: 이 명령은 옵션 필드를 포함하지 않습니다. 따라서 -site 옵션은 지원되지 않습니다. |
|
|
모든 사이트로부터 소스 및 대상 정보 목록을 반환합니다. |
반환된 목록에서 소스 또는 대상의 사이트 이름은 밑줄(_)로 구분되어 소스 또는 대상 이름에 접두어로 표시됩니다. 옵션 필드에 전달된 -site 매개변수는 특정 사이트에 대한 정보를 반환할 수 있습니다. |
|
|
단일 DIVArchive 사이트의 상태를 검색합니다(기본적으로 로컬 사이트가 반환됨). 모든 사이트의 전역 뷰는 반환하지 않습니다. |
옵션 필드에 전달된 -site 매개변수는 정보를 수집할 원본 사이트를 선택합니다. 예를 들어, -site diva1은 사이트 이름 diva1로 지정된 Manager에게 |
|
|
구성된 모든 DIVArchive 사이트에 정의되어 있는 스토리지 계획 목록을 검색합니다. |
반환된 목록에서 스토리지 계획의 사이트 이름의 앞에 스토리지 계획 이름이 밑줄(_)로 구분되어 추가됩니다. 옵션 필드의 -site 매개변수인 |
응용 프로그램 호환성을 위해 다음과 같은 명령은 DIVAnet이 이를 충족시키기 위해 어떠한 작업도 수행하지 않더라도 항상 성공을 반환합니다.
우선순위 변경
객체 잠금
객체 잠금 해제
객체 링크
인스턴스 요구
인스턴스 릴리스
DIVAnet은 DIVArchive가 반환하는 것과 비슷한 상태 코드를 반환합니다. 하지만 요청 처리 중 나중까지 검사를 수행하는 데 필요한 정보가 DIVAnet에 포함되지 않는 경우가 많기 때문에 일부 경우에는 DIVArchive에서 즉시 실패하는 요청이 DIVAnet에서 수락될 수 있습니다.
또한 DIVAnet은 여러 명령에 대해 ACCESS_DENIED 상태를 반환합니다. 이 상태는 DIVArchive에서 반환되지 않습니다. DIVAnet은 액세스 규칙 검사를 전달하지 않는 요청을 거부하며, WorkflowProfile에 구성되지 않은 메시지를 거부합니다. 호환성을 위해 API 릴리스 5.8 및 이전 버전은 ACCESS_DENIED 대신 INVALID_PARAMETER 상태를 반환합니다.