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)。

您必須且只能在 FAST Search Server 2010 for SharePoint 管理伺服器上建立及修改 deployment.xml 檔案。

注意

若要修改設定檔，請確認您符合下列基本要求：您是安裝有 FAST Search Server 2010 for SharePoint 之電腦的 FASTSearchAdministrators 本機群組成員。

元素快速對照表

下表列出 deployment.xml 中的元素。這些元素可以任何順序出現。

元素	描述
<部署>	最上層元素會說明完整的安裝
<instanceid>	SCOM 所用的 FAST Search Server 2010 for SharePoint 執行個體唯一名稱。
<connector-databaseconnectionstring>	設定資料的索引連接器所用的 JDBC URL，是供 FAST Search 資料庫連接器和 FAST Search Lotus Notes 連接器使用。
<主機>	FAST Search Server 2010 for SharePoint 部署中的每部伺服器都會在主機標記中定義。每個主機 (伺服器) 會保留一組元素，來判定伺服器上要執行的元件。
<搜尋叢集>	會定義查詢比對及索引節點 (搜尋叢集) 的多部伺服器設定，並說明哪一部分的安裝會處理查詢與執行索引，亦會指定是否啟用容錯。
<admin>	為 host 元素的一部分，會指定主機 (伺服器) 是否具備管理元件。
<document-processor>	為 host 元素的一部分，會指定主機 (伺服器) 是否具備項目處理元件。
<content-distributor>	為 host 元素的一部分，會指定主機 (伺服器) 是否具備內容散發者元件。
<indexing-dispatcher>	為 host 元素的一部分，會指定主機 (伺服器) 是否具備索引發送程式元件。
<crawler>	為 host 元素的一部分，會指定主機 (伺服器) 是否具備 Web 編目程式元件。
<webanalyzer>	為 host 元素的一部分，會指定主機 (伺服器) 是否具備 Web 分析器元件。
<searchengine>	為 host 元素的一部分，會指定主機 (伺服器) 是否具備搜尋叢集元件 (索引或查詢比對，或兩者)。
<query>	為 host 元素的一部分，會指定主機 (伺服器) 是否具備查詢處理元件。
<row>	為 searchcluster 元素的一部分，會指定搜尋叢集 (部署) 中單一搜尋資料列或索引器資料列中的功能。

運作方式

安裝後設定精靈會使用 deployment.xml 檔案來設定本機伺服器。在管理伺服器上，精靈會擷取本機複本；而在非管理伺服器上，精靈會擷取管理伺服器的複本。

deployment.xml 中的資訊是用以產生本機設定檔，以用來設定 FAST Search Server 2010 for SharePoint 執行個體。

本機設定檔會在安裝後設定期間及呼叫 Cmdlet Set-FastSearchConfiguration 時更新。

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	使用者\網域	選用；上一次修改部署檔案的使用者
modifiedTime	時間	選用；部署檔案上一次的修改時間
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>

主機

此元素會指定將在特定主機 (伺服器) 上執行的元件。請為 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>

搜尋叢集

包含索引設定方式的相關資訊。

重要

主要索引器必須一律位於 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 或大於 0。若備援有新增數個內容散發者，請為每個執行個體指派唯一 ID。

範例

<content-distributor id="0" />

indexing-dispatcher

若主機 (伺服器) 具備索引發送程式元件，則會新增此元素

屬性

無

範例

<indexing-dispatcher />

crawler

若主機 (伺服器) 具備 Web 編目程式元件，則會新增此元素

注意

當您使用選用的 FAST Search Web 編目程式時，請指定此元素。若您使用 FAST Search 連接器內容 Search Service 應用程式 (內容 SSA) 的網站索引連接器選項，就不需要指定此元素。

安裝可以含有數個單一伺服器 Web 編目程式或一個分散式的 Web 編目程式。但每部主機 (伺服器) 都只能定義一個 Web crawler 元素。

屬性

屬性	值	描述
role	single|multi	會指定編目程式為獨立編目程式，或分散式編目程式的一部分。 預設值：單一
multi-node-scheduler	true|false	若為分散式編目程式的一部分，則此屬性會指定伺服器是否要執行多節點排程器。分散式編目程式只能有一個多節點排程器。若 role 是「單一」的，則可忽略。
node-scheduler	true|false	此屬性會指定伺服器是否要執行節點排程器。分散式編目程式可以有數個節點排程器，但每部伺服器都只能有一個節點排程器。若 role 是「單一」的，則可忽略。
duplicate-server	true|false	此屬性會指定伺服器是否要執行重複的伺服器。分散式編目程式可以有數個重複的伺服器，但每部伺服器都只能有一個重複的伺服器。若 role 是「單一」的，則可忽略。
duplicate-server-replica	true|false	此屬性會指定伺服器是否要執行重複的伺服器複本。分散式編目程式可以有數個重複的伺服器複本，但每部伺服器都只能有一個重複的伺服器複本。若 role 是「單一」的，則可忽略。
duplicate-server-replica-host	<值>	此屬性會指定本機重複伺服器會使用的重複伺服器複本的位置。若 role 等於「單一」，或本機伺服器未指定重複伺服器時，則可忽略。

註解

請參閱 使用 FAST Search Web 編目程式編目 Web 內容，以取得更多不同 Web 編目程式元件的詳細資訊。

範例

下列範例會說明三部主機，其中執行了 Web 編目程式、一個多節點排程器、兩個節點排程器，及兩部彼此複寫的重複伺服器之情況。

<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

若主機具備 Web 分析器元件，則會新增此元素。叢集可以有數個單一節點編目程式，或一個分散式的 Web 分析器。但每部伺服器只能有一個 Web 分析器元素。

屬性

屬性	值	描述
server	true|false	若為分散式 Web 分析器的一部分，則此屬性會指定伺服器是否執行 Web 分析器的集中管理。分散式的 Web 分析器僅可有一部伺服器，且 Web 分析器的本機執行個體必須為 True。
max-targets	<值>	會指定 Web 分析器要使用的處理器數目。 預設值：1
link-processing	true|false	若為散佈式 Web 分析器的一部分，則此屬性會指定伺服器是否會處理項目管線中擷取的連結。分散式 Web 分析器在叢集中，可以有數個連結處理器執行個體。且單一伺服器 Web 分析器必須為 True。
lookup-db	true|false	若為分散式 Web 分析器的一部分，則此屬性會指定是否要使用伺服器來查閱連結的資料。分散式 Web 分析器在叢集中，可以有數個 lookup-db 執行個體。且單一伺服器 Web 分析器必須為 True。
redundant-lookup	true|false	若為分散式 Web 分析器的一部分，則此屬性會指定伺服器是否要有備援查閱資料庫以容錯移轉。分散式 Web 分析器在叢集中，可以有數個備援查閱資料庫執行個體，但僅限於啟用 lookup-db 的伺服器。

註解

如需安裝分散式 Web 分析器的詳細資訊，請參閱：

• waadmin.exe 參照

• 規劃 FAST Search Server 伺服器陣列拓撲 (FAST Search Server 2010 for SharePoint)

• 規劃備援及可用性 (FAST Search Server 2010 for SharePoint)

範例

<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>

See Also

Concepts

重新設定伺服器陣列部署 (FAST Search Server 2010 for SharePoint)