clm_server_rename.pl

이 도구는 CLM(Collaborative Lifecycle Management)용 Rational 솔루션에 대한 Jazz Team Server 공용 URI 아티팩트 링크를 업데이트합니다. 특히 이 도구는 IBM Rational ClearQuest Web 서버 구성 파일에 저장되어 있는 URI를 업데이트합니다. 또한 ClearQuest 사용자 데이터베이스의 OSLCLink 레코드에 저장되어 있는 URI도 업데이트합니다.

개요

cqperl clm_server_rename.pl -username username -password password [ -dbset dbset ] -dbname dbname –oldprefix oldprefix –newprefix newprefix [ -remapconfigfiles | -preview number | -update ] [ -help ] [ -man ]

설명

CLM(Collaborative Lifecycle Management)용 Rational 솔루션 버전 4.0 제품부터 관리자는 서버 이름 바꾸기 조작을 사용하여 배치 후 Jazz Team Server 또는 CLM용 Rational 솔루션 애플리케이션의 공용 URI를 변경할 수 있습니다. 이러한 변경을 수행하려면 이에 대응하여 해당 URI를 기반으로 하는 CLM용 Rational 솔루션 자원을 업데이트해야 합니다. ClearQuest 브릿지의 경우, CLM용 Rational 솔루션 제품 자원(IBM Rational Team Concert, IBM Rational Quality Manager 및 IBM Rational Requirements Composer)에 대한 해당 아티팩트 링크는 ClearQuest Web 서버 구성 파일과 ClearQuest 사용자 데이터베이스의 OSLCLinks 레코드에 저장되어 있습니다.

CLM용 Rational 솔루션에는 여러 가지 유형의 아티팩트 링크가 있습니다.
  • 구조적 링크는 자원 또는 아티팩트 사이의 관계를 설명하며 추적성 및 데이터 무결성을 유지보수하는 데 필요합니다.
  • 임베디드 링크는 텍스트 필드 또는 자원 노드에 포함될 수 있는 URI입니다. 임베디드 링크는 앵커 링크 또는 일반 텍스트 링크 중 하나입니다.
    • 앵커 링크는 탐색 가능한 하이퍼링크로 사용자에게 표시됩니다. 예를 들어, 서식있는 텍스트 위젯에서 해당 링크는 탐색 가능한 하이퍼링크로 선언되며 일반적으로 <a href=...> 같은 구조에 저장됩니다.
    • 일반 텍스트 링크는 텍스트 위젯에 입력되는 URI이지만 탐색 가능한 하이퍼링크로 렌더링되지 않습니다.

ClearQuest는 ClearQuest Web 구성 파일 및 OSLCLinks 레코드에 저장되어 있는 URI 구조적 링크를 다시 맵핑하기 위한 clm_server_rename.pl 도구를 제공합니다. 구조적 링크의 프로토콜, 호스트 이름, 포트 번호 및 애플리케이션 컨텍스트를 다시 맵핑하려면 이 도구를 사용하십시오.

도구 실행

clm_server_rename.pl 도구를 실행하려면 로컬 관리자 권한 및 ClearQuest 수퍼유저 권한이 있어야 합니다.

이 도구는 cqweb.war 파일의 다음 디렉토리에 있습니다.

WAS_profile_home\installedApps\nodecell\TeamEAR.ear\cqweb.war\WEB-INF\classes

cqperl.exe 프로그램은 ClearQuest가 설치되어 있는 디렉토리에 있습니다.

clm_server_rename.pl 도구를 실행하기 전에 TEMP 환경 변수를 쓰기 액세스 권한이 있는 디렉토리로 설정하는 것이 좋습니다. 그렇지 않은 경우, 도구를 실행 중인 디렉토리에서 쓰기 액세스 권한이 있는지 확인하십시오.

이 도구를 여러 번 실행해야 합니다.

전체 프로시저 세부사항은 CLM 서버 이름 바꾸기 후 URI 다시 맵핑을 참조하십시오.

명령행 옵션에 대한 설명은 옵션 및 인수 섹션을 참조하십시오.

제한사항

clm_server_rename.pl 도구는 ClearQuest Web 서버 구성 파일 및 OSLCLinks 레코드에 저장되어 있는 구조적 링크만 다시 맵핑합니다. 이 도구는 ClearQuest 레코드에 저장되어 있는 임베디드 링크는 다시 맵핑하지 않습니다. 이러한 임베디드 앵커 링크는 레코드 첨부 또는 설명이나 참고사항과 같은 필드에 포함될 수 있습니다. 스키마에 따라 이러한 필드는 제출 후 또는 참고사항이 추가된 후 읽기 전용 필드가 될 수 있습니다. 이는 도구 실행 후 임베디드 앵커 링크가 끊어진 상태로 남아 있게 됨을 의미합니다. 필요한 경우 이러한 링크를 해결하기 위한 코드를 작성할 수 있습니다.

도구 실행 후 끊어진 상태로 남아 있는 임베디드 앵커 링크의 예로는 Rational ClearQuest와 Rational Quality Manager 간의 CLM용 Rational 솔루션 통합이 있습니다. Rational Quality Manager 아티팩트가 ClearQuest 레코드에 링크되어 있으면 Rational Quality Manager는 아티팩트에 대한 URI 링크를 레코드 설명 필드에 삽입합니다.

옵션 및 인수

-username username
수퍼유저 권한이 있는 관리 사용자의 로그온 이름입니다.
-password password
수퍼유저 권한이 있는 관리 사용자의 비밀번호입니다.
-dbset dbset
데이터베이스 연결의 이름입니다.
-dbname dbname
사용자 데이터베이스의 이름입니다.
–oldprefix oldprefix
기존 URI 문자열을 지정합니다. URI 형식은 http로 시작하고 슬래시(/)가 뒤에 오는 애플리케이션 컨텍스트를 포함해야 합니다.
–newprefix newprefix
–oldprefix 옵션으로 지정한 기존 URI 문자열을 대체할 새 URI 문자열을 지정합니다. URI 형식은 http로 시작하고 슬래시(/)가 뒤에 오는 애플리케이션 컨텍스트를 포함해야 합니다.
-remapconfigfiles
중요사항: 이 옵션을 사용하는 경우, 도구가 설치되어 있는 디렉토리에서 도구를 실행해야 합니다.

CLM용 Rational 솔루션 애플리케이션에 대한 Jazz Team Server 공용 URI 아티팩트 링크를 다시 맵핑합니다. 특히 이 옵션은 ClearQuest Web 서버 구성 파일에 저장되어 있는 URI를 다시 맵핑합니다. 도구는 URI를 다시 맵핑하기 전에 구성 파일을 복사합니다.

이 옵션과 함께 도구를 실행한 후에는 ClearQuest Web 서버를 다시 시작해야 합니다. 그러면 웹 서버의 상호 서버 통신이 재구성되고 사용자가 CLM용 Rational 솔루션 아티팩트에 대한 새 URI 링크를 작성할 수 있습니다. 그러나 CLM용 Rational 솔루션 아티팩트에 대한 기존 링크 따르기는 -update 옵션과 함께 도구를 다시 실행해야 작동됩니다.

-preview number
ClearQuest 데이터베이스에서 oldprefix URI 문자열이 포함된 OSLCLinks 레코드 number에 적용될 변경사항의 미리보기를 표시합니다. 또한 oldprefix URI 문자열이 포함된 총 OSLCLinks 레코드 수를 보고합니다. 이 옵션이 사용되는 경우 사용자 데이터베이스는 변경되지 않습니다.
-update
CLM용 Rational 솔루션 아티팩트에 대한 Jazz Team Server 공용 URI 링크를 업데이트합니다. 특히 이 옵션은 ClearQuest OSLCLink 레코드에 저장되어 있는 URI를 업데이트합니다.

도구가 이 옵션과 함께 실행되면 도구는 OSLCLinks 레코드에 대한 변경사항을 로그 파일에 캡처합니다. TEMP 환경 변수가 설정된 경우, 로그 파일은 지정된 디렉토리에 작성됩니다. 그렇지 않은 경우에는 사용자에게 쓰기 액세스 권한이 있는 경우 사용자가 실행 중인 디렉토리에 로그 파일이 작성됩니다. 다음과 같은 파일 이름 지정 규칙이 로그 파일에 사용됩니다.

clm_server_rename_yyyymmdd_hhmmss.txt

여기서

yyyymmdd
도구가 실행된 날짜이며 연도, 월 및 일로 지정됨
hhmmss
도구가 실행된 시간이며 시간, 분 및 초로 지정됨

예를 들어, clm_server_rename_20120405_211711입니다.

예제

  • MyCQWebServer로 이름 지정된 서버에 대해 ClearQuest Web 서버 구성 파일에서 다음에 지정된 URI 문자열과 일치하는 Jazz Team Server URI 아티팩트 링크를 다시 맵핑하십시오.

    C:\was_profiles\MyCQWebServer\installedApps\Node02Cell\TeamEAR.ear\cqweb.war\WEB-INF\classes>cqperl clm_server_rename.pl -username admin -password secret -dbset 7.0.0 -dbname SAMPL -oldprefix https://clm7.mycompany.com/ccm/ -newprefix https://clm7.mycompany.com/jazz/ -remapconfigfiles

    시작됨: friendsconfig.rdf 구성 파일에서 URI 다시 맵핑.
    완료됨: friendsconfig.rdf 구성 파일에서 URI 다시 맵핑.

    시작됨: project-area-links.rdf 구성 파일에서 URI 다시 맵핑.
    완료됨: project-area-links.rdf 구성 파일에서 URI 다시 맵핑.

    시작됨: oauth-consumers.rdf 구성 파일에서 URI 다시 맵핑.
    완료됨: oauth-consumers.rdf 구성 파일에서 URI 다시 맵핑.

  • ClearQuest 데이터베이스에서 다음에 지정된 URI 문자열과 일치하는 5개의 OSLCLinks 레코드 및 애플리케이션 컨텍스트가 jazz에서 ccm으로 변경되는 경우의 레코드 모양을 미리 보십시오.

    cqperl clm_server_rename.pl -username admin -password secret -dbset 8.0.0 -dbname SAMPL -oldprefix https://servername.com:9443/jazz/ -newprefix https://servername.com:9443/ccm/ -preview 5

  • ClearQuest OSLCLinks 레코드에서 다음에 지정된 URI 문자열과 일치하는 URI의 프로토콜을 http에서 https로 변경하십시오.

    cqperl clm_server_rename.pl -username admin -password secret -dbset 8.0.0 -dbname SAMPL -oldprefix http://servername.com:9443/jazz/ -newprefix https://servername.com:9443/jazz/

  • ClearQuest OSLCLinks 레코드에서 다음에 지정된 URI 문자열과 일치하는 URI의 서버 이름을 servername에서 newservername으로 변경하십시오.

    cqperl clm_server_rename.pl -username admin -password secret -dbset 7.0.0 -dbname SAMPL -oldprefix http://servername.com:9443/jazz/ -newprefix https://newservername.com:9443/jazz/

참조

CLM 서버 이름 바꾸기 후 URI 다시 맵핑, Changing the public URI using server rename


피드백