# 永中WO在线编辑部署维护手册

2024年12月

# 部署要求

# 支持版本要求

产品 支持版本号 备注
协同OA V8.2、V8.2SP1、V9.0 V9.0SP1标准产品不支持,如需适配涉及项目化开发成本
永中Wo在线编辑 V3.3.7.0056、V3.3.8.0048 此版本是致远标准验证版,内部已确认V3.4版本不适配(并且因变动太大无解决方案)

# 服务器系统要求

仅支持Linux系统服务器,不支持Windows服务器,信创系统支持情况建议详询永中。

# 服务器阶梯资源要求

以下是永中Wo在线编辑服务所需的资源,请按预估日活用户申请对应的服务器配置。

举例说明:客户平时编辑的文档大小在5M左右,客户在线人数为1000,图中5M对应并发为22、65、155、333,那么对OA在线人数为:

22*10=220,65*10=650,155*10=1550,333*10=3330,

客户在线人数为1000,那么对应服务器配置可以推16核32G。

1733106658088.png

# 安装包下载

以下是永中Dcs在线预览服务下载地址:

链接: https://pan.baidu.com/s/1tGwOsWuW3Ra9IVls_KI2oA (opens new window)

提取码: kusm

# 部署步骤

# 设置系统语言

步骤一:执行命令查看系统语言:

locale

1733107807509.png

注:如果系统语言不是“zh_CN.UTF-8”,则执行步骤二 修改系统语言为“zh_CN.UTF-8”。

步骤二:字符语言修改为LANG="zh_CN.UTF-8":

vi  /etc/locale.conf

添加配置:

export LC_ALL= “zh_CN.UTF-8”

1733108515704.png

保存退出并检查是否生效:

source  /etc/locale.conf    #立即生效
locale   #查看系统语言,确保已经改成了“zh_CN.UTF-8”

# 检查zip命令、gcc是否安装

zip     #若提示未找到命令则需要安装。
gcc  -v #如果显示-bash: gcc: 未找到命令,说明没有gcc, 需要安装gcc。

# zip、gcc安装命令,使用yum安装

yum install zip
yum install gcc

# 安装程序解压

此次安装路径为/data,安装包名字为永中在线编辑WO3.3.8.zip,用unzip命令解压后得到文件夹WO3.3.8,此文件夹里面的内容为如图: 1733299471287.png

继续解压weboffice3.3.8.0048-patch.zip:

unzip weboffice3.3.8.0048-patch.zip

最终WO3.3.8文件夹所有内容,部署最终路径为/data/WO3.3.8。

1733299740737.png

# 修改配置文件

在/data/WO3.3.8/bin目录下对install_Config配置文件进行修改,请根据实际情况进行修改。 1733299888521.png 1733299900362.png

# 执行安装脚本

1、给bin目录赋权限:

chmod –R 755 /data/WO3.3.8/bin/

2、切到bin目录下执行checkPort脚本检查端口使用情况,如有冲突请手动修改install_Config_new中对应配置端口。

3、执行 ./install.sh 等待安装完成,安装完后会生成两个文件:WOconfig和WOlogs.log。

1733301229335.png

4、部署完成后,稍等1分钟,等服务启动完成后执行checklog.sh检查服务启动情况显示无异常则执行下一步。

1733301510369.png

5、若demo端口已开放则浏览器访问demo页面,地址:http://ip:端口 install_Config文件中配置的demo_httpPort(默认9090),输入登入密码yozo2022,登入后点击后台管理。

1733301547561.png

1733301559881.png

6、输入密码12345qwerT! 获取机器码(用于生成授权文件)

1733301593043.png

7、若暂时没有授权文件可以开启一天临时授权测试开档是否成功。

1733301609256.png

8、稍等1分钟后进入demo页面点击新建文件,若成功跳出编辑页面则部署成功。

1733302101714.png

9、部署成功后再次进入bin目录开启守护进程脚本,执行./protect.sh restart

1733302227095.png

# 授权更新

若已拿到授权文件(webConfig.eni)将授权文件放至bin/update/conf/目录下:

1733302135283.png

进入bin目录 执行./update.sh脚本,更新授权。

# https开启及设置

1、https开启需要部署nginx,nginx.conf配置文件请参考如下,请替换证书及修改代理地址。

#user  nobody;
worker_processes  1;

#error_log  logs/error.log;
#error_log  logs/error.log  notice;
#error_log  logs/error.log  info;

#pid        logs/nginx.pid;


events {
    worker_connections  1024;
}


http {
    include       mime.types;
    default_type  application/octet-stream;

    #log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
    #                  '$status $body_bytes_sent "$http_referer" '
    #                  '"$http_user_agent" "$http_x_forwarded_for"';

    #access_log  logs/access.log  main;

    sendfile        on;
    #tcp_nopush     on;

    #keepalive_timeout  0;
    keepalive_timeout  65;

    #gzip  on;

server{
        listen 443 ssl;
        server_name wo.yozosoft.com;
        ssl_certificate        STAR_yozosoft_com_integrated.crt;#证书路径
        ssl_certificate_key    STAR_yozosoft_com.key;#证书路径
        ssl_session_timeout 30m;
        ssl_session_cache shared:SSL:10m;
        ssl_protocols TLSv1 TLSv1.1 TLSv1.2 SSLv2 SSLv3;
        ssl_ciphers ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP;
        ssl_prefer_server_ciphers on;
        ssl_verify_client off;
        location / {
            proxy_pass  http://192.168.100.105:8080/; #转发的agent地址
            proxy_redirect  off;
            proxy_http_version  1.1;
            proxy_set_header  Upgrade  $http_upgrade;
            proxy_set_header  Connection  upgrade;
            proxy_set_header  Host  $host;
            proxy_set_header  X-Real_IP  $remote_addr;
            proxy_set_header  X-Forwarded-For  $remote_addr:$remote_port;
    }
}

}

2、修改配置文件

2.1 修改/data/WO3.3.8/weboffice_demo/webapps/ROOT/WEB-INF/classes/Config路径下demo.properties文件,将地址改为https地址。

1733303836505.png

2.2 修改/data/WO3.3.8/bin目录下的install_Config文件,将地址改为https地址,同时修改okhttpsafe配置为true。

1733303786103.png

2.3 修改/data/WO3.3.8/agent/_Config目录下的文件conf.yaml,设置SSL:true。

2.4、在/data/WO3.3.8路径下有文件夹如weboffice_1、weboffice_2、weboffice_3等多个,修改每个文件夹下webapps/ROOT/WEB-INF/lib/Config的webOffice.properties文件,将地址改为https地址。

1733304885004.png

2.5修改完成后需要重启服务。

# 重启服务命令

重启服务器后需要启动redis,默认安装路径为/usr/local/redis/。

ps -ef | grep redis       #查找redis进程
/usr/local/redis/bin/redis-server /usr/local/redis/redis.conf         #启动redis

agent代理重启

ps -ef | grep agent       #查找代理进程
kill -9 进程号             #杀掉进程
cd /data/WO3.3.8/agent
nohup ./agent &           #启动代理

1733369931038.png

weboffice服务启动、重启、停止命令:

cd /data/WO3.3.8/bin   #切换到bin目录
./weboffice.sh start   #启动命令
./weboffice.sh stop    #停止命令
./weboffice.sh restart #重启命令

# 增加字体

创建字体目录:

mkdir -p /usr/share/fonts/truetype

将步骤一获取的字体上传至该目录,修改文件执行权限:

chmod  -R  755  /usr/share/fonts/truetype

执行命令,加载缓存:

fc-cache

后续开档若菜单字体选择框列表依旧为空,也可将字体放至如下目录: /usr/X11R6/lib/X11/fonts/TrueType 重启wo服务。

# 协同侧配置永中在线编辑

1、打开seeyonConfig.cmd 位置为OA安装目录下\ApacheJetspeed\conf

1733386396573.png

1733386405082.png

2、Linux或其他无图像界面的OA服务器可以在与ApacheJetspeed同级的base\conf\文件夹下plugin.properties文件中添加以下配置:

weboffice.enable = true
weboffice.type = 永中在线编辑
yongzhong.webOffice.oa.url = http://ip:port/seeyon[ip:port 为OA的地址]
yongzhong.webOffice.serviceUrl = http://ip:port[ip:port 为永中WO在线编辑的服务地址]
编撰人:qiaoyulong、het