托管数据存储配置

发送反馈

SuperMap iPortal 提供了可视化的托管数据存储配置页面，以 iPortal 管理员身份登录门户首页，依次点击“管理”>“站点配置”> “数据存储”，即可进行 iPortal 托管数据存储配置，支持二进制型存储、关系型存储、GPA共享存储三种托管数据存储方式。下面将详细介绍如何在 iPortal 中进行托管数据存储配置：

二进制型存储

二进制型存储方式包括文件存储（FILE）、FTP 存储和 SuperMap iServer DataStore 存储三种，默认使用的是文件存储（FILE）。

文件存储（FILE）配置

上传至 iPortal 门户中的数据，默认使用的是文件存储（FILE）方式，默认存储路径为：【SuperMap iPortal 安装目录】/webapps/iportal/WEB-INF/iportaldata/uploadeddata 文件夹下。您可以根据需要修改存储路径，也可直接使用默认存储路径，即可通过指定的托管服务器将门户中的数据发布为服务。文件存储方式支持的托管服务器版本为 SuperMap iServer 7C SP1 及以上版本。下面将详细如何修改数据存储路径：

  1. 以 iPortal 管理员身份登录到门户首页，点击“管理”>“站点配置”>“数据存储”，进入数据存储页面，在“二进制型存储”选项卡中修改文件（FILE）存储路径；

  2. “存储方式”：选择 FILE；

  3. “存储路径”：填写存储路径，例如：D:/uploadeddata；

进行完以上配置后，可以点击“验证有效性”按钮，如果配置有效，系统会给出提示信息：“设置有效，可以连接到数据存储服务器”，然后点击“保存”按钮即可。

使用共享存储发布服务

iPortal 和 iServer 配置了共享存储的情况下，支持基于共享存储直接用数据发布服务，中间不再有推送数据的过程。

  1. 配置共享存储目录，例如：/path/to/workDir ，请参考：共享目录配置  ；

  2. 在（【SuperMap iPortal 安装目录】\webapps\iportal\WEB-INF）文件夹下的 iportal-storage.xml 配置文件中进行配置：

<application>

  <storage>

    <fileClass>FILE</fileClass>

    <basePath>/path/to/workDir</basePath>

  </storage>

</application>

  1. 在（【SuperMap iServer 安装目录】\webapps\iserver\WEB-INF）文件夹下的 iserver-system.xml 配置文件中进行配置：

<fileManagerWorkDir>/path/to/workDir</fileManagerWorkDir>

  1. 配置完成后，在 iPortal 中上传数据发布为服务，可提升服务发布速度。

FTP 存储配置

SuperMap iPortal 支持通过 FTP 服务器来实现托管数据共享。支持将上传至门户中的数据文件存储在 FTP 服务器中，实现 iPortal 与多个 iServer 服务器节点的数据共享，并可通过指定的 iServer 托管服务器获取 FTP 服务器中的数据进行服务发布。

搭建 FTP 服务器实现托管数据共享

如果您没有可用的 FTP 服务器，那么需要搭建一台 FTP 服务器，来作为托管数据的共享存储。此时，您需要选择一台存储量较大的服务器作为 FTP 服务器，并确保 iPortal 和多个 iServer 托管服务器节点都能连接到该 FTP 服务器。

下面以 win7 系统为例，简单介绍一下如何搭建 FTP 服务器：

  1. 在“开始菜单”>“控制面板”>“程序”>“打开或关闭 Windows 功能”，选中“Internet 信息服务”并展开，勾选“FTP 服务器”并展开，勾选“FTP 服务”、“FTP扩展性”和“Web 管理工具”下的“IIS 管理控制台”，点击“确定”；

  2. 系统自动配置成功后，在开始屏幕的搜索中输入“IIS”，然后点击打开“IIS管理器”；

  3. 打开“IIS管理器”后，在左栏的“网站”上点击右键，打开“添加 FTP 站点”，然后按照提示填写站点信息，如站点名称、要共享的物理路径；

  4. 点击下一步，设置“绑定和SSL设置”，在“IP地址”处，填写该服务器的 IP 地址，确保 iPortal 和多个 iServer 节点都能连接，端口默认。勾选“自动启动FTP站点”，“SSL”选择“无”或“允许”皆可；

  5. 点击下一步，设置“身份验证和授权信息”，“身份验证”勾选“基本”，“授权允许访问”的用户，“权限”勾选“读取”和“写入”，即允许用户上传数据至FTP服务器；

  6. 设置完成后，点击“完成”，即可在左栏“网站”下看到您设置的 FTP 站点；

  7. 通过在浏览器地址栏中输入“ftp://”来校验一下 FTP 服务器是否搭建成功。

在 iPortal 中进行 FTP 存储配置

在搭建好 FTP 服务器后，您还需要在 iPortal 中进行如下 FTP 存储配置：

  1. 以 iPortal 管理员身份登录到门户首页，点击“管理”>“站点配置”>“数据存储”，进入数据存储页面，在“二进制型存储”选项卡中进行 FTP 托管数据存储配置；

  2. “存储方式”：选择 FTP；

  3. “主机地址”：设置可用的 FTP 服务器 IP 地址或域名，如 IP 地址：“192.168.120.40”。请确保 iPortal 和多个 iServer 托管服务器节点都能连接到该 FTP 服务器；

  4. “端口号”：设置 FTP 服务器的端口号，默认值：21；

  5. “用户名”：设置 FTP 服务器的用户名。这里需注意，您输入的用户名必须拥有上传与下载文件的权限。

  6. “密码”：设置 FTP 服务器的密码；

  7. “存储根路径“：设置数据上传至 FTP 的目录路径。输入的路径是相对于 FTP 服务根地址的路径，例如输入：iPortal_data，表示托管数据会存储在【FTP 物理路径根地址】/iPortal_data 目录下。

进行完以上配置后，可以点击“验证有效性”按钮，如果配置有效，系统会给出提示信息：“设置有效，可以连接到数据存储服务器”，然后点击“保存”按钮即可。

注意：如果您使用的是 SuperMap iPortal 8C SP2 版本，而指定的托管服务器是 SuperMap iServer 8C 或 8C SP1版本，在进行完 FTP 存储配置后，还需进行以下兼容性配置：

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

<bean id="storage" class="com.supermap.iportal.web.utils.filestorage.FileStorageImpl">

<property name="basePath" value="./WEB-INF/iportaldata/uploadeddata"></property>

</bean>

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

<bean id="storage" class="com.supermap.iportal.web.utils.filestorage.FTPStorageImpl">

<property name="ftpServerHost" value="192.168.120.144"></property>

<property name="ftpServerPort" value="21"></property>

<property name="ftpServerAccount" value="icloud"></property>

<property name="ftpServerPassword" value="icloud"></property>

</bean>

DataStore 存储配置

上传至 iPortal 门户中的数据都支持以二进制的格式在 iServer DataStore 中进行存储。iServer DataStore 是一款应用程序，需要关联 SuperMap iServer 使用，因此，在启用 DataStore 存储前，请确保您已配置好与 DataStore 相关联的 iServer 服务器。关于 iServer DataStore 的具体配置过程请参见：DataStore 配置与管理。 iServer DataStore 配置并启动成功后，在 iPortal 中还需做如下配置：

  1. 以 iPortal 管理员身份登录到门户首页，点击“管理”>“站点配置”>“数据存储”，进入数据存储页面，在“二进制型存储”选项卡中进行 DataStore 托管数据存储配置；

  2. “存储方式”：选择 DATASTORE；

  3. “iServer服务地址“：填写 DataStore 关联的 iServer 的服务地址，例如：http://{ip}:8090/iserver；

  4. “iServer管理员账号“：填写 DataStore 关联的 iServer 服务器管理员账号；

  5. “iServer管理员密码“：填写 DataStore 关联的 iServer 服务器管理员密码。

进行完以上配置后，可以点击“验证有效性”按钮，如果配置有效，系统会给出提示信息：“设置有效，可以连接到数据存储服务器”，然后点击“保存”按钮即可。

关系型存储

SuperMap iPortal 9D(2019)及以上版本支持关系型存储。启用关系型存储后，iPortal 可以提供将上传的 Excel、CSV、GeoJSON 等数据发布为服务的能力，具体可发布的服务类型，请参见数据。同时，启用关系型存储后，数据将优先存储到关系型存储中。需要注意的是，在启用关系型存储之前，请确保您的 iServer 托管服务器关联了 iServer DataStore （关联时需要勾选“关系型数据”选项），或者已经在 iServer 托管服务器中注册了 PostgreSQL、PostGIS、HDFS 等空间数据库（注册时需要勾选“允许编辑”选项）。

下面将详细介绍如何在 iPortal 中配置关系型存储：

  1. 以 iPortal 管理员身份登录到门户首页，点击“管理”>“站点配置”>“数据存储”，进入数据存储页面，在“关系型存储”选项卡中进行关系型存储配置；

  2. “是否微服务”：提供关系型数据存储能力的 iServer 服务器是否为云原生环境；

  3. “iServer服务地址“：填写提供关系型数据存储能力的 iServer 的服务地址，例如：http://{ip}:8090/iserver；

  4. “iServer管理员账号“：填写提供关系型数据存储能力的 iServer 服务器管理员账号；

  5. “iServer管理员密码“：填写提供关系型数据存储能力的 iServer 服务器管理员密码。

 完成以上配置后，可以点击“验证有效性”按钮，如果配置有效，系统会给出提示信息：“设置有效，可以连接到数据存储服务器”，点击“保存”按钮即可。

 

托管数据存储配置完成后，您就可以在“我的数据”页面上传数据，进行数据的托管了。如果您想将托管数据发布为服务，那么需要在“添加服务器”页面，将已添加的一个或多个 GIS 服务器指定为托管服务器，用于将托管数据发布为服务。同时，您在使用 iPortal 过程中也可以根据需要修改托管数据的存储配置，然后点击“验证有效性”并“保存”即可。

注意：更改文件存储路径、FTP 服务器或 DataStore 存储后，之前上传的数据在门户中将显示不存在。请慎重更改文件存储路径、FTP 服务器和 DataStore 存储。

GPA共享存储

SuperMap iPortal 11i(2023)及以上版本支持GPA共享存储。您可以为门户和托管服务器配置一个共享存储，门户和托管服务器均可访问存储，处理自动化服务使用的数据将存储在这里。

下面将详细介绍如何在 iPortal 中配置GPA共享存储：

  1. 以 iPortal 管理员身份登录到门户首页，点击“管理”>“站点配置”>“数据存储”，进入数据存储页面，在“GPA共享存储”选项卡中进行GPA共享存储配置；

  2. “托管服务器”：选择已注册的服务器；

  3. “托管服务器共享存储路径“：指定一个托管服务器所在计算机的目录用于存储处理自动化服务使用的数据。此路径和门户共享存储路径需指向同一个目录；

  4. “门户共享存储路径“：指定一个iPortal所在计算机的目录用于存储处理自动化服务使用的数据。此路径和托管服务器共享存储路径需指向同一个目录。

 完成以上配置后，点击“保存”按钮，如果配置有效，系统会给出提示信息：“操作成功”。

 

GPA共享存储配置完成后，您在“处理自动化建模”页面为模型中的工具设置参数时，从本地或门户中选择文件，点击“执行”，数据将存储在门户和服务器共享存储路径中。若您未配置GPA共享存储，点击“执行”，执行日志会提示“没有配置数据共享目录”，模型执行失败。同时，您在使用 iPortal 过程中也可以根据需要修改GPA共享存储配置，然后点击“保存”即可。点击“删除”可以清除当前配置内容。

数据元信息存储

SuperMap iPortal 11i(2024)支持数据元信息存储。您可以配置存储数据的元信息所用的 POSTGIS 数据库。

下面将详细介绍如何在 iPortal 中配置数据元信息存储：

  1. 以 iPortal 管理员身份登录到门户首页，点击“管理”>“站点配置”>“数据存储”，进入数据存储页面，在“数据元信息存储”选项卡中进行数据元信息存储配置；

  2. “服务器地址”：填写数据库的服务地址，格式为1.IP地址，如：192.168.1.1，2.主机地址，如：supermap.com。建议您添加空数据库，若使用非空数据库，应确认能正确创建数据源；

  3. “端口“：填写数据库的端口；

  4. “数据库名称“：填写将使用的数据库名称；

  5. “用户名“：该数据库所有者的用户名 ；

  6. “密码“：该数据库所有者的密码；

  7. “模式“：默认为public，需与创建数据库设置的schema名称一致。

 完成以上配置后，点击“保存”按钮，如果配置有效，系统会给出提示信息：“操作成功”。