2장 Identity Server 조정 스크립트

이 장에서는 Sun Java™ System Identity Server 2004Q2를 위한 amtune 조정 스크립트에 대해 설명합니다. 이 장은 다음 내용으로 구성되어 있습니다.



주	2004Q2 릴리스의 경우 amtune 스크립트는 Solaris 상에서만 완전한 기능을 수행합니다. Linux 및 x86 버전 스크립트는 이 플랫폼에서 다소 기능이 떨어집니다.

amtune 스크립트

amtune 스크립트를 사용하여 Identity Server의 성능을 조정하고 Identity Server 배포의 여러 구성 요소를 위한 성능 설정을 최적화할 수 있습니다.

amtune 스크립트는 대화식이 아니므로 특정 환경을 위해 수행할 조정 사항을 지정하려면 스크립트를 실행하기 전에 amtune-env 구성 파일의 매개 변수를 편집해야 합니다.

조정 개선 사항을 편집하려면 amtune-env 파일의 매개 변수를 수정하고 amtune 스크립트를 다음 형식으로 실행합니다. 여기서 admin_password는 Identity Server Admin 클라이언트 유틸리티 비밀번호이며 dirmanager_password는 디렉토리 관리자(cn=Directory Manager) 비밀번호입니다.

특정 구성 요소를 조정하려고 할 경우 /amtune 디렉토리에 제공된 구성 요소 스크립트를 사용할 수 있습니다. 구성 요소 스크립트는 amtune-env 파일의 관련 매개 변수를 사용합니다. 사용할 수 있는 구성 요소 스크립트는 다음과 같습니다.

amntune-as7 - 이 스크립트는 Sun Java System Application Server 7 웹 컨테이너를 조정합니다.

amtune-identity - 이 스크립트는 설치된 Identity Server 인스턴스를 조정합니다.

amtune-os - 이 스크립트는 Solaris 운영 체제 커널과 TCP/IP 매개 변수를 조정합니다.

amtune-prepareDSTuner - 이 스크립트는 Identity Server를 지원하는 Directory Server 인스턴스를 조정합니다. Directory Server를 조정하려면 추가 수준의 확인이 필요합니다. Identity Server는 기존 Directory Server를 비 독점 모드로 사용해야 합니다. 설치된 위치(로컬 또는 원격)와 관계 없이 Directory Server는 amtune 스크립트를 실행할 때 조정되지 않습니다. 스크립트를 실행하면 /tmp/amtune-directory.tar라는 이름의 tar 파일이 생성됩니다. 기본적으로 추출된 파일은 /tmp 디렉토리에 배치됩니다. Directory Server가 실행되고 있는 시스템에서 이 파일을 추출한 다음 amtune-directory 스크립트를 실행해야 합니다.

amtune-ws61 - 이 스크립트는 Sun Java System Web Server 6.1 웹 컨테이너를 조정합니다.

예를 들어, 운영 체제를 조정하려면 다음 형식을 사용합니다.

amtune 스크립트와 관련 amtune-env 파일은 다음 디렉토리에 있습니다.



주	이 장에서는 Solaris 디렉토리에 대한 내용만 설명합니다. Linux를 위한 디렉토리 구조는 다릅니다. 자세한 내용은 설명서 소개를 참조하십시오.

amtune

amtune 스크립트의 생성 모드에는 Identity Server 배포를 위한 일련의 조정 제안 사항을 생성하는 모드와 조정 사양을 구현하는 모드가 있습니다. 지정 가능한 다음 두 모드는 amtune-env 파일의 AMTUNE_MODE 매개 변수에 정의되어 있습니다.

검토 모드- 검토 모드가 지정되면 amtune 스크립트는 조정 제안 사항을 반환하지만 배포 환경은 변경하지 않습니다.

변경 모드 - 변경 모드가 지정되면 amtune 스크립트는 Directory Server 조정을 제외한 amtune-env 파일에 정의한 모든 조정 사항을 수정합니다.



주	변경 모드를 사용할 때는 주의를 기울여야 합니다. 스크립트를 실행한 후 웹 컨테이너를 다시 시작해야 하며 amtune 스크립트에서 시스템을 재시작할 것을 권장할 수도 있습니다. 조정 작업은 매우 반복적인 과정이며 각 배포마다 서로 다를 수 있습니다. amtune 유틸리티는 최상의 가능한 조정 매개 변수를 적용하려고 노력하지만 모든 배포는 고유하기 때문에 요구 사항에 적합하도록 사용자 정의 작업이 필요할 수 있습니다. Identity Server 관리자가 배포에 적용된 각 조정 사항을 파악하고 검토하는 것이 중요합니다.

어느 모드의 경우든 조정 권장 사항과 현재 값 목록이 amtune 출력 파일에 기록되어 단말기 창에 표시됩니다. 이 파일의 위치는 amtune-env의 AMTUNE_DEBUG_FILE_PREFIX 매개 변수를 따릅니다.

amtune-env 구성 파일 매개 변수

amtune-env 구성 파일에는 Identity Server 배포를 위한 조정 옵션을 정의하는 매개 변수가 포함되어 있습니다. 이 절에서는 amtune-env 매개 변수에 대해 설명합니다.

amtune 매개 변수

AMTUNE_MODE

review - 검토 모드가 지정되면 amtune 스크립트는 조정 제안 사항을 반환하지만 배포 환경은 변경하지 않습니다.

change - 변경 모드가 지정되면 amtune 스크립트는 Directory Server를 제외하고 amtune-env 파일에서 정의한 모든 조정 사항을 변경합니다.

AMTUNE_MODE_OS

이 매개 변수는 Solaris 운영 체제 커널과 TCP/IP 설정을 조정합니다.

AMTUNE_MODE_DS

이 매개 변수는 Identity Server를 지원하는 Directory Server 인스턴스를 조정합니다. Directory Server를 조정하려면 추가 수준의 확인이 필요합니다. Identity Server는 기존 Directory Server를 비 독점 모드로 사용해야 합니다. 설치된 위치(로컬 또는 원격)와 관계 없이 Directory Server는 amtune 스크립트를 실행할 때 조정되지 않습니다. 스크립트를 실행할 때 /tmp/amtune-directory.tar라는 tar 파일이 생성됩니다. 기본적으로 추출된 파일은 /tmp 디렉토리에 배치됩니다. Directory Server가 실행되고 있는 시스템에서 이 파일을 추출한 다음 amtune-directory 스크립트를 실행해야 합니다.

AMTUNE_MODE_WEB_CONTAINER

이 매개 변수는 Identity Server가 설치된 웹 컨테이너를 조정합니다.

AMTUNE_MODE_IDENTITY

AMTUNE_DEBUG_FILE_PREFIX

이 매개 변수는 디버그 파일 이름 접두어를 정의합니다. 이 매개 변수를 빈 값이 아닌 값으로 설정하면 amtune 스크립트에 의해 수행되는 모든 작업이 기록됩니다. 로그 파일의 위치는 AMConfig.properties의 com.iplanet.services.debug.directory 매개 변수에 설정됩니다.

아무 값도 지정하지 않으면 디버깅 정보가 기록되지 않고 모든 출력이 /dev/null 디렉토리로 보내집니다.

AMTUNE_PCT_MEMORY_TO_USE

이 매개 변수는 Identity Server에 의해 사용되는 가용 메모리의 양을 지정합니다. 현재 Identity Server는 최소 512MB의 RAM을 필요로 하며 최대 4 GB을 사용할 수 있습니다. 이 값은 32비트 응용 프로그램을 위한 프로세스 당 주소 공간 제한값입니다. 이 매개 변수를 0 (최하위 값)으로 설정하면 Identity Server는 512MB을 사용하도록 구성됩니다. 반대로 이 매개 변수를 100으로 설정하면 Identity Server를 위해 허용되는 최대 공간은 4GB와 시스템 가용 RAM의 100% 사이의 최소량이 될 것입니다. 다음 값은 이 설정에 따라 조정된 일부 파일입니다(전체 목록은 디버그 파일 참조).

웹 컨테이너 값

힙 크기 설정

<JVMOPTIONS>-XX:PermSize 및 <JVMOPTIONS>-XX:MaxNewSize

<JVMPTIONS>-XX:Permsize 및 <JVMOPTIONS>-XX:MaxPermSize

Identity Server AMConfig.properties 값

com.iplanet.am.notification.threadpool.size

com.iplanet.am.notification.threadpool.threshold

com.iplanet.am.sdk.cache.maxsize

com.iplanet.am.session.httpSession.enabled

com.iplanet.am.session.maxSessions

com.iplanet.am.session.invalidsessionmaxtime

com.iplanet.am.session.purgedelay

AMTUNE_PER_THREAD_STACK_SIZE

이 매개 변수는 스레드 당 사용 가능한 스택 공간을 설정합니다. 스레드 당 스택 크기는 Identity Server와 웹 컨테이너의 여러 스레드 관련 매개 변수를 조정하는 데 사용됩니다. 기본값은 128KB입니다. 이 값은 변경하면 안됩니다.

AMTUNE_SESSION_MAX_SESSION_TIME_IN_MTS

이 매개 변수는 최대 세션 시간을 분 단위로 설정합니다. 기본값은 60이지만 이 값은 설치에 따라 다를 수 있습니다. 다른 수준에서 세션 서비스가 등록되어 사용자 정의되면 조정 사항은 적용되지 않습니다.

이 매개 변수를 아주 큰 값이나 아주 작은 값으로 설정하면 Identity Server 배포에서 지원할 수 있는 활성 사용자 세션 수에 영향을 주기 때문에 이 매개 변수는 조정 목적으로 사용할 경우 선택 사항입니다.

이 매개 변수를 사용하려면 AM_TUNE_DONT_TOUCH_SESSION_PARAMETERS를 false로 설정해야 합니다.

AMTUNE_SESSION_MAX_IDLE_TIME_IN_MTS

이 매개 변수는 세션에 대한 최대 유휴 시간을 분 단위로 설정합니다. 기본값은 10이지만 이 값은 설치에 따라 다를 수 있습니다. 다른 수준에서 세션 서비스가 등록되어 사용자 정의되면 조정 사항은 적용되지 않습니다.

이 매개 변수를 사용하려면 AM_TUNE_DONT_TOUCH_SESSION_PARAMETERS를 false로 설정해야 합니다.

AMTUNE_SESSION_MAX_CACHING_TIME_IN_MTS

이 매개 변수는 최대 세션 캐시 시간을 분 단위로 설정합니다. 기본값은 2이지만 이 값은 설치에 따라 다를 수 있습니다. 다른 수준에서 세션 서비스가 등록되어 사용자 정의되면 조정 사항은 적용되지 않습니다.

이 매개 변수를 사용하려면 AM_TUNE_DONT_TOUCH_SESSION_PARAMETERS를 false로 설정해야 합니다.

설치 환경 매개 변수

HOSTNAME

이 매개 변수는 Identity Server가 배포된 시스템의 호스트 이름을 정의합니다. hostname 명령을 사용하여 환경의 호스트 이름을 얻을 수 없을 경우 다음 행을 주석으로 처리합니다.

그런 다음 올바른 호스트 이름을 설정하는 행을 추가합니다. 예를 들면 다음과 같습니다.

DOMAINNAME

이 매개 변수는 Identity Server가 배포된 시스템의 도메인 이름을 정의합니다. domainname 명령을 사용하여 환경의 도메인 이름을 얻을 수 없을 경우 다음 행을 주석으로 처리합니다.

그런 다음 올바른 도메인 이름을 설정하는 행을 추가합니다. 예를 들면 다음과 같습니다.

IS_CONFIG_DIR

이 매개 변수는 Identity Server의 구성 디렉토리를 정의합니다. 기본 위치는 IdentityServer_base/SUNWam/config입니다. 이 매개 변수는 변경하지 마십시오.

WEB_CONTAINER

이 매개 변수는 Identity Server가 배포된 웹 컨테이너의 이름을 정의합니다. 이 매개 변수에는 다음 값을 허용합니다.

WS61- Web Server 6.1을 웹 컨테이너로 지정

AS7 - Application Server 7를 웹 컨테이너로 지정

CONTAINER_BASE_DIR

이 매개 변수는 Identity Server가 배포된 웹 컨테이너의 기본 디렉토리를 정의합니다. 웹 컨테이너를 기본 위치가 아닌 위치에 설치한 경우에는 amtune을 실행하기 전에 이 값을 변경하십시오.

WEB_CONTAINER_INSTANCE_NAME

이 매개 변수는 Identity Server가 배포된 웹 컨테이너 이름의 인스턴스를 정의합니다.

Java System Web Server 웹 컨테이너의 경우 인스턴스 이름은 일반적으로 Identity Server의 호스트 이름입니다. 인스턴스 이름이 호스트 이름과 다르면 여기에서 올바른 인스턴스 이름을 지정해야 합니다. 예를 들면 다음과 같습니다.

이 경우 WEB_CONTAINER_INSTANCE_NAME을 다음과 같이 둘 수 있습니다.

Web Server 설치 위치가 일반적인 값이 아니면(예: /opt/SUNWwbsrvr/https-instance1) 인스턴스 이름은 instance1일 것입니다.


주	JSWS 설치 위치의 디렉토리 이름에서 "https-"를 삭제해야 합니다.

Application Server 웹 컨테이너의 경우 일반적인 인스턴스 이름은 server1입니다. 예를 들면 다음과 같습니다.

이 경우 인스턴스 이름은 설치 위치의 마지막 부분인 server1입니다.

Application Server 설치 위치가 일반적인 값이 아니면 (예: /var/opt/SUNWappserver7/domains/domain1/server-identity-ssl) 인스턴스 이름은 server-identity-ssl일 것입니다.

IS_INSTANCE_NAME

이 매개 변수는 Identity Server 설치를 위한 등록 정보 파일 이름을 결정하는 데 사용됩니다. Identity Server의 여러 인스턴스가 동일한 시스템에 배포될 수 있지만 일반적으로 Identity Server 인스턴스당 등록 정보 파일이 한 세트씩 있으며 인스턴스 이름이 파일 이름에 추가됩니다.

한 시스템에 하나의 Identity Server 인스턴스만 있으면 그 인스턴스 이름은 파일 이름에 추가되지 않습니다.

예를 들어, Web Server 기본 인스턴스 하에는 실행되는 Identity Sever 인스턴스가 하나뿐일 수 있습니다.


주	일반적으로 설치 경로의 리프 디렉토리인 Application Server의 전체 인스턴스 이름을 지정해야 합니다.

Identity Server가 server.example.com이라는 이름의 시스템에 설치된 경우 일반적으로 Web Server의 첫 번째 인스턴스는 https-server.example.com이 될 것입니다. 첫 번째 Identity Server 인스턴스를 위한 등록 정보 파일에는 인스턴스 이름이 추가되지 않습니다 (예: AMConfig.properties).

다수 인스턴스의 경우 여러 이름이 있을 수 있습니다. 예를 들어, Web Server 인스턴스가 3개일 경우 Web Server 인스턴스 이름은 server.example.com-instance1, server.example.com-instance2, server.example.com-instance3일 수 있습니다. 이 3개의 Identity Server 인스턴스를 컨테이너 인스턴스당 하나씩 배포하면 Identity Server를 위한 기본 등록 정보 파일 이름 (일반적으로, AMConfig.properties) 은 다음과 같을 수 있습니다.

AMConfig-instance1.properties

AMConfig-instance2.properties

AMConfig-instance3.properties.

IS_INSTANCE_NAME=instance1으로 지정할 수 있습니다. amtune 는 등록 정보 파일 이름을 다음 순서로 해결합니다.

AMConfig-IS_INSTANCE_NAME

AMConfig-WEB_CONTAINER_INSTANCE_NAME

AMConfig.properties

도구는 목록에서 첫 번째로 사용 가능한 등록 파일을 사용합니다.


주	웹 컨테이너와 amadmin 도구는 올바른 Identity Server를 가리켜야 합니다.

웹 컨테이너를 위해 웹 컨테이너 인스턴스 구성의 server.xml 구성 파일에서도 인스턴스 이름을 명시적으로 지정해야 합니다. 예를 들면 다음과 같습니다.

CONTAINER_INSTANCE_DIR


주	amadmin 도구도 올바른 서버 이름 (java option -Dserver.name=instance1) 을 가리켜야 합니다.

이 매개 변수는 Identity Server가 배포된 컨테이너 인스턴스를 위한 기본 디렉토리를 정의합니다. 웹 컨테이너를 기본 위치가 아닌 위치에 설치한 경우에는 amtune 스크립트를 실행하기 전에 이 값을 변경합니다.

Directory Server 매개 변수

DIRMGR_UID

이 매개 변수는 디렉토리 관리자의 사용자 아이디입니다. 사용자 아이디를 기본값(cn=Directory Manager) 이 아닌 값으로 변경한 다음에는 이 매개 변수 값을 반드시 변경해야 합니다.

DEFALUT_ORG_PEOPLE_CONTAINER

이 매개 변수는 최상위 조직 아래 Identity Server 인스턴스의 기본 사용자 컨테이너 위치를 정의합니다. 이 값은 LDAP 인증 서비스를 위한 검색 기반을 조정하는 데 사용됩니다. 검색 범위도 객체 수준으로 수정되고 기본 검색 범위는 하위 트리 수준입니다. 이 매개 변수는 기본 조직에 하위 조직이 없을 때 유용합니다. 아무 값도 지정되지 않으면 조정이 생략됩니다.

이전 목차 색인 다음
Sun Java System Identity Server 2004Q2 관리 설명서