PDF《致远协同管理软件》

北京致远互联软件股份有限公司

1 /

22 www.

seeyon.com 致远协同管理软件 产品升级手册 北京致远互联软件股份有限公司

2019 年4月北京致远互联软件股份有限公司

2 /

22 www.seeyon.com 前言 本手册对协同管理系统的版本升级相关事宜进行说明.如对手册存在疑问,可与致远互联 的客户服务人员联系. 北京致远互联软件股份有限公司

3 /

22 www.seeyon.com 目录 致远协同管理软件.1 产品升级手册.1

1 产品升级.4 1.1 说明.4 1.2 升级版本确认.4 1.3 注意事项.4 1.3.1 保存系统原有信息.4 1.3.2 停止服务.5 1.3.3 产品备份.5 1.3.4 检查磁盘环境.6 1.3.5 加密狗升级.6 1.3.6 关闭其它程序.6 1.3.7 数据库调整.6 1.4 升级步骤.7

2 升级后事项.10 2.1.1 管理员操作.10 2.1.2 使用公文的情况.10 2.1.3 普通用户设置.10

3 升级异常的环境还原.12

4 A63.0 之前版本升级 V5 的说明.13 4.1 方式 1:关联系统设置链接.13 4.2 方式 2:关联系统设置单点登录.15 4.2.1 不同域部署.16 4.2.2 同域部署.21 4.3 关联系统常见使用问题说明.21 北京致远互联软件股份有限公司

4 /

22 www.seeyon.com

1 产品升级 1.1 说明 请务必仔细阅读本章节,便于更流畅完整的进行升级操作.尤其注意升级版本、升级前准备 及升级后的操作. 1.2 升级版本确认 说明: 本版适配帆软版本为 8.0.

0、 9.0. 升级客户, 若使用帆软 9.0, 请联系致远商务更新帆软 license 到9.0 版本.并更新帆软报表设计器到 9.0 版本. ? 升级路径: ? 支持以下版本平滑升级:V3.50SP

1、V5 版本;

? V3.20SP1 及更早版本需先升级到 V3.50SP1;

? A6-m 系列,需先升迁到 A8V3.20SP1 版本. 1.3 注意事项 在升级前,一定要注意将环境变化告知用户,并完成升级前准备工作. A8-m V3.50SP1 升级至 A8-V5 后,产品应用层面调整点见发布文档,完整的环境要求,请见本文 档系统环境要求章节. 在进行具体升级操作前,务必按照以下步骤,做好升级前准备工作. 1.3.1保存系统原有信息 由于应用变化调整,须对以下内容进行手动保存: 序号 分类 操作 说明 北京致远互联软件股份有限公司

5 /

22 www.seeyon.com

1 登录 页 系统管理员登录,手动保存 用户自定义的登录页图片 升级后登录页将使用系统默认登录页,要使用原有 登录页图片,须升级前保存升级后重新设置 (不建议进行此操作,建议使用系统默认的多图切换 式登录页,再根据协同新登录页进行新的登录图片 设置)

2 首页 风格 单位管理员登录,手动保存 用户自定义的首页横幅图片 升级后首页风格将使用系统默认风格,要使用原有 横幅图片,须升级前保存升级后重新设置. (不建议进行此操作,建议使用系统默认首页风格, 再根据协同新风格进行新的首页横幅图片设置) 1.3.2停止服务 ? 停止协同 使用 system 用户登录,在[系统维护]-[服务停止通知]中发送系统停止通知,并设置系 统停止预留时间,勾选[时间到后自动关闭服务].在预留时间结束后服务将自动关闭. ? 停止其他服务 若有 Office 转换、全文检索、M1 服务,请逐一停止. 1.3.3产品备份 ? 数据库备份 在协同服务停止后,进行对应数据库类型的备份操作. ? 产品备份 将协同目录的 ApacheJetspeed、OfficeTrans、jdk、base/conf、base/license 文件夹 进行备份. ? 注册信息备份 ? V3.X 系列版本请备份以下信息: Windows 系统导出产品注册表信息:

32 位:HKEY_LOCAL_MACHINESOFTWARE ufidaa8installinfo

64 位:HKEY_LOCAL_MACHINESOFTWAREWow6432Nodeufidaa8installinfo Linux 系统备份注册信息文件: /root/.config/a8installinfo.conf ? V5 系列版本请备份以下信息: Windows 系统导出产品注册表信息: 北京致远互联软件股份有限公司

6 /

22 www.seeyon.com

32 位:HKEY_LOCAL_MACHINESOFTWARESEEYONA8

64 位:HKEY_LOCAL_MACHINESOFTWAREWow6432NodeSEEYONA8 Linux 系统备份注册信息文件: /root/.config/seeyoninstall_A8.info 1.3.4检查磁盘环境 检查协同服务所在目录、 系统临时目录 (Windows 为操作系统所在分区、 Linux 为/tmp 目录) 是否有 2G 以上剩余空间,来完成升级时临时文件的存取操作. 1.3.5加密狗升级 需要联系致远商务将加密狗中信息更新为 V5 对应版本,否则无法启动升级后的 V5 产品. 1.3.6关闭其它程序 升级耗时较长,请关闭服务器(应用服务器、DB 服务器)其他暂不使用的程序,以释放物理 资源,缩短升级时间. 1.3.7数据库调整 ? MySQL 数据库 对于 MySQL 数据库的用户,需要调整 MySQL 服务的默认存储引擎为 InnoDB.非InnoDB 引擎 将无法升级及正常使用协同. 在执行了数据库备份后,调整 MySQL 配置文件(Windows 为my.ini、Linux 为my.cnf)中[mysqld]项的 default-storage-engine 值,调整为 InnoDB,并重启 MySQL 服务. ? Oracle 数据库 对于 Oracle 数据库的用户,需要确保数据库的字符集为 UTF8,不为 UTF8 会导致升级失败 及后续协同使用过程中的异常. 在执行了数据库备份后,请检查数据库的字符集是否为 UTF8.检查方法:使用 sys 用户连 接Oracle 服务,并执行以下 SQL: select value$ from props$ WHERE NAME='

NLS_CHARACTERSET'

;

若结果不为 AL32UTF8 或AL32UTF16,则需先将字符集调整为 UTF8,调整字符集可以使用以 下示例 SQL: 调整字符集后,重启 Oracle 服务. 恢复备份的数据,再执行后续的升级步骤. 若结果为 AL32UTF8 或AL32UTF16,则可进入升级步骤,进行升级. update props$ set value$='

AL32UTF8'

WHERE NAME='

NLS_CHARACTERSET'

;

北京致远互联软件股份有限公司

7 /

22 www.seeyon.com 1.4 升级步骤 升级准备内容完毕后,请按照以下步骤,进行升级操作: ? 启动数据库服务;

? 将V5 版本的安装程序拷贝至协同应用程序所在的服务器;

? 执行安装程序根目录的 Seeyon**Install.bat(sh)文件,启动安装程序,如图: ? 接受许可协议;

? 确认升级程序读取的产品安装目录是否正确,如图: ? 确认数据库连接信息是否正确,如图: 北京致远互联软件股份有限公司

8 /

22 www.seeyon.com ? 点击下一步进行目录、数据库的匹配检测及反馈,如图: ? 点击下一步执行升级(程序、数据库将被升级) ;

? 升级完毕后,检查升级日志是否有 错误 ,升级日志在安装后程序根目录 Logs 下. ? 若升级过程中无报错信息,则启动协同服务;

? (V3.50SP1 版本执行此步骤)执行表单 URL 升级,此步骤必须执行完成后用户才可正 常登陆协同. 协同服务启动完毕后, 访问协同地址, 登录首页提示表单样式未升级, 直接点击 【登录】 按钮,跳转结果如下图: 北京致远互联软件股份有限公司

9 /

22 www.seeyon.com 点击 表单样式升级 ,执行表单的 URL 升级. 注:此页面若有其他按钮不要随意点击. 表单 URL 升级的日志将记录在协同的 ApacheJetspeed/logs_sy/form.log 中. 在提示升级成功后,则可正常登陆协同(不需要再重启服务) ,成功提示如图: ? 至此协同升级完毕. 北京致远互联软件股份有限公司

10 /

22 www.seeyon.com

2 升级后事项 升级操作完成后,为用户操作更为流畅,请按照以下方式进行具体操作: 2.1.1管理员操作 ? 调整应用配置 启动应用配置器(安装后程序目录的 ApacheJetspeed/conf 中的 SeeyonConfig 文件) , 调整 http 端口、集群配置(若此前开启了集群)信息. ? 放置高清版 Office 转换授权 升级后 OfficeTrans 目录将重新放置,若此前 Office 转换为高清版,请将高清版授权文 件(config.eni)重新放置在 OfficeTrans/Yz/service/Config 下. 2.1.2使用公文的情况 若在历史版本中使用了公文,执行了程序升级,启动后需要使用 IE 浏览器访问协同服务, 进行公文的历史数据升级.访问后将出现公文升级说明,请仔细查阅. 2.1.3普通用户设置 ? 更新辅助程序 点击登录页 辅助程序安装 ,在弹出窗中,更新 IE/windows 插件、Office 控件、常用的插 件等辅助程序,如下图: 北京致远互联软件股份有限公司

11 /

22 www.seeyon.com 北京致远互联软件股份有限公司

12 /

22 www.seeyon.com

3 升级异常的环境还原 若升级过程中出现异常需要还原环境重新进行升级,请执行以下内容: ? 还原备份的数据库;

? 还原备份的注册信息;

Windows 系统恢复导出的产品注册表信息:

32 位恢复后在:HKEY_LOCAL_MACHINESOFTWARE ufidaa8installinfo

64 位恢复后在:HKEY_LOCAL_MACHINESOFTWAREWow6432Nodeufidaa8installinfo Linux 系统恢复备份的注册信息文件: 恢复至:/root/.config/a8installinfo.conf ? 删除 V5 版本的注册信息;

Windows 系统删除产品注册表信息:

32 位:HKEY_LOCAL_MACHINESOFTWARESEEYONA8

64 位:HKEY_LOCAL_MACHINESOFTWAREWow6432NodeSEEYONA8 Linux 系统删除注册信息文件: /root/.config/ seeyoninstall_A8.info ? 还原应用程序的 ApacheJetspeed、jdk、base/conf、base/license 文件夹;

? 重新执行升级步骤;

北京致远互联软件股份有限公司

13 /

22 www.seeyon.com

4 A63.0 之前版本升级 V5 的说明 老A6 升级 A8-V5/A6-V5,提供以下四种方式. ? 方式

3 和方式 4: 1) 如上所述,支持 A6-m V3.0Sp2/Sp3/Sp4 通过升迁工具升至 A8-m V3.20SP1,再升级至 A8-m V3.50SP1,最后升级至 A8-V5SP1 或A6-V5 SP1. 2) 升迁工具的使用查阅该工具对应的文档.升级至 A8-m V3.50SP1 后,通过本文档升级章 节进行 V5 升级操作. ? 方式

1 和方式

2 的具体操作说明如下描述. 4.1 方式 1:关联系统设置链接 ? 描述及注意事项: 1.方式:在V5 中设置关联系统,建立链接.用户通过链接进入老 A6 登录页.无需升级 2.支持版本:支持 A6 V3.0Sp4 及其之前的任何版本. 3.前提:老A6 能正常启动,用户能正常登录与使用. ? 具体操作描述: 1. 系统管理员登录 V5 系统后台, 进入信息集成配置 - 关联系统管理页面, 在常用链接下 --新建关联系统,填写名称、A6 的url 访问地址、授权给相应人员. 北京致远互联软件股份有限公司

14 /

22 www.seeyon.com 2. 使用方式:可以选择配置到空间导航还是配置成备选栏目使用. 3. 配置完成后提交,前端被授权人员可以在我的工具-常用链接下、常用链接栏目、空间 中等地方,直接点击该链接,打开 A6 登录页. 北京致远互联软件股份有限公司

15 /

22 www.seeyon.com 4.2 方式 2:关联系统设置单点登录 ? 描述及注意事项: 1. 方式: 在V5 中设置关联系统, 建立链接与单点登录, 通过链接无需输入用户名和密码, 直接进入 A6 信息页面.无需升级. 2. 支持版本:支持 A6 V3.0Sp4 及之后版本,不支持其他版本. 3. 前提:老A6 能正常启动,用户能正常登录与使用. ? 具体操作描述: 1. 系统管理员登录........