DIVAnet은 분산형 응용 프로그램입니다. 즉, 여러 시스템에 설치되는 경우가 많습니다. DIVAnet을 설치해야 하는 시스템 및 서버를 이해하고 설치해야 하는 특정 DIVAnet 서비스를 이해하기 위해서는 제 2 장을 참조하십시오.
DIVAnet에 연결된 각 DIVArchive 사이트는 DIVArchive 7.3.1 이상을 실행해야 합니다.
DIVAnet은 64비트 Windows 플랫폼 또는 64비트 Oracle Linux 플랫폼(릴리스 7 이상)에 설치할 수 있습니다. DIVAnet은 DIVArchive와 동일한 홈 디렉토리 또는 고유 디렉토리에 설치할 수 있습니다.
Windows 시스템에서 DIVAnet 설치 프로그램을 실행하려면 관리자 권한이 필요합니다. Linux 시스템에서 DIVAnet 설치 프로그램을 실행하려면 diva라는 사용자가 필요합니다.
기본적으로 DIVAnet 설치 프로그램은 DIVAnet 서비스 파일, DIVAnetUI 및 호환 가능한 64비트 Java 8 JRE(Java Runtime Environment) 설치를 처리합니다. DIVAnet을 실행하려면 JRE가 설치되어 있어야 합니다. DIVAnet 데이터베이스를 설치하려면 Oracle Database 11g 릴리스 2 이상 및 Oracle SQLPlus(Oracle 11 이상 클라이언트 소프트웨어)가 DIVAnet 시스템에 직접 설치되어 있어야 합니다.
DIVAnet을 다시 설치할 때는 실행 중인 DIVAnet 구성요소가 없는지 확인하십시오.
DIVAnet은 Windows 또는 Oracle Linux 7 운영체제에 설치할 수 있습니다. 다음 세부 절에서는 각 플랫폼에 설치하는 방법에 대해 설명합니다.
DIVAnet을 Windows 환경에 설치하려면 다음 절차를 수행하십시오.
관리자 권한을 가진 계정을 사용하여 DIVAnet 설치 프로그램 실행 파일 DIVAnet_V2.1.version.exe를 실행합니다.
원하는 구성요소를 선택한 후 Next를 누릅니다.
대상 디렉토리에 이전에 Java가 설치되지 않았으면 선택합니다.
DIVAnet 사용자 인터페이스만 설치하려면 DIVAnet Services를 선택 해제합니다.
대상 설치 디렉토리를 지정합니다. 이 위치는 DIVAnet 홈 디렉토리가 됩니다. 그런 후 Install을 누릅니다.
주:
DIVArchive 설치 디렉토리를 DIVAnet 홈 디렉토리로 사용할 수 있습니다. 하지만, Oracle은 DIVAnet을 고유 디렉토리에 설치할 것을 권장합니다.Linux에서 실행하는 경우 diva라는 사용자와 divanetsvc라는 사용자를 만들어야 합니다. divanetsvc 사용자는 diva가 소유한 파일에 대해 쓰기, 읽기 및 쓰기 권한을 가지고 있어야 합니다. diva 사용자는 Linux systemctl 명령에 대해 sudo 권한을 갖고 있어야 합니다. 설치는 diva 사용자, admin 사용자 또는 root로 실행해야 합니다. 소프트웨어를 설치하기 전에 diva 사용자를 만들어야 합니다. 설치 전에 diva 및 divanetsvc 사용자를 만드는 옵션은 설치 프로그램에서 제공합니다.
DIVAnet을 Linux 환경에 설치하려면 다음 절차를 수행하십시오.
터미널 세션을 열고 DIVAnet 릴리스의 상위 디렉토리로 이동합니다.
DIVAnet 설치 패키지(예: DIVAnet-2.1-RELEASE.sh)를 이 디렉토리에 배치합니다. 설치 프로그램이 DIVAnet을 이 상위 디렉토리의 하위 디렉토리에 설치할 수 있습니다.
다음 명령을 사용하여 DIVAnet 설치를 시작합니다.
sh ./DIVAnet-2.1-RELEASE.sh
설치 프로그램이 소프트웨어 설치 전에 필요한 diva 및 divanetsvc Linux 사용자를 만드는 옵션을 제공합니다. 사용자가 설치되고 올바른 권한이 지정되면 DIVAnet 소프트웨어 설치 옵션을 선택합니다.
DIVAnet을 설치할 하위 디렉토리 이름을 묻는 메시지가 표시됩니다. Enter 키를 눌러 기본 하위 디렉토리인 DIVAnet을 사용하거나, 사용자정의 하위 디렉토리 이름을 지정한 다음 Enter 키를 눌러 설치 디렉토리를 만듭니다.
DIVAnet 설치 프로세스가 시작되며, 모든 파일과 폴더가 지정된 대상 디렉토리로 추출됩니다.
다음 절에서는 설치를 완료하기 위해 수행해야 할 수 있는 추가 단계에 대해 설명합니다. 자세한 내용은 제 2 장을 참조하십시오.
DIVAnet 데이터베이스를 만들려면 먼저 DIVAnet 테이블을 만든 후 DIVArchive 사이트를 구성합니다.
이 단계에서는 실행 중인 Oracle 서버에 존재하게 될 DIVAnet 데이터베이스 테이블을 만듭니다. 이 단계는 전체 DIVAnet 설치의 경우에만 필요합니다(제 2 장 참조).
SQL 만들기 스크립트를 실행하려면 DIVAnet을 설치하려는 시스템에 SQLPlus(Oracle 11g 이상 클라이언트 소프트웨어)가 설치되어 있어야 합니다. sqlplus 유틸리티의 경로는 시스템의 PATH 환경 변수에 있어야 합니다.
명령줄 창 또는 터미널 셸을 엽니다. 디렉토리를 DIVAnet 홈 디렉토리(DIVAnet이 설치된 디렉토리)로 변경합니다.
디렉토리를 Program/Database/divanet/Install로 변경합니다.
다음 명령을 실행합니다.
Windows:
create_divanet_user.bat {syspassword} {username} {userpassword} {oracle_tns_name}
Linux:
create_divanet_user.sh {syspassword} {username} {userpassword} {oracle_tns_name}
위 명령에서 syspassword는 Oracle 시스템 암호이고, username은 DIVAnet 테이블이 포함될 Oracle 사용자 이름/스키마 이름이며, oracle_tns_name은 설치에 사용하려는 DIVAnet 데이터베이스의 Oracle TNS 이름입니다. 데이터베이스에 대해 정의된 TNS 이름이 없으면, 다음 절을 참조해서 TNS 이름을 실시간으로 만들 수 있습니다.
DIVAnet 데이터베이스 스키마를 삭제하려면 다음 단계를 수행합니다.
주의:
이 경우 DIVAnet 데이터베이스의 모든 데이터가 삭제됩니다.디렉토리를 Program/Database/divanet/Install로 변경합니다.
다음 명령을 실행합니다.
Windows:
delete_divanet_user.bat syspassword username oracle_conn_string
Linux:
delete_divanet_user.sh syspassword username oracle_conn_string
위 명령에서 syspassword는 Oracle 시스템 암호이고, username은 DIVAnet 테이블이 포함될 Oracle 사용자 이름 또는 스키마 이름이며, oracle_conn_string은 사용하려는 DIVAnet 데이터베이스의 Oracle TNS 이름 또는 설치를 위한 Oracle 연결 문자열(다음 절 참조)입니다. 데이터베이스에 대해 정의된 TNS 이름이 없으면, 다음 절을 참조해서 추가 및 삭제 스크립트에 사용할 Oracle 연결 문자열을 만듭니다.
데이터베이스에 대해 정의된 TNS 이름이 없으면, Oracle 연결 문자열을 제공할 수 있습니다. 이 문자열의 형식은 다음과 같습니다.
netaddress:port/remote_servicename
설명:
netaddress: 데이터베이스가 실행되는 네트워크 주소
port: 클라이언트가 연결할 수 있는 포트
remote_servicename: Oracle 원격 서비스 이름. 이 이름은 로컬에서 사용되는 서비스 이름과 다릅니다. DIVA Oracle 데이터베이스 설치 패키지의 기본값은 lib5.world입니다. 전체 연결 문자열 예는 183.34.34.67:1521/lib5.world입니다.
DIVAnet 테이블을 만든 후에는 DIVAnet 데이터베이스에서 DIVA 사이트를 구성해야 합니다. addSites 스크립트를 실행하여 다음과 같이 데이터베이스에서 사이트를 구성합니다.
DIVAnet 홈 디렉토리로 변경한 후 Program/divanet/bin 하위 폴더로 이동합니다.
addSites 스크립트를 실행합니다:
Windows: addSites.bat
Linux: addSites.sh
이 스크립트는 사이트 이름 레코드를 추가하고 사이트 이름, 위치 및 주석을 구성합니다. 사이트에 대한 네트워크 연결은 ClientAdapter 구성 파일에 구성되어 있습니다(제 4 장 참조). 사이트 이름을 만들 때는 읽기 쉽고 물리적 위치 또는 사이트의 기능을 나타내는 이름을 사용해야 합니다.
주:
이 단계에서 제공하는 사이트 이름은 로컬 및 원격 DIVAnet 서비스를 구성할 때 사용됩니다.addSites 스크립트를 실행하기 전에 원하는 사이트 이름이 일관적으로 협의되어 있는지 확인합니다. 명령 실행 중 실수한 경우 addSites 스크립트에서 사이트를 논리적으로 삭제할 수 있습니다. 사이트 이름이 데이터베이스에 준비된 다음에는 DIVAnet 설치를 계속할 수 있습니다.제 2 장을 참조해서 구성해야 하는 DIVAnet 서비스를 확인하고, 제 4 장에서 각 서비스의 구성 방법에 대한 세부정보를 참조하십시오.
DIVAnet 홈 디렉토리 아래의 Program/conf/divanet/templates 하위 디렉토리에는 구성해야 하는 각 DIVAnet 서비스에 대한 템플리트 구성 파일이 있습니다. 각 템플리트 파일은 확장자가 .ini입니다. 각 파일을 가져와서 상위 디렉토리에 복사해야 합니다(이 경우에는 Program/conf/divanet). 각 파일을 복사할 때는 .ini 확장자를 제거해야 합니다.
각 .ini 파일 위에는 사용 가능한 매개변수에 대한 설명이 있습니다. 각 DIVAnet 사이트에 대해 ManagerAdapterConfig.xml을 구성합니다. 전체 DIVAnet 설치의 경우에는 ClientAdapterConfig.xml 및 DBSyncConfig.xml 파일도 구성합니다.
이러한 매개변수 중 대부분은 기본값 그대로 둘 수 있습니다. Program/conf/divanet/wrapper 폴더의 구성 파일은 변경할 필요가 없습니다. divaEnv.conf 파일에는 선택적으로 정보를 추가할 수 있습니다(자세한 내용은 구성 파일에 스크립트 변수 추가 참조).
주:
이 설명서를 읽은 후에도 기본값에서 수정해야 할 매개변수에 대해 이해하기 어려운 경우 오라클 고객지원센터로 문의하십시오.설치 및 구성해야 하는 서비스를 확인하려면 제 2 장을 참조하십시오.
구성 파일이 올바르게 설정된 다음에는 DIVAnet 서비스를 설치하고 시작합니다. 각 DIVAnet 사이트에 설치하려는 모든 서비스에 대해 각 단계를 수행합니다.
DIVAnet 서비스를 Windows 환경에 설치하려면 다음 절차를 수행하십시오.
DIVAnet 홈 디렉토리(DIVAnet이 설치된 위치)로 변경합니다.
Program/divanet/bin 폴더로 이동합니다.
InstallDivanetService.bat 스크립트를 실행하여 설치 중인 서비스에 대한 래퍼 구성 파일을 제공합니다. 예를 들어, ManagerAdapter 서비스(DIVAnet에 연결할 Manager가 실행 중인 모든 사이트에 필요)를 설치하려면 다음 명령을 실행합니다.
InstallDivanetService.bat ../../conf/divanet/wrapper/ManagerAdapterWrapper.conf
ClientAdapter 서비스에 대해 동일한 명령 및 동일한 경로를 사용하되, ClientAdapterWrapper.conf는 해당 파일 이름으로 대체합니다.
DbSync 서비스의 경우에는 파일 이름 DBSyncWrapper.conf를 사용합니다.
Windows Services(Windows 서비스) 창에서는 다음과 같은 DIVAnet 서비스가 하나 이상 표시됩니다.
Divanet ManagerAdapter
Divanet ClientAdapter
Divanet DbSync
서비스는 아무 순서로나 시작될 수 있지만, DbSync 서비스 및 ManagerAdapter 서비스가 모두 시작된 다음에는 데이터베이스 동기화 프로세스가 자동으로 시작된다는 것에 주의하십시오. ClientAdapter 서비스를 시작해서 새로운 DIVAnet 연결 및 API 처리를 허용합니다.
DIVAnet 서비스를 Linux 환경에 설치하려면 다음 절차를 수행하십시오.
터미널 세션을 열고 Program/divanet/bin 디렉토리로 이동합니다.
divanetservice 스크립트를 실행하여 원하는 서비스(DbSync, ClientAdapter 또는 ManagerAdapter)를 설치합니다. 예를 들어 ClientAdapter를 설치하려면 다음 명령을 입력합니다.
./divanetservice install ClientAdapter
Linux DIVAnet 서비스를 만든 후에는 다음 명령을 사용하여 관리할 수 있습니다.
| 작업 |
명령 |
|---|---|
|
모든 서비스 나열 |
|
|
서비스 시작 |
|
|
서비스 중지 |
|
|
서비스 다시 시작 |
|
|
서비스 설치 |
|
|
서비스 설치 해제 |
|
service_name 매개변수는 DbSync, ClientAdapter 또는 ManagerAdapter일 수 있습니다. DIVAnet 서비스는 표준 Linux 시스템 V systemctl 명령 구문을 사용하여 관리할 수도 있습니다. Linux 명령 프롬프트에 man systemctl을 입력하면 systemctl 명령에 대한 자세한 정보를 볼 수 있습니다.
DIVAnet 응용 프로그램은 두 가지 기본 유형의 로그를 생성합니다.
추적 로그 - DIVAnet 홈 디렉토리 내의 Program/log/divanet 하위 폴더에 있습니다. 각 DIVAnet 서비스(ManagerAdapter, DbSync 및 ClientAdapter)는 Program/log/divanet 폴더 아래에 고유 하위 폴더를 만들고 해당 하위 디렉토리에 해당 로그 파일을 만듭니다.
래퍼 서비스 로그 - 응용 프로그램이 올바르게 시작되는지 확인하려면 이 로그를 먼저 조사하십시오. 이러한 로그는 DIVAnet 홈 디렉토리 내의 Program/log/divanet 하위 폴더에 있습니다. Wrapper.conf 파일과 비슷한 이름이 지정되지만, 파일 이름 확장자로 .log가 사용됩니다(예: ManagerAdapterWrapper.log).
DIVAnet을 구성할 때 가장 일반적인 오류는 사이트 이름을 지정할 때의 오류입니다. DIVAnet 네트워크에 있는 모든 DIVA 사이트는 동일한 사이트 이름 세트를 사용해야 합니다. 사이트 이름은 모든 구성 파일 및 DIVAnet 데이터베이스에서 일관적이어야 합니다. LocalSitename 매개변수는 모든 서비스 구성 파일에 올바르게 구성되어 있어야 합니다.
또한 DIVArchive Source/Destination도 확인해야 합니다. 예를 들어, 기본적으로 diva1 사이트에 diva2 사이트에 있는 것과 같은 이름의 Source/Destination이 있을 경우, DIVAnet은 이러한 두 항목이 동일한 논리적 Source/Destination을 가리킨다고 가정합니다. 동일한 Source/Destination 이름이 두 개의 서로 다른 DIVArchive 사이트에 구성된 경우, DIVAnet은 이러한 Source/Destinations가 동일한 위치를 참조한다고 가정합니다.
DbSync 서비스가 시작되면, ManagerAdapter 서비스를 참조하여 아카이브된 객체 정보를 동기화하려고 시도합니다. 그런 다음 ManagerAdapter 서비스는 서비스가 연결된 DIVArchive 사이트로부터 자산 정보를 가져옵니다. 따라서 DbSync 서비스 및 ManagerAdapter 서비스는 동기화를 시작할 준비가 되었을 때만 시작해야 합니다.
주:
DbSync 서비스를 중지하면 서비스가 다시 시작될 때 이전에 중지한 위치에서부터 동기화가 다시 시작됩니다.DivanetAdmin 명령줄 도구는 사이트 간 기준에 따라 데이터베이스 동기화 상태를 모니터합니다. DIVAnet이 특정 사이트의 최초 동기화를 수행 중인 경우에는 해당 최초 동기화 작업의 완료 백분율이 표시됩니다. 사이트가 최신 상태일 경우, DivanetAdmin은 사이트를 In Sync 상태로 표시합니다.
DivanetAdmin를 사용해서 사이트를 다시 동기화할 수도 있습니다. 여기에는 이전에 동기화된 모든 아카이브된 객체 레코드를 사이트에서 삭제하고 소스로부터 다시 동기화하는 과정이 포함됩니다. 이 도구는 소스 DIVA 데이터베이스가 오래된 데이터베이스 백업으로부터 예기치 않게 복원된 경우와 같이 일반적이지 않은 경우에만 사용해야 합니다.
최신 버전의 DIVAnet으로 업그레이드하기 전에 기존 DIVAnet 홈 디렉토리를 백업하는 것이 좋습니다. 또한 업그레이드를 시도하기 전에 서버에서 실행 중인 DIVAnet 서비스 또는 프로그램도 중지해야 합니다. DIVAnet 소프트웨어를 업그레이드하려면 다음 절차를 수행하십시오.
DIVAnet 소프트웨어 설치 절의 지침에 따라 최신 DIVAnet 소프트웨어를 DIVAnet 홈 디렉토리에 설치합니다.
DIVAnet 데이터베이스가 포함된 시스템을 업그레이드하는 경우 DIVAnet 데이터베이스 업그레이드 유틸리티를 실행해야 합니다. 이 유틸리티를 실행하려면 디렉토리를 Program/divanet/bin으로 변경하고 다음 명령을 실행합니다.
Windows: upgradeDB.bat
Linux: ./upgradeDB.sh
이 스크립트를 실행하면 DIVAnet 데이터베이스에 대한 입력(데이터베이스 사용자 이름 및 데이터베이스가 있는 네트워크 주소 등)을 요구하는 메시지가 표시됩니다. 이 유틸리티는 필요한 데이터베이스 객체를 추가하거나 수정합니다. 데이터베이스가 이미 최신 릴리스로 업그레이드된 경우 스크립트는 단순히 성공을 반환합니다.