test

Service Registry 3 2005Q4 관리 설명서

1장 Service Registry 구성 및 설정

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

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

Service Registry 구성

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

ServiceRegistry-base 위치는 Solaris 운영 환경에서는 /opt/SUNWsoar이고, Linux 시스템에서는 /opt/sun/SUNWsoar입니다.

주 –

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 도메인에 대한 기본 포트가 아닌 포트를 설정합니다.

표 1–1 Service Registry 설치 등록 정보

등록 정보 이름 

설명 

기본 등록 정보 값 

DomainName

Application Server 도메인 이름 

registry

ServerInstancePort

Application Server HTTP 포트 

6060

ServerInstanceSecurePort

Application Server HTTPS 포트 

6443

ServerJMSPort

Application Server Message Queue 포트 

6484

ServerIIOPPort

Application Server IIOP 포트 

6485

ServerIIOPSecurePort

Application Server IIOP 보안 포트 

6486

ServerIIOPMutualAuthPort

Application Server IIOP 상호 인증 포트 

6487

AdministrationJMXPort

Application Server JMX 포트 

6488

AdministrationPort

Application Server Administrative Server 포트 

6489

AdministratorUserID

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

admin

AdministratorPassword

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

12345678

ApplicationServerKeystorePassword

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

12345678

RegistryServerKeystorePassword

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

12345678

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

시작하기 전에

레지스트리를 구성하려면 root로 로그인하거나 수퍼유저가 되어야 합니다.

단계

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

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

    보안상의 이유로 비밀번호 값을 변경할 때는 이 파일을 편집하지 않는 것이 좋습니다. 대신 명령줄에서 이러한 값을 지정합니다.

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

    Solaris의 경우: /usr/sfw/bin/ant -f build-install.xml install

    Linux의 경우: /opt/sun/bin/ant --noconfig -f build-install.xml install

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

    /usr/jdk/entsys-j2se

    명령줄에서 변경된 비밀번호를 지정하려면 명령에 다음 옵션을 지정합니다(모두 한 줄로 표시).


    /usr/sfw/bin/ant -f build-install.xml
-Dregistry.install.RegistryServerKeystorePassword=passwd1
-Dregistry.install.AdministratorPassword=passwd2
-Dregistry.install.ApplicationServerKeystorePassword=passwd3 install

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

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

    RegistryDomain-base 위치는 Solaris 운영 환경에서는 /var/opt/SUNWsoar이고 Linux 환경에서는 /var/opt/sun/SUNWsoar입니다.

  4. ant install 명령의 출력에서 오류를 검토합니다.

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

Procedure관리 도구 사용 활성화 방법

관리자 역할을 가진 사용자로 제한된 관리 도구 작업을 수행하려면 관리 도구 매니페스트 클래스 경로에 JAR 파일을 추가하여 버그를 해결해야 합니다.

단계

  1. ServiceRegistry-base/install 디렉토리에 있어야 합니다.

  2. soapprocessor.jar 파일을 배포된 레지스트리에서 레지스트리 lib 디렉토리로 복사합니다. 다음 명령을 실행합니다(모두 한 줄로 표시).


    cp 
RegistryDomain-base/domains/registry/applications/j2ee-modules/soar/WEB-INF/lib/soapprocessor.jar 
../lib

  3. admin.jar.manifest.fix 설치 대상을 다음과 같이 실행합니다.

    Solaris의 경우: /usr/sfw/bin/ant -f build-install.xml admin.jar.manifest.fix

    Linux의 경우: /opt/sun/bin/ant --noconfig -f build-install.xml admin.jar.manifest.fix

Service Registry에 대한 Application Server 도메인 관리

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

이 위치는 Application Server 도메인의 기본 위치인 /var/opt/SUNWappserver/domains(Solaris) 또는 /var/opt/sun/appserver/domains(Linux)와 다릅니다.

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

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

asadmin 명령을 사용하여 registry 도메인을 관리할 수도 있습니다. 도메인이 기본 위치에 없으므로 asadmin 명령을 사용할 때 --domaindir 옵션을 지정해야 합니다.

registry 도메인에 대한 비밀번호 파일은 ServiceRegistry-base/pw.txt입니다. registry 도메인을 관리할 때 이 비밀번호 파일을 asadmin 명령의 --passwordfile 옵션에 대한 인수로 지정합니다.

registry 도메인은 기본 Application Server 도메인 domain1과 충돌이 발생하지 않도록 기본 포트가 아닌 포트를 사용합니다. 표 1–2에서는 이러한 포트를 나열하고 설명합니다. 자세한 내용은 Sun Java System Application Server Enterprise Edition 8.1 2005Q2 관리 설명서의 Application Server의 포트를 참조하십시오.

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

포트 값 

설명 

6060 

HTTP 포트 

6443 

SSL에서의 HTTPS 

6484 

Message Queue 포트 

6485 

IIOP 포트 

6486 

IIOP SSL 포트 

6487 

IIOP 상호 인증 포트 

6488 

JMX 포트 

6489 

Application Server 도메인 관리 포트 

ProcedureApplication Server 관리 콘솔 사용 방법

단계

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

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

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

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

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

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

  5. 로그인을 누릅니다.

참조

관리 콘솔에 대한 자세한 내용은 관리 콘솔에 대한 온라인 도움말 또는 Sun Java System Application Server Enterprise Edition 8.1 2005Q2 관리 설명서를 참조하십시오.

Service Registry 로깅 수준을 변경하려면 Sun Java System Application Server Enterprise Edition 8.1 2005Q2 관리 설명서의 로그 수준 구성 지침을 따릅니다. 추가 등록 정보 영역에서 지정할 등록 정보는 org.apache.commons.logging.simplelog.log.org.freebxml.omar입니다.

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

레지스트리 구성 프로세스에서 레지스트리가 배포되는 Application Server 도메인을 시작합니다. 특정 관리 작업을 수행한 후에는 도메인을 중지했다가 다시 시작해야 합니다. 이러한 작업의 예는 외부 웹 사이트에 대한 액세스 허용 및 관리자 만들기입니다.

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

단계

  1. Service Registry 설치 디렉토리로 변경합니다.

    cd ServiceRegistry-base/install

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

    Solaris: /usr/sfw/bin/ant -f build-install.xml appserver.domain.bounce

    Linux: /opt/sun/bin/ant --noconfig -f build-install.xml appserver.domain.bounce

    이 대상은 도메인을 중지하였다가 다시 시작시킵니다.

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

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

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

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

단계

  1. 지원할 루트 인증서를 다운로드합니다. 루트 인증서를 제공하는 사이트는 다음과 같습니다.

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

    주 –

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

  3. .cer 파일을 ServiceRegistry-base/install/cacerts 디렉토리에 복사합니다.

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

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

    Solaris: /usr/sfw/bin/ant -f build-install.xml install.cacerts

    Linux: /opt/sun/bin/ant --noconfig -f build-install.xml install.cacerts

    이 명령은 ServiceRegistry-base/install/cacerts 디렉토리에서 찾은 인증서를 Application Server 도메인 truststore에 설치합니다.

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

  6. 레지스트리에 대해 Application Server 도메인 중단 및 다시 시작 의 지침을 따릅니다.

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

Application Server의 기본 설치 위치는 Solaris 운영 환경에서는 /opt/SUNWappserver/appserver이고, Linux 시스템에서는 /opt/sun/appserver입니다. Application Server를 다른 위치에 설치한 경우에는 Service Registry를 구성하기 전에 install.properties 파일을 편집해야 합니다.

Procedureinstall.properties 파일 편집 방법

단계

  1. ServiceRegistry-base/install 디렉토리의 install.properties 파일을 텍스트 편집기에서 엽니다.

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

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

  4. install.properties 파일을 저장하고 닫습니다.

다음 순서

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

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

Service Registry의 기본 설치 위치는 Solaris 운영 환경에서는 /opt/SUNWsoar이고, Linux 시스템에서는 /opt/sun/SUNWsoar입니다. Service Registry를 다른 위치에 설치한 경우에는 Service Registry를 구성하기 전에 install.properties 파일을 편집해야 합니다.

Procedureinstall.properties 파일 편집 방법

단계

  1. ServiceRegistry-base/install 디렉토리의 install.properties 파일을 텍스트 편집기에서 엽니다.

  2. soar.sdk.home 및 soar.server.home 등록 정보의 주석 처리된 정의를 찾습니다.

  3. 각 등록 정보에 대해 주석 문자(#)를 제거하고 등록 정보 정의를 Service Registry의 실제 위치로 바꿉니다.

  4. install.properties 파일을 저장하고 닫습니다.

다음 순서

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

외부 웹 사이트에 대한 액세스 허용

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

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

Procedure웹 프록시 지정 방법

단계

  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

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

  8. 저장을 누릅니다.

  9. 레지스트리에 대해 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 2005Q4 사용자 설명서의 사용자 계정 만들기에 설명된 대로 사용자 등록을 수행합니다.

    다운로드한 인증서의 경로 이름을 기억해 두십시오. 인증서 파일의 기본 이름은 generated-key.p12입니다.

  2. 다음과 같이 사용자 User 객체의 고유 식별자를 가져옵니다.

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

    2. 사용자에 대해 설정된 레지스트리의 User 객체를 보려면 세부 정보 링크를 클릭합니다.

    3. 고유 식별자 필드 값을 적어둡니다.

  3. 인증서를 홈 디렉토리의 다음 위치에 복사합니다. 필요한 경우 디렉토리를 만듭니다.

    $HOME/soar/3.0/jaxr-ebxml/security

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

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

  6. omar.security.authorization.registryAdministrators 등록 정보에 대한 정의를 찾습니다.

  7. 단계 2에 대해 적어 둔 논리 식별자 문자열 앞에 세로 막대(|)를 추가하여 등록 정보 정의를 편집합니다.

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

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

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

  9. 레지스트리에 대해 Application Server 도메인 중단 및 다시 시작 의 지침을 따릅니다.

다음 순서

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

웹 콘솔 구성

관리자는 구성 파일을 편집하여 웹 콘솔 표시의 일부 측면을 사용자 정의할 수 있습니다. 이 절에서는 다음 작업에 대해 설명합니다.

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

미리 정의된 쿼리 추가

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

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

단계

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

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

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

  2. SQL 문의 자리 표시자 및 AdhocQuery 객체에 대한 고유 식별자를 적어둡니다.

  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 도메인 중단 및 다시 시작 의 지침을 따릅니다.

검색 결과 표시 구성

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

웹 콘솔은 기본적으로 검색 결과 영역에 특정 열을 표시합니다. 각 객체에 대해 객체 유형, 이름, 설명, 버전 및 버전 주석을 표시합니다. 일부 객체 유형의 경우에는 기본 표시와는 다른 표시로 구성됩니다. 예를 들어, 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=10

  4. 10을 원하는 값으로 변경합니다.

  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 객체 및 레지스트리 객체에 대해 기본 표시와는 다른 표시를 구성합니다.

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

  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. 다음 명령을 실행합니다(모두 한 줄로 표시).

    Solaris: /usr/sfw/bin/ant -f build-install.xml appserver.domain.stop

    Linux: /opt/sun/bin/ant --noconfig -f build-install.xml appserver.domain.stop

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

    Solaris: /usr/sfw/bin/ant -f build-install.xml appserver.domain.delete

    Linux: /opt/sun/bin/ant --noconfig -f build-install.xml appserver.domain.delete

ProcedureService Registry 데이터베이스 다시 설치

단계

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

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

    Solaris: /usr/sfw/bin/ant -f build-install.xml install.db

    Linux: /opt/sun/bin/ant --noconfig -f build-install.xml install.db

데이터베이스 백업 및 복원

레지스트리에서는 Apache Derby 데이터베이스를 사용합니다. 기본적으로 데이터베이스는 RegistryDomain-base/3.0/data/registry/soar/ 디렉토리에 있습니다.

데이터베이스를 백업 및 복원하는 방법은 Apache Derby 설명서를 참조하십시오.

ProcedureApache Derby 설명서를 찾는 방법

단계

  1. 웹 브라우저에서 Apache Derby 웹 사이트로 이동합니다.

  2. 설명서 탭을 누릅니다.

  3. 10.0 설명서를 누릅니다.

  4. 서버 및 관리 설명서를 찾습니다.

  5. 데이터베이스 백업 및 복원을 설명하는 절을 찾습니다.