버전 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 게이트웨이가 계속 실행 중인 동안 새 게이트웨이 구성의 사용으로 전환할 수 있습니다.
이 태스크 정보
마이그레이션 프로세스는 해당 구성을 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 애플리케이션 서버에서 이후 버전의 애플리케이션 서버 또는 클러스터의 게이트웨이 기능으로 마이그레이션하려면 다음 단계를 완료하십시오.
프로시저
다음에 수행할 작업
참고:
- 버전 5.1 게이트웨이가 필터를 사용한 경우, JAX-RPC 핸들러와 서비스 통합 버스 중개의 조합으로 필터 기능을 재작성하십시오.
- 게이트웨이 구성에 다중 대상 서비스가 있는 게이트웨이 서비스가 포함되어 있으면, 버전 5.1 구성이 라우팅 필터를 사용하여 특정 대상 서비스를 선택했을 수 있습니다. 이 경우, 라우팅 중개를 통해 대상 서비스 및 포트를 선택하도록 마이그레이션된 게이트웨이를 추가로 구성해야 합니다.
- 이후 버전의 웹 서비스 게이트웨이에서는 메시지를 처리하기 위해 추가 메모리를 사용하므로, 마이그레이션된 게이트웨이를 통해 대형 첨부를 전달하는 경우에는 JVM(Java Virtual Machine)에서 메모리 부족 오류가 발생할 수 있습니다. 이 문제점을 해결하려면 JVM 힙 크기를 늘리십시오.