目 录
1. 【设置中心】【参数设置】【系统设置】中文档、图片、邮件副本、备份目录设置 11
总体概述
目的
本手册主要介绍e-cology系统因为各种原因需要迁移重装的方法和操作步骤以及过程中可能遇到的问题。本文以Windows操作系统、Sqlserver数据库环境为蓝本进行编写,对于非Windows环境的过程也可以参照此过程进行,只是其中涉及到的目录和服务安装的命令有所差别,略微调整即可
本文内容
- e-cology重装恢复的方法和操作步骤
- e-colgoy重装迁移过程中目录及服务端口不一致问题处理
- e-cology重装过程中常见问题及解决办法
适用范围
- 适用阶段:本文一般用于售后阶段项目实施人员、客服人员以及客户的系统管理员作为系统迁移重装参考使用
- 适用范围:本文仅适用于同平台上的重装恢复,如果是需要更换数据库类型的,如从sqlserver更换成oracle的,请另外请求处理
约束定义
- ../ 符号
本文涉及到的符号../符号表示,e-cology程序安装根目录,如ecology系统安装在D:\weaver下,则../即表示D:\Weaver目录;而../ecology则表示D:\Weaver\ecology目录
e-cology系统迁移重装方法
准备工作
要还原一套e-cology系统必须具备以下条件,请在重转或迁移之前务必要准备好确保没有问题
- 对应版本的Resin、JDK、如果是使用Apache做web服务的话还需要Apache
- e-cology系统的程序文件:../ecology
- e-cology系统的文件数据:即在顶部菜单【设置中心】【参数设置】【系统设置】中设置的邮件副本存放目录、图片存放目录、文件存放目录、文件备份目录中的文件,如下图所示
其中图片存放目录、文件存放目录里面的文件是必须的,如果上面的设置为空则
图片存放目录、文件存放目录为:../ecology/filesystem目录
文件备份目录即为:../ecology/filesystembakup目录
邮件副本存放目录为:../ecology/email/eml目录(老版本不存在此项设置目录固定在这个位置)
- e-cology数据库文件
注:如果因为灾难性原因,无法找到实时的数据库和文件数据,请用最近的一次备份代替(如果连备份都没有那就无法恢复了,所以要求大家务务必要在平时做好备份工作),至于程序文件可以通过安装光盘以及对应的升级补丁来重新构建或请求泛微提供对应版本的文件(自己做过定制开发的除外)
具体步骤
程序文件恢复
对于e-cology程序文件的恢复可以通过一下两个方式完成:
- 通过e-cology安装光盘全新安装一套同版本的e-cology系统,然后升级相应的补丁程序,安装和升级的方法请参考对应环境下的e-cology安装和升级手册
- 通过原来的的e-cology程序直接恢复:将现有的Apahce(如果需要的话)、Resin、JDK、ecology目录拷贝到新服务器的相应目录下即可,如下图所示:
数据文件恢复
数据文件的恢复很简单,只要将备份的数据拷贝到和原来一样目录下即可,如下图所示
注:如果新环境不存在原来的目录(或盘符),则需要修改部分数据库表数据,具体如何修改请参看本文的【第三部分】,或者联系泛微公司技术支持来协助您完成。
数据库恢复
数据库恢复的恢复请按照如下步骤进行:
- 重新安装对应版本的数据库服务软件,具体安装请参考对应的安装手册
- 通过数据库软件本身的还原工具还原备份数据库文件
Sqlserver可以通过企业管理器直接还原备份文件或者附加现有的数据库文件
Oracle可以通过命令:imp user/pass@sid fromuser=fruser touser=user file=D:/test.dmp
注:如果不知道fromuser和touser,就直接使用full=y,一般情况下不会出现什么问题
- 修改程序文件下的数据库配置文件(../ecology/WEB-INF/prop/weaver.properties),如下图所示:
Apache、Resin服务恢复
如果在程序恢复步骤是通过【安装光盘全新安装】的方式来实现的,则不需要经过这个步骤,只需要在恢复好数据库之后重新启动Resin服务即可
如果是通过直接copy原程序文件的方式恢复的则需要重新安装Apache、Resin服务:
- 如果是以Apache作为Web服务的(Windows平台4.1之前版本),请按照以下方式进行安装:
- 安装Resin Servlet Runner服务,打开cmd窗口,运行以下命令安装
D:\Weaver\Resin\bin\srun –java_home D:\Weaver\JDK -Xms256M -Xmx1024M -install
命令解释
- D:\Weaver\Resin\bin\:Resin bin的所在目录,请根据具体情况输入
- -java_home d:\Weaver\JDK:指定JDK的所在目录,请根据具体情况输入
- -Xms256M:Resin的使用的最小内存,区分大小写,非专业人士不要做调整
- -Xmx1024M:Resin的使用的最打内存,区分大小写,非专业人士不要做调整
- 安装Apache服务,打开cmd窗口,运行以下命令安装
D:\Weaver\apache\apache -i
命令解释:D:\Weaver\apache\ 为apache所在目录
- 到服务管理器重启动apache服务和Resin服务
- 如果是以Resin作为Web服务的(Windows平台4.1之后版本),则只要安装Resin服务即可,打开cmd窗口,运行以下命令安装:
D:\Weaver\Resin\bin\httpd.exe -java_home d:\Weaver\JDK -Xms256M -Xmx1024M –install-as ResinOA
然后进入服务管理器启动Resin服务
命令解释
- D:\Weaver\Resin\bin\:Resin bin的所在目录,请根据具体情况输入
- -java_home d:\Weaver\JDK:指定JDK的所在目录,请根据具体情况输入
- -Xms256M:Resin的使用的最小内存,区分大小写,非专业人士不要做调整
- -Xmx1024M:Resin的使用的最打内存,区分大小写,非专业人士不要做调整
- -install-as ResinOA:指定Resin服务的名称为ResinOA
- 非windows平台:修改resin/bin/httpd.sh中JAVA_HOME指向.修改Resin/bin/startresin.sh与stopresin.sh中对应的路径即可
- Resin/bin/httpd.sh:如下图红色标注的JAVA_HOME指向(注意区分大小写)
-
- Resin/bin/startresin.sh:修改下图红色标注的指向httpd.sh文件的目录及内存参数
-
- Resin/bin/stopresin.sh:修改如下图红色标注的指向httpd.sh文件的目录
通过以上步骤,我们基本上已经可以将一个e-cology系统恢复还原成功,不过以上的情况都是在假设恢复重装的文件存放目录结构和原来一致的情况下进行的,一般大家做系统迁移重装的时候,也都要求大家要安装原来的系统的目录来进行恢复,这是因为我们数据库里面记录的许多文件存放的目录都是采用绝对路径的。但是由于服务器环境的限制,也可能会遇到,新的系统与原来系统的安装目录、数据文件存放目录不一致的问题。比如原来系统是安装在 D:\WEAVER\ecology_group目录下的,而还原的时候却要安装在E:\WEAVER\ecology_group目录下。那么针对这些问题如何处理呢?请大家查看我们第三部分的说明。
重装迁移过程中目录及服务端口不一致问题处理
如果系统重装恢复的时候新系统的文件存放目录和原系统有所不同(可能还会涉及到服务端口的不同),那么我们可能需要对系统进行以下两个方面的调整:
- 调整Resin配置文件中的程序目录指向
- 调整数据库中记录的文件、图片、模板的存放目录指向,主要包含以下几个方面
- 【设置中心】【参数设置】【系统设置】中文档、图片、邮件副本、备份目录设置
- 【印章图片存储路径】
- 知识管理模块中【文档显示模板、编辑模板的存储路径】
- 知识管理模块中每篇文档的【Word、excel、wps文档以及文档附件及图片的存储路径】
- 人事管理中的【人事合同模板存储路径】
- 工作流程中【html表单模板的路径】(5.0及以上版本启用了html表单的需要)
- 我的邮件中收取下来的历史邮件文档的存放路径
- 我的邮件中收取下来的邮件历史副本eml文件的存放路径
下面既是针对这些内容的处理方法和步骤进行了描述。
Resin配置文件的调整
用记事本打开Resin配置文件:d:\weaver\Resin\conf\resin.conf
对于恢复的系统主要涉及到需要调整的内容,可能包含以下信息
- Resin的http端口的修改,即我们访问的时候在浏览器中输入的端口
红色部分标注的<http port=’82’/>中的port值修改成你需要的端口数值,如修改为80
- Resin的内部服务端口修改,内部访问的端口,一般不需要修改,除非被占用了
红色部分标注的<srun host=’127.0.0.1′ port=’6820’/>中的port的值修改成你需要的端口数值
- e-cology应用服务器的目录
红色部分标注的<app-dir>D:\WEAVER\ecology_group</app-dir>中的值修改为对应的值,如修改为E:\Weaver\ecology_group
- e-cology应用服务器名:一般不需要修改,除非一个Resin对应多个eoclogy服务的时候才需要修改
红色标注的<init-param serverName=’ecologygroup’/>中的serverName的值修改成对应的值,
修改后的值必须和D:\Weaver\ecology \WEB-INF\prop\weaver.properties配置文件中原点符号前面的字符一致,即无论怎么修改两边必须匹配,如下图:
数据库配置记录的调整
在这里主要是用到一句sql,这句sql的书写格式如下
update 数据库表名称set 字段名称= replace(字段名称, ‘被替换内容’, ‘替换内容’)
比如:update DocMould set mouldPath = replace(mouldPath, ‘D:\’, ‘E:\’),的意思就是把DocMould表中的mouldPath字段里面所有的字符【D:\】替换为字符【E:\】
【设置中心】【参数设置】【系统设置】中文档、图片、邮件副本、备份目录设置
- 在数据库中执行以下sql,了解原来的设置信息:
select filesystem,filesystembackup,picturePath,emlpath from SystemSet
得到如下结果:
- Filesystem: 系统中创建的Word、excel、wps文档以及文档附件及图片的存储路径
- Filesystembackup: Filesystem的备份目录
- picturePath:图片的存放目录
- emlpath:邮件副本的存放目录(老版本不存在此项目录,可以不要理会)
- 在数据库中执行以下sql,修改成新的设置
update SystemSet set filesystem = replace(filesystem, ‘D:\’, ‘E:\’), filesystembackup = replace(filesystembackup, ‘D:\’, ‘E:\’), picturePath = replace(picturePath, ‘D:\’, ‘E:\’), emlPath = replace(emlPath, ‘D:\’, ‘E:\’)
修改后结果
注1:做完此修改则以后新上传的文档、图片、邮件会存放在上面设置的新目录中,但是对于历史文档没有任何影响
注2:如果上面的内容为空,则系统默认的目录会在
-
- Filesystem: ecolog安装目录下的filesystem目录
- Filesystembackup: ecolog安装目录下的filesystembakup目录
- picturePath: ecolog安装目录下的filesystem目录
- emlpath: ecolog安装目录下的email/eml目录
注2:有时候进行了系统迁移发现license提交的时候总是提示数据库连接不上,如果数据库是没问题的,那么其中一个原因就可能是因为这里面的 Filesystem里面设置的路径的盘符在服务器中是不存在的
修改印章图片存储路径指向
- 在数据库中执行以下sql,了解原来的设置信息:
select markPath from DocSignature
得到如下结果:
- 在数据库中执行以下sql,修改成新的设置
update DocSignature set markPath = replace(markPath, ‘D:\’, ‘E:\’)
修改后的结果
修改文档模板存储路径指向
- 在数据库中执行以下sql,了解原来的设置信息:
select mouldPath from DocMould
得到的如下结果
- 在数据库中执行以下sql,修改成新的设置
update DocMould set mouldPath = replace(mouldPath, ‘D:\’, ‘E:\’)
修改后的结果
修改文档(镜像文件)存储路径指向
- 在数据库中执行以下sql,了解原来的设置信息:
select filerealpath from ImageFile
得到的如下结果
- 在数据库中执行以下sql,修改成新的设置
update ImageFile set filerealpath = replace(filerealpath, ‘D:\’, ‘E:\’)
修改后的结果
修改合同模板表存储路径
- 在数据库中执行以下sql,了解原来的设置信息:
select mouldPath from DocMouldFile
得到的如下结果
- 在数据库中执行以下sql,修改成新的设置
update DocMouldFile set mouldPath = replace(mouldPath, ‘D:\’, ‘E:\’)
修改后的结果
修改html表单模板的路径
- 在数据库中执行以下sql,了解原来的设置信息:
select syspath from workflow_nodehtmllayout
得到的如下结果
- 在数据库中执行以下sql,修改成新的设置
update workflow_nodehtmllayout set syspath = replace(syspath, ‘D:\’, ‘E:\’)
修改后的结果
注:5.0之前的老版本,没用html表单不需要进行该操作
修改邮件文件存放目录
- 在数据库中执行以下sql,了解原来的设置信息:
SELECT filerealpath from mailResourceFile
得到的如下结果
- 在数据库中执行以下sql,修改成新的设置
update mailResourceFile set filerealpath = replace(filerealpath, ‘D:\’, ‘E:\’)
修改后的结果
修改邮件副本文件存放目录
- 在数据库中执行以下sql,了解原来的设置信息:
SELECT filerealpath from mailResource
得到的如下结果
- 在数据库中执行以下sql,修改成新的设置
update mailResourceset emlpath = replace(emlpath, ‘D:\’, ‘E:\’)
修改后的结果
注:对于不需要设置邮件副本存放目录的老版本,不需要进行该设置
重装迁移过程中常见问题及处理办法
服务无法启动
- 问题描述
用服务管理器启动服务,服务已启动就立即停止,出现如下图错误提示
出现这种情况基本上就是手动安装Resin服务的时候输入的安装命令存在错误
- 检查办法,直接在CMD窗口中运行安装命令install前面部分,类似下面的命令
D:\Weaver\Resin\bin\httpd.exe -java_home d:\Weaver\JDK -Xms100M -Xmx1824M
看看是否会报错,根据错误可以找到解决办法
如下错误指的是JDK的目录指定错误
如下错误指的是指定的最大内存过大
如下错误指的是Xms指定的比Xmx还大
如下错误指的是某个参数拼写错误了,包括大小写错误
- 处理办法,调试好正确的安装命令,删除原来的服务重新安装,服务删除命令:sc delete 服务名,例如 sc delete ResinA ,安装服务命令参见前文,调试正确的命令执行的结果应该如下所示:
服务无法访问
- 问题描述
按照以上方法把e-cology系统安装好了,通过服务管理器也已经将服务启动了,但是输入在ie中输入访问地址访问的时候却无法访问,出现如下界面:
出现如上情况表示Resin服务没有真正启动
- 检查办法,直接在CMD窗口中运行安装命令install前面部分,类似下面的命令
D:\Weaver\Resin\bin\httpd.exe -java_home d:\Weaver\JDK -Xms200M -Xmx1024M
看看是否会报错,根据错误可以找到解决办法
如下错误指的是服务所需的端口被占用,无法启动
可以将占用该端口的服务停止,然后启动Resin或者也可以需要修改Resin配置文件中的端口端口,Resin端口如何修改具体参见本文第三部分,第一节
如出现下图所示的内容之后就不再继续启动,可能是因为应用服务器无法连接上数据库服务器
数据库连接不上,请通过telnet命令(命令格式:telnet ip 端口 )检测网络连接是否正常
首先在应用服务器上telnet数据库服务器
如:telnet 192.168.1.11 1433 (sql端口一般是1433,而oralce端口一般是1521)
如果不能访问则尝试在数据库服务器上直接telnet 本地IP
如:telnet 127.0.0.1 1433 (sql端口一般是1433,oralce端口一般是1521)
如果还是不通则,数据库服务有问题,请检测数据库是否启动,访问协议端口是否打开
如果通了则表明是数据库防火墙禁止了外部访问,请设置防火墙
如果telent都是通的但就是无法连接上数据库,那么请检测数据库配置文件设置的是否有问题,
无法提交License
- 问题描述
提交License的时候总是提示“数据库连接不上”,这个原因可以通过以下方式来判定问题所在
- 检测方法一:查看登陆页面,看系统显示的登陆页面是e-cology系统默认的登陆页?还是定义过的登陆页?如果是定义过的页面则证明数据库连接是没问题的,如果是默认的登陆页则说明数据库没有连接上(没有改过登陆页的除外),数据库问题请检查数据库配置文件和网络连接
- 检测方法二:到数据库的企业管理器中查看数据库的活动情况,看看相应的账户是否已经连接到数据库中,如果没有则证明数据库没有连接上,反之则正常,,数据库问题请检查数据库配置文件和网络连接
- 检测方法三:如果确定数据库上都没问题,那么可能问题就出在系统设置的【设置中心】【参数设置】【系统设置】中设置的【文件存放目录】路径的盘符在服务器中是不存在的
可以通过在数据库中执行以下sql,了解原来的设置信息:
在查询分析器中执行;select filesystem from SystemSet
查看其中的filesystem目录,在当前服务上是否存在,如果不存在,请修改成存在的目录,即可
其他问题
其他问题会在过程中收集并持续补充进来
Submitted By Weaver
2010年9月2日