deployment.xml 참조
적용 대상: FAST Search Server 2010
마지막으로 수정된 항목: 2015-03-09
deployment.xml 파일을 사용하여 Microsoft FAST Search Server 2010 for SharePoint 설치 토폴로지에 대한 개요를 작성합니다. 이 파일에는 FAST Search Server 2010 for SharePoint 배포 및 서비스 배포에 포함된 모든 서버가 기술됩니다. 단일 서버 설치에는 수정 가능한 기본 deployment.xml 파일이 포함됩니다.
이 섹션에서는 deployment.xml 파일 형식을 지정합니다. 이 파일에는 여러 서버에서 FAST Search Server 2010 for SharePoint의 배포 방식을 지정하는 자세한 구조 정보가 포함됩니다. FAST Search Server 2010 for SharePoint 응용 프로그램의 각 노드에는 하나 이상의 서비스가 실행됩니다.
<FASTSearchFolder>\etc\에서 예제 deployment.xml 서식 파일을 찾을 수 있습니다. 여기서 *<FASTSearchFolder>*는 FAST Search Server 2010 for SharePoint를 설치한 폴더의 경로입니다(예: C:\FASTSearch).
deployment.xml은 하나의 설치에서 FAST Search Server 2010 for SharePoint 서버 및 서비스를 중앙에서 제어하기 위해 사용됩니다. deployment.xml 파일에서 서버 또는 서비스를 추가하거나 제거하여 FAST Search Server 2010 for SharePoint를 다시 구성할 수 있습니다. 팜 배포 다시 구성(FAST Search Server 2010 for SharePoint)을 참조하십시오.
deployment.xml 파일은 FAST Search Server 2010 for SharePoint 관리 서버에서만 만들고 수정해야 합니다.
참고
구성 파일을 수정하려면 FAST Search Server 2010 for SharePoint가 설치된 컴퓨터에서 FASTSearchAdministrators 로컬 그룹의 구성원이어야 하는 최소 요구 사항을 만족하는지 확인합니다.
요소 빠른 참조
다음 표에는 deployment.xml의 요소가 나열됩니다. 이러한 요소는 어떠한 순서로도 표시될 수 있습니다.
요소 | 설명 |
---|---|
<배포> |
전체 설치를 기술하는 최상위 요소입니다. |
<instanceid> |
FAST Search Server 2010 for SharePoint 인스턴스의 고유 이름입니다. SCOM에서 사용됩니다. |
<connector-databaseconnectionstring> |
구성 데이터에 대한 인덱싱 커넥터에서 사용되는 JDBC URL입니다. FAST Search 데이터베이스 커넥터 및 FAST Search Lotus Notes 커넥터에서 사용됩니다. |
<host> |
FAST Search Server 2010 for SharePoint 배포의 각 서버는 호스트 태그 내에 정의됩니다. 각 호스트(서버)에는 서버에서 실행되는 구성 요소를 결정하는 요소 집합이 저장됩니다. |
<searchcluster> |
쿼리 일치 노드 및 인덱서 노드(검색 클러스터)를 위한 여러 서버 구성을 정의합니다. 설치에서 쿼리를 지원하고 인덱싱을 수행하는 부분을 결정합니다. 또한 내결함성의 설정 여부도 지정합니다. |
<admin> |
host 요소의 일부입니다. 호스트(서버)에 관리 구성 요소가 포함되는지 여부를 지정합니다. |
<document-processor> |
host 요소의 일부입니다. 호스트(서버)에 항목 처리 구성 요소가 포함되는지 여부를 지정합니다. |
<content-distributor> |
host 요소의 일부입니다. 호스트(서버)에 콘텐츠 배포자 구성 요소가 포함되는지 여부를 지정합니다. |
<indexing-dispatcher> |
host 요소의 일부입니다. 호스트(서버)에 인덱싱 발송자 구성 요소가 포함되는지 여부를 지정합니다. |
<crawler> |
host 요소의 일부입니다. 호스트(서버)에 웹 크롤러 구성 요소가 포함되는지 여부를 지정합니다. |
<webanalyzer> |
host 요소의 일부입니다. 호스트(서버)에 웹 분석기 구성 요소가 포함되는지 여부를 지정합니다. |
<searchengine> |
host 요소의 일부입니다. 호스트(서버)에 검색 클러스터 구성 요소(인덱싱이나 쿼리 일치 또는 두 가지 모두)가 포함되는지 여부를 지정합니다. |
<query> |
host 요소의 일부입니다. 호스트(서버)에 쿼리 처리 구성 요소가 포함되는지 여부를 지정합니다. |
<row> |
searchcluster 요소의 일부입니다. 검색 클러스터(배포)에서 단일 검색 행 또는 인덱서 행의 기능을 지정합니다. |
작동 방식
설치 후 구성 마법사에서는 deployment.xml 파일을 사용하여 로컬 서버를 구성합니다. 이 마법사는 관리 서버의 경우 로컬 복사본을 검색하고, 비관리 서버에서는 관리 서버에서 복사본을 가져옵니다.
deployment.xml의 정보는 FAST Search Server 2010 for SharePoint 인스턴스를 구성하는 데 필요한 로컬 구성 파일을 생성하는 데 사용됩니다.
로컬 구성 파일은 설치 후 구성 중에 그리고 Set-FastSearchConfiguration cmdlet을 호출할 때 업데이트됩니다.
deployment.xml 파일 형식
deployment.xml 파일에는 XML 구문이 사용됩니다. XML 스키마 섹션에서는 파일 구문의 공식 사양을 보여 줍니다.
기본 요소 형식은 다음과 같습니다.
<element_name [attribute_name="value"] [attribute_name="value"] ... />
예를 들면 다음과 같습니다.
<document-processor processes="4" />
요소와 특성은 대/소문자를 구분합니다. 특성 값은 따옴표(" ")로 묶어야 하며, 대/소문자를 구분하지 않습니다.
<!--
와 -->
로 구분하여 어디에든 주석을 추가할 수 있습니다.
예를 들면 다음과 같습니다.
<!-- Add a useful comment here-->
배포
FAST Search Server 2010 for SharePoint 설치의 레이아웃을 포함합니다.
특성
특성 | 값 | 설명 |
---|---|---|
version |
<값> |
선택 사항, 배포 파일의 버전 |
modifiedBy |
user\domain |
선택 사항, 배포 파일을 마지막으로 수정한 사용자 |
modifiedTime |
time |
선택 사항, 배포 파일을 마지막으로 수정한 시간 |
comment |
선택적인 설명 |
|
xmlns |
https://www.microsoft.com/enterprisesearch |
필요한 네임스페이스 정의 |
xmlns:xsi |
http://www.w3.org/2001/XMLSchema-instance |
선택적인 스키마 정의 |
xsi:schemaLocation |
https://www.microsoft.com/enterprisesearch deployment.xsd |
선택적인 스키마 위치 |
예제
<deployment
version="1"
modifiedBy="domain\user"
modifiedTime="2009-03-14T14:39:17+01:00"
comment="Comment"
xmlns="https://www.microsoft.com/enterprisesearch"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="https://www.microsoft.com/enterprisesearch
deployment.xsd">
<!-- Hosts go here -->
</deployment>
instanceid
FAST Search Server 2010 for SharePoint 인스턴스의 고유한 논리 이름을 식별합니다.
특성
없음
예제
<instanceid>MyFastSearchServer</instanceid>
connector-databaseconnectionstring
커넥터에서 고유 콘텐츠를 저장하기 위해 사용되는 JDBC URL입니다. FAST Search 데이터베이스 커넥터 또는 FAST Search Lotus Notes 커넥터를 사용하지 않을 경우 이 요소를 비워 둘 수 있습니다.
예제
<connector-databaseconnectionstring>
<![CDATA[jdbc:sqlserver://sqlservername\instancename:portnumber;
DatabaseName=dbname]]>
</connector-databaseconnectionstring>
host
이 요소는 특정 호스트(서버)에서 실행되는 구성 요소를 지정합니다. FAST Search Server 2010 for SharePoint 배포의 각 서버에 대해 하나의 호스트 항목을 추가합니다.
특성
특성 | 값 | 설명 |
---|---|---|
name |
<값> |
이 호스트(서버)의 정규화된 도메인 이름 |
useadminservicehttps |
true|false |
이 서버의 구성 요소가 관리 서버와 통신할 때 HTTPS를 사용해야 하는 경우 true로 설정합니다. 이 특성은 선택 사항이며 기본값은 false입니다. |
예제
<host name="single01.search.contoso.com" useadminservicehttps="true">
<!-- components go here -->
</host>
searchcluster
인덱스 구성 방법에 대한 정보가 포함됩니다.
중요
기본 인덱서는 항상 행 id="0"에 있어야 합니다.
특성
없음
예제
<searchcluster>
<row id="0" index="primary" search="true" />
</search-cluster>
admin
호스트(서버)에 관리 구성 요소가 포함된 경우 이 요소를 추가합니다. 하나의 호스트(서버)만 관리 구성 요소를 사용하도록 구성할 수 있습니다.
구성 후 마법사에서 관리 서버로 선택한 서버는 deployment.xml의 관리 서버와 동일해야 합니다.
특성
없음
예제
<admin />
document-processor
호스트(서버)에서 항목 처리 구성 요소가 실행되는 경우 이 요소를 추가합니다.
특성
특성 | 값 | 설명 |
---|---|---|
processes |
<값> |
호스트(서버)에서 실행되는 항목 프로세서 수입니다. 1에서 20 사이의 정수 값이어야 합니다. 코어 수가 많은 서버의 경우 효과적으로 활용할 수 있도록 더 많은 프로세스를 추가할 수 있습니다. 기본값: 4 |
예제
<document-processor processes="4" />
content-distributor
호스트(서버)에서 콘텐츠 배포자 구성 요소를 실행하는 경우에 추가됩니다.
특성
특성 | 값 | 설명 |
---|---|---|
id |
<값> |
정수 값 0 이상이어야 합니다. 중복성을 위해 여러 콘텐츠 배포자를 추가한 경우 각 인스턴스에 고유한 ID를 할당합니다. |
예제
<content-distributor id="0" />
indexing-dispatcher
호스트(서버)에 인덱싱 발송자 구성 요소가 포함된 경우에 추가됩니다.
특성
없음
예제
<indexing-dispatcher />
crawler
호스트(서버)에 웹 크롤러 구성 요소가 포함된 경우에 추가됩니다.
참고
선택적인 FAST Search 웹 크롤러를 사용할 때 이 요소를 지정합니다. FAST Search 커넥터의 Content SSA(Content Search Service 응용 프로그램)에서 웹 사이트 인덱싱 커넥터를 사용하는 경우 이 요소를 지정할 필요가 없습니다.
한 설치에는 여러 단일 서버 웹 크롤러 또는 분산된 웹 크롤러가 포함될 수 있습니다. 호스트(서버)당 웹 crawler 요소를 하나만 정의할 수 있습니다.
특성
특성 | 값 | 설명 |
---|---|---|
role |
single|multi |
크롤러가 독립 실행형 크롤러인지 아니면 분산된 크롤러의 일부인지를 지정합니다. 기본값: single |
multi-node-scheduler |
true|false |
분산된 크롤러의 일부인 경우 이 특성은 서버가 다중 노드 스케줄러를 실행하는지 여부를 지정합니다. 분산된 크롤러는 다중 노드 스케줄러를 하나만 포함할 수 있습니다. role이 "single"인 경우에는 무시됩니다. |
node-scheduler |
true|false |
이 특성은 서버가 노드 스케줄러를 실행하는지 여부를 지정합니다. 분산된 크롤러는 노드 스케줄러를 여러 개 포함할 수 있지만 서버당 하나만 포함할 수 있습니다. role이 "single"인 경우에는 무시됩니다. |
duplicate-server |
true|false |
이 특성은 서버가 중복 서버를 실행하는지 여부를 지정합니다. 분산된 크롤러는 중복 서버를 여러 개 포함할 수 있지만 서버당 하나만 포함할 수 있습니다. role이 "single"인 경우에는 무시됩니다. |
duplicate-server-replica |
true|false |
이 특성은 서버가 중복 서버 복제본을 실행하는지 여부를 결정합니다. 분산된 크롤러는 중복 서버 복제본을 여러 개 포함할 수 있지만 서버당 하나만 포함할 수 있습니다. role이 "single"인 경우에는 무시됩니다. |
duplicate-server-replica-host |
<값> |
이 특성은 로컬 중복 서버에서 사용할 중복 서버 복제본의 위치를 지정합니다. role이 "single"이거나 로컬 서버에 지정된 중복 서버가 없으면 무시됩니다. |
설명
여러 웹 크롤러 구성 요소에 대한 자세한 내용은 FAST Search 웹 크롤러를 사용하여 웹 콘텐츠 크롤링을 참조하십시오.
예제
다음 예제에서는 하나의 다중 노드 스케줄러, 두 개의 노드 스케줄러 및 두 개의 중복 서버가 포함된 웹 크롤러를 실행하고 하나의 호스트가 다른 호스트를 복제하는 세 개의 호스트가 포함된 경우에 대해 설명합니다.
<host name="node1">
<!-- Multi Node Scheduler -->
<crawler role="multi" multi-node-scheduler="true">
</host>
<host name="node2">
<!-- Node Scheduler and Duplicate Server -->
<crawler role="multi" node-scheduler="true" duplicate-server="true" duplicate-server-replica-host="node3">
</host>
<host name="node3">
<!-- Node Scheduler and Duplicate Server replica -->
<crawler role="multi" node-scheduler="true" duplicate-server-replica="true">
</host>
webanalyzer
서버에 웹 분석기 구성 요소가 포함된 경우에 추가됩니다. 한 클러스터에는 여러 단일 노드 크롤러 또는 분산된 웹 분석기가 포함될 수 있습니다. 서버당 웹 분석기 요소를 하나만 포함할 수 있습니다.
특성
특성 | 값 | 설명 |
---|---|---|
server |
true|false |
분산된 웹 분석기의 일부인 경우 이 특성은 서버가 웹 분석기에 대해 중앙 관리를 실행하는지 여부를 지정합니다. 분산된 웹 분석기는 서버를 하나만 포함할 수 있습니다. 웹 분석기의 로컬 인스턴스에 대해서는 "true"여야 합니다. |
max-targets |
<값> |
웹 분석기가 사용하는 프로세서 수를 지정합니다. 기본값: 1 |
link-processing |
true|false |
분산된 웹 분석기의 일부인 경우 이 특성은 서버가 항목 파이프라인에 추출된 링크를 처리하는지 여부를 지정합니다. 분산된 웹 분석기는 하나의 클러스터에서 여러 개의 링크 프로세서 인스턴스를 포함할 수 있습니다. 단일 서버 웹 분석기에 대해서는 "true"여야 합니다. |
lookup-db |
true|false |
분산된 웹 분석기의 일부인 경우 이 특성은 링크에서 데이터를 조회하는 데 서버가 사용되는지 여부를 지정합니다. 분산된 웹 분석기는 하나의 클러스터에서 여러 개의 링크 lookup-db 인스턴스를 포함할 수 있습니다. 단일 서버 웹 분석기에 대해서는 "true"여야 합니다. |
redundant-lookup |
true|false |
분산된 웹 분석기의 일부인 경우 이 특성은 서버가 장애 조치(failover)를 위한 중복 조회 데이터베이스를 포함하는지 여부를 지정합니다. 분산된 웹 분석기는 하나의 클러스터에서 여러 개의 중복 조회 데이터베이스 인스턴스를 포함할 수 있지만 서버에 lookup-db가 설정되어 있어야 합니다. |
설명
분산된 웹 분석기를 설치하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
예제
<webanalyzer
server="true" max-targets="1"
link-processing="true" lookup-db="true"
redundant-lookup="false"
/>
searchengine
호스트(서버)에 인덱서 및 쿼리 일치 구성 요소를 비롯한 코어 검색 구성 요소가 포함된 경우에 추가됩니다.
특성
특성 | 값 | 설명 |
---|---|---|
row |
<값> |
서버가 속하는 검색 행 또는 인덱서 행입니다. |
column |
<값> |
서버가 속하는 인덱스 열입니다. |
설명
이러한 특성은 이 정보 및 searchcluster 태그에서 검색된 정보를 기반으로 검색 그리드에서 서버가 속하는 위치를 지정합니다.
예제
<searchengine row="0" column="0" />
query
호스트(서버)에서 쿼리 및 결과 처리를 사용하도록 설정하려면 이 요소를 추가합니다. 내결함성 및 성능을 위해 하나 이상의 서버(호스트)에서 쿼리 구성 요소를 구성할 수 있습니다.
특성
없음
예제
<query />
row
콘텐츠 인덱싱 여부, 백업 인덱서인지 여부 및 행에 검색 기능이 설정되었는지 여부와 같은 검색 행 또는 인덱서 행의 역할을 설명합니다.
특성
특성 | 값 | 설명 |
---|---|---|
id |
<값> |
행 번호이며, 0으로 시작하고 각 행 태그에 대해 1씩 순차적으로 증가해야 합니다. |
index |
primary|secondary|none |
행에 인덱싱이 포함되는지 여부, 내결함성 설정에서 기본 인덱서 또는 보조 인덱서인지 여부, 행에 인덱서가 없는지 여부(none)를 지정합니다. 중요 기본 인덱서는 항상 행 id="0"에 있어야 합니다. |
search |
true|false |
행에 검색 발송자가 포함되는지 여부를 지정합니다. |
설명
검색 클러스터를 구성하는 방법에 대한 자세한 내용은 검색 클러스터 설명서를 참조하십시오.
예제
단일 노드 예제:
<searchcluster>
<row id="0" index="primary" search="true" />
</searchcluster>
다중 노드 예제:
<searchcluster>
<row id="0" index="primary" search="false" />
<row id="1" index="secondary" search="true" />
<row id="2" index="none" search="true" />
</searchcluster>
단일 서버 배포의 deployment.xml 예제
다음은 단일 서버 배포를 위한 예제 구성 파일입니다.
<?xml version="1.0" encoding="utf-8" ?>
<deployment
version="14"
modifiedBy="domain\user"
modifiedTime="2009-03-14T14:39:17+01:00"
comment="Comment"
xmlns="https://www.microsoft.com/enterprisesearch"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="https://www.microsoft.com/enterprisesearch
deployment.xsd">
<instanceid>FAST Search Server Single Node</instanceid>
<connector-databaseconnectionstring>
<![CDATA[jdbc:sqlserver://sqlservername\instancename:portnuber;
DatabaseName=dbname]]>
</connector-databaseconnectionstring>
<host name="single01.search.contoso.com">
<admin />
<document-processor processes="4"/>
<content-distributor id="0" />
<indexing-dispatcher />
<crawler role="single" />
<webanalyzer
server="true" max-targets="1"
link-processing="true" lookup-db="true"
redundant-lookup="false"
/>
<searchengine row="0" column="0" />
<query />
</host>
<searchcluster>
<row id="0" index="primary" search="true" />
</searchcluster>
</deployment>
XML 스키마
다음 XML 스키마는 구성 요소 배포 구성 파일 형식을 지정합니다.
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema targetNamespace="https://www.microsoft.com/enterprisesearch"
elementFormDefault="qualified"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns="https://www.microsoft.com/enterprisesearch">
<!-- *********************** Global elements ********************* -->
<xs:element name="deployment" type="CT_deployment" />
<!-- ************************ Simple types ********************** -->
<xs:simpleType name="ST_crawler-role">
<xs:restriction base="xs:string">
<xs:enumeration value="single"></xs:enumeration>
<xs:enumeration value="multi"></xs:enumeration>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="ST_index">
<xs:restriction base="xs:string">
<xs:enumeration value="primary"></xs:enumeration>
<xs:enumeration value="secondary"></xs:enumeration>
<xs:enumeration value="none"></xs:enumeration>
</xs:restriction>
</xs:simpleType>
<!-- ************************ Complex types ********************** -->
<xs:complexType name="CT_deployment">
<xs:sequence minOccurs="1" maxOccurs="unbounded">
<xs:element name="instanceid" minOccurs="1" maxOccurs="1" type="xs:string" />
<xs:element name="connector-databaseconnectionstring" minOccurs="1"
maxOccurs="1" type="xs:string" />
<xs:element name="host" type="CT_host" minOccurs="1" maxOccurs="unbounded" />
<xs:element name="searchcluster" type="CT_searchcluster" minOccurs="1"
maxOccurs="1" />
</xs:sequence>
<xs:attribute name="version" use="optional" type="xs:int" />
<xs:attribute name="modifiedBy" use="optional" type="xs:string" />
<xs:attribute name="modifiedTime" use="optional" type="xs:dateTime" />
<xs:attribute name="comment" use="optional" type="xs:string" />
</xs:complexType>
<xs:complexType name="CT_host">
<xs:all>
<xs:element name="admin" type="CT_admin" minOccurs="0" maxOccurs="1" />
<xs:element name="content-distributor" type="CT_content-distributor"
minOccurs="0" maxOccurs="1" />
<xs:element name="indexing-dispatcher" type="CT_indexing-dispatcher"
minOccurs="0" maxOccurs="1" />
<xs:element name="document-processor" type="CT_document-processor"
minOccurs="0" maxOccurs="1" />
<xs:element name="crawler" type="CT_crawler" minOccurs="0" maxOccurs="1" />
<xs:element name="webanalyzer" type="CT_webanalyzer" minOccurs="0"
maxOccurs="1" />
<xs:element name="searchengine" type="CT_searchengine" minOccurs="0"
maxOccurs="1" />
<xs:element name="query" type="CT_query" minOccurs="0" maxOccurs="1" />
<xs:element name="custom" type="CT_custom" minOccurs="0" maxOccurs="1" />
</xs:all>
<xs:attribute name="name" type="xs:string" use="required" />
<xs:attribute name="useadminservicehttps" use="optional" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:complexType name="CT_admin" />
<xs:complexType name="CT_content-distributor">
<xs:attribute name="id" use="optional" type="xs:int" default="1" />
</xs:complexType>
<xs:complexType name="CT_indexing-dispatcher" />
<xs:complexType name="CT_document-processor">
<xs:attribute name="processes" use="optional" type="xs:int" default="1" />
</xs:complexType>
<xs:complexType name="CT_crawler">
<xs:attribute name="role" type="ST_crawler-role" />
<xs:attribute name="multi-node-scheduler" use="optional" type="xs:boolean"
default="false"/>
<xs:attribute name="node-scheduler" use="optional" type="xs:boolean"
default="false"/>
<xs:attribute name="duplicate-server" use="optional" type="xs:boolean"
default="false"/>
<xs:attribute name="duplicate-server-replica-host" use="optional"
type="xs:string"/>
<xs:attribute name="duplicate-server-replica" use="optional" type="xs:boolean"
default="false"/>
</xs:complexType>
<xs:complexType name="CT_webanalyzer">
<xs:attribute name="server" use="required" type="xs:boolean" />
<xs:attribute name="lookup-db" use="required" type="xs:boolean" />
<xs:attribute name="link-processing" use="required" type="xs:boolean" />
<xs:attribute name="max-targets" use="optional" type="xs:int" />
</xs:complexType>
<xs:complexType name="CT_searchengine">
<xs:attribute name="row" type="xs:int" use="required" />
<xs:attribute name="column" type="xs:int" use="required" />
</xs:complexType>
<xs:complexType name="CT_query" />
<xs:complexType name="CT_custom">
<xs:attribute name="ref" type="xs:string" use="required" />
</xs:complexType>
<xs:complexType name="CT_searchcluster">
<xs:sequence>
<xs:element name="row" type="CT_row" minOccurs="1" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
<xs:complexType name="CT_row">
<xs:attribute name="id" type="xs:int" use="required" />
<xs:attribute name="index" type="ST_index" use="required" />
<xs:attribute name="search" type="xs:boolean" use="required" />
</xs:complexType>
</xs:schema>