test

Service Registry 3 2005Q4 관리 설명서

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 구성의 지침에 따라 작업을 계속 수행합니다.