중요사항: 고가용성
클러스터 서버 환경의 경우, 클러스터 내 모든 노드에서 단계를
수행합니다.
Workplace XT 소프트웨어를 업그레이드하려면 다음을 수행합니다.
- Workplace XT가 설치된 애플리케이션 서버에 로그인합니다.
옵션 |
설명 |
UNIX |
/bin 디렉토리에 대한 쓰기 액세스
권한 및 Workplace XT를 업그레이드할
디렉토리에 대한 읽기, 쓰기 및 실행 액세스 권한이 있는 사용자로 로그인합니다. |
Windows |
로컬 관리자 그룹의 구성원 또는 해당
권한이 있는 사용자로 로그인합니다. |
설치 디렉토리 경로는 이 문서에서
install_path 변수로 참조됩니다.
이 변수의 기본값은 제품 설치 버전과 호스트 운영 체제에 따라
다릅니다.
- 버전 1.1.3.x 및 이전 릴리스
- UNIX: /opt/FileNet/WebClient
- Windows: C:\Program
Files\FileNet\WebClient
- 버전 1.1.4.0 및 이후 릴리스
- UNIX: /opt/IBM/FileNet/WebClient
- Windows: C:\Program
Files\IBM\FileNet\WebClient
팁: UNIX 설치 사용자에게는
/bin 디렉토리에 대한 쓰기 액세스 권한이 필요하지만 Workplace XT 설치 프로그램은
해당 디렉토리에 쓰지 않습니다.
- 프로세스 태스크 관리자에서 컴포넌트 관리자를 중지한 다음(실행
중인 경우) 프로세스 태스크 관리자 애플리케이션을 종료합니다.
- (Windows 전용)
Windows 서비스 콘솔에서
프로세스 WPXT 서비스 관리자 서비스를 중지합니다.
- (Windows 전용)
Windows 태스크 관리자를 사용하여
javaw.exe 프로세스가 실행 중이 아닌지 확인합니다.
이전 단계의 애플리케이션이 올바르게 중지된 경우
Workplace XT 관련 javaw.exe 프로세스가 실행되지
않습니다. 필요하면 Windows 태스크 관리자
또는 기타 프로세스 관리 도구를 사용하여 디렉토리 경로 install_path\_WCjvm\bin에 있는
모든 javaw.exe 프로세스를 중지합니다.
- J2EE 애플리케이션 서버에서 Workplace XT
(web_client) 웹 애플리케이션을 백업, 배치 취소 및 제거합니다.
옵션 |
설명 |
WebSphere® Application
Server |
- 배치된 Workplace XT 디렉토리를 백업합니다.
WAS_HOME/profiles/default/installedApps/node_name/WorkplaceXT.ear/application_name.war
- WebSphere
관리 콘솔에서 Workplace XT
애플리케이션을 중지합니다.
- 엔터프라이즈 애플리케이션에서
Workplace XT 애플리케이션을 설치 제거합니다.
- 변경사항을 저장하고 WebSphere 서버를 중지합니다.
- 임시 Workplace XT
디렉토리(기본값: WorkplaceXT)를 다음 위치에서 삭제합니다.
WAS_HOME/profiles/default/temp/node_name/instance/
- 다음 위치의 wstemp 디렉토리에서 모든 폴더를
삭제합니다.
WAS_HOME/profiles/profile_name/wstemp
|
WebLogic Server |
- WebLogic Server
관리 콘솔에서 Workplace XT
웹 애플리케이션 모듈을 중지합니다.
- 다음과 같이 Workplace XT 폴더 또는 배치된
Workplace XT 디렉토리의 백업 사본을 작성합니다.
- install_path/WorkplaceXT
- install_path/deploy/application_name.war
- install_path/deploy/web-client.ear
- Workplace XT
웹 애플리케이션 모듈을 삭제합니다.
- WebLogic Server를 중지합니다.
- 임시 Workplace XT
디렉토리(기본값: WorkplaceXT 또는 web_client)를 다음 위치에서
삭제합니다.
WL_HOME/domain/servers/instance/
tmp/_WL_usr
|
JBoss Application Server |
- JBoss Application Server 서버를 중지합니다.
- 배치된 Workplace XT 애플리케이션을 배치합니다.
JBOSS_HOME/server/server_name/deploy/application_name.war 또는 .ear
- 배치된 위치에서 Workplace XT
애플리케이션을 삭제합니다.
- 다음 임시 디렉토리에서 모든 파일과 폴더를 지웁니다.
JBoss_home/server/server_name/tmp/deploy
JBoss_home/server/server_name/work/jboss.web/localhost
|
- (IBM CMOD(Content
Manager OnDemand) 사이트 환경 설정이 구성된 시스템의 경우) CMOD 키 저장소를 이동하고
web.xml 파일에서 keyStorePath 컨텍스트 매개변수를 변경합니다.
- CMOD 키 저장소 파일, cmodKeyStore를 복사합니다.
기본 위치는 다음 경로에 있습니다.
install_path/WorkplaceXT/WEB-INF
- cmodKeyStore 파일의 사본을
다음 경로의 Config/WebClient
디렉토리에 배치합니다.
install_home/FileNet/Config/WebClient
install_home 변수의 기본 경로는
업그레이드하는 Workplace XT 버전과
운영 체제에 따라 다릅니다.
- 버전 1.1.3.x 및 이전 릴리스
- UNIX: /opt
- Windows: C:\Program
Files
- 버전 1.1.4.0 및 이후 릴리스
- UNIX: /opt/IBM
- Windows: C:\Program
Files\IBM
- web.xml 파일의
keyStorePath 매개변수 값을
키 저장소 파일의 새 위치와 일치하도록 변경합니다.
<context-param>
<param-name>keyStorePath</param-name>
<param-value>install_home/FileNet/Config/WebClient/cmodKeyStore
</param-value>
</context-param>
- 옵션: 기존 구성 파일을 복사합니다.
배치된 위치에서 구성 파일에 대한 사용자 정의 변경 작업을 수행한
경우에는 기존 Workplace XT
설치를 업그레이드하기 전에 다음을 수행합니다.
다음 파일을
복사합니다.
- WcmApiConfig.properties
- web.xml
이전 단계에서 작성한 백업 Workplace XT
디렉토리의 /WEB-INF 폴더에서 다음 디렉토리에 복사합니다.
install_path/WorkplaceXT/WEB-INF/
- JBoss 4.x.x에서 JBoss 5.x.x로 이동하는 업그레이드
전용: JBoss 4.x.x에서 JBoss 5.x.x로 업그레이드된 시스템에서
Workplace XT가 업그레이드되는
경우, JBoss 5.x.x를 사용하여 Workplace XT를
배치하기 전에 web.xml 파일을 편집하고
파일을 install_path/WorkplaceXT/WEB-INF/에
복사해야 합니다.
- web.xml 파일의 해당 리스너 섹션 끝에 다음 행을 입력합니다.
<listener>
<listener-class>com.sun.faces.config.ConfigureListener</listener-class>
</listener>
- FileNet/WebClient/jboss5 경로에서
jboss-classloading.xml 파일을 복사하고
사본을 install_path/WorkplaceXT/WEB-INF/ 디렉토리에 배치합니다.
- 옵션: IBM Production Imaging Edition Viewer Pro 라이센스 파일을
설치합니다. IBM Production
Imaging Edition을 구입한 경우, Viewer Pro 소프트웨어는
Workplace XT 설치를 실행할 때 설치할 수 있습니다.
- Viewer Pro 설치를 활성화하려면 Workplace XT를
업그레이드하기 전에 먼저 라이센스 설치 프로그램을 실행해야 합니다. 대화식으로 또는 자동으로 업그레이드 여부에 따라
다음 중 한 가지 방법으로 IBM Production Imaging Edition Viewer Pro 라이센스
설치를 시작합니다.
옵션 |
설명 |
IBM Production
Imaging Edition Viewer Pro 라이센스를 대화식으로 설치하려면 다음을 수행하십시오. |
- IBM Production
Imaging Edition Viewer Pro 라이센스 설치 소프트웨어 패키지에 액세스합니다.
- 해당 설정 프로그램(PIEProLic-1.1.5.0-operating_system.bin 또는 .exe)을
실행하고 마법사 화면의 프롬프트를 따릅니다.
|
IBM Production
Imaging Edition Viewer Pro 라이센스를 자동으로 설치하려면 다음을 수행하십시오. |
- IBM Production
Imaging Edition Viewer Pro 라이센스 설치 소프트웨어 패키지에 액세스하여
PIEsilent_input.txt 파일을 로컬 디렉토리에
복사합니다.
- 워크시트의 값을 참조하여 IBM Production Imaging Edition Viewer
Pro 패키지에 액세스하고 설치에 적합한 응답을 반영하여
자동 입력 파일을 편집합니다.
PIEsilent_input.txt 파일의
모든 기본값을 승인하더라도 라이센스 계약에 동의하도록
파일을 편집해야 합니다(-V licenseAccepted="true").
- 명령 프롬프트에서 다음 설치 프로그램으로 이동하여 실행합니다.
- UNIX
- ./PIEProLic-1.1.5.0-operating_system.bin
-options "path_to_edited_input_file/XT_silent_upgrade.txt"
-silent
- Windows
- PIEProLic-1.1.5.0-Win.exe -options "path_to_edited_input_file\XT_silent_upgrade.txt"
-silent
|
install_path/IBM/FileNet/PIEProLicense에 있는
PIEPro_install_log.txt 파일을 확인합니다.
Workplace XT 업그레이드를 진행하기 전에
먼저 로그 파일에 기록된 오류 또는 실패를 정정합니다.
문제점은 행의 맨 앞에 "ERROR" 용어를 사용하여
로그되기도 합니다.
- 대화식으로 또는 자동으로 업그레이드 여부에 따라
다음 중 한 가지 방법으로 업그레이드 프로세스를 시작합니다.
옵션 |
설명 |
Workplace XT를 대화식으로 업그레이드하려면 다음을 수행하십시오. |
- Workplace XT
설치 소프트웨어 패키지에 액세스합니다.
- 해당 설정 프로그램(WorkplaceXT-1.1.5.0-operating_system.bin 또는 .exe)을
실행하고 마법사 화면의 프롬프트를 따릅니다. 설치 프로그램은 이전
Workplace XT 설치의 설정을 발견하고 복사합니다.
|
Workplace XT를 자동으로 업그레이드하려면 다음을 수행하십시오. |
- Workplace XT 설치 소프트웨어
패키지에 액세스하여 XT_silent_upgrade.txt
파일을 로컬 디렉토리에 복사합니다.
- 자동 입력 파일의 지시사항에 따라 설치에
적합한 응답을 반영하여 값을 편집합니다.
XT_silent_upgrade.txt 파일의 모든
기본값을 승인하더라도 파일을 편집하여 라이센스 계약에 동의해야 합니다(-V
licenseAccepted="true").
- 명령 프롬프트에서 다음 설치 프로그램으로 이동하여 실행합니다.
- UNIX
- ./WorkplaceXT-1.1.5.0-operating_system.bin
-options "path_to_edited_input_file/XT_silent_upgrade.txt"
-silent
- Windows
- WorkplaceXT-1.1.5.0-Win.exe -options "path_to_edited_input_file\XT_silent_upgrade.txt"
-silent
|
- 업그레이드 프로그램이 완료되면 install_path/FileNet/WebClient에 있는
web_client_install_log_1.1.5.0.txt 파일을 확인합니다.
오류 또는 실패가 로그되지 않았는지 확인합니다. 계속
진행하기 전에 오류를 정정합니다.
- 옵션: Workplace XT의
사용자 토큰을 지원하도록 파일을 업데이트합니다.
업그레이드 이전에 사용자 토큰이 시스템에서 사용 가능하고
Content Engine 버전 4.5.1, 5.0 또는 5.1을 사용하는 경우,
authentication-websphere.jar 및 log4j-1.2.13.jar 파일은
다시 복사해야 합니다. 사용자 토큰 구성과 이 두 파일이 복사되는 원본 위치에
대해서는 아래에서 해당 섹션을 참조하십시오.
옵션 |
설명 |
WebSphere |
- authentication-websphere.jar 파일을 다음
위치에서
install_path/FileNet/WebClient/WorkplaceXT/authenticationFiles
다음 위치에
복사합니다.
WAS_home/AppServer/lib/ext
- log4j-1.2.13.jar 파일을 다음 위치에서
install_path/FileNet/WebClient/WorkplaceXT/WEB-INF/lib
다음 위치에
복사합니다.
WAS_home/AppServer/lib/ext
|
WebLogic |
- authentication-weblogic.jar 파일을 다음
위치에서
install_path/FileNet/WebClient/WorkplaceXT/authenticationFiles
다음 위치에
복사합니다.
WL_home/server/lib/mbeantypes
- log4j-1.2.13.jar 파일을 다음 위치에서
install_path/FileNet/WebClient/WorkplaceXT/WEB-INF/lib
다음 위치에
복사합니다.
WL_home/server/lib/mbeantypes
|
JBoss |
authentication-utils.jar 파일을 다음
위치에서
install_path/FileNet/WebClient/WorkplaceXT/authenticationFiles
다음 위치에
복사합니다.
JBOSS_home/server/server_name/lib
|
- WebLogic 버전 10.x에서
버전 11g로 이동하는 업그레이드 전용: WebLogic 세션 쿠키 설정을 구성합니다.
- install_path/FileNet/WebClient/WorkplaceXT/WEB-INF 디렉토리로 이동합니다.
- weblogic.xml 파일을 weblogic.xml.bak에 백업합니다.
- weblogic-11g.xml 파일을
WebLogic_install_path/WebClient/weblogicFiles 디렉토리에서
Workplace XT 설치 경로의 WEB-INF 디렉토리에 복사합니다.
- weblogic-11g.xml 파일의 이름을
weblogic.xml로 바꿉니다. WebLogic 11g를 사용하여 Workplace XT를 배치하기 전에
먼저 weblogic-11g.xml 파일을 새 위치에 복사하고 이름을 바꿔야 합니다.