CommunityServer的编译

1. 简介

Community Server是一个免费的开源协作系统，用于管理文档、项目、客户关系和电子邮件通信，可以在私有服务器上安装和配置。它的组成分为：

　　1. OnlyOfficeJabber - 即时消息服务;

　　2. OnlyOfficeNotify - 邮件通知服务;

　　3. OnlyOfficeIndex - 全文检索相关服务;

　　4. OnlyOfficeFeed - 门户新闻种子分析和布局服务;

　　5. OnlyOfficeBackup - 创建备份、下载和部署等服务;

　　6. OnlyOfficeAutoReply - 对不同门户实体自动应答和通过邮件新建实体等服务；

　　7. OnlyOfficeSocketIO - Web页面的Talk工具消息交换服务;

　　8. OnlyOfficeMailAggregator, OnlyOfficeMailWatchdog - Windows服务，用来聚合和保存邮件消息。服务配置的详细信息可以参考以下文件:

　　　　8.1 module\ASC.Mail.Aggregator\ASC.Mail.Aggregator.CollectionService\ReadMe.txt

　　　　8.2 module\ASC.Mail.Aggregator\ASC.Mail.Aggregator.CollectionService\Requirements.txt

　　　　8.3 module\ASC.Mail.Aggregator\ASC.Mail.Watchdog.Service\ReadMe.txt

　　9. WebStudio - Web网站，页面产品和模块展示;

　　10. Auxiliary tools

2. 安装需求

2.1 硬件需求

CPU：dual core 2 GHz or better

内存：不少于4 GB

硬盘：至少 2 GB

2.2 软件需求

①　操作系统: Microsoft Windows Server 2012 (R2)以上

②　Microsoft .NET Framework 4.7.2 Developer Pack;

③　Microsoft Build Tools 2015;

④　Internet Information Services 7以上，包含以下模块:

• Internet Information Services Manager;
• Default Document; Directory Browsing; HTTP Errors; HTTP Redirection; Static Content;
• .NET Extensibility (for Microsoft Windows 7, Microsoft Windows Server 2008 (R2));
• .NET Extensibility 3.5; .NET Extensibility 4.6.2 (for Microsoft Windows 8, Microsoft Windows 8.1, Microsoft Windows Server 2012(R2), Microsoft Windows Server 2016);

⑤　Node.js: 版本8.12.0及以上;

⑥　MySQL Server 5.5及以上;

⑦　Python: 3.7.2 (64-bit);

⑧　Redis: 3.0.504 (64-bit);

⑨　Java SE Runtime Environment: 8u171 (64-bit);

⑩　Elasticsearch: v6.5.0 (64-bit);

⑪　Web Browser: Microsoft Internet Explorer 9 以上，最新版本的 Mozilla Firefox, Opera, Safari, Google Chrome.

3.数据库

Community Server使用MySql数据库，标准配置和流程如下：

　　1. 确保本地MySql服务器版本不低于5.5 ;

　　2. 用onlyoffice名称创建一个数据库;

　　3. 从build\sql\顺序运行下列sql脚本

　　　　3.1 安装脚本:

　　　　onlyoffice.sql，onlyoffice.data.sql，onlyoffice.resources.sql

　　　　3.2 升级脚本: onlyoffice.upgrade*.sql

如果不用标准配置，可以用自己的用户名，密码和数据库名：

　　1. 创建包含下列文本的文件:

　　　　Server={ServerName};Database={DatabaseName};User ID={UserName};Password={UserPassword};Pooling=True;Character Set=utf8

　　2. 更改下列配置文件中连接字符串:

　　　　2.1 web\studio\ASC.Web.Studio\web.connections.config

　　　　2.2 build\config\TeamLabSvc.exe.config

　　　　2.3 module\ASC.Mail.Aggregator\ASC.Mail.Aggregator.CollectionService\App.config

　　　　2.4 odule\ASC.Mail.Aggregator\ASC.Mail.Watchdog.Service\App.config

　　3. 运行sql脚本。

 

4. Community Server

 

4.1 编译

 

进至build文件夹，用BuildAndDeploy.bat编译源码。完成后的二进制文件位于\build\deploy\OPENSOURCE.SERVER。

 

4.2 部署

 

假设部署目录为С:\ONLYOFFICE,将\build\deploy\OPENSOURCE.SERVER所有文件拷贝至其中。

 

4.3 安装服务

 

进入"cd C:\ONLYOFFICE\Services\TeamLabSvc",执行”ManageServices.bat --install-all”命令.

 

5. IIS配置

 

Community Server使用IIS网站管理。注意配置参数中80端口对于HTTP，443端口对应HTTPS。不建议修改上述网站端口。

 

IIS需要安装如下组件：

 

• Application Request Routing. 下载完后按照提示安装。在IIS管理中，选择 Application Request Routing Cache 选项, 打开Server Proxy Settings，勾选Enable proxy和Reverse rewrite host in response headers.
• URL Rewrite Module. 下载完后按照提示安装。在控制面板中，选择Programs and Features，Turn Windows features on or off， 展开Internet Information Services > World Wide Web Services > Application Development Features，打开WebSocket Protocol 选项. 点击OK 确保安装完毕。

 

IIS配置如下:

 

1. 打开IIS管理器.
2. 添加站点ONLYOFFICE CommunityServer指向C:\ONLYOFFICE\WebStudio。
3. 确保网站使用.Net Framework 4.0（Application Pools -> Edit Application Pool ->  Basic Settings）。
4. 在网站内建立一个mailattachments 虚拟目录，指向C:\ONLYOFFICE\Data。用于邮件聚集计算。
5. 确保网站用户和IUSR角色用户对C:\ONLYOFFICE 拥有最高权限:

　　　　5.1 选择C:\ONLYOFFICE "Security"选项卡

　　　　5.2 点击"Edit..."

　　　　5.3 点击"Add..." 添加新组或用户

　　　　5.4 加入IUSR用户

　　6. Documents模块需要激活WCF Http Activation组件. 控制面板中Programs And Features，选择Turn Windows Features On or Off，展开至.NET Framework 3.5 选择WCF Http Activation。

 

6. 防火墙配置

 

Community Server 的通知服务器，即时消息服务器和邮件聚合计算都需要通过特定端口访问外部网络，可将下列程序添加入防火墙的例外中。

 

• C:\ONLYOFFICE\Services\TeamLabSvc\TeamLabSvc.exe
• C:\ONLYOFFICE\Services\MailAggregator\ASC.Mail.Aggregator.CollectionService.exe

 

7. Community Server门户

 

按照上述步骤，Community Server 门户对应http://communityserver 地址. 在门户启动后，需要设置如下参数：

 

• Password
• Email address
• Language和Time Zone