全局搜索配置

SuperMap iPortal 提供了全局搜索功能，全局搜索可以对门户的所有资源进行检索，而无需在每一资源分类中逐一检索。iPortal 的全局搜索功能基于 Elasticsearch 分布式搜索引擎实现，有关全局搜索功能的使用，请参见：全局搜索。

SuperMap iPortal 内置全局搜索

SuperMap iPortal 内置的全局搜索是指 iPortal 产品包中自带的全局搜索。启动 iPortal 服务时，已默认启用了内置全局搜索，无需做额外配置。该配置方式的优点是：操作简单，针对小型的门户网站应用，可选择内置的全局搜索。

作为 iPortal 门户的管理员，如果您部署了自己的 Elasticsearch 搜索服务器，不想使用 iPortal 中自带的 Elasticsearch，或者希望更改 iPortal 中 Elasticsearch 的默认配置，可以通过以下两个步骤进行配置：

1. 打开 %SuperMap iPortal_HOME%/search/WEB-INF 目录下的 search-beans.xml 配置文件，可以根据您自己部署的 Elasticsearch 服务器更改参数，两者需保持一致。

<bean id="esSetting" class="com.supermap.iportal.search.commontypes.ESSetting">

    <property name="address" value="127.0.0.1"></property>

    <property name="port" value="9300"></property>  

    <property name="clusterName" value="myapplication"></property>

    <!-- <property name="nodeName" value="node1"></property> -->

    <property name="indexName" value="portalsearch"></property>

    <property name="numberOfShards" value="5"></property>

    <property name="numberOfReplicas" value="0"></property>

</bean>

• address：Elasticsearch 的 IP 地址。默认为本机 IP：127.0.0.1，使用 iPortal 自带的 Elasticsearch。
• port：Elasticsearch 的 TCP 协议通讯端口号。默认值：9310。
• clusterName：Elasticsearch 的集群名称。
• nodeName：Elasticsearch 的节点名称。可选配置项，如需指定 Elasticsearch 节点，在配置时需要将该行的注释打开。
• indexName：Elasticsearch 里存储 iPortal 所有资源索引的索引库名称。用户可自定义名称，若对应的索引库不存在，iPortal 将自动创建索引库。
• numberOfShards：索引分片数。设置 Elasticsearch 对索引进行划分的分片数量。默认值：5，将索引划分为 5 片。
• numberOfReplicas：索引拷贝数。默认值：0，没有拷贝索引副本。

如果您仅想更改 iPortal 内置 ES 的默认配置（如端口号、集群名、节点名等），而非使用自己部署的 ES 服务器， 则在修改完 search-beans.xml 文件后，还需同步修改 %SuperMap iPortal_HOME%/bin/startes.bat(sh) 文件中对应配置项，保持两者一致，以 startes.bat 为例，具体如下：

@echo off

set "CUR_DIR_TEMP=%~dp0"

set JAVA_HOME=%CUR_DIR_TEMP%\..\support\jre

set PATH=%JAVA_HOME%\bin;%path%

rem start elasticsearch

if not ""%ESDATADIR%""=="""" goto okdatadir

set ESDATADIR=%CUR_DIR_TEMP%\..\data\elasticsearch\data

:okdatadir

if not ""%ESLOGSDIR%""=="""" goto oklogdir

set ESLOGSDIR=%CUR_DIR_TEMP%\..\data\elasticsearch\logs

:oklogdir

set ESNODENAME=node1

set ESClUSTERNAME=myapplication

set ESHTTPPORT=9210

set ESTCPPORT=9310

"%CUR_DIR_TEMP%\..\database\elasticsearch\bin\elasticsearch.bat" -Epath.data=%ESDATADIR% -Epath.logs=%ESLOGSDIR% -Ecluster.name=%ESClUSTERNAME% -Enode.name=%ESNODENAME% -Ehttp.port=%ESHTTPPORT% -Etransport.tcp.port=%ESTCPPORT% -Enetwork.host=127.0.0.1 -p espid

2. 修改 %SuperMap iPortal_HOME%/webapps/iportal/WEB-INF 目录下的 iportal.xml 配置文件，具体配置项如下：

<IportalConfig>

  ...

  <modulesConfig>

    <searchModuleConfig class="com.supermap.server.config.BuildinSearchConfig">

      <enable>true</enable>

      <reindexAllResources>true</reindexAllResources>

      <startElasticSearch>true</startElasticSearch>

      <port>8192</port>

    </searchModuleConfig>

  </modulesConfig>

  ...

</IportalConfig>

• <enable>：是否开启全局搜索功能。默认值： true。
• <reindexAllResources>：是否重新索引已有 iPortal 资源。重建索引后，此配置会自动设置为 false。
• <startElasticSearch>：是否启用 iPortal 内置的 Elasticsearch。默认值：true。如果您希望使用自己搭建的 Elasticsearch 服务器，需要将该值设置为 false。
• <port>：全局搜索服务的端口。默认值：8192。