업그레이드 유틸리티

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

install_dir/domains 디렉토리가 아닌 사용자 정의 경로에서 만든 도메인이 직접 업그레이드되지 않음(6165528)

설명

install_dir /domains 디렉토리가 아닌 사용자 정의 경로에서 생성된 도메인은 Application Server Enterprise Edition 8에서 Application Server Enterprise Edition 8.1로 업그레이드되는 동안 직접 업그레이드되지 않습니다.

업그레이드 유틸리티를 실행하고 install_dir을 소스 설치 디렉토리로 식별하면 install_dir/domains 디렉토리에 생성되는 도메인만 업그레이드됩니다. 다른 위치에 생성된 도메인은 업그레이드되지 않습니다.

해결 방법

업그레이드 프로세스를 시작하기 전에 모든 도메인 디렉토리를 다른 위치에서 install_dir/domains 디렉토리로 복사합니다.

일부 Linux 시스템에서 "업그레이드 마법사 시작" 버튼을 누른 후에 "현재 위치에서 업그레이드"를 실행하는 설치 프로그램에서 업그레이드 도구를 시작하지 못함(6207337)

설명

이 문제는 몇몇 Linux 시스템에서 발견되었으며 Java Desktop System 2에서 가장 일반적으로 나타나지만 Red Hat 배포에서도 볼 수 있습니다.

설치 프로그램 화면의 "업그레이드 도구 시작" 버튼을 누른 후에 설치 프로그램에서 업그레이드 도구를 시작하여 업그레이드 프로세스를 완료하는 데 실패하고 명령 프롬프트가 반환되지 않은 채 중단됩니다.

해결 방법

이 문제는 명령줄 설치 모드를 사용하여 현재 위치에서 업그레이드를 실행하는 경우에는 발생하지 않습니다.

1. 현재 위치에서 업그레이드를 GUI 모드에서 실행하고 이 문제가 발생하면 설치 프로그램이 시작된 단말기 창에서 Ctrl+C를 눌러 설치 프로그램을 종료합니다.

2. 단말기 창에서 다음 명령을 사용하여 업그레이드 도구를 시작합니다.

   install_dir/bin/asupgrade --source install_dir/domains --target install_dir --adminuser adminuser --adminpassword adminpassword --masterpassword changeit

   adminuser 및 adminpassword는 업그레이드 중인 설치를 위해 사용되는 값이 일치해야 합니다.

3. 업그레이드 도구에서 업그레이드 프로세스를 완료하면 브라우저를 시작하고 다음 URL을 입력하여 정보 페이지를 검토할 수 있습니다.

   file://install_dir/docs-ee/about.html

제품을 등록하는 설치 옵션을 선택한 경우에는 제품 정보 페이지에서 등록 페이지로 연결되는 링크를 따라갑니다.

8.0 PE(Platform Edition)에서 8.1 EE(Enterprise Edition) UR2로 업그레이드하는 동안이나 그 이후에 자체 서명된 인증서가 신뢰되지 않음(6296105)

해결 방법

(업그레이드 후) 대상 domain.xml에서 다음 항목을 제거하고 서버를 다시 시작합니다.

<jvm-options>-Djavax.net.ssl.keyStore=${com.sun.aas.instanceRoot}
/config/keystore.jks</jvm-options>-
<jvm-options>Djavax.net.ssl.trustStore=${com.sun.aas.instanceRoot}
/config/cacerts.jks</jvm-options>

업그레이드 도구에서 인스턴스(클러스터 구성원)의 수정된 index.html 내용을 덮어씀(6386451)

설명

업그레이드 도구가 서버 인스턴스의 기존 index.html 파일을 덮어씁니다.

해결 방법

업그레이드 도구를 실행하기 전에 기존 index.html 파일을 백업하고, 나중에 백업된 파일을 복원합니다.

(sbs-manual, sbs-installer)에서 서버 인스턴스 서버에 null이라는 이름의 시스템 커넥터가 없다는 오류를 표시함(6545145)

설명

Application Server 8.0PE에서 9.1로 업그레이드하는 경우 서버에 null이라는 이름의 시스템 커넥터가 없다는 오류가 발생하고 sbs-manual에 잘못된 사용자 정보가 표시됩니다. 하드코드된 값을 변경해도 같은 오류 메시지가 표시됩니다. 이것은 8.0과 9.1 사이에서 domain.xml이 변경되어서 발생하는 문제입니다.

해결 방법

8.0 PE를 9.1로 업그레이드하는 동안에만 이 버그가 발생합니다. 해결 방법은 8.1, 8.2 또는 9.0으로 일단 업그레이드했다가 다시 9.1로 업그레이드하는 것입니다.

서로 다른 빌드 조합을 사용하는 경우 업그레이드 시 다른 여러 도메인이 손실됨(6546130)

설명

현재 위치에서 업그레이드를 수행하는 경우 소스에 여러 도메인이 있으면 프로세스가 중지된 후에도 설치 프로그램에서 업그레이드 도구를 호출합니다. GUI 모드에서 호출한 경우에 발생하는 문제입니다.

해결 방법

1. 현재 위치에서 CLI 모드로 설치를 수행하고 설치 프로세스의 마지막에 설치 프로그램에서 업그레이드 도구를 선택하라는 프롬프트를 표시하면 종료합니다. 그러면 도메인 디렉토리에 있는 도메인이 삭제되지 않습니다. 업그레이드 도구는 bin 디렉토리에서 수동으로 호출해야 합니다.

2. 현재 위치에서 GUI 모드로 설치를 수행할 때 도메인 루트에 도메인의 백업을 만들어 작업 중에 도메인이 손실되는 것을 방지합니다. 설치 프로세스의 마지막에 설치 프로그램에서 업그레이드 도구를 호출하라는 프롬프트를 표시하면 종료합니다. 도메인이 손실된 경우 백업된 도메인을 도메인 디렉토리에 복사합니다. 업그레이드 도구를 수동으로 실행하여 업그레이드를 수행합니다.

Solaris: 업그레이드 도구의 미리 입력된 마스터 비밀번호가 AS8.2이 아닌 AS9.1의 값임(6565825)

설명

AS 8.2에서 9.1로 업그레이드하는 경우 8.2 설치의 마스터 비밀번호가 9.1 설치로 상속되지 않습니다. 그러면 다음 관리자 로그인 시에 인증 오류가 발생합니다.

해결 방법

Application Server 9.1에서 기본 관리자 비밀번호는 changeit입니다. 8.2에서 업그레이드한 후에 9.1로 로그인할 때 문제가 발생하지 않게 하려면 다음 세 가지 중 하나를 수행합니다.

• 업그레이드를 수행하기 전에 8.2 관리자 비밀번호를 changeit으로 변경합니다.

• 업그레이드 프로세스 중에 기본 관리자 비밀번호를 승인하지 않고, 대신 원하는 비밀번호를 명시적으로 입력합니다.

• 기본 비밀번호로 9.1에 로그인한 다음 즉시 변경합니다.

AS9.1 IFR 업그레이드 도구에서 JES5U1 MQ 저장소를 새로운 var 홈으로 마이그레이션하지 않음(6573635)

설명

업그레이드 도구에서는 어떤 형태로도 데이터베이스 또는 데이터베이스 테이블의 업그레이드를 처리하지 않으며, 그런 기능을 지원할 계획도 없습니다. 자원 참조 구성이 전송되며 Application Server는 원래 데이터베이스 및 테이블을 사용하여 작업을 계속해야 합니다. 데이터베이스를 변경하거나 데이터베이스 테이블을 전송하려면 사용 중인 데이터베이스에서 작동하는 도구를 사용합니다.

해결 방법

다음 단계를 수행하여 MQ 저장소를 마이그레이션합니다.

AS 8.2가 종료된 다음 AS9.1 업그레이드 도구를 실행한 후, AS9.1을 처음으로 시작하기 전에 다음 단계를 수행합니다. IFR 설치/업그레이드 후에 이미 AS 9.1을 시작한 경우에는 이 단계를 수행하지 마십시오. MQ 메시지 저장소가 불안정해질 수 있습니다.

1. domains/domain1/imq 하위 디렉토리 전체를 AS 8.x domains 디렉토리에서 AS 9.1 domains 디렉토리로 복사합니다.

2. 디렉토리 및 파일의 소유자가 Application Server를 실행할 사용자와 같은지 확인합니다.

위의 단계를 수행한 후 Application Server 9.1을 시작하고 Application Server 9.1에서 MQ 저장소를 사용할 수 있습니다. domains 디렉토리는 JES5 U1 형식에서 MQ 4.1 형식으로 마이그레이션됩니다. AS 8.2에 있는 원래 JES5 U1 MQ 저장소는 보존되며 AS 9.1을 시작할 때 이 절차나 MQ4.1에 의해 수정되지 않습니다.

JES5(AS 8.2)를 AS 9.1로 업그레이드. PS 커뮤니티 샘플이 손상되어 수많은 javax.faces 오류 발생(6576700)

설명

JES5(Application Server 8.2)에서 Application Server 9.1로 업그레이드할 경우 Portal Server 커뮤니티 샘플은 더 이상 작동하지 않으며 수많은 javax.faces.application.ApplicationFactory 오류를 일으킵니다.

해결 방법

JES5 Portal Server에서 Application Server 8.2가 설치된 경우 Application Server 8.2에서 9.1로의 업그레이드는 지원되지 않습니다. Application Server를 9.1로 업그레이드하기 전에 Portal Server를 Java ES 5 Update 1로 업그레이드해야 합니다.

AS91 IFR b58, Linux: 설치 프로그램을 통해 새 Java를 설치한 후에 /usr/jdk/entsys-j2se 링크가 업데이트되지 않음(6591697)

설명

Linux 플랫폼에 있는 IFR 설치 프로그램을 사용해서 Application Server 8.2에서 9.1로 업그레이드하는 경우 설치를 성공적으로 완료한 후에 JDK 설치 옵션을 선택하면 대부분의 JES 구성 요소가 작업을 멈춥니다.

해결 방법

이 문제는 Linux 플랫폼에 있는 Application Server 9.1의 IFR 설치에만 영향을 주며 JDK 설치 옵션을 선택한 경우에만 발생합니다. 이 문제를 해결하려면 설치가 끝난 직후에 /usr/jdk/entsys-j2se를 /usr/java/jdk1.5.0_12 디렉토리에 수동으로 연결합니다.

AS9.1 IFR Win 인플레이스(In-place) 백업이 값 검사에서 asupdate.bat 양식 값과 통합되지 않음 - 잘못된 경로(6596412)

설명

Windows에서 Application Server 9.1 IFR 업그레이드를 수행할 때 인플레이스(In-place) 백업이 asupdate.bat 양식 값에 올바르게 통합되지 않습니다. ASupdate.bat GUI 화면에 잘못된 정보를 입력하고 다음을 누르면 업그레이드 설치 프로그램에서 인플레이스(In-place) 업그레이드인지 여부를 감지하려 합니다. 그렇다면 업그레이드를 수행하기 전에 domain1이 백업 디렉토리로 이동합니다. 업그레이드가 진행되는 동안 잘못된 정보 때문에 오류 메시지가 표시됩니다. 오류를 즉시 수정하려 하면 domain1이 이미 이동했기 때문에 경로 오류가 발생합니다.

해결 방법

{current source path}/backup에서 소스 디렉토리를 domain1_ {timestamp} 디렉토리로 변경하거나 취소 버튼으로 설치 프로그램을 종료한 후 다시 시작합니다.

AS9.1 IFR Windows, 인라인 업그레이드, asupgrade.bat를 짧은 경로와 긴 경로에 사용하면 Domain1이 삭제됨(6596394)

설명

(Windows에만 해당) 프로그램 디렉토리 경로에 특수 문자나 DOS 스타일의 짧은 이름을 사용하여 이전 버전의 Application Server를 설치한 경우 이후의 인플레이스(In-place) 업그레이드에서 같은 디렉토리 경로 이름을 사용하면 Application Server 9.1로의 인플레이스(In-place) 업그레이드가 실패합니다.

예를 들어 다음 중 한 위치에 Application Server 8.2가 설치된 경우:

C:\Program Files (x86)\dirs\appserver
c:\progra~2\dirs\appserver

설치 프로그램에서 짧은 이름이나 특수 문자를 필요한 긴 이름 형식으로 변환할 수 없기 때문에 9.1로의 인플레이스(In-place) 업그레이드 수행이 실패합니다.

해결 방법

특수 문자나 DOS 스타일의 짧은 이름 표시(progra~2 등)가 포함된 경로 이름을 사용하여 Application Server를 설치하면 이후의 업그레이드 설치에 방해가 되기 때문에 좋지 않습니다. 그런 설치가 있는 경우에는 업그레이드를 수행하기 전에 긴 경로 이름을 사용하여 다시 설치하거나 완전히 새로운 디렉토리에 새 버전의 Application Server를 설치합니다.

AS 9.1 IFR: 웹 UI 인증 문제(6569813)

설명

Application Server 업그레이드를 수행한 후 <jsp:forward> 태그가 Authenticate.jsp에서 예상대로 작동하지 않습니다. 서버 로그에서 <jsp:forward> 호출이 오류를 일으켜 WebUI에 빈 페이지가 표시됩니다. 문제는 Authenticate.jsp에 있는 <jsp:forward>에 <jsp:forward page="${redirectPage}"/>와 같은 페이지 속성이 필요하지만 전달되는 값은 Authenticate.jsp가 순수한 JSP 페이지인 경우에도 작동하지 않는 /registry/thin/{pagename}.jsp 등의 상대적 경로라는 것입니다.

해결 방법

Application Server 업그레이드를 수행한 후에 asadmin 도구로 다음 명령을 실행하여 domain.xml에서 <auth-realm>을 설정합니다.

1. <appserver9.1-install-dir>/bin으로 이동하여 다음 명령을 실행합니다.

   ./asadmin delete-auth-realm --host localhost --port 6489 certificate

   그러면 기존 auth-realm 인증서가 있는 경우 제거됩니다.

2. 다음 명령을 실행합니다.

   ./asadmin create-auth-realm --terse=false --echo=true --interactive=true \ --user admin --host localhost --port 6489 --classname \ com.sun.enterprise.security.auth.realm.certificate.CertificateRealm \ --property assign-groups=have.client.cert certificate

   그러면 assign-groups 등록 정보가 있는 새 <auth-realm>이 만들어집니다.

3. Application Server registry 도메인을 중지했다가 다시 시작합니다.

asupgrade GUI의 현지화된 온라인 도움말이 존재하지 않음(6610170)

설명

영어가 아닌 언어로 asupgrade GUI를 실행하는 경우 GUI의 온라인 도움말이 영어 외의 선택된 언어로 현지화되어 있지 않습니다.

해결 방법

지금은 해결 방법이 없습니다. 온라인 도움말은 영어가 아닌 모든 대상 언어로 현지화될 예정입니다.