Windchill Business Reporting 사후 설치 지침
다음 경우에는 수동 사후 설치 단계가 필요합니다.
• Windchill Business Reporting을 포함하도록 기존 Windchill 설치를 업데이트하는 경우. 자세한 내용은 "기존 설치 업데이트" 단원을 참조하십시오.
• 다른 PTC HTTP Server를 사용하여 Windchill Business Reporting 및 Windchill을 설치하는 경우. 자세한 내용은 "별도의 PTC HTTP Server에 대한 역방향 프록시 구성" 단원을 참조하십시오.
다음 단원에서는 Windchill Business Reporting이 제대로 설치되었는지 확인하기 위해 실행할 수 있는 확인 사항과 사이트에 해당하는 경우에 선택할 수 있는 선택적 수동 사후 설치 단계에 대해 설명합니다.
확인 작업에는 다음이 포함됩니다.
• Windchill Business Reporting에 로그인
• 기본 보고서 존재 여부 확인
• Cognos 구성 도구 액세스
선택적 단계에는 다음이 포함됩니다.
• Windchill Business Reporting 액세스 제어 구성
• HTTPS를 사용하여 Windchill Business Reporting 구성
• 인증을 위해 기업 LDAP 추가
• 모델 업데이트 및 보고서 로드
확인
Windchill Business Reporting에 로그인
Windchill Business Reporting이 성공적으로 설치되었는지 확인하려면
<machine>:<port>/Cognos
URL로 이동하십시오. 여기에서 <machine>은 Windchill Business Reporting이 설치된 시스템이며 <port>는 Windchill Business Reporting 게이트웨이 시스템의 웹 서버 포트입니다(기본 포트 값 80을 수락한 경우 URL에서 포트를 지정할 필요 없음).
설치 중에 지정한 Windchill 관리 사용자(기본적으로 wcadmin) 또는 Windchill Business Reporting 관리 사용자(기본적으로 wbradmin)에 대해 지정한 자격 증명을 사용하여 로그인합니다. 처음에는 관리 LDAP 저장소에 있는 모든 사용자가 Windchill Business Reporting에 로그인할 수 있습니다. 기업 저장소에서 사용자로 로그인하려는 경우 또는 Windchill Business Reporting 관리 사용자가 기업 저장소에 있도록 구성한 경우 "인증을 위해 기업 LDAP 추가" 단원을 참조하십시오.
기본 보고서 존재 여부 확인
|
이 확인 단계는 Windchill PDMLink, Windchill ProjectLink, 통합 Windchill PDMLink 및 Windchill ProjectLink, 통합 Arbortext Content Manager 및 Windchill ProjectLink 설치에만 적용됩니다.
|
Windchill Business Reporting으로 로그인한 경우 Windchill 솔루션에 대해 로드된 기본 보고서가 들어 있는 Windchill 폴더가 표시되어야 합니다. Windchill Requirements Management, Windchill Aerospace and Defense 또는 Windchill MPMLink가 Windchill 솔루션과 함께 설치된 경우 각 제품의 기본 보고서를 위한 폴더가 Windchill 폴더 내에 있습니다.
이러한 보고서는 Windchill 솔루션의 보고서 페이지에서도 사용할 수 있습니다.
Cognos 구성 도구 액세스
확인에 실패하거나 Cognos에서 추가 구성을 수행하려는 경우 Cognos 구성 도구를 사용합니다. 설치 중에 바로 가기를 작성한 경우 Cognos Configuration 바로 가기를 선택하여 도구에 액세스할 수도 있습니다. 또는, 다음 위치에서 Cognos 구성 도구에 액세스합니다.
• Windows 32비트 시스템의 경우: <WBR_Home>\bin\cogconfigw.exe
• Windows 64비트 시스템의 경우: <WBR_Home>\bin\cogconfigw.exe
• UNIX의 경우: <WBR_Home>/bin64/cogconfig.sh
여기서 <WBR_Home>은 Windchill Business Reporting이 설치된 시스템입니다. 자세한 내용은 Cognos 구성 도구에서 사용할 수 있는 설명서를 참조하십시오.
Windchill Business Reporting 액세스 제어 구성
기본적으로 Windchill Business Reporting에서는 모든 Windchill 사이트 관리자(Administrators 그룹의 멤버)를 Cognos 내 System Administrators 그룹의 멤버로 만들어 모든 Windchill Business Reporting 데이터 및 기능에 대한 모든 권한을 제공합니다. 사이트에 선택적 Windchill Business Reporting 모듈이 있는 경우에는 사용자를 적절한 Windchill 그룹에 추가해야만 사용자가 추가 Windchill Business Reporting 기능에 액세스할 수 있습니다.
• Windchill Business Report Author 선택적 모듈 - Business Report Author 그룹의 멤버인 사용자만 Report Studio 도구에 액세스할 수 있습니다.
• Windchill Business Report Monitor 선택적 모듈 - Business Report Monitor 그룹의 멤버인 사용자만 Report Monitor 도구에 액세스할 수 있습니다.
처음에는 설치 중에 작성된 Windchill 관리 사용자(기본값: wcadmin) 및 Windchill Business Reporting 관리 사용자(기본값: wbradmin)가 이러한 그룹의 유일한 멤버입니다. > 에서 사용 가능한 참여자 관리 유틸리티를 사용하여 이러한 그룹에 추가 사용자를 추가할 수 있습니다.
액세스 제어를 구성하는 방법에 대한 자세한 내용은 Windchill Business Reporting 설명서 페이지에서 사용 가능한 Cognos 관리 및 보안 안내서를 참조하십시오. 이 페이지는 Windchill Business Reporting호스트 구성 요소 또는 게이트웨이 서버)이 설치된 시스템의 다음 위치에서 액세스할 수 있습니다.
<WBR_Home>\webcontent\documentation
여기서 <WBR_Home>은 Windchill Business Reporting이 설치된 위치입니다.
HTTPS를 사용하여 Windchill Business Reporting 구성
SSL 프로토콜로 작업하도록 다음과 같은 일반적인 단계에 따라 Windchill Business Reporting을 구성할 수 있습니다. 그러면 HTTP 대신 HTTPS를 사용하여 통신이 이루어집니다.
2. 이전 단원에서 설명한 것처럼 설명서 페이지에서 사용 가능한 보안 배포 안내서의 지침에 따라 SSL을 사용하도록 Windchill Business Reporting을 구성합니다.
4. Windchill Business Reporting를 다시 시작합니다.
인증을 위해 기업 LDAP 추가
LDAP 인증 네임스페이스 추가
"확인" 단원에서 설명한 대로 Cognos 구성 도구에 액세스합니다. IBM Cognos Business Intelligence Installation and Configuration Guide(IBM Cognos Business Intelligence 설치 및 구성 안내서)에 나오는 지침에 따라 기업 LDAP에 맞는 적절한 유형의 LDAP 또는 Active Directory의 새 네임스페이스 리소스를 적절하게 추가합니다. 또한 다음 필드의 값을 지정해야 합니다.
• 네임스페이스 ID
• 호스트 및 포트
• 기본 구분 이름
사용자가
Windchill Business Reporting에 로그인하면 PSI에서 구성된 원본 관리 LDAP, 새 기업 LDAP를 포함하여 사용 가능한 네임스페이스 드롭다운 목록이 표시됩니다. 로그인 기본값을 엔터프라이즈 LDAP로 지정하려면
기본 네임스페이스 설정(선택 사항)을 참조하십시오. 나중에 기본 네임스페이스를 제거하도록 선택하고 드롭다운 목록으로 되돌릴 수 있습니다.
웹 서버 구성
이제 Windchill Business Reporting 요청을 인증할 때 기업 LDAP를 인식하도록 웹 서버를 구성합니다. 사이트에 설치된 웹 서버에 대한 자세한 내용은 이 안내서의 이전 장을 참조하십시오. 다음 단원에는 각 웹 서버에 유용한 정보가 포함되어 있습니다.
지원되는 소프트웨어 버전에 대한 자세한 내용은 소프트웨어 지원 매트릭스(
https://www.ptc.com/en/support/refdoc에서 제공)를 참조하십시오.
PTC HTTP Server(Windows)
Windchill Business Reporting 요청 인증을 위해 기업 LDAP를 인식하도록 PTC HTTP Server를 구성하려면 다음 절차를 따르십시오.
1. Windchill 셸에서 PTC HTTP Server가 설치된 디렉토리로 이동합니다.
2. 명령줄에서 다음을 실행합니다.
ant -f webAppConfig.xml addCognosAuthProvider
-DappName=<COGNOS_WEBAPP_NAME>
-DproviderName=<ENTERPRISE_LDAP_NAME>
-DldapUrl=<ENTERPRISE_LDAP_URL>
-DdocBase=<WBR_HOME>
where
◦ <COGNOS_WEBAPP_NAME>은 Cognos 웹 응용 프로그램의 이름이며 기본적으로 Cognos입니다.
◦ <ENTERPRISE_LDAP_NAME>은 기업 LDAP의 고유한 이름입니다. 이 값은 Cognos 구성 도구의 EnterpriseLDAP 노드 값과 일치해야 합니다.
◦ <ENTERPRISE_LDAP_URL>은 기업 LDAP의 전체 URL로서 기본 구분 이름이 포함됩니다. 예:
ldap://mymachine.mycompany.com:389/cn=EnterpriseLdap,cn=Windchill_10.0,o=myorg
◦ <WBR_HOME>은 Windchill Business Reporting의 설치된 위치입니다.
필요한 경우 -DbindDn 및 -DbindPwd 요소를 포함할 수도 있습니다.
| 인수 중 하나에 공백이나 등호( = )가 있는 경우 인수 전체를 큰따옴표( " )로 묶어야 합니다. |
3. PTC HTTP Server를 다시 시작합니다.
IIS(인터넷 정보 서비스)
IIS는
Windchill Business Reporting 요청 인증을 위해 단일 LDAP만 사용할 수 있습니다.
IIS 및 Tomcat 구성 장에서 설명한 것처럼 처음에 함께 제공되는
PTC HTTP Server를 사용하여 시스템을 구성한 다음 IIS로 전환하는 것이 좋습니다.
1. 'PTC HTTP Server(Windows)' 단원에 나온 단계를 따르고 구성이 제대로 작동하는지 확인합니다.
2. Cognos 설치 및 구성 안내서에 나오는 지침에 따라 Windchill Business Reporting에 대한 IIS를 구성합니다.
3. PTC HTTP Server를 종료하고 IIS를 시작합니다. PTC HTTP Server와 IIS는 동시에 실행되지 않으므로 동일한 포트를 사용할 수 있습니다.
로그인할 때 Cognos 네임스페이스 선택 동작 구성(선택 사항)
다음 옵션 중 하나를 선택하여 Windchill Business Reporting에 로그인할 때 Cognos 네임스페이스 선택 동작을 구성하도록 선택할 수 있습니다.
또는
이 옵션은 한 번에 하나만 구성할 수 있습니다. 옵션을 구성하지 않으면 Windchill Business Reporting에 로그인할 때 사용 가능한 네임스페이스 중에서 선택할 수 있는 드롭다운 목록이 사용자에게 표시됩니다.
기본 네임스페이스 설정
기본적으로 기업 LDAP를 사용하여 사용자를 인증하려면 다음 절차에 따라 Windchill Business Reporting 게이트웨이 네임스페이스를 설정합니다. 이 게이트웨이 네임스페이스는 Windchill Business Reporting에서 인증에 사용되는 기본 네임스페이스입니다. 다시 말해서, 지정된 네임스페이스만 인증에 사용됩니다.
1. "확인" 단원에서 설명한 대로 Cognos 구성 도구에 액세스합니다.
2. 탐색기 트리의 환경 노드를 선택합니다.
3. 등록 정보 패널에서
LDAP 인증 네임스페이스 추가에서 작성된 새 엔터프라이즈 LDAP 네임스페이스 리소스의 네임스페이스 ID에 입력한 것과 동일한 값으로
게이트웨이 네임스페이스 등록 정보를 지정합니다.
| 기업 LDAP를 게이트웨이 네임스페이스로 설정하는 경우 기업 LDAP의 사용자만 Windchill Business Reporting에 로그인할 수 있습니다. 따라서 관리 LDAP의 사용자(wcadmin, wbradmin 등)는 Windchill Business Reporting에 로그인할 수 없지만 기업 LDAP의 사용자 중 동일한 사용 권한이 있는 사용자는 로그인할 수 있습니다. 나중에 이 게이트웨이 네임스페이스를 제거하고 Windchill Business Reporting에 로그인할 때 표시되는 네임스페이스 드롭다운 목록으로 돌아갈 수 있습니다. |
Windchill에서 사용자의 Cognos 네임스페이스를 전달하도록 허용
Windchill에서 사용자의 Cognos 네임스페이스를 명시적으로 전달하려면 xconf manager를 사용하여 wt.properties 파일에서 다음 등록 정보를 설정합니다.
• wt.cognos.explicitNamespace.enabled - 이 등록 정보를 TRUE로 설정하면 Windchill에서는 현재 사용자의 Cognos 네임스페이스를 확인하고, Windchill 내에서 Windchill Business Reporting 보고서가 실행될 때 해당 네임스페이스를 URL 매개변수로 명시적으로 전달합니다. 네임스페이스를 확인할 수 없으면 위의 설명과 같이 표준 네임스페이스 드롭다운 목록이 표시됩니다. 이 등록 정보를 FALSE(기본값)로 설정하면 드롭다운 목록 동작으로 돌아갑니다.
• wt.cognos.startup.location - 이 등록 정보 값을 Cognos 구성 파일인 cogstartup.xml의 파일 경로 위치로 설정합니다. Windchill 솔루션과 WBR Gateway Server가 동일한 시스템에 설치된 경우 등록 정보 값을 다음으로 설정할 수 있습니다.
$wt.cognos.home\\configuration\\cogstartup.xml
Windchill 솔루션과 WBR Gateway Server가 서로 다른 시스템에 설치된 경우 파일을 사용할 수 있도록 액세스 가능한 위치에 파일을 복사하거나 파일이 들어 있는 디렉토리를 공유해야 합니다.
모델 업데이트 및 보고서 로드
설치 중에 기본 보고서가 로드되지 않았거나(예: 기본 데이터를 로드하지 않은 경우) Windchill Business Reporting으로 로드해야 하는 보고서가 업데이트된 경우, 데이터 모델을 업데이트하고 보고서를 Windchill 솔루션이 설치된 시스템에 로드해야 합니다. 그렇게 하려면 Windchill 셸에서 다음 스크립트를 실행합니다. 이 스크립트를 성공적으로 실행하려면 Windchill 솔루션, Windchill Business Reporting, 웹 서버 및 서브렛 엔진이 실행 중이어야 합니다.
ant -f <wt_home>/installer/wnc/wbr_actions.xml
기존 설치 업데이트
Windchill Business Reporting을 포함하도록 기존 Windchill 설치를 업데이트하려는 경우 다음 수동 사후 설치 단계를 완료해야 합니다.
• Cognos에 대한 새 데이터베이스 응용 프로그램 사용자를 작성합니다. 자세한 내용은 "새 Cognos 데이터베이스 사용자 작성" 단원을 참조하십시오.
• xconfmanager를 사용하여 등록 정보를 설정합니다. 자세한 내용은 "등록 정보 설정" 단원을 참조하십시오.
• 이전 단원인 "모델 업데이트 및 보고서 로드" 단원에 설명된 대로 wbr_actions.xml 스크립트를 실행합니다.
새 Cognos 데이터베이스 사용자 작성
Windchill PDMLink 위에 Cognos를 설치하기 전에 새 Cognos 데이터베이스 사용자를 작성해야 합니다. 자세한 내용은
데이터베이스 응용 프로그램 사용자 구성을 참조하십시오. 여기서 해당 데이터베이스에 적합한 지침을 따릅니다.
등록 정보 설정
설치에 적합한 값과 xconfmanager를 사용하여 다음 등록 정보를 설정합니다.
• wt.properties의 경우:
wt.reporting.thirdParty.enabled=true
wt.auth.trustedHosts=<WBR 호스트> <WBR 게이트웨이> localhost
• db.properties의 경우:
wt.cognos.namespace=AdministrativeLDAP
wt.cognos.endpointUrl=http://<WBR 호스트>:<WBR 포트>/p2pd/servlet/dispatch
wt.cognos.home=<호스트 시스템의 WBR 호스트 컴포넌트 설치 디렉토리>
wt.cognos.model.dir.location=$(wt.cognos.model.dir)
wt.cognos.admin.uid=<Windchill 사이트 관리자 사용자>
wt.cognos.admin.password=<Windchill 사이트 관리자 암호>
wt.cognos.externalUrl=$(wt.webserver.protocol)://$(wt.rmi.server.hostname)
:$(wt.webserver.port)/Cognos/bi/v1/disp
| wt.cognos.namespace 등록 정보에 사용되는 값은 Cognos 구성 도구의 네임스페이스 ID 값과 일치해야 하며 기본적으로 AdministrativeLDAP입니다. 네임스페이스 ID 값을 변경한 경우 wt.cognos.namespace 등록 정보에 대해 새 값을 사용해야 합니다. |
| Windchill Business Reporting 호스트 및 Windchill 웹 서버가 설치되는 시스템의 운영 체제가 서로 다를 경우 db.properties에 대해 다음 등록 정보도 설정해야 합니다. wt.cognos.model.dir=$(wt.cognos.home)<OS 특정 분리자> $(wt.cognos.model.name) 여기서 <OS별 특정 분리자>는 Windows 시스템의 경우 백슬래시( \ )이고 Unix 시스템의 경우 슬래시( / )입니다. |
별도의 PTC HTTP Server에 대한 역방향 프록시 구성
Windchill Business Reporting과 Windchill 솔루션에서 서로 다른 PTC HTTP Server를 사용할 경우 역방향 프록시 구성이 필요합니다.
Windchill Business Reporting과 Windchill 솔루션이 성공적으로 설치된 후 다음을 수행해야 합니다.
| Windchill 솔루션과 Windchill Business Reporting은 모두 동일한 LDAP를 사용해야 합니다. |
Windchill 구성
다음 위치에서 Windchill 솔루션을 변경해야 합니다.
• wt.properties 파일
Windchill Business Reporting이 설치된 시스템의 주소를 신뢰할 수 있는 호스트로 포함하도록 wt.properties를 수정합니다.
wt.auth.trustedHosts=<machine_ip_addr> <serverhost>
여기서 <machine_ip_addr><serverhost>는 Windchill Business Reporting이 설치된 시스템의 주소입니다. 분산 설치 시나리오에서는 Windchill Business Reporting 호스트 구성 요소가 설치된 시스템입니다.
• HTTPSERVER_HOME/conf/conf.d에서 다음 콘텐츠로 cognosreverseproxy.conf 파일을 작성합니다.
<IfModule !proxy_http_module>
LoadModule proxy_http_module modules/mod_proxy_http.so
</IfModule>
ProxyPass /Cognos <cognos_url>
ProxyPassReverse /Cognos <cognos_url
여기서 <cognos_url>은 Windchill Business Reporting호스트 구성 요소가 설치된 시스템의 전체 URL입니다. 예:
http://server1.mycompany.com/Cognos
• PTC HTTP Serveradditions.conf