调用实用工具文件以配置搜索适配器

使用联合搜索集成多个搜索引擎 › 配置联合搜索 › 为联合搜索生成配置 XML 文件 › 调用实用工具文件以配置搜索适配器

调用实用工具文件以配置搜索适配器

搜索引擎需要特殊编码的插件适配器。插件搜索适配器将常规搜索请求转换为搜索引擎专有格式，调用搜索引擎，然后返回搜索请求。

注意：如果配置了 CA SDM 以支持多方租用，则会将您的承租人一起传递到搜索引擎。联合搜索内置了对多方租用的支持。可以借助此支持功能，在单个 SharePoint 实施中按承租人隔离数据。

重要信息！ 在 adapters.properties 文件值中，不要使用 &（与符号）或空格。

遵循这些步骤:

使用加密密码实用工具，对搜索适配器的密码进行加密。要对密码进行加密，请导航到以下 CA SDM 目录：
```
$NXROOT\bin
```
运行以下命令以生成加密密码：
```
encrypt_pwd [-e] <搜索引擎密码>
```
默认选项为 -e。
从以下 CA SDM 目录打开 adapters.properties 文件：
```
$NX_ROOT\samples\cafedsearch
```
编辑 adapters.properties 文件。为要配置的适配器指定适当的参数。
对于 SharePoint，更新 adapters.properties 文件中的以下值：

sharepoint_username=

输入用于 SharePoint 访问的用户名。

sharepoint_password=

输入用于 SharePoint 访问的加密密码，如步骤 1 中所示。

sharepoint_hostname=

输入主机名。

sharepoint_domainName=

输入域名。

sharepoint_protocol=

输入通信协议（http 或 https）

sharepoint_portNumber=

输入端口号。默认值为 80。
对于 Google，更新 adapters.properties 文件中的以下值：

google_googleCx=

输入 Google 用于确定要使用的 Google 自定义搜索帐户的唯一密钥值。

google_googleApiKey=

输入用于帮助 Google 确定应用程序身份的唯一密钥值。要在 API 控制台中检索密钥，请激活 JSON/Atom 自定义搜索 API。此 API 为简单 API 访问提供了新的 API 密钥。
对于 CA Open Space，更新 adapters.properties 文件中的以下值：

openspace_protocol=

输入通信协议（http 或 https）

openspace_portNumber=

输入 CA Open Space 的端口号。默认为 8686。

openspace_default_tenant_userName=

如果没有为 CA SDM 配置多方租用，请输入用户名以便在 CA Open Space 中执行搜索。

openspace_default_tenant_password=

输入 CA Open Space 的加密密码。有关详细信息，请参阅步骤 1。

openspace_default_tenant_companyHost=

输入承租人公司的主机详细信息。
1. 对于 CA SDM 多方租用，在 openspace-tmpl.xml 中为每个承租人添加条目：
  例如，如果 CA SDM 包含的承租人名称为“Tenant1”，则必须在 openspace-tmpl.xml 文件中提供以下值：
```
<entry key="Tenant1"> 
```
```
 <bean class="com.ca.ServicePlus.cafedsearch.adapters.openspace.OpenSpaceCompanyDetail">
```
```
  <property name="userName" value="$(openspace_tenant1_userName)"/>
```
```
   <property name="password" value="$(openspace_tenant1_password)"/>
```
```
  <property name="companyHost" value="$(openspace_tenant1_companyHost)"/>
```
```
  </bean>
```
```
</entry>
```
2. 在 adapters.properties 文件中，为“Tenant1”添加以下条目：
```
openspace_tenant1_userName=
```
```
openspace_tenant1_password=
```
```
openspace_tenant1_companyHost=
```
  在 openspace-tmpl.xml 文件中，对于所有必需的承租人重复步骤 a 和 b。
为要配置的每个适配器调用一次 fs_adapters_cli。
- 若要配置 CA Open Space 适配器，请使用 bean 值“OpenSpaceSearchAdapter”，并使用“openspace-tmpl.xml”作为模板，如以下示例所示：
```
fs_adapters_cli -i -k OpenSpace -b OpenSpaceSearchAdapter -t "openspace-tmpl.xml" -o "openspace.xml"
```
- 若要配置 Google 适配器，请使用 bean 值“GoogleSearchAdapter”，并使用“google-tmpl.xml”作为模板，如以下示例所示：
```
fs_adapters_cli -i -k Google -b GoogleSearchAdapter -t "google-tmpl.xml" -o "google.xml"
```
- 若要配置 SharePoint 适配器，请使用 bean 值“SharePointSearchAdapter”，并使用“sharepoint-tmpl.xml”作为模板，如以下示例所示：
```
fs_adapters_cli -i -k SharePoint -b SharePointSearchAdapter -t "sharepoint-tmpl.xml" -o "sharepoint.xml"
```
用所选名称修改 -k 和 -o 属性值。有关联合搜索实用工具文件和属性的详细信息，请参阅联合搜索实用工具文件。
在安装后，如果存在任何错误，请检查位于以下 CA SDM 目录中的日志文件：
```
$NXROOT\log\jfedsearch.log
```
（可选）也可以创建自己的 XML 文件以用于注册。位于以下目录的 adapters-config.xml 中的所有适配器条目都会注册：
```
$NX_ROOT\samples\cafedsearch
```
要创建自己的 XML 文件以用于注册，也可以制作现有 adapters-config.xml 文件的副本（可选步骤）。将修改后的 adapters-config.xml 文件命名为您选择的名称。例如，xyz.xml 文件。
随修改后的 XML 文件 (xyz.xml) 使用 -c 选项以便注册适配器。
更改 bean.xml 中的 resource 值：<import resource="adapters-config.xml"/>。
在以下 CA SDM 目录中复制 adapters-config.xml 或修改后的 xyz.xml（步骤 11）以及任何关联适配器特定的 XML 文件（对于 Google 为 google.xml，对于 CA Open Space 为 openspace.xml，对于 SharePoint 为 sharepoint.xml）：
```
$NX_ROOT\bopcfg\www\CATALINA_BASE_FS\webapps\cafedsearch\WEB-INF
```
重新启动联合搜索 Tomcat 实例：
```
pdm_tomcat_nxd –c STOP –t FS
```
```
pdm_tomcat_nxd –c START –t FS
```
联合搜索适配器就配置好了。
验证并检查以下 CA SDM 目录中的错误日志文件：
```
$NX_ROOT\log\jfedsearch.log
```