Pre-installation Configuration

Feedback


Before installing the iServer on the Linux system, refer to System Configuration Requirements and check if the installation machine meets the minimum software and hardware configuration requirements for SuperMap iServer. After confirming that the software and hardware requirements are met, you also need to prepare the necessary environment on the system where iServer is to be installed, such as installing dependency library, Chinese language packs, configuration licenses, etc.

Determine the operating enviroment

Starting from SuperMap iServer 2025, iServer only supports running on GLIBC≥2.28 and GCC≥8.3 Linux(x64) systems. You can run the following command to check the GLIBC and GCC versions of the operating system:

ldd --version

gcc --version

If you have GCC<8.3 in your system, you can also obtain the libstdc++.so.6* from the operating system with GCC≥8.3 and copy it to the {iServer Root}/support/objectsjava/Bin directory to enable the environment to run iServer.

Install dependency library

You can install the dependency library in two ways: automatically using the scripts provided in the iServer package, or manually installing.

Install dependency library through script file

The iServer product package provides the dependencies_check_and_install.sh file, which can automatically detect the current operating system version and the dependency library required for iServer to run on this operating system, and install these dependency library. The method to run this file is to execute the following command in the supermap_iserver_*_linux64/support directory:

./dependencies_check_and_install.sh [command] [options]

【Command】 (required parameter):

【Options】:

For example, to install a dependency library, execute the following command:

./dependencies_check_and_install.sh install -y

If you are running iServer via Docker ( http://hub.docker.com/r/supermap/iserver ), you can specify the environment by adding the following parameters. When the script runs, it installs the appropriate dependency library based on the operating system you specify:

For example, run iServer through Docker and specify the running environment as ubuntu system. Execute the following command when installing dependency library:

./dependencies_check_and_install.sh install -yu

Manually install dependency library

You can also load the system installation disk to supplement the installation of related libraries, or obtain relevant libraries on the official website to manually install dependency libraries.

Ubuntu

When installing and using iServer on Ubuntu 14 Server operating system, the required dependency libraries include libx11-dev, xinit, gcc, and Chinese language pack. You can load the system installation disk to supplement the installation of related libraries, or obtain the relevant libraries on the Ubuntu official website to manually install. If the system installation disk is loaded or in an external network environment, you can install the relevant libraries using the apt-get install command.

sudo apt-get install libx11-dev

sudo apt-get install xinit

sudo apt-get install gcc

sudo apt-get install libgomp1

sudo apt-get install libxtst6

sudo apt-get install libxi6

sudo apt-get install libxrandr2

sudo apt-get install libglu1-mesa

sudo apt-get install libglapi-mesa

sudo apt-get install libx11-xcb1

sudo apt-get install libxcb-glx0

sudo apt-get install libxdamage1

sudo apt-get install libxxf86vm1

sudo apt-get install libxfixes3

sudo apt-get install libgl1-mesa-glx

sudo apt-get install libxinerama1

sudo apt-get install libxcursor1

sudo apt-get install libc6-i386

sudo apt-get install ia32-libs

The simplified Chinese version of iServer needs to rely on the Chinese environment. If you do not install the Chinese language pack when installing the Ubuntu system, you can execute the following command to install the Chinese language pack for the system:

sudo apt-get install language-pack-zh-hans

Deep Operating System

iServer supports installation and use on the Deep Operating System 15.3 operating system. When installing iServer on a deep operating system, there is no need to install dependency libraries. If your system language is not Chinese, you need to modify it to Simplified Chinese. You can set it directly on the graphical interface or through terminal settings.

The command set through the terminal is:

localedef -f UTF-8 -i zh_CN zh_CN.UTF-8

After the setting is completed, restart the iServer.

Red Hat/SUSE

When installing and using iServer on RedHat and SUSE series operating systems, the dependency library required include libgomp, libpng12, etc. You can complete the installation using the yum install command.

sudo yum install libgomp

sudo yum install libpng12

sudo yum install libXext

sudo yum install libXi

sudo yum install libXrender

sudo yum install libXtst

sudo yum install libstdc++-devel.i686

sudo yum install glibc.i686

sudo yum install libgcc.i686

sudo yum install libstdc++.i686

sudo yum install glibc-devel.i686

For SUSE operating systems, install the glibc-32bit library in addition to the above libraries:

sudo yum install glibc-32bit

Detect and supplement dependency library

You can detect and supplement the dependency library in two ways: automatically using the scripts provided in the iServer package, or manually installing.

Detect and supplement dependency library through script file

The iServer product package provides the systemlibs_check_and_decess.sh file, which can automatically detect and supplement iServer's missing dependency libraries on this operating system.

Enter the [iServer package root directory]/support/objectsjava directory, run the systemlibs_check_and_process.sh, and execute the following command:

cd /[iServer package root]/support/objectsjava

./systemlibs_check_and_process.sh

Manually detect and supplement dependency library

1.Detect missing dependency library

You can detect and obtain the list of missing dependency library with the following command: (If there is no bin directory, please unzip bin.tar.gz in the [iServer package root directory]/support/objectsjava directory first)

cd /[iServer package root]/support/objectsjava/bin

export LD_LIBRARY_PATH=.

ldd libWrapj*.so |grep not

ldd libQt5*.so |grep not

2.Install dependency library

The iServer package provides the required dependency library file sysDepLibs.tar.gz (located in the [root directory of the iServer package]/support/objectisJava/directory). You need to extract the file and copy the corresponding library file to the root directory of the iServer package, which is in the [root directory of the iServer package]/support/objectsjava/bin.

  1. Extract the sysDepLibs.tar.gz of the dependency library file, and execute the following commands in turn:

cd /[iServer package root directory]/support/objectsjava

tar -zxvf sysDepLibs.tar.gz

  1. Copy the missing library files to the [iServer package root directory]/support/objectsjava/bin directory:

cp -d [library file name] [iServer package root]/support/objectsjava/bin

Notice

  1. At present, the BimRv plugin used in Linux systems is compiled based on C++14. The third-party libraries that this plugin relies on have been compiled and processed using gcc 8.5.0. To ensure the smooth implementation of RVT file import function in Linux environment, users must ensure that the libstdc++.so library provided by the system is compatible and supports both GLIBCXX_3.4.25 and GLIBC_2.3.2 versions. In addition, the development environment we specified is Linux CentOS 8.5 version, which comes with the gcc compiler and version number gcc 8.5.

Configure license

When using iServer for the first time, you need Configure License.