cqtsadmin.pl

cqtsadmin.pl은 IBM® Rational® ClearQuest® 전체 텍스트 검색의 설정, 구성 및 관리 단계를 자동화합니다.

개요

cqperl cqtsadmin.pl --username superusername --password password --dbset dbset --userdb connectionname --ftshome cqftshome [options]

설명

cqtsadmin.pl 스크립트는 전체 텍스트 검색 관리자 도구의 두 컴포넌트 중 하나입니다. 다른 컴포넌트는 cqtsadmin.pl 스크립트에 의해 생성되는 cqtsadmin-dbset-userdb.xml입니다. cqtsadmin-dbset-userdb.xml 파일은 전체 텍스트 검색 배치에 대한 데이터를 제공하고 저장합니다. 사용자 배치에 맞게 cqtsadmin-dbset-userdb.xml을 편집하십시오. 모든 명령행 옵션은 Windows, UNIX 또는 Linux에서 동일하게 작동하지만, scrub_oplog 옵션은 UNIX 또는 Linux에서 사용할 수 없습니다.

중요사항: cqtsadmin.pl 명령을 실행하려면 CQFTS_AppServer_HOME 환경 변수를 WebSphere® Application Server가 설치된 디렉토리로 설정해야 합니다. ClearQuest를 기존의 WebSphere Application 프로파일에 설치하는 경우나, ClearQuest 웹 서버에 원격으로 액세스하는 개별 시스템에 전체 텍스트 검색 기능을 설치하는 경우와 같은 특정 상황에서는 CQFTS_AppServer_HOME 환경 변수가 설정되지 않고 다음과 같은 오류가 표시됩니다.

WebSphere의 AppServer 홈을 확인할 수 없습니다. CQFTS_AppServer_HOME 환경 변수를 통해 설정하는 방식에 대해서는 ClearQuest 전체 텍스트 검색 관리자 안내서를 참조하십시오.

이 문제를 해결하려면 WebSphere Application Server를 설치한 디렉토리로 CQFTS_AppServer_HOME 변수를 설정하십시오. 예를 들어, 다음과 같이 변수를 설정하십시오.

Windows 운영 체제의 경우:
set CQFTS_AppServer_HOME=C:\Program Files\IBM\WebSphere\AppServer
UNIX 시스템 및 Linux 운영 체제의 경우:
setenv CQFTS_AppServer_HOME /opt/IBM/WebSphere/AppServer
중요사항: dbset, userdbftshome 인수는 대소문자를 구분합니다. cqtsadmin.pl 스크립트를 사용하는 전반에 걸쳐 동일한 대소문자를 유지해야 합니다. 그렇지 않으면 전체 텍스트 검색 배치가 재구성될 수 있습니다.

ftshome 옵션

전체 텍스트 검색을 배치하거나 배치를 참조하는 경우 필수 명령행 옵션 ftshome, dbsetuserdb 인수가 배치 데이터의 저장 위치를 정의합니다. 다음 예는 D 드라이브의 CQ.Search 디렉토리에 ClearQuest 전체 텍스트 검색 배치를 새로 작성하는 방법을 보여줍니다. 디렉토리가 존재하지 않을 경우에는 작성됩니다. TextSearch_SAMPL 서브디렉토리가 이전 디렉토리에 작성됩니다. 서브디렉토리 이름은 ClearQuest 데이터베이스 세트 이름과 ClearQuest 논리 사용자 데이터베이스 이름을 토대로 생성됩니다. 서브디렉토리에는 이 배치의 전체 텍스트 검색 데이터가 포함됩니다.

cqperl cqtsadmin.pl --username admin --password “” --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile manual --fts_was_profile_home D:\FTS.WASprofiles

D:\CQ.Search\TextSearch_SAMPL 디렉토리가 작성되면 이 디렉토리가 TextSearch 데이터베이스 세트와 SAMPL 사용자 데이터베이스에 대한 전체 텍스트 검색 배치의 위치입니다. 이 배치와 관련되는 모든 데이터와 설정이 이 디렉토리에 저장됩니다. ftshome, dbsetuserdb 인수에 대해 동일한 값을 사용하여 실행하는 후속 명령은 이 디렉토리에 적용됩니다.

두 번째 ClearQuest 사용자 데이터베이스에 대해 전체 텍스트 검색을 배치하려면 두 번째 ClearQuest 사용자 데이터베이스와 관련되는 필수 명령행 옵션을 지정하십시오. 추가적인 ClearQuest 사용자 데이터베이스는 지정된 ftshome 인수와 생성된 서브디렉토리 구조에 기반하는 전체 텍스트 검색 구성을 배치합니다.

cqperl cqtsadmin.pl --username admin --password “” --dbset TextSearch --userdb PROD --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile manual --fts_was_profile_home D:\FTS.WASprofiles
표 1. 전체 텍스트 검색 배치 디렉토리 구조
디렉토리 또는 파일 설명
ftshome\dbset_userdb\logs\ 이 디렉토리에는 이 배치에 대해 실행하는 모드 명령의 로그가 저장됩니다. 사용한 명령, 사용 시기, 이의 상태에 대한 히스토리를 가져오려면 이 디렉토리를 참조하십시오. IBM 소프트웨어 지원 센터에서는 문제를 처리할 때 이러한 로그를 점검합니다. 비밀번호는 로그와 화면 출력에서 일반 텍스트가 아닌 별표(*)로 표시됩니다.
ftshome\dbset_userdb\Solr\solr\conf\schema.xml 이 파일은 검색 엔진이 색인화하거나 검색할 필드를 판별할 때 사용하는 구성 파일 중 하나입니다. cust_solr_files 명령을 실행하는 경우 이 파일의 필드는 엔티티 파일에 지정된 레코드 유형의 필드와 일치하도록 사용자 정의됩니다.

ClearQuest 데이터베이스가 영어가 아닌 경우 추가 사용자 정의를 위해 이 파일을 편집해야 합니다. 자세한 정보는 비영어 데이터베이스에서 전체 텍스트 검색 사용 가능을 참조하십시오.

ftshome\dbset_userdb\Solr\solr\data\index\ 이 디렉토리에는 사용자 배치의 실제 색인이 저장됩니다.
주의: 이 디렉토리의 컨텐츠를 수정하지 마십시오. 디렉토리를 수정하면 배치의 무결성이 훼손되어 색인화 또는 배치를 재수행해야 할 수 있습니다.
ftshome\dbset_userdb\AboutThisFTS.txt 이 파일은 전체 텍스트 검색의 초기 배치 시 한 번 생성됩니다. 여기에는 사용자가 참조해야 하는 배치 정보가 포함되어 있습니다. IBM 소프트웨어 지원 센터에서는 문제를 처리할 때 이 파일을 점검합니다.
ftshome\dbset_userdb\CQ-dbset-userdb.xml 이 파일은 ClearQuest 전체 텍스트 검색 특성 XML 파일입니다. 파일에는 일괄처리 및 업데이트 색인화, 검색 서버, 연결 프로파일, 레코드 유형 및 색인화 및 검색할 필드에 대한 데이터가 포함되어 있습니다. IBM 소프트웨어 지원 센터에서는 문제를 처리할 때 이 파일을 점검합니다.
ftshome\dbset_userdb\cqtsadmin-dbset-userdb.xml 이 파일에는 전체 텍스트 검색 관리자 구성이 포함되어 있습니다. 배치에 대한 데이터를 포함합니다. 데이터의 대부분은 배치 중에 설정되지만 설정을 사용자 정의하기 위해서는 이 파일을 편집해야 합니다. IBM 소프트웨어 지원 센터에서는 문제를 처리할 때 이 파일을 점검합니다.
ftshome\dbset_userdb\Entity-dbset-userdb.txt 엔티티 파일에는 검색이 가능한 엔티티 유형 목록과 이의 필드가 포함되어 있습니다. 배치 중에 이 파일을 편집하여, 검색하지 않을 레코드 유형이나 필드를 제거해야 합니다. 배치를 완료한 후에는 이 파일을 수정하지 마십시오. IBM 소프트웨어 지원 센터에서는 문제를 처리할 때 이 파일을 점검합니다.

자국어 지원

영어가 아닌 운영 체제에서 cqtsadmin.pl을 사용하려면 LANGUAGE 시스템 환경 변수를 다음의 지원되는 값 중 하나로 설정하십시오.

LANGUAGE가 지원되지 않는 값을 지정하는 경우, cqtsadmin.pl이 오류 메시지와 함께 실패합니다.

옵션 및 인수

cqtsadmin.pl 스크립트에는 필수 명령행 옵션과 선택적 명령행 옵션이 있습니다. cqtsadmin.pl 스크립트를 실행할 때마다 필수 명령행 옵션을 제공해야 합니다. 필수 옵션의 매개변수 중 하나라도 올바르지 않으면 도구가 실패하고 오류 메시지가 표시됩니다. 도구는 조치를 취하기 전에 ClearQuest 데이터베이스에서 사용자를 인증합니다. cqtsadmin.pl 스크립트를 실행할 때에는 선택적 명령행 옵션을 하나 이상 제공해야 합니다.

필수 명령행 옵션
username superusername
수퍼유저 권한이 있는 ClearQuest 사용자 이름
password password
ClearQuest 사용자 비밀번호
dbset dbset
ClearQuest 데이터베이스 세트 이름. 값은 대소문자를 구분합니다.
userdb connectionname
ClearQuest 사용자 데이터베이스 이름. 값은 대소문자를 구분합니다.
ftshome cqftshome
ClearQuest 전체 텍스트 검색 홈 디렉토리입니다. 이 옵션에는 이 배치, Solr 파일, 설정, Lucene 색인과 관련되는 모든 구성 파일이 포함되어 있습니다. 값은 대소문자를 구분합니다.

선택적 명령행 옵션

선택적 명령행 옵션은 ClearQuest 전체 텍스트 검색 배치에 대해 특정의 조치를 수행합니다. 모든 명령은 정보, 진행상태, 경고, 오류 및 지시사항 출력을 생성합니다. 지시사항 출력은 오류 복구에 도움이 됩니다. 표시되는 출력도 로그 디렉토리에 저장됩니다. 이 로그 데이터는 화면 출력을 파일로 경로 재지정할 필요가 없으므로 배치에서 사용자 조치를 디버그하거나 추적하는 경우 유용합니다. 일반적으로 명령은 실패하지 않습니다. 실패하는 경우 대다수 명령은 모든 변경사항을 되돌려 놓습니다. 변경사항을 되돌릴 수 없는 경우 수행할 지시사항과 함께 오류 메시지가 표시됩니다. 선택적 명령행 옵션은 여러 번 실행할 수 있습니다. 여러 개의 선택적 명령행 옵션을 제공하는 경우 명령행에 표시되는 순서로 실행됩니다. 옵션이 실패하는 경우 후속하는 명령 평가와 실행이 중지되고 오류 메시지와 함께 도구가 종료합니다. 선택적 명령행 옵션은 자주 사용되는 옵션과 자주 사용되지 않는 옵션의 두 카테고리로 그룹화할 수 있습니다.

add_record_type
요약
하나 이상의 새 레코드 유형을 색인에 추가합니다. 이 옵션은 명령 실행 중에 ClearQuest Web 사용자의 전체 텍스트 검색 기능을 일시적으로 사용 불가능하게 합니다. 새 레코드 유형 및 이와 연관된 필드 목록이 전체 텍스트 검색 관리자 구성 파일에 있는 <addRecordType> 태그를 통해 제공됩니다.
사용법
초기 전체 텍스트 검색 배치 중에 레코드 유형을 누락한 경우 레코드 유형을 추가하거나, 초기 배치 후에 새 레코드 유형을 ClearQuest 스키마에 추가했고 새 레코드 유형을 검색하려는 경우 이 명령행 옵션을 사용하십시오. 이미 색인화된 레코드 유형에서 필드의 이름을 바꾸거나 필드를 추가 또는 제거한 경우 이 명령을 사용하십시오. 색인에 변경사항을 반영하려면 remove_record_type 명령을 실행하여 레코드 유형을 제거한 후 이 명령을 실행하여 다시 추가하십시오. 둘 이상의 레코드 유형을 추가하려면 세미콜론을 구분 기호로 사용하십시오. 예를 들어, 다음 코드는 Customer 레코드 유형과 Product 레코드 유형을 추가합니다.

<newValue required="no">Customer=CustomerNum,address,phone,product;Product=name,version</newValue>

필드 목록 없이 레코드 유형을 나열하는 경우 해당 레코드 유형의 모든 필드가 추가됩니다. 다음 예제에서는 Customer 레코드 유형과 Product 레코드 유형의 모든 필드가 추가됩니다.

<newValue required="no">Customer;Product</newValue>
영향
이 명령은 ClearQuest 전체 텍스트 검색 색인, ClearQuest 전체 텍스트 검색 특성 XML 파일, 엔티티 파일, Solr schema.xml 파일에 영향을 줍니다. 이 명령을 실행하기 전에 사용자의 배치를 백업하십시오. 피크 시간대를 피하여 이 옵션을 실행하십시오. 시간 소비가 많은 오퍼레이션이므로 전체 텍스트 검색이 잠깐 중단될 수 있습니다.
Stateful 상태
명령은 Stateful합니다. 실행 지점 중 하나에서 명령이 실패하는 경우 문제를 해결하고 명령을 다시 실행할 수 있습니다. 실행이 중지된 위치에서 오퍼레이션이 계속됩니다. 실패하는 경우 오류 메시지가 표시되어 수행할 작업을 알려줍니다.
예제
Customer라는 새 레코드 유형을 추가해야 합니다.
  1. cqtsadmin-TextSearch-SAMPL.xml 파일을 편집하고 <addRecordType> 태그를 변경하십시오.

    <newValue required="no">Customer=CustomerNum,address,phone,product</newValue>

  2. 백업을 작성합니다.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --backup_fts E:\FTSBackup

  3. 새 레코드 유형을 추가합니다.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --add_record_type

  4. cqtsadmin-TextSearch-SAMPL.xml 파일을 편집하고 <addRecordType> 태그에 추가한 내용을 제거하십시오. 이 단계는 기본적으로 정리 태스크입니다.
archive_fts
요약
ClearQuest 전체 텍스트 검색 배치를 아카이브합니다. 활성 전체 텍스트 검색 배치를 사용 불가능하게 한 다음 배치된 WebSphere Application Server 프로파일을 제거합니다. 모든 구성 데이터와 색인은 그대로 유지합니다. 새 구성에서 시작하여 이전 구성을 참조할 때 이 옵션을 사용할 수 있습니다.
사용법
새 배치를 시작하려면 이 명령행 옵션을 사용하거나, 더 이상 배치에서 전체 텍스트 검색 기능이 필요하지 않은 경우 이 옵션을 사용하십시오. 이 명령행 옵션은 전체 텍스트 검색 서비스를 중지하고 서비스 및 파일과 같은 모든 관련 자원을 아카이브합니다. 아카이브한 후 배치를 참조할 수 있습니다.
참고: 차후 복원을 계획하는 경우에는 이 명령행 옵션을 사용하지 마십시오. 대신 prep_upgd_was_profiles 명령행 옵션을 사용하십시오.
영향
이 명령행 옵션은 전체 텍스트 검색을 사용 불가능하게 합니다. 또한 이 배치의 WebSphere Application Server에 설정하여 사용한 모든 파일, 자원, 설정을 제거 및 삭제합니다. ftshome 아래의 배치 데이터는 영향을 받지 않지만 dbset_userdb.Archived-time-stamp로 이름이 변경됩니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 실행 지점 중 하나에서 명령이 실패하는 경우 아카이브를 수동으로 완료해야 합니다. 진행상태 보고서와 오류 메시지가 오류 복구 방법을 알려줍니다.
예제
다음 예제는 배치를 아카이브하는 방법을 보여줍니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --archive_fts

스크립트 실행 후 아카이브된 전체 텍스트 검색 배치는 D:\CQ.Search\TextSearch_SAMPL.Archived-time-stamp가 됩니다.

backup_fts destination
요약
ClearQuest 전체 텍스트 검색 배치의 백업 사본을 작성합니다. 백업이 작성되면 백업이나 전체 배치를 통해 데이터를 복구할 수 있습니다. 최상의 결과를 얻으려면 기존 배치를 상당히 변경하는 명령을 실행하기 전에 백업을 먼저 작성하십시오. 배치를 백업하기 전에 ftshome 배치 시 사용한 것과 동일한 양의 디스크 공간이 백업 위치에 있는지 확인하십시오.
사용법
레코드 유형을 추가하거나 업데이트할 때 또는 조직의 정책에 따라 정기 백업을 유지보수해야 하는 경우 이 명령을 사용하여 백업을 작성합니다.
참고: 각 사용자 데이터베이스의 백업 WebSphere Application Server 프로파일을 처리하는 prep_upgd_was_profiles 명령행 옵션을 대신하여 이 명령을 사용하지는 마십시오.
영향
이 명령은 백업 중 업데이트 모드 색인기를 일시적으로 사용 불가능하게 합니다. 백업 기간 중 전체 텍스트 검색은 최신이 아닐 수 있습니다. LAN이나 WAN을 통해 백업하는 경우 백업 기간은 색인의 크기, 하드 드라이브의 속도, 네트워크 등에 따라 다릅니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 실행 지점 중 하나에서 명령이 실패하는 경우 실패 유형과 수신되는 오류 메시지에 따라 백업을 수동으로 완료하거나 시작해야 합니다. 가장 일반적인 장애는 대상 디바이스에 디스크 공간이 충분하지 않은 경우입니다. 백업 중에는 배치 데이터가 변경되지 않습니다.
예제
새 레코드 유형을 추가하기 전에 배치의 백업을 작성합니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --backup_fts E:\FTSBackup

스크립트 실행 후 아카이브된 전체 텍스트 검색 배치는 E:\FTSBackup\TextSearch_SAMPL.Backup-time-stamp가 됩니다.

clear_state
요약
상태가 없도록 cqtsadmin.pl 도구 프로시저에서 상태를 재설정합니다. 사실상 불완전 상태에서는 도구가 어떤 상태이든 지워집니다.
사용법
이 명령행 옵션을 사용하여 Stateful 명령의 상태를 지우고 다른 명령을 실행하거나 Stateful 명령을 재실행할 수 있습니다. 상태를 지우는 시기는 지우려는 Stateful 명령, Stateful 명령의 마지막 상태, 오류 메시지, 제공되는 정정 조치에 따라 달라집니다.
영향
이 명령행 옵션의 실행에 따른 영향은 중지된 Stateful 명령, 중지 전 명령 완료 정도에 따라 달라집니다. 로그와 오류 메시지에 상태를 재설정할 수 있는지 여부가 표시됩니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
오류 메시지의 지시사항에 따라 복구 불가능한 오류를 복구할 수 있도록 Stateful 조치의 상태를 지워야 합니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --clear_state

copy_fts_template
요약
ClearQuest 전체 텍스트 검색 기본 템플리트를 복사하고 설정합니다 아직 전체 텍스트 검색이 사용되지 않는 데이터베이스에 전체 텍스트 검색을 배치하는 경우 깨끗한 기본 템플리트에서 시작하여 이를 ftshome 디렉토리로 복사해야 합니다. 기존 배치에서 이 명령을 사용하려는 경우 오류와 함께 실패합니다.
사용법
일반적으로 init_cq_fts 명령행 옵션을 실행할 때 이 옵션이 호출되므로 이 명령행 옵션을 직접 사용할 필요는 없습니다. 배치를 미세 조정하거나 디버그해야 하는 경우 이 명령행 옵션이 제공됩니다.
영향
이 명령행 옵션은 전체 텍스트 검색 기능에 필요한 기본 데이터를 지정된 ftshome 디렉토리에 복사합니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
IBM Rational Client Support에서는 배치 문제를 디버그하거나 배치를 사용자 정의할 때 이 명령을 실행하도록 지시합니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --copy_fts_template

create_fts_was_profile startup-type { manual | automatic | disabled }
요약
ClearQuest 전체 텍스트 검색 WebSphere Application Server 프로파일을 작성합니다. 모든 새 배치에 필수입니다.
사용법

각 ClearQuest 전체 텍스트 검색 배치에는 고유의 WebSphere Application Server 프로파일이 있어야 하고, 각 ClearQuest 전체 텍스트 검색 사용 사용자 데이터베이스에 대해 하나의 WebSphere Application Server 프로파일이 있습니다.

Windows 운영 체제 배치에 한해 매개변수 값이 Windows 서비스 상태를 구성합니다. 부트 시 디먼으로 시작하도록 WebSphere Application Server 프로파일을 구성해야 하는 UNIX 및 Linux 운영 체제에서는 이 값이 무시됩니다.

WebSphere Application Server 프로파일 이름은 데이터베이스 세트와 사용자 데이터베이스 이름을 통해 결정됩니다. 그러나 <ftsWASProfileName> 태그를 사용하여 이를 대체할 수 있습니다.

fts_was_profile_home 명령행 옵션을 사용하여 WebSphere Application Server 프로파일을 작성할 위치를 지정하십시오. 위치를 지정하지 않으면 %CLEARQUEST_HOME%/cqweb/ 기본 위치가 사용됩니다. 최상의 결과를 위해서는 고유 위치를 지정하십시오.

참고: ClearQuest 전체 텍스트 검색 배치에 기반하여 WebSphere Application Server 프로파일을 작성하여 사용자 정의할 수 있도록 이 명령행 옵션은 반드시 init_cq_fts 옵션과 함께 사용하십시오. 그렇지 않으면, 이 도구를 사용하여 이전에 WebSphere Application Server 프로파일을 작성하였고 현재 이를 재사용하는 경우가 아니면 배치에 실패합니다.
영향
이 명령행 옵션은 사용 가능한 다음 포트를 사용하여 WebSphere Application Server에 새 WebSphere Application Server 프로파일을 작성합니다. 오퍼레이션 완료 시 사용되는 디스크 공간은 약 200MB입니다. Windows에서 프로파일이 자동으로 설정된 경우 Windows가 다시 시작되면 서비스가 자동으로 시작됩니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
두 번째 사용자 데이터베이스에 대해 전체 텍스트 검색을 배치하려 계획합니다. 데이터베이스 세트의 이름은 MASTR이고 사용자 데이터베이스 이름은 SAMPL입니다.
  1. 다음 명령을 실행하여 초기 배치를 설정합니다.

    cqperl cqtsadmin.pl --username admin --password "" --dbset MASTR --userdb SAMPL --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile automatic --fts_was_profile_home D:\FTS.WASprofiles

  2. 엔티티 파일을 수정하여 관심 있는 레코드 유형과 필드만 포함시킵니다.
  3. 다음 명령을 실행하여 배치를 완료합니다.

    cqperl cqtsadmin.pl --username admin --password "" --dbset MASTR --userdb SAMPL --ftshome D:\CQ.Search --setup_cq_fts

cust_fts_files
요약
사용자 데이터베이스, 엔티티 파일, 전체 텍스트 검색 관리자 구성 파일에 기반하여 ClearQuest 전체 텍스트 검색 특성 XML 파일을 사용자 정의합니다. ClearQuest 전체 텍스트 검색을 처음 배치하는 경우 전체 텍스트 검색 특성 파일 CQ-dbset-userdb.xml을 사용자 정의해야 합니다.
사용법
기본 전체 텍스트 검색 템플리트에는 사용자 데이터베이스에 따라 사용자 정의하는 일반 설정이 포함되어 있습니다. 반드시 사용자 정의해야 하는 한 파일이 전체 텍스트 검색 특성 XML 파일입니다. 이 파일에는 엔티티 파일에 지정된 내용을 토대로 모든 레코드 유형의 목록과 이의 필드가 저장되어 있습니다. 또한 이 파일에는 표시 필드로 사용할 필드, ClearQuest 사용자 데이터베이스에서 변경을 확인하는 빈도, ClearQuest 데이터베이스 및 서버와 통신하는 방법과 같은 매개변수도 포함되어 있습니다. 일반적으로 setup_cq_fts 명령행 옵션을 실행할 때 이 옵션이 호출되므로 이 명령행 옵션을 직접 사용할 필요는 없습니다. 배치를 미세 조정하거나 디버그해야 하는 경우 이 명령행 옵션이 제공됩니다.
영향
배치에서 이 명령행 옵션을 사용하는 경우 이는 CQ-dbset-userdb.xml 파일을 겹쳐씁니다. 수동이든 명령 실행에 따른 것이든 파일에 대한 모든 변경사항은 유실됩니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
IBM 소프트웨어 지원 센터에서 전체 텍스트 검색 배치 문제를 디버그하거나 배치를 사용자 정의하도록 요청합니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --cust_fts_files

cust_solr_files
요약
ClearQuest 전체 텍스트 검색을 처음으로 배치하는 경우 현재의 ClearQuest 엔티티 파일에 기반하여 Solr 스키마 파일을 사용자 정의해야 합니다.
사용법
기본 전체 텍스트 검색 템플리트에는 사용자 데이터베이스에 따라 사용자 정의해야 하는 일반 기본 설정이 포함되어 있습니다. 반드시 사용자 정의해야 하는 한 파일은 Solr schema.xml 파일입니다. 이 파일에는 엔티티 파일을 사용하여 검색하도록 설정한 모든 레코드 유형의 필드가 모두 포함되어 있습니다. 일반적으로 setup_cq_fts 명령행 옵션을 실행할 때 이 옵션이 호출되므로 이 명령행 옵션을 직접 사용할 필요는 없습니다. 배치를 미세 조정하거나 디버그해야 하는 경우 이 명령행 옵션이 제공됩니다.
영향
이 명령행 옵션은 엔티티 파일의 데이터를 읽고 Solr schema.xml 파일을 사용자 정의합니다. 기존 배치에서 이 옵션을 사용하는 경우 schema.xml 파일이 리팩토링됩니다. 처음 배치한 후 엔티티 파일을 변경한 경우 이전 값이 유실됩니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
IBM 소프트웨어 지원 센터에서 전체 텍스트 검색 배치 문제를 디버그하거나 배치를 사용자 정의하도록 요청합니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --cust_solr_files

delete_fts_was_profile
요약
WebSphere Application Server 프로파일을 삭제하거나 다시 시작하려면 이 명령행 옵셩을 실행하십시오. 이 명령행 옵션은 이 ClearQuest 전체 텍스트 검색 배치와 연관된 ClearQuest 전체 텍스트 검색 WebSphere Application Server 프로파일을 삭제합니다. 이 옵션은 WebSphere Application Server 프로파일만 삭제된다는 점에서 archive_fts와 다릅니다. 그러나 전체 텍스트 검색 홈 디렉토리 및 연관된 메타데이터는 제거되지 않습니다. ClearQuest 전체 텍스트 검색 배치를 완전히 제거하려면 archive_fts 옵션을 대신 사용하십시오.
사용법
일반적으로 archive_fts 명령행 옵션을 실행할 때 호출되므로 이 명령을 직접 사용하지는 마십시오. 배치를 미세 조정하거나 디버그해야 하는 경우 이 명령이 제공됩니다.
영향
WebSphere Application Server 프로파일을 위해 WebSphere에서 사용하는 자원이 해제됩니다. disable_cqweb_fts 명령행 옵션을 사용하여 ClearQuest Web 전체 텍스트 검색을 사용 불가능하게 하지 않으면 전체 텍스트 검색에 오류가 발생합니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
WebSphere Application Server 프로파일의 이름을 바꾸거나 위치를 변경해야 하지만 전체 텍스트 검색 솔루션을 완전히 재배치하지는 않습니다.
  1. WebSphere Application Server 프로파일을 삭제합니다.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --delete_fts_was_profile

  2. cqtsadmin-dbset-userdb.xml 파일을 편집하고 <ftsWASProfileName> 태그를 자동 생성되는 기본 이름에서 WebSphere Application Server 프로파일의 새 이름으로 변경하십시오. 이름은 고유해야 합니다. 그렇지 않으면 명령이 실패합니다.
  3. WebSphere Application Server 프로파일을 재작성합니다.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --create_fts_was_profile automatic --fts_was_profile_home D:\FTS.WASprofiles

  4. 또한 이 WebSphere Application Server 프로파일의 포트 번호를 변경하려 한 경우 위의 3단계 이전에 cqtsadmin-dbset-userdb.xml 파일을 편집하고 <ftsWASProfilePort> 태그에서 포트 번호를 업데이트하십시오. 또는 다음 명령을 실행하여 포트를 재정의합니다.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --create_fts_was_profile automatic --fts_was_profile_home D:\FTS.WASprofiles --was_profile_ports_file D:\CQ.Search\TextSearch_SAMPL\cqftsportdef.props

disable_cqweb_fts
요약
이 명령행 옵션은 ClearQuest Web에서 전체 텍스트 단일 선택 단추를 사용 불가능하게 하고 복제되지 않은 ClearQuest 사용자 데이터베이스에서 레코딩 오퍼레이션 로그(oplogs)를 중지합니다. 이 명령행 옵션은 복제된 환경의 oplogs 작성에는 영향을 미치지 않습니다.
주의: 이 명령행 옵션은 주의하여 사용하십시오. ClearQuest 데이터베이스가 복제되지 않은 경우 oplog 레코딩을 사용 불가능하게 합니다. oplogs가 생성되지 않은 시점에 ClearQuest 레코드가 변경되는 경우 변경된 레코드가 재색인화되지 않습니다. 전체 사용자 데이터베이스에 대해 재색인화를 수행해야 합니다. 전체 텍스트 검색 기능이 다시 사용 가능해질 때까지 사용자가 ClearQuest에 액세스하지 못하게 차단하거나 읽기 전용 오퍼레이션만 허용하십시오.
사용법
테스트 환경이거나 IBM 소프트웨어 지원 센터에서 지시한 경우가 아니면 이 명령을 사용하면 안 됩니다.
영향
데이터베이스가 복제되지 않은 경우 Oplog 생성이 중지되고 전체 텍스트 단일 선택 단추가 사용 불가능해집니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
IBM Rational Client Support에서 문제 해결을 위해 전체 텍스트 검색을 사용 불가능하게 하도록 지시합니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --disable_cqweb_fts

enable_cqweb_fts
요약
ClearQuest Web에서 전체 텍스트 단일 선택 단추를 사용 가능하게 합니다. ClearQuest 데이터베이스가 복제되지 않았고 기늘 레벨 7에 있는 경우 oplog 생성도 가능하게 됩니다. ClearQuest 사용자 데이터베이스가 복제된 경우 oplog 생성에 변화가 없습니다. 배치가 올바로 구성되지 않은 경우 전체 텍스트 검색을 사용하려는 사용자에게 오류 메시지가 수신됩니다.
사용법
테스트 환경이거나 IBM 소프트웨어 지원 센터에서 지시한 경우가 아니면 이 명령을 사용하면 안 됩니다.
영향
데이터베이스가 복제되지 않았고 기능 레벨 7에 있는 경우 oplog 생성이 시작됩니다. ClearQuest Web의 전체 텍스트 단일 선택 단추가 사용 가능하게 됩니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
IBM 소프트웨어 지원 센터에서 문제 해결을 위해 전체 텍스트 검색을 사용 가능하게 하도록 지시합니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --enable_cqweb_fts

fresh_batch_idx
요약
이 명령행 옵션은 초기 색인화 이후 일괄처리 모드에서 전체 재색인화를 강제 실행합니다. 일괄처리 모드 색인화는 레코드의 데이터를 검색하여 색인화를 위해 검색 엔진(Solr)에 전송하도록 구성된 모든 ClearQuest 레코드를 읽는 프로세스입니다. 일괄처리 모드 색인화는 setup_cq_fts 명령행 옵션 실행 과정에서 수행됩니다. 이 명령을 실행하기 전에 stop_update_idx 명령행 옵션을 실행하여 업데이트 모드 색인기를 중지하십시오. 그렇지 않으면 일괄처리 모드 색인기가 업데이트 모드 색인기에서 색인화한 최신 레코드의 데이터를 대체합니다. 재색인화가 완료되면 색인은 단편화됩니다. 일반적으로 이러한 단편화가 검색 성능에는 영향을 미치지 않습니다. 그러나 색인 크기는 현재 크기의 두 배까지 커질 수 있습니다. 색인을 최적화하고 이의 크기를 줄이려면 optimize_idx 명령행 옵션을 실행하십시오.
사용법
테스트 환경이거나 IBM 소프트웨어 지원 센터에서 지시한 경우가 아니면 이 명령을 사용할 필요가 없습니다.
영향
검색 색인이 업데이트됩니다. 크기가 현재 크기의 두 배까지 커질 수 있습니다. 따라서 이 명령을 사용하기 전에 디스크 공간이 충분한지 확인하십시오. 재색인화 중, 업데이트 모드 색인기가 사용 불가능하므로 검색 결과가 완료되지 않습니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
IBM 소프트웨어 지원 센터에서 검색 가능한 레코드를 완전히 재색인화하도록 지시합니다.
  1. 업데이트 모드 색인기를 중지합니다.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --stop_update_idx

  2. 일괄처리 모드 재색인화를 강제 실행합니다.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --fresh_batch_idx

  3. 색인 최적화를 실행합니다.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --optimize_idx

  4. 업데이트 모드 색인기를 사용 가능하게 합니다.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --start_update_idx

    참고: 이들 단계를 하나의 명령으로 결합할 수 있습니다. 다수의 레코드를 재색인화하는 경우 긴 시간이 소요되므로 이같이 결합할 수 있습니다.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search -- stop_update_idx --fresh_batch_idx --optimize_idx --start_update_id

fresh_update_idx
요약
업데이트 모드 색인기에 의해 기록된 모든 oplog 레코드 변경의 전체 재색인화를 강제 실행합니다. 이 옵션은 주의하여 사용하십시오. 업데이트 모드 색인기는 단일 스레드입니다. 특히 ClearQuest 데이터베이스에 다수의 oplog가 있는 경우 이 오퍼레이션에는 긴 시간이 소요됩니다.

업데이트 모드 색인은 검색을 위해 구성된 레코드 유형에 변경이 있는지 ClearQuest 데이터베이스를 모니터링하는 프로세스입니다. 모니터링은 ClearQuest 데이터베이스의 oplog를 확인하여 수행됩니다. 업데이트 모드 색인화는 setup_cq_fts 명령행 옵션의 파트로 사용됩니다. fresh_batch_idx 명령행 옵션과 달리 이 명령의 경우에는 업데이트 모드 색인기를 중지할 필요가 없습니다. 채워진 색인에 대해 이 명령이 완료되면 색인이 단편화됩니다. 일반적으로 이러한 단편화가 검색 성능에는 영향을 미치지 않습니다. 그러나 색인 크기는 현재 크기의 두 배까지 커질 수 있습니다. 색인을 최적화하고 이의 크기를 줄이려면 optimize_idx 명령행 옵션을 실행하십시오. 처음 기록된 oplog로부터 업데이트 모드 색인기를 시작할지 주의깊게 검토하십시오. 점차 ClearQuest 레코드에서 수행하는 모든 조치에 대해 oplog가 축적되므로 특히, oplog를 지속적으로 정리하지 않은 경우에는 처음 기록된 oplog를 색인화하지 않을 수 있습니다. 이 명령은 테스트 환경 및 IBM Rational Client Support와 함께 전체 텍스트 검색 배치 문제를 디버그하는 용도로 고안된 것입니다.

사용법
테스트 환경이거나 IBM 소프트웨어 지원 센터에서 지시한 경우가 아니면 이 명령을 사용하면 안 됩니다.
영향
검색 색인이 업데이트됩니다. 크기가 현재 크기의 두 배까지 커질 수 있습니다. 이 명령을 사용하기 전에 디스크 공간이 충분한지 확인하십시오.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
IBM 소프트웨어 지원 센터에서 업데이트 모드 색인기의 재색인화를 강제 실행하도록 지시합니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --fresh_update_idx

fts_was_profile_home destination
요약
이 명령행 옵션을 create_fts_was_profile 명령행 옵션과 함께 사용하면 ClearQuest 전체 텍스트 검색 배치의 WebSphere Application Server 프로파일이 작성되는 위치를 지정할 수 있습니다. 이 옵션을 생략하는 경우 ${CLEARQUEST_HOME}/cqweb/의 기본 위치가 사용됩니다. ClearQuest 설치 디렉토리에 작성되는 추가 파일이 설치 제거나 업그레이드 등으로 ClearQuest 설치를 방해할 수 있으므로 항상 기본 위치가 적합한 것은 아닙니다. 또한 이 명령행 옵션은 restore_was_profile 명령행 옵션과 함께 사용할 수도 있습니다. 전체 텍스트 검색 WebSphere Application Server 프로파일이 작성되는 원래 위치와 다른 위치를 지정할 수 있습니다.
사용법
ClearQuest 데이터베이스에 대한 ClearQuest 전체 텍스트 검색을 배치하고, 사용자 배치와 관련된 WebSphere 파일의 작성 및 저장에 기본 위치를 사용하지 않을 수 있습니다. 이 명령행 옵션을 create_fts_was_profile 명령행 옵션과 함께 사용하여 전체 텍스트 검색 WebSphere Application Server 프로파일을 작성할 위치를 지정할 수 있습니다. 한 시스템에 전체 텍스트 검색 배치가 둘 이상 있는 경우, WebSphere Application Server 프로파일이 모두 동일한 위치에 있도록 이들 배치에 대해 동일한 위치를 사용하십시오.
영향
디렉토리가 없는 경우에는 fts_was_profile_home 위치에 디렉토리가 작성됩니다. 여기에는 WebSphere Application Server 프로파일과 관련된 데이터가 포함되어 있습니다. 이 디렉토리 내에 서브디렉토리가 작성됩니다. 이는 WebSphere Application Server 프로파일 이름을 나타내어, cqsearchprofile_dbset_userdb 또는 cqfts_dbset_userdb가 됩니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 출력 오류가 있거나 드라이브 이름이 올바르지 않은 경우(예: 존재하지 않거나 Unix 또는 Linux 마운트 경로에 존재하지 않음)가 아니면 이 명령은 실패하지 않습니다.
예제
ClearQuest 전체 텍스트 검색을 배치해야 합니다. 이 때 WebSphere Application Server 프로파일의 기본 위치를 사용하지 않습니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile manual --fts_was_profile_home D:\FTS.WASprofiles

gather_diagnostic_data
요약
IBM 소프트웨어 지원 센터에서 잠재적인 ClearQuest 전체 텍스트 검색 문제를 진단할 때 도움이 되는 데이터를 수집합니다. 지원이 필요한 경우 이 진단 명령 옵션을 실행하고 이 명령 옵션을 통해 수집한 데이터를 지원 센터에 전송하십시오. 이 명령행 옵션은 ClearQuest 전체 텍스트 검색 배치에 대한 관련 데이터를 수집합니다. IBM 소프트웨어 지원 센터에 전송하도록 지시를 받은 디렉토리에 데이터가 복사됩니다. 데이터를 전송하기 전에 기밀 전보가 포함되지 않았는지 확인하십시오. 일반적으로 가장 민감한 데이터는 검색이 가능하게 한 레코드 유형 이름과 사용자 조직에서 제출한 검색어 히스토리입니다. 히스토리는 WebSphere Application Server 프로파일에 대해 WebSphere가 유지보수하는 로그입니다. 비밀번호는 출력이 화면이나 로그 파일로 전송될 때 별표로 변환됩니다. 절대 일반 텍스트로 저장되지 않습니다.
사용법
이 명령을 사용하면 전체 텍스트 검색의 문제를 진단할 수 있는 진단 데이터를 수집하여 IBM 소프트웨어 지원 센터에 전송할 수 있습니다.
영향
데이터나 구성 설정이 변경되지 않습니다. 사용자의 배치와 시간소인을 사용하여 새 디렉토리가 작성됩니다. 진단 데이터의 누적 크기는 배치에 있는 로그의 총 크기(주로 MB)에 따라 달라집니다. 실제 색인은 진단 데이터의 파트가 아닙니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
IBM 소프트웨어 지원 센터에서 전체 텍스트 검색 문제를 해결할 수 있도록 진단 데이터 전송을 지시합니다. 다음 명령은 진단 데이터를 작성하여 이를 D:\CQ.Search\TextSearch_SAMPL.Diag-time-stamp 파일에 저장합니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --gather_diagnostic_data

gen_entity_file
요약
이 명령행 옵션은 ClearQuest 데이터베이스에 제출할 수 있는 모든 레코드 유형이 포함되어 있는 엔티티 파일을 생성합니다. 기본적으로 엔티티 파일에는 ClearQuest 스키마의 모든 레코드 유형과 이의 필드가 모두 포함되어 있습니다. 또한 이 파일도 전체 텍스트 검색의 후보입니다. 색인화하려는 레코드 유형 및 연관된 필드만 선택하도록 파일을 사용자 정의할 수 있습니다. ClearQuest 사용자 데이터베이스에 전체 텍스트 검색을 처음으로 배치하는 경우 ClearQuest 사용자 데이터베이스 스키마가 참조하는 모든 레코드 유형과 이의 필드가 포함된 엔티티 파일이 있어야 합니다. 이 엔티티 파일은 전체 텍스트 검색 속성 XML 파일, Solr 중간 XML 파일, Solr schema.xml 파일을 생성하기 위한 입력으로 사용됩니다.
사용법
일반적으로 이 명령을 직접 사용할 필요는 없습니다. 이 명령은 init_cq_fts 명령행 옵션을 실행할 때 호출됩니다. 배치를 미세 조정하거나 디버그해야 하는 경우 이 명령이 제공됩니다.
영향
기존 배치에서 이 명령을 사용하는 경우 Entity-dbset-userdb.txt 파일이 겹쳐쓰이고 기존의 편집 내용이 유실됩니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
IBM Rational 소프트웨어 지원 센터에서 전체 텍스트 검색 배치 문제를 디버그하거나 배치를 사용자 정의하도록 지시했습니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --gen_entity_file

gen_fts_files
요약
이 명령행 옵션은 사용자 데이터베이스, 엔티티 파일, 전체 텍스트 검색 관리자 구성 파일에 기반하여 ClearQuest 전체 텍스트 검색 설정 파일을 생성합니다. 사용자 데이터베이스에 전체 텍스트 검색을 처음으로 배치하는 경우 전체 텍스트 검색 특성 XML 파일을 생성해야 합니다. 이 파일에는 색인화 빈도, 색인화의 일괄처리 크기, 검색 서버 정보 등 배치 설정에 대한 정보가 저장됩니다.
사용법
일반적으로 이 명령행 옵션을 직접 사용하지는 마십시오. 이 명령은 setup_cq_fts 명령행 옵션을 실행할 때 호출됩니다. 배치를 미세 조정하거나 디버그해야 하는 경우 이 명령행 옵션이 제공됩니다.
영향
기존 배치에서 이 명령을 사용하는 경우, Entity-dbset-userdb.txt, Solr-dbset-userdb.txtCQ-dbset-userdb.xml 파일이 겹쳐스이고 기존의 편집 내용이 유실됩니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
IBM Rational 소프트웨어 지원 센터에서 전체 텍스트 검색 배치 문제를 디버그하거나 배치를 사용자 정의하도록 지시했습니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --gen_fts_file

help
요약
도움말 텍스트를 표시한 후 닫습니다.
사용법
cqtsadmin.pl에는 친숙하지만 사용 가능한 명령을 잠깐 살펴봅니다.
영향
없습니다. 이 명령은 어떤 데이터도 변경하지 않고 인증을 실행할 필요도 없습니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
사용 가능한 명령 목록이 필요합니다.

cqperl cqtsadmin.pl --help

init_cq_fts
요약
ClearQuest 전체 텍스트 검색 기본 템플리트를 복사하여 기본 엔티티 파일을 생성합니다. 사실상 copy_fts_template 옵션과 gen_entity_file 옵션을 모두 실행합니다. 이 명령은 전체 텍스트 검색을 배치할 때 실행하는 첫 번째 명령 중 하나입니다. ftshome 디렉토리에 dbset_userdb 디렉토리를 작성합니다. 이 배치와 관련되는 모든 기본 데이터와 설정이 이 디렉토리에 저장됩니다. 이 옵션이 작성하는 키 파일 중 하나가 Entity-dbset-userdb.txt 엔티티 파일입니다. 이 파일은 ftshome 디렉토리에 저장됩니다. 배치를 사용자 정의하는 경우 배치를 그대로 둘 것인지, 검색하지 않을 레코드 유형과 필드를 제거할지 여부를 결정하십시오. 작성되는 또 다른 파일은 cqftsadmin-dbset-userdb.xml 검색 관리자 구성 파일입니다. 이 파일에는 사용자의 배치와 환경에 고유한 추가적인 기본 설정(예: 서버 이름, WebSphere Application Server 프로파일 이름, 색인 일괄처리 크기, 색인 빈도)이 저장됩니다.
참고: 보통 이 명령행 옵션은 create_fts_was_profilefts_was_profile_home 명령행 옵션과 함께 실행되어 이 배치에 대한 새 WebSphere Application Server 프로파일을 작성합니다. 그렇지 않으면, 이전에 텍스트 검색을 위해 배치했던 WebSphere Application Server 프로파일을 재사용하는 경우가 아니면 ClearQuest 전체 텍스트 검색 배치가 실패합니다.
사용법
이 명령을 사용하여 전체 텍스트 검색 배치를 미리 구성할 수 있습니다. 이 명령은 ftshome 디렉토리를 작성하고 기본 파일을 여기에 복사하며 기본값을 설정합니다. 일반적으로 배치를 완료하기 전에 엔티티 파일을 사용자 정의합니다.
영향
이 명령은 아직 존재하지 않는 경우 새 ftshome 디렉토리를 작성하고 사용자 배치의 기본 데이터와 설정을 여기에 복사합니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
사용자 데이터베이스 중 하나에서 새로운 전체 텍스트 검색 배치를 시작합니다.
  1. 다음 명령을 실행하여 배치를 미리 구성합니다.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile Automatic --fts_was_profile_home D:\CQFTS.WASprofiles

  2. 다음 배치 엔티티 파일을 편집하여 사용자가 검색하면 안 되는 레코드 유형이나 필드를 제거합니다. 또한 각 레코드 유형의 필드 앞에 앰퍼샌드(&)를 추가합니다. 그러면 이것이 전체 텍스트 검색의 히트 결과 세트에서 표시 필드가 됩니다.

    D:\CQ.Search\TextSerch_SAMPL\Entity-TextSearch-SAMPL.txt

  3. 다음 명령을 실행하여 배치를 완료합니다.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --setup_cq_fts

lock_cq_fts
요약

이 명령행 옵션은 이 ClearQuest 전체 텍스트 검색 배치를 잠금하여 비파괴적 cqtsadmin.pl 명령만 실행할 수 있도록 합니다. gather_diagnostic_datahelp를 제외한 모든 명령이 사용 불가능합니다. 명령을 다시 사용하려면 unlock_cq_fts 옵션을 사용하십시오.

사용법
전체 텍스트 검색을 배치한 후 이 명령을 실행하여 배치를 잠금하면 부주의한 수정을 방지할 수 있습니다. 이러한 잠금은 약합니다. 올바른 파일 시스템 액세스 권한 또는 ClearQuest 권한이 있는 사람이면 누구나 배치를 잠금 해제할 수 있습니다. 이 명령의 목적은 관리자가 배치 완료를 신호로 알릴 수 있도록 하는 것입니다. 추가 수정은 충분히 검토한 후 주의하여 실행해야 합니다.
영향
없습니다. 전체 텍스트 검색 배치 데이터와 설정은 영향을 받지 않습니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
배치를 완료했고 배치가 수정되지 않았는지 확인하고자 합니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --lock_cq_fts

optimize_idx
요약

이 명령행 옵션은 색인의 단편화를 해제합니다. 최적화에는 최소한 현재 색인 크기의 1.5배 정도되는 디스크 여유 공간이 필요합니다. 예를 들어, 색인이 2GB의 디스크 공간을 사용하는 경우 명령을 실행하려면 3GB의 디스크 여유 공간이 있어야 합니다.

사용법

검색 색인에서 레코드를 추하거나 수정하면 색인이 단편화될 수 있습니다. 단편화된 색인은 단편화되지 않은 색인보다 커지는 경향이 있습니다. 또한 약간의 성능 저하도 보일 수 있습니다. 색인 크기를 줄이고 성능을 복원하려면 일 년에 한 번은 색인을 최적화하십시오. 레코드 수정, 추가 또는 삭제 등 ClearQuest 데이터베이스의 활동이 과도한 경우 더 자주 최적화하십시오.

이 명령을 실행하기 전에 디스크 여유 공간이 충분한지 확인하십시오. 그렇지 않으면 최적화에 실패할 수 있지만 원본 색인은 영향을 받지 않습니다. 최적화 중에 원본 색인이 다시 쓰여지므로 디스크 여유 공간이 필요합니다. 이전 색인이 새 색인이 재생성될 때까지 보관됩니다.

색인을 최적화하는 데 필요한 시간은 색인의 크기, 하드 드라이브 및 입출력 속도에 따라 달라질 수 있습니다. 2GB 색인의 경우 최적화에는 몇 시간이 소요될 수 있습니다. 최적화가 진행 중인 동안에는 업데이트 모드 색인기 등 모든 전체 텍스트 검색 서비스를 사용할 수 있습니다. 그러나 약간의 성능 저하가 있을 수 있습니다. 색인 최적화는 피크 시간대를 피하여 계획하십시오.

영향
검색 색인이 다시 쓰여집니다. 최적화 중에 입출력 오류가 발생하면 디스크 공간이 충분하지 않은 것이 가장 큰 원인입니다. 원본 색인은 영향을 받지 않습니다. 원본 색인이 더 커질 수 있지만 최적화가 완료되면 원래 크기로 돌아갑니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
검색 색인을 최적화해야 합니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --optimize_idx

prep_upgd_was_profiles destination
요약
이 명령 옵션은 스케줄된 작동 중단 시간 중에 ClearQuest 수정이나 재설치를 준비합니다. 이 명령이 작성하는 백업을 사용하여 WebSphere Application Server 프로파일을 포함하는 전체 텍스트 검색 배치를 원래 상태로 복원할 수 있습니다.
사용법

전체 텍스트 검색을 사용하여 배치된 모든 사용자 데이터베이스에는 해당하는 WebSphere Application Server 프로파일이 있어야 합니다. ClearQuest를 업그레이드, 수정 또는 재설치하는 경우 이 프로파일이 유지되지 않습니다. ClearQuest 수정팩에 제공되는 업데이트는 이 준비 및 복원 프로시저를 통해 ClearQuest 전체 텍스트 검색 배치에 통합할 수 있습니다. 이 명령행 옵션을 restore_was_profiles 명령행 옵션과 함께 사용하면 백업 데이터가 작성되고 선택적으로 WebSphere Application Server 프로파일이 삭제된 다음, ClearQuest의 업그레이드나 재설치가 완료된 후 호출 시 지정된 백업 데이터 경로를 사용하여 삭제된 WebSphere Application Server 프로파일이 복원됩니다.

ClearQuest WebSphere Application Server 프로파일을 삭제하려면 하나의 cqtsadmin-dbset-userdb.xml 전체 텍스트 검색 관리자 구성 파일에 대해 <deleteFtsWASProfiles> 태그 값을 FALSE에서 TRUE로 변경해야 합니다. 명령을 실행할 때 이 수정된 배치를 참조해야 합니다. 그렇지 않으면 복원과 업그레이드 준비 시 WebSphere Application Server 프로파일이 올바로 제거되지 않습니다.

이 명령행 옵션은 모든 dbset, userdb 또는 ftshome에서 실행할 수 있습니다. 옵션은 특정한 전체 텍스트 검색 배치와 연관되지 않습니다. 호스트에 있는 임의의 ftshome 디렉토리에서 모든 ClearQuest 전체 텍스트 검색 배치를 평가하고 영향을 줍니다.
참고: 현재 시스템에 전체 텍스트 검색 배치가 둘 이상 있는 경우, 이 명령행 옵션과 restore_was_profiles 명령행 옵션을 한 번만 실행해야 합니다. 이들 두 명령은 현재 시스템의 모든 전체 텍스트 검색 배치에서 글로벌하게 작용합니다.
주의: ClearQuest를 업그레이드하는 경우 <deleteFtsWASProfiles> 태그를 TRUE로 설정해 두고 이 명령행 옵션을 실행해야 합니다. 그렇지 않으면 전체 텍스트 검색 배치의 업그레이드가 완료되지 않습니다. 업그레이드가 완료되고 restore_was_profiles 명령행 옵션을 실행한 후 이 옵션을 FALSE로 변경하십시오.
영향
하나의 cqtsadmin-dbset-userdb.xml 전체 텍스트 검색 관리자 구성 파일에 대해 <deleteFtsWASProfiles> 태그가 TRUE로 설정되는 경우 ClearQuest 전체 텍스트 검색 WebSphere Application Server 프로파일의 백업 데이터가 작성되고 이 WebSphere Application Server 프로파일은 삭제됩니다. 프로파일이 복원될 때까지 전체 텍스트 검색 요청은 실패합니다. 그러나 단일 선택 단추는 사용 가능 상태로 있고 복제되지 않은 기능 레벨 7 사용자 데이터베이스에 대해서는 oplogs 작성이 계속됩니다. 이 명령행 옵션을 사용하는 시점은 ClearQuest를 업그레이드, 수정 또는 재설치하는 때이므로 이러한 유형의 장애는 수용 가능합니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
ClearQuest를 업그레이드, 수정 또는 재설치하려 합니다. 설치를 시작하기 전에 이 호스트의 모든 WebSphere Application Server 프로파일을 백업해야 합니다.
  1. 단일 전체 텍스트 검색 배치의 cqtsadmin-dbset-userdb.xml 파일을 편집하고 <deleteFtsWASProfiles> XML 태그를 다음과 같이 변경하여 WebSphere Application Server 프로파일을 백업하고 삭제하도록 허용하십시오.

    <newValue required="no">true</newValue>

    변경사항을 저장하십시오. 이 예제에서는 cqtsadmin-TextSearch-SAMPL.xml 파일이 사용됩니다.

  2. 명령행 옵션을 실행하여 백업 데이터를 작성하고 WebSphere Application Server 프로파일을 삭제합니다.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --prep_upgd_was_profiles E:\FTSBackupWASProfiles

  3. <deleteFtsWASProfiles> XML 태그 값을 FALSE로 변경하거나 TRUE 값을 제거하십시오.
  4. ClearQuest 업그레이드, 전체 텍스트 검색 기능 수정 또는 재설치를 완료합니다.
  5. 명령행 옵션을 실행하여 모든 전체 텍스트 검색 배치와 삭제된 WebSphere Application Server 프로파일을 백업 데이터를 통해 복원합니다. 다음은 두 가지 가능한 시나리오입니다.
    • ClearQuest 8.0(전체 릴리스)의 경우, 원본 WebSphere Application Server 프로파일 홈 위치를 유지하고 이를 원래의 고유 위치에 복원합니다.

      cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --restore_was_profiles E:\FTSBackupWASProfiles

    • ClearQuest 8.0(전체 릴리스) 및 7.0(전체 릴리스)의 경우, 복원 시 모든 WebSphere Application Server 프로파일을 하나의 WebSphere Application Server 프로파일 홈 디렉토리에 통합합니다.

      cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --restore_was_profiles E:\FTSBackupWASProfiles --fts_was_profile_home D:\FTS.WASprofiles

  6. 문제가 발생하면 동일한 dbset, userdb, ftshome에서 gather_diagnostic_data 명령행 옵션을 실행하여 IBM Rational 지원 센터에 데이터를 제공하십시오.
주의: 영어 이외의 언어를 지원하기 위해 Solr schema.xml 파일을 사용자 정의한 경우 또는 Solr 분석기나 토크나이저(tokenizer)를 변경한 경우 변경사항이 유실됩니다. 변경을 유지하려면 변경사항을 저장하고 업그레이드가 완료된 후 이를 다시 적용하십시오. schema.xml 파일을 변경한 후 변경을 적용하려면 전체 텍스트 검색 WebSphere Application Server 프로파일을 중지한 후 시작하십시오.
remove_lucene_idx_lock
요약
이 명령을 사용하면 검색 색인에서 Lucene 잠금을 제거할 수 있습니다. Lucene 검색 엔진은 잠금을 사용하여 업데이트를 동기화합니다. 흔하지는 않지만 잠금이 되어 있고 Lucene 엔진이 이를 복구할 수 없는 경우 Lucene 또는 서버에 오류가 발생하면 잠금이 활성 상태를 유지합니다. 잠금이 활성인 동안에는 검색 색인을 업데이트할 수 없습니다. 따라서 ClearQuest 레코드를 추가하거나 업데이트할 수 없습니다. 색인의 무결성에 문제가 없다면 색인에 대한 전체 텍스트 검색은 계속 작동합니다. 이러한 유형의 잠금을 복구하려면 stop_fts_was_profilestart_fts_was_profile 명령행 옵션을 실행하여 WebSphere Application Server 프로파일을 다시 시작하십시오. 서비스가 다시 시작되는 동안에는 전체 텍스트 검색이 인터럽트됩니다.
사용법
새로 추가된 ClearQuest 레코드가 검색 결과에 포함되지 않는 것을 확인합니다. WebSphere Application Server 프로파일 로그를 검토하여 Lucene에서 색인 잠김 오류를 보고하는 것을 발견합니다. 잠금을 해제하려면 이 명령을 사용하십시오.
영향
없습니다. 전체 텍스트 검색 배치 데이터와 설정은 영향을 받지 않습니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
Lucene 색인 잠금을 제거하려 합니다. 한 단계에서 색인을 중지, 시작 및 잠금 해제합니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --stop_fts_was_profile --remove_lucene_idx_lock --start_fts_was_profile

remove_record_type
요약
이 명령은 검색 색인에서 하나 이상의 ClearQuest 레코드 유형을 제거합니다. 후속되는 검색에서는 제거된 레코드 유형에 대해 일치점을 찾지 않습니다. 이 명령은 cqtsadmin-dbset-userdb.xml 전체 텍스트 검색 관리자 구성 파일을 통해 제공해야 하는 데이터와 함께 사용됩니다. 구성 파일에서 제거할 레코드 유형 이름을 <removeRecordType> XML 태그에 나열하십시오. 여러 개의 레코드 유형을 제거하려면 세미콜론을 사용하여 이름을 구별하십시오.

이 명령은 여러 상태로 실행됩니다. 한 상태에서 오류가 발생하면 오류 메시지가 표시되어 오류 정정 방법을 설명합니다. 명령을 다시 시작하면 오류 발생 지점에서 다시 시작됩니다.

이 명령을 실행하기 전에 배치의 백업을 작성하십시오. 레코드 유형을 제거하면 해당 레코드 유형과 관련된 데이터만 검색 색인에서 제거됩니다. ClearQuest 자체는 이 명령의 영향을 받지 않습니다.

사용법
전체 텍스트 검색을 배치하고 나면 특정 레코드 유형에 대해 검색을 허용하지 않도록 요청받습니다. 이 명령은 이러한 레코드 유형을 색인에서 제거하여 이들 레코드 유형을 검색 불가능하게 만듭니다. 또 다른 명령 사용 방법은 색인화된 레코드 유형이 ClearQuest 스키마에서 변경된 경우입니다. 새 필드를 추가했거나 필드의 이름을 바꾸었을 가능성이 있습니다. 검색 색인에 이러한 변경을 반영하려면 remove_record_typeadd_record_type 명령행 옵션을 사용하십시오.
영향
검색 색인이 변경되어 제거된 레코드 유형에 대한 참조가 더 이상 존재하지 않습니다. 따라서 제거된 레코드 유형은 검색할 수 없습니다. 이러한 레코드 유형에 대한 참조는 전체 텍스트 검색 특성 XML 파일과 엔티티 파일에서 제거됩니다. 이 명령이 실행 중인 동안에는 WebSphere Application Server 프로파일이 다시 시작될 때 잠깐 검색 서비스가 인터럽트됩니다. 서버가 중단되었다는 오류가 사용자에게 표시될 수 있습니다. 명령이 완료된 후에도 ClearQuest 세션이 열려 있는 사용자의 경우에는 ClearQuest Web의 검색 범위에 제거된 레코드 유형이 계속 표시됩니다. 이러한 레코드 유형을 검색하려는 경우 일치점은 없습니다. 검색 범위에 검색 색인을 반영하려면 이들 사용자가 다시 로그인해야 합니다. 이 명령은 색인 단편화를 초래합니다. 이 명령을 실행한 후에는 색인을 최적화하여 색인 크기와 성능이 최적화하십시오.
Stateful 상태
명령은 Stateful합니다. 실행 지점 중 하나에서 명령이 실패하는 경우 문제를 정정하고 명령을 다시 실행할 수 있습니다. 실행이 중지된 위치에서 계속됩니다. 실패하는 경우 오류 메시지가 표시되어 수행 방법을 설명합니다.
예제
검색 색인에서 두 개의 레코드 유형을 제거해야 합니다.
  1. cqtsadmin-TextSearch-SAMPL.xml 파일에서 제거할 레코드 유형을 <removeRecordType> XML 태그에 지정하십시오. 레코드 유형을 세미콜론으로 구분합니다.

    <newValue required="no">Email_Rule;Customer</newValue>

  2. 두 개의 레코드 유형을 제거하는 명령을 실행합니다.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --remove_record_type

  3. cqtsadmin-TextSearch-SAMPL.xml 파일에서 <removeRecordType> XML 태그에 추가한 두 개의 레코드 유형을 제거하십시오. 이러한 정리 태스크는 제거한 레코드 유형을 차후에 추가하는 경우 실수로 이를 제거하는 일이 없도록 해줍니다.
repair_records
요약
일괄처리 모드 또는 업데이트 모드 색인화 프로세스에 레코드 읽기를 방해하거나 색인화를 위한 서버로의 레코드 전송을 방해하는 문제가 있는 경우 복구 파일이 작성됩니다. 복구 파일은 실패한 레코드의 ClearQuest 레코드 ID를 나열합니다. 이 명령은 복구 파일을 읽고 또 다른 실패 가능성을 줄이기 위해 한 번에 한 개의 레코드를 재색인화합니다.
사용법
일괄처리 색인화가 색인화되지 않은 레코드의 색인화를 완료하면 전체 텍스트 검색 배치의 일부로 이 명령을 실행하십시오. 업데이트 모드 색인화 중에 색인화되지 않은 레코드가 있는지 정기적으로 ftshome 디렉토리를 확인해야 합니다. 레코드가 색인화되지 않은 경우 record-type-nametime-stamp.xml과 같은 이름 지정 규칙의 파일이 표시됩니다. 다음 예제는 색인화되지 않은 Defect1222923990646.xml 파일을 보여줍니다. 이러한 유형의 파일이 표시되면 이 명령을 실행하여 레코드를 색인화하십시오.
영향
검색 색인에 새로 색인화된 레코드의 데이터가 포함됩니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
일괄처리 색인화 또는 업데이트 색인화 중에 색인화되지 않은 레코드를 색인화해야 합니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --repair_records

restore_was_profiles path-to-backup
요약
이 명령행 옵션을 사용하면 prep_upgd_was_profiles 명령행 옵션을 사용하여 작성한 백업 데이터로 ClearQuest 전체 텍스트 검색 WebSphere Application Server 프로파일을 복원할 수 있습니다.
사용법
ClearQuest를 업그레이드, 수정 또는 설치 제거하는 경우 WebSphere Application Server 프로파일이 유지되지 않습니다. ClearQuest 수정팩을 적용한 후 전체 텍스트 검색 수정사항을 현재의 WebSphere Application Server 프로파일에 통합해야 합니다. 이 모든 과정이 prepare-restore 프로시저를 통해 처리됩니다. ClearQuest를 업그레이드, 수정 또는 재설치하고 나면, 이 명령행 옵션은 prep_upgd_was_profiles 명령행 옵션을 사용하여 작성한 모든 ClearQuest 전체 텍스트 검색 WebSphere Application Server 프로파일을 복원합니다.

이미 존재하거나, prep_upgd_was_profiles 명령행 옵션을 사용하여 먼저 백업하고 삭제하지 않은 ClearQuest 전체 텍스트 검색 WebSphere Application Server 프로파일을 복원하는 경우 이 명령행 옵션이 실패합니다.

모든 dbset, userdb 또는 ftshome에서 이 명령행 옵션을 실행할 수 있습니다. 이는 이 호스트의 모든 WebSphere Application Server 프로파일에 있는 전체 텍스트 검색 배치와 WebSphere Application Server 프로파일에 영향을 줍니다.
참고: 이 명령행 옵션을 fts_was_profile_home 명령행 옵션과 함께 사용하면 원래 대상과 견주어 WebSphere Application Server 프로파일의 통합된 새 대상을 지정할 수 있습니다. ClearQuest 7.0(전체 릴리스)에서 업그레이드하는 경우 새 WebSphere Application Server 프로파일 홈이 사용되게 하려면 이 스위치를 사용하십시오.
영향
전체 텍스트 검색 WebSphere Application Server 프로파일이 재작성되어 원래 설정과 위치로 복원되거나 지정된 fts_was_profile_home 디렉토리 경로에 통합됩니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
ClearQuest의 업그레이드 준비 중에 <deleteFtsWASProfiles> 태그를 TRUE로 설정해 두고 prep_upgd_was_profiles 명령행 옵션을 실행했습니다. ClearQuest를 업그레이드한 후 백업 데이터를 사용하여 모든 ClearQuest 전체 텍스트 검색 WebSphere Application Server 프로파일을 복원해야 합니다. 또한 fts_was_profile_home 명령행 옵션을 사용하여 WebSphere Application Server 프로파일을 새 디렉토리에 통합할 수 있습니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --restore_was_profiles E:\FTSBackupWASProfiles [ --fts_was_profile_home D:\FTS.WASprofiles ]

주의: 영어 이외의 언어를 지원하기 위해 Solr schema.xml 파일을 사용자 정의한 경우 또는 Solr 분석기나 토크나이저(tokenizer)를 변경한 경우 변경사항이 유실됩니다. 변경을 유지하려면 변경사항을 저장하고 업그레이드가 완료된 후 이를 다시 적용하십시오. schema.xml 파일을 변경한 후 변경을 적용하려면 전체 텍스트 검색 WebSphere Application Server 프로파일을 중지한 후 시작하십시오.
run_batch_idx
요약
이 명령은 일괄처리 모드 색인기를 시작합니다. 검색을 위해 구성한 모든 ClearQuest 레코드를 색인화합니다.

일괄처리 크기나 스레드 수가 너무 큰 경우 또는 ClearQuest 레코드의 데이터 양이 너무 많은 경우 이 명령이 실패할 수 있습니다. 가장 일반적인 장애는 메모리 부족 오류입니다. 이 경우 일괄처리 크기나 사용되는 스레드 수를 줄이십시오. 결과적으로 색인화 시간이 증가됩니다. 또는 <batchIndexJVMParm> XML 태그를 사용하여 일괄처리 모드 색인기의 JVM(Java™ Virtual Machine) 메모리를 늘리고 <ftsWASProfileMaxHeapSize> XML 태그를 사용하여 검색 서버의 메모리를 늘릴 수 있습니다. 이는 메모리를 늘려야 하는 경우 일괄처리 색인기가 완료될 때까지의 임시 요구사항입니다. 이 경우 IBM Rational 고객 지원 센터의 도움을 받아 최적의 조치를 판별할 수 있습니다. 명령이 완료 전에 중지되는 경우 명령을 다시 시작할 수 있습니다. 중지된 위치에서 실행이 재개됩니다.

사용법
이 명령을 직접 사용할 필요는 없습니다. 이 명령은 setup_cq_fts 명령행 옵션을 실행할 때 호출됩니다. 배치를 미세 조정하거나 디버그해야 하는 경우 이 명령이 제공됩니다.
영향
이 명령은 ClearQuest 데이터베이스에 대해 ClearQuest SQL 조회를 실행합니다. 그런 다음 발견한 레코드를 색인화를 위해 Solr 검색 서버로 전송합니다. 사실상 이 명령이 실행되는 중에 ClearQuest 데이터베이스 서버는 ClearQuest 전체 텍스트 검색에 데이터를 전송하고 사용자의 검색 색인은 업데이트됩니다. 이 명령을 실행해야 하는 경우에는 데이터베이스 서버의 성능에 미치는 영향이나 로드를 줄일 수 있도록 피크 시간대를 피해 실행하십시오.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류, 메모리 부족 오류 또는 예기치 않은 구성 오류가 발생하는 경우가 아니면 이 명령은 실패하지 않습니다.
예제
모든 ClearQuest 레코드를 색인화해야 합니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --run_batch_idx

scrub_oplog before-date
요약
이 명령은 복제되지 않은 ClearQuest 사용자 데이터베이스에서 oplog를 삭제하는 데 사용됩니다. ClearQuest는 레코드에 대한 변경을 추적하는 oplog를 생성합니다. ClearQuest 전체 텍스트 검색에서는 업데이트 모드 색인화 중에 oplog를 모니터링하여 검색 색인을 이러한 변경사항과 동기화합니다.

Oplog는 임시 데이터입니다. 이를 무한정 보관할 필요는 없습니다. 복제되지 않은 데이터베이스에서 oplog가 계속 커지는 것을 방지하려면 가끔 이전 oplog를 삭제하십시오. oplog 작성 비율에 따라 삭제 빈도를 정하십시오.

ClearQuest 사용자 데이터베이스가 복제된 경우 oplog 삭제 정책과 복제 도구를 사용하십시오. 복제된 데이터베이스에서 이 명령을 사용하는 경우 명령이 실패하고 복제 도구를 사용하도록 지시하는 오류 메시지가 표시됩니다.

특히 업데이트 모드 색인기가 아직 처리하지 않은 oplog가 있는 경우 절대 전체 oplog를 삭제하지 마십시오. 그렇지 않으면 검색 색인이 ClearQuest 레코드와 동기화되지 않습니다. 검색이 정확하거나 완전하지 않을 수 있습니다. 이 시나리오에는 일괄처리 모드 재색인화가 필요합니다.

업데이트 모드 색인기 처리량이 충분하지 않은 상황에서 공격적으로 oplog를 삭제하면 색인이 부정확하거나 히트 수가 누락될 수 있습니다. 업데이트 모드 색인기가 최신인지 확인하고 한 달 이상된 oplog만 삭제하거나 oplog를 삭제하지 마십시오.

사용법
데이터베이스 공간을 절약하고 사용하지 않는 데이터를 정리하려면 복제되지 않은 ClearQuest 사용자 데이터베이스에서 oplog를 삭제해야 합니다. ClearQuest 데이터베이스가 복제된 경우에는 이 명령을 사용하지 마십시오.
영향
지정된 날짜 이전에 작성된 oplog 테이블의 ClearQuest oplog가 삭제됩니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
ClearQuest 관리자 자격으로 오래된 oplog를 정기적으로 삭제합니다. 지원되는 날짜 형식은 scruboplog 명령 참조서에서 확인할 수 있습니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --scrub_oplog "31-Oct-2009"

setup_cq_fts
요약
이 명령은 전체 텍스트 검색 배치를 완료하는 데 사용됩니다. 첫 번째로, 이 옵션은 전체 텍스트 검색 관리자 구성 파일, ClearQuest 데이터베이스, 운영 체제에 기반하여 다음 파일을 사용자 정의하고 구성합니다.
  • 엔티티 파일
  • 전체 텍스트 검색 특성 XML 파일
  • Solr schema.xml 파일
두 번째로, 전체 텍스트 단일 선택 단추를 사용 가능하게 하여 ClearQuest Web에서 ClearQuest 전체 텍스트 검색을 사용 가능하게 합니다. ClearQuest 데이터베이스가 기능 레벨 7이고 복제되지 않은 경우 oplog 생성이 시작됩니다. 세 번째로, 엔티티 파일에서 검색으로 설정한 레코드 유형에 대해 모든 ClearQuest 레코드를 색인화하여 일괄처리 모드 색인화를 시작합니다. 마지막으로 업데이트 모드 색인화를 사용 가능하게 하고 이것으로 배치가 완료됩니다.

이 명령은 이의 상태를 유지합니다. 완료 전에 오류가 발생하는 경우 상태가 설정되며 오류를 정정한 후 계속할 수 있습니다. 오류 메시지와 로그에는 오류 복구 방법을 알려주는 지시사항이 포함되어 있습니다. 복구 단계는 오류와 오류가 발생한 상태에 따라 다릅니다.

사용법
이 명령을 사용하여 전체 텍스트 검색 배치를 완료할 수 있습니다. 일반적으로 엔티티 파일을 사용자 정의한 후 이 명령을 실행하십시오. 이 명령이 실행되는 동안 ClearQuest Web에서 전체 텍스트 단일 선택 단추가 사용 가능합니다. 다시 로그인한 사용자는 검색을 수행할 수 있습니다. 검색 결과는 배치가 완료될 때까지 완료되지 않습니다. 특히 ClearQuest 데이터베이스가 복제되지 않은 경우에는 일괄처리 모드 색인화 중과 색인화 후에 발생하는 모든 레코드 변경사항을 캡처하는 oplog를 생성해야 하므로 단일 선택 단추가 사용 가능해야 합니다.

일괄처리 모드 색인화는 프로세스, 입출력 및 메모리에 크게 의존하므로 기본 JVM 메모리 설정을 늘리는 경우 전체 텍스트 검색을 배치하는 컴퓨터의 활용도가 과다해질 수 있습니다. 일괄처리 크기와 스레드 수를 늘려 일괄처리 모드 색인기를 설정하는 정도에 따라, 일괄처리 모드 색인화 중에 ClearQuest 데이터베이스의 활용도가 높아질 수 있습니다.

영향
ftshome 디렉토리에 여러 개의 파일이 작성됩니다. 색인이 작성됩니다. WebSphere Application Server에서 검색 서비스가 사용 가능합니다. 또한 ClearQuest 데이터베이스가 업데이트되어 전체 텍스트 검색 특성 XML 파일을 포함합니다. ClearQuest 데이터베이스가 복제되지 않은 경우 oplogs 작성이 사용 가능합니다. 복제된 ClearQuest 사용자 데이터베이스가 oplogs 작성을 계속합니다.
Stateful 상태
명령은 Stateful합니다. 실행 지점 중 하나에서 명령이 실패하는 경우 문제를 해결하고 명령을 다시 실행할 수 있습니다. 중지된 위치에서 명령이 계속 실행됩니다. 실패하는 경우 오류 메시지가 표시되어 수행할 작업을 알려줍니다. 완료 전에 오류가 발생하는 경우 상태가 설정되며 오류를 정정한 후 계속할 수 있습니다. 오류 메시지와 로그에는 오류 복구 방법을 알려주는 지시사항이 포함되어 있습니다. 복구 단계는 오류와 오류가 발생한 상태에 따라 다릅니다.
예제
init_cq_fts 명령행 옵션을 실행했고 엔티티 파일을 편집했습니다. 이제 배치를 완료해야 합니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --setup_cq_fts

set_was_max_mem
요약
이 명령은 WebSphere Application Server 프로파일이 사용할 수 있는 최대 JVM 메모리를 설정하는 데 사용됩니다. 기본값은 300MB이며 다음 상황에서 일괄처리 모드 색인화에는 많이 부족합니다.
  • 일괄처리 크기가 증가했습니다.
  • 스레드 수가 증가했습니다.
  • ClearQuest 레코드 유형이 복합적입니다.

이 명령은 구성 파일의 <ftsWASProfileMaxHeapSize> XML 태그에서 메모리 설정을 읽습니다. 그런 다음 JVM 메모리를 이 값으로 설정합니다.

사용법
WebSphere Application Server 프로파일 서버가 메모리 부족 오류를 보고하여 일괄처리 모드 색인화에 실패하는 경우 메모리 설정이 너무 낮은 것이 원인입니다. 다음 중 한 가지 조치를 취하여 메모리 부족 오류를 복구하십시오.
  • 일괄처리 크기와 스레드 수를 줄여 색인화를 완료하는 데 드는 시간을 늘립니다.
  • 임시로 JVM 메모리를 늘립니다. 일반적으로 일괄처리 모드 색인화가 완료될 때까지는 JVM 최대 메모리를 더 크게 설정해야 합니다.
영향
WebSphere Application Server 프로파일에 대한 JVM 최대 메모리 설정이 새 값으로 변경됩니다. 사실상 더 많은 시스템 메모리가 WebSphere Application Server 프로파일에 할당됩니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
색인화 중에 WebSphere Application Server 프로파일로부터 메모리 부족 오류가 수신됩니다. 계속하려면 이 문제를 해결해야 합니다.
  1. cqtsadmin-TextSearch-SAMPL.xml 파일의 <ftsWASProfileMaxHeapSize> 태그에서 JVM 메모리를 1.5GB로 설정하십시오.

    <newValue required="no">1536</newValue>

  2. 다음 명령을 실행하여 JVM 메모리를 새로 설정합니다.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --set_was_max_mem

set_solr_home
요약
이 명령은 WebSphere Application Server에 Solr 홈 디렉토리를 설정하는 데 사용됩니다. 각 배치에는 고유의 schema.xml 구성 파일과 색인이 있습니다. Solr 홈 디렉토리를 정확하게 지정하지 않거나 잘못된 위치를 지정하는 경우 WebSphere Application Server 전체 텍스트 검색 프로파일이 시작되지 않습니다. WebSphere Application Server 전체 텍스트 검색 프로파일이 시작되지 않는 경우 %your-WAS-profile-home%/<cqfts>_<dbset>_<userdb>/logs/server1/logs/ 경로의 해당 전체 텍스트 검색 WebSphere Application Server 프로파일 로그 디렉토리에 오류가 로그됩니다.
사용법
이 명령을 직접 사용할 필요는 없습니다. 이 명령은 setup_cq_fts 명령행 옵션을 실행할 때 호출됩니다. 배치를 미세 조정하거나 디버그해야 하는 경우 이 명령이 제공됩니다.
영향
배치된 WebSphere Application Server 프로파일의 JVM 특성이 변경되어 Solr 홈 환경 변수가 설정됩니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
IBM Rational 소프트웨어 지원 센터에서 다음 명령을 사용하여 전체 텍스트 검색 배치 문제를 디버그하거나 배치를 사용자 정의하도록 지시했습니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --set_solr_home

show_scenarios [ID | all]
요약
이 명령은 시나리오 목록과 cqtsadmin.pl 도구의 사용 방법에 대한 예제를 표시하는 데 사용됩니다. 시나리오는 정보 센터에 나열된 시나리오의 압축 양식이며 전체 목록이 아니거나 일대일 매치가 안 될 수 있습니다.
사용법
이 명령행 옵션을 사용하여 cqtsadmin.pl 도구에 가장 빈번히 사용되는 시나리오 목록을 표시할 수 있습니다. 시나리오 ID와 헤드라인을 보려면 매개변수없이 명령을 실행하십시오. 시나리오의 전체 텍스트를 보려면 시나리오 ID 매개변수를 사용하여 명령을 실행하십시오. 각 시나리오에 ID, 헤드라인, 전체 텍스트 설명을 표시하여 시나리오의 전체 목록을 보려면 all 매개변수를 사용하여 명령을 실행하십시오.
영향
전체 텍스트 검색 배치 데이터와 설정은 영향을 받지 않습니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
cqtsadmn.pl 도구를 사용하여 태스크를 완료하려 했지만 사용 방법을 기억할 수 없습니다. 다음 명령행 옵션을 사용하여 시나리오 헤드라인과 ID를 나열할 수 있습니다. 그런 다음 전체 텍스트를 보려면 다음 명령을 다시 실행하여 관심 있는 시나리오의 ID를 전달하십시오.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --show_scenarios

start_fts_was_profile
요약
이 명령은 전체 텍스트 검색 WebSphere Application Server 프로파일 서비스를 시작하는 데 사용됩니다. 검색 요청을 처리하려면 전체 텍스트 검색 WebSphere Application Server 프로파일을 시작해야 합니다. 업데이트 모드 색인기가 새 레코드나 업데이트된 레코드에 대한 점검을 시작하고 색인화를 위해 이를 검색 엔진에 전송하기 위해서도 프로파일을 시작해야 합니다.
사용법
이 명령을 직접 사용할 필요는 없습니다. 이 명령은 setup_cq_fts 명령행 옵션을 실행할 때 호출됩니다. 배치를 미세 조정하거나 디버그해야 하는 경우 이 명령이 제공됩니다.
영향
전체 텍스트 검색 WebSphere Application Server 프로파일이 중지되면 이 명령이 시작되어 임시 메모리와 프로세스 자원을 활용합니다. 검색 서비스와 업데이트 모드 색인기가 사용 가능하게 되면 실행을 시작합니다. WebSphere Application Server 프로파일이 이미 시작된 경우에는 변화가 없습니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 설정 문제인 WebSphere Application Server 프로파일 시작 장애, 입출력(I/O) 오류 또는 Solr 서버 장애가 없으면 이 명령은 실패하지 않습니다.
예제
IBM 소프트웨어 지원 센터에서 검색 WebSphere Application Server 프로파일을 시작하도록 지시했습니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --start_fts_was_profile

start_update_idx
요약
이 명령은 WebSphere Application Server 프로파일에서 실행되는 업데이트 모드 색인기를 사용 가능하게 하고 시작하는 데 사용됩니다. 업데이트 모드 색인기는 ClearQuest 데이터베이스의 변경사항으로 검색 색인을 동기화합니다. 색인기는 oplog를 모니터링하여 색인화할 새 값을 찾습니다. 전체 텍스트 검색 관리자 구성 파일에서 <updateIndexDelay> XML 태그를 사용하여 색인의 동기화 빈도를 구성하십시오.
사용법
이 명령을 직접 사용할 필요는 없습니다. 이 명령은 setup_cq_fts 명령행 옵션을 실행할 때 호출됩니다. 배치를 미세 조정하거나 디버그해야 하는 경우 이 명령이 제공됩니다.
영향
업데이트 모드 색인기가 사용 가능하게 되고 시작됩니다. ClearQuest 레코드의 수정, 추가, 제거가 색인화되어 검색 결과에 표시됩니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 설정 문제인 WebSphere Application Server 프로파일 시작 장애, 입출력(I/O) 오류 또는 Solr 서버 장애가 없으면 이 명령은 실패하지 않습니다.
예제
IBM 소프트웨어 지원 센터에서 업데이트 색인기를 사용 가능하게 하도록 지시했습니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --start_update_idx

stop_fts_was_profile
요약
이 명령은 전체 텍스트 검색 WebSphere Application Server 프로파일 서비스를 중지하는 데 사용됩니다. WebSphere Application Server 프로파일이 중지되면 검색 서비스를 사용할 수 없게 되고 업데이트 모드 색인기가 ClearQuest 레코드에 대한 변경사항으로 검색 색인을 동기화하는 작업을 중지합니다.
사용법
이 명령을 직접 사용할 필요는 없습니다. 이 명령은 setup_cq_fts 명령행 옵션을 실행할 때 호출됩니다. 배치를 미세 조정하거나 디버그해야 하는 경우 이 명령이 제공됩니다.
영향
전체 텍스트 검색 WebSphere Application Server 프로파일이 중지되고 검색 서비스와 업데이트 색인화도 중지됩니다. WebSphere Application Server 프로파일이 사용하는 메모리와 프로세서도 해제됩니다. 검색 시 오류가 발생합니다.

ClearQuest Web에서 전체 텍스트 단일 선택 단추가 사용 가능 상태를 유지하는 한 oplog에는 메시지가 계속 수신됩니다. 이 때문에 WebSphere Application Server 프로파일이 다시 실행된 후에도 업데이트 모드 색인기가 이를 따라잡을 수 있습니다.

Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
IBM 소프트웨어 지원 센터에서 검색 WebSphere Application Server 프로파일을 중지하도록 지시했습니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --stop_fts_was_profile

stop_update_idx
요약
이 명령은 업데이트 모드 색인기를 사용 불가능하게 하고 중지하는 데 사용됩니다. 업데이트 모드 색인기가 중지되면 검색 서비스가 사용 가능하지만 업데이트 모드 색인화가 다시 사용 가능하게 되거나 재개될 때까지 ClearQuest 레코드에 대한 변경사항이 색인에 반영되지 않습니다. 따라서 검색 결과가 최신이 아니거나 정확하지 않습니다.
사용법
이 명령을 직접 사용할 필요는 없습니다. 이 명령은 setup_cq_ftsbackup_fts 명령행 옵션을 실행할 때 호출됩니다. 배치를 미세 조정하거나 디버그해야 하는 경우 이 명령이 제공됩니다.
영향
WebSphere Application Server 프로파일에서 실행되는 업데이트 모드 색인기가 사용 불가능하게 됩니다. 새롭거나 수정된 ClearQuest 레코드가 검색 결과에 반영되지 않습니다. oplog에는 계속하여 메시지가 수신됩니다. 업데이트 모드 레코드 색인기가 다시 사용 가능하게 되고 현재 oplog에 도달한 후에는 전체 텍스트 검색에 ClearQuest 레코드 변경사항이 반영됩니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
IBM 소프트웨어 지원 센터에서 업데이트 모드 색인기를 사용 불가능하게 하도록 지시했습니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --stop_update_idx

unlock_cq_fts
요약
이 명령은 잠겨 있는 전체 텍스트 검색 배치를 잠금 해제하는 데 사용됩니다. 명령이 완료된 후 사용 가능한 모든 전체 텍스트 검색 관리자 명령을 실행할 수 있습니다.
사용법
이 명령을 사용하여 잠겨 있는 전체 텍스트 검색의 배치를 잠금 해제하고 사용 가능한 모든 명령을 실행할 수 있습니다. 이 명령은 lock_cq_fts 명령행 옵션이 설정하는 잠금을 되돌립니다.
영향
없습니다. 전체 텍스트 검색 배치 데이터와 설정은 영향을 받지 않으며 모든 명령을 실행할 수 있습니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
색인을 최적화해야 하지만 배치가 잠겨 있습니다. 색인을 잠금 해제하고 최적화한 후 이를 다시 잠금해야 합니다.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --unlock_cq_fts --optimize_idx --lock_cq_fts

update_fts_prop_files
요약
cqtsadmin-dbset-userdb.xml 전체 텍스트 검색 관리자 구성 파일에서 변경한 내용을 전파합니다. 구성 파일에서 다음 XML 태그 중 변경한 내용이 있으면 이를 전파해야 변경 내용이 적용됩니다.
  • <batchIndexBatchSize>
  • <batchIndexDelay>
  • <batchIndexThreads>
  • <ftsServerName>
  • <ftsWASProfileName>
  • <ftsWASProfilePort>
  • <updateIndexBatchSize>
  • <updateIndexDelay>
  • <updateIndexLoginInterval>

예를 들어, 일괄처리 모드 색인기의 일괄처리 크기를 변경하는 경우 새 값을 사용하기 위해 run_batch_idx 명령행 옵션을 실행하기 전에 이 명령을 실행해야 합니다.

참고: 관리 사용자의 비밀번호를 변경할 때마다 update_fts_prop_files(새 비밀번호 지정)를 사용하여 비밀번호 파일(pwd.txt)이 업데이트되고 새 레코드의 일괄처리 색인화가 재개될 수 있는지 확인하십시오. 예를 들면 다음과 같습니다.
cqperl cqtsadmin.pl --username admin --password new_password --dbset 7.0.0 --userdb SAMPL --ftshome C:\CQ.Search --fresh_batch_idx
사용법
전체 텍스트 검색을 배치하는 경우 기본 설정을 변경해야 합니다. 구성 파일을 변경하는 경우 적절한 전체 텍스트 검색 컴포넌트에 변경 내용을 전파해야 합니다.
영향
영향받는 컴포넌트는 변경하는 XML 태그 값에 따라 다릅니다. 자세한 정보는 cqtsadmin-dbset-userdb.xml을 참조하십시오.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
일괄처리 크기와 스레드 수를 늘려 일괄처리 모드 색인화를 촉진해야 합니다. 구성 파일을 변경한 후 다음 명령을 실행하십시오.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --update_fts_prop_files --run_batch_idx

upgrade_solr_app
요약
이 명령행 옵션은 현재 전체 텍스트 검색 배치의 Apache Solr이 사용 중인 ClearQuest와 함께 설치되는 최신 버전인지 여부를 확인합니다. 최신 버전이 아닌 경우 Apache Solr을 업그레이드합니다.
사용법
ClearQuest의 신규 버전은 현재의 전체 텍스트 검색 배치에서 사용하는 버전보다 최신의 Apache Solr 버전을 지원합니다. ClearQuest와, prep_upgd_was_profilesrestore_was_profiles 명령행 옵션을 사용하는 전체 텍스트 검색 배치를 업그레이드할 때 Apache Solr 애플리케이션이 자동으로 업그레이드되지는 않습니다. 이러한 업그레이드 접근은 의도적이며 색인 형식이 변경되었기 때문에 전체 재색인화가 필요합니다. Apache Solr을 지원되는 최신 버전으로 업그레이드하려면 이 명령을 사용하십시오.

이 명령행 옵션을 사용하기 전에 backup_fts 명령행 옵션을 사용하여 전체 텍스트 검색 배치를 백업해야 합니다. 또한 Apache Solr 업그레이드 후 ClearQuest 데이터베이스를 재색인화해야 하는지 여부를 판별하려면 IBM Rational ClearQuest 릴리스 정보를 참조하십시오. Apache Solr의 색인 형식이 변경된 경우 재색인화해야 합니다.

이 명령행 옵션을 실행한 후, stop_fts_was_profile 명령행 옵션을 실행하고 start_fts_was_profile 명령행 옵션을 실행해야 업그레이드가 적용됩니다.
중요사항: prep_upgd_was_profilesrestore_was_profiles 명령행 옵션을 사용하여 전체 텍스트 검색 배치를 업그레이드한 이후와 ClearQuest를 업그레이드한 이후에는 이 명령행 옵션을 실행해야 합니다. 그렇지 않으면 문제가 발생할 수 있습니다.
영향
기존의 Apache Solr이 지원되는 최신 버전으로 업그레이드됩니다. 업그레이드가 완료될 때까지 ClearQuest 전체 텍스트 검색을 사용할 수 없습니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 이 명령은 입출력(I/O) 오류나 WebSphere Application Server 문제만 없으면 실패하지 않습니다.
예제
전체 텍스트 검색 배치 중 하나에서 Apache Solr을 업그레이드하려 합니다. backup_fts 옵션과 함께 cqtsadmin.pl 명령을 실행하여 전체 텍스트 검색 배치를 백업하십시오.

cqperl cqtsadmin.pl --username admin --password secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --backup_fts E:\FTS.Backup

upgrade_solr_app 명령행 옵션과 함께 cqtsadmin.pl 명령을 실행하여 Solr 애플리케이션을 업그레이드하십시오.

cqperl cqtsadmin.pl --username admin --password secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --upgrade_solr_app

사용자 데이터베이스를 재색인화하도록 지시하는 메시지가 표시되면 stop_update_idx, run_batch_idx, optimize_idxstart_update_idx 명령행 옵션을 사용하여 cqtsadmin.pl 명령을 네 번 실행하십시오.

cqperl cqtsadmin.pl --username admin --password secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --stop_update_idx

cqperl cqtsadmin.pl --username admin --password secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --run_batch_idx

cqperl cqtsadmin.pl --username admin --password secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --optimize_idx

cqperl cqtsadmin.pl --username admin --password secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --start_update_idx

다른 ClearQuest 데이터베이스에 대한 전체 텍스트 검색 배치가 추가로 있는 경우 각 데이터베이스에서 위 명령을 실행하십시오.

was_profile_ports_file
요약
이 명령행 옵션을 사용하여 사용자 고유의 WebSphere Application Server 프로파일 포트 파일을 선택적으로 제공할 수 있으며, 전체 텍스트 검색 프로파일을 작성할 때 create_fts_was_profile 명령행 옵션과 함께 사용됩니다.
사용법
전체 텍스트 검색 배치를 새로 작성하는 경우 기본적으로 새 WebSphere Application Server 프로파일을 작성하십시오. 전체 텍스트 검색 관리자 도구는 시스템에서 사용할 다음 사용 가능 포트를 판별합니다. 배치를 조정하고 사용할 고유 포트를 지정해야 하는 경우 고유의 포트 파일을 작성해야 합니다. 그런 다음 was_profile_ports_file 옵션을 사용하여 포트 파일을 사용하도록 전체 텍스트 검색 관리자 도구에 지시하십시오. WebSphere 설치의 portdef.props 파일에 사용할 수 있는 템플리트가 있습니다. portdef.props 파일은 보통 \IBM\WebSphere\AppServer\profileTemplates\default\actions\portsUpdate\ 디렉토리에 있습니다. WebSphere Application Server 프로파일 포트 파일에 대해 자세히 알려면 WebSphere Application Server Information Center의 manageprofiles 명령, 예제: 사전 정의된 포트 번호 사용 섹션을 참조하십시오. http://pic.dhe.ibm.com/infocenter/wasinfo/v8r0/index.jsp?topic=%2Fcom.ibm.websphere.base.doc%2Finfo%2Faes%2Fae%2Frxml_manageprofiles.html
이 명령행 옵션은 create_fts_was_profile 옵션과 함께 사용됩니다.
참고: 사용자 고유 포트를 사용하는 경우 다른 애플리케이션에서 사용자 포트를 사용하지 않는지 확인하십시오. 그렇지 않으면 전체 텍스트 검색 및 다른 애플리케이션에서 문제가 발생할 수 있습니다.
영향
이 명령에서 지정하는 포트가 전체 텍스트 검색 관리자 도구에서 지정하는 포트 대신 사용됩니다.
Stateful 상태
이 옵션은 Stateful하지 않습니다. 입출력(I/O) 오류가 없는 한 이 명령은 실패하지 않습니다.
예제
사용할 고유 포트 세트를 지정해야 합니다.
  1. portdef.props 파일의 사본을 작성한 후 고유 포트 값을 지정합니다.
  2. 다음 명령을 실행하여, was_profile_ports_file 옵션을 사용하여 고유 포트를 지정하는 전체 텍스트 검색 배치를 새로 작성합니다.

    cqperl cqtsadmin.pl --username admin --password "" --dbset MASTR --userdb SAMPL --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile automatic --fts_was_profile_home D:\FTS.WASprofiles --was_profile_ports_file D:\my-portdef.props

  3. 전체 텍스트 검색 배치를 계속 사용합니다.

피드백