iSeries용 IBM WebSphere Development Studio Client 버전 5.0 이주 안내서

사용자 프로젝트를 iSeries용 IBM(R) WebSphere(R) Development Studio Client (TM) 버전 4.0 또는 WebSphere Development Tools V5R1M0으로부터 이주하는 방법에 대해 설명합니다.

시작하기 전에 알아야 할 사항

중요: 현재 iSeries용 WebSphere Development Studio Client 버전 4.0 또는 WebSphere Development Tools V5R1M0이 있고 WebSphere Development Studio Client 버전 5.0을 설치하려는 경우에는 설치 프로세스가 제품의 이전 버전을 설치 제거합니다.

iSeries용 Development Studio Client 버전 4.0을 설치 제거하기 전에 다음을 수행하십시오.

  1. 버전 4.0의 작업공간이 있는 위치를 확인하십시오. 버전 4.0 설치 시 기본 위치를 사용했다면 작업공간은 디렉토리 X:\WDSC\WSSD\workspace에 있고 X는 제품을 설치한 드라이브를 말합니다. 그렇지 않은 경우 다음 중 하나를 실행하십시오.
  2. 버전 4.0의 작업공간을 백업하십시오. 실패하는 경우 버전 4.0 프로젝트를 복구할 수 없습니다.
  3. 이 이주 안내서의 해당 섹션을 읽으십시오. 안내서의 개별 섹션마다 기타 설치 전에 정보가 있습니다.

    안내서는 설치 후에도 사용가능합니다. 예를 들어 X:\WDSC\install\help\migrate.html에서 찾을 수 있습니다.

  4. 버전 5.0으로 이주함으로써 작업공간 또는 프로젝트에 어떤 영향을 주는지에 대한 추가 정보는 기본 WebSphere Studio 제품과 함께 제공된 이주 안내서의 해당 섹션을 참조하십시오. 구입한 Development Studio Client의 버전에 따라 안내서의 위치는 달라질 수 있습니다. 안내서는 예를 들어 C:\Program Files\IBM\WebSphere Studio\migrate.html에서 설치 후에도 사용가능합니다.

프로그램 호출 Bean을 버전 4.0에서 버전 5.0으로 이주

원격 시스템 탐색기 설정 이주

WebFacing 프로젝트 이주

iSeries 웹 프로젝트 이주

iSeries 프로젝트 버전 4.0을 버전 5.0으로 이주

iSeries Java(TM) 및 웹 프로젝트의 프로그램 호출 bean을 버전 4.0에서 5.0으로 이주

이 섹션에서는 iSeries용 Development Studio Client 버전 4.0으로 작성된 프로그램 호출 bean을 버전 5.0으로 이주하는 방법을 설명합니다.

설치 후에

Java 프로젝트의 프로그램 호출 bean의 경우

  1. 버전 5.0 제품을 시작하면(시작 > 프로그램 > iSeries용 IBM WebSphere Studio > Development Studio Client), 세션에 대해 사용하도록 사용자가 지정한 디렉토리에서 WebSphere Studio 창이 열립니다. 이 창에서 버전 4.0 작업공간의 디렉토리 위치를 지정하십시오.
  2. 새 사용자 인터페이스 형식으로 변환할지 여부를 확인하는 프롬트가 표시되면 확인을 클릭하십시오.
  3. 프로젝트의 Java 빌드 경로를 변경하여 기존의 클래스 경로를 제거하십시오.
    1. Java 프로젝트를 마우스 오른쪽 단추로 클릭한 다음 특성을 선택하십시오.
    2. 왼쪽 분할창에서 Java 빌드 경로를 선택하십시오.
    3. 라이브러리 탭을 선택한 다음 아래의 JAR 파일을 선택하고 제거를 클릭하여 파일을 클래스 경로에서 제거하십시오. 
         ECLIPSE_HOME/plugins/com.ibm.etools.iseries.toolbox/runtime/jt400.jar
   ECLIPSE_HOME/plugins/com.ibm.etools.iseries.webtools/lib/wdt400rt.jar
   ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/j2ee.jar
   ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/xerces.jar
  4. 모든 PCML 파일에 대해서 프로그램 호출 마법사를 재실행하십시오.

웹 프로젝트의 프로그램 호출 bean의 경우

  1. 버전 5.0 제품을 시작하면(시작 > 프로그램 > iSeries용 IBM WebSphere Studio > Development Studio Client), 세션에 대해 사용하도록 사용자가 지정한 디렉토리에서 WebSphere Studio 창이 열립니다. 이 창에서 버전 4.0 작업공간의 디렉토리 위치를 지정하십시오.
  2. 새 사용자 인터페이스 형식으로 변환할지 여부를 확인하는 프롬트가 표시되면 확인을 클릭하십시오.
  3. J2EE 이주 마법사를 사용하여 다음을 수행할 수 있습니다.
  4. 웹 Perspective의 프로젝트 이름을 마우스 오른쪽 단추로 클릭하고 이주 > iSeries 웹 도구 프로젝트 4.0에서 5.0으로를 선택하십시오.
  5. 중요: 이 때 프로젝트를 닫고 다시 열어서 자원 삭제와 관련된 예외를 피하십시오.
  6. 이주 확인 창에 이주될 프로젝트 구조 및 컨텐츠가 표시됩니다. 프로세스를 계속하려면 확인을 클릭하십시오.
  7. 이주하게 되면 WEB-INF\lib 폴더에서 wdt400rt.jar 및 wdt400tb.jar이 제거되고 버전 5.0 iwdtrt.jar 및 jt400.jar 파일이 폴더로 복사됩니다.
  8. 모든 PCML 파일에 대해서 프로그램 호출 마법사를 재실행하십시오.

원격 시스템 탐색기 설정 이주

설치 후에
  1. 버전 5.0 제품을 시작하면(시작 > 프로그램 > iSeries용 IBM WebSphere Studio > Development Studio Client), 세션에 대해 사용하도록 사용자가 지정한 디렉토리에서 WebSphere Studio 창이 열립니다. 이 창에서 버전 4.0 작업공간의 디렉토리 위치를 지정하십시오.
  2. 새 사용자 인터페이스 형식으로 변환할지 여부를 확인하는 프롬트가 표시되면 확인을 클릭하십시오.
  3. 기본 메뉴에서 창 > 환경 설정을 클릭하십시오.
  4. 왼쪽 분할창에서 LPEX 편집기를 펴고 구문 분석기를 선택하십시오.
  5. 오른쪽 분할창에서 ILErpg를 선택하십시오. 맨 아래 있는 클래스 이름 필드에서클래스 이름을 com.ibm.etools.iseries.editor.ISeriesEditorRPGILEParser로 변경하십시오. 설정을 클릭하십시오.
  6. 오른쪽 분할창에서 rpg를 선택하십시오. 맨 아래 있는 클래스 이름 필드에서 클래스 이름을 com.ibm.etools.iseries.editor.ISeriesEditorRPGOPMParser로 변경하십시오. 설정을 클릭하십시오.
  7. 적용을 클릭하십시오. 확인을 클릭하십시오.

WebFacing 프로젝트 이주

WebSphere Development Studio Client 버전 4.0 또는 WebSphere Development Tools 버전 5.1의 WebFacing 프로젝트가 있는 경우 가져오기 마법사를 사용하여 버전 5.0으로 이주할 수 있습니다. 다음 단계를 수행하십시오.

설치 후에

  1. 파일 > 가져오기를 선택하십시오.
  2. WebFacing 프로젝트를 선택하십시오. 다음을 클릭하십시오.
  3. 버전 5.0으로 이주할 WebFacing 프로젝트가 있는 폴더에서 찾아보기를 하십시오. 다음을 클릭하십시오.
    주:
    • 버전 4.0에서 업그레이드하는 경우, WebFacing 프로젝트는 원래 버전 4.0의 작업공간 디렉토리에서 여전히 사용 가능합니다. 작업공간의 기본 위치를 변경하지 않는한 그리고 버전 4.0을 설치할 때 선택한 디렉토리 경로에 따라, X:\WDSC\WSSD\workspace와 같은 위치에서 작업공간 디렉토리를 찾을 수 있습니다.
    • WebSphere Development Tools 버전 5.1에서 업그레이드할 경우, 버전 5.1 설치 시 선택한 디렉토리 경로에 따라 X:\WDT\WebFacing\eclipse와 같은 위치에서 WebFacing 프로젝트를 찾을 수 있습니다.
  4. 마법사가 찾은 WebFacing 프로젝트는 발견된 WebFacing 프로젝트 분할창에 나열됩니다. 가져오기할 프로젝트를 선택하십시오. 마법사가 프로젝트에 해당하는 EAR 파일을 작성합니다. EAR 파일은 J2EE 엔터프라이즈 어플리케이션 아카이브 파일입니다. 기본값으로, EAR 파일은 WebFacing 프로젝트의 이름을 사용하고 _EAR을 이름에 추가합니다. 다른 이름을 사용하거나 여러 프로젝트를 하나의 EAR 파일로 통합하려면 엔터프라이즈 어플리케이션 프로젝트 필드에서 이름을 변경할 수 있습니다.
  5. 완료를 클릭하십시오. 프로젝트가 버전 5 작업공간으로 이주됩니다.
  6. WebFacing Perspective에서 프로젝트를 참조하려면 창 > Perspective 열기 > WebFacing을 선택하십시오.
주:
  • WebFacing 프로젝트가 버전 4.0 IDE를 사용하여 이미 변환된 경우 이주가 완료된 후에 프로젝트를 다시 변환할 필요가 없습니다.
  • 원본 프로젝트가 WebSphere Development Tools 버전 5.1로부터 이주된 경우 프로젝트를 재변환해야 합니다.

iSeries 웹 프로젝트 이주

버전 4.0 iSeries 웹 프로젝트를 버전 5.0으로 이주

이 섹션에서는 iSeries용 Development Studio Client 버전 4.0으로 작성된 iSeries 웹 프로젝트를 버전 5.0으로 이주하는 방법을 설명합니다.

이주는 다음의 단계로 진행됩니다.

  1. 기존의 V4.0.x 작업공간을 사용하여 프로젝트 이주
  2. 웹 프로젝트 구조를 J2EE 1.3 프로젝트 구조로 이주

    주: 웹 프로젝트를 J2EE 1.3으로 이주하는 것은 선택사항입니다. 그러나 J2EE 1.2는 JCA(Java Connector Achitecture)를 지원하지 않습니다.

  3. iSeries 웹 도구 프로젝트 컨텐츠 이주
  4. 이주의 결과로 생성된 오류 및 경고 지정

단계 1: 기존의 V4.0.x 작업공간을 사용하여 프로젝트 이주

이 접근 방식은 부분적으로만 지원되므로 이주가 불완전하게 수행됩니다. 사용자 인터페이스 설정, 디버그 설정 및 대부분의 환경 설정을 모두 상실합니다. 프로젝트 이름, 프로젝트 소스 파일 및 프로젝트 Java 빌드 경로(클래스 경로)는 남지만 그 이상은 보장할 수 없습니다. 이 접근 방식은 어떤 지원 SCM(Software Configuration Management) 시스템도 사용하고 있지 않고 프로젝트 빌드 경로 정보를 보유해야 하는 경우에만 사용하십시오. 이 정보는 버전 4.0에서 프로젝트를 가져오기할 때 상실됩니다. 다음을 수행하여 기존의 버전 4.0.x 작업공간을 사용할 수 있습니다.

설치 전에

  1. 지연 중인 변경 사항을 저장소에 커미트(보류 해제)하십시오.
  2. 모든 Perspective를 닫고 버전 4.0 제품을 종료하십시오.
  3. workspace_directory의 컨텐츠를 백업하십시오. 여기서 workspace_directory는 버전 4.0.x 작업공간을 포함하는 완전한 디렉토리 이름입니다. 기본값으로, 버전 4.0.x 작업공간 서브디렉토리는 제품이 설치된 디렉토리와 같은 디렉토리에 있습니다. 버전 4.0.x 제품을 다시 사용하려면 백업을 해야 합니다. 일단 버전 5.0 IDE에서 버전 4.0.x 작업공간을 지정하면, 버전 4.0.x 제품의 작업공간을 다시 사용할 수 없습니다.
  4. iSeries용 Development Studio Client 버전 5.0을 설치하십시오.
설치 후에
  1. 버전 5.0 제품을 시작하면(시작 > 프로그램 > iSeries용 IBM WebSphere Studio > Development Studio Client), 세션에 대해 사용하도록 사용자가 지정한 디렉토리에서 WebSphere Studio 창이 열립니다. 이 창에서 버전 4.0.x 작업공간의 디렉토리 위치를 지정하십시오.
  2. 새 사용자 인터페이스 형식으로 변환할지 여부를 확인하는 프롬트가 표시되면 확인을 클릭하십시오.
  3. 작업공간에 있는 프로젝트를 재빌드하거나 확인하기 전에 자원 Perspective에서 탐색 보기에 있는 모든 프로젝트를 선택한 다음 팝업 메뉴에서 새로 고치기를 선택하십시오. 이것은 모든 화일이 올바른 메타데이터와 동기화되도록 합니다.
  4. 닫힌 프로젝트를 여십시오(아래의 알려진 문제점 참조).
  5. 클래스 경로 변수를 검증하십시오(아래의 알려진 문제점 참조).
  6. 일부 빌더 및 검증자가 이 버전에서 추가, 제거 또는 수정되었습니다. 올바른 오류와 경고가 표시되도록 하려면 프로젝트 > 모두 재빌드를 선택하여 모든 프로젝트를 재빌드한 다음 각 Java 프로젝트에 대해 유효성 확인 실행을 선택해야 합니다.
  7. 일부 사용자 환경 설정은 유지보수될 수 있지만 대부분은 유지보수되지 않습니다. 버전 5.0에 있는 환경 설정을 검사하여 설정이 올바른지 확인하십시오.

이주 후의 EAR 제거 및 서버 구성 절대 경로 참조

버전 4.0 EAR application.xml 파일 및 서버 구성 파일에는 절대 경로 참조가 있습니다. 파일을 버전 5.0으로 이주한 후에는 편집기(기존의 절대 경로 참조를 새 상대 참조로 자동 변경하는)를 사용하여 파일을 열어야 합니다.

  1. 각 EAR 프로젝트의 경우, 탐색 보기에서 마우스 오른쪽 단추를 눌러 META-INF/application.xml > 열기 > 전개 설명자 편집기를 클릭하십시오.
    1. 메시지 창이 열립니다. "어플리케이션을 저장한 이후에 하나 이상의 모듈의 절대 경로가 변경되었습니다. . . 자동 수정하시겠습니까?"
    2. 예를 클릭하십시오.
    3. 편집기 창을 저장한 다음 닫으십시오.
  2. 각 서버 구성의 경우, 서버 Perspective, 서버 구성 보기에서 마우스 오른쪽 단추를 눌러 서버 > 열기를 클릭하십시오.
    1. 비슷한 자동 수정 창이 열립니다.
    2. 예를 클릭하십시오.
    3. 편집기 창을 저장한 다음 닫으십시오.

알려진 문제점 및 제한사항

버전 5.0 제품에서 버전 4.0의 작업공간을 열어 이주하려고 할 경우 다음의 문제점이 발생할 수 있습니다.

JRE_LIB 클래스 경로 변수에 올바르지 않은 값

JRE_LIB 클래스 경로 변수에 올바른 위치를 재설정하려면 다음 단계를 수행하십시오. 환경 설정 창을 처음 열었을 때 올바른 값으로 보여도 다음을 수행하십시오.

  1. 창 > 환경 설정 > Java > 설치된 JRE를 선택하십시오.
  2. 목록에서 JRE_LIB이 있는 JRE 위치가 기본값이 되도록 선택란을 선택하십시오.
  3. 편집을 선택한 다음 확인을 클릭하여 JRE 편집 대화 상자를 닫으십시오.

이를 수행하지 않으면, JRE_LIB에 해당하는 값이 올바르지 않을 수 있고 Java 파일에 많은 빌드 오류가 발생합니다.

일반적인 검사로서 기타 모든 클래스 경로 변수의 값을 확인하십시오.

이전의 SCM 공유 프로젝트에 대해, 팀 메뉴에 공유 프로젝트가 포함되어 있습니다.

Eclipse 1.0에 비해 2.0의 팀 지원이 크게 변경되었습니다. 프로젝트와 저장소의 공유 방법 또한 변경되었습니다.

  • 팀 > 프로젝트 공유 옵션을 선택하면 마법사가 이주 프로세스를 마칠 때까지 안내합니다. 완료되면 프로젝트가 공유되고 동기화 보기가 열립니다. 모든 파일에서 변경 충돌을 볼 수 있습니다. 이것은 Eclipse 1.0과 2.0에 동기화 정보가 저장된 방식이 변경되었기 때문입니다.
  • 전송되는 변경사항이 없는 경우(위에서 권장한 바와 같이 업그레이드 전에 전송되는 모든 변경사항을 커미트할 경우에는 없어야 하는)에는 단순히 동기화 보기에서 프로젝트를 선택하고 서버로부터 현재의 컨텐츠를 로드하는 대체 및 갱신을 선택할 수 있습니다.
  • 전송되는 변경사항이 있는 경우 동기화 보기에서 세모 표시 메뉴를 풀다운하여 파일 컨텐츠 비교를 선택할 수 있습니다. 일부 작업 후에 실제로 다른 파일만이 동기화 보기에 표시됩니다. 그런 다음 동기화 보기를 사용하여 충돌을 해결합니다.

작업공간 디렉토리 외부에서 작성된 프로젝트

기본적으로 프로젝트는 작업공간 디렉토리에서 작성됩니다. 기본값을 대체하여 프로젝트가 다른 곳에서 작성되도록 했다면 Workbench를 닫기 전에 모든 프로젝트를 여십시오. 그러면 프로젝트에 해당하는 .project 파일이 올바른 위치에 작성될 수 있습니다. 작업공간 외부 디렉토리가 프로젝트 디렉토리인 닫힌 프로젝트 열기에 실패하면 프로젝트 내에 있는 기존의 .project 파일만으로 프로젝트가 실제 프로젝트를 마스크합니다.

단계 2: 웹 프로젝트 구조를 J2EE 1.3 프로젝트 구조로 이주

주: J2EE 이주 마법사는 두 가지 기능을 수행할 수 있습니다.

  • 웹 프로젝트 구조 또는 J2EE 프로젝트 구조 버전 4.0에서 버전 5.0으로 이주
  • J2EE 레벨 1.2에서 레벨 1.3으로 이주(선택적)

J2EE 프로젝트 구조를 이주하려면 다음을 수행하십시오.

  1. 아직 열지 않았으면 시작 > 프로그램 메뉴에서 제품을 선택하여 버전 5.0 IDE를 여십시오.
  2. IDE에서 창 > Perspective 열기 > 웹을 선택하여 웹 Perspective를 여십시오.
  3. 웹 Perspective의 J2EE 탐색 보기에 있는 프로젝트 이름을 마우스 오른쪽 단추로 클릭하고 이주 > J2EE 이주 마법사를 선택하십시오.
  4. 마법사 페이지에 있는 지침을 따르십시오. JCA(Java Connector Architecture) 지원을 사용하려면 프로젝트 버전 레벨 J2EE 1.2를 J2EE 1.3으로 이주 선택란을 선택했는지 확인하십시오.
  5. 완료를 클릭하여 선택된 웹 프로젝트를 이주하십시오.

단계 3: iSeries 웹 도구 프로젝트 컨텐츠 이주

다음의 이주 프로세스는 앞서 설명된 바와 같이 웹 프로젝트를 J2EE 프로젝트 구조로 이주를 완료했는지에 따라 달라집니다.

iSeries 웹 도구 프로젝트 컨텐츠를 이주하려면 다음을 수행하십시오.

  1. 웹 Perspective의 프로젝트 이름을 마우스 오른쪽 단추로 클릭하고 이주 > iSeries 웹 도구 프로젝트 4.0에서 5.0으로를 선택하십시오.
  2. 중요: 이 때 프로젝트를 닫고 다시 열어서 자원 삭제와 관련된 예외를 피하십시오.
  3. 이주 확인 창에 이주될 프로젝트 구조 및 컨텐츠가 표시됩니다. 프로세스를 계속하려면 확인을 클릭하십시오.
  4. 진행 정보 창이 열리고 이주가 수행 중에 있으며 진행 정도를 표시합니다.
  5. 이주 프로세스가 완료되면 경고, 오류 또는 성공 메시지 창에 이주 결과가 표시됩니다.
  6. 이주 프로세스가 완료되면 더 이상의 조치는 필요없습니다. 이주 프로세스가 오류 또는 경고와 함께 완료된 경우 아래의 이주 결과로 생성된 오류 및 경고 지정을 따라 수행하십시오.

이주 프로세스는 다음의 조치를 수행합니다.

  • JSP 파일의 모든 설계시 제어를 새 웹 구성요소 필드 및 제어로 변환하십시오.
  • Apache Struts 1.02 런타임 파일을 추가하고 .wit 파일에서 struts 구조를 기초로 한 웹 상호작용 관련 파일을 재생성합니다.

단계 4: 이주의 결과로 생성된 오류 및 경고 지정

이주 프로세스 도중 문제가 발생하면 창이 열리고 오류 또는 경고가 발생했음을 나타내며 오류 또는 경고는 웹 Perspective의 프로젝트 이름 아래 projectName_MigrationDetails.txt 이주 로그 파일에 기록됩니다.

이주 로그 파일의 맨 위에 있는 이주 결과 섹션에는 이주의 전체 상태가 표시되고 오류와 경고를 설명하는 온라인 정보 파일과 오류와 경고를 정정하는 데 필요한 조치가 표시됩니다.

또한 온라인 도움말의 "이주 오류 및 경고 세부사항"을 참조하십시오.

       iSeries용 Development Studio Client > 웹 어플리케이션 >
      iSeries 웹 개발 > 참조 > 이주 오류 및 경고 세부사항

이전 버전 4.0의 iSeries 웹 프로젝트 이주

iSeries용 WebSphere Development Tools 버전 3.5와 함께 사용된 WebSphere Studio 제품을 이주하는 방법에 대해 설명합니다. 이 WebSphere Studio 제품을 WebSphere Studio의 현재 버전과 구별하기 위해 WebSphere Studio classic으로 합니다. 이 정보는 WebSphere Studio classic의 Advanced 및 Professional Editon 모두에 해당됩니다.

주: WebSphere Studio classic 버전 4.0을 이주하는데 필요한 지침은 다음과 같습니다. WebSphere Studio classic의 이전 버전으로부터 이주하려는 경우 계속하기 전에 먼저 WebSphere Studio classic 버전 4.0으로 이주해야 합니다.

WebSphere Studio classic을 이주하려면 다음 단계를 수행하십시오.

  1. 이주에 대한 새 단일 서버 스테이지 작성
  2. 웹 구성 설명자 파일 작성
  3. 이주 JAR 파일 내보내기
  4. 이주 JAR 파일을 웹 프로젝트로 가져오기
  5. iSeries 웹 프로젝트 이주 완료
  6. 서버 설정 및 이주된 어플리케이션 테스트

WebSphere Studio classic 데이터를 이주하기 전에 다음의 제한사항을 숙지해야 합니다.

  • WebSphere Studio 현재 버전의 통합 개발 환경에는 XML 기반 SQL 편집기가 사용되므로 .sql 파일은 사용할 수 없습니다.
  • 정보 공개 프로젝트와 단계 정보는 이주될 수 없습니다.
  • WebSphere Studio classic의 서버 구성 정보는 이주될 수 없습니다.
  • 버전 제어 정보는 이주될 수 없습니다.

아래 설명되어 있는 이주 프로세스 동안 단일 서버에 대한 공개 가능한 소스인 사용자의 모든 프로젝트 파일을 포함하는 JAR 파일을 작성합니다. 기본 서버의 공개 보기에서 볼 수 있는 모든 파일은 JAR 파일로 패키지됩니다. 그런 다음 JAR 파일을 iSeries용 WebSphere Development Studio Client 버전 5.0의 웹 프로젝트로 가져옵니다.

기존의 프로젝트를 이주하는 경우 모든 프로젝트 공개 및 단계 정보는 이주하는 동안 상실됩니다. 해당 단계에 여러 서버가 있는 경우 기본 서버에 공개된 파일만이 보유됩니다. 따라서, 이주의 목적으로 하나의 서버만을 사용하는 단계를 새로 작성하게 됩니다.

이주 단계

단계 1 - 이주에 대한 새 단일 서버 스테이지 작성

현재 스테이지에 하나 이상의 서버가 있는 경우 다음 단계를 따라 하나의 서버만을 사용하는 새 이주 스테이지를 작성하십시오.

  1. 이주하려고 하는 프로젝트를 열고 프로젝트 > 공개 스테이지 사용자 정의 메뉴를 클릭하십시오.
  2. 스테이지 이름 필드에 Migration을 입력하십시오.
  3. 추가를 클릭하십시오.
  4. 확인을 클릭하십시오.
  5. 프로젝트 > 공개 스테이지 메뉴를 클릭하고 사용가능한 스테이지 목록에서 Migration을 선택하십시오.
  6. 공개 보기에서 Migration을 클릭한 다음 삽입 > 서버 메뉴를 클릭하십시오.
  7. 서버 이름을 입력하고(예: localhost) 확인을 클릭하십시오.
  8. 선택사항: 정의된 servlet 맵핑 정보가 있으면 이 타스크를 완료하고 그렇지 않은 경우 아래의 단계 2를 진행하십시오. 서버 변경 또는 공개 스테이지 변경은 WebSphere Application Server 버전 4.0용 servlet 맵핑 정보를 전달하지 않습니다. 공개 보기로 이동하여 각 servlet에 대해 마우스 오른쪽 단추를 클릭하고 특성을 선택하십시오. 특성 창의 공개 탭에서 servlet 맵핑 필드에 실제 servlet 맵핑을 입력하고 확인을 클릭하십시오. servlet 멥핑은 어플리케이션 서버의 등록된 servlet에 대한 URL 패턴입니다.

단계 2 - 웹 구성 설명자 파일 작성

  1. 공개 보기에서 프로젝트 > 웹 구성 설명자 파일 작성을 클릭하십시오.
  2. 필수 servlet을 모두 선택하십시오.
  3. 필수 TLD(태그 라이브러리 설명자) 파일을 모두 선택하십시오.
  4. 작성을 클릭하십시오.

웹 구성 설명자 파일명은 serverName_web.xml 양식에 있습니다. localhost 서버용 웹 구성 설명자 파일명은 localhost_web.xml입니다. 다른 위치를 지정하지 않으면 .xml 파일이 WEB-INF 디렉토리에 저장됩니다.

단계 3 - 이주 JAR 파일 내보내기

  1. 공개 보기에 있는 동안 localhost 서버를 마우스 오른쪽 단추로 클릭한 다음 특성 > 공개 메뉴를 클릭하십시오.
  2. Webapp 웹 경로 필드에 웹 경로(문맥 루트)를 입력하십시오. 이 항목은 프로젝트가 iSeries용 Development Studio Client 버전 5.0에서 작성될 때 웹 프로젝트 이름으로 사용됩니다. 예를 들어 myproj를 입력하면, 버전 5.0에서 웹 프로젝트 이름으로 사용됩니다.
  3. 확인을 클릭하십시오.
  4. 공개 보기에서 프로젝트 > 이주 파일 작성을 클릭하십시오.
  5. localhost가 선택된 서버임을 검증하십시오.
  6. localhost_web.xml이 선택된 웹 구성 설명자 파일임을 검증하십시오.
  7. 확인을 클릭하십시오.
  8. JAR 파일명은 serverName.jar 양식에 있습니다. localhost 서버용 JAR 파일 이름은 localhost.jar입니다. 필요하면 파일명을 재지정할 수 있습니다.
  9. 저장 필드에 JAR 파일의 위치를 지정하고 저장을 클릭하여 JAR 파일을 작성하십시오.

단계 4 - 이주 JAR 파일을 웹 프로젝트로 가져오기

  1. iSeries용 WebSphere Development Studio Client 버전 5.0을 시작하십시오.
  2. 창 > Perspective 열기 > 기타 메뉴를 클릭하고 웹을 선택한 다음 확인을 클릭하여 웹 Perspective를 여십시오.
  3. JAR 파일을 가져오십시오.
    1. 파일 > 가져오기를 클릭하십시오.
    2. 가져오기 창에서 WAR 파일을 클릭하고 다음을 클릭하십시오.
  4. WAR 파일에서 자원 가져오기 창에서,
    1. WAR 파일 필드에 전체 경로와 JAR 파일명을 입력하십시오. 예를 들어 JAR 파일명이 localhost.jar이고 d:\myjar에 있는 경우 WAR 파일 필드에 d:\myjar\localhost.jar를 입력하십시오.
      주: 반드시 WAR 파일 옵션을 사용하여 JAR 파일을 가져와야 합니다. 그렇지 않으면 올바른 작업이 이뤄지지 않습니다.
    2. 웹 프로젝트용 신규 라디오 단추를 선택하십시오.
    3. 새 프로젝트 이름 필드에, 웹 프로젝트 이름과 같이 위의 단계 3에서 정의된 Webapp 웹 경로 이름을 입력하십시오. 이 이름은 자동으로 문맥 루트 필드에 추가됩니다. 추가되지 않으면 문맥 루트 필드에 프로젝트 이름을 입력하십시오.
    4. 엔터프라이즈 어플리케이션 프로젝트를 위해 신규 라디오 단추를 선택하고 EAR 파일명을 입력하십시오. EAR 파일에는 DefaultEAR의 기본값 이름이 있습니다. 새 프로젝트에 맞게 식별하기 쉬운 이름으로 변경할 수 있습니다. 예를 들어 새 프로젝트 이름이 myproj인 경우 EAR 파일을 myprojEAR로 지정할 수 있습니다.
    5. 완료를 클릭하여 JAR 파일의 압축을 풀고 웹 프로젝트를 생성하십시오.
  5. 웹 프로젝트의 초기화를 완료하려면 iSeries 웹 도구 런타임 구성 마법사를 실행하십시오.
    1. J2EE 탐색 보기의 웹 프로젝트 이름을 마우스 오른쪽 단추로 클릭한 다음 iSeries 웹 도구 런타임 구성 지정을 선택하십시오.
    2. 필드를 공백으로 하고 마법사 페이지에서 완료를 클릭하십시오. 이 조치로 인해 iSeries 웹 도구에 필요한 JAR 파일이 웹 프로젝트의 Web-INF > lib에 복사됩니다.
  6. 해결되지 않은 참조나 분실된 가져오기 파일이 있을 수 있습니다. 이것은 타스크 보기에 나타납니다. 해결하려면 웹 프로젝트의 Java 빌드 경로를 수정해야 합니다.
    1. 프로젝트 이름을 마우스 오른쪽 단추로 클릭한 다음 특성을 클릭하여 특성 창을 여십시오.
    2. Java 빌드 경로를 클릭하고 라이브러리 탭을 클릭하십시오.
    3. 외부 JAR 추가를 클릭하십시오.
    4. 다음의 디렉토리로부터 필요한 Jar를 가져오십시오.
      x:\WS*D\runtimes\base_v5\lib,
      x:\WS*D\runtimes\aes_v4\lib 및
      x:\WS*D\wstools\eclipse\plugins\com.ibm.etools.websphere.tools\runtime
      x:\WS*D는 기존 제품의 설치 디렉토리입니다.
  7. J2EE 탐색 보기에서 프로젝트를 마우스 오른쪽 단추로 클릭하고 프로젝트 재빌드를 선택하십시오.

단계 5 - iSeries 웹 프로젝트 이주 완료

iSeries 웹 프로젝트 버전 4.0 이주의 단계 2, 3 및 4에 설명된 타스크를 수행하여 프로젝트 이주를 완료하십시오.

  1. 선택사항: WebSphere Application Server 버전 4.x에서 웹 어플리케이션을 실행하는 경우 단계 2의 타스크는 필요하지 않습니다. 그러나 WebSphere Application Server 버전 5.0에서 웹 어플리케이션을 실행하는 경우 단계 2에서 타스크를 완료하여 웹 프로젝트 J2EE 1.2를 J2EE 1.3으로 이주할 필요가 있습니다.
  2. 단계 3에서는 웹 프로젝트 컨텐츠를 이주하는 방법에 대해 설명합니다.
  3. 단계 4에서는 웹 프로젝트 컨텐츠가 이주될 때 생성되는 오류 및 경고 지정에 관한 정보가 제공됩니다.

이 타스크가 완료되면 아래의 단계 6으로 이동하십시오.

단계 6 - 테스트 서버에서 이주된 어플리케이션 테스트

이제 어플리케이션을 테스트해도 좋습니다. 기본값 테스트 서버에서 테스트하려면 다음 단계를 수행하십시오.

  1. 웹 어플리케이션의 초기 페이지에서 마우스 오른쪽 단추를 클릭하십시오.
  2. 서버에서 실행을 선택하십시오.

기타 서버 런타임 환경에서 어플리케이션을 테스트하려면 서버 도구 구성요소에 대한 온라인 도움말을 참조하십시오.

iSeries 프로젝트 버전 4.0을 버전 5.0으로 이주

iSeries용 Development Studio Client 버전 4.0이 아직 설치되어 있는 경우 다음을 수행하십시오.

Development Studio Client 버전 4.0을 설치 제거하기 전에 프로젝트 컨텐츠를 호스트 시스템으로 내보내야 합니다. 그런 다음 Development Studio Client 버전 5.0을 설치하십시오. 설치 후 원격 시스템 탐색기에서 조치를 실행함으로써 프로젝트가 재작성됩니다.

설치 전에
  1. 버전 4.0에서 iSeries 프로젝트를 마우스 오른쪽 단추로 클릭한 다음 변경사항 푸시를 선택하십시오. 이 프로젝트에 연관된 라이브러리의 코드 변경이 모두 업로드됩니다. (이 프로젝트가 대상으로 하는 호스트와 라이브러리를 알려면 프로젝트를 마우스 오른쪽 단추로 클릭하고 특성 > iSeries 프로젝트를 선택하십시오.)
  2. 버전 4.0을 닫고 설치 제거하십시오.
  3. 계속해서 iSeries용 Development Studio Client 버전 5.0을 설치하십시오.
설치 후에
  1. 버전 5.0에서 원격 시스템 탐색기 Perspective를 여십시오. 창 > Perspective 열기 > 원격 시스템 탐색기를 클릭하십시오.
  2. iSeries 프로젝트 연관 라이브러리를 탐색하십시오. 이 라이브러리에는 iSeries 프로젝트로부터 업로드한 모든 소스가 포함되어 있습니다.
  3. iSeries 프로젝트의 부분이었던 이 라이브러리의 소스 실제 파일을 선택하고 마우스 오른쪽 단추를 클릭한 다음 오프라인 사용가능화를 선택하십시오. iSeries 프로젝트가 재작성되며 작성된 프로젝트는 라이브러리에 맵핑되고 모든 소스 멤버를 프로젝트에 다운로드합니다. 이제 개발할 수 있습니다.

    주: 원격 시스템 탐색기의 라이브러리에서 iSeries 프로젝트 작성을 선택하는 것도 프로젝트를 빠른 시간에 재작성할 수 있는 방법 중에 하나입니다. 그러나 이 방법은 라이브러리로부터 어떤 소스 멤버도 다운로드하지 않습니다. 라이브러리와 호스트에 맵핑되는 iSeries 프로젝트를 작성하고 설정할 뿐입니다.

iSeries용 Development Studio Client 버전 5.0을 이미 설치한 경우 프로젝트를 원격 호스트로 업로드하지 않았음을 알 수 있습니다.

설치 후에
  1. 버전 5.0을 실행하십시오.
  2. 기본 메뉴에서 창 > Perspective 열기 > 자원을 클릭하십시오. 확인을 클릭하십시오.
  3. 간단한 프로젝트를 작성하려면 파일 > 신규 > 기타 > 단순 > 프로젝트를 클릭하고 프로젝트 이름을 Temp로 하십시오. 이 프로젝트는 버전 4.0 프로젝트를 버전 5.0 작업공간으로 가져오는 컨테이너 역할을 합니다.
  4. 파일 > 가져오기 > 파일 시스템을 선택하십시오. 다음을 클릭하십시오.
  5. 기존 작업공간을 탐색하고(예를 들어, X:\WDSC\WSSD\workspace 여기서 X는 버전 4.0을 설치한 드라이브입니다) 재작성하려는 프로젝트를 가져오기하십시오.
  6. 지금 가져오기한 버전 4.0 프로젝트의 라이브러리와 호스트에 맵핑되는 iSeries 프로젝트를 작성하십시오.
    • 탐색 보기의 어느 곳에서든 마우스 오른쪽 단추를 클릭한 다음 신규 > 프로젝트 > iSeries > 로컬 > iSeries 프로젝트를 선택하십시오.
    • 라이브러리와 호스트를 기억하지 못하는 경우 Temp 프로젝트 아래의 .iseries_project_properties라는 XML 파일에서 찾을 수 있습니다.
  7. 버전 4.0 프로젝트에 있는 소스 실제 파일을 재작성하십시오.
    • 파일 > 신규 > 기타 > iSeries > 로컬 > iSeries 소스 실제 파일을 클릭하십시오.
    • CCSID와 해당 파일의 레코드 길이를 모르면 각 소스 실제 파일 바로 아래 .iseries_srcpf_properties라는 XML 파일에서 찾을 수 있습니다.
  8. 이제 소스 멤버를 기존 버전 4.0 프로젝트에서 새 버전 5.0 프로젝트로 끌어서 놓으십시오.
  9. 더이상 필요하지 않은 Temp 프로젝트를 삭제하고 iSeries 프로젝트 Perspective를 여십시오. 창 > Perspective 열기 > iSeries 프로젝트를 클릭하십시오.

상표 및 서비스표

다음 용어는 미국 또는 기타 국가에서 사용되는 IBM Corporation의 상표 또는 등록상표입니다.

Java 및 모든 Java 기반 상표와 로고는 미국 및 기타 국가에서 사용되는 Sun Microsystems, Inc.의 상표 또는 등록상표입니다.

기타 회사, 제품 및 서비스 이름은 해당 회사의 상표 및 서비스표입니다.