전체 텍스트 검색 유지보수

전체 텍스트 검색을 유지보수하면 문제가 있는 레코드 복구, 오퍼레이션 로그 파일 제거, 색인 최적화, Solr 성능 조정 및 스키마 변경사항을 수용하는 구성 업데이트 등의 타스크를 자주 수행하지 않아도 됩니다.

문제가 있는 레코드 복구

일괄처리 또는 업데이트 모드에서 레코드 추출기가 실행될 때 레코드를 처리하는 데 실패하는 경우가 있습니다. 이러한 경우 레코드 추출기는 실패한 레코드에 대한 복구 파일을 작성합니다. 복구 파일은 ClearQuest 검색 특성 파일 CQ-db_name-dbset_name.xml이 상주하는 디렉토리에 작성됩니다. 일반적으로 이 디렉토리는 Solr 홈 디렉토리입니다. 실패한 처리의 인스턴스를 확인하려면 이 디렉토리를 모니터하고, 문제가 있는 레코드를 처리하려면 레코드 추출기를 복구 모드에서 사용하십시오. 사용법에 대한 정보는 cqtsdbcrawler 참조 도움말을 참조하십시오.

오퍼레이션 로그 제거

기본적으로 오퍼레이션 로그(oplog) 제거는 사용자 데이터베이스에서 발생하지 않습니다. oplog 스크러빙 정책을 구현하여 버려진 공간을 최소화하려면 oplog가 성급히 제거되지 않도록 주의를 사용하십시오. Oplog는 업데이트 모드의 레코드 추출기가 처리하는 동안 계속 남아 있어야 합니다. 업데이트 모드 레코드 추출기가 장시간 실행되지 않는 경우, 처리되지 않았던 가장 오래된 업데이트 oplog를 처리하면 이 추출기가 재개됩니다.

실행 중인 ClearQuest MultiSite에서는 전체 텍스트 검색 oplog 스크러빙 정책이 기존 ClearQuest MultiSite oplog 스크러빙 정책보다 더 활성화되지 않아야 합니다.

자세한 사항은 oplog 스크러빙에 대한 ClearQuest Multisite 도움말을 참조하십시오.

맨 위로 돌아가기

색인 최적화

새 ClearQuest 레코드가 추가, 수정 및 삭제됨에 따라 Lucene 색인이 단편화되므로 성능이 저하될 수 있습니다.

색인을 최적화하려면 다음 단계를 수행하십시오.
  1. 디렉토리를 ClearQuest 홈 디렉토리로 변경하십시오.
  2. 명령 프롬프트에서 최적화 모드로 레코드 추출기를 실행하십시오.
    cqperl cqtsdbcrawler.pl -optimize CQ-db_name-dbset_name.xml -site site_name

ClearQuest MultiSite가 실행 중이 아니면 -site 옵션을 생략할 수 있습니다. 사용법에 대한 정보는 cqtsdbcrawler 참조 도움말을 참조하십시오.

맨 위로 돌아가기

Solr 성능 조정

Solr 검색 엔진이 ClearQuest 성능에 장애가 되어서는 안됩니다. 이를 방지하려면 앞 섹션에서 설명한 대로 먼저 Lucene 색인을 최적화하십시오. 또한 Solr 성능에 최적화되도록 아래 내용을 검토하십시오.

  • JVM(Java Virtual Machine)의 메모리 할당을 늘리십시오. solr을 시작할 때 기본적으로 할당된 메모리 대신 Xms512M 및 Xmx1024M을 할당하십시오.

    일괄처리 모드에서 레코드 추출기를 시작하려면 JVM 메모리를 임시로 늘린 후 재설정해야 합니다.

  • Solr 홈 디렉토리를 빠른 보조 하드 디스크로 이동하십시오. 특히 대형 색인의 경우 검색 엔진은 하드 드라이브, 프로세서 및 메모리 중심적입니다. 10,000 RPM으로 검색 시간을 빨리하여 Solr 홈 디렉토리를 빠른 보조 하드 드라이브로 이동하면, 표준 54,000 RPM 하드 드라이브를 사용할 때보다 Solr 성능이 훨신 향상됩니다. 운영 체제 파티션의 개별 파티션을 사용하는 경우에도 성능이 향상될 수 있습니다.
  • 서버의 실제 메모리, 프로세서 수 및 시계 속도를 늘리십시오.
  • Solr 구성 파일 solrconfig.xml의 성능 설정을 조정하십시오. 자세한 사항은 Solr 웹 사이트를 참조하십시오.
  • 색인 중인 레코드 유형 및 연관 필드 수를 줄이십시오.
  • 전용 서버에 solr을 설치하십시오.
  • Solr 마스터 및 슬레이브 구성을 사용 가능하게 하십시오. 이 구성은 Lucene 색인 기본 구성의 디스크 공간을 두 배로 이용하지만, 색인에 과도한 요구사항이 발생해도 안정적인 성능을 제공합니다.
  • 성능 조정 팁에 대한 추가사항은 Solr 웹 사이트를 참조하십시오.

맨 위로 돌아가기

스키마 변경사항 수용

데이터베이스 스키마가 변경되면 검색 스키마도 변경해야 합니다. 예를 들면 다음과 같습니다.
  • 새 엔티티 추가 - 새 엔티티가 ClearQuest 전체 텍스트 검색으로 검색하려는 제출 가능 레코드 유형인 경우, ClearQuest 검색 특성 파일 CQ-db_name-dbset_name.xml 및 Solr 스키마 파일 schema.xml을 새 레코드 유형의 계정으로 업데이트해야 합니다. 이를 수행하려면 이전에 수행한 다음 단계를 반복하십시오.
    1. 엔티티 파일을 작성 및 편집하십시오.
    2. ClearQuest 검색 특성 파일을 작성 및 편집하십시오.
    3. Solr 검색 파일을 작성하십시오.
    4. Solr 스키마 파일 schema.xml을 업데이트한 후 solr을 다시 시작하여 레코드를 색인에 구성하십시오.
    5. installutil setmasterpropertyfromfile 부속명령을 실행하여 ClearQuest 검색 특성 파일 CQ-db_name-dbset_name.xml을 사용자 데이터베이스로 업로드하십시오.

    업데이트 모드 레코드 추출기는 색인이 끝나면 업데이트된 ClearQuest 검색 특성 파일을 사용합니다.

  • 필드를 엔티티에 추가 - 새 필드를 제출 가능 유형이면서 필드를 색인할 엔티티에 추가하려면 새 엔티티 추가에서 설명한 것과 동일한 프로시저를 수행하십시오.
  • 엔티티 이름 바꾸기 - ClearQuest 스키마에서 엔티티 이름을 바꾸려면 새 엔티티 추가에서 설명한 것과 동일한 프로시저를 수행하십시오. 또한 다음 단계도 수행해야 합니다.
    1. 이름을 바꾼 레코드 유형을 다시 색인하십시오.
      1. 이름을 바꾼 레코드 유형만 포함하는 ClearQuest 검색 특성 파일을 새로 작성하십시오.
      2. 일괄처리 모드(cqperl cqtsdbcrawler.pl -batch)에서 레코드 추출기를 실행하십시오.
    2. 다음 Solr 명령을 실행하여 기존 엔티티 이름에 속하는 모든 레코드 유형을 삭제하십시오.
      Windows의 경우:
      1. cd %SOLR_HOME%\yourSchemaName\Solr\exampledocs\
      2. java -Ddata=args -jar post.jar "<delete><query>record_type:recordTypeName</query></delete>"
      UNIX 시스템 및 Linux의 경우:
      1. cd $SOLR_HOME/yourSchemaName/Solr/exampledocs/
      2. java -Ddata=args -jar post.jar "<delete><query>record_type:record_type</query></delete>"
  • 엔티티 필드 이름 바꾸기 - ClearQuest 스키마에서 엔티티 필드 이름을 바꾸려면 엔티티 이름 바꾸기에서 설명한 것과 동일한 프로시저를 수행하십시오.

맨 위로 돌아가기


피드백