产品升级

发送反馈


从 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 中门户内容、配置文件、图片等绝大部分内容的升级。下面介绍升级脚本的具体使用方法:

  1. 在升级 iPortal 前,请先对旧版 iPortal 进行备份,以避免可能发生的意外。
  2. 如果您正在运行待升级的旧版 iPortal,请先停止该服务。
  3. 将用于替代旧版 iPortal 的新版 iPortal 产品包解压缩。
  4. 编辑 %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"

  1. 运行升级脚本。Windows 系统中双击运行 autoUpgrade.bat,Linux 系统中切换到 %SuperMap iPortal_HOME%\support\upgrade 目录后,输入如下命令:

./autoUpgrade.sh

  1. 脚本运行完毕后,旧版 iPortal 中的门户数据、配置文件、首页定制等内容已迁移至新版 iPortal 中,完成了产品的升级。运行 {IPORTAL_HOME_NEW}\bin\startup.bat(Linux 系统中为 startup.sh),即可使用新版 iPortal。

注:欲了解该脚本在升级过程中做的具体操作,可参阅:%SuperMap iPortal_HOME%\support\upgrade\readme_zh_cn.txt。

需要手动升级的内容

使用升级脚本后,以下这些配置还需要手动进行升级:

  1. 根据“旧版 iPortal” 的 {IPORTAL_HOME_OLD}/conf/server.xml,去编辑配置“新版 iPortal”的 {IPORTAL_HOME_NEW}/conf/server.xml,尤其是 Server port 、 connector port 以及其它自定义的配置。
  2. “新版 iPortal”的 iportal-storage.xml 文件需要通过界面来配置:管理->服务管理->托管服务器->托管数据配置,该界面的参数需要依据”旧版 iPortal“的 {IPORTAL_HOME_OLD}/webapps/iportal/WEB-INF/iportal-storage.xml 的内容进行配置,关于如何配置请参见:托管服务配置
  3. 若”旧版 iPortal“进行过主题的定制,那么需要:
    1) 将“旧版 iPortal”中的新增的自定义主题 {IPORTAL_HOME_OLD}/webapps/iportal/resources/web-ui/config/themes/ThemeSetting_**.json 文件拷贝至新版 iPortal {IPORTAL_HOME_NEW}/webapps/iportal/resources/web-ui/config/themes 目录中。
    2) 比对自定义主题文件 ThemeSetting_**.json 和“新版 iPortal”的 {IPORTAL_HOME_NEW}/webapps/iportal/resources/web-ui/config/themes/ThemeSetting_blue.json 文件结构,将 ThemeSetting_blue.json 文件中新增的 json 对象拷贝到 ThemeSetting_**.json 中,并赋予自定义色值进行覆盖。
    3)参考“旧版 iPortal”的 {IPORTAL_HOME_OLD}/webapps/iportal/resources/web-ui/config/themes/themes.json 去编辑配置”新版iPortal“的{IPORTAL_HOME_NEW}/webapps/iportal/resources/web-ui/config/themes/themes.json,或通过 管理->站点配置->站点定制->主题管理 以界面方式重新导入自定义的主题。
  4. 若“旧版 iPortal”进行过多语言定制,增加了新的语言种类,那么需要:
    1)对比 {IPORTAL_HOME_NEW}/webapps/iportal/resources/web-ui/config/Language_**.json(新增加的语言配置文件) 和  {IPORTAL_HOME_NEW}/webapps/iportal/resources/web-ui/config/Language_zh.json 文件。将 Language_zh.json 文件中新增的 json 对象拷贝到 Language_**.json 文件中,并进行翻译和覆盖。
    2)对比 {IPORTAL_HOME_NEW}/webapps/iportal/resources/admin-ui/lang/Language_**.json(新增加的语言配置文件) 和  {IPORTAL_HOME_NEW}/webapps/iportal/resources/admin-ui/lang/Language_zh.json 文件。将 Language_zh.json 文件中新增的 json 对象拷贝到 Language_**.json 文件中,并进行翻译和覆盖。
  5. 若“旧版 iPortal”配置过 CAS 单点登录,那么需要参考旧版的 {IPORTAL_HOME_OLD}/webapps/iportal/WEB-INF/shiro.ini,去编辑配置“新版 iPortal”的 {IPORTAL_HOME_NEW}/webapps/iportal/WEB-INF/shiro.ini。
  6. 若要升级 ElasticSearch 中存储的门户资源,需要编辑“新版 iPortal”的 {IPORTAL_HOME_NEW}/webapps/iportal/WEB-INF/iportal.xml, 修改 IportalConfig->modulesConfig->searchModuleConfig->reindexAllResources 值为true。
  7. 若希望对版权信息内版本号进行变更,可通过 管理->站点配置->站点定制->常规内容->版权信息 进行配置。
  8. 若“旧版 iPortal” 为 SuperMap iPortal 10i 以下版本,您在“旧版iPortal”中定制的首页将无法被升级,推荐您使用“新版 iPortal” 首页定制功能重新定制您的 iPortal 首页。
  9. 若“旧版 iPortal” 进行过后台管理界面的扩展开发,那么需要参考旧版的 {IPORTAL_HOME_OLD}/webapps/iportal/WEB-INF/urlrewrite.xml,去编辑配置“新版iPortal”的{IPORTAL_HOME_NEW}/webapps/iportal/WEB-INF/urlrewrite.xml,将旧版中的自定义配置项拷贝至新版中。
  10. 若“旧版 iPortal”为 SuperMap iPortal 11i 以下的版本,在升级为 11i 及以上的版本时,需编辑“新版 iPortal”的 {IPORTAL_HOME_NEW}/webapps/iportal/WEB-INF/config/search/WEB-INF/search-beans.xml,将 ElasticSearch 搜索服务器的端口由 TCP 端口39300 修改为 HTTP 端口39200:

    <bean id="esSetting" class="com.supermap.iportal.search.commontypes.ESSetting">

        ...

        <property name="port" value="39200"></property>  

        ...

    </bean>

  11. 若“旧版 iPortal”编辑或升级过 iportal-ehcache.xml 文件(位于目录 {IPORTAL_HOME_OLD}/webapps/iportal/WEB-INF ),那么需要参考旧版配置编辑“新版 iPortal”的 {IPORTAL_HOME_NEW}/webapps/iportal/WEB-INF/ iportal-ehcache.xml 文件。