安装前配置

在 Linux 系统上安装 iPortal 前，请参照系统配置要求，检查安装机器是否满足 SuperMap iPortal 的最低软硬件配置要求。确认满足软硬件要求后，您还需要在待安装 iPortal 的系统上进行必要的环境准备，如安装系统的依赖库、中文语言包、配置许可等。

SuperMap iPortal 默认无需任何安装配置即可满足您试用的需求。如果您将 iPortal 用在实际的生产环境中，建议您根据自身业务需要，进行可选的数据库配置、账户初始化配置等。

Ubuntu

在 Ubuntu 14 Server 操作系统安装使用 iPortal 时，需要依赖某些库才能正常使用 iPortal，如 libx11-dev、xinit、gcc 等，以及中文语言包。您可以加载系统安装盘补充安装相关库，或在 Ubuntu 官网获取相关库来手动安装。 如果加载了系统安装盘，或在外网环境下，您可以通过 apt-get install 命令安装相关的库。

• 安装 libx11-dev、xinit、gcc 等，依次执行以下命令：

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

• 安装许可驱动依赖的 32bit 支持库 libc6-i386 和 ia32-libs，依次执行以下命令：

sudo apt-get install libc6-i386

sudo apt-get install ia32-libs

• 安装中文语言包

简体中文版 iPortal 需要依赖中文环境。如果您在安装 Ubuntu 系统的时候，没有安装中文语言包，可以执行如下命令为系统安装中文语言包：

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

华为TaiShan+中标麒麟

在华为 TaiShan 服务器支撑的中标麒麟操作系统中安装使用 iPortal 时，需要替换 iPortal 产品包中的 JRE，并修改部分文件的配置，具体的操作如下：

1. 将 iPortal 产品包内置的 JRE 替换为 aarch64 JRE，您可以先将  %SuperMap iPortal_HOME%/support/jre 路径下产品包内置的 JRE 备份到其他路径，然后删除原路径下的 JRE，下载  java-1.8.0-openjdk-1.8.0.×××-×××.aarch64.tar.gz，解压后放置在原 JRE 的路径下，删除与解压的命令如下：

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. 修改 %SuperMap iPortal_HOME%/database/elasticsearch/config 路径下的 elasticsearch.yml 文件，添加配置 xpack.ml.enabled: false，执行以下命令：

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

3. 修改/etc/security/limits.conf 文件（可选）。如果您完成以上配置后，仍然无法启动 iPortal 服务，并出现 "max file descriptors [4096] for elasticsearch process is too low, increase to at least [65536]" 等类似错误信息时，表明设置的单个进程最大文件打开数量不够用了，需要修改/etc/security/limits.conf 文件：

（1）以 root 用户执行以下命令：

vi  /etc/security/limits.conf

user soft nofile 65536

user hard nofile 65536

user：应写入实际的 Linux 中使用的用户名，您也可以将其替换为"*"，表示该配置修改对所有用户生效。

注：上述进程最大文件打开数量"nofile"的配置值 65536 并非固定配置值，您可以根据实际情况进行修改，完成修改后，必须切换到非 root 用户登录，才能启动iPortal服务。

（2）切换到非 root 用户，执行以下命令，查看配置是否生效：

ulimit -Hu

ulimit -Su

（3）完成修改后，进入 iPortal 安装目录，执行以下命令结束当前进程后，重新启动iPortal服务。

ps -ef | grep $PWD

kill -9  iportal 进程号

iportal 进程号：通过 "ps" 命令查看与 iPortal 相关的进程及对应的进程号， 此处实际写入相关进程号。

配置许可

初次使用 iPortal 时，您需要配置许可。

数据库配置（可选）

SuperMap iPortal 的门户数据默认存储在 SQLite 数据库中，无需安装和配置，但是针对大数据量、高并发的情况，建议您配置 MySQL/Oracle/PostgreSQL 数据库。具体请参见数据库配置。

账户初始化配置（可选）

SuperMap iPortal支持通过环境变量配置，初始化管理员账户，启动服务后，无需进入“配置向导”页面创建账户，即可直接进入门户首页，使用初始化的管理员账户登录。具体请参见账户初始化配置。