SuperMap iServer 10i/11i 配置备份恢复实操:从Web界面到文件迁移的保姆级指南
SuperMap iServer 10i/11i 配置备份恢复实操从Web界面到文件迁移的保姆级指南当你第一次面对SuperMap iServer的运维工作尤其是需要处理配置备份与恢复时可能会感到无从下手。本文将带你一步步了解如何通过Web界面和文件系统操作完成从基础备份到复杂迁移的全流程。无论你是刚接手旧服务器的GIS开发人员还是需要为新项目做预案的运维新手这篇指南都能帮你避开常见陷阱。1. 理解iServer备份的核心机制SuperMap iServer的备份功能本质上是对关键配置文件的打包处理。这些文件集中在WEB-INF目录下构成了服务器运行的神经中枢。理解它们的角色能让你在操作时更有把握iserver-services.xml用户自定义服务的核心配置文件记录所有手动发布的地图服务、数据服务等iserver-system.xml系统级设置包含集群配置、KML样式等关键参数shiro.ini安全认证配置文件管理用户权限和访问控制iserver-security.db存储用户账号和角色关系的SQLite数据库iserver-services.db服务授权信息的存储库提示默认配置包config_default.zip内置于iserver-all-xxxx.jar中这是恢复出厂设置的源头。2. Web界面备份操作详解通过浏览器访问http://localhost:8090/iserver/manager/backup将localhost替换为实际服务器IP你会看到简洁的备份恢复界面。让我们分解每个操作细节2.1 创建自定义备份在备份选项卡输入有意义的文件名如projectX_pre_deploy_202308点击蓝色备份按钮观察右上角弹出的成功提示物理文件会生成在[iServer_HOME]/webapps/iserver/WEB-INF/backup/目录下# 可以通过命令行验证备份文件 ls -lh /opt/SuperMap/iServer/webapps/iserver/WEB-INF/backup/ -rw-r--r-- 1 iserver iserver 2.3M Aug 15 14:30 projectX_pre_deploy_202308.zip2.2 恢复操作的双重选择恢复界面暗藏玄机——恢复和恢复为默认配置是两个完全不同的操作路径操作类型源文件适用场景影响范围自定义恢复用户备份的ZIP版本内配置回滚保留当前管理员账户默认恢复config_default.zip重置到初始状态会重置除管理员外的所有配置典型误区很多新手误以为恢复为默认配置会保留现有服务实际上这会清除所有自定义发布的服务。3. 文件系统层面的迁移实战当需要将服务迁移到新服务器时仅靠Web界面可能不够。以下是经过验证的文件级迁移方案3.1 最小化文件迁移组合对于大多数场景只需要复制这几个关键文件iserver-services.xml用户服务定义iserver-system.xml系统配置iserver-security.db用户数据/resources目录关联的资源文件# 迁移操作示例 rsync -avz /old_server/webapps/iserver/WEB-INF/iserver-services.xml usernew_server:/opt/SuperMap/iServer/webapps/iserver/WEB-INF/3.2 跨版本迁移的特殊处理当新旧服务器存在版本差异时如10i到11i需要特别注意删除备份包中的iserver-system.xml和iserver-services-interfaces.xml比较新旧版shiro.ini只合并新增的安全配置项检查服务引用的组件API是否兼容新版本警告直接复制全套配置文件到高版本服务器可能导致服务启动失败。4. 备份策略与灾备方案合理的备份计划能让你在意外发生时从容应对。建议采用三级备份体系日常增量备份通过Web界面每周备份服务变更版本快照每次重大更新前创建带版本号的备份包异地冷备每月将整个WEB-INF目录打包存储到不同物理设备备份文件命名规范示例[项目代号]_[环境]_[日期]_[版本].zip → GIS_PRD_20230815_v2.1.zip → GIS_DEV_20230801_v2.0-rc1.zip5. 排错与常见问题解决即使按照规范操作仍可能遇到这些问题问题1恢复后服务列表为空检查iserver-services.xml权限是否为644确认文件没有被截断比较MD5值问题2迁移后登录失败确认shiro.ini中的加密算法与版本匹配检查iserver-security.db是否完整复制问题3集群节点配置不同步先停止所有节点服务在主节点执行备份恢复将cluster目录同步到所有从节点在多次服务器迁移项目中最稳妥的做法是在操作前停止所有iServer服务完成文件操作后再统一启动。对于大型生产环境建议先在测试服务器验证备份文件的完整性。