SuperMap iPortal常见问题解答集锦（一）

问:在线制图能否上传外部数据进行加载显示？
答:在“添加矢量图层”选项卡中，选择“上传文件添加”，您可以通过上传矢量文件向地图添加要素。目前支持上传带分隔符的 csv 格式的文本文件（UTF-8编码）和 excel 文件（*.xlsx 或 *.xls），上传的文件需包含表示地理坐标的数据列。矢量文件上传成功后，您可以查看单个要素的属性数据，也可以查看属性表信息，当然，您也可以更改图层的样式

问:群组角色和用户角色有什么区别？
答:目前，群组的角色包含群组创建者和群组成员。用户在群组中的角色权限与在 SuperMap iServer 中的角色权限是没有关系的。系统管理员申请或被邀请加入一个群组后，在该群组中只是一个普通的群组成员的角色。但是系统管理员可以进入群组管理模块，进行所有群组的统一管理

问:SuperMap iPortal如何创建群组？
答:在 iPortal 首页点击“群组”进入群组资源页面，然后点击页面右侧的“创建群组”。需要注意的是填1.写的群组名称不允许重复；2.更换图标时，上传的图片格式支持 PNG、JPEG、GIF，建议图片大小标准为72*72像素

问:如何设置Map Viewer 地图坐标的显示？
答:管理员可以通过 %SuperMap iPortal_HOME%/webapps/iportal/WEB-INF 目录下的 iportal.xml 文件，设置 Map Viewer 在线制图中地图坐标的显示与不显示
具体示例如下所示：

…

false

问:支持批量操作的地图服务有哪些？
答:目前只支持将地图类服务（如： REST Maps 服务、 WMTS 服务和 WMS 服务）批量添加为地图

问:为什么正确配置了邮箱服务器后，还会提示“警告：SMTP服务器配置不合法”？
答:如果您使用的 JDK 版本为1.8及以上（iPortal 产品包中自带的 JDK 版本为1.8），当安全协议采用 SSL 或 STARTTLS 时，邮件服务器配置可能会验证不通过，提示“警告：SMTP服务器配置不合法”，需通过以下步骤解决：

1.到 http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html 下载 UnlimitedJCEPolicyJDK7.zip
2.解压 UnlimitedJCEPolicyJDK7.zip 得到以下两个文件
local_policy.jar
US_export_policy.jar
3.用这两个 jar 文件覆盖 【SuperMap iPortal_HOME】\support\jre\lib\security 目录下的同名文件(建议将原文件做备份)
4.重启 iPortal 服务

问:在线制图时，所加载的矢量面，为什么点击后无法弹出其属性信息？
答:图层顺序问题，请将需要点击弹窗的图层顺序置顶显示或提高其优先顺序（不能被其他面压盖）即可。

问:为什么在 Linux 系统上启动 iPortal 服务时，报如下类似错误：“Unable to set localhost. This prevents creation of a GUID”？
答:出现这种现象时，请在 /etc/hosts 文件中，配置主机名对应的 IP 地址，即将主机名映射到具体的 IP 地址。如加上下面最后一行，表示将机器名 linux-3z6l 映射到 192.168.112.213。

1

2

3

4

5

6
# Syntax: # IP-Address Full-Qualified-Hostname Short-Hostname

127.0.0.1 localhost

192.168.112.213 linux-3z6l linux-3z6l

    <BR> 

问:如果在 Hyper-v 上运行的 Linux 操作系统中，安装7C 许可失败，或在重启系统后许可不可用，该如何解决？
答:如果遇到许可安装失败，或安装过的许可不可用，可以通过以下方法把驱动卸载后重新安装。

（1）把/var/hasplm 目录删除，命令如下：

cd /var

rm -rf hasplm

（2）卸载许可驱动：

cd /SuperMapiPortal7C/support/SuperMap_License/Support/aksusbd-2.2.1-i386

./dunst

（3）重新安装许可驱动：

./dinst

问:为什么使用远程工具（如：putty、SecureCRT、SSH）启动 Linux 机器上的 SuperMap iPortal 7C 服务后，访问服务首页报“Could not initialize class sun.awt.X11GraphicsEnvironment”或“系统环境检查不通过”错误，而在本机上启动服务，访问服务首页却正常？
答:如果使用远程工具启动 SuperMap iPortal 7C 服务，需要首先登陆 Linux 机器，然后打开一个终端运行以下命令:

（1）X:n& 在第 n 个屏幕上启动一个 XServer , n 为任意整数（如：22、30 等）。

（2）export DISPLAY=:n.0 设置 DISPLAY 变量到本机的 XServer 服务器上，然后再重启服务即可。

问:为什么有时候发送请求时服务器无法正确识别请求，即出现返回乱码、请求失败或者得到错误结果的情况？
答:发送的 HTTP 请求没有使用 UTF-8 编码导致服务器无法识别所致。对于非 ASCII 字符，SuperMap iPortal 默认使用 UTF-8 编码，如果不是，则无法正确解析。

问:为什么配置 CAS 认证服务器后，单点登录认证失败？
答:如果 CAS 认证服务器和 GIS 服务器不在同一台机器上，由于两台机器的时间差，可能导致登录验证不成功，这时需要调整两台机器的时间保持一致，或延长容错时间间隔，iPortal 默认的时间差容限为 3 分钟。修改容错时间差容限的方法是编辑 shiro.ini（WEB-INF 下），修改 casRealm.tolerance 参数（单位为毫秒）如下：

…

casRealm.enabled = false

casRealm.reserveSystemAccount = true

casRealm.casServerUrlPrefix = http://{ip}:{port}/cas

casRealm.casService = http://{ip}:{port}/{contextPath}/shiro-cas

casRealm.securityInfoDAO = $sqliteRealm

casRealm.tolerance = 180000

…

问:如果用户已经创建了 SuperMap iPortal 的系统管理员账号，如：admin，此时由 SQLite 数据库切换至 MySQL 数据库，然后进行注册服务、创建地图等添加门户数据操作会报错，控制台提示“Cannot add or update a child row: a foreign key constraint fails…”?
答:因为丢失了原来 SQLite 数据库中 user_infos 表里的用户信息，需要将%SuperMap iPortal_HOME%webapps\iportal\WEB-INF\iportaldata 下的 iportal.db 中的用户信息同步到 MySQL 数据库中。具体操作为：在 MySQL 数据库中的 user_infos 表中添加 admin 这条记录，SQL 语句为：

insert into user_infos(name,nickname) values(“admin”,“admin”);

（针对 SuperMap iPortal 8C SP1之前的版本，您还需确保 MySQL 数据库中的 servicerooturls 表是空的，如果有记录，需要删除 ），然后重启 iPortal 服务即可。

需要注意的是：如果您已经使用了 iPortal 创建地图、注册服务等，切换至 MySQL 数据库时如果想保留之前的门户数据信息，那么还需要同步 iportal.db 中的所有门户数据信息。

问:为什么在我的内容里面无“开发授权”模块？
答:使用“开发授权”功能，需要启用服务代理功能，如何使用代理，可以在iportal的帮助文档里面搜索“服务代理”查看。

问:上传矢量文件是否支持动态投影？
答:支持，如果上传的矢量源文件投影与目标底图投影不一致，会进行自动的投影转换，转成与底图一致的投影后进行正确的叠加。目前，支持动态投影的文件源投影包括： EPSG Code：4326、EPSG Code：3857 和百度坐标，可与任一目标底图投影包括：EPSG Code：4326、EPSG Code：3857 、百度坐标和谷歌坐标进行正确叠加。

问:iPortal 811/802能否托管低版本的iServer8c?
答:针对您使用的是 SuperMap iPortal 8C SP2 版本，而指定的托管服务器是 SuperMap iServer 8C 或 8C SP1版本，在进行完以上 FTP 存储配置后，还需进行兼容性配置。

兼容性配置是指在 iPortal 的“托管数据存储配置”页面进行完 FTP 配置后，还需手动修改用于发布服务的 iServer 节点中的配置文件 iportal-storage.xml，位于【SuperMap iServer 安装目录】/webapps/iserver/WEB-INF 目录下，将设置存储磁盘根目录项注释掉或删掉，代码如下：

将 FTP 存储类配置信息的注释打开，设置 FTP 地址，端口以及访问账号和密码，需与“托管数据存储配置”页面的配置信息保持一致。例如：

问:如果忘记 SuperMap iPortal 初始化时创建的管理员账户密码怎么办？
答:在 SuperMap iPortal 的【SuperMap iPortal_HOME】\bin 目录下有个 passwordreset.bat/passwordreset.sh 文件，专门用来处理用户忘记系统初始化时的管理员账户密码问题。如果忘记系统初始化时的管理员账户密码，可以通过以下操作重新创建管理员账户：
（1） 停止 SuperMap iPortal 服务，即执行 【SuperMap iPortal_HOME】\bin 目录下的 shutdown.bat /shutdown.sh 文件。
（2） 执行 passwordreset.bat/passwordreset.sh 文件 。
（3） 重启 SuperMap iPortal 服务，即执行 【SuperMap iPortal_HOME】\bin 目录下的 startup.bat/startup.sh 文件。服务启动后访问 iPortal 首页时，系统会自动跳转到创建管理员账户界面，此时只需重新创建管理员账户即可。

问:如果 SuperMap iPortal 所在的操作系统配置了多个IP，如何指定 iPortal 服务所使用的IP？
答:您可以通过修改 Catalina.bat 中的 Java 虚拟机参数中的-Diserver_ip来指定 iPortal 所使用的 IP。即：修改 %SuperMap iPortal_HOME%/bin/catalina.bat 中的 JAVA_OPTS，设置-Diserver_ip为期望的IP，如:
set JAVA_OPTS=%JAVA_OPTS% -Xms256m -Xmx1536m -XX:MaxPermSize=192m -Xss512k -Diserver_ip=192.168.15.26

*问:停止 SuperMap iPortal 时，bin 下为什么会生成 .mdmp 文件，导致磁盘占用过多？
答:经常非正常关闭导致，停止 SuperMap iPortal 时，请使用 shutdown.bat/sh，而不是 Ctrl+C 命令。

问:SuperMap iPortal 在 Tomcat 等 Java Web 容器中，以 Windows 服务形式启动时，日志文件放在哪里？
答:当 SuperMap iPortal 以 Windows 服务形式启动时，以部署到 Tomcat 中为例，在【SuperMap iPortal 安装目录】\webapps\iportal\WEB-INF\iserver-log4j.properties 文件中，指定了日志文件的存放路径：log4j.appender.F.File=…/logs/iserver.log，因此 logs 文件夹放在服务启动文件（cmd.exe）的上一级目录下，即日志文件的存放位置为：C:\Windows\logs\。

另外，用户可以修改上述 log4j.properties 文件，把指定的存放 log 文件的相对路径改为绝对路径，例如：log4j.appender.F.File=D:/Tomcat /logs/iserver.log。

问:SuperMap iPortal 在非正常关闭的情况下，服务为什么会自动重启？
答:这是为了在 iPortal 服务异常的情况下，通过服务自动重启来保证 iPortal 继续正确工作。自动重启功能在如下场景中有效：iPortal Windows/Linux 安装包，以命令行方式启动时。自动重启功能不适用如下场景：iPortal 以 Windows 服务启动时 注意：SuperMap iPortal 可通过执行 shutdown.bat/shutdown.sh（位于【SuperMap iPortal 安装目录】\bin 下）或按住键盘上的 Ctrl+C 键结束服务，来正常关闭，详细请参见服务器的启动/停止。系统配置文件（iserver-system.xml）中 节点下的参数，可用于控制是否启用该功能。

问:SuperMap iPortal 服务崩溃的可能原因有哪些？
答:有如下可能原因：（1）请检查本机是否安装并开启了金山毒霸杀毒软件。开启金山毒霸可能会导致 iPortal 服务崩溃。（2）已知 Tomcat 7.0.29 版本会导致内存泄露，更换为其他 Tomcat 版本，如 Tomcat 7.0.26 即可。

问:为什么启动 SuperMap iPortal 服务时，报端口占用错误，导致 iPortal 服务启动失败？
答:SuperMap iPortal 产品包默认部署在 Tomcat 中，Tomcat 默认使用了 8090、8015端口，这两个端口被占用则无法正常启动服务。可以通过以下两种方式解决：（1） 请退出占用端口的程序，然后重新启动 SuperMap iPortal。目前已知的可能占用 8090 端口的程序有：360 杀毒软件的自动升级程序。（2） 修改 SuperMap iPortal 产品包中 Tomcat 的端口号，然后重新启动 SuperMap iPortal。具体方法是修改%SuperMap iPortal_HOME%/conf/server.xml 中的相关端口，如：<Server port=“8016” ……>、<Connector port=“8091” …… redirectPort=“8454” ……>。

问:启动 SuperMap iPortal 服务时，环境检查不通过的几种可能原因及解决方法
答:SuperMap iPortal 服务需要配置 JRE 1.8 或以上版本，需要配置 SuperMap iPortal 的使用许可。在 %SuperMap iPortal_HOME%\bin 目录下使用“iportal.bat -v”（Linux/Unix 平台使用 “./iportal.sh -v”）可以查看当前 SuperMap iPortal 的版本及配置信息。可能原因及解决方法如下：（1） SuperMap iPortal 许可配置不正确，请确保使用许可已正确配置。许可的配置请参见许可配置说明。（2） JRE/JDK 版本过低或者不兼容。SuperMap iPortal 支持1.8以上版本的 JRE/JDK。另外，如果是Windows Server系统，请切换到administrator超级管理员账户启动。

问:iPortal我的数据支持上传什么类型的？
答:支持工作空间，udb 数据源，SMTiles 文件，SVTiles 文件，MBTiles 文件，TPK 文件，UGCV5 缓存等，但上传时，首选需要将数据压缩为zip格式上传。

问:在我的数据中，上传了数据，也成功了，但是发布按钮是灰色的？
答:需要设置托管服务器，进入iPortal管理页面，点击服务器管理，添加服务器（iServer），添加完成后，刷新我的数据页面，即可看到发布按钮可选。

问:在iPortal管理页面配置托管服务器的时候，托管数据FTP存储配置验证有效性报错，无法连接到数据存储服务器？
答:1.FTP服务器是否搭建，如果没有请按照帮助文档进行搭建。
2.若已经搭建，在电脑打开页面输入iis，查看FTP站点是否启动。
3.检查用户名和密码是否书写错误。

问:iPortal中，上传数据的容量有限制吗？可以修改吗？
答:默认上传数据的容量是2048MB,可在位于 WEB-INF（【SuperMap iPortal 安装目录】\webapps\iportal\WEB-INF）目录下的iportal.xml里面的 进行设置，单位为MB