泛微协同办公平台Ecology系统重装迁移指导手册

泛微协同办公平台
E-cology 系统重装迁移指导手册Weaver e-cology
目录
目录 (2)
第一部分E-COLOGY 系统迁移重装方法 (1)
一. 准备工作 (1)
二. 具体步骤 (1)
1.程序文件恢复 (1)
2.数据文件恢复 (1)
3.数据库恢复 (2)
4.Resin 服务恢复 (5)
5.JDK 恢复 (5)
6.集群环境共享目录恢复 (5)
7.IP 地址变更的相关修改 (6)
8.其他 (6)
第二部分解决路径不同的问题 (9)
一. R ESIN 配置文件的调整 (9)
二. 数据库配置记录的调整 (10)
1.【设置中心】→【参数设置】→【系统设置】中文档、图片、邮件副本、备份目录设置 (11)
2.修改印章图片存储路径指向 (12)
3.修改文档模板存储路径指向 (13)
4.修改文档（镜像文件）存储路径指向 (14)
5.修改合同模板表存储路径 (15)
6.修改html 表单模板的路径 (17)
7.修改邮件文件存放目录 (19)
8.修改邮件副本文件存放目录 (19)
9.修改全文检索的路径（若使用了此功能） (21)
10.修改文档元素缩略图的路径 (21)
11.修改表单建模的模板路径 (21)
第一部分e-cology 系统迁移重装方法
要还原一套 e-cology 系统必须具备以下条件，请在重装或迁移之前务必要准备好确保没有问题
➢对应版本的 Resin、JDK（原环境或安装光盘中，如 D:\weaver\JDK 和 D:\weaver\Resin）➢e-cology 系统的程序文件（如 D:\weaver\ecology）
➢e-cology 系统的文件数据：【系统设置】中设置的邮件副本存放目录、图片存放目录、文件存放目录、文件备份目录中的文件。

（如D:\weaver\ecology\filesystem，这是系统默认路径，如果设置到其他路径，就要根据实际路径去找，如 E:\filessystem）
➢e-cology 数据库文件，即数据库的备份。

1. 程序文件恢复
将 ecology 目录拷贝到新服务器的和原服务器一致的目录下即可。

注意：如果 ecology 路径和原环境不同，则需要修改 resin/conf/resin.conf 中程序的路径。

2. 数据文件恢复
数据文件的恢复很简单，只要将备份的数据拷贝到和原来一样目录下即可。

注意：如果新环境不存在原来的目录（或盘符），则需要修改部分数据库表数据。

数据库恢复的恢复请按照如下步骤进行：
➢重新安装和原环境版本一致的数据库服务软件。

➢Sqlserver 可以通过企业管理器直接还原备份文件或者附加现有的数据库文件。

Oracle 可以通过命令进行还原。

oracle11g 用 exp 导出数据库的时候，空表是导不出来的，必须用 expdb 及 impdp 方式导入导出。

A、expdp（备份）
（1）连接 sqlplus（在数据库服务器上打开命令行窗口操作）
Sqlplus system/ecology@ecology
（2）创建备份文件存放的目录。

（目录名可自定义，存储地址必须真实存在）
格式为 SQL> create directory 目录名 as 存储地址;
windows:
SQL> create directory dmpbak as 'D:\dbbak\';
Linux:
SQL> create directory dmpbak as '/usr/weaver/';
若成功会提示：目录已创建。

（3）为目录赋权
格式为 SQL> grant read,write on directory 目录名 to public;
SQL> grant read,write on directory dmpbak to public;
若成功会提示：授权成功。

（4）退出 sqlplus
SQL> exit
（5）备份
格式为 expdp 用户名/密码@实例 dumpfile=备份文件名 directory= 目录名
expdp system/ecology@ecology dumpfile=ecology.dmp directory=
dmpbak
B、impdp（还原）
（1）连接 sqlplus（在数据库服务器上打开命令行窗口操作）
Sqlplus system/ecology@ecology
（2）创建备份文件存放的目录。

（目录名可自定义，存储地址必须真实存在）
格式为 SQL> create directory 目录名 as 存储地址;
windows:
SQL> create directory dmpbak as 'D:\dbbak\';
Linux:
SQL> create directory dmpbak as '/usr/weaver/';
若成功会提示：目录已创建。

（3）为目录赋权
格式为 SQL> grant read,write on directory 目录名 to public;
SQL> grant read,write on directory dmpbak to public;
若成功会提示：授权成功。

（4）退出 sqlplus
SQL> exit
（5）新建一个用来还原的用户名
如果 oracle 数据库是新安装的，且为 oracle10g 及以后版本，在创建用户之前，需要使用 sysdba
用户执行一条命令（同一数据库服务器上只需要执行一次即可），否则在数据库初始化时会报错：alter system set "_allow_level_without_connect_by" = true;
接着再创建用户及赋权：
Sqlplus system/ecology@ecology
CREATE USER ecologynew IDENTIFIED BY ecology DEFAULT TABLESPACE users
TEMPORARY TABLESPACE Temp;
grant connect,resource,dba to ecologynew;
commit;
exit
若无法赋予 dba 权限，可这样赋权：
grant connect,resource to ecologynew;
grant create view to ecologynew;
grant DATAPUMP_EXP_FULL_DATABASE ,DATAPUMP_IMP_FULL_DATABASE to ecologynew;
（6）还原
格式为 impdp 用户名 2/密码@实例 directory=目录名 dumpfile=备份文件名.dmp logfile=日志名.log REMAP_SCHEMA=备份的用户名:还原的用户名
impdp system/ecology@ecology directory=dmpbak dumpfile=ecology.dmp
logfile=ecology.log REMAP_SCHEMA=ecology:ecologynew
如果 impdp 是在同一台机器上操作的，则 impdp 前的创建目录和赋权的步骤都可以省略。

➢如果数据库名（实例名）、用户名、密码改变了，需要修改程序文件下的数据库配置文件
ecology/WEB-INF/prop/weaver.properties。

4. Resin 服务恢复
将 Resin 目录（如 D:\weaver\Resin）拷贝到新服务器的相应目录下即可。

Windows 平台和非Windows 平台下的 Resin 是通用的，可以直接使用。

➢Windows 平台：安装 Resin 服务，打开 cmd 窗口，运行以下命令安装（路径及最大最小内存根据实际情况调整）：
D:\WEAVER\Resin\httpd.exe -java_home D:\WEAVER\JDK -Dfile.encoding=GBK -install ➢非 windows 平台：不需要安装服务，可直接使用
5. JDK 恢复
将 JDK 目录拷贝到新服务器的相应目录下即可。

➢同为 Windows 平台：必须都为 32 位或都为 64 位操作系统才可通用，否则需要重新下载对应的 JDK
➢同为非 Windows 平台：必须都为 32 位或都为 64 位操作系统才可通用，否则需要重新下载对应的 JDK
➢如果从Windows迁移到Linux或者从Linux迁移到Windows，必须重新下载对应的JDK，Windows 和非 Windows 平台的 JDK 不能通用。

6. 集群环境共享目录恢复
如果客户是集群环境，会把 ecology 的一些目录设置为共享，让集群的 ecology 同时能访
问，在迁移时，要注意这些目录要单独复制，确保文件不要丢失。

7. IP 地址变更的相关修改
如果迁移后，数据库服务器的地址变化了，需要修改 ecology/WEB-INF/prop/ 下weaver.properties 中数据库地址。

如果是集群环境，ecology 服务器的地址变化了，需要修改 ecology/WEB-INF/prop/下weaver.properties 中主从服务器的地址。

如果部署了微搜，微搜服务器的地址变化了，需要在 ecology 上重新配置微搜服务器地址。

如果部署了emobile，若ecology 访问地址变化了，需要重新初始化设置emobile；若emobile 服务器地址变化了，需要在 ecology/WEB-INF/prop 下相关配置文件中修改 emobile 的服务器地址。

如果部署了emessage，若数据库服务器地址变化了，需要重新初始化设置消息服务。

若emessage 服务器地址变化了，需要在 ecology/WEB-INF/prop 下相关配置文件中修改消息服务的服务器地址。

8. 其他
如果是把一个环境迁移到 Linux 上的，在除了要修改路径外，在启动服务前，还要检查环境的字符集以及对文件进行赋权限。

（1）检查当前系统是不是使用 zh_CN.gbk 字符集
若不是 zh_CN.gbk 字符集，则通过 export LANG=zh_CN.gbk 命令来指定
这种方式在重启系统后将失效，若要一直有效，可编辑/etc/profile 文件，在最后添加export LANG=zh_CN.gbk
(2)对 Resin 和 jdk 目录使用 chmod +x 赋予可执行权限
（3）检查文件格式（在 windows 下编写的脚本文件，放到 Linux 中无法识别）
进入相应目录下使用 vi startresin.sh 命令打开 startresin.sh
如果是这个结果，则代表文件格式是正确的，直接输入:q! 冒号+q+感叹号表示不保存修改直接退出vi 操作。

如果是这个结果，则代表文件格式是错误的，需要转换格式，否则无法启动。

输入:set ff=unix 冒号+set+空格+ff 等于 unix 表示把文件格式由 dos 转换为 unix
回车后再输入:wq 冒号+w+q 表示保存之前的修改并退出 vi 操作。

除了 startresin.sh 外，httpd.sh 和 stopresin.sh 也必须检查，保证文件格式正确。

通过以上步骤，我们基本上已经可以将一个 e-cology 系统恢复还原成功，不过以上的情况都是在假设恢复或重装的文件存放目录结构和原来一致的情况下进行的，一般来说系统迁移重装的时候，也都要求大家要安装原来的系统的目录来进行恢复，这是因为我们数据库里面记录的许多文件存放的目录都是采用绝对路径的。

但是由于服务器环境的限制，也可能会遇到，新的系统与原来系统的安装目录、数据文件存放目录不一致的问题。

比如原来系统是安装在 D:\WEAVER\ecology 目录下的，
而还原的时候却要安装在 E:\WEAVER\ecology 目录下。

如果遇到这样的情况，必须手动到数据库调整相关路径。

第二部分解决路径不同的问题
如果系统重装恢复的时候新系统的文件存放目录和原系统有所不同（可能还会涉及到服务端口的不同），那么我们可能需要对系统进行以下两个方面的调整：
➢调整 Resin 配置文件中的程序目录指向
➢调整数据库中记录的文件、图片、模板等存放目录指向，
下面既是针对这些内容的处理方法和步骤进行了描述。

1、用记事本打开 Resin 配置文件： Resin\conf\resin.conf
对于恢复的系统主要涉及到需要调整的内容，可能包含以下信息
➢JDK 路径
修改<javac compiler="D:\weaver\JDK\bin\javac" args="-encoding UTF-8"/>中的值
注意：Windows 为 D:\weaver\JDK，Linux 为/usr/weaver/JDK(斜杠方向不同且区分大小写)
➢Resin 的 http 端口，即我们访问的时候在浏览器中输入的端口
修改<http port='80'/>中的 port 值为你需要的端口数值
➢Resin 的 watchdog 端口，一般不需要修改，除非被占用了
修改<watchdog-port>6600</watchdog-port>中的 port 的值为你需要的端口数值
➢Resin 的内部服务端口，一般不需要修改，除非被占用了
修改<srun host='127.0.0.1' port='6800'/>中的 port 的值为你需要的端口数值
➢e-cology 应用服务器的目录
修改<app-dir>D:\WEAVER\ecology</app-dir>中的值
2、非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 文件的目录
二. 数据库配置记录的调整
在这里主要是用到一句 sql，这句 sql 的书写格式如下
update 数据库表名称 set 字段名称= replace(字段名称, '被替换内容', '替换内容')
比如：update DocMould set mouldPath =replace(mouldPath, 'D:\', 'E:\')，的意思就是把DocMould 表中的 mouldPath 字段里面所有的字符【D:\】替换为字符【E:\】
1. 【设置中心】→【参数设置】→【系统设置】中文档、图片、邮件副本、备份目录设置
➢在数据库中执行以下 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. 修改印章图片存储路径指向
➢在数据库中执行以下 sql，了解原来的设置信息：
select markPath from DocSignature
得到如下结果：
➢在数据库中执行以下 sql，修改成新的设置
update DocSignature set markPath = replace(markPath, 'D:\', 'E:\')
修改后的结果
3. 修改文档模板存储路径指向
➢在数据库中执行以下 sql，了解原来的设置信息：
select mouldPath from DocMould
得到的如下结果
➢在数据库中执行以下 sql，修改成新的设置
update DocMould set mouldPath = replace(mouldPath, 'D:\', 'E:\')
修改后的结果
4. 修改文档（镜像文件）存储路径指向
➢在数据库中执行以下 sql，了解原来的设置信息：
select filerealpath from ImageFile
得到的如下结果
➢在数据库中执行以下 sql，修改成新的设置
update ImageFile set filerealpath = replace(filerealpath, 'D:\', 'E:\')
修改后的结果
5. 修改合同模板表存储路径
➢在数据库中执行以下 sql，了解原来的设置信息：select mouldPath from DocMouldFile
得到的如下结果
➢在数据库中执行以下 sql，修改成新的设置
update DocMouldFile set mouldPath = replace(mouldPath, 'D:\', 'E:\') 修改后的结果
6. 修改 html 表单模板的路径
➢在数据库中执行以下sql，了解原来的设置信息：select syspath from workflow_nodehtmllayout
得到的如下结果
➢在数据库中执行以下 sql，修改成新的设置
update workflow_nodehtmllayout set syspath = replace(syspath, 'D:\', 'E:\') 修改后的结果
注：5.0 之前的老版本，没用 html 表单不需要进行该操作
7. 修改邮件文件存放目录
➢在数据库中执行以下 sql，了解原来的设置信息：
SELECT filerealpath from mailResourceFile
得到的如下结果
➢在数据库中执行以下 sql，修改成新的设置
update mailResourceFile set filerealpath = replace(filerealpath, 'D:\', 'E:\')
修改后的结果
8. 修改邮件副本文件存放目录
➢在数据库中执行以下 sql，了解原来的设置信息：
SELECT emlpath from mailResource
得到的如下结果
➢在数据库中执行以下 sql，修改成新的设置
update mailResource set emlpath = replace(emlpath, 'D:\', 'E:\')
修改后的结果
注：对于不需要设置邮件副本存放目录的老版本，不需要进行该设置
修改 ecology\WEB-INF\ searchConf.properties 文件中 index.dbpath=d:/ecology/fullsearch 为实际的索引存放路径。

修改字典的路径ecology\classbean\paoding-dic-home.properties 文件中paoding.dic.home=D:/ecology/dic 为实际的字典放置路径。

10. 修改文档元素缩略图的路径
➢在数据库中执行以下 sql，了解原来的设置信息：
SELECT FILEREALPATH from hpElementImg
➢在数据库中执行以下 sql，修改成新的设置
update hpElementImg set FILEREALPATH = replace(FILEREALPATH,'D:\','E:\')
11. 修改表单建模的模板路径
➢在数据库中执行以下 sql，了解原来的设置信息：
SELECT syspath from modehtmllayout
➢在数据库中执行以下 sql，修改成新的设置
update modehtmllayout set syspath = replace(syspath,'D:\','E:\')。