test

Oracle OpenSSO 업데이트 2 릴리스 노트

2장 OpenSSO 8.0 업데이트 2 설치

이 장은 다음 내용으로 구성되어 있습니다.

OpenSSO 8.0 업데이트 2 설치 개요

OpenSSO 8.0 업데이트 2는 패치 TBS로 사용할 수 있습니다.

OpenSSO 8.0 업데이트 2(또는 후속 패치)를 설치하기 전에 본 문서에서 새로운 기능, 하드웨어 및 소프트웨어 요구 사항과 문제 및 문제 해결에 대한 정보를 확인하십시오.

OpenSSO 8.0 업데이트 2에는 다음 방법을 사용하여 설치할 수 있는 opensso.war 파일이 포함되어 있습니다.

주 –

Access Manager 7.1 또는 Access Manager 7 2005Q4를 실행 중이며 업데이트 2로 업그레이드하려는 경우 다음 단계를 따릅니다.

  1. Sun OpenSSO Enterprise 8.0 Upgrade Guide에 설명된 대로 Access Manager 7.x를 OpenSSO 8.0으로 업그레이드합니다.

  2. 이 장에 설명된 대로 업그레이드 2 패치를 적용합니다.

OpenSSO 8.0 업데이트 2 패치

Sun은 OpenSSO 8.0 업데이트 2용 패치를 주기적으로 출시합니다. 이러한 패치에 대한 자세한 내용은 여기에서 주기적으로 확인하십시오.

패치 작업 계획

ProcedureOpenSSO 8.0의 패치 작업을 계획하는 방법

  1. ssopatch 유틸리티 개요를 읽습니다.

  2. ssopatch 유틸리티 설치에 설명된 대로 해당 플랫폼에서 사용할 패치 유틸리티를 설치합니다.

  3. 기존 WAR 파일에 대한 정보를 가져와서 기존 WAR 파일이 OpenSSO WAR 파일과 내부 매니페스트 비교에 설명된 대로 사용자 정의되거나 수정되었는지 확인합니다.

  4. 두 OpenSSO WAR 파일 비교에 설명된 대로 기존 WAR 파일과 업데이트 2 WAR 파일을 비교하여 원본 WAR 파일에서 사용자 정의한 파일, 새 WAR 파일에서 업데이트된 파일 및 두 WAR 버전 간에 추가되거나 삭제된 파일을 반환합니다.

  5. OpenSSO WAR 파일 백업에 설명된 대로 기존 Opensso WAR 파일을 백업 및 아카이브합니다.

  6. OpenSSO WAR 파일 패치에 설명된 대로 OpenSSO WAR 파일을 패치합니다.

  7. updateschema 스크립트 실행에 설명된 대로 updateschema 스크립트를 실행합니다.

    참고 - OpenSSO 서버 전용, 관리 콘솔 전용, Distributed Authentication UI 서버 또는 IDP 검색 서비스 WAR과 같이 opensso.war에서 생성한 특수 WAR 파일을 패치하는 경우 특수 OpenSSO WAR 패치를 참조하십시오.

ssopatch 유틸리티 개요

ssopatch 유틸리티는 Solaris 및 Linux 시스템에서 ssopatch로, Windows에서는 ssopatch.bat로 사용할 수 있는 Java 명령줄 유틸리티입니다.

참고 - OpenSSO 8.0 업데이트 2의 ssopatch에 대한 구문은 OpenSSO 8.0 릴리스 이후 크게 변경되었습니다. 새 구문에 대한 내용은 updateschema 스크립트 실행을 참조하십시오.

ssopatch 패치 유틸리티는 다음 기능을 수행합니다.

OpenSSO 8.0 업데이트 2 ZIP 파일(opensso_80U2.zip)을 다운로드 및 압축 해제한 후, zip-root/opensso/tools 디렉토리의 ssoPatchTools.zip 파일에서 패치 유틸리티 및 관련 파일을 사용할 수 있습니다. zip-root는 opensso_80U2.zip을 압축 해제한 위치입니다.

ssopatch 유틸리티는 매니페스트 파일을 사용하여 특정 OpenSSO WAR 파일의 내용을 확인합니다. 매니페스트 파일은 다음을 포함하는 ASCII 텍스트 파일입니다.

일반적으로 매니페스트 파일은 OpenSSO.manifest로 이름이 지정되고 OpenSSO WAR 파일의 META-INF 디렉토리에 저장됩니다.

ssopatch 유틸리티는 표준 출력(stdout)으로 결과를 보냅니다. 원하는 경우 파일로 출력을 리디렉션하여 ssopatch 출력을 캡처할 수 있습니다. ssopatch가 성공적으로 완료되면 영(0) 종료 코드를 반환합니다. 오류가 발생하는 경우 ssopatch는 영이 아닌 종료 코드를 반환합니다.

ssopatch 유틸리티 설치

ssopatch 유틸리티를 설치하기 전에 다음을 수행합니다.

ssopatch 유틸리티를 설치하는 방법

  1. zip-root/opensso/tools 디렉토리에서 ssoPatchTools.zip 파일을 찾습니다. zip-root는 opensso_80U2.zip을 압축 해제한 위치입니다.

  2. ssoPatchTools.zip 파일을 압축 해제할 새 디렉토리를 만듭니다. 예: ssopatchtools

  3. 새 디렉토리에서 ssoPatchTools.zip 파일을 압축 해제합니다.

  4. 전체 경로를 제공하지 않고 현재 디렉토리가 아닌 다른 디렉토리에서 ssopatch 유틸리티를 실행하려면 PATH 변수에 유틸리티를 추가합니다.

다음 표는 ssoPatchTools.zip에 들어 있는 파일에 대해 설명합니다.

파일 또는 디렉토리 

설명 

README

ssopatch를 설명하는 Readme 파일

/lib

필수 ssopatch JAR 파일

/patch

updateschema 및 updateschema.bat 스크립트 및 관련 XML 파일

/resources

필수 등록 정보 파일 

ssopatch 및 ssopatch.bat

Solaris, Linux 및 Windows 시스템용 유틸리티 

OpenSSO WAR 파일 백업

시작하기 전에 기존 OpenSSO WAR 파일 및 구성 데이터를 백업합니다.

ssopatch 유틸리티 실행

ssopatch 유틸리티를 실행하려면 다음 사용법을 따릅니다.


ssopatch
--help|-?
[--locale|-l]

ssopatch
--war-file|-o
[--manifest|-m]
[--locale|-l]

ssopatch
--war-file|-o
--war-file-compare|-c
[--staging|-s]
[--locale|-l]
[--override|-r]
[--overwrite|-w]

옵션은 다음과 같습니다.

OpenSSO WAR 파일과 내부 매니페스트 비교

이 절차를 사용하여 다운로드한 이후 OpenSSO WAR 파일이 사용자 정의 또는 수정되었는지 확인합니다.

ssopatch 유틸리티는 새로운 내부 매니페스트 파일을 생성한 다음 이 내부 매니페스트를 META-INF 디렉토리의 원본 OpenSSO WAR 파일 내에 저장된 매니페스트와 비교합니다.

OpenSSO WAR 파일과 내부 매니페스트를 비교하는 방법

  1. ssopatch를 실행하여 OpenSSO WAR 파일과 내부 매니페스트를 비교합니다. 예: 


    ./ssopatch -o /zip-root/opensso/deployable-war/opensso.war
Generating Manifest for: /zip-root/opensso/deployable-war/opensso.war
Comparing manifest of Internal (Enterprise 8.0 Build 6(200810311055))
against /zip-root/opensso/deployable-war/opensso.war (generated-200905050855)
File not in original war (images/login-origimage.jpg)
File updated in new war (images/login-backimage.jpg)
File updated in new war (WEB-INF/classes/amConfigurator.properties)
Differences: 3

이 예는 원본 WAR 파일에 대한 변경 사항을 보여줍니다.

두 OpenSSO WAR 파일 비교

이 절차를 통해 두 WAR 파일을 비교하여 다음과 같은 상태의 파일을 보여줍니다.

두 OpenSSO WAR 파일을 비교하는 방법

  1. ssopatch를 실행하여 두 WAR 파일을 비교합니다. 예에서는 -override 옵션을 사용하여 두 WAR 파일 간의 개정 확인을 무시합니다. 


    ./ssopatch -o /zip-root/opensso/deployable-war/opensso.war
-c /u1/opensso/deployable-war/opensso.war --override
Generating Manifest for: /zip-root/opensso/deployable-war/opensso.war
Original manifest: Enterprise 8.0 Build 6(200810311055)
New manifest: Enterprise 8.0 Update 2 Build 6.1(200904300525)
Versions are compatible
Generating Manifest for: /u1/opensso/deployable-war/opensso.war
Comparing manifest of /zip-root/opensso/deployable-war/opensso.war
(generated-200905050919) against
    /u1/opensso/deployable-war/opensso.war (generated-200905050920)
File updated in new war(WEB-INF/classes/amClientDetection_en.properties)
File updated in new war(WEB-INF/classes/fmSAMLConfiguration_fr.properties)
...
Differences: 1821
Customizations: 3

이 예는 새 WAR 파일에서 업데이트 및 사용자 정의된 파일을 표시합니다.

OpenSSO WAR 파일 패치

이 절차를 사용하여 원본 WAR 파일이 새 WAR 파일과 병합되는 새 스테이징 영역을 만듭니다.

이 작업은 각 WAR 파일에 대한 매니페스트를 비교한 후 다음을 보여줍니다.

그런 다음 ssopatch는 해당 파일을 스테이징 디렉토리(새로 패치된 WAR을 만들고 배포하기 전에 사용자 정의를 추가해야 하는 위치)로 복사합니다.

OpenSSO WAR 파일을 패치할 스테이징 영역을 만드는 방법

  1. ssopatch가 원본 opensso.war 파일을 수정하지 않더라도 패치된 opensso.war 파일을 되돌려야 하는 경우에 대비하여 이 파일을 백업하는 것이 좋습니다.

  2. ssopatch를 실행하여 스테이징 영역을 만듭니다. 예: 


    ./ssopatch -o /zip-root/opensso/deployable-war/opensso.war
  -c /u1/opensso/deployable-war/opensso.war --override -s /tmp/staging
Generating Manifest for: /zip-root/opensso/deployable-war/opensso.war
Original manifest: Enterprise 8.0 Build 6(200810311055)
New manifest: Enterprise 8.0 Update 2 Build 6.1(200904300525)
Versions are compatible
Generating Manifest for: /u1/opensso/deployable-war/opensso.war
Comparing manifest of /zip-root/opensso/deployable-war/opensso.war
    (generated-200905051031) against /u1/opensso/deployable-war/opensso.war
    (generated-200905051032)
File was customized in original, but not found in new war.
Staging area using original war version (samples/saml2/sae/header.jsp)
File was customized in original, but not found in new war.
Staging area using original war version
    (WEB-INF/template/opends/config/upgrade/config.ldif.4517)
File was customized in original, but not found in new war.
Staging area using original war version
    (WEB-INF/template/opends/config/upgrade/schema.ldif.4517)
Differences: 1813
Customizations: 0

이 예에서 /tmp/staging은 ssopatch가 파일을 복사하는 스테이징 영역입니다.

이전 단계의 결과를 사용하여 필요에 따라 스테이징 영역에서 파일을 업데이트합니다.

다음 표를 사용하여 새로 패치된 WAR 파일을 생성하기 전에 수행해야 할 작업을 확인합니다.

ssopatch 결과

설명 및 필요한 작업 

파일이 원본 war filename에 없습니다.

표시된 파일이 원본 WAR 파일에는 없지만 WAR 파일의 최신 버전에는 있습니다. 

작업: 없음

파일이 새 war filename에서 업데이트되었습니다.

표시된 파일이 원본과 새 WAR 파일 모두에 존재하고 WAR 파일의 최신 버전에서 업데이트되었습니다. 원본 WAR 파일에서 사용자 정의가 수행되지 않았습니다. 

작업: 없음

파일이 filename을 사용자 정의했습니다.

표시된 파일이 두 WAR 파일 모두에 있고 WAR 파일의 원본 버전에서 사용자 정의되었지만 WAR 파일의 최신 버전에서 업데이트되지는 않았습니다. 

작업: 없음

filename을 직접 사용자 정의해야 할 수도 있습니다.

파일이 두 WAR 파일 모두에 있고 WAR 파일의 원본 버전에서 사용자 정의되었으며 WAR 파일의 최신 버전에서 업데이트되었습니다. 

작업: 파일에서 사용자 정의를 수행하려면 스테이징 디렉토리에서 새로 업데이트된 파일에 이를 직접 추가해야 합니다.

원본 버전에서 파일이 사용자 정의되었지만 새 war에 없습니다.

파일이 원본 WAR 파일에는 있었지만 새 WAR에는 없습니다. 

작업: 없음

다음 단계

  1. 스테이징 영역의 파일에서 새 OpenSSO WAR 파일을 만듭니다. 예: 


    cd /tmp/staging
jar cvf /patched/opensso.war *

    /patched/opensso.war은 새로 패치된 OpenSSO WAR 파일입니다.

  2. 원본 배포 URI를 사용하여 /patched/opensso.war 파일을 웹 컨테이너에 재배포합니다. 예: /opensso

OpenSSO 구성 변경 사항. 새 OpenSSO WAR 파일에 원본 WAR 파일에 없는 구성 변경 사항이 있을 수도 있습니다. 각 패치에 대한 구성 변경 사항이 있는 경우 개별적으로 기록됩니다. 구성 변경 사항에 대한 자세한 내용은 패치 설명서와 Sun OpenSSO Enterprise 8.0 릴리스 노트를 확인하십시오. 새 WAR 파일의 구성이 변경되지 않았더라도 OpenSSO 매니페스트 파일의 버전 문자열은 변경됩니다.

패치된 버전을 되돌려야 하는 경우 패치된 WAR 파일을 배포 해제한 다음 원본 WAR 파일을 재배포합니다.

OpenSSO WAR 매니페스트 파일 만들기

OpenSSO 매니페스트 파일은 특정 릴리스에 대한 WAR 파일의 모든 개별 파일을 각 파일에 대한 체크섬 정보로 식별하는 텍스트 파일입니다.

이 절차를 통해 OpenSSO 서버 전용, 관리 콘솔 전용, Distributed Authentication UI 서버 또는 IDP 검색 서비스 WAR과 같은 특수 OpenSSO WAR에 포함될 수 있는 매니페스트 파일을 만듭니다.

OpenSSO WAR 매니페스트 파일을 만드는 방법

  1. ssopatch를 실행하여 OpenSSO 매니페스트 파일을 만듭니다. 예: 


    ./ssopatch -o zip-root/opensso/deployable-war/opensso.war --manifest /tmp/manifest

    opensso.war은 기존 OpenSSO WAR 파일입니다.

    ssopatch 유틸리티는 /tmp 디렉토리에 manifest라는 새 매니페스트 파일을 만듭니다.

  2. WAR 파일이 패치되도록 하려면 이 새 매니페스트 파일을 opensso.war 파일 내의 META-INF 디렉토리로 복사합니다. 예: 


    mkdir META-INF
cp /tmp/manifest META-INF
jar uf opensso.war META-INF/manifest

특수 OpenSSO WAR 패치

OpenSSO 서버 전용, 관리 콘솔 전용, Distributed Authentication UI 서버 또는 IDP 검색 서비스 WAR과 같은 특수 OpenSSO WAR을 이전에 만든 경우 ssopatch 유틸리티를 사용하여 이를 패치할 수 있습니다.

특수 OpenSSO WAR을 패치하는 방법

  1. OpenSSO WAR 매니페스트 파일 만들기에 설명된 대로 특수 OpenSSO WAR에 대한 매니페스트 파일을 만듭니다.

    참고: 모든 사용자 정의가 수행되기 전에 Sun에서 제공된 대로 원본 OpenSSO 8.0 opensso.war을 기반으로 한 매니페스트 파일을 만듭니다. 매니페스트가 사용자 정의 후에 만들어진 경우 ssopatch는 사용자 정의가 아닌 업데이트 2의 파일을 사용할 수 있으므로 패치 후 사용자 정의를 다시 실행해야 합니다.

  2. Sun OpenSSO Enterprise 8.0 Update 1 Release Notes의 4 장, Creating a Specialized OpenSSO Enterprise 8.0 Update 1 WAR File에 설명된 대로 OpenSSO 8.0 업데이트 2 opensso.war 파일에서 특수 OpenSSO WAR을 생성합니다.

  3. ssopatch 유틸리티를 사용하여 이전 WAR 파일과 새 WAR 파일을 비교합니다.

  4. OpenSSO WAR 파일을 패치할 스테이징 영역을 만드는 방법에 설명된 대로 새 특수 WAR 파일에 대한 스테이징 영역을 생성합니다.

  5. 새 특수 WAR 파일을 재배포합니다.

updateschema 스크립트 실행

ssopatch를 실행한 후, Solaris 또는 Linux 시스템에서는 updateschema.sh 또는 Windows에서는 updateschema.bat를 실행합니다. 스크립트는 OpenSSO 서버 버전을 업데이트하고 새 기본 서버 등록 정보를 추가하며 업데이트 2의 버그 수정 및 개선 사항에 필요한 새 속성 스키마를 추가합니다. 서버 버전을 업데이트하기 위해 updateschema를 실행해야 합니다.

시작하기 전에

updateschema 스크립트를 실행하는 방법

  1. patch-tools/patch 디렉토리로 변경합니다. patch-tools는 ssoPatchTools.zip을 압축 해제한 위치입니다.

  2. updateschema.sh 또는 updateschema.bat를 실행합니다. 예를 들어 Solaris 시스템의 경우 다음을 수행합니다.

    ./updateschema.sh

  3. 스크립트가 메시지를 표시하면 다음 정보를 입력합니다.

    • ssoadm 유틸리티의 전체 경로(ssoadm 자체는 제외) 예: /opt/ssotools/opensso/bin

    • amadmin 비밀번호

    updateschema.sh 또는 updateschema.bat 스크립트가 메시지 또는 오류를 표준 출력으로 작성합니다.

  4. OpenSSO 8.0 업데이트 2 웹 컨테이너를 다시 시작합니다.

패치 설치 되돌리기

패치 설치를 되돌려야 할 경우 원본 opensso.war 파일(또는 특수 WAR 파일)을 재배포하면 됩니다.