Pre-deployment environment configuration

Feedback


The war package of SuperMap iServer 11i(2023) can be deployed on multiple middlewares on different operating systems (see: Hardware Requirements and Software Requirements).

While using the war package to deploy SuperMap iServer 11i(2023), you need to install JRE/JDK, SuperMap iObjects Java 11i(2023) and configure the environment variables firstly. If you use 32 bit JRE / JDK, you need to use 32 bit SuperMap iObjects Java; if you use 64 bit JRE / JDK, you need to use 64 bit SuperMap iObjects Java.

Windows

(1) Set the environment variable for JRE (11.0.18+10).

If you installed JDK, set JAVA_HOME to the installation directory of JDK. If you installed JRE, set JAVA_HOME to the installation directory of JRE.

(2) Set the environment variable for SuperMap iObjects Java.

Environment variables will be set automatically while installing SuperMap iObjects Java. Also, you can set them manually.

You need to set UGO_HOME to the directory of SuperMap iObjects Java and add %UGO_HOME%\Bin to the PATH virable.

Linux

(1) Set the environment variable for JRE (11.0.18+10).

If you installed JDK, set JAVA_HOME to the installation directory of JDK. If you installed JRE, set JAVA_HOME to the installation directory of JRE. For instance, you can set JAVA_HOME in the profile file (default path: /etc/profile):

export JAVA_HOME=/JDK directory

(1) Set the system encoding as:

export LANG=zh_CN.UTF-8

export LANG=zh_CN.UTF-8

unset LC_CTYPE

(3) Set the environment variable for SuperMap iObjects Java.

If SuperMap iObjects Java was installed as the ROOT, the environment variable will be automatically written into the /etc/profile file and you don't need to set it manually.

If SuperMap iObjects Java was not installed as the ROOT, you need to make the configuration below.

Set UGO_HOME and add UGO_HOME to the LD_LIBRARY_PATH variable:

export UGO_HOME=/SuperMap iObjects Java installation directory

export LD_LIBRARY_PATH =$UGO_HOME/bin:$LD_LIBRARY_PATH

Set the environment variable of SUPERMAP_ROOT, making it point to the parent directory of fonts. For example, SuperMap iObjects Java has fonts by default, locating in $UGO_HOME/Support, so set SUPERMAP_ROOT as folows:

export SUPERMAP_ROOT=$UGO_HOME/Support

(4) Run source /etc/profile to validate the configuration.

(5) Use echo to check the settings.

echo $LANG

echo $SUPERMAP_ROOT

echo $LD_LIBRARY_PATH

AIX

(1) Set the environment variable for IBM Java SDK. To do this, you need to set JAVA_HOME to the directory of IBM Java SDK. For instance, you can set JAVA_HOME in the profile file (default path: /etc/profile) as below:

export JAVA_HOME=/IBM Java SDK directory

(2)Set the system encoding as follows:

export LANG=zh_CN

(3) Set the environment variable for SuperMap iObjects Java.

If SuperMap iObjects Java was installed as the ROOT, the environment variable will be automaticallywritten into the /etc/profile file and you don't need to set it.

If SuperMap iObjects Java was not installed as the ROOT, you need to make the configuration below.

export UGO_HOME=/SuperMap iObjects Java installation directory

export LIBPATH =$UGO_HOME/bin:$LIBPATH

export SUPERMAP_ROOT=$UGO_HOME/Support

4) Run source /etc/profile to validate the configuration.

(5) Use echo to check the settings.

echo $LANG

echo $SUPERMAP_ROOT

echo $LIBPATH

 

 

Note: If you are using an Oracle data source and the database is encoded as GBK, set the NLS_LANG parameter to "simplified chinese" _china.zhs16gbk as follows:

export NLS_LANG="simplified chinese"_china.zhs16gbk