FileNet Collaboration Services 2.0.3 이후 버전 재구성

IBM® Connections Content Manager에 대한 변경사항을 지원하기 위해 FileNet® Collaboration Services 2.0.3을 재구성하려면 IBM Content Navigator 구성 및 배치 도구를 사용하십시오. 예를 들어, Connections Content Manager에 연결하는 데 사용되는 호스트 또는 포트가 변경된 경우 FileNet Collaboration Services를 다시 구성하십시오. 이 버전의 FNCS는 IBM Content Navigator 2.0.3의 컴포넌트입니다.

시작하기 전에

IBM FileNet Collaboration Services IBM Knowledge Center의 Site preference parameters에 설명되어 있는 바와 같이 <FNCS_Install_Location>\configure\explodedformat\fncs\WEB-INF\classes\fncs-sitePrefs.properties에서 모든 관련 특성 및 해당 값을 설정하십시오. 특히, anonymousAccessEnabled=true 및 enablePropertySheetTemplateMinMax=true를 설정하십시오.

중요사항: fncsServerURL 및 fncsServerURLSecure 특성을 FileNet Collaboration Services를 지정하는 데 사용된 기본 URL로 설정하십시오. 예를 들어, http://example.com 및 https://example.com. icURI 특성을 IBM Connections를 다루기 위해 사용된 기본 URL로 설정하십시오. 예를 들어, http://example.com입니다. 이러한 값은 Tivoli® Access Manager와 같은 보안 프록시를 구성한 경우 변경해야 할 수 있습니다. 보안 프록시는 사용자가 배치에 액세스하기 위해 사용하는 URL 또는 호스트 이름을 변경합니다.

이 태스크 정보

다음 프로시저에서는 Connections Content Manager의 새 FileNet 설치에 포함되어 있는 FileNet Collaboration Services를 재구성하는 방법에 대해 설명합니다.

기존 FileNet 설치의 경우 사용 가능한 구성 옵션의 전체 목록은 FileNet Collaboration Services Information Center를 참조하십시오.

Connections Content Manager 및 새 FileNet 배치를 사용할 때 이들 구성 옵션은 <connections_install_root>\addons\ccm\FNCS\configure\profiles\CCM에서 사용 가능합니다. 예: Linux의 경우 <connections_install_root>/addons/ccm/FNCS/configure/profiles/CCM.

참고: 이 경로는 <connections_install_root>\FNCS...일 수 있습니다.

프로시저

Enterprise Content Manager 클라이언트 구성 및 배치 도구(구성 관리자 UI 또는 CMUI)를 실행하십시오.
- Windows의 경우: connections_root\FNCS\configure\configmgr.exe
- Linux 또는 AIX®의 경우: /opt/IBM/Connections/FNCS/configure/configmgr.bin
  참고: 시스템에서 사용자 인터페이스를 지원하지 않아 configmgr.bin을 실행할 수 없는 경우에는 <FNCS home>/configure/profiles/CCM에서 XML 파일을 수동으로 변경할 수 있습니다. 3단계에서 설명하는 대로 명령을 사용하여 실행할 수 있습니다.
- 배치 옵션 목록에서 기존 배치 프로파일 수정을 선택하십시오.
Content Platform Engine이 설치되어 실행 중인지 확인한 후 다음을 클릭하십시오. Content Platform Engine이 설치되어 실행 중인지 확인하려면 다음 단계를 수행하십시오.
1. 웹 브라우저에서 WebSphere Integrated Solutions Console을 시작하십시오.
2. 애플리케이션 > 애플리케이션 유형 > WebSphere 엔터프라이즈 애플리케이션을 찾아보십시오.
3. FileNetEngine이 엔터프라이즈 애플리케이션 목록에 나열되는지 확인하십시오.
CCM 프로파일을 로드하십시오.
1. 기본 CCM 프로파일을 로드하고 파일 > 배치 프로파일 열기를 찾아보십시오.
2. <FNCS home>\configure\profiles\CCM을 찾아보십시오.
3. CCM.cfgp을 선택하십시오.
여섯 개의 기본 태스크가 있습니다. 원하는 태스크를 다시 구성한 다음 각 태스크를 두 번 클릭하고 값을 입력하고 업데이트를 저장하여 태스크를 다시 실행할 수 있습니다. 다음과 같이 태스크를 다시 구성하십시오.
- 태스크 1: FileNet P8 Client Connectors 파일 업데이트(태스크 이름: downloadcejarstask)
  이 태스크는 FileNet Content Engine 서버에서 Jace.jar 파일을 다운로드합니다. 이 태스크를 실행하려면 WebSphere® Application Server Community Edition 서버가 실행 중이어야 합니다. FileNet Content Engine 서버 호스트 이름 및 HTTP 포트(일반적으로 9080 또는 80)를 입력하십시오. 이러한 값은 서버로부터 클라이언트 라이브러리를 다운로드하기 위해 한 번만 사용됩니다. 클러스터가 있는 경우, 원하면 단일 서버에 대한 호스트 이름을 사용할 수 있습니다.
- 태스크 2: LDAP 서버에 대한 연결 구성(태스크 이름: configureldap)
  이 태스크는 아직 LDAP 기반 보안이 구성되지 않은 새 WebSphere Application Server 서버에 배치 중인 경우에만 필요합니다. 대부분의 CCM 대상 시스템에서는 이 태스크가 이미 수행되었습니다.
- 태스크 3: Content Engine LTPA 키 가져오기(태스크 이름: importltpakey)
  이 태스크는 Connections 및/또는 Content Engine이 별도의 WebSphere Application Server 셀에서 실행 중이며 사용자가 이전에 이러한 서버에서 키를 가져오지 않은 경우에만 필요합니다. 일반적인 CCM 대상 시스템에서는 CE 및 FNCS가 Connections와 함께 단일 셀에서 실행되므로 이 태스크가 필요하지 않습니다.
- 태스크 4: FileNet Collaboration Services 구성(태스크 이름: configurefncstask)
  FNCS가 CE와 동일한 WebSphere Application Server 서버에서 실행되며 로컬 EJB 연결을 사용하려는 경우에는 새 기능인 Content Engine과 함께 배치를 선택하십시오.
  참고: 이 옵션은 대부분의 CCM 배치에 대해 권장됩니다.
  - 이 값에 대해 “True”를 지정한 경우, CE URL을 입력할 필요가 없습니다. 이 필드는 숨겨집니다.
  - FNCS가 CE와 함께 배치되지 않은 경우 여기에 CE EJB URL을 입력하십시오. 일반적인 형식은 http://<hostname>:<ejb port>/FileNet/Engine입니다. 예를 들어, http://ccv01233.usca.example.com:2809/FileNet/Engine입니다.
  HA-클러스터형 URL이 지원됩니다. 예를 들어, 다음과 같습니다.
```
corbaloc::cm-cfgsvr59vm2.usca.example.com:9810,:cm-cfgsvr59vm4.usca.example.com:9810/cell/clusters/cecluster/FileNet/Engine
```
  - 커뮤니티 라이브러리 오브젝트 저장소, 커뮤니티 HTTP URL 및 커뮤니티 HTTPS URL을 입력하십시오.
  - 추가 사용자 정의 특성을 FNCS로 변경하려는 경우 포함된 템플리트 특성 파일 connections_root\IBM\Connections\addons\ccm\FNCS\configure\explodedformat\fncs\WEB-INF\classes\fncs-sitePrefs.properties을 사용하십시오.
  - CCM에 대해 필요한 특성은 anonymousAccessEnabled=true입니다.
  - 라이브러리 위젯에서 IBM Docs를 사용하는 경우에 필요한 특성: enableSharedDrafts=true.
- 태스크 5: 재구성 태스크 1 - 4 중 하나를 수행하는 경우에는 웹 애플리케이션 빌드(태스크 이름: rebuildear)가 필요합니다.
  이 태스크는 이전 태스크에서 사용자가 지정한 옵션을 기반으로 .ear 파일을 생성합니다. 기본 애플리케이션 이름은 네비게이터이며 기본 ear 이름은 navigatorEAR.ear입니다. 일반 CCM 프로파일의 경우, 이 .ear 파일에는 FNCS 애플리케이션만 포함됩니다.
  참고: 컨텍스트 루트를 변경하지 마십시오.
  - connections_root\addons\ccm\FNCS\configure\explodedformat\create_ear.bat와 같은 올바른 빌드 스크립트 경로를 제공하고 connections_root\addons\ccm\FNCS\configure\tmp와 같이 tmp 경로를 수정하십시오.
  - 이 태스크가 완료되면 WebSphere Application Server에 대해 배치할 수 있도록 .ear 파일 준비가 완료된 것입니다. WebSphere Application Server 관리 콘솔을 사용하여 수동으로 배치하거나 CMUI에서 웹 애플리케이션 배치 태스크를 사용할 수 있습니다. navigatorEAR.ear 파일은 connections_root\addons\ccm\FNCS\configure\deploy 디렉토리에 있습니다.
- 태스크 6: 웹 애플리케이션 배치(태스크 이름: deployapplication)
  태스크 5에서 새 .ear 파일을 작성한 경우, 이를 사용하려면 WebSphere Application Server에 다시 배치해야 합니다. 배치 유형, 애플리케이션 서버 노드 및 애플리케이션 서버 이름을 선택한 다음 이를 실행하십시오.
다음과 같이 WebSphere Application Server를 구성하십시오.
1. Content Navigator 태스크 보기에서 CCM을 마우스 오른쪽 단추로 클릭한 후 프로파일 특성 편집을 선택하십시오.
2. WebSphere Application Server 매개변수를 완료하십시오. 다음 매개변수 설정을 참고하십시오.
  - Application Server 버전:은 8.5여야 합니다.
  - 프로파일:은 <WebSphere Application Server pathname>/Dmgr01이어야 합니다.
  - DMGR 관리자 이름, 비밀번호 및 비밀번호의 확인.
  - SOAP 커넥터 포트:는 DMGR 포트여야 합니다.
  - 호스트 이름:은 DMGR 호스트여야 합니다.
  - 배치 세션 제한시간:은 기본값(180)이어야 합니다.
3. 완료를 클릭하십시오. FNCS 구성 관리자 세션을 다시 시작할 때마다 WebSphere Application Server 관리자 비밀번호를 다시 입력해야 할 수 있습니다.
WebSphere Application Server 특성을 완료하고 필요한 태스크를 다시 구성하고 나면 이러한 태스크를 실행할 수 있습니다. 일부 태스크를 구성할 필요가 없으면 마우스 오른쪽 단추로 태스크를 클릭하고 태스크 사용 안함을 선택하십시오.
성공적으로 배치됨 요약이 표시될 때 CMUI를 닫으십시오.
Deployment Manager에 대한 WebSphere Application Server Integrated Solutions Console에 로그인하고 시스템 관리 > 노드를 클릭하십시오.
노드의 선택란을 선택하고 전체 재동기화를 클릭하십시오.
다음과 같이 인증 필터 코드를 설치하십시오. FNCS가 재구성될 때마다 인증 필터를 재설치해야 합니다.
1. WebSphere Application Server 관리 콘솔에서 WebSphere 엔터프라이즈 애플리케이션을 찾아보십시오.
2. FileNet Collaboration Services 옵션을 선택하십시오.
  참고: 2.0.3 릴리스에서는 기본 애플리케이션 이름이 네비게이터입니다.
3. 업데이트를 클릭하십시오.
4. 애플리케이션 업데이트 옵션의 경우 다중 파일 대체, 추가 또는 삭제 옵션을 선택하십시오.
5. 배치 관리자 노드에서 브라우저를 실행 중인 경우에는 로컬 파일 시스템을 선택한 후 auth_filter_patch.zip 파일을 찾으십시오.
  참고: auth_filter_patch.zip 파일은 시스템 구성에 따라서 다음 두 디렉토리 중 하나에 있습니다.
  - connections_root/ccm/ccm/ccm/auth_filter_patch/auth_filter_patch.zip
  - connections_root/xkit/filenetConfig/auth_filter_patch.zip
  참고: 브라우저가 DM(Deployment Manager) 노드에서 실행되지 않는 경우 원격 파일 시스템을 선택하고 DM 파일 시스템을 선택하여 이전에 기술한 디렉토리에서 auth_filter_patch.zip 파일을 찾으십시오.
6. 다음 및 확인을 클릭하여 애플리케이션을 업데이트하십시오.
OAuthClient 보안 역할과 사용자/그룹 간의 맵핑을 재설정하십시오.
참고: FNCS가 재구성될 때마다 OAuthClient 맵핑을 재설정해야 합니다.
1. WebSphere Application Server 관리 콘솔에서 WebSphere 엔터프라이즈 애플리케이션을 찾아보십시오.
2. FileNet Collaboration Services(네비게이터)를 클릭하십시오.
3. 세부사항 특성에서 보안 역할과 사용자/그룹 간의 맵핑을 클릭하십시오.
4. OAuthClient 옵션을 선택하십시오.
5. 특수 제목 맵핑에서 애플리케이션의 영역에서 인증된 모두를 클릭하고 확인을 클릭하여 변경사항을 저장합니다.
6. 저장을 클릭하여 마스터 구성에 직접 저장하십시오.
FNCS에 대한 클래스 로더 정책을 확인하십시오. 다음 단계를 수행하십시오.
1. 네비게이터 애플리케이션을 호스팅하고 있는 WebSphere Application Server의 Integrated Solutions Console을 여십시오.
2. 애플리케이션 > 애플리케이션 유형을 클릭하고 WebSphere 엔터프라이즈 애플리케이션을 선택하십시오.
3. 네비게이터 > 클래스 로드 및 업데이트 감지를 클릭하십시오.
4. 클래스 로더 순서 섹션에서 로컬 클래스 로더를 사용하여 로드된 클래스 먼저(상위 나중)가 선택되어 있는지 확인하십시오.
5. 확인을 클릭하십시오.
6. 네비게이터 > 모듈 관리 > IBM FileNet Collaboration Services를 클릭하십시오.
7. 일반 특성 섹션에서 클래스 로드 순서에서 로컬 클래스 로더를 사용하여 로드된 클래스 먼저(상위 나중)가 선택되어 있는지 확인하십시오.
8. 확인을 클릭하고 변경사항을 저장하십시오.
네비게이터 애플리케이션을 다시 시작하십시오.
FileNet Collaboration Services를 재구성하고 나면 HTTP 서버 맵핑을 업데이트해야 할 수 있습니다. 자세한 정보는 IBM HTTP server에 애플리케이션 맵핑을 참조하십시오.

결과

요약은 서비스가 시작되어 실행 중임을 확인하는 방법에 대한 제안사항을 제공합니다.