Linux系统使用war包部署iServer（中间件：Tomcat）

作者：yx

---

前言

SuperMap iServer 10i(2021) 的 war 包可部署在多种操作系统下的多种中间件中，以下将介绍在Linux上部署，中间件采用的是tomcat。
使用 war 包部署 SuperMap iServer 10i(2021) 时，需要先安装 JRE/JDK、SuperMap iObjects Java 10i(2021)，并进行环境变量的配置。若使用32 bit 的 JRE/JDK，则需要使用32 bit 的 SuperMap iObjects Java；若使用64 bit 的 JRE/JDK，则需要使用64 bit 的 SuperMap iObjects Java。

---

一、下载war包

在咱们超图官网下载iserver-war包
下载后放到Linux系统，通过命令

unzip xxxxx.zip

解压war包，解压后的目录如下：

再通过命令，解压包support_linux_x64.tar.gz

tar -vxzf support_linux_x64.tar.gz

二、下载安装JDK

JDK版本不建议采用过高或过低的版本，推荐1.8.x，这里以1.8.0_11为例
下载地址https://pan.baidu.com/s/1fSbe2AFxaXWLWWY2h28w4g
提取码：m7ln

三、配置环境变量

在系统的 profile 文件（默认路径为：/etc/profile）中设置

1、JAVA_HOME

export JAVA_HOME=/JDK 的目录

参考配置：

2、UGO_HOME

export UGO_HOME=/SuperMap iObjects Java 的安装目录

iserver-war包有内置的Java组件，因此不需要再下载SuperMap iObjects Java产品
参考配置：

3、LD_LIBRARY_PATH

export LD_LIBRARY_PATH=$UGO_HOME/bin:$LD_LIBRARY_PATH

参考配置：

4、CLASSPATH

export CLASSPATH=.:$JAVA_HOME/lib:$JAVA_HOME/lib/tools.jar:$JAVA_HOME/lib/dt.jar

参考配置：

CLASSPATH 中当前目录“.”不能丢

5、PATH

将 jdk 安装目录下的 bin 目录以及，jidk下边的jre的bin目录增加到PATH变量中
参考配置：

6、SUPERMAP_ROOT

设置 SUPERMAP_ROOT 环境变量，使其指向字体库 fonts 文件夹的父目录
在此目录下/supermap-iserver-10.2.1-war/support_linux_x64/fonts

总的配置如下：

7、生效

执行 source /etc/profile 命令，使上述设置生效。

注意：

• linux 下用冒号 “:” 来分隔路径；
• $PATH / $CLASSPATH / $JAVA_HOME 是用来引用原来的环境变量的值；
• export 是把这六个变量导出为全局变量；
• 大小写必须严格区分。

四、下载Tomcat

tomcat版本不建议使用过低或者过高的版本，推荐8.5.xx
这里以8.5.77为例，下载地址https://pan.baidu.com/s/14ktFXASSElFWLpw1DXZpEw
提取码：alb2
启动 Tomcat，把 war 包放入如下目录：【Tomcat 根目录】\webapps，Tomcat 就可以将 war 包发布为 Web 服务。例如启动 Tomcat，把 iserver.war 放入 webapps 目录，就完成了 SuperMap iServer 核心功能的启动。访问 http://<server>:<port>/iserver/services，就能获取 SuperMap iServer 所有可用服务的列表。使用 iserver#help.war 将帮助文档发布为在线形式后，访问的 URI 为：http://<server>:<port>/iserver/help。使用 iserver#iClient.war 将 iClient 发布为在线服务后，访问的 URI 为：http://:/iserver/iClient。

注意：

按照上述操作完成之后，启动tomcat，可能会出现tomcat启动成功，但是iserver启动失败，并报以下错：

是由于tomcat和iserver本身的jar包冲突导致
解决办法：
将非war包中的conf/catalina.properties替换到，tomcat中间件的相同路径下，替换之后文件配置如下：

五、部署成功

至此就部署结束了！

总结

1. 当遇到jar包冲突时，替换catalina.properties文件
2. JDK和tomcat版本使用过低或者过高会出现问题
3. 环境变量的配置参照上述配置，切忌少配、误配
4. 如果部署失败可以查看tomcat的logs日志，根据日志查看报错