이 장에서는 DIVAnet 관리에 대해 설명합니다.
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 옵션을 보여줍니다.
범주 |
옵션 |
설명 |
---|---|---|
자산 데이터베이스 동기화 |
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 제한 매개변수를 설정할 수 있습니다.
액세스 규칙이 정의된 경우 이 옵션은 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은 다운스트림 DIVArchive 시스템이 요청 대기열로 처리할 수 있는 것보다 많은 요청을 수락할 수 있습니다. DIVAnet은 GlobalDivanetRequestLimit
매개변수를 사용해서 대기열에 넣고(또는) 내부적으로 실행될 수 있는 최대 요청 수(기본값 5000)를 강제 적용합니다. 이 제한에 도달한 경우 DIVAnet에서 요청 거부가 시작됩니다. DIVAnet ClientAdapter 서비스는 각 사이트에 대해 대기열을 유지 관리합니다. 사이트에 요청을 천천히 공급하거나 사이트에 전체 요청을 한 번에 전송하도록(이 경우에는 DIVArchive가 요청을 대기열에 넣을 수 있음) DIVAnet을 구성할 수 있습니다.
요청이 DIVArchive 시스템에서 대기열에 들어가고, DIVA 시스템이 다시 시작되면, 실행 중인 모든 요청이 종료됩니다. DIVAnet은 다르게 작동합니다. DIVAnet은 각 요청을 데이터베이스에 저장합니다. ClientAdapter 서비스가 다시 시작되면 DIVAnet이 보류 중인 요청 및 실행 중인 요청을 읽고 이를 다시 시작합니다. 하지만 모든 요청이 이러한 방식으로 다시 시작되지는 않습니다. 예를 들어, 삭제 요청은 서비스가 다시 시작된 후에 다시 실행되지 않습니다. 시작 시 요청 복구가 필요하지 않을 경우에는 시작 시 대기열에 있는 모든 요청을 종료하도록 ClientAdapter AbortAllOnStartup
매개변수를 설정할 수 있습니다.
기본적으로 DIVAnet은 100개의 요청을 전송한 후에 전송을 중지하고 요청 중 하나가 완료될 때까지 기다립니다. 이러한 제한을 제어하는 매개변수는 사이트별 기준으로 ClientAdapter에서 구성할 수 있는 SubmittedThrottleThreshold
입니다. 런타임에는 DIVAnetAdmin 유틸리티를 통해 변경할 수도 있습니다. 또한 DIVAnet은 DIVArchive 사이트에서 실행 중인 총 요청 수를 기준으로 요청을 제한할 수 있습니다(TotalThrottleThreshold
매개변수 사용). 둘 중 어느 매개변수라도 -1로 설정해서 제한이 수행되지 않도록 할 수 있습니다. 또한 값을 0으로 설정하면 대기열에 있는 요청이 DIVArchive로 전송되지 않습니다. 이러한 설정은 특정 상황에서 유용할 수 있습니다.
DIVAnet 요청이 특정 사이트에서 몇 초 이상 대기열에 있을 경우, DIVAnetUI는 대기열에서 해당 요청의 위치를 표시합니다. 처음 요청보다 우선순위가 높은 다른 요청이 대기열에 들어가면, 대기열에서 더 높은 위치를 갖게 될 가능성이 있습니다. 요청이 실패하고 재시도되면, 시스템에 오랫동안 존재하여 우선순위가 높아지더라도 요청이 다시 대기열에 들어갑니다.
일부 요청은 DIVAnet 내에서 자동으로 재시도될 수 있습니다. 복사, 복원, 부분 파일 복원 및 삭제 요청은 재시도될 수 있습니다. 복원 & 부분 파일 복원 요청은 구성 가능한 횟수만큼 재시도될 수 있으며, 복사 및 삭제 요청은 구성 가능한 기간 동안 재시도됩니다. 재시도는 워크플로우 프로파일별 기준으로 지정할 수 있으며, ClientAdapter를 다시 시작하지 않아도 런타임에 수정할 수 있습니다(자세한 내용은 워크플로우 프로파일 구성 참조).
사이트가 작동 중지되고 요청이 해당 사이트의 대기열에 들어가면, 사이트가 작동 가능 상태가 될 때까지 DIVAnet이 SiteDownRequeueWaitMins
분 동안 기다립니다. 구성된 기간이 경과하고, 재시도가 구성된 경우 DIVAnet은 가능한 경우 다른 사이트에서 요청을 재시도합니다. 재시도가 구성되지 않은 경우에는 요청이 종료됩니다.