test

Service Registry 3.1 관리 설명서

1장 Service Registry 구성 및 설정

이 장에서는 Service Registry를 설치한 후 구성하는 방법과 다른 관리 작업을 수행하는 방법에 대해 설명합니다.

이 장은 다음 절로 구성되어 있습니다.

Service Registry 구성

Sun Java Enterprise System 5 Installation Guide for UNIX에서는 레지스트리에 대한 기본 등록 정보 설정을 사용하여 Service Registry를 설치한 다음 구성하는 방법에 대해 설명합니다. 사용자 정의 등록 정보 설정을 사용하려면 ServiceRegistry-base/install/install.properties 또는 ServiceRegistry-base/install/install.properties.template 파일의 복사본을 만들고 구성을 수행하기 전에 이 복사본을 편집합니다.

레지스트리를 구성하려면 root로 로그인하거나, 수퍼유저가 되거나, 루트가 아닌 사용자로 로그인할 수 있습니다.

보안상 루트가 아닌 사용자로 레지스트리를 구성하는 것이 좋습니다. 자세한 지침은 나중에 구성 설치 후 사용자 정의 등록 정보를 사용하여 루트가 아닌 사용자로 Service Registry를 구성하는 방법을 참조하십시오.

ServiceRegistry-base 위치는 Solaris OS의 경우 /opt/SUNWsrvc-registry이고, Linux 및 HP-UX 시스템의 경우 /opt/sun/srvc-registry입니다.

주 –

Service Registry를 구성하기 전에 먼저 Sun Java System Application Server("Application Server")를 설치하여 구성해야 합니다. Service Registry 구성 프로세스에서 레지스트리를 Application Server 도메인에 설치합니다.

Application Server를 해당 기본 위치에 설치하는 것이 좋습니다. 기본값이 아닌 위치에 Application Server를 설치한 경우에는 기본값이 아닌 Application Server 설치에 대한 Service Registry 구성 의 지침을 수행한 다음 Service Registry를 구성합니다.

install.properties 파일에는 수정 가능한 등록 정보 설정 집합이 포함되어 있습니다. 표 1–1에 나열된 등록 정보는 구성 프로세스에서 사용합니다. 각 등록 정보 이름에는 마침표로 끝나는 registry.install. 접두어가 붙어 있습니다. 이러한 등록 정보 중 일부는 레지스트리에 생성된 Application Server 도메인에 기본값이 아닌 포트를 설정합니다. 다른 등록 정보는 본 설명서의 다른 부분에서 설명한 구성 등록 정보를 설정합니다.

루트 또는 루트가 아닌 사용자로 여러 Service Registry 인스턴스를 구성할 수 있습니다. 여러 인스턴스를 구성하는 경우 각 레지스트리 인스턴스에 대해 registry.install.dataHome 등록 정보가 고유한 값이 되도록 변경해야 합니다. 서버에서 인스턴스를 한 번에 두 개 이상 실행하려면 각 인스턴스의 8개 포트 등록 정보도 고유한 값이 되도록 변경해야 합니다. 루트가 아닌 여러 인스턴스를 구성하는 경우에는 각 인스턴스에 대해 registry.install.CACertDir 값이 고유한 값이 되도록 변경할 수 있습니다.

표 1–1 Service Registry 구성 등록 정보

등록 정보 이름 

설명 

기본 등록 정보 값 

DomainName

Application Server 도메인 이름 

registry

ServerInstanceHost

Service Registry에 액세스할 수 있는 기본 호스트 이름 

localhost

ServerInstancePort

Service Registry용 Application Server HTTP 포트 

6480

ServerInstanceSecurePort

Service Registry용 Application Server HTTPS 포트 

6443

ServerJMSPort

Service Registry용 Application Server Message Queue 포트 

6484

ServerIIOPPort

Service Registry용 Application Server IIOP 포트 

6485

ServerIIOPSecurePort

Service Registry용 Application Server IIOP 보안 포트 

6486

ServerIIOPMutualAuthPort

Service Registry용 Application Server IIOP 상호 인증 포트 

6487

AdministrationJMXPort

Service Registry용 Application Server JMX 포트 

6488

AdministrationPort

Service Registry용 Application Server Administrative Server 포트 

6489

AdministratorUserID

Application Server Administrative Server에 액세스하는 데 사용하는 사용자 이름 

admin

AdministratorPassword

Application Server Administrative Server에 액세스하는 데 사용하는 비밀번호 

root로 구성하는 경우 12345678

루트가 아닌 사용자로 구성하는 경우 없음 

ApplicationServerKeystorePassword

Application Server 키 저장소에 액세스하는 데 사용하는 비밀번호 

root로 구성하는 경우 12345678

루트가 아닌 사용자로 구성하는 경우 없음 

RegistryServerKeystorePassword

Service Registry 키 저장소에 액세스하는 데 사용하는 비밀번호 

root로 구성하는 경우 12345678

루트가 아닌 사용자로 구성하는 경우 없음 

clientDatabase

Service Registry 데이터베이스를 포함 모드 또는 네트워크 서버 모드로 실행할지 여부를 결정(네트워크 서버 모드의 경우 true)

false

RequireDatabaseAuthentication

Service Registry 데이터베이스에 액세스할 때 사용자 인증을 요구할지 여부를 결정 

false

DatabaseUserID

사용자 인증이 필요한 경우 Service Registry 데이터베이스에 액세스하는 데 필요한 사용자 아이디 

APP

DatabasePassword

사용자 인증이 필요한 경우 Service Registry 데이터베이스에 액세스하는 데 필요한 비밀번호 

root로 구성하는 경우 app123

루트가 아닌 사용자로 구성하는 경우 없음 

backupDir

Service Registry 백업에 사용할 디렉토리. 일반적으로 주석 처리되며, 대체 위치를 지정하려면 주석을 제거해야 함 

root로 구성하는 경우 RegistryDomain-base/3.0/backup

루트가 아닌 사용자로 구성하는 경우 $HOME/srvc-registry/3.0/backup

dataHome

Service Registry 데이터를 저장할 디렉토리 

root로 구성하는 경우 RegistryDomain-base

루트가 아닌 사용자로 구성하는 경우 $HOME/srvc-registry

CACertDir

Application Server 도메인이 트러스트해야 하는 추가된 인증서를 저장할 디렉토리 

root로 구성하는 경우 ServiceRegistry-base/install/cacerts

루트가 아닌 사용자로 구성하는 경우 $HOME/srvc-registry/cacerts

Procedure나중에 구성 설치 후 사용자 정의 등록 정보를 사용하여 루트로 Service Registry를 구성하는 방법

시작하기 전에

이 지침에서는 사용자가 root로 로그인했거나 수퍼유저가 된 것으로 가정합니다.

  1. ServiceRegistry-base/install 디렉토리로 변경합니다.

  2. install.properties 파일을 안전한 위치로 복사합니다.

    다음과 같은 명령을 사용합니다.


    cp install.properties $HOME/hidden_dir/sr.properties

  3. 쓰기 가능한 상태가 되도록 등록 정보 파일의 권한을 변경합니다.

    다음과 같은 명령을 사용합니다.


    chmod 600 $HOME/hidden_dir/sr.properties

  4. 파일에서 수정 가능한 등록 정보를 편집합니다.

    예를 들어, 기본값의 모든 비밀번호를 변경하는 것이 좋습니다.

  5. 권한을 원래의 읽기 전용 값으로 다시 변경합니다.

    다음과 같은 명령을 사용합니다.


    chmod 400 $HOME/hidden_dir/sr.properties

  6. ServiceRegistry-base/install 디렉토리에서, 수정된 install.properties 파일의 위치를 지정하여 다음 명령을 실행합니다(모두 한 줄로 표시).

    다음과 같은 명령을 사용합니다.

    Ant-base /ant -f build-install.xml -Dinstall.properties=$HOME/hidden_dir/sr.properties configure

    ant 명령을 사용하려면 JAVA_HOME 환경 변수가 설정되어 있어야 합니다. 일반적으로 이 환경 변수를 다음 값으로 설정합니다.

    /usr/jdk/entsys-j2se

    레지스트리 구성 프로세스에서 RegistryDomain-base/domains/${registry.install.DomainName}에 Application Server 도메인을 만듭니다. 기본 도메인 이름은 registry입니다. 그런 다음 도메인을 시작하고 레지스트리를 배포하여 도메인을 실행 중인 상태로 둡니다.

    레지스트리 구성 프로세스에서 RegistryDomain-base/3.0 디렉토리에 레지스트리 데이터베이스 및 서버 키 저장소를 설치합니다. 이 디렉토리는 레지스트리를 제거해도 제거되지 않으므로 이후 릴리스에서 사용하도록 데이터베이스를 유지할 수 있습니다. 관리자는 이 디렉토리의 제거 시기와 제거 여부를 관리할 수 있습니다.

    RegistryDomain-base 위치는 Solaris OS의 경우 /var/opt/SUNWsrvc-registry이고, Linux 및 HP-UX 시스템의 경우 /var/opt/sun/srvc-registry입니다.

    레지스트리 구성 프로세스에서 Application Server 도메인이 트러스트해야 하는 추가된 인증서를 저장할 ServiceRegistry-base/install/cacerts라는 디렉토리를 만듭니다.

  7. ant configure 명령 출력에서 오류를 검토합니다.

    오류가 없는 경우 웹 콘솔 또는 관리 도구를 사용할 수 있습니다.

Procedure나중에 구성 설치 후 사용자 정의 등록 정보를 사용하여 루트가 아닌 사용자로 Service Registry를 구성하는 방법

시작하기 전에

이 지침에서는 root로 로그인하여 설치한 Service Registry에 root가 아닌 일반 사용자가 로그인한 것으로 가정합니다.

  1. ServiceRegistry-base/install 디렉토리로 변경합니다.

  2. install.properties.template 파일을 사용자 홈 디렉토리 위치로 복사하고 이름을 바꿉니다.

    다음과 같은 명령을 사용합니다.


    cp install.properties.template $HOME/sr.properties

  3. 필요한 경우 파일 복사본을 텍스트 편집기에서 열어 등록 정보를 수정합니다.

    템플리트 파일에 빈 상태로 남겨진 다음 등록 정보에 비밀번호 값을 입력해야 합니다.

    registry.install.AdministratorPassword=
registry.install.ApplicationServerKeystorePassword=
registry.install.RegistryServerKeystorePassword=

  4. 파일 권한을 사용자만이 읽을 수 있도록 변경합니다.

    다음과 같은 명령을 사용합니다.


    chmod 400 $HOME/sr.properties

  5. ServiceRegistry-base/install 디렉토리에서, 수정된 파일의 위치를 지정하여 다음과 같은 명령을 실행합니다(모두 한 줄로 표시).

    Ant-base/ant -f build-install.xml -Dinstall.properties=$HOME/sr.properties configure

    이와 유사한 명령을 사용하여 필요한 다른 구성 대상을 실행합니다.

    레지스트리 구성 프로세스에서 $HOME/srvc-registry/domains/${registry.install.DomainName}에 Application Server 도메인을 만듭니다. 기본 도메인 이름은 registry입니다.

    레지스트리 구성 프로세스에서 $HOME/srvc-registry/3.0 디렉토리에 레지스트리 데이터베이스 및 서버 키 저장소를 설치합니다.

    레지스트리 구성 프로세스에서 Application Server 도메인이 트러스트해야 하는 추가된 인증서를 저장할 $HOME/srvc-registry/cacerts라는 디렉토리를 만듭니다.

  6. ant configure 명령 출력에서 오류를 검토합니다.

    오류가 없는 경우 웹 콘솔 또는 관리 도구를 사용할 수 있습니다.

Service Registry용 Application Server 도메인 관리

Service Registry 구성 프로세스에서는 기본적으로 registry라는 Application Server 도메인을 만들며, 이 도메인에 Service Registry 웹 응용 프로그램이 배포됩니다. 이 도메인은 RegistryDomain-base/domains/registry 디렉토리에 있습니다.

이 위치는 Application Server 도메인의 기본 위치인 /var/opt/SUNWappserver/domains(Solaris OS) 또는 /var/opt/sun/appserver/domains(Linux 및 HP-UX 시스템)와 다릅니다.

주 –

registry 도메인에서는 Service Registry 이외의 응용 프로그램을 실행하지 않는 것이 좋습니다.

registry 도메인을 관리하는 데 Application Server 관리 콘솔("관리 콘솔")을 사용할 수 있습니다. 관리 콘솔을 사용하여 도메인 시작 및 중지, 서버 로그 보기 및 기타 관리 작업을 수행할 수 있습니다. 자세한 내용은 Application Server 관리 콘솔 사용 방법을 참조하십시오.

서버 로그를 직접 검사할 수도 있습니다. 로그는 RegistryDomain-base/domains/registry/logs/server.log 파일에 있습니다.

관리 콘솔뿐 아니라 asadmin 명령을 사용하여 registry 도메인을 관리할 수도 있습니다. 도메인이 기본 위치에 없으므로 asadmin 명령을 사용할 때 --domaindir 옵션을 지정해야 합니다. --domaindir 옵션에 대한 인수는 RegistryDomain-base/domains입니다.

asadmin 명령의 --passwordfile 옵션을 사용하려면 레지스트리 도메인의 관리자 비밀번호 복사본이 있는 파일이 필요합니다. 이 파일을 만들려면 build-install.xml 파일의 generate.password.file 대상을 사용합니다. RegistryDomain-base/3.0/data/security/pw.txt 파일이 만들어집니다.

registry 도메인은 기본 Application Server 도메인 domain1과 충돌이 발생하지 않도록 기본값이 아닌 포트를 사용합니다. 이러한 Service Registry 포트 값은 IANA(Internet Assigned Numbers Authority)에 등록되어 있습니다. 표 1–2에서 이러한 포트를 설명합니다. 자세한 내용은 Sun Java System Application Server Enterprise Edition 8.2 Administration Guide의 Ports in the Application Server를 참조하십시오.

표 1–2 Service Registry 도메인 기본 포트

포트 값 

설명 

6480 

HTTP 포트 

6443 

SSL을 통한 HTTPS 

6484 

Message Queue 포트 

6485 

IIOP 포트 

6486 

IIOP SSL 포트 

6487 

IIOP 상호 인증 포트 

6488 

JMX 포트 

6489 

Application Server 도메인 관리 포트 

ProcedureApplication Server 관리 콘솔 사용 방법

  1. 웹 브라우저에서 https://hostname:6489/ URL로 이동합니다.

    hostname은 Application Server 및 Service Registry가 실행 중인 시스템입니다.

  2. 제공되는 인증서에 동의합니다.

    로그인 페이지가 나타납니다.

  3. 로그인 페이지의 사용자 이름 필드에 admin을 입력합니다.

    레지스트리를 구성할 때 registry.install.AdministratorUserID 등록 정보의 기본값을 변경한 경우 해당 값을 입력합니다.

  4. 비밀번호 필드에 Application Server 관리자 비밀번호를 입력합니다. 레지스트리를 구성할 때 registry.install.AdministratorPassword 등록 정보에 지정한 값을 사용합니다. 기본값은 12345678입니다.

  5. 로그인을 누릅니다.

참조

관리 콘솔 사용에 대한 자세한 내용은 관리 콘솔에 대한 온라인 도움말 또는 Sun Java System Application Server Enterprise Edition 8.2 Administration Guide를 참조하십시오.

Service Registry 로깅 수준 변경

Service Registry의 로깅 수준을 변경하려면 관리 콘솔 온라인 도움말의 지침을 수행하십시오. 추가 등록 정보 영역에 지정할 등록 정보는 org.freebxml.omar입니다.

특정 Service Registry 하위 구성 요소에 대한 로깅을 변경하려면 RegistryDomain-base/domains/registry/applications/j2ee-modules/soar/WEB-INF/classes/log4j.properties 파일을 참조하십시오. 이 파일에 나열된 모든 하위 구성 요소 이름을 지정할 수 있습니다. log4j.logger 문자열은 포함시키지 마십시오. 예를 들어, org.freebxml.omar.server를 지정하여 서버 호출을 기록할 수 있습니다.

Procedure레지스트리에 대해 Application Server 도메인 중단 및 다시 시작 방법

레지스트리 구성 프로세스에서 레지스트리가 배포되는 Application Server 도메인을 시작합니다. 특정 관리 작업을 수행한 후에는 도메인을 중지했다가 다시 시작해야 합니다. 이러한 작업의 예는 레지스트리 도메인에 대한 JVM(Java Virtual Machine) 구성 및 관리자 만들기에 설명되어 있습니다.

도메인을 다시 시작해야 하는지 여부를 관리 콘솔이 알려줍니다. 관리 콘솔을 사용하여 이 작업을 수행할 수 있습니다. asadmin 명령을 사용하는 경우 Ant 작업을 사용하여 도메인을 중지 및 시작할 수 있습니다.

  1. Service Registry 설치 디렉토리를 다음과 같이 변경합니다.

    cd ServiceRegistry-base/install

  2. 다음 명령을 실행합니다(모두 한 줄로 표시).

    Ant-base/ant -f build-install.xml -Dinstall.properties= props-file appserver.domain.bounce

    여기서, props-file은 나중에 구성 설치 후 사용자 정의 등록 정보를 사용하여 루트로 Service Registry를 구성하는 방법 또는 나중에 구성 설치 후 사용자 정의 등록 정보를 사용하여 루트가 아닌 사용자로 Service Registry를 구성하는 방법에서 편집한 install.properties 파일 복사본의 경로 이름입니다.

    appserver.domain.bounce 대상은 도메인을 중지한 후 다시 시작합니다.

    또한 build-install.xml 파일에는 레지스트리 도메인 중지 및 시작을 위한 개별 Ant 대상이 포함됩니다. 도메인을 중지하려면 Ant 대상 appserver.domain.stop을 사용합니다. 도메인을 시작하려면 Ant 대상 appserver.domain.start를 사용합니다.

Procedure레지스트리 도메인의 신뢰할 수 있는 인증서에 루트 인증서 추가 방법

이 작업은 Application Server registry 도메인의 신뢰할 수 있는 인증서 목록을 확장합니다.

아직 Application Server truststore에 없는 타사 인증서 및 해당 루트 인증 기관(CA) 인증서를 사용하는 경우에만 이 작업을 수행합니다. 레지스트리 발급 인증서만을 사용하는 경우 이 작업을 수행하지 않습니다.

필요한 CA 인증서가 이미 사용할 수 있는 상태인지 확인하려면 build-install.xml 파일의 list.cacerts 대상을 사용합니다.

Ant-base/ant -f build-install.xml -Dinstall.properties=props-file list.cacerts

여기서, props-file은 나중에 구성 설치 후 사용자 정의 등록 정보를 사용하여 루트로 Service Registry를 구성하는 방법 또는 나중에 구성 설치 후 사용자 정의 등록 정보를 사용하여 루트가 아닌 사용자로 Service Registry를 구성하는 방법에서 편집한 install.properties 파일 복사본의 경로 이름입니다.

  1. 지원할 루트 인증서를 다운로드합니다.

    루트 인증서를 제공하는 사이트는 다음과 같습니다.

  2. 필요한 경우 unzip 명령을 사용하여 다운로드한 아카이브에서 .cer 파일을 추출합니다.

    주 –

    일부 파일은 .der 접미어를 가집니다.

  3. .cer 파일을 install.properties 파일 복사본의 registry.install.CACertDir 등록 정보에서 지정한 디렉토리에 복사합니다.

    일반적으로 이 값은 root로 구성한 경우 ServiceRegistry-base/install/cacerts이며, 루트가 아닌 사용자로 구성한 경우 $HOME/srvc-registry/cacerts입니다.

  4. ServiceRegistry-base/install 디렉토리로 변경합니다.

  5. 다음 명령을 실행합니다(모두 한 줄로 표시).

    Ant-base/ant -f build-install.xml -Dinstall.properties= props-file install.cacerts

    이 명령을 실행하면 registry.install.CACertDir 등록 정보에서 지정한 디렉토리에 있는 모든 인증서를 Application Server 도메인 truststore에 설치할 수 있습니다.

    list.cacerts 대상을 다시 사용하여 인증서가 제대로 설치되었는지 확인할 수 있습니다.

  6. 레지스트리에 대해 Application Server 도메인 중단 및 다시 시작 방법의 지침을 수행합니다.

기본값이 아닌 Application Server 설치에 대한 Service Registry 구성

Application Server 설치 기본 위치는 Solaris OS의 경우 /opt/SUNWappserver/appserver이고 Linux 및 HP-UX 시스템의 경우 /opt/sun/appserver입니다. Application Server를 다른 위치에 설치한 경우에는 Service Registry를 구성하기 전에 install.properties 파일의 복사본을 편집해야 합니다.

Procedureinstall.properties 파일의 복사본을 편집하는 방법

  1. ServiceRegistry-base/install 디렉토리로 변경합니다.

  2. install.properties 파일을 안전한 위치로 복사한 후 이름을 바꿉니다.

    다음과 같은 명령을 사용합니다.


    cp install.properties $HOME/hidden_dir/sr.properties

  3. 등록 정보 파일이 쓰기 가능한 상태가 되도록 권한을 변경합니다.

    다음과 같은 명령을 사용합니다.


    chmod 600 $HOME/hidden_dir/sr.properties

  4. 파일을 텍스트 편집기에서 엽니다.

  5. appserver.root.dir 등록 정보의 주석 처리된 정의를 찾습니다.

  6. 주석 문자(#)를 제거하고 등록 정보 정의를 Application Server의 실제 위치로 바꿉니다.

  7. 파일을 저장한 다음 닫습니다.

다음 순서

Service Registry 구성의 지침에 따라 작업을 계속 수행합니다.

레지스트리 도메인에 대한 JVM(Java Virtual Machine) 구성

Service Registry가 올바르게 작동하려면 다음 조건이 필요합니다.

레지스트리 객체는 해당 레지스트리 객체에 연결된 외부 URL을 지정하는 외부 링크(ExternalLink) 객체를 가질 수 있습니다. 서비스(Service) 객체는 서비스 바인딩(ServiceBinding)을 가질 수 있으며, 외부 URL을 가리킬 수도 있습니다. 사용자가 외부 링크(ExternalLink) 및 서비스 바인딩(ServiceBinding) 객체를 만들려면 Service Registry에서 URL을 검증할 수 있어야 하며 이 작업 중 외부 웹 사이트에 액세스할 수 있어야 합니다. 레지스트리가 방화벽 뒤에 배포되어 있는 경우 이 액세스를 허용하도록 프록시 구성을 설정해야 합니다.

프록시 구성에서는 웹 프록시 호스트 및 포트를 Service Registry가 배포되는 Application Server 도메인의 JVM(Java Virtual Machine) 옵션으로 지정해야 합니다.

레지스트리에 메모리가 부족할 수도 있습니다. 이 문제를 방지하려면 JVM 옵션을 구성하여 레지스트리의 Application Server 도메인에 사용할 수 있는 메모리를 늘립니다.

다음 작업을 수행하여 레지스트리의 JVM 옵션을 구성합니다.

Procedure레지스트리 도메인의 JVM 옵션을 구성하는 방법

  1. Application Server 관리 콘솔 사용 방법에 설명한 대로 Application Server 관리 콘솔에 로그인합니다.

  2. 구성 노드를 확장합니다.

  3. 서버 노드 server-config (Admin Config)를 확장합니다.

  4. JVM 설정을 누릅니다.

  5. JVM 옵션 탭을 누릅니다.

  6. JVM 옵션 추가를 누릅니다.

  7. 텍스트 필드에 다음을 입력합니다(모두 한 줄로 표시).


    -Dhttp.proxyHost=hostname.domainname -Dhttp.proxyPort=8080 -Dhttp.nonProxyHosts=localhost

    포트 값은 일반적으로 8080입니다. 포트가 사용자 위치와 다른 경우 올바른 값을 지정합니다.

  8. JVM 옵션 추가를 다시 누릅니다.

  9. 텍스트 필드에 다음을 입력합니다(모두 한 줄로 표시).


    -XX:MaxPermSize=128m

  10. 저장을 누릅니다.

  11. 레지스트리에 대해 Application Server 도메인 중단 및 다시 시작 방법의 지침을 수행합니다.

관리자 만들기

Service Registry 관리 도구를 사용하면 관리자로 등록된 사용자만 수행할 수 있는 몇 가지 작업을 수행할 수 있습니다. 또한 관리자를 호출하여 다른 사용자가 제출하는 객체에 대한 라이프 사이클 변경(예: 승인)을 구현할 수 있습니다.

또한 관리자는 기본 액세스 제어 정책(ACP)을 변경해야 할 수도 있습니다. 그러나, 현재는 수동 프로세스를 통해 ACP를 작성하므로 OASIS XACML(eXtensible Access Control Markup Language)을 잘 알고 있어야 합니다. 자세한 내용은 ebXML RIM 3.0의 9장, “액세스 제어 정보 모델” 특히, 9.7.6~9.7.8절의 예를 참조하십시오. ebXML RIM 3.0 사양을 찾는 방법에 대한 자세한 내용은 이 설명서를 읽기 전에를 참조하십시오.

Procedure관리자를 만드는 방법

자신을 관리자로 등록하려면 다음 단계를 수행합니다.

  1. Service Registry 3.1 사용자 설명서의 사용자 계정 만들기에 설명한 대로 사용자 등록을 수행하거나, add user에 설명된 add user 관리 도구를 사용하여 자신을 사용자로 추가합니다.

  2. 웹 콘솔을 사용하여 등록한 경우 다음과 같이 사용자(User) 객체의 고유 식별자를 얻습니다.

    1. 사용자로 설정된 객체 유형으로 웹 콘솔을 사용하여 기본 쿼리를 수행합니다.

    2. 사용자에 대해 만들어진 레지스트리의 사용자(User) 객체를 보려면 세부 정보 링크를 누릅니다.

    3. 고유 식별자 필드 값을 입력하거나 파일에 복사 및 붙여넣기합니다.

    add user 명령을 사용한 경우에는 users 명령을 사용하여 사용자 목록을 가져온 다음 사용자 이름의 식별자 값을 복사합니다.

  3. RegistryDomain-base/domains/registry/applications/j2ee-modules/soar/WEB-INF/classes 디렉토리로 변경합니다.

  4. omar.properties 파일을 텍스트 편집기에서 엽니다.

  5. omar.security.authorization.registryAdministrators 등록 정보의 정의를 찾습니다.

  6. 단계 2에서 복사한 고유 식별자 문자열 앞에 세로 막대(|)를 추가하여 등록 정보 정의를 편집합니다.

    등록 정보 정의는 한 줄로 입력해야 하며 공백을 포함할 수 없습니다. 완료하면 다음과 같이 나타납니다(모두 한 줄로 표시).

    omar.security.authorization.registryAdministrators=
urn:freebxml:registry:predefinedusers:registryoperator|
urn:uuid:77f5c196-79de-4286-8483-8d80def3583b

  7. omar.properties 파일을 저장한 다음 닫습니다.

  8. 레지스트리에 대해 Application Server 도메인 중단 및 다시 시작 방법의 지침을 수행합니다.

다음 순서

추가 관리자를 만들기 위해 omar.properties 파일을 편집할 필요가 없습니다. 관리자는 관리 도구 또는 웹 콘솔을 사용하여 사용자를 추가할 수 있으며 웹 콘솔을 사용하여 사용자를 관리자로 분류할 수 있습니다.

사용자 등록을 수행할 수 있는 대상 지정

기본적으로 Service Registry에 액세스할 수 있는 모든 사용자가 URL에서 사용자 등록 마법사를 사용하여 사용자 등록을 수행할 수 있습니다. 등록된 사용자는 레지스트리에 내용을 게시할 수 있습니다.

omar.properties 파일의 omar.security.selfRegistration.acl 등록 정보를 정의하여 이 기능을 제한함으로써 지정된 사용자만 사용자 등록을 수행할 수 있도록 할 수 있습니다.

이 작업을 완료하면 등록 정보 정의에서 지정한 성과 이름을 가진 사용자만이 마법사를 사용하여 등록 작업을 수행할 수 있습니다. 지정되지 않은 다른 사용자가 등록 작업을 수행하려는 경우 사용자 등록 마법사 3단계의 사용자 인증 세부 정보 양식을 입력한 후 다음 버튼을 누르면 오류 메시지가 표시됩니다. 오류 메시지는 User registration failed이며 뒤에 UserNotFoundException 보고 내용이 나옵니다.

omar.security.selfRegistration.acl 등록 정보가 omar.properties에 없거나 빈 문자열로 정의되면 등록된 사용자는 레지스트리에 내용을 게시할 수 있습니다.

Procedure사용자 등록 제한 방법

  1. RegistryDomain-base/domains/registry/applications/j2ee-modules/soar/WEB-INF/classes 디렉토리로 변경합니다.

  2. omar.properties 파일을 텍스트 편집기에서 엽니다.

  3. 다음 등록 정보의 정의를 추가합니다.

    omar.security.selfRegistration.acl

    이 등록 정보 정의는 파일 내 모든 위치에 추가할 수 있습니다. 등록 정보 정의의 논리 위치는 omar.security 접두어가 있는 다른 등록 정보가 정의된 영역입니다.

    등록 정보 값을 다음 예와 같이 사용자 등록을 수행할 수 있는 사용자의 성과 이름에 대한 쉼표로 구분된 목록으로 정의합니다.

    omar.security.selfRegistration.acl=Vijay Patel, Jane Doe,

  4. omar.properties 파일을 저장한 다음 닫습니다.

  5. 레지스트리에 대해 Application Server 도메인 중단 및 다시 시작 방법의 지침을 수행합니다.

레지스트리 객체 버전 지정 활성화

기본적으로 레지스트리 객체의 버전 지정은 비활성화되어 있습니다. 버전 지정이 활성화되면 객체의 속성이 변경될 때마다 객체의 새 버전이 만들어집니다. 버전 지정 활성화는 관리 작업입니다.

Procedure레지스트리 객체 버전 지정을 활성화하는 방법

  1. RegistryDomain-base/domains/registry/applications/j2ee-modules/soar/WEB-INF/classes 디렉토리로 변경합니다.

  2. omar.properties 파일을 텍스트 편집기에서 엽니다.

  3. omar.server.lcm.VersionManager.versionableClassList 등록 정보의 정의를 찾습니다.

    기본적으로 이 등록 정보에는 다음과 같이 값이 없습니다.

    omar.server.lcm.VersionManager.versionableClassList=

  4. 수정 시 레지스트리에서 새 버전을 만들 객체를 지정합니다. 객체는 세로 막대(|)를 사용하여 구분합니다.

    예를 들면 다음과 같습니다.

    omar.server.lcm.VersionManager.versionableClassList=Service|Organization

    위의 예와 같이 파일에서 등록 정보 설정의 주석 처리된 복사본을 사용합니다.

  5. omar.properties 파일을 저장한 다음 닫습니다.

  6. 레지스트리에 대해 Application Server 도메인 중단 및 다시 시작 방법의 지침을 수행합니다.

WSDL 카탈로거 비활성화

WSDL 파일이 레지스트리에 외부 객체(ExtrinsicObject)로 게시된 경우 기본적으로 레지스트리는 ebXML Registry Profile for Web Services에 정의된 기능을 사용하여 객체에 대한 메타데이터를 만듭니다. 이 기능은 비활성화할 수 있습니다.

ProcedureWSDL 카탈로거를 비활성화하는 방법

  1. RegistryDomain-base/domains/registry/applications/j2ee-modules/soar/WEB-INF/classes 디렉토리로 변경합니다.

  2. omar.properties 파일을 텍스트 편집기에서 엽니다.

  3. omar.server.cms.classMap.urn\:oasis\:names\:tc\:ebxml-regrep\:profiles\:ws\:wsdl\:cataloging\:Service\:default 등록 정보의 정의를 찾습니다.

  4. 주석 문자(#)를 이 등록 정보의 정의 앞에 붙여 주석 처리합니다.

  5. omar.properties 파일을 저장한 다음 닫습니다.

  6. 레지스트리에 대해 Application Server 도메인 중단 및 다시 시작 방법의 지침을 수행합니다.

웹 콘솔 구성

관리자는 구성 파일을 편집하여 웹 콘솔 표시의 일부 측면을 사용자 정의할 수 있습니다.

이 절에서는 다음 작업에 대해 설명합니다.

웹 콘솔 사용에 대한 자세한 내용은 Service Registry 3.1 사용자 설명서를 참조하십시오.

미리 정의된 쿼리 추가

Service Registry에는 미리 정의된 쿼리 선택 드롭다운 목록의 웹 콘솔 검색 양식에 표시되는 미리 정의된 여러 쿼리가 포함되어 있습니다. 관리자는 해당 레지스트리 설치에 특정한 새 쿼리를 드롭다운 목록에 추가할 수 있습니다.

Procedure미리 정의된 쿼리를 추가하는 방법

  1. 웹 콘솔을 사용하여 레지스트리에 쿼리 객체 AdhocQuery를 게시합니다.

    쿼리에 대해 지정하는 이름 및 설명이 미리 정의된 쿼리의 드롭다운 목록에 나타납니다. 쿼리에 대한 SQL 문에서 다음과 같이 사용자가 제공한 데이터를 작은따옴표 쌍으로 묶어 자리 표시자를 지정합니다.

    select * from registryobject where id = ''$lid''

  2. 쿼리 객체 AdhocQuery 및 SQL 문 자리 표시자의 고유 식별자를 입력하거나 파일에 복사 및 붙여넣기합니다.

  3. RegistryDomain-base/3.0/jaxr-ebxml 디렉토리로 변경합니다.

  4. 텍스트 편집기에서 registry-browser-config.xml 파일을 엽니다.

    필요한 경우 변경 사항을 다시 되돌릴 수 있도록 원래 파일의 복사본을 만듭니다.

  5. 다음 형식을 사용하여 registry-browser-config.xml 파일에 항목을 추가합니다. SQL 문의 각 자리 표시자에 대한 Parameter 요소를 지정합니다.

    <Query>
  <AdhocQueryRef id="unique-identifier"/>
  <Parameter parameterName="$placeholder-name" datatype="string">
    <rim:Name>
      <rim:LocalizedString xml:lang="en" charset="UTF-8" 
        value="parameter-name-in-en-locale"/>
      <rim:LocalizedString xml:lang="fr" charset="UTF-8" 
        value="parameter-name-in-fr-locale"/>
    </rim:Name>
    <rim:Description>
      <rim:LocalizedString xml:lang="en" charset="UTF-8" 
        value="parameter-description-in-en-locale"/>
      <rim:LocalizedString xml:lang="fr" charset="UTF-8" 
        value="parameter-description-in-fr-locale"/>
    </rim:Description>
  </Parameter>
  ...
</Query>

    unique-identifier는 쿼리 객체 AdhocQuery의 고유 식별자입니다.

    각 매개 변수의 parameterName 속성 값은 쿼리에 대한 SQL 문의 자리 표시자에서 가져와야 합니다.

    datatype 속성은 다음 값 중 하나를 가질 수 있습니다.

    • string: 매개 변수가 검색 양식의 텍스트 필드로 나타납니다.

    • taxonomyElement: 매개 변수가 검색 양식의 드롭다운 목록으로 나타납니다. taxonomyElement 데이터 유형을 지정하는 경우 이름 및 설명 요소 뒤에 다음과 같은 SlotList 요소가 있어야 합니다.

      <rim:SlotList>
  <rim:Slot name="domain">
    <rim:ValueList>
      <rim:Value>
      classification-scheme-or-concept-id
      </rim:Value>
    </rim:ValueList>
  </rim:Slot>
</rim:SlotList>

      classification-scheme-or-concept-id는 해당 개념(또는 하위 개념)이 드롭다운 목록에 나타나야 하는 분류 체계 또는 개념의 고유 식별자입니다. 분류 체계를 게시해야 합니다(레지스트리에 해당 체계가 없는 경우 해당).

      슬롯 이름은 "domain"이어야 합니다.

    • boolean: 매개 변수가 검색 양식에서 확인란으로 표시됩니다.

    datatype이 string 또는 boolean이면 Parameter 요소에 defaultValue 속성을 추가하여 검색 양식에 표시할 기본값을 지정할 수도 있습니다.

    지원하는 로켈의 각 매개 변수 이름 및 설명에 대해 현지화된 문자열 값을 지정합니다. 현재 로켈의 parameter-name은 검색 양식에 매개 변수 레이블로 표시됩니다.

    registry-browser-config.xml 파일의 기존 항목은 참조용으로 사용합니다.

  6. registry-browser-config.xml 파일을 저장한 다음 닫습니다.

  7. 레지스트리에 대해 Application Server 도메인 중단 및 다시 시작 방법의 지침을 수행합니다.

기본 쿼리 변경

미리 정의된 쿼리 선택 드롭다운 목록에 기본값으로 표시되는 쿼리는 사용자가 이름, 설명 및 분류 기준으로 레지스트리 객체를 검색할 수 있는 기본 쿼리입니다.

관리자는 이 기본값을 설치에 적절한 쿼리로 변경할 수 있습니다. 예를 들어, 미리 정의된 쿼리 추가에 설명된 대로 기본 쿼리를 레지스트리에 추가한 미리 정의된 새 쿼리로 지정할 수 있습니다. 이를 변경하려면 구성 파일의 등록 정보를 편집합니다.

Procedure기본 쿼리를 변경하는 방법

  1. RegistryDomain-base/domains/registry/applications/j2ee-modules/soar/WEB-INF/classes 디렉토리로 변경합니다.

  2. 텍스트 편집기에서 jaxr-ebxml.properties 파일을 엽니다.

  3. jaxr-ebxml.thin.defaultQueryPanel 등록 정보의 정의를 찾습니다. 기본적으로 이 등록 정보는 다음과 같이 주석 처리됩니다.

    #jaxr-ebxml.thin.defaultQueryPanel=

  4. 주석 문자(#)를 제거합니다.

  5. 다음 예와 같이 기본값이 될 쿼리의 논리 식별자를 지정하여 등록 정보 값을 설정합니다.

    jaxr-ebxml.thin.defaultQueryPanel=urn:oasis:names:tc:ebxml-regrep:query:MyQuery

  6. jaxr-ebxml.properties 파일을 저장한 다음 닫습니다.

  7. 레지스트리에 대해 Application Server 도메인 중단 및 다시 시작 방법의 지침을 수행합니다.

분류 체계 숨기기

분류 체계의 트리 구조는 다음 웹 콘솔 영역에 표시됩니다.

Service Registry 사용자가 분류 체계를 사용하지 못하게 하려면 관리자는 보기에서 해당 분류 체계를 숨길 수 있습니다. 분류 체계를 숨기려면 구성 파일에서 등록 정보를 정의합니다.

Procedure분류 체계 숨기기 방법

  1. RegistryDomain-base/domains/registry/applications/j2ee-modules/soar/WEB-INF/classes 디렉토리로 변경합니다.

  2. 텍스트 편집기에서 jaxr-ebxml.properties 파일을 엽니다.

  3. 다음 구문을 사용하여 jaxr-ebxml.registryBrowser.ConceptsTreeModel.hiddenSchemesList 등록 정보를 설정합니다. 모든 등록 정보 정의는 한 줄로 입력해야 하며 공백을 포함할 수 없습니다.

    jaxr-ebxml.registryBrowser.ConceptsTreeModel.hiddenSchemesList=
class-scheme-id1|class-scheme-id2|...

    숨길 각 분류 체계의 논리 식별자를 지정합니다. 식별자를 2개 이상 지정하려면 다음 예와 같이 세로 막대(|)를 사용하여 식별자를 구분합니다.

    jaxr-ebxml.registryBrowser.ConceptsTreeModel.hiddenSchemesList=
urn:oasis:names:tc:ebxml-regrep:classificationScheme:StatusType|
urn:oasis:names:tc:ebxml-regrep:profile:ws:classificationScheme:BindingType

  4. jaxr-ebxml.properties 파일을 저장한 다음 닫습니다.

  5. 레지스트리에 대해 Application Server 도메인 중단 및 다시 시작 방법의 지침을 수행합니다.

검색 결과 표시 구성

웹 콘솔은 기본적으로 각 쿼리에 대해 한 번에 25개의 검색 결과를 표시합니다. 25개가 넘는 검색 결과가 반환되면 사용자는 추가 결과 페이지를 표시할 수 있습니다. 관리자는 각 페이지에 표시되는 검색 결과 수를 수정할 수 있습니다.

웹 콘솔은 기본적으로 검색 결과 영역에 특정 열을 표시합니다. 각 객체에 대해 객체 유형, 이름, 설명, 버전 및 버전 주석을 표시합니다. 일부 객체 유형의 경우에는 기본 표시와는 다른 표시로 구성됩니다. 예를 들어, 서비스 바인딩(ServiceBinding) 객체의 경우 버전 정보 대신에 종점이 포함되어 표시됩니다. 관리자는 구성 정보를 추가하여 선택 객체 유형에 대한 기본값이 아닌 데이터를 표시할 수 있습니다.

이러한 작업을 각각 수행하려면 구성 파일을 편집합니다.

Procedure검색 결과 표시에 행 수 구성

  1. RegistryDomain-base/domains/registry/applications/j2ee-modules/soar/WEB-INF/classes 디렉토리로 변경합니다.

  2. 텍스트 편집기에서 jaxr-ebxml.properties 파일을 엽니다.

  3. omar.client.thinbrowser.numSearchResults 등록 정보의 정의를 찾습니다.

    omar.client.thinbrowser.numSearchResults=25

  4. 25를 원하는 값으로 변경합니다.

  5. jaxr-ebxml.properties 파일을 저장한 다음 닫습니다.

  6. 레지스트리에 대해 Application Server 도메인 중단 및 다시 시작 방법의 지침을 수행합니다.

Procedure검색 결과 영역의 열 구성

객체 유형별로 검색 결과 영역의 열을 구성할 수 있습니다. 열에는 객체의 속성이 표시됩니다.

  1. RegistryDomain-base/3.0/jaxr-ebxml 디렉토리로 변경합니다.

  2. 텍스트 편집기에서 registry-browser-config.xml 파일을 엽니다.

  3. registry-browser-config.xml 파일에 항목을 추가하거나 기존 항목을 편집합니다. 다음 형식을 사용합니다.

    다음 예에서는 서비스(Service) 객체에 대해 기본값이 아닌 표시를 구성합니다.

    <ObjectTypeConfig 
    className="org.freebxml.omar.client.xml.registry.infomodel.ServiceImpl" 
    id="urn:oasis:names:tc:ebxml-regrep:ObjectType:RegistryObject:Service">
  <SearchResultsConfig>
    <SearchResultsColumn columnClass="java.lang.Object" 
      columnHeader="Object Type" columnWidth="25" editable="false" 
      method="getObjectType"/>
    <SearchResultsColumn columnClass="java.lang.Object" 
      columnHeader="Name" columnWidth="25" editable="true" method="getName"/>
    <SearchResultsColumn columnClass="java.lang.Object" 
      columnHeader="Description" columnWidth="30" editable="true" 
      method="getDescription"/>
    <SearchResultsColumn columnClass="java.lang.Object" 
      columnHeader="Status" columnWidth="15" method="getStatusAsString"/>
    <SearchResultsColumn columnClass="java.lang.Object" 
      columnHeader="Version" columnWidth="5" method="getVersionName"/>
  </SearchResultsConfig>
</ObjectTypeConfig>

    registry-browser-config.xml 파일은 ObjectTypeConfig 요소에 대한 구문을 제공합니다. 파일에 있는 기존 요소를 예로 사용합니다. 이러한 요소는 외부 링크(ExternalLink), 외부 객체(ExtrinsicObject) 및 서비스 바인딩(ServiceBinding) 객체에 대해 기본값이 아닌 표시를 구성할 뿐 아니라, 레지스트리 객체에 대해 기본 표시를 구성합니다.

    구성할 수 있는 열은 최대 30개입니다.

    SearchResultsColumn 요소의 경우 다음과 같은 특징이 있습니다.

    • columnClass 속성 값은 항상 java.lang.Object입니다.

    • columnHeader 속성 값은 웹 콘솔 자원 번들 파일의 메시지에 대한 키입니다. 이 파일은 registryDomain-base/domains/registry/applications/j2ee-modules/soar/WEB-INF/classes/org/freebxml/omar/client/ui/thin/ 디렉토리에 포함되어 있습니다. 예를 들어, columnHeader 값에 Object Type을 입력하면 웹 콘솔의 백킹 Bean은 WebResourceBundle 클래스를 사용하여 해당 키가 있는 메시지를 조회합니다. WebResourceBundle이 메시지 찾기에 실패하면 해당 키를 소문자로 변환하여 검색을 다시 시도합니다. 이 작업도 실패하게 되면 메시지 값을 "???"+key+"???"로 설정하고 누락된 자원 번들 항목에 대한 경고 메시지를 기록합니다. 따라서, 현지화된 새 columnHeader 값을 추가하려면 이 디렉토리에 포함된 ResourceBundle 파일에 새 메시지 키를 입력해야 합니다.

    • columnWidth 속성은 웹 콘솔에서 사용되지 않습니다.

    • editable 속성은 웹 콘솔에서 사용되지 않습니다.

    • 대부분의 경우 ebXML Registry Information Model Version 3.0 사양의 클래스 속성에서 method 속성에 대한 메소드 이름을 추정할 수 있습니다(자세한 내용은 이 설명서를 읽기 전에 참조). getStatusAsString 메소드는 RegistryObjectImpl 구현 클래스에서 찾을 수 있습니다. (그러나 이번 Service Registry 릴리스에는 API 설명서가 포함되어 있지 않습니다.)

    각 omar.client.xml.registry.infomodel 클래스 이름당 ObjectTypeConfig 요소를 하나만 가질 수 있습니다.

  4. registry-browser-config.xml 파일을 저장한 다음 닫습니다.

  5. 레지스트리에 대해 Application Server 도메인 중단 및 다시 시작 방법의 지침을 수행합니다.

  6. 재구성을 확인하려면 웹 콘솔의 검색 또는 탐색 메뉴를 사용하여 해당 열이 변경된 객체를 표시합니다.

Service Registry 다시 설치

Service Registry를 제거하고 다시 설치해야 하는 경우 다시 설치하기 전에 다음 작업을 먼저 수행합니다.

Service Registry 데이터베이스를 다시 설치해야 하는 경우(예: 데이터베이스가 손상된 경우) Service Registry 데이터베이스를 다시 설치하는 방법의 지침을 수행합니다. 이 데이터베이스는 다시 설치하기 전에 제거할 필요가 없습니다.

Procedure레지스트리에 대한 Application Server 도메인 중지 및 삭제

  1. ServiceRegistry-base/install 디렉토리로 변경합니다.

  2. 다음 명령을 실행합니다(모두 한 줄로 표시).

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file appserver.domain.delete

    여기서, props-file은 나중에 구성 설치 후 사용자 정의 등록 정보를 사용하여 루트로 Service Registry를 구성하는 방법 또는 나중에 구성 설치 후 사용자 정의 등록 정보를 사용하여 루트가 아닌 사용자로 Service Registry를 구성하는 방법에서 편집한 install.properties 파일 복사본의 경로 이름입니다.

    이 대상은 도메인을 중지한 다음 삭제합니다.

ProcedureService Registry 데이터베이스를 다시 설치하는 방법

이 작업을 수행하면 등록된 사용자를 포함한 기존 데이터베이스 내용을 삭제하고 기본 데이터베이스를 다시 만들 수 있습니다.

  1. ServiceRegistry-base/install 디렉토리로 변경합니다.

  2. 다음 명령을 실행합니다(모두 한 줄로 표시).

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file install.db

  3. 다음 명령을 실행합니다(모두 한 줄로 표시).

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file appserver.domain.stop export.registryOperatorCert install.cacerts appserver.domain.start

Java DB 데이터베이스 관리

레지스트리는 Java DB 데이터베이스를 사용합니다. Java DB는 Apache Software Foundation의 오픈 소스 관계형 데이터베이스 프로젝트의 상용 릴리스입니다. Apache 프로젝트는 Derby라고 불립니다.

기본적으로 데이터베이스는 RegistryDomain-base/3.0/data/registry/soar/ 디렉토리에 있습니다. 데이터베이스 백업은 RegistryDomain-base/3.0/backup/ 디렉토리에 저장되며, 하위 디렉토리 이름에 백업 날짜가 포함됩니다(예: 20060419-004759).

기본적으로 Java DB 데이터베이스는 포함된 모드로 실행됩니다. 이것은 데이터베이스가 Service Registry와 동일한 JVM에서 실행되며 하나의 클라이언트에서만 요청된 연결을 수락할 수 있다는 것을 의미합니다. 원격 연결은 가능하지 않습니다. Java DB가 포함된 모드로 실행되는 경우 데이터베이스 실행을 중지해야 데이터베이스를 백업할 수 있습니다(오프라인 백업). 자세한 지침은 데이터베이스의 오프라인 백업을 수행하는 방법을 참조하십시오.

레지스트리 도메인이 실행 중일 때 데이터베이스를 백업하려면(온라인 백업) Java DB 데이터베이스를 네트워크 서버 모드로 실행해야 합니다. 자세한 지침은 포함된 모드에서 네트워크 서버 모드로 전환하는 방법 및 데이터베이스의 온라인 백업을 수행하는 방법을 참조하십시오.

Java DB를 네트워크 서버 모드로 실행하면 일반 클라이언트/서버 구성으로 여러 클라이언트 연결을 수락할 수 있습니다. 예를 들어, Service Registry 및 SQL 클라이언트가 동시에 Java DB와 통신할 수 있습니다. Java DB가 네트워크 서버 모드로 실행되는 경우 Java DB는 기본값이 1527인 데이터베이스 포트를 사용합니다. Service Registry와 같은 클라이언트가 이 포트를 사용하여 데이터베이스와 통신합니다.

Java DB가 네트워크 서버 모드로 실행되면 Service Registry는 네트워크 클라이언트 모드로 실행됩니다.

네트워크 서버 모드로 실행되는 데이터베이스는 인증된 클라이언트만 사용할 수 있도록 비밀번호로 보호되어야 합니다. Java DB가 포함된 모드로 실행되는 경우에도 이러한 방식으로 데이터베이스를 보호할 수는 있지만 필수 사항은 아닙니다.

기본적으로 ServiceRegistry-base/install/install.properties 파일의 등록 정보는 Java DB가 포함된 모드로 실행되도록 설정됩니다. 표 1–3에서는 이러한 설정을 보여줍니다.

표 1–3 Java DB의 기본 등록 정보 설정

등록 정보 설정 

설명 

registry.install.clientDatabase=false

포함된 모드를 활성화합니다. 

registry.install.RequireDatabaseAuthentication=false

데이터베이스 인증을 요구하지 않도록 설정합니다. 

registry.install.DatabaseUserID=APP

사용자 아이디를 APP(사용되지 않음)로 설정합니다.

registry.install.DatabasePassword=app123

비밀번호를 app123(사용되지 않음)으로 설정합니다.

Java DB에 대한 자세한 내용은 Java DB 웹 사이트의 Java DB 설명서를 참조하십시오.

Procedure데이터베이스 인증을 요구하도록 설정하는 방법

기본적으로 데이터베이스 인증을 요구하지 않도록 설정되어 있습니다. 데이터베이스가 포함된 모드로 실행 중인 경우 인증을 요구하도록 설정할 수 있으며, 데이터베이스가 네트워크 서버 모드로 실행 중인 경우에는 인증을 요구하도록 설정해야 합니다.

  1. Service Registry 설치 디렉토리를 다음과 같이 변경합니다.

    cd ServiceRegistry-base/install

  2. 텍스트 편집기에서 install.properties 파일의 복사본을 엽니다.

  3. registry.install.RequireDatabaseAuthentication 등록 정보의 설정을 false에서 true로 변경합니다.

  4. registry.install.DatabaseUserID 등록 정보의 설정을 편집합니다.

    포함된 모드의 경우 이 값은 다음과 같이 APP이거나 비어 있을 수 있습니다.

    registry.install.DatabaseUserID=APP
    registry.install.DatabaseUserID=

    네트워크 서버 모드의 경우 이 값은 APP이어야 합니다.

  5. registry.install.DatabasePassword 등록 정보의 설정을 편집합니다.

    비밀번호는 6자 이상으로 구성되어야 합니다. 기본값은 app123입니다.

  6. 파일을 저장한 다음 닫습니다.

  7. 레지스트리의 Application Server 도메인을 중지한 다음 다시 시작합니다. 이 작업을 수행하려면 다음 명령을 실행합니다(모두 한 줄로 표시).

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file appserver.domain.bounce

    여기서, props-file은 나중에 구성 설치 후 사용자 정의 등록 정보를 사용하여 루트로 Service Registry를 구성하는 방법 또는 나중에 구성 설치 후 사용자 정의 등록 정보를 사용하여 루트가 아닌 사용자로 Service Registry를 구성하는 방법에서 편집한 install.properties 파일 복사본의 경로 이름입니다.

Procedure데이터베이스의 오프라인 백업을 수행하는 방법

데이터베이스가 포함된 모드로 실행 중인 경우에는 오프라인 백업을 수행해야 합니다.

  1. Service Registry 설치 디렉토리를 다음과 같이 변경합니다.

    cd ServiceRegistry-base/install

  2. 다음 명령을 실행합니다(모두 한 줄로 표시).

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file appserver.domain.stop

    여기서, props-file은 나중에 구성 설치 후 사용자 정의 등록 정보를 사용하여 루트로 Service Registry를 구성하는 방법 또는 나중에 구성 설치 후 사용자 정의 등록 정보를 사용하여 루트가 아닌 사용자로 Service Registry를 구성하는 방법에서 편집한 install.properties 파일 복사본의 경로 이름입니다.

  3. 다음 명령을 실행합니다(모두 한 줄로 표시).

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file backup.db

  4. 다음 명령을 실행하여 도메인을 다시 시작합니다(모두 한 줄로 표시).

    Ant-base/ant -f build-install.xml Dinstall.properties=props-file appserver.domain.start

Procedure포함된 모드에서 네트워크 서버 모드로 전환하는 방법

포함된 모드(기본값)에서 네트워크 서버 모드로 전환하려면 registry.install.clientDatabase 등록 정보의 설정을 false에서 true로 변경하고, 데이터베이스 인증을 요구하도록 설정합니다.

이 등록 정보를 편집한 후 데이터베이스 자원을 다시 만들고, 그런 다음 Application Server를 중지하고 다시 시작합니다.

  1. Service Registry 설치 디렉토리를 다음과 같이 변경합니다.

    cd ServiceRegistry-base/install

  2. 텍스트 편집기에서 install.properties 파일의 복사본을 엽니다.

  3. registry.install.clientDatabase 등록 정보의 설정을 false에서 true로 변경합니다.

  4. registry.install.RequireDatabaseAuthentication 등록 정보의 설정을 false에서 true로 변경합니다.

  5. 필요한 경우 registry.install.DatabaseUserID 등록 정보의 설정을 편집합니다.

    네트워크 서버 모드의 경우 이 값은 APP이어야 합니다.

  6. registry.install.DatabasePassword 등록 정보의 설정을 편집합니다.

    길이에는 제한이 없습니다. 기본값은 app123입니다.

  7. 파일을 저장한 다음 닫습니다.

  8. 데이터베이스 연결 풀 및 연관된 자원을 다시 만듭니다. 이 작업을 수행하려면 다음 명령을 실행합니다(모두 한 줄로 표시).

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file appserver.jdbcResource.update

    여기서, props-file은 나중에 구성 설치 후 사용자 정의 등록 정보를 사용하여 루트로 Service Registry를 구성하는 방법 또는 나중에 구성 설치 후 사용자 정의 등록 정보를 사용하여 루트가 아닌 사용자로 Service Registry를 구성하는 방법에서 편집한 install.properties 파일 복사본의 경로 이름입니다.

  9. 레지스트리의 Application Server 도메인을 중지한 다음 다시 시작합니다. 이 작업을 수행하려면 다음 명령을 실행합니다(모두 한 줄로 표시).

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file appserver.domain.bounce

  10. Java DB 데이터베이스를 시작합니다. 이 작업을 수행하려면 다음 명령을 실행합니다.

    asadmin start-database --dbhome database-directory

    기본적으로 이 명령은 데이터베이스 및 해당 로그 파일을 현재 디렉토리에 저장합니다. --dbhome 옵션을 사용하여 데이터베이스의 위치를 지정할 수 있습니다(일반적으로 RegistryDomain-base/3.0/data/registry/soar로 지정됨).

다음 순서

데이터베이스가 네트워크 서버 모드로 실행 중인 경우 데이터베이스의 온라인 백업을 수행할 수 있습니다.

나중에 포함된 모드로 다시 돌아가려면 다음 사항을 제외하고 동일한 단계를 수행합니다.

Procedure데이터베이스의 온라인 백업을 수행하는 방법

  1. Service Registry 설치 디렉토리를 다음과 같이 변경합니다.

    cd ServiceRegistry-base/install

  2. install.properties 파일 복사본의 registry.install.clientDatabase 등록 정보가 true로 설정되어 있는지 확인합니다.

  3. 다음 명령을 실행합니다(모두 한 줄로 표시).

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file backup.db

    여기서, props-file은 나중에 구성 설치 후 사용자 정의 등록 정보를 사용하여 루트로 Service Registry를 구성하는 방법 또는 나중에 구성 설치 후 사용자 정의 등록 정보를 사용하여 루트가 아닌 사용자로 Service Registry를 구성하는 방법에서 편집한 install.properties 파일 복사본의 경로 이름입니다.