관리

이 절에서는 관리와 관련된 알려진 문제점과 해결 방법을 설명합니다.

domain1이 없는 경우 package-appclient 스크립트가 작동하지 않음(6171458)

설명

기본적으로 as-install/lib/package-appclient.xml에는 asenv.conf 파일이 가리키는 domain1의 AS_ACC_CONFIG 변수를 위해 하드 코드된 값이 있습니다. domain1을 삭제하고 새 도메인을 만든 경우 AS_ACC_CONFIG 변수가 새 도메인 이름으로 업데이트되지 않아 package-appclient 스크립트의 실패 요인이 됩니다.

해결 방법

다음 중 한 가지를 수행합니다.

1. domain1을 그대로 두고 해당 위치에 다른 도메인을 만듭니다.

2. domain1을 제거하고 as-install/lib/package-appclient.xml 에서 domain1의 하드 코드된 값을 새 도메인 이름으로 변경합니다.

domain1이 없는 경우에는 새 도메인이 생성될 때마다 이 작업을 수행해야 합니다.

추가 JMX 에이전트를 사용하여 Application Server를 시작하는 기능이 지원되지 않음(6200011)

설명

J2SE 1.4.x, 5.0 이상을 Application Server에서 구성할 수 있습니다. J2SE 5.0 플랫폼의 중요한 기능은 JMX 에이전트를 시작하는 능력입니다. 이 기능은 서버를 시작할 때 시스템 등록 정보를 명시적으로 설정하면 활성화됩니다.

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

name="com.sun.management.jmxremote" value="true"
name="com.sun.management.jmxremote.port" value="9999"
name="com.sun.management.jmxremote.authenticate" value="false"
name="com.sun.management.jmxremote.ssl" value="false"

JMX 등록 정보를 구성하고 서버를 시작한 후 새 jmx-connector 서버가 Application Server VM 내에서 시작됩니다. 이로 인한 원하지 않는 부작용으로 관리 기능이 역으로 영향을 받고 Application Server 관리 콘솔과 명령줄 인터페이스에서 예기치 못한 결과가 발생할 수 있습니다. 문제는 내장된 jmx-connector 서버와 새 jmx-connector 서버 간에 충돌이 발생하는 것입니다.

해결 방법

jconsole(또는 다른 JMX-compliant 클라이언트)을 사용할 경우 Application Server 시작과 함께 시작되는 표준 JMX Connector Server를 다시 사용할 것을 고려합니다.

서버를 시작하면 아래에서 설명한 것과 유사한 행이 server.log에 나타납니다. 이곳에 지정된 JMXService URL에 연결하여 자격 증명을 성공적으로 제공한 후 동일한 관리/구성 작업을 수행할 수 있습니다. 예를 들면 다음과 같습니다.

[#|2004-11-24T17:49:08.203-0800|INFO|sun-appserver-ee8.1|
javax.enterprise.system.tools.admin|_ThreadID=10;|ADM1501: 
Here is the JMXServiceURL for the JMXConnectorServer: 
[service:jmx:rmi:///jndi/rmi://hostname:8686/management/
rmi-jmx-connector]. This is where the remote administrative 
clients should connect using the JSR 160 JMX Connectors.|#]

자세한 내용은 Sun Java System Application Server 9.1 Administration Guide를 참조하십시오.

웹 서비스의 종점 URL이 있는 로드 밸런서 구성 파일이 만들어지지 않음(6236544, 6275436)

설명

웹 서비스 URL을 내보내는 EJB 모듈이 있는 응용 프로그램을 사용하여 로드 밸런서 구성을 설정하면 loadbalancer.xml 결과 파일에 웹 서비스의 컨텍스트 루트가 없게 됩니다.

해결 방법

1. loadbalancer.xml 파일을 편집하여 누락된 웹 모듈을 다음과 같이 추가합니다.

   <web-module context-root="context-root-name" disable-timeout-in-minutes="30" enabled="true"/>

2. context-root-name 값을 EJB로 노출된 웹 서비스의 컨텍스트 루트 이름과 바꿉니다.

sun-appserv-admin을 사용하여 Application Server를 다시 시작하면 LoginException 오류 발생(6288893)

해결 방법

1. 기존 as-install/bin/asant 스크립트 이름을 asant.bak으로 변경합니다.

2. as-install/lib/install/templates/ee(SE/EE 버전용)에서 asant.template 파일을 as-install/bin/ 디렉토리에 복사하고 asant 파일 이름을 변경합니다.

3. 새로 복사된 as-install/bin/asant 스크립트를 편집하여 %CONFIG_HOME% 토큰을 as-install/config로 바꿉니다.

4. 원본 asant.bak 파일을 수동으로 변경했다면 이러한 변경 사항을 모두 새 asant 스크립트로 병합합니다.

.asadmintruststore 파일이 Application Server 설명서에 설명되어 있지 않음(6315957)

설명

Application Server 설명서에 .asadmintruststore 파일에 대한 설명이 없습니다. 이 파일이 서버 관리자의 홈 디렉토리에 없으면 서버에 호스트된 일정 응용 프로그램을 업그레이드할 때 심각한 버그가 발생할 수 있습니다.

해결 방법

• 가능하다면 서버를 설치한 사용자가 asadmin start-domain domain1 명령을 실행해야 합니다.

• 해당 사용자가 실행하지 않는 경우 .asadmintruststore를 설치 사용자의 홈 디렉토리에서 실행 중인 사용자의 홈 디렉토리로 이동 또는 복사해야 합니다.

• 파일이 설치 사용자의 홈 디렉토리에서 실행 중인 사용자의 홈 디렉토리로 이동되면 6309079, 6310428, 6312869 버그에서 설명한 대로 응용 프로그램의 업그레이드에 문제가 생길 수 있습니다. 이는 업그레이드/설치 사용자(일반적으로 Java ES의 루트)의 홈 디렉토리에 더 이상 .asadminstruststore 파일이 없기 때문입니다.

JMS 브로커에 도달하면 시간 제한 때문에 클러스터링된 인스턴스가 시작되지 않음(6523663)

설명

Application Server 클러스터 인스턴스의 기본 MQ 통합 모드는 LOCAL입니다. Application Server가 긴("not short") 위치(PATH)에 설치된 경우 클러스터 인스턴스가 시작되면 imqbrokerscv.exe가 충돌됩니다. 문제는 imqbrokersvc의 메모리 할당 문제입니다.

해결 방법

클러스터 인스턴스의 JMS 서비스 유형을 기본 LOCAL에서 REMOTE로 변경해야 합니다. 이 구성에서 모든 인스턴스는 다시 DAS 브로커를 가리킵니다. 다음 지침에 따라 REMOTE 모드로 클러스터를 구성합니다.

REMOTE 모드를 사용하면 모든 인스턴스가 한 브로커(DAS)를 사용하기 때문에 Application Server 클러스터가 시작될 때 브로커 클러스터가 만들어지지 않습니다. 자세한 내용은 http://www.glassfishwiki.org/gfwiki/attach/OnePagersOrFunctionalSpecs/as-mq-integration-gfv2.txt에 있는 한 페이지짜리 설명서의 4.1절, iii부에 있는 "Auto-clustering"을 참조하십시오. 위의 기능은 사용할 수 없습니다.

명령줄 사용

시작하기 전에

환경에 따라 포트 및 비밀번호 파일을 수정합니다. 아래의 지침에서 클러스터 이름은 racluster, DAS 관리 포트는 5858, DAS JMS 포트는 7676입니다.

1. JMS 유형을 REMOTE로 변경하여 클러스터 구성을 수정합니다.

   as-install/bin/asadmin.bat set --port 5858 --user admin --passwordfile \ as-install/bin/password_file racluster.jms-service.type=REMOTE

2. DAS JMS 호스트에 해당되는 JMS 호스트를 만듭니다.

   as-install/bin/asadmin.bat create-jms-host --port 5858 --user admin --passwordfile \ as-install/bin/password_file --target racluster --mqhost localhost --mqport 7676 \ --mquser admin --mqpassword admin dashost

3. 기본 JMS 호스트를 이전 단계에서 만든 DAS JMS 호스트로 설정합니다.

   as-install/bin/asadmin.bat set --port 5858 --user admin --passwordfile \ as-install/bin/password_file racluster.jms-service.default-jms-host=dashost

관리 GUI 사용

1. 구성->cluster-name-config->Java Message Service->JMS 호스트로 이동합니다.

2. 새로 만들기를 눌러 새 JMS 호스트를 만들고 이름을 dashost로 지정합니다.

3. DAS의 JMS 서비스에 해당되는 구성 설정을 입력합니다. 기본값은 다음과 같습니다.

   • 호스트 이름: localhost

   • 포트: 7676

   • 관리자: admin

   • 비밀번호: admin

   이 설정을 DAS JMS 서비스에 맞게 수정합니다.

4. Java Message Service 탭으로 돌아와 JMS 서비스 유형을 REMOTE로 변경합니다(기본값: LOCAL).

5. default-jms-host 드롭다운 목록에서 dashost를 선택합니다.

6. 변경 사항을 저장한 다음 노드 에이전트 또는 클러스터를 시작합니다.

Netscape 8.1.3, Mozilla 1.7 및 Safari 2.0.4 브라우저에서 jmaki 차트를 표시할 수 없음(6543014)

설명

지원되지 않는 브라우저를 사용하여 로그 통계 모니터링 페이지의 차트를 표시하려고 하면 다음 오류가 발생할 수 있습니다.

Error loading jmaki.widgets.jmaki.charting.line.Widget : id=form1:jmaki_chart11
Script: http://easqelx5.red.iplanet.com:4848/resources/jmaki/charting/ \
line/component.js (line:5437).
Message: area.initialize is not a function

해결 방법

지원되는 브라우저를 사용합니다. Application Server 9.1 Update 1에서 지원되는 브라우저의 목록은 브라우저를 참조하십시오.

각 AS 주요 릴리스에서 기본 포트가 변경됨(6566481)

설명

지난 세 번의 주요 Application Server 릴리스 각각에서 기본 관리 포트가 변경되었습니다. 7.x, 8. x 및 9.x의 기본 관리 포트는 다음과 같습니다.

• AS 7.x: 4848

• AS 8.x: 4849

• AS 9.x: 4848

해결 방법

이 문제는 버그는 아니지만 알아 두어야 하는 사항입니다. 기본 관리 포트는 권장 사항일 뿐입니다. 이후 Application Server 릴리스에서는 기본 4848 포트를 유지할 예정입니다.

create-domain 명령이 AIX의 사용자 정의 비밀번호에서 실패(6628170)

설명

AIX 운영 체제에서 사용자 정의 마스터 비밀번호로 도메인을 만드는 시도가 다음 오류와 함께 실패합니다.

keytool error (likely untranslated): java.lang.NullPointerException
 Enter keystore password:  New keystore password:

해결 방법: (AIX) 사용자 정의 마스터 비밀번호로 도메인을 생성하려면

다음 절차에서는 각 단계에 필요한 옵션만 제공됩니다. 명령에 대한 추가 옵션이 필요한 경우 명령에 이러한 옵션을 지정합니다. Application Server 명령에 대한 자세한 내용은 Sun Java System Application Server 9.1 Update 1-9.1 Update 2 Reference Manual 을 참조하십시오.

1. 다음 코드 줄이 포함된 쉘 스크립트를 만듭니다.

   #!/bin/sh
   changeKeystorePass() {
     keytool -storepasswd -keystore ${KEYSTORE} -storepass ${OLD} -new ${NEW}
   }
   changeTruststorePass() {
     keytool -storepasswd -keystore ${TRUSTSTORE} -storepass ${OLD} -new ${NEW}
   }
   changeKeyPass() {
     keytool -keypasswd -alias s1as -keystore ${KEYSTORE} -storepass ${NEW} -keypass ${OLD} -new ${NEW}
   }
   changeDomainPasswordEntry() {
     keytool -storepasswd -storetype JCEKS -keystore ${DOMAINPASSWORDS} -storepass ${OLD} -new ${NEW}
   }
   deleteMasterPasswordFile() {
     if [ -f ${DOMAIN_PATH}/master-password ] ; then
       echo Deleting ${DOMAIN_PATH}/master-password
       rm -f ${DOMAIN_PATH}/master-password
     fi
   }
   DOMAIN_PATH=$1
   OLD=$2
   NEW=$3
   if [ $# != 3 ] ; then
     echo Usage: $0 domain-path old-master-pass new-master-pass
     exit 1
   fi
   echo Processing ...
   if [ ! -f ${DOMAIN_PATH}/config/domain.xml ] ; then
     echo "Domain with folder ${DOMAIN_PATH} does not exist, create it first"
     exit 2
   else
     KEYSTORE=${DOMAIN_PATH}/config/keystore.jks
     TRUSTSTORE=${DOMAIN_PATH}/config/cacerts.jks
     DOMAINPASSWORDS=${DOMAIN_PATH}/config/domain-passwords
     changeKeystorePass
     changeTruststorePass
     changeKeyPass
     changeDomainPasswordEntry
     deleteMasterPasswordFile
   fi

2. 기본 마스터 비밀번호를 지정하여 도메인을 만듭니다.

   aadmin create-domain {--adminport aminportno|--portbase portbase} domain-name Please enter the admin user name>admin-user Please enter the admin password>admin-user-password Please enter the admin password again>admin-user-password Please enter the master password [Enter to accept the default]:> Please enter the master password again [Enter to accept the default]:>

   기본 마스터 비밀번호는 changeit입니다.

3. 방금 만든 도메인의 마스터 비밀번호를 변경합니다.

   마스터 비밀번호를 변경하려면 단계 1에서 만든 스크립트를 실행합니다.

   script-name domain-path old-password new-password

4. 단계 2에서 만든 도메인을 시작합니다.

   asadmin start-domain domain-name

   도메인에 사용자 정의 마스터 비밀번호가 있으므로 마스터 비밀번호를 입력하라는 메시지가 표시됩니다.

5. 프롬프트에 대한 응답으로 새 마스터 비밀번호를 입력합니다.

6. 클러스터를 지원하도록 구성된 도메인의 경우 노드 에이전트를 만들고 시작합니다.

   1. 단계 2에서 만든 도메인의 노드 에이전트를 만듭니다.

      asadmin create-node-agent --port portno --user admin-user

   2. 단계 a에서 만든 노드 에이전트를 시작합니다.

      asadmin start-node-agent

      도메인에 사용자 정의 마스터 비밀번호가 있으므로 마스터 비밀번호를 입력하라는 메시지가 표시됩니다.

   3. 프롬프트에 대한 응답으로 새 마스터 비밀번호를 입력합니다.

참조

Application Server 설명서 페이지

• create-domain(1)

• create-node-agent(1)

• start-domain(1)

• start-node-agent(1)

AIX: 0403-027 매개 변수 목록이 너무 김(6625591)

설명

AIX 운영 체제에서 일부 OS 관련 작업은 다음 오류와 함께 실패합니다.

0403-027 The parameter list is too long

OS 관련 작업의 예로는 응용 프로그램 배포나 응용 프로그램 클라이언트 컨테이너 실행이 있습니다.

이 문제는 일반적으로 CLASSPATH 환경 변수의 긴 파일 경로로 인해 발생합니다.

해결 방법

다음 해결 방법 중 하나를 사용합니다.

• 최대 명령줄 길이를 늘립니다. 자세한 내용은 (AIX) 최대 명령줄 길이를 늘리려면을 참조하십시오.

• xargs 명령을 사용하여 인수 목록을 구성하고 명령을 시작합니다. xargs 명령을 사용하면 명령이 최대 명령줄 길이를 초과할 수 있습니다.

(AIX) 최대 명령줄 길이를 늘리려면

ncargs 속성은 환경 변수를 포함한 최대 명령줄 길이를 결정합니다. AIX 운영 체제에서 ncargs 속성의 기본값은 4KB 블록 4개입니다. Application Server 명령이 최대 명령줄 길이를 초과하지 않게 하려면 이 값을 4KB 블록 16개로 늘립니다.

ncargs 속성 값을 변경한 후 데몬을 재부트하거나 새로 고칠 필요가 없습니다.

1. ncargs 속성 값을 결정합니다.

   lsattr -EH -l sys0 | grep ncargs

2. ncargs 속성 값이 4KB 블록 16개보다 작으면 값을 16으로 늘립니다.

   chdev -l sys0 -a ncargs=16