E9安装手册

E9安装手册

安装包获取

安装所需文件可在泛微emobile技术门户获取,泛微会定期维护

image-20231114224459866

自动部署

1、通过 SSH 工具连接上 linux,创建应用程序目录

image-20231114182416386

可根据客户实际要求创建在任何路径下,保证有足够的空间即可,相关命令为:

1
mkdir -p /usr/weaver

2、通过 FTP 工具上传程序

image-20231114183226839

将本地的 ECOLOGY相关程序上传到创建好的 weaver 目录下。共四个,JDK,RESIN,ECOLOGY 和 Ecology_setup_forLinux_*.py 文件。(JDK 必须提前下载好)

3、执行 Ecology_setup_forLinux_*.py

即输入命令:python Ecology_setup_forLinux_*.py 回车,此处我使用的版本为v2.66

1
python Ecology_setup_forLinux_v2.66.py

image-20231114183454149

如果选择 1 自动执行以下三步操作:

第一步:解压缩。(Linux 必须支持 unzip 及 tar 命令,没有需要提前安装好,否则无法解压)

第二步:给 ecology、jdk、resin 三个目录赋权。

第三步:修改配置文件。设置路径、内存、端口。(内存和端口可在安装过程中进行调整)。

如果选择 2 自动解压缩失败可在手动解压好的情况下,进行第二步和第三步配置。

如果选择 3 查看配置好的相关参数,仅查看,若要调整,可再选择 2 或手动调整。

此处输入1

image-20231114184103511

image-20231114184352829

image-20231114184506165

image-20231114193414751

本页面为配置完成后,切换到 Resin4/bin (或者Resin/bin) 目录后,启动 resin 服务。

1
2
cd /usr/weaver/Resin4/bin
./startresin.sh

image-20231114193711901

服务启动好后,访问服务器ip及刚才设置的端口即可进入数据库初始化页面

能打开此页面代表Resin服务部署成功

image-20231114221759787

如果 自动部署操作不成功,那就只能手动部署。

手动部署

(1)端口(三个端口)

http 端口(Resin/conf/resin.properties)浏览器访问时用到的端口,根据实际调整

1
app.http : 80

server 端口(Resin/conf/resin.properties)默认不需要修改

1
app_servers : 127.0.0.1:6800

watchdog 端口(Resin/conf/resin.xml)默认不需要修改

1
2
3
<server-multi id-prefix="app-" address-list="${app_servers}" port="6800">
<watchdog-port>6600</watchdog-port>
</server-multi>

(2)内存(Resin/conf/resin.properties)

根据实际可用内存调整,不要低于 3550

1
2
# Arg passed directly to the JVM
jvm_args : -Xmx5550m -Xms5550m -XX:CompileThreshold=100000 -XX:ReservedCodeCacheSize=512m -XX:ParallelGCThreads=20 -XX:+UseConcMarkSweepGC -XX:-OmitStackTraceInFastThrow -XX:+UseParNewGC -XX:+DisableExplicitGC -javaagent:wagent.jar -javaagent:stophotdeploy.jar -Djdk.tls.ephemeralDHKeySize=2048 -Dfile.encoding=GBK -javaagent:rasp/rasp.jar

(3)路径(两个路径)

JDK 路径(Resin/conf/resin.xml)根据实际调整

官方部署文档:

1
2
3
4
5
<!--
- You can change the compiler to "javac", "eclipse" or "internal".
-->
<javac compiler="/usr/weaver/jdk1.8.0_151/bin/javac" args="-encoding UTF-8"/>

我本地实际为:

1
2
3
4
<!--
- You can change the compiler to "javac", "eclipse" or "internal".
-->
<javac compiler="internal" args="-encoding UTF-8"/>

应用程序路径(Resin/conf/resin.xml)根据实际调整

<web-app id="/" root-directory="/usr/weaver/ecology">

官方部署文档:

1
2
3
4
5
6
7
8
9
<!-- the default host, matching any host name -->
<host id="" root-directory=".">
<!--
- webapps can be overridden/extended in the resin.xml
-->
<web-app id="/" root-directory="/usr/weaver/ecology">
<servlet-mapping url-pattern='/weaver/*' servlet-name='invoker'/>
</web-app>
</host>

我本地实际为:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
<host id="" root-directory=".">

<access-log path="logs/access.log" archive-format="access-%Y%m%d.log.gz" format='%s` %{loginidweaver}c` %D` %h` %n` %u` "%t"` "%r"` "%{Referer}i"' rollover-period="1D">
<exclude>\.gif$</exclude>
<exclude>\.jpg$</exclude>
<exclude>\.png$</exclude>
<exclude>\.js$</exclude>
<exclude>\.css$</exclude>
<exclude>\.html$</exclude>
<exclude>\.htm$</exclude>
<exclude>\.swf$</exclude>
<exclude>\.cur$</exclude>
</access-log>

<stdout-log path="log/stdout.log" archive-format="stdout-%Y%m%d.log.gz" timestamp="[%Y.%m.%d %H:%M:%S.%s]" rollover-period="1D"/>
<stderr-log path="log/stderr.log" archive-format="stderr-%Y%m%d.log.gz" timestamp="[%Y.%m.%d %H:%M:%S.%s]" rollover-period="1D"/>

<!--
- webapps can be overridden/extended in the resin.xml
-->
<web-app id="/" root-directory="/usr/weaver/ecology">
<servlet-mapping url-pattern='/weaver/*' servlet-name='invoker'/>
<form-parameter-max>100000</form-parameter-max>
</web-app>

</host>

(4) 服务(三个文件)

resin.sh(Resin4/bin/resin.sh)根据实际设置 JDK 路径

JAVA_HOME=/usr/weaver/jdk1.8.0_151

startresin.sh(Resin4/bin/startresin.sh)根据实际设置 resin.sh 路径

ulimit -n 65535

export LC_ALL=zh_CN.gbk

export LANG=zh_CN.gbk

/usr/weaver/Resin4/bin/resin.sh> start

stopresin.sh(Resin4/bin/stopresin.sh) 根据实际设置 resin.sh 路径

/usr/weaver/Resin4/bin/resin.sh stop

(5) 检查字符集

不建议修改,修改后Linux环境会乱码,可跳过

image-20231115214449680

检查当前系统是不是使用 zh_CN.gbk

1
env | grep LANG

image-20231114214453735

若不是 zh_CN.gbk 字符集,则通过 export LANG=zh_CN.gbk 命令来指定

image-20231114214606820

这种方式在重启系统后将失效,若要一直有效,可编辑/etc/profile 文件

在最后添加 export LANG=zh_CN.gbk

(6)对目录赋予权限

对Resin 和 jdk 目录使用 chmod +x 赋予可执行权限

image-20231114215810827

命令如下

1
2
3
cd /usr/weaver/
chmod +x Resin4/*
chmod +x jdk1.8.0_151/*

(7)检查文件格式

(在 windows 下编写的脚本文件,放到 Linux 中无法识别)

切换到Resin的bin目录,使用 vi命令查看shell脚本内容

1
2
cd /usr/weaver/Resin4/bin
vi startresin.sh

image-20231114220051405

显示内容如下

image-20231114220548940

如果是这个结果,则代表文件格式是正确的,直接输入:q! (冒号+q+感叹号表示不保存修) 改直接退出 vi 操作

image-20231114220638213

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

image-20231114220713062

输入:set ff=unix (冒号+set+空格+ff 等于 unix 表示把文件格式由 dos 转换为 unix)

回车后再输入:wq (冒号+w+q 表示保存之前的修改并退出 vi 操作)

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

初始化数据库

修改验证码

为方便记忆及日后license维护,可以修改验证码默认值为1

验证码默认值为wEAver2018可在文件 ecology\WEB-INF\code.key 中查看

image-20231114222537960

可直接修改code.key 文件,也可通过初始化页面修改

image-20231114222715608

创建数据库

因为无论是否使用现有数据库,数据库均需手动到数据库中创建,程序无法自动生成

image-20231114223322650

手动创建数据库

image-20231114223232833

创建好后即可开始初始化数据库,初始化耗时较长,需耐心等待

image-20231114223529239

若想重新初始化数据库将ecology\WEB-INF\prop\weaver.properties文件内容清空

重启服务后重新访问OA地址即可重新进入初始化界面

当然,也可直接修改数据库连接地址,数据库名,用户名,密码等配置信息

数据库初始化完成之后重新登录系统即可,管理员初始密码为 Weaver@2001,可通过sql改为1

1
2
3
4
-- 将用户登录密码改为1   默认密码 Weaver@2001
update hrmresource set password='C4CA4238A0B923820DCC509A6F75849B'
-- 系统管理员登录密码改为1
update hrmresourcemanager set password='C4CA4238A0B923820DCC509A6F75849B'

首次登录需要提交license授权文件,授权后会进入Ecology升级确认页面,按操作指引操作即可

image-20231115125011884

启用非标功能

申请非标包

可通过Ecology功能及版本升级申请流程 申请本地DEMO非标包

image-20231115131356893

申请时需注意以下信息

image-20231115131226722

升级非标

将非标包解压后直接覆盖到ecology目录,重启Resin服务

重启后重新访问OA进入升级页面

image-20231115220235973

使用系统管理员账号登录,进行升级操作

image-20231115220325965

填写数据库地址后六位信息及数据库名后三位

image-20231115220736382

详细信息可在 ecology/WEB-INF/prop/weaver.properties 中查看

以我本地服务为例,数据库地址为 127.0.0.1,后六位为 .0.0.1;数据库名为ecology,后三位为ogy

image-20231115221001654

重要提醒确认

image-20231115221153868

确认其他配置

image-20231115221214071

点击确定后开始执行sql脚本

image-20231115221319203

脚本执行完毕后重新登录OA进入Ecology升级完成确认页面,按照操作指引一次点击下一步即可

image-20231115223621537

启用非标

使用系统管理员登录OA后右上角设置按钮点击授权信息

image-20231115223816956

此时非标功能启用情况已启用数量为0

image-20231115223906464

点击蓝色链接进入非标功能管理界面,勾选需要启用的非标进行启用

image-20231115224034684

启用时会有相应提醒

image-20231115224132848

启用后可重新查看已启用数量确认

image-20231115224238550