Pre-installation configuration

Before installing iPortal on a Linux system, please refer to the system requirements to check whether your machine meets the minimum software & hardware configuration requirements of SuperMap iPortal.After that, you also need to make necessary environmental preparations, such as installing the system's dependent libraries, language packs, and configuring licenses, and so on.

By default, SuperMap iPortal can meet your trial needs without any installation configuration. But in the actual production environment, it is recommended to perform optional database configuration and account initialization configuration according to your business needs.

Ubuntu

When installing iPortal in the Ubuntu 14 Server operating system, it needs some dependent libraries to use iPortal normally, such as libx11-dev, xinit, gcc, etc., and Chinese language packs.You can use the OS setup disk to install or manual install from the Ubuntu website. If the OS setup disk is loaded, or in an external network environment, You can install the related libraries through the apt-get install command.

• To install libx11-dev, xinit, gcc and so on. Follow the commands below:

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

• To install the 32 bit dependent libraries libc6-i386 and ia32-libs for the license driver, follow the commands below:

sudo apt-get install libc6-i386

sudo apt-get install ia32-libs

• Install the Chinese language package if required

Simplified Chinese version of iPortal requires Chinese environment. If you have not installed the Chinese Language package while installing the Ubuntu system, you can perform the following command to install the Chinese language package for the system:

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

Huawei TaiShan+NeoKylin

When installing iPortal in the NeoKylin operating system supported by the Huawei TaiShan server, you need to replace the JRE in the iPortal product package and modify the configuration of some files. The specific operations are as follows:

1. Replace the built-in JRE in the iPortal product package with aarch64 JRE. First, back up the built-in JRE under the %SuperMap iPortal_HOME%/support/jre path to another path, then delete the JRE under the original path, and download java-1.8.0-openjdk-1.8.0.×××-×× ×.aarch64.tar.gz. After decompression, place it under the original path of JRE. The commands for deleting and decompressing are as follows:

rm -rf /%SuperMap iPortal_HOME%/support/jre

tar -xzvf java-1.8.0-openjdk-1.8.0.×××-×××.aarch64.tar.gz -C /%SuperMap iPortal_HOME%/support/jre

2. Modify the elasticsearch.yml file under the %SuperMap iPortal_HOME%/database/elasticsearch/config path, add the configuration that xpack.ml.enabled: false, and execute the following command:

echo  'xpack.ml.enabled: false' >> /%SuperMap iPortal_HOME%/database/elasticsearch/config/elasticsearch.yml

3. Modify the /etc/security/limits.conf file (optional). If you still cannot start the iPortal service after completing the above configuration, and a similar error message such as "max file descriptors [4096] for elasticsearch process is too low, increase to at least [65536]" appears, it indicates that the maximum number of open files set for a single process is not enough, you need to modify the /etc/security/limits.conf file:

(1) Switch to the root user and execute the following commands:

vi  /etc/security/limits.conf

user soft nofile 65536

user hard nofile 65536

user: Write the actual user name used in Linux. You can also replace it with "*" to indicate that the configuration modification takes effect for all users.

Note: The configuration value 65536 for the maximum number of open files in a process is not a fixed configuration value. You can modify it according to the actual situation. After modification, you must switch to a non-root user to start the iPortal service.

 (2) Switch to a non-root user and execute the following command to check whether the configuration takes effect:

ulimit -Hu

ulimit -Su

(3)  After modification, enter the iPortal installation directory, execute the following command to end the current process, and restart iPortal.

ps -ef | grep $PWD

kill -9  iportal process ID

iportal process ID: Use the "ps" command to view the iPortal related process and the corresponding process ID, and write the actual related process ID here.

Configuring license

When using iPortal for the first time, you need to configure license.

Database configuration (optional)

The portal data of SuperMap iPortal is stored in the SQLite database by default without installation and configuration. However, it is recommended that you configure the MySQL/Oracle/PostgreSQL database for large data volume and high concurrency. For details, please refer to database configuration.

Account initialization configuration (optional)

SuperMap iportal supports the configuration of environment variables to initialize the administrator account. After starting the service, you can directly access the portal homepage without entering the "Configuration Wizard" page to create an account and log in with the initialized administrator account. For details, see Account Initialization Configuration.