SuperMap iServer 备份恢复与迁移

作者：yx

---

前言

SuperMap iServer 支持对服务器配置信息、用户及授权信息进行备份和恢复。该功能通过备份和恢复配置文件来实现，文件位于 WEB-INF（【SuperMap iServer 安装目录】\webapps\iserver\WEB-INF）文件夹下，包括：

• 服务配置文件 iserver-services-interfaces.xml、iserver-services-samples.xml、iserver-services.xml、iserver-system.xml
• 包含服务安全信息的 shiro.ini 文件

其中，在进行服务恢复时，系统会保留当前的初始管理员账户（即系统初始化时创建的管理员账户）而不被备份文件中保存的初始管理员账户覆盖，因为在某些特殊情况下二者可能不同。
该操作可在服务管理器的“备份与恢复”页面http://localhost:8090/iserver/manager/backup进行。

---

一、备份

即对服务器的当前配置信息进行备份。SuperMap iServer 10i/11i提供了默认的配置文件备份，打包为 config_default.zip，位于 【SuperMap iServer_HOME】\webapps\iserver\WEB-INF\lib\iserver-all-xxxx（xxxx 表示 SuperMap iServer 10i/11i 的版本号）.jar 文件中。

在“备份与恢复”页面的“备份”选项卡中，输入备份文件名，单击“备份”按钮，提示“备份服务器配置成功”，表示备份成功。配置文件备份后会打包为"备份文件名.zip"，放在【SuperMap iServer_HOME】\webapps\iserver\WEB-INF\backup 中。

二、恢复

即恢复备份过的服务器配置信息，包括“恢复”和“恢复为默认配置”。“恢复”即用户自行选择备份的配置文件进行恢复，“恢复为默认配置”即恢复服务器配置为默认配置（使用默认的配置文件备份：config_default.zip）。

在“备份与恢复”页面的“恢复”选项卡中，如果选择了要恢复的配置文件，并单击了”恢复“按钮，即恢复为所需要的配置信息；如果单击了”恢复为默认配置“按钮，即恢复为默认服务器配置。

三、迁移

如果您只需要简单的迁移已发布的服务，您可以将旧包的配置文件（一般迁移iserver-services.xml即可），直接拷贝到新包即可，具体迁移哪些配置文件，可以根据您的需求进行迁移，各配置文件的介绍如下：

文件名	描述
iserver-services-interfaces.xml	服务接口实例，包含 iserver-services-samples.xml 和 iserver-services-user.xml 中所用到的接口实例，如：rest、restjsr、wms111、wms130、wfs100、wmts100、wmts-china、wcs111、wcs112、handler、gpserver。
iserver-services-samples.xml	产品提供的示例服务的配置信息。
iserver-services.xml	用户发布的服务的配置信息。此文件命名时只要以“iserver-services”开头，服务器即可识别为服务配置文件，且支持多个用户自定义服务配置文件，如 iserver-services-1.xml，iserver-services-2.xml。
iserver-services-buildin.xml	iServer内置服务（如Geometry服务、map服务）的配置信息。
iserver-system.xml	SuperMap iServer 系统级配置，包括元信息、集群、kml 样式配置等。
iserver-security.db	用于存储用户、角色等信息的数据库。
iserver-services.db	用户存储服务授权信息的数据库。

四、注意事项

跨版本升级注意事项：

1.当您的服务配置信息存储在配置文件中时，如果您需要跨版本进行备份、恢复，需要删除备份文件中的 iserver-system.xml、 iserver-services-interfaces.xml 两个配置文件。此外，如您有新增安全相关配置信息，请从新版本 shiro.ini 文件中拷贝新增条目至备份的 【iServer安装目录】\webapps\iserver\WEB-INF\backup\【备份 ZIP 文件】\shiro.ini 文件中。如您没有新增安全配置信息，可直接删除备份文件中的 shiro.ini 文件。

2.如果您的服务存储在数据库中，在版本升级时则无需进行上述备份、恢复的操作，通过服务配置信息存储连接存有上一个版本的配置信息的数据库，即可达到恢复服务配置信息的目的