Toggle navigation


然之&禅道&EspoCRM镜像手册

Version 然之4.5&禅道9.6.3&EspoCRM4.8.4

由Websoft9提供一个包含Ranzhi然之OA、ZenTao禅道和EspoCRM的组合集成环境,用户可以轻松实现企业内部研发、销售和后台事物支持一体化管理,充分利用开源软件提升管理效率,节省运营成本。

Ranzhi然之OA是一款易用性极佳、功能非常全面的开源OA系统;ZenTao禅道是中国最知名的开源项目管理软件之一;EspoCRM是一个支持中文、支持多屏自适应访问的CRM系统。


本文档适用于通过主流云市场购买和部署了Websoft9镜像的用户,文档内容重点指导用户进行安装配置、系统基本操作和常见运维问题处理。

文档适用性说明:

  • 适用的主流云平台包括:阿里云、腾讯云、百度云、华为云、Azure、青云
  • 适用的操作系统包括:Linux、Windows
  • 适用的阅读者包括:初学者、学生、站长、运维人员、产品经理、开发者、UI

 

 

Websoft9的镜像由应用软件、运行环境、数据库和运维面板四个部分组成,并基于云厂商操作系统镜像打包:

Linux版本(CentOS,Ubuntu,AliyunLinux)

Linux版本的chanzhi&Zentao&EspoCRM镜像采用LAMP作为运行环境,以最新版本为例,组件包括:

应用软件(Chanzhi, Zentao,EspoCRM)
安装目录:/data/wwwroot/default/chanzhi
安装目录:/data/wwwroot/default/zentao
安装目录:/data/wwwroot/default/espocrm
运行环境(PHP 7.0,Apache 2.4.8)
PHP配置文件目录: /etc/php.ini
Apache虚拟主机文件目录: /ect/httpd/conf.d
日志文件目录:/var/log/httpd
数据库(MySQL5.6.3)
MySQL数据目录: /data/mysql
MySQL配置文件: /etc/my.cnf
数据库账号:root/123456
数据库面板访问路径:http://公网ip/phpmyadmin
运维面板(9Panel)
9Panel是Websoft9根据镜像用户的习惯和技术能力而研制的轻量级面板,以帮助用户快速掌握程序安装和运维工作
访问路径:http://ip/9panel

服务器要求

本镜像在云服务器的最低配置(1核CPU1G内存)下即可运行

  1. 镜像需要与服务器配套使用,获取Websoft9的镜像有两种方式:
    方式一:若没有可用的云服务器,登录主流云厂商的云市场,找到由Websoft9提供的然之&禅道&EspoCRM相关免费镜像,点击“购买”(同时会配套购买云服务器,若只打算试用请选择“按量”方式购买,实现按小时使用,接近免费)
    方式二:登录到云厂商的控制面板,找到可用的云服务器,通过更换系统盘(重装镜像)的方式
  2. 待镜像购买或更换完成后,镜像会自动安装到配套的云服务器上,当云服务实例处于“运行中”后,通过浏览器访问网址
    http://服务器公网IP/9panel,正常会出现如下界面:
  3. 如果浏览器访问以上网址没有任何反应,请检查您的安全组设置,确保80端口是开放的。

注意:安装之前一定要确认是否使用域名。有无域名对应的安装步骤是略有差别的,请选择下面不同的访问方式来完成安装过程:

方式一:通过IP访问应用

如果不打算使用域名访问网站,而是通过IP地址访问网站,安装非常简单:

本地浏览器访问:http://公网ip/9panel,根据提示分别进入各个软件的安装向导,然后参考下面的文档完成:

点击链接进入各个软件安装页面后,参考如下的安装向导文档:

 

方式二:共用一个域名访问应用

如果打算通过一个域名访问,即http://域名/ranzhi,http://域名/zentao等方式。安装步骤如下:

  1. 登录到域名管理面板,完成解析域名(假设您的域名是abc.com)
    例如:增加一个A记录,将www.abc.com解析到服务器公网IP地址
  2. 本地浏览器访问:http://域名/9panel,根据提示分别进入各个软件的安装向导

点击链接进入各个软件安装页面后,参考如下的安装向导文档:

 

方式三:分别为每个应用配置域名

在LAMP环境下,如果您打算通过三个自域名(假设您的主域名是abc.com)来访问ranzhi,zentao,espocrm。域名配置如下:

  1. 登录到域名管理面板,完成3个解析域名
    ranzhi域名解析,例如:增加一个A记录,将ranzhi.abc.com解析到服务器公网IP地址
    zentao域名解析,例如:增加一个A记录,将zentao.abc.com解析到服务器公网IP地址
    espocrm域名解析,例如:增加一个A记录,将espocrm.abc.com解析到服务器公网IP地址
  2. 通过WinSCP远程到Linux服务器,进入/etc/httpd/conf.d目录,分别将“ranzhi.conf.范例”、“zentao.conf.范例”和“espocrm.conf.范例”内容中的示例域名(类似:mydomain.com等字样)替换成您的域名,然后保存,并去掉“.范例”后缀
  3. 通过Putty工具运行“systemctl restart httpd”重启服务
  4. 通过9panel修改数据库root密码(修改后一定要重新登录验证一下)
  5. 分别通过http://chanzhi.abc.com,http://zentao.abc.com,http://espocrm.abc.com来安装网站

进入各个软件安装页面后,参考如下的安装向导文档:

 

应用程序安装、使用和维护中需要用到多种账户:

1、MySQL数据库默认账号和密码root/123456,管理地址:http://公网ip/phpmyadmin

2、然之后台账号和密码:安装的时候自行设置的,管理地址:http://ip/ranzhi 或者 http://域名

3、禅道后台账号和密码:安装的时候自行设置的,管理地址:http://ip/zentao 或者 http://域名

4、EspoCRM后台账号和密码:安装的时候自行设置的,管理地址:http://ip/espocrm 或者 http://域名


5、服务器操作系统账号和密码

Linux服务器账号和密码说明:

  • 账号:root
  • 密码:是安装镜像的时候客户自行设置的,若不记得此密码,请登录云服务器后台,修改服务器密码,重启后生效
  • 登录:下载一个putty工具,通过root账号登录,参考(服务器通用文档-Linux远程管理与FTP

Windows服务器账号和说明:

  • 账号:administrator
  • 密码是安装镜像的时候客户自行设置的,若不记得此密码,请登录云服务器后台,修改服务器密码,重启后生效
  • 登录:PC本地打开远程桌面工具-通过Administrator账号连接,参考(服务器通用文档-Windows远程桌面与FTP

管理Linux系统,只需要用到两个工具即可满足大部分使用场景

  • WinSCP,可视化界面的SFTP工具,90%的Linux操作均可通过它来实现(下载WinSCP
  • Putty,远程登录&命令操作软件,需要用到命令操作的时候使用(下载Putty

具体参考:

Websoft9镜像默认安装了可视化MySQL管理工具phpMyadmin,其安装目录: /usr/share/phpMyAdmin。

如何使用PhpMyAdmin数据库?

  1. 通过本地Chrome或Firefox浏览器,访问:http://服务器公网IP/9panel
  2. 点击左侧菜单的“数据库管理”项,会进入“登录PhpMyAdmin”链接
  3. 选择您需要的语言,然后输入root和对应的密码,然后登录到系统中

常见的数据库相关操作包括:
修改root密码、创建数据库、创建用户和权限设置、导入和导出等,具体参考《MySQL文档-PhpMyAdmin常见操作》

网站技术日新月异,更新升级是维护工作之一,长时间不升级的程序,就如长时间不维护的建筑物一样,会加速老化、功能逐渐缺失直至无法使用。完成的升级包括:操作系统补丁升级、运行环境补丁漏洞升级和应用程序升级三个部分

  • Websoft9的镜像可以自动完成操作系统和运行环境的升级,用户只需关注应用程序的升级即可。若计划立即进行升级,可以通过通过Putty运行升级命令:
    [root@iZm5ejevtfmojhh6jmr078Z ~]# yum update -y
  • 软件的升级方案待续

网站的定期备份和重要操作之前的备份工作(如系统升级或重要修改)无比重要,可以做到防范于未然,让发生了意外而能够进行复原,这是网站运维工作的重中之重。 本镜像的备份有基于服务器快照自动备份、手动本地备份等方式,两种凡是各有利弊,建议结合起来使用

服务快照自动备份

云服务器厂商都会提供一个叫“快照”的功能,快照是针对于服务器的磁盘来说的。快照工具可以记录指定时间点硬盘的数据,全部备份起来,并可以实现一键恢复。 如果您对磁盘进行了自动的快照设定,如下场景您便可以比较从容的面对: 1、工作了几天的成果,被误删了 2、黑客把把网站网站弄的面目全非 3、现在的内容已经乱七八糟了,我要回到一个正常的服务器状态 做了快照备份,一键恢复到备份时间点的状态。也就是现场还原,很好的功能。 不同的云厂商快照设置稍有差别,具体参考:

手工本地备份

手工本地备份主要是通过下载应用程序文件和备份导出数据库文件,建议备份周期每月一次,备份文件保存6个月左右。下面就具体的备份操作进行说明:

  1. 通过SFTP工具登录到服务器,将网站目录完整的下载到本地(如果文件数量比较多,建议压缩后再下载) 
  2. 通过浏览器进入PhpMyAdmin(网址:http://服务器公网ip/phpMyAdmin),进入数据库管理界面
  3. 左侧菜单中选择所需的数据库,顶部导航栏上选择“导出”标签 
  4. 选择导出方式和格式(建议SQL),点击“执行”,导出文件后下载到本地
  5. 将程序文件和数据库文件放到同一个文件夹,根据日期命名,备份工作完成

Websoft9的镜像支持部署多个应用程序(网站),但不同类型操作系统有不同的操作方法,具体参考:

LAMP环境新增

Linux下的LAMP环境支持部署多个应用程序(网站),具体操作如下:

  1. 通过SFTP将网站文件上传到/data/wwwroot/default/目录下面,假设程序目录命名为“mysite”
  2. 修改mysite文件夹的权限和用户组(参考:如何修改Linux文件系统的权限?
  3. 通过域名控制台将域名解析到服务器公网IP
  4. 通过SFTP打开 /ect/httpd/conf.d目录,新增一个conf文件,假设名称为www.mydomain.com.conf,将下面内容拷贝到文件中,根据你的实际情况进行修改、保存。
<VirtualHost *:80>
ServerName www.mydomain.com
ServerAlias mydomain.com
DocumentRoot "/data/wwwroot/default/mysite"
ErrorLog "/var/log/httpd/www.mydomain.com_error_apache.log"
CustomLog "/var/log/httpd/www.mydomain.com_apache.log" common
<Directory "/data/wwwroot/default/mysite">
Options Indexes FollowSymlinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>

如果没有域名或不打算通过域名访问,步骤“5”的配置文件内容为:

Alias /mysite "/data/wwwroot/default/mysite"   
 <Directory "/data/wwwroot/default/mysite">
	        Options Indexes FollowSymlinks
	        AllowOverride All
	        Require all granted
	    </Directory>

重启http服务后,再通过http://www.mydomain.com或http://ip/mysite访问新网站,如何配置没有问题,您会成功打开网站 说明:Apache的配置文件规则和语法非常灵活,以上仅供参考

上传一个扩展或模板文件夹,建议修改Linux系统的权限以便能够正常访问。网站的权限设置值建议如下:
file 644, folder 755 ,用户和用户组分别是 apache : apache

方法一:putty登录命令行方式(推荐)

~# chown -R apache.apache /data/wwwroot/default
~# find /data/wwwroot/default -type d -exec chmod 755 {} \;
~# find /data/wwwroot/default -type f -exec chmod 644 {} \;

方法二:WinSCP右键修改,参考:使用WinSCP设置文件夹权限

使用PHP应用程序的时候,php组件的启用或停用、邮件设置、上传文件大小等控制都会涉及修改php配置文件。本镜像php配置文件的安装目录为: /etc/php.ini 下面是一些与安装相关的php参数:

  • memory_limit – Minimum: 256M   //默认内存
  • upload_max_filesize – Minimum: 20M  //上传文件最大值
  • post_max_size – Minimum: 20M   //通过POST提交数据的最大值
  • max_execution_time: At Least 120 Recommended: 300  //PHP最大执行时间

需要修改上述参数的值,只需要通过SFTP打开php.ini,修改(“#”在前的项表示没有启用,请根据实际情况删除“#”),然后保存 保存后还需要重启http服务才能生效,重启命令如下:

~# systemctl restart httpd

如果您不会使用命令操作,通过云服务器后台去重启服务器也可以达到同样的效果。

如何修改上传文件大小限制?

通过SFTP修改 /etc/php.ini 如下的部分

; Maximum size of POST data that PHP will accept.
post_max_size = 16M
; Maximum allowed size for uploaded files.
upload_max_filesize = 16M

保存后,重启http服务

~# systemctl restart httpd

如果您不会使用命令操作,通过云服务器后台去重启服务器也可以达到同样的效果。

如何修改系统最大响应时间?

我们在运行应用程序的时候,常常会等待很长的时间之后,却收到这样的错误提示 “Maximum execution time of 30 seconds exceeded”。这种情况下就需要通过修改the max_execution_time(最大执行响应时间)的值来解决这个问题。 方法一(推荐): 通过SFTP修改 /etc/php.ini 如下的部分

; Maximum execution time of each script, in seconds
; http://php.net/max-execution-time
; Note: This directive is hardcoded to 0 for the CLI SAPI
max_execution_time = 90
; Maximum amount of time each script may spend parsing request data. It's a good
; idea to limit this time on productions servers in order to eliminate unexpectedly
; long running scripts.

方法二: 如果应用程序支持 .htaccess,请修改它:

<IfModule mod_php5.c>
php_value max_execution_time 90
</IfModule>

保存后,重启http服务

~# systemctl restart httpd

如果您不会使用命令操作,通过云服务器后台去重启服务器也可以达到同样的效果。

如何安装PHP扩展?

当应用程序进行大版本升级的时候,可能会需要增加某种php扩展。 安装php扩展的步骤如下: 1、利用yum search查找扩展包

~# yum search memcached php
php-pecl-memcached - memcached module for php5

2、使用yum install安装扩展包

~# yum install -y php-pecl-memcached
Reading package lists... Done
Reading state information... Done

使用本镜像的Linux版本,可能需要用到的命令如下:

~# cd /data/wwwroot/default  //进入网站根目录
~# reboot //重启服务器
~# wget url  //下载url对应的文件
~# unzip xx.zip //解压xx.zip文件到当前目录

~# systemctl start | stop | restart httpd  //启动、关闭、重启http服务
~# systemctl start | stop | restart mysqld //启动、关闭、重启mysql数据库

~# yum update -y //升级所有包同时也升级软件和系统内核,-y当安装过程提示选择全部为"yes"
~# yum upgrade -y //只升级所有包,不升级软件和系统内核,-y当安装过程提示选择全部为"yes"

本文档由长沙网久软件有限公司原创,为了保证文档的严肃性和可用性,任何人不得盗用或修改后二次分发。转载请标注来源,否则我们保留给予法律追究的权利。

我们会定期更新文档,请访问在线文档以获取最新版本

本文档在线地址:http://www.websoft9.com/xdocs/ranzhi-zentao-espocrm-image-guide
合作或技术支持:http://www.websoft9.com