4 DIVAnet 서비스 구성

DIVAnet 서비스를 구성하기 전에 제 2 장에서 DIVAnet 서비스에 대한 정보와 DIVAnet 서비스가 DIVArchive 및 다른 DIVAnet 서비스와 서로 상호 작용하는 방법에 대한 설명을 참조하십시오.

ClientAdapter 서비스 구성

ClientAdapter 서비스를 구성하려면 클라이언트가 DIVAnet에 연결하는 방법을 구성해야 합니다. 또한 DIVAnet이 DIVArchive에 연결하는 방법도 구성해야 합니다.

DIVArchive 사이트 이름 구성

DIVAnet 사이트는 하나의 DIVArchive 시스템 및 하나 이상의 DIVAnet 서비스(ManagerAdapter, ClientAdapter, DbSync)로 정의됩니다. 각 사이트에는 고유한 사이트 이름이 지정됩니다. ClientAdapter를 구성하려면 먼저 DIVAnet 데이터베이스에서 사이트 이름을 구성해야 합니다(addSites 유틸리티 사용). 사이트 이름을 만들 때는 읽기 쉽고 물리적 위치 또는 사이트의 기능을 나타내는 이름을 사용해야 합니다. 이러한 사이트 이름은 각 사이트에서 사용됩니다.

주:

사이트 이름은 대소문자를 구분합니다.

클라이언트 API 포트 구성

DIVAnet은 클라이언트 API 응용 프로그램이 DIVAnet에 연결하기 위해 사용하는 소켓 포트의 구성을 허용합니다. ClientAdapter에서는 여러 API 포트를 구성할 수 있습니다. 각 API 포트는 Direct 모드와 MultiDiva 모드의 두 가지 모드 중 하나로 구성됩니다. 각 포트에는 워크플로우 프로파일을 지정할 수 있습니다.

  • Direct 모드 - Direct 모드에서 수신되는 API 연결은 추가 처리 없이 개별 DIVArchive 시스템으로 직접 경로 지정됩니다. DIVAnet이 경로 지정하는 특정 사이트는 포트별 기준에 따라 ClientAdapter에 구성됩니다. 이 기능은 로컬 클라이언트가 원격 DIVArchive 시스템에 마치 로컬인 것처럼 연결할 수 있게 해줍니다. 메시지 경로를 지정할 DIVA 사이트는 ClientAdapter 구성 파일의 DivaManagers 섹션에 구성되어 있어야 합니다. 또한 Direct 모드에서만 작동하도록 사이트를 지정할 수 있습니다(자세한 내용은 DIVArchive 사이트 이름 구성 참조).

    Direct 모드에서의 요청은 DIVAnetUI에 표시되지 않으며, 요청을 경로 지정 중인 DIVA 사이트에서만 모니터할 수 있습니다.

    일부 DIVAnet 워크플로우는 DIVAnet 데이터베이스, DIVAnet UI 또는 MultiDiva 모드 처리가 필요하지 않습니다. Direct 모드 전용으로 ClientAdapter 서비스를 구성하려면 Direct 모드 포트만 정의되었고 WebServicePort는 정의되지 않았는지 확인합니다. 이렇게 하면 DIVAnet UI가 사용 안함으로 설정됩니다. 예제 구성은 다음 위치의 파일에서 찾을 수 있습니다.

    Program/conf/divanet/templates/ClientAdapterConfig.xml.ProxyOnly.ini

  • MultiDiva 모드 — MultiDiva 모드에서 DIVAnet은 모든 DIVA 사이트가 하나의 큰 아카이브 시스템으로 표시되도록 합니다. 이 모드에서 수신되는 API 요청은 DIVAnet으로 직접 경로 지정됩니다. DIVAnet은 필요에 따라 다른 DIVArchive 시스템을 참조해서 상위 레벨 요청을 충족시킵니다. 예를 들어, 이 기능은 한 사이트에서 다른 사이트로 컨텐츠를 복사할 수 있도록 허용하고, 컨텐츠가 포함된 특정 사이트를 알 필요 없이 복원을 수행하고, 첫번째 사이트에서 컨텐츠에 액세스할 수 없을 경우 다른 사이트에서 재시도합니다. 또한 모든 사이트의 컨텐츠에 대한 전역 뷰를 제공합니다.

    MultiDiva 모드에서 실행되는 요청의 진행 상태는 DIVAnetUI에서 모니터할 수 있습니다. DIVAnet은 사용자에게 다음 사항을 알리는 고유 요청 레벨 이벤트를 만듭니다.

    • DIVAnet이 요청을 처리하는 방법

    • DIVA 사이트로 구성된 요청

    • 중간에 발생하는 모든 오류 또는 경고

클라이언트 웹 연결 구성

DIVAnetUI 응용 프로그램 및 DivanetAdmin 도구는 모두 ClientAdapter에 대한 웹 연결을 설정합니다. 사용자는 ClientAdapter 구성 파일에서 이러한 연결에 대해 제공되는 포트를 구성할 수 있습니다.

워크플로우 프로파일 구성

워크플로우 프로파일은 DIVAnet에서 수신 요청이 처리되는 방법을 정의하는 매개변수 세트입니다. 워크플로우 프로파일은 비슷한 방식으로 DIVAnet을 사용하는 사용자 및 시스템을 논리적으로 그룹화할 수 있는 방법을 제공합니다.

DIVAnet은 ClientAdapter 내에 하나 이상의 프로파일을 만들 수 있도록 허용합니다. 이러한 프로파일은 특정 사용자 세트 또는 응용 프로그램 세트에 필요한 매개변수를 포함합니다. 워크플로우 프로파일은 요청이 수신된 위치를 기준으로 지정됩니다(수신된 포트 - 다음 절 참조).

워크플로우 프로파일에서 사용자는 수락된 유효한 메시지 목록, 재시도 매개변수, 사이트 간 복사 방법 및 기타 속성과 같은 정보를 사용자정의할 수 있습니다.

프로파일 및 API 포트

API Ports 섹션에서 정의된 각 포트에는 워크플로우 프로파일 이름을 지정할 수 있습니다. API 포트로 수신되는 요청은 지정된 워크플로우 프로파일을 사용해서 처리됩니다. 이름이 정의되지 않았으면 default 프로파일이 사용됩니다. MultiDiva 모드의 포트는 ClientAdapter 구성 아래쪽에 있는 워크플로우 프로파일 본문 섹션을 참조하는 워크플로우 프로파일 이름을 포함할 수 있습니다.

포트가 Direct 모드인 경우, 워크플로우 프로파일 이름은 레이블만 포함하며, Direct 모드 연결에 대한 워크플로우 프로파일 본문이 없습니다. 하지만 이 이름은 액세스 규칙에서 유용하게 사용될 수 있습니다(다음 절 참조).

MultiDiva 모드 및 Direct 모드 모두, 이름을 지정하지 않으면 연결에 default라는 워크플로우 프로파일 이름이 사용됩니다. 각 워크플로우 프로파일 본문 섹션은 ClientAdapterConfig.xml에 구성됩니다. 다음 절에서는 각 워크플로우 프로파일에서 구성 가능한 정보 유형을 보여줍니다.

재시도 및 시간 초과

DIVAnet 내에서 일부 명령은 재시도할 수 있습니다(예: 복원, 복사 및 삭제 요청). 재시도 기간 및 재시도 간격을 포함한 재시도 매개변수는 여기에서 구성할 수 있습니다. 여러 명령에는 고유한 재시도 설정이 포함됩니다(예: 복사 명령 재시도 매개변수는 삭제 명령 재시도 매개변수와 완전히 다름). 메시지 시간 초과 및 연결 제한도 워크플로우 프로파일에서 구성할 수 있습니다. 재시도 및 시간 초과 설정은 이러한 설정이 정의되는 워크플로우 프로파일에 따라 다릅니다.

유효 메시지

각 워크플로우 프로파일에서는 메시지 목록이 구성됩니다. 이 목록은 이 워크플로우 프로파일에서 수락될 수 있는 유효한 API 메시지 목록을 나타냅니다. 예를 들어, Archive 메시지가 목록에 표시되지 않은 경우, 아카이브 메시지는 API를 통해 DIVAnet으로 전송할 수 없습니다(최소한 이 워크플로우 프로파일의 경우).

사이트 간 매핑

DIVAnet은 사이트 간 전송이 수행되는 방법을 구성할 수 있는 유연한 방법을 제공합니다. 각 워크플로우 프로파일에서 사용자는 각 전송 경로에 대해 매핑 매개변수를 구성합니다(한 경로는 사이트 A에서 사이트 B로 전송하고, 다른 경로는 사이트 A에서 사이트 C로 전송하는 등의 방식으로 구성 가능). 이 표는 복사, 복원 또는 부분 파일 복원 명령이 수신될 때 참조됩니다.

다른 워크플로우 프로파일이 default 워크플로우 프로파일에서 해당 매핑을 로드할 수 있으므로, 이 표는 default 워크플로우 프로파일에서 사이트 간 매핑을 정의할 때 유용합니다. 이렇게 하면 구성에서 매핑 수를 줄일 수 있습니다.

매개변수 - DIVAnet은 서로 다른 여러 전송 유형을 지원합니다. 사이트 간 전송 방법에서는 여러 유형에 대해 설명합니다. RestoreAndArchive가 기본 전송 유형입니다. RestoreAndMonitor에는 DFM(드롭 폴더 모니터) 또는 비슷한 기능을 수행하는 다른 응용 프로그램이 필요합니다. 기타 매개변수는 다음과 같습니다.

  • Source/Destination - 전송을 위한 공통 스토리지 위치입니다(소스 및 대상 사이트 모두에서 액세스 가능).

  • Default Media - 대상 사이트에 아카이브할 때 사용할 기본 아카이브 매체입니다. 기본 매체는 임시 복사가 시작되었거나(복원 등으로 인해), 사용자가 복사를 실행하고 DIVAnet이 매체를 선택하도록 지정한 경우에 사용할 수 있습니다.

  • Options - 복원, 아카이브 및 전송 요청에서 사용할 매개변수입니다.

  • FilePathRoot - 컨텐츠를 저장할 상위 디렉토리입니다.

Directory Location - DIVAnet은 선택한 Source/Destination에 상대적인 파일 저장 디렉토리 경로를 생성합니다. 이 상대 경로는 다음과 같이 생성됩니다.

{FilePathRoot} / {Media} / {UniqueDirName} /

FilePathRoot는 사이트 간 매핑에서 지정됩니다. 매핑에서 AppendMediaToPath 옵션이 true로 설정된 경우에만 매체가 경로에 포함됩니다(기본값은 false). 마지막으로 DIVAnet은 경로의 일부로 포함된 고유한 디렉토리 이름을 생성합니다. 이 고유 이름에는 이름 앞에 붙은 요청을 시작한 사이트 이름이 포함됩니다.

워크플로우 프로파일 다시 로드

워크플로우 프로파일에 지정된 매개변수는 ClientAdapter를 다시 시작하지 않아도 변경 및 다시 로드할 수 있습니다. ClientAdapter 서비스 다시 시작은 실행 중인 모든 요청을 중지하고 모든 클라이언트 연결을 닫기 때문에 피해야 합니다. 다시 로드는 DivanetAdmin 도구 내에서 수행할 수 있습니다(DivanetAdmin에 대한 자세한 내용은 다음 내용 참조).

주:

다시 로드는 모든 워크플로우 프로파일을 업데이트할 뿐만 아니라 모든 액세스 규칙도 업데이트합니다.

ClientAdapter 구성 파일 수정

다음 표에서는 ClientAdapter 구성 파일에 표시될 수 있는 매개변수에 대해 설명합니다. 이 파일은 XML 형식입니다. 기본값 열은 구성 파일에 매개변수가 지정되지 않은 경우, 매개변수에 포함되는 값을 나타냅니다. 이 열에는 또한 매개변수가 필수 또는 선택사항인지 여부가 표시됩니다.

새 구성 파일을 만들려면 다음과 같이 하십시오.

  1. DIVAnet 홈 디렉토리(DIVAnet이 설치된 위치)로 이동합니다.

  2. Program/conf/divanet/templates 폴더로 이동합니다.

  3. ClientAdapterConfig.xml.ini를 상위 디렉토리에 복사하되, .ini 확장자는 제거합니다(../ClientAdapterConfig.xml).

  4. 아래 표를 참조해서 ClientAdapterConfig.xml 파일에서 매개변수를 편집하여 ClientAdapter를 구성합니다.

샘플 ClientAdapter 구성 파일은 부록 A를 참조하십시오.

최상위 레벨 매개변수

테이블 4-1 ClientAdapter 최상위 레벨 매개변수

매개변수
설명
기본값

LocalSitename

로컬 DIVAnet 사이트의 사이트 이름입니다.

없음(필수)

LogDirectory

로그 파일이 생성되는 폴더입니다.

log/divanet/ClientAdapter 디렉토리

LogLevel

추적 파일 로깅이 수행되는 세부정보 레벨입니다(ERROR, WARN, INFO, DEBUG, TRACE).

INFO

SyncTimeoutSecs

객체가 동기화되도록 기다리는 시간(초)입니다.

60

WorkerThreads

DIVAnet 스레드 풀에 있는 작업자 스레드 수입니다. 큰 구성을 조정하는 데 사용됩니다. 확실하지 않으면 이 값을 설정하지 마십시오.

25

AbortAllOnStartup

DIVArchive 레벨에서 요청이 완료되었더라도 DIVAnet이 시작될 때 완료되지 않은 모든 DIVAnet을 중지합니다. 새 요청은 영향을 받지 않습니다.

false

MaxClientConnections

허용되는 API 연결의 총 최대 개수입니다.

200

GlobalDivanetRequestLimit

시스템에 수락될 수 있는 보류 중이거나 실행 중인 DIVAnet 요청의 최대 개수입니다. 이 제한에 도달하면 DIVAnet에서 새로운 요청 거부가 시작됩니다.

5000

InternalPollingRateMillis

정보를 위해 사이트가 폴링되는 기본 속도입니다. 네트워크 및/또는 시스템 속도가 느려질 경우에만 이 매개변수를 변경합니다.

4000

WebServicePort

관리 메시지를 ClientAdapter에 전송하는 데 사용되는 포트입니다.

없음(선택사항)

SSLWebServicePort

웹 서비스 요청에 대해 SSL이 강제 적용된 경우 True입니다.

true

WebDefaultWorkflowProfile

웹 요청에 대해 사용할 워크플로우 프로파일입니다(DivanetUI 포함).

default 프로파일

AccessRulesFilename

액세스 규칙 파일 이름입니다. 이 파일 이름은 클라이언트 어댑터 구성 파일이 존재하는 디렉토리에 대해 상대적입니다.

없음(구성되지 않은 경우 액세스 규칙이 적용되지 않음).


API 포트 섹션

ApiPorts 태그 내에 ApiPort 정의가 여러 개 표시될 수 있습니다. 테이블 4-2에서는 ApiPort 정의의 일부로 표시될 수 있는 매개변수를 보여줍니다.

테이블 4-2 API Port 매개변수

매개변수
설명
기본값

ListenPort

수신 대기할 포트 소켓입니다.

없음(필수)

RoutingMode

요청의 경로 지정 방법을 식별합니다(Direct 또는 MultiDiva).

  • Direct - 하나의 Manager로만 경로 지정됩니다(이 경우에는 Sitename 매개변수가 필수임).

  • MultiDiva - DIVAnet 워크플로우 명령을 사용해서 경로 지정합니다. 제출된 요청은 DIVAnet에서 고유한 요청 ID를 수신합니다.

MultiDiva

Sitename

Direct 모드를 사용할 경우 경로 지정할 사이트입니다. 사이트는 DivaManagers 섹션에 정의되어 있습니다(다음 표 참조). 이 매개변수는 Direct 모드에서만 필요합니다. 정의된 경우, DivaManagers 섹션에 정의된 사이트 이름 중 하나와 일치해야 합니다.

없음(Direct 모드에 필요)

LocalAddress

이 Manager로 전송하는 데 필요한 로컬 주소입니다(일반적으로 사용할 네트워크 카드). 확실하지 않으면 지정하지 마십시오.

없음(선택사항)

WorkflowProfile

이 포트를 통과해서 이동하는 요청에 사용할 워크플로우 프로파일 이름입니다(워크플로우 프로파일 단원 참조). 제공되지 않은 경우 default 워크플로우 프로파일이 사용됩니다.

default

(MultiDiva 모드의 기본 프로파일).


DIVArchive Managers 섹션

DivaManagers 태그 내에 DivaManager 정의가 여러 개 표시될 수 있습니다. 테이블 4-3에서는 DivaManager 정의의 일부로 표시될 수 있는 매개변수를 보여줍니다.

테이블 4-3 DivaManagers 구성 매개변수

매개변수
설명
기본값

Sitename

Manager가 설치된 사이트의 이름입니다. 나열된 사이트 이름은 DIVAnet 데이터베이스에 구성된 항목 및 ManagerAdapter.xml 파일에 구성된 항목과 일치해야 합니다.

없음(필수)

ConnectionType

Manager에 연결하는 방법을 식별합니다(유효한 값: Socket, WebService).

Socket

Address

Manager의 네트워크 주소(IP 또는 인터넷 이름)

localhost

Port

클라이언트가 Manager에 연결되는 포트입니다.

없음(필수)

LocalAddress

이 Manager로 전송하는 데 필요한 로컬 주소입니다(일반적으로 사용할 네트워크 카드). 확실하지 않으면 지정하지 마십시오.

없음(선택사항)

LocalPort

사용되는 로컬 포트입니다. 확실하지 않으면 지정하지 마십시오.

0

BaseURL

ConnectionTypeWebService; required로 설정된 경우 ManagerAdapter의 URL입니다.

없음(선택사항)

TotalThrottleThreshold

DIVAnet은 추가 요청을 전송하기 전에 총 Manager 요청 수가 이 제한 아래로 내려갈 때까지 기다립니다. ConnectionTypeSocket으로 설정된 경우에 사용됩니다. Manager가 소스에 관계없이(예: DIVAnet, SPM, 로컬 API 연결) 실행 중인 요청 수를 초과할 경우, DIVAnet은 Manager에서 실행 중인 요청 수가 이 임계값 아래가 될 때까지 추가 요청을 전송하지 않습니다.

400

SubmittedThrottleThreshold

DIVAnet은 추가 요청을 전송하기 전에 Manager에서 실행 중인 DIVAnet 자체에 포함된 요청 수가 이 제한 아래로 내려갈 때까지 기다립니다. Manager가 DIVAnet 자체에서만 전송된 실행 중인 요청 수를 초과할 경우, DIVAnet은 DIVAnet에서만 전송된 Manager에서 실행 중인 요청 수가 이 임계값 아래가 될 때까지 추가 요청을 전송하지 않습니다.

0은 모든 메시지가 DIVAnet 내에서 내부적으로 대기열에 들어가게 만드는 유효한 값입니다. -1 값은 제한이 없음을 나타냅니다.

100


DIVAnet 데이터베이스 섹션

테이블 4-4에서는 DivanetDatabase 섹션 내에 표시할 수 있는 매개변수를 보여줍니다.

테이블 4-4 DIVAnetDatabase 매개변수

매개변수
설명
기본값

Address

데이터베이스의 IP 주소입니다.

localhost

Port

데이터베이스에 액세스하는 데 사용되는 포트입니다.

1521

User

스키마의 사용자 이름입니다.

없음(필수)

Password

스키마의 암호입니다.

없음(필수)

DbSiteId

Oracle SID입니다.

lib5

DbServiceName

Oracle 서비스 이름입니다. DbSiteId 대신 제공할 수 있습니다.

없음(선택사항)


워크플로우 프로파일 섹션

테이블 4-5에서는 WorkflowProfile 섹션 내에 표시할 수 있는 매개변수를 보여줍니다.

테이블 4-5 WorkflowProfile 매개변수

매개변수
설명
기본값

Name

워크플로우 프로파일의 이름입니다.

default

AllowDirectRemoteRestores

원격 DIVA에서(Source/Destinations로의) 직접 전송을 허용합니다. 복원하기 전에 항상 컨텐츠의 로컬 복사본을 만들려면 false로 설정합니다.

true

MessageTimeoutMillis

Manager로 전송되는 메시지의 기본 시간 초과 값입니다.

15000

(15초)

TotalRequestTimeoutHours

시간 초과되기 전에 요청을 유지할 기간(시간)입니다.

72

PreventArchiveIfInDirectory

객체가 아무 사이트에나 존재할 경우 새로운 아카이브 요청을 방지합니다. true로 설정되었고 객체가 아무 사이트에나 존재할 경우 해당 객체 아카이브 요청이 거부됩니다(아카이브하려는 대상 사이트에 객체가 존재하지 않는 경우라도).

true

DeleteRetryIntervalMins

삭제 워크플로우에 대한 재시도 사이의 간격입니다.

5분

DeleteRetryLimitMins

삭제 워크플로우 재시도가 계속되는 총 기간(분)입니다. 삭제 재시도는 DeleteRetryLimitMins 동안 또는 삭제가 성공할 때까지 DeleteRetryIntervalMins마다 시도됩니다.

0분(재시도 안함)

IntersiteCopyRetryIntervalMins

복사 요청을 재시도하기 전에 기다리는 시간입니다. 이 매개변수는 복사 요청에만 적용됩니다.

5분

IntersiteCopyRetryLimitMins

이 총 시간 제한에 도달할 때까지(또는 성공할 때까지) 복사를 계속 재시도합니다. 이 매개변수는 복사 요청에만 적용됩니다.

0분(재시도 안함)

RestoreRetryAttempts

실패 시, 시도해야 하는 최대 재시도 횟수입니다(일반적으로 다른 사이트에 존재하는 컨텐츠를 사용해서 재시도).

3회

RestoreRetryIntervalMins

DIVAnet이 동일한 사이트에서 재시도를 수행할 때의 재시도 간격입니다.

5분

SiteDownRequeueWaitMins

(고급) 대기열에 있는 요청을 다른 사이트로 경로 지정하기 전에 사이트가 작동 중지 상태로 있는 최대 시간입니다.

30

BackupArchiveSite

로컬 사이트가 연장 기간(SiteDownRequeueWaitMins에 구성됨) 동안 작동 중지 상태일 경우, 로컬 사이트 대신 아카이브에 사용할 사이트입니다. 아카이브가 제출되고 로컬 사이트에서 실패하면, 백업 사이트에서 아카이브가 재시도되지 않습니다.

없음(백업 사이트 없음)

ForceGlobalDeleteToSite

전역 삭제 요청을 지정된 사이트에서 사이트 삭제로 변환합니다.

없음(선택사항)

Messages

각각 워크플로우 프로파일에 대한 유효한 메시지 목록이 포함된 하나 이상의 메시지 목록입니다.

NA

Message

하나 이상의 유효한 메시지 이름:

  • AllInfo

  • Archive

  • Cancel

  • CloseObjectsList(레거시)

  • Copy

  • Delete

  • GetArchiveSystemInfo

  • GetArrayList

  • GetFilesAndFolders

  • GetGroupsList

  • GetObjectDetailsList

  • GetObjectInfo

  • GetObjectsList(레거시)

  • GetRequestInfo

  • GetSourceDestinationList

  • GetStoragePlanList

  • InitObjectsList(레거시)

  • PartialRestore

  • Restore

Message 태그는 하나 이상 지정해야 합니다.

AllInfo는 모든 정보 요청 메시지가 전송되도록 허용합니다.

없음

(1개 필요)

UseDefaultMappings

default 워크플로우 프로파일에 정의된 모든 매핑이 워크플로우 프로파일에 포함되어야 하는 경우 True입니다.

False


사이트 간 전송 매핑(워크플로우 프로파일)

Mappings 태그에는 사이트 간 전송 매핑이 여러 개 포함됩니다. 사이트 간 매핑은 한 사이트에서 다른 사이트로 객체가 복사되는 방법을 정의합니다. 각 매핑에는 FromSitenameToSitename 매개변수가 포함됩니다. 각 매핑은 FromSitename에서 ToSitename으로 복사가 수행되는 방법을 정의합니다.

각 매핑에는 전송을 수행하는 데 사용되는 방법을 나타내는 Type 매개변수가 포함됩니다(자세한 내용은 복원 워크플로우 참조). 다른 매개변수는 사이트 간 복사를 실행하는 프로세스에서 사용되는 기본값입니다.

DIVAnet은 FromSrcDest를 임시 스토리지 영역으로 사용하며, ToSrcDest를 사용해서 선택적으로 대상 DIVA로 푸시합니다. 컨텐츠를 저장할 때 DIVAnet은 FilePathRoot에 추가되는 고유한 폴더 이름을 제공합니다. FromSrcDest에 컨텐츠를 저장한 후 DIVAnet은 (Type 매개변수에 따라) 다음을 수행합니다.

  • 대상 사이트에 컨텐츠 아카이브

  • 대상 사이트에서 컨텐츠가 성공적으로 아카이브될 때까지 대기

  • 추가 작업 없이 완료

주:

구성에서 동일한 매핑을 여러 번 지정하지 않도록 하기 위해 워크플로우 프로파일 매개변수 UseDefaultMappings를 설정할 수 있습니다. 워크플로우 프로파일은 default 워크플로우 프로파일의 매핑을 사용합니다.

테이블 4-6 SitetoSiteTransfer 워크플로우 프로파일 매개변수

매개변수
설명
기본값

FromSitename

객체가 복사되는 원본 사이트 이름입니다. 입력된 값은 DivaManagers 섹션에 정의된 사이트 이름 중 하나와 일치해야 합니다.

없음(필수)

ToSitename

객체가 복사되는 대상 사이트 이름입니다. 입력된 값은 DivaManagers 섹션에 정의된 사이트 이름 중 하나와 일치해야 합니다.

없음(필수)

Type

전송 유형:

  • Restore - 복원을 수행하고 전송됨으로 표시합니다.

  • RestoreAndArchive - 복원한 후 대상 DIVArchive로 아카이브됩니다.

  • RestoreAndMonitor - 복원한 후 대상을 모니터합니다(DFM 드롭 폴더에 유용함).

RestoreAndArchive

FromSrcDest

복사의 복원 단계에 사용할 Source/Destination입니다.

: Oracle은 기본값을 사용하지 않을 것을 권장합니다.

MISSING_MAPPING_TO + FromSitename

ToSrcDest

복사의 아카이브 단계에 사용할 Source/Destination입니다.

MISSING_MAPPING_TO + ToSitename

TempDefaultMedia

객체의 임시 복사를 수행할 때 지정할 대상 매체입니다(일부 복원 작업에서 수행됨).

이 값은 또한 API 또는 UI 사용자가 DIVAnet에서 사용할 매체를 결정하도록 하려는 경우에도 사용됩니다(구성에 따라 다름)(any 키워드가 매체로 사용됨).

이 변수와 함께 RestoreAndMonitor가 사용된 경우, AppendMediaToPath 옵션이 필요한지 여부를 결정합니다.

없음(RestoreAndArchive에 필요)

FilePathRoot

Source/Destination 루트에 대한 상대 경로 세그먼트입니다. DIVAnet에서 생성된 고유한 폴더 이름에 접두어로 지정됩니다.

Remote

AdditionalOptions

복원/아카이브 작업에 사용할 DIVA 옵션입니다.

-axf -rm -delete_fpr

-allow_delete_on_source

AssignDefaultMediaOption

API 또는 UI 사용자가 DIVAnet에서 복사에 사용할 매체를 선택하도록 결정할 때 사용할 전략입니다. any 키워드가 매체로 사용되는 경우에 호출됩니다.

StoragePlan - 소스 객체의 스토리지 계획 이름을 기본 매체로 사용합니다.

StoragePlanAndSitename - 스토리지 계획 앞에 소스 사이트 이름을 붙입니다(밑줄로 구분됨).

TempMedia - TempDefaultMedia의 값을 매체로 사용합니다.

TempMedia

AppendMediaToPath

FilePathRoot 뒤에(그리고 고유 폴더 이름 앞에) 대상 매체를 하위 디렉토리로 추가해야 할 경우 True입니다. 다음과 같이 구성됩니다.

FilePathRoot / ToMedia / UniqueFolderName

이 옵션은 DFM으로 RestoreAndMonitor 유형을 사용할 때 유용합니다. DFM은 이 방식으로 전달된 매체 이름을 구문 분석할 수 있습니다.

false

Weighting

성능, 환경 설정을 기준으로 다른 전송 경로에 대해 이 전송 경로를 평가합니다. 복사 및 복원을 수행할 사이트를 선택할 때 사용됩니다. 유효한 범위는 0-40입니다. 20을 초과하는 값을 사용할 때는 디스크 및 테이프 비교, 사이트 상태 등과 같은 다른 요소를 대체하게 되므로, 주의해야 합니다. 이 옵션을 잘못 사용하면 복원 작업 시 성능 문제가 발생할 수 있으며, WAN 네트워크 정체에 영향을 줄 수 있습니다.

기본값은 10입니다. 로컬은 10씩 증가합니다.


선호하는 Source/Destination 매핑

DIVAnet이 복원 작업에 사용할 사이트를 계산할 때, 로컬 사이트를 사용해서 Source/Destination에 연결할 수 있는 한 DIVAnet은 일반적으로 로컬 사이트를 선호합니다. 하지만 일부 경우에는 다른 사이트를 선호할 수 있습니다.

Mappings 태그는 SrcDest 태그를 포함할 수 있습니다. SrcDest 태그 내에서 Name 태그는 Source/Destination 이름을 정의합니다. PreferredSitename 태그는 복원 작업에서 Source/Destination이 요청될 때 사용할 선호 사이트를 나타냅니다. SrcDest 섹션은 여러 개 존재할 수 있습니다.

ManagerAdapter 서비스 구성

ManagerAdapterConfig.xml 구성 파일은 ManagerAdapter 서비스에 대한 구성을 포함합니다. ManagerAdapter 서비스를 구성하려면 ManagerAdapter 구성의 각 매개변수 설명과 함께 다음 단계를 수행합니다(아래에 표시된 각 표에 이에 대한 정보가 포함됨).

범주별 동기화 필터링

DIVAnet은 DIVAnet DbSync 서비스에서 풀링되는 객체 정보에 필터를 배치할 수 있습니다. 이 필터는 사이트가 다운스트림 DIVAnet 시스템과 동기화할 객체 레코드의 하위 세트를 선택할 수 있게 해줍니다. 필터링은 ManagerAdapter 서비스에서 구성 및 수행됩니다.

주:

객체 필터 및 범주 접두어 대체는 프로덕션 워크플로우에서 구현을 신중하게 테스트해야 하는 고급 기능입니다. 객체 필터는 무조건 추가 또는 변경하지 마십시오.

예를 들어, 뉴욕 DIVAnet 시스템이 LA 사이트의 자산을 사용 및 저장하도록 구성되었다고 가정해보십시오. LA 사이트 관리자는 뉴욕 사용자가 세 가지 범주인 AVID, POST1POST2 중 하나와 일치하는 객체만 볼 수 있도록 하려고 합니다. LA 사이트의 ManagerAdapter 구성 파일을 통해 다음과 같이 필터를 구현할 수 있습니다.

<LocalSitename>LosAngeles</LocalSitename>
<ObjFilter>
     <RequestingSitename>NewYork</RequestingSitename>
     <Category>AVID</Category>
     <Category>POST1</Category>
     <Category>POST2</Category>
</ObjFilter>

이 필터를 사용하면 지정된 범주와 일치하는 객체가 뉴욕에 있는 DIVAnet 데이터베이스와 동기화됩니다. 다른 범주의 객체는 동기화되지 않습니다. 뉴욕 사이트 사용자의 관점에서 볼 때 LA에 존재하는 유일한 객체 레코드는 구성된 범주 필터와 일치하는 객체입니다. ManagerAdapter에는 여러 개의 ObjFilter 태그가 표시될 수 있으며, 각 태그는 요청 사이트와 관련된 범주 세트가 포함됩니다.

주:

범주 객체 필터는 필터와 일치하지 않는 객체에 대한 요청을 ManagerAdapter가 수락하지 못하도록 자동으로 방지하지 않습니다. ManagerAdapter 액세스 규칙은 특정 범주를 포함하지 않는 객체에 대한 작업을 방지합니다.

필터와 일치하지 않는 객체에 대한 작업을 방지하기 위해서는 ManagerAdapter 액세스 규칙 파일에 다음과 같은 액세스 규칙을 만듭니다.

<Include>
     <SourceSitename>NewYork</SourceSitename>
     <Operation>*</Operation>
     <ReqObjectCategory>AVID</ReqObjectCategory>
     <ReqObjectCategory>POST1</ReqObjectCategory>
     <ReqObjectCategory>POST2</ReqObjectCategory>
</Include>

이 규칙은 세 가지 범주인 AVID, POST1POST2 중 하나와 일치하는 객체에 대해서만 뉴욕의 요청을 허용합니다. 다른 포함 규칙이 지정되지 않은 경우에는 다른 범주가 거부됩니다. ManagerAdapter에서 액세스 규칙을 정의할 때는 ClientAdapter가 WebService 모드로 사이트와 통신하도록 구성되었는지 확인해야 합니다.

범주 접두어 대체 구성

범주별 동기화 필터링을 사용할 때는 한 가지 문제가 발생할 수 있습니다. 예제를 계속해서, 뉴욕이 필터에 없는 범주로 객체를 만들고, 이 객체를 LA에 복사하면 이름 충돌이 발생할 수 있습니다. 이 이름의 객체는 LA에도 존재할 수 있는데, 뉴욕의 DIVAnet 시스템은 이러한 객체에 대해 알지 못하기 때문입니다. 한 가지 해결 방법은 아카이브할 수 있는 잠재적 범주를 제한하는 액세스 규칙을 뉴욕에 제공하는 것입니다.

범주 접두어 대체를 사용하면 보다 유연한 해결 방법을 얻을 수 있습니다. 이 기능은 동기화되는 항목을 필터링할 뿐만 아니라 각 수신 요청에 범주 접두어를 추가합니다. 이 방식은 사이트에서 아카이브되는 객체에 대해 이름 공간과 비슷한 기능을 제공합니다.

일부 DIVAnet 워크플로우에서 단일 사이트는 여러 사이트에서 복사되는 객체를 수락해야 합니다. 그러면 시스템에 있는 모든 객체에 대해 고유한 범주 세트를 설정하는 것이 어려울 수 있습니다. 범주 접두어 대체를 사용하면 이러한 상황을 해결할 수 있습니다. 다음 ManagerAdapter 객체 필터는 LA에서 NY001로 시작하는 범주의 객체만 뉴욕의 DIVAnet 데이터베이스에 동기화되도록 보장합니다.

<LocalSitename>LosAngeles</LocalSitename>
<ObjFilter>
     <RequestingSitename>NewYork</RequestingSitename>
     <CategoryPrefix>NY001.</CategoryPrefix>
</ObjFilter>

필터를 적용한 후, 하지만 대상(뉴욕)에 객체가 도달하기 전에, 접두어가 삭제되고, 남은 문자는 뉴욕 DIVAnet 데이터베이스에서 범주로 사용됩니다. 예를 들어, LA에서 한 객체의 범주가 NY001.POST1인 경우, 뉴욕에 전송되는 결과 범주는 POST1이 됩니다. 비슷하게, 뉴욕 DIVAnet ClientAdapter가 LA에 명령을 전송할 때는 접두어가 다시 추가됩니다.

이렇게 하면 LA가 이름 충돌 없이 뉴욕에서 오는 모든 객체의 복사본을 저장할 수 있습니다. 이 기술을 통해 LA는 여러 사이트에 대한 재해 복구 사이트로 작동할 수 있습니다. 뉴욕은 해당 이름 지정 정책을 변경할 필요도 없습니다. 뉴욕은 이전과 동일한 방식으로 객체를 참조하므로, 뉴욕에서 이름을 바꿀 필요가 없습니다. 각 요청 사이트에 대해서는 범주 접두어가 하나만 허용됩니다.

이렇게 하기 위해서는 DIVAnet ClientAdapter 서비스가 WebService 모드로 원격 사이트에 연결할 수 있도록 구성되어야 합니다. 접두어 대체가 사용으로 설정된 사이트에 객체가 복사될 때는 필수적으로 객체 이름이 바뀌기 때문에, 이전에 사이트에 복사된 객체는 접두어를 포함하지 않게 되며, 따라서 문제를 일으킬 수 있습니다. 한 가지 해결 방법은 변환되지 않는 추가 범주 목록을 제공하는 것입니다. 또 다른 해결 방법은 Oracle DIVA 설치 전문가로 하여금 필터링된 사이트에서 객체 하위 세트의 이름을 바꾸도록 하는 것입니다(즉, DIVA 데이터베이스에서 영향을 받는 각 객체의 범주에 범주 접두어 추가). 범주 접두어 대체를 사용할 경우, DIVArchive Actor 구성에서 범주 검사를 사용 안함으로 설정(해야 할 가능성이 높음)합니다(자세한 내용은 오라클 고객지원센터에 문의).

주:

객체 필터를 변경할 경우에는 거의 항상 다운스트림 DIVAnet 시스템이 사이트에 대해 다시 동기화를 수행해야 합니다. 해당 시스템에서는 DIVAnetAdmin 도구를 사용해서 수행할 수 있습니다(제 6 장 참조).

범주 필터링은 두 가지 유형을 함께 혼합할 수 있습니다. 다음 두번째 필터(달라스)는 POST2 또는 POST3 범주를 제외한 모든 범주에 대해 범주 접두어 대체를 수행합니다(DAL01 사용). 해당 범주 접두어를 포함하거나 POST2 또는 POST3 범주를 포함하는 객체 레코드만 달라스에 동기화됩니다.

<LocalSitename>LosAngeles</LocalSitename>
<ObjFilter>
     <RequestingSitename>NewYork</RequestingSitename>
     <CategoryPrefix>NY001.</CategoryPrefix>
</ObjFilter>

<ObjFilter>
     <RequestingSitename>Dallas</RequestingSitename>
     <CategoryPrefix>DAL01.</CategoryPrefix>
     <Category>POST2</Category>
     <Category>POST3</Category>
<ObjFilter>

이러한 하이브리드 접근 방식을 사용할 경우에는 목록에 표시된 범주의 객체 이름(예: POST2)에 접두어가 다시 추가되지 않도록(예: NY001.POST2) 해야 합니다. 이 정책은 액세스 규칙을 통해 강제 적용할 수 있습니다.

ManagerAdapter 구성 파일 수정

다음 표에서는 ManagerAdapter 구성 파일에 표시될 수 있는 매개변수에 대해 설명합니다. 이 파일은 XML 형식입니다. 기본값 열은 구성 파일에 매개변수가 지정되지 않은 경우, 매개변수에 포함되는 값을 나타냅니다. 이 열에는 또한 매개변수가 필수 또는 선택사항인지 여부가 표시됩니다.

새 구성 파일을 만들려면 다음과 같이 하십시오.

  1. DIVAnet 홈 디렉토리(DIVAnet이 설치된 위치)로 이동합니다.

  2. Program/conf/divanet/templates 폴더로 이동하고, ManagerAdapterConfig.xml.ini를 상위 디렉토리로 복사하되, .ini 확장자는 제거합니다(../ManagerAdapterConfig.xml).

  3. 아래 표를 참조해서 ManagerAdapterConfig.xml 파일에서 매개변수를 편집하여 ManagerAdapter를 구성합니다.

부록 A에서는 샘플 ManagerAdapter 구성 파일을 보여줍니다.

테이블 4-7 최상위 레벨 ManagerAdapter 매개변수

매개변수
설명
기본값

LocalSitename

로컬 사이트의 이름입니다. 나열된 사이트 이름은 DIVAnet 데이터베이스에 구성된 것과 일치해야 하며(로컬 및 원격), ClientAdapterConfig.xmlDBSyncConfig.xml 파일 모두에 구성된 것과 일치해야 합니다. 이 구성을 통해 ClientAdapter 및 DbSync는 ManagerAdapter와 통신할 수 있습니다.

없음(필수)

ManagerAddress

DIVArchive Manager의 네트워크 주소(IP 또는 인터넷 이름)입니다.

localhost

ManagerPort

클라이언트가 DIVArchive Manager에 연결되는 포트입니다.

없음(필수)

WebServicePort

웹 메시지를 수신하는 데 사용되는 포트입니다.

없음(선택사항)

SSLWebServicePort

수신되는 웹 서비스 연결에 SSL을 강제 적용해야 할 경우 True입니다.

true

AccessRulesFilename

액세스 규칙 파일 이름입니다. 이 파일 이름은 ManagerAdapter 구성 파일이 존재하는 디렉토리에 대해 상대적입니다.

없음(구성되지 않은 경우 액세스 규칙이 적용되지 않음)

WorkerThreads

DIVAnet 스레드 풀에 있는 작업자 스레드 수입니다. 큰 구성을 조정하는 데 사용됩니다. 확실하지 않으면 이 값을 설정하지 마십시오.

50

LogDirectory

로그 파일이 생성되는 폴더입니다.

log/divanet/ManagerAdapter 폴더

LogLevel

추적 파일 로깅이 수행되는 세부정보 레벨입니다(ERROR, WARN, INFO, DEBUG, TRACE).

INFO


테이블 4-8 ManagerDatabase 매개변수

매개변수
설명
기본값

Address

DIVArchive Manager 데이터베이스의 IP 주소입니다.

localhost

Port

데이터베이스에 액세스하는 데 사용되는 포트입니다.

1521

User

스키마의 사용자 이름입니다.

없음(필수)

Password

스키마의 암호입니다.

없음(필수)

DbSiteId

Oracle SID입니다

lib5

DbServiceName

Oracle 서비스 이름입니다. DbSiteId 대신 제공할 수 있습니다.

없음(선택사항)


ObjFilter는 ManagerAdapter의 각 요청 사이트 이름에 대해 정의할 수 있습니다. 다음 표에서는 객체 필터에 대해 유효한 매개변수를 보여줍니다.

테이블 4-9 ObjectFilter 매개변수

매개변수
설명
기본값

RequestingSitename

사이트 요청 객체의 사이트 이름입니다.

없음(필수)

Category

제공된 범주의 객체는 요청 사이트 이름으로 동기화됩니다. 여러 범주가 표시될 수 있습니다.

없음(CategoryPrefix가 표시될 경우 선택사항)

CategoryPrefix

접두어가 ManagerAdapter를 통해 수신되는 모든 요청 앞에 붙습니다. 해당 범주 접두어의 객체만 요청 사이트 이름에 동기화됩니다.

없음(Category가 표시될 경우 선택사항)


DbSync 서비스 구성

DBSyncConfig.xml 구성 파일은 DbSync 서비스에 대한 구성을 포함합니다. DbSync 서비스를 구성하려면 각 매개변수의 설명과 함께 다음 단계를 수행합니다.

ClientAdapter를 사용할 때는 DbSync 서비스가 실행 중인지 확인합니다. DbSync 서비스가 실행 중이 아니면 원래 성공해야 할 일부 요청이 실패할 수 있습니다. 예를 들어, 새로운 DIVAnet 아카이브 요청이 성공할 수 있더라도 새로 아카이브된 객체의 DIVAnet 복원이 실패할 수 있습니다.

DbSync 구성 파일 수정

다음 표에서는 DbSync 구성 파일에 표시될 수 있는 매개변수에 대해 설명합니다. 이 파일은 XML 형식입니다. 기본값 열은 구성 파일에 매개변수가 지정되지 않은 경우, 매개변수에 포함되는 값을 나타냅니다. 이 열에는 또한 매개변수가 필수 또는 선택사항인지 여부가 표시됩니다.

새 구성 파일을 만들려면 다음과 같이 하십시오.

  1. DIVAnet 홈 디렉토리(DIVAnet이 설치된 위치)로 이동합니다.

  2. Program/conf/divanet/templates 폴더로 이동하고, DBSyncConfig.xml.ini를 상위 디렉토리로 복사하되, .ini 확장자는 제거합니다(../DBSyncConfig.xml).

  3. 다음 매개변수 설명 표를 참조해서 DBSyncConfig.xml 파일에서 매개변수를 편집하여 DbSync를 구성합니다.

부록 A에서는 샘플 DbSync 구성 파일을 보여줍니다.

테이블 4-10 DbSync 최상위 레벨 매개변수

매개변수
설명
기본값

LocalSitename

로컬 DIVAnet 사이트(DbSync가 실행 중인 사이트)의 사이트 이름입니다. 나열된 사이트 이름은 DIVAnet 데이터베이스에 구성된 것과 일치해야 하며 ClientAdapterConfig.xmlManagerAdapter.xml 모두에 구성된 것과 일치해야 합니다. 이 구성을 통해 DbSync는 ManagerAdapter와 통신할 수 있습니다.

없음(필수)

LogDirectory

로그 파일이 생성되는 폴더입니다.

log/divanet/Dbsync 폴더

LogLevel

추적 파일 로깅이 수행되는 세부정보 레벨입니다(ERROR, WARN, INFO, DEBUG, TRACE).

INFO

InternalPollingRateMillis

정보를 위해 사이트가 폴링되는 기본 속도입니다. 네트워크 및/또는 시스템 속도가 느려질 경우에만 이 매개변수를 변경합니다.

2000

WebServicePort

관리 메시지를 DbSync에 전송하는 데 사용되는 포트입니다.

없음(선택사항)

SSLWebServicePort

수신되는 웹 서비스 연결에 SSL을 강제 적용해야 할 경우 True입니다.

true


DivaManager 섹션

DivaManagers 태그 내에 DivaManager 정의가 여러 개 표시될 수 있습니다. 테이블 4-11에서는 DivaManager 섹션의 일부로 표시될 수 있는 매개변수를 보여줍니다.

테이블 4-11 DbSync에 대한 DivaManagers 매개변수

매개변수
설명
기본값

BaseUrl

동기화에 사용할 DIVA Manager 플랫폼에서 서비스의 URL입니다. 기본적으로 이 URL은 ManagerAdapter에서 사용되는 WebServicePort로 한정되는 원격 ManagerAdapter의 네트워크 주소에 해당합니다.

없음(선택사항)

Sitename

객체 정보를 동기화할 사이트의 공식 이름입니다. 나열된 사이트 이름은 DIVAnet 데이터베이스에 구성된 것과 일치해야 하며 ClientAdapterConfig.xmlManagerAdapter.xml 모두에 구성된 것과 일치해야 합니다.

없음(필수)


DIVAnet 데이터베이스

테이블 4-12에 표시된 것처럼 DIVAnet 데이터베이스 매개변수를 구성합니다.

테이블 4-12 DIVAnetDatabase 매개변수

매개변수
설명
기본값

Address

데이터베이스의 IP 주소입니다.

localhost

Port

데이터베이스에 액세스하는 데 사용되는 포트입니다.

1521

User

스키마의 사용자 이름입니다.

없음(필수)

Password

스키마의 암호입니다.

없음(필수)

DbSiteId

Oracle SID(사이트 식별자)입니다.

lib5

DbServiceName

Oracle 서비스 이름입니다. DbSiteId 대신 제공할 수 있습니다.

없음(선택사항)


액세스 규칙 구성

DIVAnet에서는 클라이언트 응용 프로그램 및 사용자가 DIVAnet 작업 및 리소스에 대해 갖는 액세스 권한을 제어하기 위해 액세스 규칙을 사용합니다. 액세스 규칙은 세 가지 방법으로 실행할 수 있습니다.

  • ClientAdapter 서비스 내의 DIVAnet 요청(MultiDiva 모드)

  • ManagerAdapter 서비스 내의 DIVArchive 요청

  • Direct 모드 포트를 통해 ClientAdapter에 들어가는 DIVArchive 요청

액세스 규칙을 실행하려면 ClientAdapter 및(또는) ManagerAdapter 구성 파일에서 AccessRulesFilename 매개변수를 정의해야 합니다. 파일 이름은 경로 없이 제공해야 합니다. DIVAnet은 파일이 ClientAdapter 구성 파일과 동일한 디렉토리에 있다고 가정합니다.

액세스 규칙 실행 방법

ClientAdapter(MultiDiva 모드)에 정의된 액세스 규칙 세트는 DIVAnet 요청(로컬로 수신됨)에 대해 액세스 제어를 강제 적용합니다. ManagerAdapter 구성에 정의된 액세스 규칙 세트는 DIVArchive 요청(DIVAnet 요청을 충족시키기 위해 제출됨)에 대해 액세스 제어를 강제 적용합니다. 액세스 제어의 두 가지 레벨은 요청이 시작된 위치에서 서비스 레벨 규칙을 구성할 수 있게 해주고, 서비스 레벨 정책에 대한 예외사항으로 사이트별 규칙을 강제 적용할 수 있게 해줍니다.

ClientAdapter(Direct 모드)에 정의된 액세스 규칙 세트는 원격 시스템이 또 다른 DIVAnet 인스턴스 또는 DIVArchive 시스템인지 여부에 따라 DIVAnet 요청 또는 DIVArchive 요청에 액세스 제어를 강제 적용합니다. 이 모드에서는 추가 작업 유형을 규칙 세트에서 사용할 수 있습니다. 이러한 작업은 DIVArchive 특정 요청에 해당하며, 아래에서 자세히 설명합니다.

아카이브 예제

규칙 자체를 익히기 위해 예제를 바로 살펴보겠습니다. 다음 규칙은 Source/Destination DATA_EXP_PDAT1 또는 VID_FTP_3에서 admin 또는 operator로 연결하는 사용자에 대해 아카이브 작업을 허용하며, HDFeatures 또는 spm의 매체로 아카이브를 수행하고(속성의 순서는 중요하지 않음), POST 단어가 포함된 범주로 이름을 바꿀 수 있게 해줍니다.

<Include>
     <Operation>Archive</Operation>
     <Username>admin</Username>
     <Username>operator</Username>
     <ReqMedia>spm</ReqMedia>
     <ReqObjectCategory>*POST*</ReqObjectCategory>
     <ReqSourceDest>DATA_EXP_PDAT1</ReqSourceDest>
     <ReqSourceDest>VID_FTP_3</ReqSourceDest>
     <ReqMedia>HDFeatures</ReqMedia>
</Include>

복사 예제

다음 두 가지 규칙에서 GUI Workflow Profile의 Guest 사용자는 diva2에서 diva3으로 또는 그 반대로 복사를 수행하도록 허용되지 않습니다.

<Exclude>
     <WorkflowProfile>GUI</WorkflowProfile>
     <Username>guest</Username>
     <Operation>Copy</Operation>
     <SourceSitename>diva2</SourceSitename>
     <TargetSitename>diva3</TargetSitename>
</Exclude>
<Exclude>
     <Username>guest</Username>
     <WorkflowProfile>GUI</WorkflowProfile>
     <Operation>Copy</Operation>
     <SourceSitename>diva3</SourceSitename>
     <TargetSitename>diva2</TargetSitename>
</Exclude>

여기에서는 동일 사이트 내에서 발생하는 복사 작업을 명시적으로 제한하지 않아야 하기 때문에 두 가지 규칙이 사용되었습니다. 예를 들어, diva2 사이트에 있는 누군가가 객체를 새 테이프로 이동해야 할 수 있습니다(DIVAnet 사용). 이 경우 소스 및 대상 사이트 이름은 모두 diva2입니다! SourceSitenameTargetSitename 속성이 모두 포함된 단일 규칙이 있을 경우, diva2에서 diva2로 그리고 diva3에서 diva3으로의 복사가 제외됩니다.

아직 완료된 것이 아닙니다. 일치하는 포함 규칙이 적어도 하나 이상이 아니면 복사가 성공하지 않습니다.

<Include>
     <Operation>Copy</Operation>
     <WorkflowProfile>GUI</WorkflowProfile>
     <Username>guest</Username>
     <Operation>ApiConnect</Operation>
</Include>

이 경우, 매우 일반적인 포함 규칙은 필요한 기능을 제공하고, diva2에서 diva3으로 그리고 그 반대로를 제외한 모든 경우에 복사할 수 있는 기능을 제공합니다. 실제로 제외 규칙은 전혀 필요하지 않습니다. 하지만 일부 경우에는 제외 규칙을 사용하는 것이 더 쉬울 수 있습니다. 제외 규칙이 특정 작업과 일치할 경우, 하나 이상의 포함 규칙이 일치하더라도 해당 작업은 거부된다는 것에 주의해야 합니다.

포함 및 제외 규칙

요약하자면, 규칙은 포함 및 제외의 두 가지 유형이 있습니다. 하나 이상의 포함 규칙이 수행하려는 작업과 일치하지 않는 한 모든 요청에 대해 액세스가 거부됩니다. 하지만, 제외 규칙이 일치할 경우에는 일치하는 포함 규칙에 관계없이 작업이 자동으로 거부됩니다.

속성 유형

Delete, Copy, Restore, Partial File Restore, Cancel 및 Archive와 같은 요청에 대해 DIVAnet은 작업이 허용되는지 여부를 확인하기 위해 전체 액세스 규칙 세트를 실행합니다. 다음과 같은 변수가 검사됩니다.

  • 전송자 속성 - 연결의 워크플로우 프로파일, 메시지를 전송한 사용자 이름, 전송자의 IP 주소입니다.

  • 요청 속성 - Source/Destination, 소스/대상 사이트 이름, 요청된 매체, 주석 등입니다. 이러한 항목은 요청 자체에서 파생됩니다. 이러한 항목들 대부분은 Req 접두어가 표시되어 있습니다.

  • 객체 속성 - 객체가 저장된 매체, 스토리지 계획, 객체 크기 등입니다. 이러한 항목은 작업이 처리 중인 객체로부터 파생됩니다. 이러한 항목들 대부분은 Obj 접두어가 표시되어 있습니다.

다음 규칙은 세 가지 속성 유형을 모두 결합합니다. 이 규칙은 객체가 LA에 존재할 때만 사용자 diva가 뉴욕에서 사이트 삭제를 수행할 수 있습니다.

<Include>
     <Username>diva</Username>
     <Operation>Delete</Operation>
     <SubType>SiteDelete</SubType>
     <TargetSitename>NewYork</TargetSitename>
     <ObjOnSite>LosAngeles</ObjOnSite>
</Include>

DIVAnet 요청에 대한 규칙(ClientAdapter)

DIVAnet 요청은 MultiDiva 모드로 요청이 수신될 때 생성됩니다. 액세스 규칙은 이러한 DIVAnet 작업에 대해 만들 수 있습니다. 다음은 DIVAnet 요청과 관련된 일부 속성에 대한 세부정보입니다.

연결 작업

ApiConnect 및 WebConnect 작업은 ClientAdapter 연결을 설정하기 위해 반드시 포함해야 하는 특별한 작업입니다.

  • ApiConnect - 이 작업은 API 클라이언트 소켓 연결을 통해 ClientAdapter에 연결하는 기능을 제어합니다. 이 작업은 DIVA API 연결에 필요합니다.

  • WebConnect - 이 작업은 응용 프로그램이 웹 연결을 통해 연결하는 기능을 제어합니다(DIVAnetUI 및 DivanetAdmin). 이 작업은 DIVAnetUI 연결에 필요합니다.

이러한 작업이 사용자의 규칙과 일치할 경우, 이에 대한 일치 비교를 위해 전송자 속성만 제공된다는 것에 주의해야 합니다. 예를 들어, 클라이언트가 연결될 때 속성이 단순히 존재하지 않기 때문에 ApiConnect 작업 중 액세스 규칙을 실행하면 TargetSitename이 일치하지 않게 됩니다.

하위 유형(삭제)

삭제 작업에는 작업의 하위 유형을 나타내는 SubType 필드가 있습니다. SubType 필드는 삭제 작업과 함께 규칙에 포함하고 필요한 경우 여러 개의 SubType 매개변수를 제공할 수 있습니다. Delete SubType의 값은 다음과 같습니다.

  • GlobalDelete - 수행 중인 삭제 작업이 모든 사이트에서 객체의 전역 삭제인 경우 규칙과 일치합니다. 또한 DIVAnet에서 모든 남은 객체를 삭제하게 되는 사이트 삭제 작업과도 일치합니다.

  • SiteDelete - 삭제 작업이 특정 사이트의 모든 인스턴스에 대한 삭제일 경우 규칙과 일치합니다(사이트 이름은 TargetSitename 매개변수를 사용해서 규칙과 일치하는지 확인할 수 있음). 또한 요청자가 단일 인스턴스를 삭제하지만, 이 인스턴스가 해당 사이트에서 객체의 마지막 인스턴스인 경우, 작업이 이 SubType을 갖게 됩니다.

  • InstanceDelete - 이 삭제 작업은 사이트에서 단일 인스턴스를 삭제하며, 사이트에는 다른 인스턴스가 존재합니다.

규칙에 이 매개변수를 지정하면 허용된 삭제 작업의 범위를 강제 적용하는 데 유용합니다.

DIVArchive 요청에 대한 규칙(ManagerAdapter)

DIVAnet은 DIVArchive 요청에 대해서도 액세스 규칙을 실행할 수 있도록 허용합니다. ManagerAdapter에 정의된 액세스 규칙은 허용되는 DIVArchive 작업(DIVAnet 요청을 충족시키기 위해 전송된)을 지정합니다. DIVAnet 요청에 대해 유효한 작업만 규칙 세트에 지정할 수 있습니다. ManagerAdapter 규칙 세트에서 WorkflowProfile, TargetSitename 및 SubType 속성은 잘못된 속성입니다.

ClientAdapter 규칙 세트와 비슷하게, ManagerAdapter에 대해 연결을 설정할 수 있으려면 WebConnect 작업에 권한을 부여해야 합니다. 이러한 조건은 DbSync 작업에도 해당됩니다. SourceSitename 속성은 요청을 수행 중인 특정 사이트에 따라 달라집니다. ApiConnect 작업은 ManagerAdapter 액세스 규칙에서 사용할 수 없습니다.

규칙 일치

규칙과 일치하는지 확인할 때는 각 요청, 일치하는 객체 또는 요청 전송자의 실제 값에 대해 규칙의 속성을 비교합니다. 여기에서는 와일드카드가 허용됩니다(와일드카드로 별표(*) 사용). 태그 이름은 대소문자가 구분되지 않지만, 대부분의 값은 대소문자가 구분됩니다. Operation 태그는 각 규칙에서 필수입니다. 별표(*)가 포함된 Operation 태그를 제공해서 규칙이 모든 작업에 적용되도록 나타낼 수 있습니다. 하지만 모든 작업에 모든 속성이 유효하지는 않으므로 이렇게 할 때는 주의해야 합니다.

규칙(포함 또는 제외 규칙)에 있는 고유 속성은 비교 프로세스에서 논리적 AND로 결합됩니다. 하지만 단일 속성이 규칙에 두 번 이상 지정된 경우 해당 속성이 단일 표현식에서 논리적 OR로 결합됩니다.

액세스 규칙에 대해 요청된 작업이 일치하는지 비교할 때, DIVAnet은 규칙의 속성을 현재 수행 중인 작업에 적용할 수 있는지 여부를 확인합니다. 적용할 수 없는 경우, 해당 속성은 비교에 사용되지 않습니다.

규칙 세트 및 기본값

규칙은 규칙 세트로 그룹화할 수 있습니다. 각 포함-제외 규칙은 Ruleset 태그 안에 포함되어야 합니다. 각 수신 DIVAnet 작업은 모든 규칙 세트에 대해 일치하는지 비교됩니다. 규칙 세트는 내부에 포함된 모든 규칙에 대해 기본값으로 사용되는 속성을 포함할 수 있기 때문에 유용합니다. 비교 프로세스에서 각 규칙 세트의 기본 속성은 해당 속성이 규칙 내에 직접 지정된 것처럼 각 하위 규칙에 포함되어 있습니다. 워크플로우 프로파일은 요청되는 모든 DIVAnet 작업에 대해 채워지기 때문에 워크플로우 프로파일을 규칙 세트의 기본 속성으로 사용하는 것이 일반적입니다.

다음 속성은 규칙 세트 내에서 기본값으로 지정할 수 있습니다.

  • Username

  • NetAddress

  • WorkflowProfile(ClientAdapter 규칙)

또 다른 예제

다음 예제에서는 GUIWorkflowProfile로 연결된 사용자가 요청 및 자산을 보고, diva1 사이트에서 개별 인스턴스를 삭제할 수 있습니다. InstanceDeleteSubType은 사이트에 있는 특정 객체의 마지막 인스턴스를 제거하는 삭제를 거부합니다.

이 예제의 두번째 부분에서는 웹 또는 API 연결이든 서브넷 172.53에서 시작되는 모든 연결을 금지합니다. 여기에서는 해당 워크플로우 프로파일에 관계없이 모든 작업에 대해 이를 수행합니다.

<Ruleset>
     <WorkflowProfile>GUI</WorkflowProfile>
     <Include>
          <Operation>WebConnect</Operation>
          <Operation>Delete</Operation>
          <SubType>InstanceDelete</SubType>
          <TargetSitename>diva1</TargetSitename>
     </Include>
</Ruleset>
<Ruleset>
     <NetAddress>172.53*</NetAddress>
     <Exclude>
          <Operation>ApiConnect</Operation>
          <Operation>WebConnect</Operation>
     </Exclude>
</Ruleset>

규칙 세트 매개변수

테이블 4-13에서는 Ruleset 섹션 아래에 표시할 수 있는 매개변수를 보여줍니다.

테이블 4-13 규칙 세트 매개변수

매개변수
설명
기본값

WorkflowProfile

ClientAdapter 구성에 정의된 이 속성은 DIVAnet에 액세스하는 작업 그룹 또는 응용 프로그램 세트의 이름입니다. 이 속성은 규칙 세트에 있는 모든 규칙으로 구성됩니다.

없음(선택사항)

Username

API로 전달되었거나 웹 요청에 지정된 사용자 이름입니다. 이 속성은 규칙 세트에 있는 모든 규칙으로 구성됩니다.

없음(선택사항)

NetAddress

원격 연결의 네트워크 주소(IP 또는 인터넷 이름)입니다. 이 주소는 전송자의 주소가 아니라 게이트웨이 또는 라우터의 주소일 수 있습니다. 이 속성은 규칙 세트에 있는 모든 규칙으로 구성됩니다.

없음(선택사항)

Exclude

DIVAnet 작업과 일치할 경우 권한을 거부하는 규칙입니다.

없음(선택사항)

Include

DIVAnet 작업과 일치할 경우 권한을 허용하는 규칙입니다.

없음(선택사항)


포함/제외 규칙 매개변수

요청에 표시되는 규칙 속성을 지정할 수 있습니다. 예를 들어, ReqMedia는 요청(작업)에 지정된 매체 및(또는) 스토리지 계획이 규칙과 일치하는지 비교합니다.

비슷한 방식으로, 요청이 처리 중인 아카이브된 객체에 대해 일치하는지 비교하는 규칙 속성을 지정할 수 있습니다. 예를 들어, 특정 객체가 삭제 작업에 지정된 경우 ObjHasMedia는 요청에 전달된 매체에 관계없이 해당 아카이브된 객체에 현재 속하는 모든 매체가 규칙과 일치하는지 비교합니다.

테이블 4-14에서는 Include 또는 Exclude 규칙 섹션에 표시할 수 있는 매개변수를 보여줍니다.

테이블 4-14 규칙 작업 매개변수(포함 또는 제외)

매개변수
설명
기본값

Operation

일치하는지 비교할 DIVAnet 작업의 이름입니다.

  • Archive

  • Copy

  • Restore

  • PartialRestore

  • Delete

  • Cancel

  • ApiConnect

  • WebConnect

  • ChangeConfig

Direct 모드에서는 DIVArchive 작업에 대해 다음과 같은 추가 작업을 사용할 수 있습니다.

  • CopyToNew

  • InsertTape

  • EjectTape

  • AssociativeCopy

  • TranscodeArchived

  • TransferFiles

  • ServerDelete

  • ChangePriority

없음(선택사항)

Username

연결된 API 사용자 및(또는) 서비스 사용자의 사용자 이름입니다.

없음(선택사항)

WorkflowProfile

ClientAdapter 프로파일 이름입니다.

없음(선택사항)

NetAddress

API 응용 프로그램 및(또는) 사용자의 IP 주소입니다.

없음(선택사항)

SourceSitename

작업의 소스 사이트 이름입니다. 일부 작업은 소스 사이트 이름을 포함하지 않습니다(예를 들어, 아카이브에는 Source/Destination이 소스로 포함됨). 다른 사이트에서 요청이 재시도되면, 이 값이 변경되고, 전체 규칙이 다시 평가됩니다. 이 속성이 ManagerAdapter 규칙에 표시될 경우에는 요청을 제출한 사이트에 대해 규칙과 일치하는지 비교합니다.

없음(선택사항)

TargetSitename

작업의 대상 사이트 이름입니다. 일부 작업은 대상 사이트 이름을 포함하지 않습니다(예를 들어, 복원에는 Source/Destination이 소스가 아닌 대상으로 포함됨). 다른 사이트에서 요청이 재시도되면, 이 값이 변경되고, 전체 규칙이 다시 평가됩니다.

없음(선택사항)

SubType

MultiDIVA 모드 작업 유형입니다(삭제 명령에는 GlobalDelete, SiteDelete 및 InstanceDelete가 포함됨).

없음(선택사항)


테이블 4-15 규칙 요청 매개변수(포함 또는 제외)

매개변수
설명
기본값

ReqObjectName

처리 중인 객체의 이름입니다.

없음(선택사항)

ReqObjectCategory

객체의 범주입니다(DIVArchive의 경우 객체의 공식 이름 중 일부임).

없음(선택사항)

ReqSourceDest

요청에 지정된 Source/Destination입니다.

없음(선택사항)

ReqComments

요청의 주석 필드입니다.

없음(선택사항)

ReqMedia

작업/요청의 일부로 요청된 매체입니다(사이트 이름은 추가되지 않아야 함). 스토리지 계획은 요청된 매체로 전달될 수 있습니다.

없음(선택사항)

ReqOptions

요청의 옵션 필드입니다.

없음(선택사항)


테이블 4-16 규칙 객체 매개변수(포함 또는 제외)

매개변수
설명
기본값

ObjOnSite

객체가 지정된 사이트에 존재할 경우 규칙과 일치합니다.

없음(선택사항)

ObjNotOnSite

객체가 지정된 사이트에 없을 경우 규칙과 일치합니다.

없음(선택사항)

ObjHasMedia

모든 사이트의 모든 매체와 일치합니다.

없음(선택사항)

ObjHasStoragePlan

모든 사이트의 스토리지 계획과 일치합니다(ObjStoragePlanSite는 한 사이트로 제한될 수 있음).

없음(선택사항)

ObjStoragePlanSite

지정된 스토리지 계획을 특정 사이트로 제한합니다.

없음(선택사항)

ObjHasSizeGbLessThan

부분 GB의 총 객체 크기가 지정된 값 미만일 경우 일치합니다.

없음(선택사항)

ObjHasSizeGbGreaterThan

부분 GB의 총 객체 크기가 지정된 값을 초과할 경우 일치합니다.

없음(선택사항)


구성 파일에 스크립트 변수 추가

DIVAnet은 여러 스크립트 파일을 더 쉽게 구성할 수 있도록 구성 파일에서 변수 대체를 허용합니다. ${variable_name} 패턴이 XML 값에서 발견될 경우(변수가 태그 이름에서 잘못됨), DIVAnet이 스크립트를 읽을 때 변수 값이 대체됩니다. 이 값은 환경 변수로부터 가져오거나 스크립트 내에서 직접 지정될 수 있습니다.

스크립트에서 변수 이름이 환경 변수와 동일하게 지정된 경우, 해당 변수의 값이 스크립트에서 대체됩니다. 또는 Variable 태그를 사용해서 각 스크립트의 맨 위에 변수 값을 정의할 수 있습니다. 구문: <Variable name="LocalSitename" value="diva1"/>. DIVAnet이 구성 스크립트를 읽을 때는 스크립트 내에 사용된 변수가 맨 위에 설정되어 있는지 여부를 확인합니다. 그렇지 않을 경우에는 변수와 동일한 이름의 환경 변수를 찾습니다.

쉽게 사용할 수 있도록 divanetEnv.conf라는 이름의 스크립트 변수가 DIVAnet 홈 디렉토리 내의 Program\conf\divanet\wrapper 하위 폴더에 생성되어 있습니다. 변수는 이 구성 파일에서 중앙 집중식으로 정의할 수 있으며, 모든 DIVAnet 서비스에 제공됩니다. 값이 변경되고, 서비스가 다시 시작되면 변경사항이 다시 읽혀집니다. 샘플 변수는 divanetEnv.conf 파일을 참조하십시오.