# 永中Dcs在线预览部署维护手册

2024年12月

# 部署要求

# 支持版本要求

产品 支持版本号 备注
协同OA V8.2、V8.2SP1、V9.0 V9.0SP1标准产品不支持,如需适配涉及项目化开发成本
永中Dcs在线预览 V4.11.0_release.0316 此版本是致远标准验证版,其它版本未验证是否稳定

# 服务器系统要求

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

# 服务器阶梯资源要求

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

# 安装包下载

以下是永中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”

# 部署永中

将压缩包和项目包放到到部署目录下(我的目录是/yozo/fcsserver,可以改其他的)

解压DCS_auto-4.11.0.zip和DCSV4.11.0_release.0316.zip,详情如下

将fcscloud.war包移到到bin目录的package项目下

赋予执行权限并且进入bin目录

chmod -R 755 \*
cd bin/

修改bin目录下的install_Config文件,设置所需配置

1734418467964.png

fcsPath为部署路径
hostIP为服务器IP
fcsNum为并发数(最高12个,看内存)
tomcatsize为每个tomcat项目的内存大小
serverPort默认8005
httpPort服务的访问端口默认为8080(这为了凸显差异改为8088)
javaPath程序自带自己的jdk, jdk1.8.0_321,为(sun)JDK,路径可以自行设置
filePath和logPath自行设置
redisPass默认没有密码,如果需要自行设置
FcsName项目名自行设置,默认为fcscloud
redisPort默认为6379

启动安装脚本

成功安装如下:

成功启动后,进程如下:

关闭服务方式

启动服务方式

卸载服务(慎重执行)

# 更换授权

先停止服务:./shutdown.sh

去bin目录下,进入 update/conf目录

cd update/conf 将申请的授权文件放到conf目录

将名为fcs-*****.eni的文件改名为fcs.eni

执行命令解压yozoT*****.zip包:

unzip yozoT****.zip

最后conf文件夹下面就会变成:

返回bin目录后,执行./update.sh命令

授权更新成功后,启动服务:./startUp.sh

服务启动成功后,验证服务是否可用:curl http://127.0.0.1:8088/fcscloud/query/fcsExpiration

查看版本命令:curl http://127.0.0.1:8088/fcscloud/query/version

# 开启https访问

直接启用tomat的https,需要用到jks证书方法如下

编辑/data/DCSV4.11.0/apache-tomcat-9.0.70/conf路径下的server.xml文件,添加以下内容,将jks证书拷贝到conf目录下,注意证书密码的输入。

<Connector port="443" protocol="HTTP/1.1" SSLEnabled="true"
              maxThreads="150" scheme="https" secure="true"
              keystoreFile="conf/domains.jks"
              keystorePass="80ISkH7c"   //证书密钥 ,密码文本那个
              clientAuth="false" sslProtocol="TLS" />

将以下server.xml中的8443端口改成https端口一致:

1734421896143.png

1734421907863.png

修改web.xml文件(一般在最末尾),增加以下内容,

<login-config>
    <!-- Authorization setting for SSL -->
    <auth-method>CLIENT-CERT</auth-method>
    <realm-name>Client Cert Users-only Area</realm-name>
</login-config>
<security-constraint>
    <!-- Authorization setting for SSL -->
    <web-resource-collection >
        <web-resource-name >SSL</web-resource-name>
        <url-pattern>/*</url-pattern>
    </web-resource-collection>
    <user-data-constraint>
        <transport-guarantee>CONFIDENTIAL</transport-guarantee>
    </user-data-constraint>
</security-constraint>

1734422114796.png

# OA侧配置永中DCS

打开位置为OA安装目录\ApacheJetspeed\conf下seeyonConfig.cmd配置系统参数(用于永中DCS预览)

1734420085021.png

systemCtp.properties配置系统参数(用于永中DCS预览)Linux或其他无图像界面的OA服务器可以在与ApacheJetspeed同级的..base\conf\文件夹下systemCtp.properties文件中添加以下配置:

officeTrans.type = 永中DCS
officeTrans.yongzhong.dcs.callbackUrl=http://ip:port/seeyon #[ip:port 为OA的]
officeTrans.yongzhong.dcs.url = http://ip:port/fcscloud #[ip:port 为永中DCS在线预览服务的地址]

oa系统管理员登录后进入系统管理模块开启office在线预览

1734420212748.png

编撰人:qiaoyulong、het