포털 프로젝트는 WebSphere Portal v5.0.2.2를 지원합니다.
새 포틀렛 마법사를 사용하여 JSR 168 포틀렛을 작성할 때, Rational Developer는 자동으로 ID 속성을 지정합니다. 서버에 대해 포틀렛을 고유하게 식별하려면, portlet.xml 파일의 <portlet-app/> 요소에 ID 속성을 포함해야 합니다. (이 속성은 IBM 포틀렛 API 포틀렛에서 사용되는 UID 속성에 해당합니다.)
portlet.xml의 <portlet-app/> 요소에 ID 속성이 없는 JSR 168 포틀렛을 가지고 있을 경우, 작업공간으로 포틀렛을 가져온 후 즉시 고유한 값을 사용하여 ID 속성을 추가하십시오. ID 속성을 추가하려면 포틀렛 전개 설명자를 열고 소스 보기를 사용하여 편집하십시오. JSR 168 포틀렛을 포털 서버에 전개한 후, 또는 포털 프로젝트에서 JSR 168 포틀렛 프로젝트를 사용한 후에는 ID 값을 변경하지 마십시오.
ID 속성이 없는 JSR 168 포틀렛에는 다음과 같은 제한사항이 있습니다.
- 포털 프로젝트에 ID 속성이 없는 JSR 168 포틀렛을 사용할 경우, 이 포털 프로젝트를 테스트 환경에서 실행할 수 없습니다.
- 두 개 이상의 JSR 168 포틀렛을 ID 속성 없이 WebSphere Portal 5.1 테스트 환경에 연관시킬 경우, 테스트 환경을 시작할 수 없습니다.
- JSR 168 포틀렛을 포털 서버에 전개한 후, 또는 포털 프로젝트에서 JSR 168 포틀렛 프로젝트를 사용한 후에는 프로젝트 이름을 변경할 수 없습니다.
관계형 레코드 목록이나 관계형 레코드(SDO)를 포함하는 포틀렛을 실행할 경우, 서버 로그에서 다음과 같은 오류를 볼 수 있습니다.
[04/10/07 17:57:27:172 JST] 4942fbd0 SystemOut O java.lang.LinkageError: org/eclipse/emf/ecore/EClass 클래스가 로더 제한사항을 위반함: 상위 및 하위 로더 사이의 정의 불일치이 오류는 무시해도 됩니다.
협력 소스 포틀렛을 작성할 때 actionNameParameter와 name 속성을 직접 WSDL 파일에 추가해야 합니다. 예를 들면, 다음과 같습니다.
<portlet:action type="standard" name="myActionName" actionNameParameter="ACTION_NAME"/>이 릴리즈에서는, 포털 도구가 WSDL 파일에 caption 속성을 생성하지 않습니다. WebSphere Portal v5.1을 유선으로 사용할 경우, WSDL 파일에 caption 속성을, 자원 파일에 caption 값을 직접 지정해야 합니다. 예를 들면, 다음과 같습니다.
<portlet:param name="orderId" partname="order_id" caption="order.id" />자세한 정보는 WebSphere Portal Information Center에서 "협력 포틀렛 개발" 주제를 참조하십시오.
WebSphere Portal v5.1의 IBM API 기본 포틀렛에서 person 태그를 사용할 경우, 다음 구문을 사용하여 지정해야 합니다.
<pa:person value="CN=John Smith,OU=SALES,O=ACME" valueType="LDAPDN" displayName="John Smith" />WebSphere Portal v5.1의 IBM API Faces 포틀렛에서 person 태그를 사용할 경우, 다음 구문을 사용하여 지정해야 합니다.
<pa:person value="CN=John Smith,OU=SALES,O=ACME" />John Smith<pa:person>
person 태그는 JSR 168 포틀렛에 대해 지원되지 않습니다.
SAP BAPI 및 RFM SDO 마법사 제한사항: "기본 및 사전/사후 기능 선택" 페이지를 지나 계속 진행하는데 다른 기본 기능을 선택한 후 이 페이지로 돌아가려고 할 경우, 사전/사후 맵핑 페이지가 올바르게 작동하지 않습니다.
솔루션: 새로운 사전 및 사후 기능 맵핑을 설정해야 할 경우, 마법사를 다시 시작해야 합니다.
Portal 서버에서 SAP SDO를 포함하는 포틀렛을 테스트하기 전에 WebSphere Portal 5.1 서버에서 SAP JCo 어댑터를 구성해야 합니다.
- SAP Service Marketplace의 SAP 사이트에서 SAP의 JCo 어댑터 디렉토리를 다운로드하십시오.
- Download Software > Download > SAP Connectors > SAP Java Connector를 누르십시오. 운영 체제에 따라 다운로드할 적절한 파일을 선택하십시오. ZIP 파일의 컨텐츠를 로컬 디렉토리에 푸십시오.
- 운영 체제에 따라 다음 단계를 완료하십시오. 참고: <wps_51>은 WebSphere Portal 5.1 서버의 설치 디렉토리를 가리킵니다(예: C:\WebSphere\PortalServer51TE).
Windows:
- sapjco.jar 및 sapjcorfc.dll을 <wps_51>\shared\app로 복사하십시오.
- librfc32.dll을 C:\windows\system32\로 복사하십시오.
- WebSphere Portal 5.1 서버를 다시 시작하십시오.
Linux:
- sapjco.jar 및 libsapjcorfc.so를 <wps_51>\shared\app로 복사하십시오.
- librfccm.so 파일을 포함하는 폴더를 환경 변수 LD_LIBRARY_PATH에 추가하십시오.
- WebSphere Portal 5.1 서버를 다시 시작하십시오.
새 포털 프로젝트 마법사를 사용하거나 샘플 갤러리에서 샘플 포털 프로젝트를 가져와서 포털 프로젝트를 작성할 경우, 문제점 보기에 끊어진 링크 경고 메시지가 표시됩니다.
이 버전의 Rational Developer에서는 Portal Designer가 지원되는 마크업으로 HTML, cHTML 및 WML만 표시합니다. 가져올 프로젝트에서 페이지나 레이블에 대해 지원되는 다른 마크업을 지정한 경우, 이 마크업은 Rational Developer에서 유지보수되지만 변경할 수 없으므로 특성 보기에 표시되지 않습니다.
이 버전의 Rational Developer에서는 Portal Designer에서 외부 URL만 설정할 수 있습니다. 포털 서버에 내부 URL이 있는 경우, 가져온 프로젝트에서 URL을 유지보수하지만 변경할 수는 없습니다. 내부 URL을 다시 기존의 포털 서버로 전개하는 것만 가능합니다.
Portal Designer의 이 릴리즈에서는, Admin 및 AdminLeftNavigation 주제가 아웃라인 보기에 표시됩니다. 그러나 이 주제는 포털 관리 목적을 위한 것이므로 포털 프로젝트의 기본 주제로 선택하면 안됩니다.
문제점: Rational Developer 설치 프로그램으로 WebSphere Portal 테스트 환경을 설치하면 실패합니다.
솔루션: 설치 로그를 확인하고 문제를 해결하는 데 필요한 적절한 조치를 수행하십시오.
WebSphere Portal 5.0 테스트 환경 RD_installdir\runtimes\portal_v50\log\wpsinstalllog.txt(여기서, RD_installdir은 Rational Developer를 설치한 디렉토리임).
WebSphere Portal 5.1 테스트 환경 WP51TE_installdir\PortalServer\log\wpsinstalllog.txt(여기서, WP51TE_installdir은 WebSphere Portal v5.1 테스트 환경을 설치한 디렉토리임)
로그 파일에서 문제를 식별할 수 없으면 직접 WebSphere Portal 테스트 환경을 설치 제거하십시오. 그런 다음 다시 설치하십시오. 수동 설치 제거에 대한 자세한 정보는 Rational Developer 설치 안내서를 참조하십시오.
문제점: Rational Developer를 사용하여 WebSphere Portal V5.0에 대해 포틀렛을 빌드할 수 있습니다. 포털 서버에 WebSphere Portal 서비스를 적용하는 경우, 포틀렛 빌드 중 컴파일 오류가 발생할 수 있습니다. 이 경우, 컴파일에서 필요한 파일을 직접 갱신해야 합니다.
솔루션: 포틀렛을 올바르게 컴파일하려면 다음 단계를 수행하십시오.
WebSphere Portal v5.0.2.x
참고: WebSphere Portal 테스트 환경을 설치 제거하려면, 먼저 파일을 원래 상태로 복원해야 합니다. 이를 수행하지 않을 경우, "portal_v50_stub" 폴더가 삭제되지 않으므로 직접 삭제해야 합니다.
- WebSphere Portal 5.0.2.x PortalServer\*.* 디렉토리에서 최신 버전을 복사하여 다음 디렉토리의 모든 파일을 갱신하십시오.
- WS_installdir\runtimes\portal_v50_stub\*.*(여기서, WS_installdir은 Rational Developer를 설치한 디렉토리임)
- 포틀렛을 디버그하려면 WebSphere Portal 테스트 환경에도 서비스를 적용해야 합니다. 반드시 WebSphere Portal V5.0.2.x WS_installdir\runtimes\portal_v50 디렉토리에 서비스를 적용하십시오.
WebSphere Portal v5.1
참고: WebSphere Portal 테스트 환경을 설치 제거하려면 먼저 파일을 원래 상태로 복원해야 합니다. 이를 수행하지 않을 경우, "portal_v50_stub" 폴더가 삭제되지 않으므로 직접 삭제해야 합니다.
- 서비스 지시사항에 따라 WebSphere Portal v5.1 테스트 환경에 서비스를 적용하십시오.
- WebSphere Portal 5.1 테스트 환경 PortalServer\*.* 디렉토리에서 최신 버전을 복사하여 다음 디렉토리의 모든 파일을 갱신하십시오.
- RD_installdir\runtimes\portal_v51_stub\*.*(여기서, RD_installdir은 Rational Developer를 설치한 디렉토리임)
포틀렛 전개 설명자 편집기 및 프로젝트 탐색기 보기에는 포틀렛 아이콘 및 해당 이름이 표시됩니다. 이 아이콘은 포틀렛 상태를 나타냅니다. 포틀렛 상태는 정상, 소스 사용 가능, 대상 사용 가능 및 소스와 대상 모두 사용 가능입니다.
문제점: 포틀렛을 Click-to-Action 소스 포틀렛으로 변환한 경우, 변환된 포틀렛 아이콘만 변경되어야 합니다. 그러나 여러 개의 포틀렛이 하나의 Servlet과 연관되어 있는 경우, 둘 이상의 포틀렛 아이콘이 변경됩니다. 이 경우, 원하는 Click-to-Action 포틀렛이 아닌 다른 포틀렛의 아이콘이 잘못 표시됩니다. 포틀렛을 Click-to-Action 대상 포틀렛으로 변환하는 경우에도 동일한 결과가 발생합니다.
솔루션: 둘 이상의 포틀렛 아이콘이 변경되더라도 하나의 포틀렛만 변경됩니다. 변환은 성공하고 포틀렛 프로젝트는 손상되지 않습니다.
문제점: 기존 IBM API 포틀렛 프로젝트에서 새 포틀렛을 작성할 때, 이벤트 처리 페이지에서 Click-to-Action 송신자 포틀렛 샘플 추가 또는 메시지 송신자 포틀렛 샘플 추가 옵션을 선택할 경우 다음 오류 메시지가 표시됩니다.
- IWAL0008E 포틀렛에 대해 올바르지 않은 Servlet 참조. (portlet.xml)
- CHKJ4014W: 유형 Servlet 이름의 빈 항목. (web.xml)
솔루션: 다음 방법으로 포틀렛 프로젝트를 다시 열어야 합니다.
- 포틀렛 프로젝트를 마우스 오른쪽 단추로 누르고 팝업 메뉴에서 프로젝트 닫기를 선택하십시오.
- 포틀렛 프로젝트를 마우스 오른쪽 단추로 누르고 팝업 메뉴에서 프로젝트 열기를 선택하십시오.
- 포틀렛 프로젝트를 마우스 오른쪽 단추로 누르고 팝업 메뉴에서 유효성 검증 실행을 선택하십시오.
문제점: WebSphere Portal 테스트 환경을 시작할 수 없습니다.
솔루션:
- 성공적 설치 확인: 이 문제는 설치 중 장애로 인해 발생했을 수 있습니다. WebSphere Portal 테스트 환경 설치 중의 문제를 확인하고 필요에 따라 해결하도록 하십시오.
- 너무 긴 파일 이름 생략: 포틀렛 프로젝트에 파일 이름이 너무 긴 파일이 있어서 서버를 시작할 수 없습니다. 이 문제를 해결하려면, 프로젝트 이름, 패키지 접두부 및/또는 클래스 접두부를 짧게 줄여서 생성된 파일 이름 길이를 승인 가능하게 하십시오. 또는 개별 파일 이름 자체를 승인 가능한 길이로 줄일 수 있습니다. 또한 기본 디렉토리를 작업공간으로 사용하는 경우, 디렉토리 길이가 더 짧은 다른 작업공간을 사용하는 것도 효과적입니다. Rational Developer를 시작하여 작업영역 디렉토리를 지정하고 제공된 대화 상자에서 이름을 변경할 수 있습니다. 작업공간을 지정하기 위한 대화 상자가 표시되지 않으면, 명령 프롬프트로 이동하여 Rational Developer 실행 명령을 입력한 후 -data [workspace_name]을 입력하십시오.
문제점: WebSphere Portal 테스트 환경 서버에서 관리 포틀렛을 사용하여 포틀렛을 설치하면 실패합니다.
솔루션: WebSphere Portal 테스트 환경 서버에서 관리 포틀렛을 사용하는 포틀렛 설치는 지원되지 않습니다. WebSphere Portal 테스트 환경에서 포틀렛을 전개하려면 Rational Developer의 "공개(Publish)" 기능을 사용해야 합니다. "공개(Publish)" 기능을 사용하려면, 포틀렛 응용프로그램 프로젝트를 마우스 오른쪽 단추로 누르고 실행 > 서버에서 실행을 선택하거나 서버 보기에서 서버를 마우스 오른쪽 단추로 누르고 공개를 선택하십시오.
문제점: 포틀렛 응용프로그램에서 Cloudscape™가 아닌 데이터베이스를 사용할 경우 오류가 발생할 수 있습니다.
솔루션: WebSphere Portal 테스트 환경의 WebSphere 특정 클래스 경로에 JDBC 드라이버를 추가해야 합니다. 다음 단계를 수행하십시오.
- 서버 보기에서 WebSphere Portal 테스트 환경 서버를 두 번 누르십시오. 서버 편집기가 열립니다.
- 편집기의 맨 아래에서 환경 탭을 누르십시오.
- ws.ext.dirs 섹션에 JDBC 드라이버를 추가하십시오. 예를 들면, DB2®의 경우 SQLLIB\java12\db2java.zip 파일을 추가하십시오. 여기서, SQLLIB은 DB2를 설치한 디렉토리입니다.
- Ctrl+S를 눌러 변경사항을 저장하십시오.
문제점: JSR 168 포틀렛 전개 설명자에서는 포틀렛 콜렉션 영역의 포틀렛 이름을 편집할 수 없습니다.
솔루션: 소스 페이지에서 포틀렛 이름을 편집하십시오.
문제점: WebSphere Portal v5.0을 사용 중인 일부 구성에서, 포털 또는 포틀렛 프로젝트에 대해 수행한 변경사항이 Remote Server Attach 서버를 사용하여 프로젝트를 디버깅하거나 실행할 때 자동으로 브라우저에 표시되지 않습니다.
솔루션: 이를 처리하는 방법은 두 가지입니다.
- 브라우저를 사용하여 WebSphere Portal을 명확하게 로그아웃한 후 다시 로그인하십시오. 로그인하면 변경사항이 표시됩니다. 브라우저 창 닫기가 작동되지 않으므로 갱신된 포털 프로젝트를 공개할 때마다 수행해야 합니다.
- 또한 외부 브라우저를 사용하도록 Rational Developer를 구성하십시오. 이를 수행하려면 창 메뉴에서 환경 설정...을 선택하십시오. 왼쪽에서 인터넷 노드를 펼치고 웹 브라우저를 선택하십시오. 기본 섹션에서 내부 웹 브라우저를 제외한 브라우저를 선택하십시오.
그런 다음, 각각의 서버에서 실행 또는 디버그 조작을 수행하기 전에 외부 브라우저를 닫으십시오.
문제점: 마법사에서 생성된 Faces JSP 파일에서 <f:view> 태그를 삭제하고 Faces 구성요소를 파일에 삽입할 경우, <f:subview> 태그가 <f:view> 태그 대신 사용됩니다. 이러한 유형의 JSP 파일에서, Faces 포틀렛이 올바르게 실행되지 않습니다. 브라우저에서 입력한 사항은 서버측 처리 시 유실됩니다.
솔루션: 이 문제를 해결하려면, JSP 파일에서 <f:subview> 태그를 <f:view> 태그로 바꾸십시오.
Click-to-Action 태그를 포함하는 Faces 포틀렛을 최대화할 경우 포틀렛 컨텐츠가 표시되지 않습니다.
문제점: 클래스 경로의 길이가 긴 경우 포틀렛 API 레벨을 변경하려면 실패합니다.
솔루션: 이주된 포틀렛 프로젝트의 Java 빌드 경로를 수정해야 합니다. 필요한 Java 빌드 경로에 대해서는 새 포틀렛 프로젝트 마법사에 의해 생성된 기본 포틀렛 프로젝트를 참조하면 됩니다. 누락된 필수 JAR 파일을 이주된 포틀렛 프로젝트의 Java 빌드 경로에 추가하십시오.
문제점: Portal UTE를 설치하지 않은 경우, "localhost" 또는 "127.0.0.1"을 대상으로 하는 포털 가져오기, 내보내기 및 전개 서버는 작성할 수 없습니다.
솔루션: 이러한 서버를 작성해야 하는 경우, "localhost" 대신 시스템의 완전한 이름을 사용하십시오(예: myhost.mydomain).
문제점: 새 포털 프로젝트의 가져오기를 완료하기 전에 취소할 경우, 완료되지 않은 포털 프로젝트는 제거되지 않아 사용 불가능하게 됩니다.
솔루션: 포털 가져오기 마법사에서 겹쳐쓰기 시 삭제 옵션을 사용하여 포털 구성 및 파일을 다시 가져와야 합니다.
문제점: WebSphere Portal에서 Rational Developer로 기존 포털 사이트를 가져올 때, 가져온 포털 프로젝트에 대한 문제점 보기에 WSRP에 관련된 유효성 검증 오류가 표시됩니다.
솔루션: Rational Developer를 가져오기 전에 APAR PQ95638을 WebSphere Portal에 적용하십시오.
문제점: 올바르지 않은 인코딩으로 인해, Page Designer를 사용하여 가져온 포털 프로젝트에서 license.html 또는 privacy.html 파일을 열 수 없습니다.
솔루션: APAR PQ93681을 Portal 서버에 적용한 후 Portal 서버에서 프로젝트를 다시 가져오십시오.
문제점: 다음을 수행하려고 할 때 WebSphere Portal 5.0 테스트 환경을 시작할 수 없습니다.
- 연관된 포틀렛 프로젝트를 가지고 있지 않은 포털 프로젝트로 테스트 환경을 시작
- 포틀렛 프로젝트를 포털 프로젝트에 추가하고 테스트 환경에서 포털 프로젝트를 다시 실행
솔루션: WebSphere Portal 5.0 테스트 환경을 다시 구성해야 합니다.
이제 테스트 환경에서 포털 프로젝트 및 새로 연관된 포틀렛 프로젝트를 실행할 수 있습니다.
- 서버 보기에서 서버를 마우스 오른쪽 단추로 누르고 "프로젝트 추가 및 제거"를 선택하십시오.
- "구성된 프로젝트"에서 "wps" 프로젝트를 제거하십시오.
- 포털 프로젝트를 마우스 오른쪽 단추로 누르고 실행 > 서버에서 실행을 선택하십시오.
"SDO 런타임 추가"는 Rational Software Architect 뉴스그룹을 참조합니다. Rational Software Architect 지원 사이트( www.ibm.com/software/awdtools/developer/application/support)는 뉴스그룹에 대한 링크를 포함하도록 갱신됩니다.