部署在Docker中的iServer进行服务迁移

---

作者kxj

前言

Linux 容器虚拟技术LXCLinux Container是一种轻量级的虚拟化手段它利用内核虚拟化技术提供轻量级的虚拟化来隔离进程和资源。Docker 扩展了 LXC提供了更高级别的 API并简化了应用的打包和部署为终端用户创建彼此独立的私有环境可有效节约开发者和系统管理员的环境部署时间。

SuperMap iServer 现已在阿里云和 Docker 中心上线(获取镜像的地址分别为 registry.cn-beijing.aliyuncs.com/supermap/iserver、supermap/iserver建议您通过阿里云获取 iServer 镜像)仅需几步即可在Docker中部署iServer。具体部署步骤可以参考博客Docker版iServer新手入门教程。
部署在Docker中的iServer如果需要备份与迁移应该如何操作呢那么接下来就给大家提供两种思路来解决在部署在Docker中的iServer如何进行服务迁移的问题。

一备份与恢复

1.备份

在iServer管理页面http://localhost:8090/iserver/admin-ui/home依次点击“高级”-“备份与恢复”-“备份”设置备份文件名称点击“备份”按钮提示“备份服务器配置成功”表示备份成功。配置文件备份后会打包为"备份文件名.zip"放置在映射数据路径的主机宿主路径/iserver_config/backup目录下。

例如运行 Docker 容器并启动 iServer时命令如下docker run --name iserver1 -d -p 8090:8090 -v /root/iserver/datatest:/opt/iserverOPTs supermap/iserver则备份文件放置在主机的/root/iserver/datatest/iserver_config/backup路径下。

2.恢复

将需要恢复的备份文件提前放置到需要恢复的iServer的backup路径下在iServer管理页面http://localhost:8090/iserver/admin-ui/home依次点击“高级”-“备份与恢复”-“恢复”选择要恢复的配置文件并单击了”恢复“按钮即恢复为所需要的配置信息如果单击了”恢复为服务器出厂配置“按钮即恢复为默认服务器配置。

二迁移配置文件

SuperMap iServer 的主要配置信息位于 WEB-INF【SuperMap iServer 安装目录】\webapps\iserver\WEB-INF文件夹下部署在Docker中的iServer配置文件放置于映射数据路径的主机宿主路径/iserver_config目录下例如运行 Docker 容器并启动 iServer时命令如下docker run --name iserver1 -d -p 8090:8090 -v /root/iserver/datatest:/opt/iserverOPTs supermap/iserver则备份文件放置在主机的/root/iserver/datatest/iserver_config路径下,WEB-INF 文件夹下存储了服务器及其所提供服务的配置信息文件夹结构如下

其中
backup 文件夹存放服务器配置信息的备份详见备份与恢复服务器配置。
config 文件夹配置文件包括适用于 Bing Maps、天地图、云服务等的缓存方案。
lib 文件夹存放 SuperMap iServer 运行时所依赖的 jar 文件。
各个配置文件的主要内容如下表所示

文件名	描述
iserver-datacatalog.xml	数据目录服务配置文件包含数据目录服务中的数据存储的配置以及其他的一些配置信息。
iserver-log4j.properties	日志的配置文件
iserver-rest-appContext.xml	REST 应用配置文件其中定义了表述类型与 URI 后缀的映射关系。
iserver-rest-resources.xml	扩展资源的资源配置文件用户可在其中指定扩展资源的名称、URI、类型、表述生成器名称、参数解析器名称等等。
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.xmliserver-services-2.xml。
iserver-services-buildin.xml	iServer内置服务如Geometry服务、map服务的配置信息。
iserver-system.xml	SuperMap iServer 系统级配置包括元信息、集群、kml 样式配置等。
web.xml	SuperMap iServer 的初始化配置文件定义了功能与类的映射关系。
iserver-security.db	用于存储用户、角色等信息的数据库。
iserver-services.db	用户存储服务授权信息的数据库。

迁移iServer时根据自己的需求将需要旧包的配置文件拷贝到新包的对应目录下替换原始配置文件即可。例如仅需迁移自己发布的服务不涉及权限设置时拷贝iserver-services.xml即可。