6 DIVAnet 관리

이 장에서는 DIVAnet 관리에 대해 설명합니다.

DIVAnetAdmin 유틸리티 사용

DIVAnetAdmin은 DIVAnet 관리 옵션이 포함된 간단한 명령줄 도구입니다. 이 유틸리티는 ClientAdapter 및 DbSync 서비스가 실행 중인 서버에서만 실행할 수 있습니다.

유틸리티를 시작하려면 명령 창을 연 후 DIVAnet 홈 디렉토리에서 Program/divanet/bin 하위 디렉토리로 이동합니다. 다음 명령 중 하나를 입력하여 유틸리티를 시작합니다.

Windows:

DIVAnetAdmin.bat ClientAdapterWebUrl DbSyncWebUrl

Linux:

DIVAnetAdmin.sh ClientAdapterWebUrl DbSyncWebUrl

주:

URL 인수를 제공하지 않을 경우 유틸리티는 ClientAdapter 및 DbSync 서비스가 로컬로 실행 중인 것으로 간주하고, ClientAdapter 및 DbSync 서비스 포트를 묻는 프롬프트를 표시합니다.

테이블 6-1에서는 메뉴 시스템을 통해 선택할 수 있는 DIVAnetAdmin 옵션을 보여줍니다.

테이블 6-1 DIVAnetAdmin 옵션

범주
옵션
설명

자산 데이터베이스 동기화

List Synced Sites

자산 정보를 동기화 중인 사이트의 목록을 생성합니다. 또한 각 사이트의 동기화 상태도 표시합니다. 사이트가 최초 동기화 상태인 경우 완료된 백분율도 표시됩니다.

자산 데이터베이스 동기화

Resync a Site

특정 사이트의 모든 객체 레코드를 DIVAnet 데이터베이스에 다시 동기화합니다.

주의: 이 옵션은 레코드를 다시 동기화하기 전에 DIVAnet 데이터베이스(선택한 사이트)에 있는 모든 자산 레코드를 삭제합니다.

자산 데이터베이스 동기화

Resync an Object

특정 사이트에서 특정 객체에 대한 객체 레코드를 업데이트합니다. 삭제는 동기화하지 않습니다.

API 연결

List API Connection

Direct 모드의 연결을 포함해서 모든 클라이언트 DIVAnet API 연결을 나열합니다.

API 연결

End API Connection

ID로 식별된 특정 API 연결을 종료하기 위한 옵션을 제공합니다.

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

Reload Workflow Profiles

이 옵션은 모든 워크플로우 프로파일이 다시 로드되도록 합니다. 또한 정의된 모든 액세스 규칙도 다시 로드합니다.

액세스 규칙이 정의된 경우 이 옵션은 ChangeConfig 작업에 대한 액세스가 필요합니다.

사이트 매개변수

Show Site Parameters

이 옵션은 사이트에 대해 대기열에 있는 요청 수, 각 사이트에서 실행 중인 요청 수(DIVAnet이 전송), 사이트와 마지막으로 통신한 날짜 및 제한 매개변수를 포함해서 DIVA 사이트 매개변수를 표시합니다.

사이트 매개변수

Set Site Parameters

이 옵션을 사용하면 사용자가 DIVA 제한 매개변수를 설정할 수 있습니다.

  • SubmittedThrottleThreshold는 요청 중 하나가 완료될 때까지 기다리기 전에 DIVA가 사이트에 전송해야 하는 요청 수를 제어합니다.

  • TotalThrottleThreshold도 비슷하지만 DIVA 사이트에서 실행 중인 총 요청 수를 기반으로 합니다. DIVAnet은 총 DIVA 요청 수가 이 숫자 아래로 떨어질 때까지 기다린 후에 다음 요청을 전송합니다.

액세스 규칙이 정의된 경우 이 옵션은 ChangeConfig 작업에 대한 액세스가 필요합니다.

런타임 통계

Show Runtime Stats: ClientAdapter

이 옵션은 ClientAdapter 서비스에 대해 유용한 런타임 통계를 표시합니다.

런타임 통계

Show Runtime Stats: DbSync

이 옵션은 DbSync 서비스에 대해 유용한 런타임 통계를 표시합니다.

로그 레벨

Set Log Level: ClientAdapter

이 옵션은 ClientAdapter 서비스의 로그 레벨을 나열하고, 로그 레벨을 동적으로 변경할 수 있는 옵션을 제공합니다(유효한 값은 ERROR, WARN, INFO, DEBUG, TRACE).

로그 레벨

Set Log Level: DbSync

이 옵션은 DbSync 서비스의 로그 레벨을 나열하고, 로그 레벨을 동적으로 변경할 수 있는 옵션을 제공합니다(유효한 값은 ERROR, WARN, INFO, DEBUG, TRACE).


DIVAnet은 다음과 같은 유형의 로그 파일을 만듭니다.

  • 추적 로그 - DIVAnet 홈 디렉토리 내의 Program/log/divanet 하위 폴더에 있습니다. 각 DIVAnet 서비스(ManagerAdapter, DbSync 및 ClientAdapter)는 Program/log/divanet 폴더 아래에 고유 하위 폴더를 만들고 해당 하위 디렉토리에 해당 로그 파일을 만듭니다.

  • 래퍼 서비스 로그 - 이러한 로그는 Windows 서비스의 시작 및 종료와 관련된 메시지를 출력합니다. 서비스가 올바르게 시작하지 않으면 이 로그를 조사해야 합니다. 이러한 로그는 DIVAnet 홈 디렉토리 내의 Program/log/divanet 하위 폴더에 있습니다. Wrapper.conf 파일과 비슷한 이름이 지정되지만, 파일 이름 확장자로 .log가 사용됩니다(예: ManagerAdapterWrapper.log).

  • GUI 로그 - DIVAnetUI에서 발생하는 오류는 서버측이 아닌 클라이언트 컴퓨터에 표시됩니다. 로그는 Program/log/divanet/gui 하위 폴더에 표시됩니다.

DIVAnet은 1시간보다 오래된 로그를 zip 파일로 패키지화하고 2일 분량의 로그를 검토할 수 있도록 보존합니다.

요청 처리 및 대기열에 넣기

다음 절에서는 DIVAnet 요청의 대기열 넣기 및 처리에 대해 설명합니다.

DIVAnet 요청 대기열에 넣기

DIVAnet은 다운스트림 DIVArchive 시스템이 요청 대기열로 처리할 수 있는 것보다 많은 요청을 수락할 수 있습니다. DIVAnet은 GlobalDivanetRequestLimit 매개변수를 사용해서 대기열에 넣고(또는) 내부적으로 실행될 수 있는 최대 요청 수(기본값 5000)를 강제 적용합니다. 이 제한에 도달한 경우 DIVAnet에서 요청 거부가 시작됩니다. DIVAnet ClientAdapter 서비스는 각 사이트에 대해 대기열을 유지 관리합니다. 사이트에 요청을 천천히 공급하거나 사이트에 전체 요청을 한 번에 전송하도록(이 경우에는 DIVArchive가 요청을 대기열에 넣을 수 있음) DIVAnet을 구성할 수 있습니다.

요청이 DIVArchive 시스템에서 대기열에 들어가고, DIVA 시스템이 다시 시작되면, 실행 중인 모든 요청이 종료됩니다. DIVAnet은 다르게 작동합니다. DIVAnet은 각 요청을 데이터베이스에 저장합니다. ClientAdapter 서비스가 다시 시작되면 DIVAnet이 보류 중인 요청 및 실행 중인 요청을 읽고 이를 다시 시작합니다. 하지만 모든 요청이 이러한 방식으로 다시 시작되지는 않습니다. 예를 들어, 삭제 요청은 서비스가 다시 시작된 후에 다시 실행되지 않습니다. 시작 시 요청 복구가 필요하지 않을 경우에는 시작 시 대기열에 있는 모든 요청을 종료하도록 ClientAdapter AbortAllOnStartup 매개변수를 설정할 수 있습니다.

DIVAnet 요청 제한

기본적으로 DIVAnet은 100개의 요청을 전송한 후에 전송을 중지하고 요청 중 하나가 완료될 때까지 기다립니다. 이러한 제한을 제어하는 매개변수는 사이트별 기준으로 ClientAdapter에서 구성할 수 있는 SubmittedThrottleThreshold입니다. 런타임에는 DIVAnetAdmin 유틸리티를 통해 변경할 수도 있습니다. 또한 DIVAnet은 DIVArchive 사이트에서 실행 중인 총 요청 수를 기준으로 요청을 제한할 수 있습니다(TotalThrottleThreshold 매개변수 사용). 둘 중 어느 매개변수라도 -1로 설정해서 제한이 수행되지 않도록 할 수 있습니다. 또한 값을 0으로 설정하면 대기열에 있는 요청이 DIVArchive로 전송되지 않습니다. 이러한 설정은 특정 상황에서 유용할 수 있습니다.

DIVAnet 요청이 특정 사이트에서 몇 초 이상 대기열에 있을 경우, DIVAnetUI는 대기열에서 해당 요청의 위치를 표시합니다. 처음 요청보다 우선순위가 높은 다른 요청이 대기열에 들어가면, 대기열에서 더 높은 위치를 갖게 될 가능성이 있습니다. 요청이 실패하고 재시도되면, 시스템에 오랫동안 존재하여 우선순위가 높아지더라도 요청이 다시 대기열에 들어갑니다.

DIVAnet 요청 재시도

일부 요청은 DIVAnet 내에서 자동으로 재시도될 수 있습니다. 복사, 복원, 부분 파일 복원 및 삭제 요청은 재시도될 수 있습니다. 복원 & 부분 파일 복원 요청은 구성 가능한 횟수만큼 재시도될 수 있으며, 복사 및 삭제 요청은 구성 가능한 기간 동안 재시도됩니다. 재시도는 워크플로우 프로파일별 기준으로 지정할 수 있으며, ClientAdapter를 다시 시작하지 않아도 런타임에 수정할 수 있습니다(자세한 내용은 워크플로우 프로파일 구성 참조).

사이트가 작동 중지되고 요청이 해당 사이트의 대기열에 들어가면, 사이트가 작동 가능 상태가 될 때까지 DIVAnet이 SiteDownRequeueWaitMins분 동안 기다립니다. 구성된 기간이 경과하고, 재시도가 구성된 경우 DIVAnet은 가능한 경우 다른 사이트에서 요청을 재시도합니다. 재시도가 구성되지 않은 경우에는 요청이 종료됩니다.