第二步 服务代理配置

服务代理配置

管理员通过 %SuperMap iPortal_HOME%/webapps/iportal/WEB-INF 目录下的 iportal.xml 文件中的 <serviceProxy> 子节点元素，设置是否启用独立部署的服务代理。详情请参见：iPortal 配置文件说明。

具体示例如下所示：

<IportalConfig>

   ...

   <serviceProxy>

       <enable>true</enable>

       <enableBuiltinProxy>false</enableBuiltinProxy>

       <port>8195</port>

       <rootUrlPostfix>portalproxy</rootUrlPostfix>

       <httpConnPoolInfo>

            <maxTotal>100</maxTotal>

            <defaultMaxPerRoute>10</defaultMaxPerRoute>

            <connectionTimeout>30000</connectionTimeout>

            <socketTimeout>30000</socketTimeout>

      </httpConnPoolInfo>

   ...

   </serviceProxy>

</IportalConfig>

• <enable>：设置是否启用服务代理，这里的服务代理是指内置的服务代理或独立部署的服务代理，默认值：true，启用服务代理。
• <enableBuiltinProxy>：设置是否启用内置的服务代理，默认值：true，启用内置的服务代理，此处需要启用独立部署的服务代理，所以该值需设置为：false。
• <port>：设置代理服务地址的端口号，需要与 iPortal 独立代理安装包中设置的端口号保持一致。独立部署的服务代理默认端口号为：8195，您可以通过修改服务代理安装包的 Tomcat 端口号，来改变这个代理地址的端口号。关于如何修改服务代理安装包的端口号，请参见：iPortal 端口介绍。该端口号也是通过 Nginx 负载均衡多个代理服务时监听的端口。
• <rootUrlPostfix>：为代理服务根地址设置统一的后缀名，需要与 iPortal 独立代理安装包中设置的后缀名一致（ %SuperMap iPortal_Proxy_HOME%/webapps/ROOT/WEB-INF/ iportal-proxy.xml 文件中 <serviceProxy>节点下的 <rootUrlPostfix>配置项 ）。默认的后缀名为：portalproxy，完整的代理服务地址例如：http://192.168.120.40:8195/portalproxy/iserver/services/map-changchun/rest，您可以根据实际需要设置该后缀名，也可以设置为空值，即不设置后缀名。
• <httpConnPoolInfo>：代理服务的连接池设置项，用于设置代理服务内部的 HttpClient 连接池。调整该节点下的各个设置项，从而提升代理服务的并发性能。
• <maxTotal>：设置整个连接池最大连接数。默认值是：100。您可以根据门户最大并发访问用户数来设置。
• <defaultMaxPerRoute>：对于一个路由地址，设置最多存在几个连接。默认值是：10。例如：您可以根据门户中单个服务的最大并发访问用户数来设置。
• <connectionTimeout>：代理转发请求时，与服务器间建立连接的超时时间，单位为 ms。默认值是：30000。您可以根据网络环境设置。
• <socketTimeout>：代理转发请求时，从服务器读取数据的超时时间，单位为 ms。默认值是：30000。您可以根据网络环境设置。

如果 iPortal 运行在双网卡或多网卡的网络环境中，希望通过不同 ip 访问 iPortal 时，服务代理地址会动态的显示 ip 地址，则需在以上配置的基础上，在<serviceProxy>节点下增加<proxyServerRootUrl>子节点（粗体部分代码），具体配置如下：

<serviceProxy>

    <enable>true</enable>

    <enableBuiltinProxy>false</enableBuiltinProxy>

    <port>8195</port>

    <rootUrlPostfix>portalproxy</rootUrlPostfix>

    <proxyServerRootUrl>http://{ProxyHost}[:port]</proxyServerRootUrl>

    <httpConnPoolInfo>

      <maxTotal>100</maxTotal>

      <defaultMaxPerRoute>10</defaultMaxPerRoute>

      <connectionTimeout>30000</connectionTimeout>

      <socketTimeout>30000</socketTimeout>

    </httpConnPoolInfo>

  </serviceProxy>

其中，{ProxyHost} 是占位符，会动态显示 ip 地址，[:port] 变量表示端口，填写代理后的服务监听端口即可，例如：<proxyServerRootUrl>http://{ProxyHost}:8195</proxyServerRootUrl>

注意：

• 启用服务代理后，在浏览器窗口输入 iPortal 门户首页地址：http://<server>:<port>/iportal（server 取决于部署 iPortal 的服务器的 IP，port 取决于 server.xml 文件（位于 %SuperMap iPortal_HOME%\conf\server.xml ）中配置的端口号，与上述代理配置项无关）即可访问 iPortal 首页。

• 停用服务代理后，需要重启 iPortal 服务，设置才会生效。

请参见

• 第一步 数据库配置
• 第三步 iPortal 与代理服务的 session 共享配置