war 包部署前的环境配置

发送反馈

SuperMap iServer 11i(2023) 的 war 包可部署在多种操作系统下的多种中间件中（参见：硬件要求和软件要求）。

使用 war 包部署 SuperMap iServer 11i(2023) 时，需要先安装 JRE/JDK、SuperMap iObjects Java 11i(2023)，并进行环境变量的配置。若使用32 bit 的 JRE/JDK，则需要使用32 bit 的 SuperMap iObjects Java；若使用64 bit 的 JRE/JDK，则需要使用64 bit 的 SuperMap iObjects Java。若需要使用 iServer 内置 Spark，请参考使用 iServer 内置 Spark 前的环境准备；需要使用处理自动化服务，请参考使用处理自动化服务。

Windows 系统

（1）JRE（1.8版本）设置环境变量如下：

如果安装的是 JDK，则设置 JAVA_HOME 为 JDK 的目录；如果安装的是 JRE，则需要设置 JRE_HOME 为 JRE 的目录。

（2）SuperMap iObjects Java 环境变量

安装 SuperMap iObjects Java 时会自动设置，也可手工设置如下：

UGO_HOME，设置为 SuperMap iObjects Java 的目录。并将%UGO_HOME%\Bin 加入到系统的 PATH 环境变量中。

Linux 系统

（1）JRE（1.8版本）设置环境变量如下：

如果安装的是 JDK，则设置 JAVA_HOME 为 JDK 的目录；如果安装的是 JRE，则设置 JAVA_HOME 为 JRE 的目录，比如在系统的 profile 文件（默认路径为：/etc/profile）中设置 JAVA_HOME 如下：

export JAVA_HOME=/JDK 的目录

（2）设置系统的编码方式如下：

export LANG=zh_CN.UTF-8

export LANG=zh_CN.UTF-8

unset LC_CTYPE

（3）设置 SuperMap iObjects Java 的环境变量

如果用户以 ROOT 用户安装 SuperMap iObjects Java，环境变量配置会自动写入到/etc/profile 文件，此时不需要额外设置。

如果用户没有以 ROOT 用户安装 SuperMap iObjects Java，需要进行如下设置：

设置 UGO_HOME，并将 UGO_HOME 加入 LD_LIBRARY_PATH 变量，如下：

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

export LD_LIBRARY_PATH=$UGO_HOME/bin:$LD_LIBRARY_PATH

设置 SUPERMAP_ROOT 环境变量，使其指向字体库 fonts 文件夹的父目录。例如在 SuperMap iObjects Java 中默认自带了 fonts，从而设置 SUPERMAP_ROOT 如下：

export SUPERMAP_ROOT=/SuperMap iObjects Java 的安装目录的父目录

设置使用 QT 自带的 offscreen 插件：

export QT_QPA_PLATFORM='offscreen'

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

（5）执行 echo 命令检查设置是否正确。

echo $LANG

echo $SUPERMAP_ROOT

echo $LD_LIBRARY_PATH

 

注意：若使用 Oracle 数据源，且数据库的编码方式为 GBK，请将 NLS_LANG 参数设置为"simplified chinese"_china.zhs16gbk，如下：

export NLS_LANG="simplified chinese"_china.zhs16gbk