SuperMap iServer 作为一个 Web 应用可以部署到多种 Web 服务器中,SuperMap iServer 默认部署在自带的 Tomcat 中,启动 Tomcat 就能够启动 SuperMap iServer,并同时启动 SuperMap iServer 所提供的服务。
在 %SuperMap iServer_HOME%/bin 目录下,提供了启动/停止 SuperMap iServer 服务器的批处理文件:
- startup.bat:在 Windows 系统下启动 SuperMap iServer 服务器
- startup.sh:在 Linux 系统下启动 SuperMap iServer 服务器
- shutdown.bat:在 Windows 系统下停止 SuperMap iServer 服务器
- shutdown.sh:在 Linux 系统下停止 SuperMap iServer 服务器
此外,在 %SuperMap iServer_HOME%/bin 目录下提供了 iserver.bat/iserver.sh 来启动和调试 SuperMap iServer,用法如下:
用法: iserver [选项]
选项:
-start 启动 iServer
-stop 停止 iServer
-v / -version 显示 iServer 的版本信息,包含所用的 JRE/JDK、SuperMap iObjects Java 等参数信息
-help 显示帮助
在 Windows 平台下使用 setup 安装包安装 SuperMap iServer 后,您在开始菜单中也可以找到 SuperMap iServer 启动/停止的快捷方式(以 Windows XP 系统为例):
- 开始 → 程序 → SuperMap → SuperMap iServer 11i(2022) → 启动 iServer 服务
- 开始 → 程序 → SuperMap → SuperMap iServer 11i(2022) → 停止 iServer 服务
注:SuperMap iEdge 未提供setup安装包,该启动方式仅用于SuperMap iServer。
SuperMap iServer 服务器启动后,会自动发布默认的 GIS 服务。访问管理服务页面(本机):http://localhost:8090/iserver/admin-ui/home/,即可进行服务管理;访问 http://localhost:8090/iserver/services(本机),即可查看 SuperMap iServer 服务器默认发布的所有 GIS 服务列表。(iEdge 不提供示范GIS服务,首次启动服务列表界面时,服务列表为空。)
SuperMap iServer 提供了服务器非正常关闭时自动重启功能,及系统配置文件中控制该功能是否开启的<restartWhenCrash>参数。
高级配置
以 Windows 服务的方式启动
除了上述方式启动/停止 SuperMap iServer 服务外,还可以通过 Windows 服务的方式来启动/停止 SuperMap iServer,当然首先需要将 Tomcat 注册为 Windows 服务。详细步骤请参考以 Windows 服务的方式启动 iServer。
指定配置文件目录启动
SuperMap iServer 支持指定配置目录启动。配置目录包含了 SuperMap iServer 中的所有配置信息。非 war 包中,默认的配置目录位于 %SuperMap iServer_HOME%/webapps/iserver/WEB-INF(不含 lib),war 包中,默认的配置目录位于 %iserver 服务目录%/WEB-INF(不含 lib)。
高级用户启动时,可设置名为 iserver.config 的 Java 虚拟机参数类指定 iServer 配置目录的位置,例如在 windows 下运行如下命令启动:
set JAVA_OPTS=%JAVA_OPTS% -Diserver.config="D:/WEB-INF1"
startup.bat
即可使用“D:/WEB-INF1”目录包含的配置文件部署 SuperMap iServer。
在 Tomcat 中,可使用如下命令来同时定制 Tomcat 的 server.xml 和 SuperMap iServer 的配置文件:
启动:
set JAVA_OPTS=%JAVA_OPTS% -Diserver.config="D:/WEB-INF1"
startup.bat -config="D:/server1.xml"
停止:
shutdown.bat -config="D:/server1.xml"
指定应用服务器名称启动
SuperMap iServer 提供了默认的 URL 根地址,即 http://<ip>:<port>/iserver,若您需要将 "iserver" 更改为其他应用服务器名称,并在访问 iServer 时能够默认显示跳转,请遵循如下步骤:
1、将 %SuperMap iServer_HOME%/webapps 下 iserver 文件夹名更改为指定名称;
2、将 %SuperMap iServer_HOME%/webapps/ROOT/index.htm 文件中,如下代码中的 iserver 更改为上一步中的名称
window.onload=function ()
{
window.location.href="iserver";
}
设置监控进程通信端口号
SuperMap iServer 支持指定守护进程与主进程间通信端口号。并提供两种方式设置:
1、修改 setenv.sh/setenv.bat
打开【iServer 根目录】\bin\setenv.sh(Linux)或 setenv.bat(Windows),添加如下内容:
set com.supermap.server.mainprocessport=8091
set com.supermap.server.daemonprocessport=8092
2、修改 iserver-system.xml
打开【iServer 根目录】\webapps\iserver\WEB-INF\iserver-system.xml,在<properties>中添加:
<daemonprocessport>8092</daemonprocessport>
<mainprocessport>8091</mainprocessport>
配置完成后如下:
<properties> <outputPath>../../webapps/{contextPath}/output</outputPath> <outputSite>http://{ip}:{port}/{contextPath}/output/</outputSite> <realspaceCacheAccessKey>70 39 -37 -116 -91 105 73 111 -71 90 -24 -17 -115 80 -56 -17</realspaceCacheAccessKey> <realspaceSecurityEnabled>true</realspaceSecurityEnabled> <envCheckEnabled>true</envCheckEnabled> <daemonprocessport>8092</daemonprocessport> <mainprocessport>8091</mainprocessport> </properties>