从 iPortal 8C 及以前版本升级
如果您正在使用的是 SuperMap iPortal 7C 系列版本或 8C 版本,需要升级至 SuperMap iPortal 8C SP1 版本或更新版本,请联系 SuperMap iPortal 团队,获取产品升级服务。联系电话:010-59896716
从 SuperMap iPortal 8C SP1 版本开始,iPortal 实现了独立部署,不再内置 SuperMap iServer 应用服务器,针对先前版本的门户升级,主要包括以下几方面:
- 门户内容的升级:包括在线制作的地图、注册的服务、创建的群组、托管的数据、托管的服务、门户管理员发布的服务、监控数据等
- 用户账户数据的升级
- 门户配置信息升级
- 前端门户定制内容升级
从 iPortal 8C SP1 及更新版本升级
SuperMap iPorta 自 8C SP1 版本起,在产品包中提供了用于产品升级的脚本文件,可以通过该脚本文件快速完成 iPortal 版本的升级。升级脚本文件位于【SuperMap iPortal 安装目录】\support\upgrade 目录下,其中的 autoUpgrade.bat 文件(用于 Windows 平台)和 autoUpgrade.sh 文件(用于 Linux 平台)可以帮助您自动进行 iPortal 中配置文件、图片、通过可视化布局系统进行的首页定制等内容的升级。
在升级 iPortal 前,请先对旧版 iPortal 进行备份,以避免升级时发生意外。下面介绍该脚本的具体使用方法:
- 如果您正在运行待升级的旧版 iPortal,请先停止该服务。
- 将用于替代旧版 iPortal 的新版 iPortal 产品包解压缩。
- 编辑 %SuperMap iPortal_HOME%\support\upgrade\autoUpgrade.bat 文件(Linux 系统下对应为 autoUpgrade.sh 文件)中 OLD_PKG 和 NEW_PKG 变量并保存,示例如下:
set "OLD_PKG=D:\supermap_iportal_8.0.1a_win64_zip"
set "NEW_PKG=D:\supermap-iportal-9.1.0-win64-zip"
- OLD_PKG:指向旧版 iPortal 根目录的绝对路径,不能以 "/" 或 "\" 结尾
- NEW_PKG:指向新版 iPortal 根目录的绝对路径,不能以 "/" 或 "\" 结尾
- 运行升级脚本。Windows 系统中双击运行 autoUpgrade.bat,Linux 系统中切换到 %SuperMap iPortal_HOME%\support\upgrade 目录后,输入如下命令:
./autoUpgrade.sh
- 脚本运行完毕后,旧版 iPortal 中的门户数据、配置文件、首页定制等内容已迁移至新版 iPortal 中,完成了产品的升级。运行 {IPORTAL_HOME_NEW}\bin\startup.bat(Linux 系统中为 startup.sh),即可使用新版 iPortal。
注:欲了解该脚本在升级过程中做的具体操作,可参阅:%SuperMap iPortal_HOME%\support\upgrade\readme_zh_cn.txt。
需要手动升级的内容
使用升级脚本后,以下这些配置还需要手动进行升级:
- 根据“旧版 iPortal”的 {IPORTAL_HOME_OLD}/conf/server.xml,去编辑配置“新版 iPortal”的 {IPORTAL_HOME_NEW}/conf/server.xml,尤其是 connector port、context path、context docBase 以及其它自定义的配置。
- “新版 iPortal”的 iportal-storage.xml 文件需要通过界面来配置:管理->服务管理->托管服务器->托管数据配置,该界面的参数需要依据”旧版iPortal“的 {IPORTAL_HOME_OLD}/webapp(s)/iportal/WEB-INF/iportal-storage.xml 的内容进行配置,关于如何配置请参见:托管服务配置。
- 若”旧版iPortal“进行过定制开发,需要参考:iPortal 升级代码合并注意事项,对定制开发的内容进行手动升级。
- 若“旧版iPortal”配置过 CAS 单点登录,那么需要参考旧版的 {IPORTAL_HOME_OLD}/webapp(s)/iportal/WEB-INF/shiro.ini,去编辑配置新版 iPortal 的 {IPORTAL_HOME_NEW}/webapp(s)/iportal/WEB-INF/shiro.ini。