致遠(yuǎn)協(xié)同管理軟件v71部署手冊(cè)

1、致遠(yuǎn)協(xié)同管理軟件WEB 部署手冊(cè)北京致遠(yuǎn)互聯(lián)軟件2019 年 4 月北京致遠(yuǎn)互聯(lián)軟件1 / 16前言本手冊(cè)對(duì)協(xié)同管理系統(tǒng)支持的 web 服務(wù)部署相關(guān)事宜進(jìn)行說(shuō)明。如對(duì)手冊(cè)疑問(wèn)，可與致遠(yuǎn)互聯(lián)的客戶服務(wù)。北京致遠(yuǎn)互聯(lián)軟件2 / 16目錄致遠(yuǎn)協(xié)同管理軟件1WEB 部署手冊(cè)112Web 服務(wù)配置4Apache 部署及配置52.1Apache 部署.2Windows 系統(tǒng)部署5Linux 系統(tǒng)部署配置文件修改7集群或配置8啟用 HTTPS 配置103Nginx 部署及配置11Nginx 安裝11Nginx 配置12Nginx 啟動(dòng)14參數(shù)調(diào)優(yōu)14啟用 https 配

2、置3.43.5F5 的配置說(shuō)明164北京致遠(yuǎn)互聯(lián)軟件3 / 161 Web 服務(wù)配置Web 服務(wù)可以為協(xié)同系統(tǒng)的單機(jī)環(huán)境提供 Web以及負(fù)載均衡。，為協(xié)同系統(tǒng)的集群環(huán)境提供 Web協(xié)同系統(tǒng)的集群要求對(duì)應(yīng)的 web 服務(wù)在做負(fù)載均衡時(shí)支持會(huì)話保持機(jī)制。會(huì)話保持機(jī)制的意義在于，確保將來(lái)自相同客戶端的請(qǐng)求，轉(zhuǎn)發(fā)至后端相同的服務(wù)器進(jìn)行處理。換句話說(shuō)，就是將客戶端與服務(wù)器之間建立的多個(gè)連接，都到相同的服務(wù)器進(jìn)行處理。這種機(jī)制，可以識(shí)別客戶端與服務(wù)器之間交互過(guò)程的關(guān)聯(lián)性，在負(fù)載均衡的同時(shí)，保證一系列相關(guān)聯(lián)的請(qǐng)求分配到同一臺(tái)服務(wù)器上。依據(jù)實(shí)際情況，可自由選擇 Apache、Nginx、

3、F5 或其他 web 服務(wù)軟硬件設(shè)施。以下章節(jié)對(duì) Apache、Nginx、F5 在做 web 服務(wù)時(shí)的部署及配置注意事項(xiàng)進(jìn)行說(shuō)明。北京致遠(yuǎn)互聯(lián)軟件4 / 162 Apache 部署及配置ØØØØ可以根據(jù)實(shí)際情況調(diào)整 Apache 的版本。建議使用 Apache 對(duì)應(yīng)系列的最新版本。以下 Apache 部署及配置的說(shuō)明以 2.4.29 版本為基礎(chǔ)；Apache 2.4.系列不再支持 windows2003，若使用 windows2003 請(qǐng)更換 Apache2.2 系列。使用 https 需在 SeeyonConfig 中設(shè)置服務(wù)器配置為：?jiǎn)螜C(jī)(HTTP

4、S)或集群/雙機(jī)，如圖:2.1 Apache 部署2.1.1Windows 系統(tǒng)部署l安裝包獲?。?從 Apache依賴包安裝合作：l安裝對(duì)應(yīng)版本的 vc_redist 程序Apache 安裝1）解壓的 Apache 程序壓縮包至 WEB 服務(wù)器 Apache 所在目錄，如 D:Apache 2）調(diào)整 ApacheWindowsconfhttpd.conf 文件中 Apache 所在絕對(duì)路徑，如：替換lhttpd.conf 中 c:/Apache24 為 D:/Apache243）Apache 為 Windows 服務(wù)（在 cmd 命令提示符中，執(zhí)行以下命令）：lApache 服務(wù)啟停北京致遠(yuǎn)

5、互聯(lián)軟件5 / 16檢查配置文件正確性： d:apachebinhttpd t 啟動(dòng)服務(wù)：d:apachebinhttpd start 或 使用 Windows 服務(wù)啟動(dòng) Apache 服務(wù)。停止服務(wù)：d:apachebinhttpd stop 或 使用 Windows 服務(wù)停止 Apache 服務(wù)。cd /d D:Apachebin httpd -k install2.1.2Linux 系統(tǒng)部署l安裝包獲取從 Apache 官網(wǎng)（）l依賴包安裝（可從 Apache）n安裝 pcre（地址：）,解壓并拷貝后的安裝程序到/home 目錄下下，執(zhí)行以下命令進(jìn)行 pcre 的安裝n安裝 apr（地址

6、：），解壓并拷貝后的安裝程序到/home 目錄下，執(zhí)行以下命令進(jìn)行 apr 的安裝：n安裝 apr-util（地址：），解壓并拷貝后的安裝程序到/home 目錄下，執(zhí)行以下命令進(jìn)行 apr 的安裝：l安裝 httpd，解壓并拷貝后的安裝程序到/home 目錄下，執(zhí)行以下命令進(jìn)行 httpd的安裝：（注意紅色標(biāo)注的為一條命令）：lApache 服務(wù)啟停北京致遠(yuǎn)互聯(lián)軟件6 / 16拷貝啟動(dòng)cp /usr/local/apache/bin/apachectl /etc/init.d/httpd檢查配置文件正確性：/usr/local/apache/bin/apachectl -t啟動(dòng)服務(wù)：/usr/

7、local/apache/bin/apachectl start 或 service httpd start停止服務(wù)：/usr/local/apache/bin/apachectl stop 或 service httpd stopcd /home/httpd-2.4.29./configure -prefix=/usr/local/apache -with-apr=/usr/local/apr -with-apr- util=/usr/local/apr-util -with-pcre=/usr/local/pcre -enable-ssl -enable-so - enable-defla

8、te -enable-ext-filtermakemake installcd /home/apr-util-1.6.0./configure -prefix=/usr/local/apr-util -with-apr=/usr/local/apr makemake installcd /home/apr1.6.2./configure -prefix=/usr/local/apr makemake installcd /home/pcre-8.41./configure -prefix=/usr/local/pcre makemake install2.2 配置文件修改ØWindo

9、ws 下配置文件修改：l到 Apache 安裝目錄的 conf 目錄下（如 Winows 下的 D:apacheconf）,找到 httpd.conf，取消以注釋或增加以：l然后找到 Apache 安裝目錄的 confextra 目錄下找到 httpd-mpm.conf,并進(jìn)行如下修改：ØLinux 下配置文件修改：l到 Apache 安裝目錄的 conf 目錄下（如/usr/local/apache/conf）,找到 httpd.conf，取消以注釋或增加以：北京致遠(yuǎn)互聯(lián)軟件7 / 16LoadModule socache_shmcb_module modules/mod_soca

10、che_shmcb.so LoadModule log_config_module modules/mod_log_config.so LoadModule setenvif_module modules/mod_setenvif.so LoadModule ssl_module modules/mod_ssl.soLoadModule filter_module modules/mod_filter.so LoadModule deflate_module modules/mod_deflate.so#配置集群時(shí)，增加mod_jk 配置文件，并去掉下面一行的注釋#Include conf/m

11、od_jk.conf #對(duì)指定的內(nèi)容進(jìn)行壓縮AddOutputFilterByType DEFLATE text/html text/xml text/css text/javascript text/plain application/javascript application/octet-stream#去掉以下行前面的注釋符號(hào)"#"<IfModule mpm_winnt.c>ThreadsPerChild 2000#推薦設(shè)置：小型=1000 中型=10002000 大型=20003500 MaxRequestsPerChild 20000#推薦設(shè)置：小=1

12、0000 中或大=20000100000 AcceptFilter httpNoneAcceptFilter httpsNone</IfModule>LoadModule socache_shmcb_module modules/mod_socache_shmcb.so LoadModule log_config_module modules/mod_log_config.soLoadModule setenvif_module modules/mod_setenvif.so LoadModule ssl_module modules/mod_ssl.soLoadModule fi

13、lter_module modules/mod_filter.so LoadModule deflate_module modules/mod_deflate.so#配置集群時(shí)，增加mod_jk 配置文件，并去掉下面一行的注釋#Include conf/mod_jk.conf #對(duì)指定的內(nèi)容進(jìn)行壓縮AddOutputFilterByType DEFLATE text/html text/plain text/xml #去掉以下行前面的注釋符號(hào)"#"Include conf/extra/httpd-mpm.conflconf/extra/httpd-mpm.conf 配置文件

14、修改，取消以注釋或修改、增加以：（perfork 或 worker 模塊修改使用模塊對(duì)應(yīng)的配置文件）2.3 集群或配置ØLinux 下和 Windows 下配置步驟相同：l組件集群組件：地址（對(duì)應(yīng)操作系統(tǒng)及版本的 mod_jk.so 文件）：l集群組件安裝：將的 mod_jk.so 文件拷貝到 Apache 安裝目錄下的 modules 目錄下l集群組件配置：n在 Apacheconfhttpd.conf 中增加以：n在 Apacheconf 下建立 mod_jk.conf 文件，內(nèi)容如下：北京致遠(yuǎn)互聯(lián)軟件8 / 16#mod_jk.conf 主要描述了 jk 模塊的位置及相關(guān)參數(shù)L

15、oadModule jk_module modules/mod_jk.so JkWorkersFile conf/pertiesJkMountFile conf/pertiesInclude conf/mod_jk.conf#mpm_perfork 模塊<IfModule mpm_prefork_module>StartServers50#推薦設(shè)置：小=默認(rèn) 中=2050 大=50100 MinSpareServers50#推薦設(shè)置：與StartServers 保持一致MaxSpareServers80#推薦設(shè)置：小=20 中=

16、3080 大=80120MaxClients1500#推薦設(shè)置：小=500 中=5001500 大型=15003000ServerLimit1500#還需額外設(shè)置 ServerLimit 參數(shù)，該參數(shù)最好與 MaxClients 的值保持一致MaxRequestsPerChild 20000#推薦設(shè)置：小=10000 中或大=10000500000</IfModule> #mpm_worker 模塊<IfModule mpm_worker_module>StartServers10#推薦設(shè)置：小=默認(rèn) 中=35 大=510MaxClients1500#推薦設(shè)置：小=50

17、0 中=5001500 大型=15003000ServerLimit1500#如果 MaxClients/ThreadsPerChild 大于 16，還需額外設(shè)置 ServerLimit參數(shù)，ServerLimit 必須大于等于 MaxClients/ThreadsPerChild 的值。MinSpareThreads100#推薦設(shè)置：小=默認(rèn) 中=50100 大=100200 MaxSpareThreads200#推薦設(shè)置：小=默認(rèn) 中=80160 大=200400ThreadsPerChild100#推薦設(shè)置：小=默認(rèn) 中=50100 大型=100200 MaxRequestsPerChi

18、ld 20000#推薦設(shè)置：小=10000 中或大=1000050000</IfModule>Include conf/extra/httpd-mpm.confn在 Apacheconf 下建立 perties 文件，內(nèi)容如下：n在 Apacheconf 下建立 perties 文件，內(nèi)容如下：北京致遠(yuǎn)互聯(lián)軟件9 / 16worker.list = controller,status worker.status.type=status worker.controller.type=lb#與 tomcat 的 server.xml

19、 中 jvmRoute 的值一致#<Engine name="Catalina" defaultHost="localhost" jvmRoute="SY1"> worker.controller.balance_workers=SY1#若增加 tomcat 節(jié)點(diǎn)，請(qǐng)參考以下格式添加#worker.controller.balance_workers=SY1,SY2#若增加 tomcat 節(jié)點(diǎn)，請(qǐng)參考上述格式添加worker.controller.sticky_session=1 worker.controller.sti

20、cky_session_force=0#與 tomcat 的 server.xml 中協(xié)議為 AJP/1.3 的 Connector 端口一致#<Connector port="8009" protocol="AJP/1.3" /> worker.SY1.port=8951worker.SY1.host= worker.SY1.type=ajp13 worker.SY1.lbfactor=1/*=controller#所有請(qǐng)求轉(zhuǎn)發(fā)到集群服務(wù)器上/jkstatus= status#jkstatus 的請(qǐng)求轉(zhuǎn)發(fā)到 statu

21、sworker 上JkLogFile lood_jk.log JkLogLevel debug #formatJkLogStampFormat "%a %b %d %H:%M:%S %Y" #optionsJkOptions +ForwardKeySize +ForwardURICompatUnparsed -ForwardDirectories JkRequestLogFormat "%w %V %T"JkMount /* controller HostnameLookups Off# Should mod_jk send SSL informatio

22、n to Tomcat (default is On)JkExtractSSL On# What is the indicator for SSL (default is HTTPS)JkHTTPSIndicator HTTPS# What is the indicator for SSL session (default is SSL_SESSION_ID)JkSESSIONIndicator SSL_SESSION_ID# What is the indicator for client SSL cipher suit (default is SSL_CIPHER)JkCIPHERIndi

23、cator SSL_CIPHER# What is the indicator for the client SSLd (default is SSL_CLIENT_CERT) JkCERTSIndicator SSL_CLIENT_CERT修改說(shuō)明：紅色粗體是需要修改的部分；worker.SY*.host 值為對(duì)應(yīng)協(xié)同服務(wù)器的 IP； worker.SY*中*為協(xié)同服務(wù)器 IP 的最后一段。2.4 啟用 HTTPS 配置Ø說(shuō)明：lll若不使用 Apache 的 HTTPS 功能，可以不進(jìn)行以下步驟。若為單機(jī)環(huán)境，則在 Apache 的 conf /pertie

24、s 中只需配置一個(gè) tomcat 節(jié)點(diǎn)。使用 https 需在 SeeyonConfig 中設(shè)置服務(wù)器配置為：?jiǎn)螜C(jī)(HTTPS)或集群/雙機(jī)。啟用支持 openssl 版本 Apache 的 HTTPS 功能步驟如下：Windows 下 https 配置Øl配置文件更改：n打開 httpd.conf 文件，取消注釋或增加以：n編輯 conf/extra/httpd-ssl.conf 文件，取消注釋或增加以：修改說(shuō)明：在 Apache/conf 目錄中放置 CA 的.crt 和.key 文件，注意文件名分別為：server.crt、server.key；為了取得更好的安全性，建議使用經(jīng)

25、過(guò)安全機(jī)構(gòu)認(rèn)證過(guò)的第。啟用 mod_jk 模塊，并開啟 https 時(shí)，httpd-ssl.conf 中需要增加 JkMount /* controller重啟 Apache 即可使用 http、https 方式Linux 下 https 配置Web 服務(wù)。Øll前提條件：編譯安裝包時(shí)，增加-enable-ssl 參數(shù)。其他配置同 Windows 下配置。北京致遠(yuǎn)互聯(lián)軟件10 / 16SSLFile"conf/server.crt"SSLKeyFile "conf/server.key" JkMount /* controllerInclude

26、 conf/extra/httpd-ssl.confworker.SY1.retries=3#若增加 tomcat 節(jié)點(diǎn)，請(qǐng)參考以下格式添加#worker.SY2.port=8951 #worker.SY2.host= #worker.SY2.type=ajp13 #worker.SY2.lbfactor=1 #worker.SY2.retries=3#若增加 tomcat 節(jié)點(diǎn)為多節(jié)點(diǎn)時(shí)，請(qǐng)參考上述格式添加3 Nginx 部署及配置Nginx 支持協(xié)同系統(tǒng)集群部署。為了保持負(fù)載均衡且實(shí)現(xiàn)會(huì)話保持，需要用到 nginx-sticky- module 模塊，此模塊目前僅支持

27、 Linux 系統(tǒng)，因此用 Nginx 做為 web 服務(wù)，則需要 Linux 操作系統(tǒng)的服務(wù)器。以下 Nginx 的部署及配置的說(shuō)明以 1.12.1 版本為基礎(chǔ)。3.1 Nginx 安裝ØNginx 及安裝過(guò)程中需要的依賴程序的參考如下：llNginx，參考（建議stable version）：nginx-sticky-module，參考module-ng/downloads/llllpcre，參考o(jì)penssl，參考zlib，參考：未安裝 gcc，請(qǐng)使用操作系統(tǒng)安裝盤（或安裝鏡像）進(jìn)行安裝Ø以所有的安裝程序位于/home/soft 下，nginx 的安裝目錄位于/hom

28、e/nginx 下，依次執(zhí)行以下命令進(jìn)行 nginx 的安裝（命令中標(biāo)紅的安裝包名稱，以實(shí)際的為準(zhǔn)）：北京致遠(yuǎn)互聯(lián)軟件11 / 16# 切換目錄至/home/soft cd /home/soft# 以實(shí)際的文件格式選擇 tar 或 zip 解壓# 解壓 tar 壓縮包tar -zxvf nginx-1.12.1.tar.gz tar -zxvf pcre-8.40.tar.gz tar -zxvf zlib-1.2.11.tar.gztar -zxvf openssl-1.1.0g.tar.gz # 解壓 zip 壓縮包unzip nginx-goodies-nginx-sticky-modu

29、le-ng-08a395c66e42.zip # 修改解壓后文件夾名，便于后續(xù)安裝mv nginx1.12.1 nginx mv pcre-8.40 pcremv nginx-goodies-nginx-sticky-module-ng-08a395c66e42 nginx-sticky-module mv zlib-1.2.11 zlibmv openssl-1.1.0g openssl # 賦權(quán)文件夾chmod -R 777 nginxchmod -R 777 openssl chmod -R 777 zlibchmod -R 777 nginx-stick-module chmod -R

30、 777 pcre# 進(jìn)行 nginx 的 configure3.2 Nginx 配置以 nginx 安裝在/home/nginx 下為例，nginx 的配置文件為/home/nginx/conf/nginx.conf。配置文件內(nèi)容示例如下（其中#號(hào)為注釋內(nèi)容，upstream 的名稱及服務(wù)地址依據(jù)實(shí)際情況進(jìn)行修改）：北京致遠(yuǎn)互聯(lián)軟件12 / 16worker_processes auto; worker_rlimit_nofile 20960;error_loglogs/error.logcrit; events worker_connections4096; multi_accept on

31、;accept_mutex on;accept_mutex_delay 500ms;http server_tokens off; sendfile on;tcp_nopush on; tcp_n ay on; access_log off;includemime.types;default_typeapplication/octet-stream; keepalive_timeout300;client_max_body_size 10240M; # 開啟 gzipgzip on;# 1KB 以下不進(jìn)行 gzip gzip_min_length 1k;# 設(shè)置 gzip 的 buffer g

32、zip_buffers 4 16k;# 設(shè)置 gzip 的等級(jí)，等級(jí)越高壓縮比例越大，越消耗 cpu gzip_comp_level 3;# 設(shè)置 gzip 的壓縮類型cd nginx# 注意以下 configure 命令./configure -prefix=/home/nginx -with-http_stub_status_module -with-http_ssl_module - with-http_realip_module -with-http_sub_module -with-http_flv_module -with- http_mp4_module -with-http_r

33、andom_index_module -with-http_gzip_static_module - with-pcre=/home/soft/pcre-add-module=/home/soft/nginx-sticky-module-with- openssl=/home/soft/openssl -with-zlib=/home/soft/zlib# 編譯、安裝makemake install北京致遠(yuǎn)互聯(lián)軟件13 / 16gzip_types text/xml text/plain text/css text/javascript application/x-javascript app

34、lication/javascript application/xml;# ie6 及以下版本瀏覽器不進(jìn)行 gzip gzip_disable "MSIE 1-6."# 定義一個(gè) upstream，名稱（seeyon_v5_cluster，可更改）、模式（必須為 sticky） 及其服務(wù)集（server， 為服務(wù) ip，80 為 http 端口，以實(shí)際情況進(jìn)行修改）upstream seeyon_v5_clustersticky;server :80 max_fails=5 fail_timeout=20s; server 192

35、.168.0.2:80 max_fails=5 fail_timeout=20s;# 定義一個(gè) server server # 設(shè)置端口listen80;# 設(shè)置 server 名稱server_namelocalhost; # 設(shè)置字符集charset utf-8;# 設(shè)置 location location / # 轉(zhuǎn)發(fā)請(qǐng)求至 seeyon_v5_cluster，該名稱與 upstream 的名稱一致proxy_pass;# 設(shè)置 header 的 host 包含 host 及 port proxy_set_header Host $host:$server_port; # 設(shè)置 head

36、er 的客戶端 ip 為實(shí)際 ip proxy_set_header X-Real-IP $remote_addr;proxy_set_header REMOTE-HOST $remote_addr; # 設(shè)置 header 的協(xié)議為實(shí)際使用的協(xié)議proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme;# 關(guān)閉 redirect proxy_redirectoff; # 設(shè)置超時(shí)時(shí)間proxy_connect_timeout 300;proxy_read_timeout 300;proxy_send_timeout 300;error_page500 502 503 504/50x.html; location = /50x.html roothtml;3.3 Nginx 啟動(dòng)以 nginx 安裝在/home/nginx 下為例，nginx 的啟動(dòng)如下：為/home/nginx/sbin/nginx。啟動(dòng)示例3.4