安装后配置 |
启动 SuperMap iServer 时，iServer 采用了环境配置脚本（ %SuperMap iServer_HOME%/bin/setenv.sh）定义的默认设置，您不需要任何安装后配置即可开始使用 iServer。
默认设置包括以下几个方面：
如果您不想使用上述默认配置，可直接修改该脚本文件以使用自定义的配置或不使用该该环境配置脚本，而通过手工设置环境变量的方式来使用自定义的 JRE 和 JDK。在使用自定义的 JRE 与 iObjects 时，请注意保证 JRE/JDK、iObjects 与 iServer 位数的一致，即使用32位的 iServer 时，请使用32位的 JRE/JDK、iObjects；使用64 位的 iServer 时，请使用64 位的 JRE/JDK、iObjects。
此外，在 catalina 脚本（%SuperMap iServer_HOME%/bin/catalina.sh）中还定义了 iServer 对 JVM 内存的配置参数，包括堆内存的初始大小（-Xms）、堆内存的最大大小（-Xmx）和每个线程可使用的内存大小（-Xss）等。如果您不想使用默认配置，可直接修改该脚本文件以使用自定义的配置。当您使用 rpm 或 deb 安装包时，还可以不使用该脚本，通过手工设置环境变量的方式来使用自定义的参数。
除上述自定义配置外，如果您需要使用 Oracle 数据源，那么您也需要进行相关的环境配置。
如果您不想使用 iServer 启动服务时的默认配置，即不使用该环境配置脚本中的默认 JRE 和 JDK，那么可直接修改上述脚本文件以使用自定义的配置，或通过手工设置环境变量的方式来使用自定义的配置。
除上述自定义配置外，如果您需要使用 Oracle 数据源，那么您也需要进行相关的环境配置。
通过修改环境变量使用自定义的 JRE 时，您需要将%SuperMap iServer_HOME%/support 目录下的 jre 目录重命名或删除。因为 SuperMap iServer java 6R(2012)（版本号：6.1.0）之后（不含）的产品包中，如果不作此处理，将继续使用自带的 JRE。
根据使用 iServer 的软件要求，JRE 需要11.0.18+10版本。如果您安装的是 JDK，则需要设置 JAVA_HOME 为 JDK 的目录；如果安装的是 JRE，则设置 JRE_HOME 为 JRE 的目录。
以配置 JDK 为例，您可以通过以下方式设置环境变量：
（1）在系统的 profile 文件（默认路径为：/etc/profile）中设置 JAVA_HOME 如下：
export JAVA_HOME=/JDK 的目录
（2）使上述设置生效：
source /etc/profile
（3）执行 echo 命令检查设置是否正确：
echo $JAVA_HOME
JRE 的配置方式与 JDK 一致，仅将环境变量名改为 JRE_HOME 即可。
通过修改环境变量使用自定义的 iObjects 时，您需要将%SuperMap iServer_HOME%/support 目录下的 objectsjava 目录重命名或删除。因为 SuperMap iServer java 6R(2012)（版本号：6.1.0）之后（不含）的产品包中，如果不作此处理，将继续使用自带的 SuperMap iObjects Java。
请您根据 iServer 的软件要求，配置使用相应版本的 iObjects，如果版本不一致则不能保证 iServer 所有服务和功能的可用性。
设置使用自定义的 SuperMap iObjects Java 及其字体库的过程如下：
（1）在系统的 profile 文件（默认路径为：/etc/profile）中设置名为 UGO_HOME 的环境变量，并将 $UGO_HOME/Bin 加入 LD_LIBRARY_PATH 变量：
export UGO_HOME= /SuperMap iObjects Java 11i(2023) 的安装目录
export LD_LIBRARY_PATH =$UGO_HOME/Bin:$LD_LIBRARY_PATH
（2）设置 SUPERMAP_ROOT 环境变量，使其指向字体库 fonts 文件夹的父目录。例如在 SuperMap iObjects Java 中默认自带了 fonts，位于 $UGO_HOME/Support，从而设置 SUPERMAP_ROOT 如下：
export SUPERMAP_ROOT=$UGO_HOME/Support
（3）使上述设置生效：
source /etc/profile
（4）执行 echo 命令检查设置是否正确：
echo $LD_LIBRARY_PATH
SuperMap iServer 启动时使用的环境设置脚本（%SuperMap iServer_HOME%/bin/setenv.sh）中还设置了系统的编码方式，如果您自己修改了此环境设置脚本，或配置了启动服务时不使用此环境设置脚本，那就需要手工设置系统编码方式。
（1）设置 RedHat 系统编码方式：
export LANG=zh_CN.UTF-8
（2）设置 SUSE 系统编码方式：
export LANG=zh_CN.UTF-8
unset LC_CTYPE
支持通过以下三种配置使用自定义的 JVM 内存参数：
1.修改 %SuperMap iServer_HOME%/bin/catalina.sh 中的 JAVA_OPTS参数，如：
JAVA_OPTS="$JAVA_OPTS -Djava.awt.headless=true -Xms[初始堆内存大小] -Xmx[最大堆内存大小] -Xss[每个线程可使用堆大小]"
2.修改 %SuperMap iServer_HOME%/bin 目录下的 javaopts.config 文件，如：
-Xms[初始堆内存大小] -Xmx[最大堆内存大小] -Xss[每个线程可使用堆大小]
3.通过修改环境变量使用自定义的 JVM 内存参数，过程如下：
（1）在系统的 profile 文件（默认路径为：/etc/profile）中设置 SUPERMAP_JAVA_OPTS 如下，您可以选择 -Xms、-Xmx 和 -Xss 中的任意参数进行配置：
export SUPERMAP_JAVA_OPTS="$JAVA_OPTS -Djava.awt.headless=true -Xms[初始堆内存大小] -Xmx[最大堆内存大小] -Xss[每个线程可使用堆大小]"
（2）使上述设置生效：
source /etc/profile
（3）执行 echo 命令检查设置是否正确：
echo $SUPERMAP_JAVA_OPTS
注意：1.在涉密系统中，如可以配置永久环境变量，建议您通过配置 SUPERMAP_JAVA_OPTS 环境变量的方式来自定义 JVM 内存参数；如不能配置永久环境变量则需要通过配置 javaopts.config 文件来自定义 JVM 内存参数 。2.当系统中同时存在以上三种方式配置的自定义 JVM 内存参数时，其优先级为 SUPERMAP_JAVA_OPTS > javaopts.config > catalina(tomcat)默认配置>JAVA_OPTS
若使用 Oracle 数据源，需要配置环境变量如下：
（1）设置 ORACLE_HOME，使其指向 Oracle 的安装目录;并将 $ORACLE_HOME/lib 加入 LD_LIBRARY_PATH 变量，如下：
export ORACLE_HOME=/Oracle 的安装目录
export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH
export PATH=$PATH:$ORACLE_HOME
（2）若 Oracle 数据库的编码方式为 GBK，请将 NLS_LANG 参数设置为 "simplified chinese"_china.zhs16gbk，如下：
export NLS_LANG="simplified chinese"_china.zhs16gbk
若使用 Oracle 客户端，下载并安装相应系统的客户端后，需要配置环境变量如下：
（1）设置ORACLE_CLIENT_HOME，使其指向 Oracle Client 的安装目录;并将 $TNS_ADMIN 加入 LD_LIBRARY_PATH 变量，如下：
export ORACLE_HOME=/Oracleclient安装目录
export LD_LIBRARY_PATH=$ORACLE_CLIENT_HOME:$LD_LIBRARY_PATH
export PATH=$PATH:$ORACLE_HOME
（2）设置TNS_ADMIN，使其指向文件tnsames.ora的上一级目录 ，如下：
export TNS_ADMIN=Oracleclient安装目录/network/admin
若使用pg客户端，下载并安装相应系统的客户端后，需要配置环境变量如下：
（1）设置 PG_CLIENT_HOME，使其指向 PGClient 的安装目录;并将 $PG_CLIENT_HOME加入 LD_LIBRARY_PATH 变量，如下：
export PG_CLIENT_HOME=/PgClient 的安装目录
export LD_LIBRARY_PATH=$PG_CLIENT_HOME:$LD_LIBRARY_PATH