다음을 통해 공유

lotusnotestemplate.xml 참조

  • 아티클

 

적용 대상: FAST Search Server 2010

마지막으로 수정된 항목: 2015-03-09

lotusnotestemplate.xml 복사본을 사용하여 FAST Search Lotus Notes 커넥터에 대한 설정을 변경합니다.

FAST Search Lotus Notes 커넥터에서는 구성 설정을 사용하여 Lotus Domino에서 콘텐츠 추출을 제어합니다. 각 인스턴스에 대해 서로 다른 구성을 사용할 경우 FAST Search Lotus Notes 커넥터의 여러 인스턴스를 동시에 실행할 수 있습니다.

lotusnotestemplate.xml 사용자 지정

참고

구성 파일을 수정하려면 FAST Search Server 2010 for SharePoint이 설치된 컴퓨터에서 FASTSearchAdministrators 로컬 그룹의 구성원이어야 하는 최소 요구 사항을 만족하는지 확인합니다.

Lotus Notes 데이터베이스에서 콘텐츠를 추출하여 FAST Search Server 2010 for SharePoint 설치에 공급하려면 먼저 lotusnotestemplate.xml 파일의 복사본을 만듭니다. 메모장을 제외한 원하는 텍스트 편집기나 XML 편집기에서 복사본을 편집하여 환경에서 사용할 요소와 설정을 포함합니다.

설정을 테스트하려면 다음을 실행합니다.

<FASTSearchFolder>\bin\lotusnotesconnector.bat testconnections -f <구성 파일>

여기서 *<구성 파일>*은 구성의 경로 및 파일 이름이고, *<FASTSearchFolder>*는 FAST Search Server 2010 for SharePoint을 설치한 폴더의 경로(예: C:\FASTSearch)입니다.

FAST Search Lotus Notes 커넥터는 Lotus Domino 서버, FAST Search Server 2010 for SharePoint 설치, 상태 데이터베이스 같은 모든 외부 시스템에 연결하여 연결 매개 변수를 확인합니다. 커넥터는 데이터를 처리하지 않습니다.

FAST Search Lotus Notes 커넥터를 실행하여 콘텐츠를 FAST Search Server 2010 for SharePoint에 공급하려면 다음을 실행합니다.

<FASTSearchFolder>\bin\ lotusnotesconnector.bat start -f <구성 파일>

매개 변수 그룹 빠른 참조

다음 표에는 lotusnotestemplate.xml에 있는 매개 변수 그룹이 나와 있습니다. 이러한 그룹은 어떠한 순서로도 나올 수 있습니다.

매개 변수 그룹 설명

매개 변수 그룹: Connection

Domino 서버에 연결하는 방법을 지정합니다.

매개 변수 그룹: Filters

크롤링할 콘텐츠를 지정합니다.

매개 변수 그룹: FASTSearchSubmit

콘텐츠 전송 시 FAST Search Server 2010 for SharePoint과 통신하는 데 사용되는 속성을 설명합니다.

매개 변수 그룹: XMLExport

XML 형식 파일로 내보내는 데 사용할 값을 지정합니다.

매개 변수 그룹: Normalization

커넥터가 항목을 콘텐츠 배포자로 보내기 전에 항목을 변환/정규화하는 방법을 지정합니다.

매개 변수 그룹: ConnectorExecution

커넥터를 실행할 때 사용되는 일반 값을 지정합니다.

매개 변수 그룹: StateTracker

상태 추적기 데이터베이스의 동작을 지정합니다. 상태 추적기 데이터베이스는 증분 크롤링에 사용됩니다.

매개 변수 그룹: General

구성 이름을 지정합니다.

lotusnotestemplate 파일 형식

lotusnotestemplate.xml 의 XML 요소는 <로 시작해서 />로 끝납니다. 이 XML은 FastConnectorConfig-1.0.dtd에 정의되어 있습니다.

기본 형식은 다음과 같습니다.

<group name=" 그룹_이름 ">

    <parameter name="매개 변수_이름" type="매개 변수_유형">

        <value>값</value>

    </parameter>

</group>

매개 변수 이름은 대/소문자를 구분하고 매개 변수 유형은 대/소문자를 구분하지 않습니다. 매개 변수 이름과 유형은 따옴표(" ")로 묶어야 합니다.

매개 변수 정의는 여러 줄에 입력할 수 있습니다. 요소 정의에서 공백, 캐리지 리턴, 라인 피드 및 탭 문자는 무시됩니다.

예를 들면 다음과 같습니다.

<group name="ConnectorExecution">
    <parameter name="QueueSize" type="integer">
         <value>200</value>
    </parameter>
    <parameter name="WorkFolder" type="string">
         <value>../var/lotusnotesconnector</value>
    </parameter>
</group>

팁

매개 변수 정의가 긴 경우 값을 여러 줄에 배치하고 들여쓰기를 사용하여 파일을 알아보기 쉽게 만듭니다.

<FastConfig> 요소는 특수한 경우이며 필수 요소입니다. 다른 모든 요소는 <FastConfig> 요소 내에 포함되며 이 요소는 </FastConfig>.를 사용하여 닫습니다.

다음은 구성 파일의 예제 코드 조각입니다.

<!DOCTYPE FastConfig SYSTEM "dtd/FastConnectorConfig-1.0.dtd"><FastConfig>
    <group name="ConnectorExecution">
       <parameter name="QueueSize" type="integer">
             <value>200</value>
        </parameter>
       <parameter name="WorkFolder" type="string">
             <value>../var/lotusnotesconnector</value>
       </parameter>
    </group>
</FastConfig>

<!--와 -->로 구분하여 어디에든 주석을 추가할 수 있습니다.

예를 들면 다음과 같습니다.

<!DOCTYPE FastConfig SYSTEM "dtd/FastConnectorConfig-1.0.dtd"><FastConfig>
    <!-- The parameter group ConnectorExecution specifies general values
          used when running a connector. -->
    <group name="ConnectorExecution">
       <parameter name="QueueSize" type="integer">
             <value>200</value>
       </parameter>
       <parameter name="WorkFolder" type="string">
             <value>../var/lotusnotesconnector</value>
       </parameter>
    </group>
</FastConfig>

매개 변수 그룹: Connection

이 그룹의 매개 변수는 Lotus Domino 서버에 대한 연결을 지정합니다.

매개 변수 유형 값 설명

Hostname

문자열

텍스트

Domino 서버의 호스트 이름입니다.

호스트 이름, 정규화된 도메인 이름, Domino 서버 이름(<호스트>/<도메인> 형식) 또는 "localdisk"일 수 있습니다.

예약어 "localdisk"는 로컬 Lotus Notes 클라이언트에서 데이터베이스를 찾도록 커넥터에 지시합니다.

Password

문자열

텍스트

Lotus Notes 클라이언트에 인증하는 데 사용되는 부호화된 암호입니다.

이 암호는 이 컴퓨터에서 Lotus Notes 클라이언트에 마지막으로 로그온할 때 사용한 암호와 일치해야 합니다. 암호는 암호화해야 하며 암호화할 때는 <FASTSearchFolder>\bin\connectorpwgen.bat 유틸리티를 사용하십시오.

부호화된 암호는 줄 바꿈이나 공백 문자를 포함할 수 없습니다. 콘솔에서 부호화된 암호를 복사할 때 이러한 문자를 제거하십시오.

참고

암호를 해독할 사용자(커넥터를 실행할 사용자)가 암호를 암호화해야 합니다.

예

<group name="Connection">
    <parameter name="Hostname" type="string">
        <value>dominoserver.company.com</value>
    </parameter>
    <parameter name="Password" type="string">
        <value>AQAAANCMnd8BFdERjHoAwE/Cl+sBAAAAPF3E/uqo8kuy05Vfl6hBWAAAAABSAAAATQBpAGMAcgBvAHMAbwBmAHQAIABFAG4AdABlAHIAcAByAGkAcwBlACAAUwBlAGEAcgBjAGgAIAAtACAAQwBvAG4AbgBlAGMAdABvAHIAcwAAAANmAACoAAAAEAAAAN/ksvnBFepWFXzS9BFNY6AAAAAABIAAAKAAAAAQAAAAvbI2O5PXmb6wDzAeEfvNeRAAAABEqBeLrh8usMBfBhA7J8t1FAAAAD54sadCcKVwSRyxdU0TO6XjyCdH</value>
    </parameter>
</group>

매개 변수 그룹: Filters

이 그룹의 매개 변수는 몇 가지 포함 및 제외 필터를 통해 크롤링할 콘텐츠를 지정합니다.

매개 변수 유형 값 설명

DataBase

문자열

텍스트

크롤링할 데이터베이스 목록입니다. 뷰 이름을 포함할 수도 있습니다.

<데이터베이스 경로>#뷰 이름 형식으로 뷰를 지정합니다. 데이터베이스를 여러 개 지정하는 경우 세미콜론(;)으로 구분합니다.

뷰를 지정하면 뷰의 검색 수식만 사용됩니다.

ViewName

string

텍스트

특정 뷰를 여러 데이터베이스에 동시에 지정합니다.

DataBase 매개 변수에 뷰를 지정하지 않은 경우에 사용합니다.

뷰를 지정하면 뷰의 검색 수식만 사용됩니다.

IncludeDataBases

문자열

텍스트

데이터베이스 이름/경로에 대한 하나 이상의 포함 필터나 정규식을 나열합니다(예: Attach.*\.nsf;help\/.*\.nsf).

포함 필터를 여러 개 지정하는 경우 세미콜론(;)으로 구분합니다.

DataBase 매개 변수를 비워 둔 경우에 ExcludeDatabases 필터와 함께 사용합니다.

ExcludeDataBases

문자열

텍스트

데이터베이스 이름/경로에 대한 하나 이상의 제외 필터나 정규식을 나열합니다(예: mail\\.*\.nsf;schema.nsf;names.nsf;help.*\.nsf).

제외 필터를 여러 개 지정하는 경우 세미콜론(;)으로 구분합니다.

DataBase 매개 변수를 비워 둔 경우에 IncludeDatabases 필터와 함께 사용합니다.

이 매개 변수는 포함 필터를 무시합니다. 포함된 콘텐츠의 범위를 좁히려는 경우에 사용합니다.

IncludeAttachmentExtensions

문자열

텍스트

인덱싱할 첨부 파일의 확장명 목록입니다. 포함 필터를 여러 개 지정하는 경우 세미콜론(;)으로 구분합니다.

IncludeAttachmentExtension과 ExcludeAttachmentExtensions를 모두 지정하면 ExcludeAttachmentExtensions가 무시됩니다.

ExcludeAttachmentExtensions

문자열

텍스트

인덱싱하지 않을 첨부 파일의 확장명 목록입니다. 제외 필터를 여러 개 지정하는 경우 세미콜론(;)으로 구분합니다.

IncludeAttachmentExtension과 ExcludeAttachmentExtensions를 모두 지정하면 ExcludeAttachmentExtensions가 무시됩니다.

MaxAttachmentSize

정수

크기

첨부 파일의 최대 크기(KB)를 지정합니다.

기본값: 10000

SearchQuery

문자열

텍스트

Notes Query Language를 사용하여 쿼리를 지정합니다.

예: SELECT Form="Item"

이 쿼리는 뷰가 지정되지 않은 모든 데이터베이스에 적용됩니다.

이러한 매개 변수를 변경한 결과 이전에는 인덱싱되었던 항목이 더 이상 인덱싱되지 않으면 해당 항목은 인덱스에서 제거됩니다. 이 경우 StateTracker/PurgeAtStart 매개 변수를 true로 설정하여 상태 테이블을 지워야 합니다. 모음을 삭제하고 비워 FAST Search Server 2010 for SharePoint 검색 인덱스의 항목도 모두 삭제해야 합니다.

예

<group name="Filters">
    <parameter name="DataBase" type="string" separator=";">
        <value></value>
    </parameter>
    <parameter name="ViewName" type="string">
        <value></value>
    </parameter>
    <parameter name="IncludeDataBases" type="string" separator=";">
        <value>help\\.*</value>
    </parameter>
    <parameter name="ExcludeDataBases" type="string" separator=";">
        <value>help\\.*api.*</value>
    </parameter>
    <parameter name="IncludeAttachmentExtensions" type="string" separator=";">
        <value>doc;xls;ppt;pdf</value>
    </parameter>
    <parameter name="ExcludeAttachmentExtensions" type="string" separator=";">
        <value></value>
    </parameter>
    <parameter name="MaxAttachmentSize" type="integer">
        <value>10000</value>
    </parameter>
    <parameter name="SearchQuery" type="string">
        <value>SELECT Form="Item"</value>
    </parameter>
</group>

매개 변수 그룹: FASTSearchSubmit

이 그룹의 매개 변수는 콘텐츠를 FAST Search Server 2010 for SharePoint에 전송하는 데 사용되는 통신 속성을 설명합니다.

매개 변수 유형 값 설명

ActuallyPublish

부울

true|false

true로 설정하면 항목을 FAST Search Server 2010 for SharePoint로 전송합니다.

false로 설정하면 커넥터가 Lotus Domino에서 콘텐츠를 크롤링만 하고 검색 인덱스로 전송하지는 않습니다. 다른 매개 변수(예: Filters 그룹의 매개 변수 설정)를 실행하여 테스트해 보려는 경우 이 설정을 사용합니다.

기본값: true

Collection

문자열

텍스트

공급할 FAST Search Server 2010 for SharePoint 크롤링 모음의 이름입니다.

예

<group name="FASTSearchSubmit">
    <parameter name="ActuallyPublish" type="boolean">
        <value>true</value>
    </parameter>
    <parameter name="Collection" type="string">
        <value>lotusnotes</value>
    </parameter>
</group>

매개 변수 그룹: XMLExport

이 그룹의 매개 변수는 XML 형식 파일로의 내보내기를 지정합니다. 테스트하는 동안 XML로 콘텐츠를 내보내 콘텐츠를 확인합니다.

텍스트 데이터만 XML로 내보내지고 이진 콘텐츠는 내보내지지 않습니다.

매개 변수 유형 값 설명

ExportToXML

부울

true|false

true로 설정하면 모든 항목을 XML로 내보냅니다.

기본값: false

내보낸 XML은 <FASTSearchFolder>\var\lotusnotesconnector\<collection name>\xml에 저장됩니다.

예

<group name="XMLExport">
    <parameter name="ExportToXML" type="boolean">
        <value>true</value>
   </parameter>
</group>

매개 변수 그룹: Normalization

이 그룹의 매개 변수는 항목을 콘텐츠 인덱스에 전송하기 전에 변환/정규화하는 방법을 지정합니다.

매개 변수 유형 값 설명

FixedFields

문자열

텍스트

크롤링된 모든 항목에 고정 필드와 필드 값을 할당합니다. 필드1:값1;필드2:값2 형식의 필드 이름/값 쌍이 세미콜론으로 구분되어 포함된 목록입니다.

필드는 작성된 그대로 추가되며 대/소문자를 구분합니다.

DominoWebServerPrefix

문자열

텍스트

검색 결과에서 연결할 Domino 웹 서버를 지정합니다.

이 Domino 웹 서버가 크롤링할 서버와 다를 경우 이 매개 변수는 항목 URL을 Domino 웹 서버의 항목 URL로 재정의합니다.

SecurityDomainId

문자열

텍스트

Lotus Notes의 보안 도메인 ID(Lotus Notes 사용자 저장소를 만들 때 제공한 ID)를 지정합니다.

도메인 ID는 Lotus Notes 사용자 저장소 cmdlet의 Identity 속성 및 Lotus Notes 사용자 디렉터리 구성 파일의 FSAOutput/SecurityDomainId와 일치해야 합니다.

DateTimeFormat

문자열

텍스트

ACL 변경 타임스탬프에 대한 구문 분석을 수정합니다.

이 매개 변수는 변경하지 않아야 합니다. 커넥터는 데이터베이스 보안이 마지막으로 변경된 타임스탬프를 자동으로 구문 분석합니다. 단, 커넥터가 이전 실행 이후 수정되지 않은 데이터베이스를 다시 처리하는 경우에는 이 매개 변수에 날짜-시간 형식을 지정하십시오.

날짜-시간 형식의 예:

  • dd/MM/yyyy hh:mm:ss aa

  • MM/dd/yyyy hh:mm:ss aa

  • yyyy/MM/dd hh:mm:ss aa

커넥터가 Domino 서버와는 다른 로캘의 Lotus Notes 데이터베이스를 크롤링하는 경우가 아니면 Normalization/DateTimeFormat 매개 변수를 비어 있는 상태로 둡니다. 예를 들어 Domino 서버의 로캘은 "28/07/2009 14:56:34" 형식의 타임스탬프를 포함하지만, 데이터베이스는 "07/28/2009 02:56:34 PM" 형식의 동일한 타임스탬프를 포함하는 로캘의 Domino 서버에 만들어진 경우 이 매개 변수는 "MM/dd/yyyy kk:mm:ss aa"를 포함해야 합니다.

예

<group name="Normalization">
    <parameter name="FixedFields" type="string">
        <value></value>
    </parameter>
    <parameter name="DominoWebServerPrefix" type="string">
        <value>http://dominowebserver.company.com</value>
    </parameter>
    <parameter name="SecurityDomainId" type="string">
        <value>lnx</value>
    </parameter>
    <parameter name="DateTimeFormat" type="string">
        <value></value>
    </parameter>
</group>

매개 변수 그룹: ConnectorExecution

이 그룹의 매개 변수는 커넥터를 실행하는 동안 사용되는 일반 값을 지정합니다.

매개 변수 유형 값 설명

QueueSize

정수

1 - 10000

내부 항목 큐의 크기를 지정합니다.

이 값을 늘리면 성능이 향상되지만 커넥터의 메모리 사용량도 증가할 수 있습니다.

기본값: 200

DocumentLoggingFrequency

정수

10 - 50000

커넥터가 처리한 항목의 수를 지정하며 이 수를 초과하면 커넥터는 처리한 항목의 수에 관한 메시지를 기록합니다.

기본값: 1000

WorkFolder

문자열

폴더 이름

모든 파일 출력용 작업 폴더(상대 또는 절대 파일 경로)를 지정합니다. 이 폴더에는 로그 파일과 XML 출력 파일이 포함됩니다.

폴더가 없으면 자동으로 만들어집니다.

커넥터 구성을 여러 개 사용하는 경우 구성마다 이 매개 변수의 값이 달라야 합니다.

기본값: ../var/lotusnotesconnector

NumAdapters

정수

1 - 32

여러 개의 어댑터 스레드를 지정하거나, 커넥터가 동시에 크롤링하는 데이터베이스의 수를 지정합니다.

이 값을 늘리면 커넥터의 성능이 향상되지만 메모리 사용량도 늘어날 수 있습니다.

기본값: 3

AdapterThrottleSleepMS

정수

0 - 10000

원본에서 각 항목을 가져오는 사이에 어댑터가 대기해야 할 시간(밀리초)을 지정합니다.

이 커넥터 인스턴스의 공급 속도를 제한하려는 경우에 사용합니다.

기본값: 0

EnableStatustracker

부울

true|false

true로 설정하면 항목 크롤링 상태가 데이터베이스에 기록됩니다. false로 설정하면 상태 추적이 해제됩니다.

추적을 해제하면 상태 데이터베이스의 부하가 줄어들지만 SQL Server Reporting Services를 사용하여 개별 항목의 상태를 확인할 수 없습니다.

커넥터 구성을 여러 개 실행하는 경우가 아니면 이러한 설정을 변경할 필요가 없습니다.

예

<group name="ConnectorExecution">
    <parameter name="QueueSize" type="integer">
        <value>200</value>
    </parameter>
    <parameter name="DocumentLoggingFrequency" type="integer">
        <value>1000</value>
    </parameter>
    <parameter name="WorkFolder" type="string">
        <value>../var/lotusnotesconnector2</value>
    </parameter>
    <parameter name="NumAdapters" type="integer">
        <value>4</value>
    </parameter>
    <parameter name="AdapterThrottleSleepMS" type="integer">
        <value>0</value>
    </parameter>
    <parameter name="EnableStatustracker" type="boolean">
        <value>false</value>
    </parameter>
</group>

매개 변수 그룹: StateTracker

이 그룹의 매개 변수는 증분 크롤링에 사용되는 상태 추적기 데이터베이스의 동작을 지정합니다.

매개 변수 유형 값 설명

PurgeAtStart

부울

true|false

true로 설정하면 시작할 때 상태 추적기 테이블의 모든 데이터가 지워져 이전에 크롤링된 항목을 포함하여 모든 항목을 크롤링하도록 커넥터에 지시합니다.

구성을 테스트하려는 경우에 사용합니다. 프로덕션에서는 false로 설정합니다.

기본값: false

예

<group name="StateTracker">
    <parameter name="PurgeAtStart" type="boolean">
        <value>false</value>
    </parameter>
</group>

매개 변수 그룹: General

구성 이름을 지정합니다.

매개 변수 유형 값 설명

Name

문자열

텍스트

구성 이름을 지정합니다.

서로 다른 관리 속성에 매핑되어야 하는 동일한 필드를 포함하는 데이터베이스가 여러 개 있는 경우에만 사용합니다.

이름은 고유해야 하고 최대 길이는 32자여야 하며 a~f 및 0~9 범위에 있어야 합니다.

32자보다 짧은 이름은 32자로 채워져 32자의 GUID가 생성됩니다. 이 propset-ID GUID는 크롤링 속성이 검색 엔진으로 들어올 때 속성의 원본을 식별하여 크롤링 속성이 관리 속성에 매핑될 수 있도록 합니다.

Name이 비어 있으면 미리 정의된 Lotus Notes propset-ID와 미리 정의된 매핑이 사용되며 이는 확장할 수 있습니다.

별도의 매핑을 통해 서로 다른 관리 속성에 매핑되어야 하는 동일한 필드를 포함하는 데이터베이스가 여러 개 있는 경우가 아니면 이 매개 변수의 값을 입력할 필요가 없습니다.

예를 들어 a.nsf와 b.nsf라는 두 데이터베이스는 모두 "lastmodified"라는 필드를 포함합니다. a.nsf에서 이 필드는 데이터베이스를 마지막으로 수정한 사용자를 지정하는 문자열입니다. b.nsf에서 이 필드는 datetime이며 데이터베이스가 마지막으로 수정된 타임스탬프를 포함합니다. a.nsf에서 "lastmodified"는 "modifiedby"라는 관리 속성에 매핑되고 b.nsf에서 "lastmodified"는 "lastmodifiedtime"이라는 관리 속성에 매핑됩니다. 이 두 데이터베이스를 크롤링하려면 서로 다른 두 개의 커넥터 구성이 필요합니다.

예

<group name="General">
    <parameter name="Name" type="string">
        <value>abcdef01</value>
    </parameter>
</group>

See Also

Reference

lotusnotesconnector.bat 참조

Concepts

FAST Search Lotus Notes 콘텐츠 커넥터를 사용하여 크롤링 관리