버전 5.1 웹 서비스 게이트웨이 구성 마이그레이션

WebSphere® Application Server 버전 5.1에서 웹 서비스 게이트웨이는 자체 사용자 인터페이스를 가진 분리 가능한 컴포넌트였습니다. 제품의 이후 버전에서는 게이트웨이가 서비스 통합 버스 지원 웹 서비스에 통합되고 인바운드 및 아웃바운드 서비스 확장과 링크를 위한 메커니즘으로 다시 구현됩니다. wsadmin 명령 스크립트를 사용하여 기존 게이트웨이 구성을 버전 5.1 애플리케이션 서버에서 이후 버전의 애플리케이션 서버 또는 클러스터로 마이그레이션합니다.

시작하기 전에

기존 게이트웨이를 마이그레이션해야 하는지 여부를 고려하십시오.
  • WebSphere Application Server 버전 5.0 은 더 이상 지원되지 않으므로, 제품의 현재 레벨에 있는 애플리케이션 서버에서 실행하려면 버전 5.0 애플리케이션 서버에서 실행 중인 모든 기존 게이트웨이를 마이그레이션해야 합니다.
  • WebSphere Application Server 버전 5.1에서 실행 중인 웹 서비스 게이트웨이는 특정 제한을 따르지만 버전 7.0 이상 애플리케이션 서버에서 실행 중인 게이트웨이 인스턴스와 공존할 수 있습니다. .
  • 버전 7.0 이상 셀은 버전 5.1, 버전 6버전 7.0 이상 애플리케이션 서버를 포함할 수 있습니다. .
자세한 정보는 공존: 버전 5.1 게이트웨이 보존 또는 마이그레이션를 참조하십시오.

게이트웨이를 중지하지 않고 프로덕션 사용 중인 버전 5.1 게이트웨이를 마이그레이션할 수 있습니다. 그런 다음, 요청자 애플리케이션은 기존 버전 5.1 게이트웨이가 계속 실행 중인 동안 새 게이트웨이 구성의 사용으로 전환할 수 있습니다.

이 태스크 정보

마이그레이션 프로세스는 해당 구성을 XML 파일로 내보낸 버전 5.1 게이트웨이 애플리케이션을 취하며 내보낸 XML 파일을 사용하여 이후 버전의 단일 애플리케이션 서버 또는 클러스터에서 동일한 게이트웨이 기능을 구성합니다. 이를 수행하려면 버전 5.1 게이트웨이 구성을 내보낸 후 스크립트를 실행하여 내보낸 구성을 이후 버전의 기존 애플리케이션 서버 또는 클러스터에 있는 새 게이트웨이 인스턴스로 마이그레이션하십시오.

버전 5.1 구성은 다음과 같이 마이그레이션됩니다.
  • 마이그레이션 프로세스의 일부로서 게이트웨이 인스턴스는 자동으로 작성됩니다.
  • 게이트웨이 서비스, 대상 서비스 및 UDDI 참조가 직접 마이그레이션됩니다.
  • JAX-RPC 핸들러 및 핸들러 목록의 게이트웨이 내의 정의도 역시 마이그레이션됩니다. 기본 핸들러 클래스가 런타임에 사용 가능한지 확인해야 합니다.
  • 특정 채널에 대한 게이트웨이 서비스 지정은 특정 인바운드 포트 및 엔드포인트 리스너 쌍에 해당되는 지정으로 바뀝니다. (이후 버전에서 채널 기능이 엔드포인트 리스너와 인바운드 포트 사이에 공유되기 때문입니다.) Apache SOAP 채널의 모든 사용은 HTTP를 통한 SOAP 엔드포인트 리스너 및 인바운드 포트로 마이그레이션됩니다.
  • 기존 필터는 마이그레이션되지 않습니다. 필터 사용은 버전 5.1.1에서 더 이상 사용되지 않으며 버전 7.0에서는 필터 지원이 제거되었습니다. 이전에 필터가 했던 역할을 이제는 JAX-RPC 핸들러와 서비스 통합 버스 중개 조합이 수행합니다.
  • 기본적으로 이후 버전에서는 게이트웨이 서비스가 아닌 대상 서비스에 대해 WSDL에서 생성되는 웹 서비스 클라이언트가 오류로 플래그됩니다.
  • 버전 5.1 게이트웨이 서비스 WSDL을 사용하여 웹 서비스 클라이언트를 생성했고 WSDL 바인딩 및 인코딩 유형이 문서 리터럴이 아닐 경우, 이후 버전으로 마이그레이션한 후 새 게이트웨이 서비스 WSDL을 사용하여 클라이언트 스텁을 재생성해야 합니다.
  • WS-Security 바인딩은 WS-Security 드래프트 13 스펙을 준수하는 바인딩으로서 마이그레이션됩니다. 그러나
    • WebSphere Application Server 버전 6에서 구현된 WS-Security 스펙의 최종 버전(1.0)은 Draft 13 버전과 호환 가능하지 않습니다. 따라서 WS-Security Draft 13의 사용은 WebSphere Application Server 버전 6에서 사용되지 않습니다. WS-Security Draft 13 사용은 더 이상 사용되지 않으며, WS-Security Draft 13 스펙에 기록된 기존 웹 서비스 클라이언트 애플리케이션을 계속 사용하도록 허용하는 데만 사용해야 합니다.
    • WS-Security 바인딩 오브젝트는 대상 서버가 실행 중인 시스템에서(독립형 서버의 경우) 또는 배치 관리자가 Network Deployment 구성에서 실행 중인 시스템에서 마이그레이션 프로세스가 실행되는 경우에만 마이그레이션됩니다.
    • 게이트웨이 서비스 또는 대상 서비스 WS-Security 구성에 의해 사용되는 WS-Security 바인딩 오브젝트만 마이그레이션됩니다. 작성하지만 사용하지 않는 모든 바인딩은 마이그레이션되지 않습니다. 예를 들어 서명 정보 오브젝트를 참조하는 WS-Security 구성이 있으며 서명 정보 오브젝트가 신뢰 앵커를 참조하는 경우, 서명 정보 오브젝트 및 신뢰 앵커 오브젝트는 모두 이를 참조하는 WS-Security 구성을 따라 마이그레이션됩니다.
참고:
  • 마이그레이션은 마이그레이션된 서비스에 대한 외부 웹 주소가 변경되지 않았다고 가정합니다. 이 가정은 게이트웨이가 호스트되는 시스템이 아닌 웹 서버와 이 주소가 연관되므로 이 주소에 대한 호스트 이름 및 포트 번호에는 영향이 없다는 예상을 기반으로 합니다. 구성에서 외부 웹 주소가 게이트웨이 시스템을 지시하는 경우에는 마이그레이션 프로세스가 완료된 이후에 엔드포인트 리스너 구성을 수정하십시오.
  • WebSphere Application Server Network Deployment를 사용하여 구성 프로파일(독립형 서버 또는 배치 관리자)에서 실행 중인 단일 서버로 마이그레이션할 수 있습니다. 그러나 배치 관리자 프로파일 아래에서 실행되는 단일 서버로 마이그레이션하는 것이 좋습니다. 독립형 서버 프로파일로 마이그레이션하는 경우에는 관리 콘솔을 사용하여 후속으로 게이트웨이 구성을 수정할 수 없습니다.
  • 서비스 통합 버스 인에이블된 웹 서비스가 WebSphere Application Server 버전 5.1에서 수행되지 않고 웹 서비스 메시지에 대한 유효성 검증을 수행합니다. 따라서 잘못 형성된 요청 또는 응답(메시지 파트 이름이 잘못 지정된)을 사용하고 버전 5.1를 사용할 때 작동하는 일부 클라이언트 애플리케이션은 현재 잘못 형성된 것으로 식별됩니다. 이 문제점을 해결하기 위해 취해야 하는 단계는 버스 인에이블된 웹 서비스: 알려진 제한사항의 내용을 참조하십시오.

기존 게이트웨이 구성을 버전 5.1 애플리케이션 서버에서 이후 버전의 애플리케이션 서버 또는 클러스터의 게이트웨이 기능으로 마이그레이션하려면 다음 단계를 완료하십시오.

프로시저

  1. 옵션: 버전 5.1 게이트웨이에서 모든 필터를 제거하십시오.
    필터가 있는 게이트웨이를 마이그레이션할 수 있습니다. 하지만 필터가 이후 버전에서 작동하지 않으므로 다음 단계를 완료하여 마이그레이션 전에 구성에서 필터를 제거하는 것이 좋습니다.
    1. 버전 5.1 게이트웨이가 필터를 사용하는지 검사하십시오. 자세한 정보는 WebSphere Application Server 버전 5.1 토픽: 게이트웨이 배치 필터 나열 및 관리를 참조하십시오.
    2. 모든 필터를 제거하십시오. 자세한 정보는 WebSphere Application Server 버전 5.1 토픽: 웹 서비스 게이트웨이에서 필터 제거를 참조하십시오.
    마이그레이션 후, JAX-RPC 핸들러와 서비스 통합 버스 중개의 조합을 사용하여 필터 기능을 재작성할 수 있습니다. 라우팅 필터를 포함하는 웹 서비스 게이트웨이를 마이그레이션하면 필터 기능을 재작성할 수 있습니다.
  2. 이후 버전의 단일 서버 또는 클러스터이며 Network Deployment 셀의 일부인 대상 서버 또는 클러스터를 선택하십시오.
  3. 서비스 통합 버스의 멤버로서 대상 서버 또는 클러스터를 구성하십시오.
  4. 대상 서버 또는 클러스터의 셀 범위에서 서비스 데이터 오브젝트(SDO) 저장소를 구성하십시오.
  5. 임의의 EJB 바인딩을 마이그레이션 중이며 문서 리터럴이 아닌 RPC-인코딩된 바인딩 또는 임의의 바인딩을 계속 사용하도록 하려면 올바른 유형의 바인딩을 EJB 바인딩 WSDL에 추가하십시오. 버전 5.1 게이트웨이 기본 바인딩이 RPC-인코드이므로 이 단계가 필요합니다. 한편 이후 버전에서 기본 바인딩은 문서 리터럴입니다.
  6. 소스(버전 5.1) 애플리케이션 서버가 실행 중인지 확인한 후, 버전 5.1 게이트웨이 사용자 인터페이스를 사용하여 개인용 구성으로 버전 5.1 애플리케이션 서버로부터 게이트웨이 구성을 백업하십시오. 자세한 정보는 the WebSphere Application Server 버전 5.1 주제: 게이트웨이 구성 백업을 참조하십시오.
  7. 옵션: 버전 5.1 애플리케이션 서버를 중지하십시오.
    참고: 프로덕션 사용 중인 게이트웨이를 마이그레이션하는 경우에는 이후 버전의 게이트웨이 구성이 완료될 때까지 버전 5.1 게이트웨이가 계속 실행되도록 한 후에 기존 버전 5.1 게이트웨이가 계속 실행 중인 동안 새 게이트웨이 구성의 사용으로 요청자 애플리케이션을 전환하십시오. 그러나 게이트웨이의 두 버전은 동시에 실행될 필요가 없으며, 이후 버전의 서버 또는 클러스터를 시작하기 전에 버전 5.1 서버를 중지시켜야 합니다(예를 들어 동일한 시스템에서 동일한 포트 번호를 사용하여 버전 5.1 서버에 대한 직접 대체로서 이후 버전의 서버 또는 클러스터를 설치하는 경우).
  8. 대상 셀의 배치 관리자(관리 셀에 있는 단일 서버 또는 클러스터의 경우)와 이후 버전의 대상 애플리케이션 서버 또는 클러스터를 시작하십시오.
  9. 버전 5.1 애플리케이션 서버에 대상 서비스를 정의하는 데 사용된 모든 WSDL 문서가 해당 위치에서 사용 가능한지 확인하십시오. WSDL 위치가 UDDI 참조인 경우 참조된 UDDI 레지스트리가 사용 가능한지 확인하십시오.
  10. 옵션: 마이그레이션되는 게이트웨이가 JAX-RPC 핸들러 및 핸들러 목록를 사용하는 경우에는 기본 핸들러 클래스가 런타임에 사용 가능한지 확인하십시오.
  11. 내보낸 구성을 이후 버전의 애플리케이션 서버 또는 클러스터의 새 게이트웨이로 마이그레이션하려면 다음 단계를 완료하십시오.
    1. 명령 프롬프트를 열고, 그런 다음 app_server_root/util 디렉토리로 변경하십시오.
    2. 다음 명령을 실행하십시오.
      [IBM i]참고: [IBM i]wsadmin 스크립트 클라이언트는 Qshell에서 실행됩니다. . [IBM i]자세한 정보는 wsadmin 스크립트를 사용하여 WebSphere 스크립트를 실행하도록 Qshell 구성의 내용을 참조하십시오..
      migratewsgw[AIX Solaris HP-UX Linux Windows][z/OS].ext -C=cell_name [-S=server_name -N=node_name] 
                          [-X=cluster_name] -B=bus_name 
                           -G=v5_gateway_configuration_file_name 
                          [-H=administration_hostname] [-A=administration_port] 
                          [-U=gateway_instance_name] [-P=object_prefix] 
                          [-username=WAS_user_ID -password=WAS_password]
      여기서
      • [AIX Solaris HP-UX Linux Windows][z/OS].ext는 파일 확장자(.bat(Windows 시스템의 경우) 또는 .sh(Unix 또는 Linux 시스템의 경우))입니다.
      • 대괄호("[ ]")는 일부 경우에 매개변수 또는 매개변수 세트가 선택사항임을 표시합니다.
      • server_namenode_name이 함께(단일 서버의 경우) 또는 cluster_name(클러스터의 경우)이 게이트웨이 구성이 마이그레이션되는 서버 또는 클러스터를 정의합니다.
      • cell_name, server_name and node_name(또는 cluster_name), administration_hostnameadministration_port는 함께 이후 버전의 애플리케이션 서버(또는 클러스터)에 대한 연결을 정의합니다. server_name 또는 cluster_name은 엔드포인트 리스너 및 아웃바운드 포트 대상이 작성되는 대상 애플리케이션 서버 또는 클러스터의 이름입니다. 관리 셀의 일부인 서버 또는 클러스터로 마이그레이션하는 경우, administration_hostnameadministration_port는 배치 관리자의 호스트 이름 및 SOAP 관리 포트 번호를 정의합니다. 관리 셀의 일부가 아닌 서버로 마이그레이션하는 경우, administration_hostnameadministration_port는 독립형 서버의 호스트 이름 및 포트 번호를 정의하며 선택적입니다. 생략되는 경우, 명령은 의도한 값이 localhost:8880이라고 가정합니다(즉, 독립형 서버에 대한 WebSphere Application Server 기본값).
        [IBM i]참고: administration_hostname은 IBM i 플랫폼에 필수입니다.
      • v5_gateway_configuration_file_name은 내보낸 버전 5.1 개인용 게이트웨이 XML 구성 파일에 대한 전체 경로 및 파일 이름입니다.
      • bus_namegateway_instance_name은 함께 이 버스에 작성하려는 게이트웨이 인스턴스를 정의합니다. gateway_instance_name은 이 버스에 둘 이상의 게이트웨이 인스턴스를 작성하려는 경우에만 필수입니다. 이 선택적 매개변수를 생략하면 기본 이름이 지정됩니다.
      • object_prefix는 마이그레이션 프로세스에 의해 정의되는 오브젝트 이름의 접두부를 지정하는 데 사용되는 문자열입니다. 생략되는 경우 마이그레이션된 서비스에 대한 네임스페이스 URI(기본값 urn:ibmwsgw)가 대신 사용됩니다.
      • 대상 애플리케이션 서버 또는 클러스터가 비밀번호로 보호될 경우 WAS_user_IDWAS_password가 필요합니다.
  12. 옵션: 마이그레이션 서비스에 대한 외부 웹 주소가 마이그레이션 프로세스에 의해 변경되는 경우에는 엔드포인트 리스너 구성을 수정하여 이 주소를 업데이트하십시오. 외부 웹 주소가 웹 서버가 아닌 게이트웨이 시스템을 지시하며 게이트웨이를 다른 시스템으로 마이그레이션하거나 동일 시스템의 다른 포트로 마이그레이션한 경우에는 이 작업을 수행해야 합니다.

다음에 수행할 작업

참고:
  • 버전 5.1 게이트웨이가 필터를 사용한 경우, JAX-RPC 핸들러와 서비스 통합 버스 중개의 조합으로 필터 기능을 재작성하십시오.
  • 게이트웨이 구성에 다중 대상 서비스가 있는 게이트웨이 서비스가 포함되어 있으면, 버전 5.1 구성이 라우팅 필터를 사용하여 특정 대상 서비스를 선택했을 수 있습니다. 이 경우, 라우팅 중개를 통해 대상 서비스 및 포트를 선택하도록 마이그레이션된 게이트웨이를 추가로 구성해야 합니다.
  • 이후 버전의 웹 서비스 게이트웨이에서는 메시지를 처리하기 위해 추가 메모리를 사용하므로, 마이그레이션된 게이트웨이를 통해 대형 첨부를 전달하는 경우에는 JVM(Java Virtual Machine)에서 메모리 부족 오류가 발생할 수 있습니다. 이 문제점을 해결하려면 JVM 힙 크기를 늘리십시오.

주제 유형을 표시하는 아이콘 태스크 주제



시간소인 아이콘 마지막 업데이트 날짜: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twsg_coex_migrate
파일 이름:twsg_coex_migrate.html