服务器配置的备份与恢复

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

服务配置文件 iserver-services-interfaces.xml、iserver-services-samples.xml、iserver-services.xml、iserver-system.xml，详见iServer 配置文件说明
包含服务安全信息的 shiro.ini 文件

其中，在进行服务恢复时，系统会保留当前的初始管理员账户（即系统初始化时创建的管理员账户）而不被备份文件中保存的初始管理员账户覆盖，因为在某些特殊情况下二者可能不同。

该操作可在服务管理器的“备份与恢复”页面（http://localhost:8090/iserver/admin-ui/advanced/backupAndRestore）进行。

备份

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

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

恢复

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

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

请注意：当使用备份文件或服务器出厂配置恢复服务器配置信息后，恢复前服务器配置生成的令牌将会失效。

跨版本升级注意事项：

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

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

3. 当您需要从 SuperMap iServer 11i(2024) 以前的版本备份、恢复到该版本，您还需要在系统配置文件（【iServer 根目录】/webapps/iserver/WEB-INF/iserver-system.xml）中 <security> 节点的 <encryption> 节点中添加 <sensitiveInfoKeySetting> 节点及其配置项以保证升级后的 GIS 服务能够正常使用：

    <security> 
      <encryption class="com.supermap.server.config.EncryptionSetting">           
        <sensitiveInfoKeySetting>                    
            <algorithm>AES</algorithm>                     
            <keyLength>256</keyLength>                     
        </sensitiveInfoKeySetting>
      </encryption> 
    </security>