Để cài đặt zimbra docs trên Zimbra server, bạn tiến hành theo các bước sau (các lệnh sử dụng cho môi trường redhat, bạn thay đổi cho phù hợp với Ubuntu nếu đang sử dụng).

Với quyền root, chạy:

yum remove zimbra-onlyoffice
yum remove zimbra-onlyoffice-patch
yum remove zimbra-rabbitmq-server
yum remove zimbra-erlang
mv /opt/zimbra/onlyoffice /tmp
yum clean metadata
yum check-update
yum install zimbra-onlyoffice
yum install zimbra-rabbitmq-server
yum install zimbra-erlang
yum install zimbra-onlyoffice-patch
/opt/zimbra/onlyoffice/bin/zmonlyofficeconfig new
su - zimbra
zmprov ms `zmhostname` +zimbraServiceInstalled onlyoffice +zimbraServiceEnabled onlyoffice
zmprov fc -a all
zmcontrol restart

Hãy đảm bảo rằng thông số zimbraDocumentServerHost đã được cấu hình trỏ về tên của server cài đặt docs, đồng thời kiểm tra lại đảm bảo mysql database có chứa database onlyoffice.

zmprov -l gacf zimbraDocumentServerHost
mysql -e "show databases" | grep -i onlyoffice;

Ngoài ra bạn cũng cần kiểm tra các tham số zimbraFeatureViewInHtmlEnabled và zimbraFeatureBriefcasesEnabled đã được bật. Ví dụ kiểm tra 2 tham số này cho 1 account cụ thể như sau (thay user@domain.com bằng account của bạn):

zmprov -l ga user@domain.com zimbraFeatureViewInHtmlEnabled zimbraFeatureBriefcasesEnabled

Trong trường hợp bạn gặp vấn đề với docs server không hoạt động, người dùng không edit, xem được các file tài liệu. Hãy tham khảo các bước xử lý sau:

1. Kiểm tra tham số JWT secret trong Zimbra

zmprov -l gacf zimbraDocumentEditingJwtSecret

Nếu không thấy kết quả hiển thị, bạn cần thiết lập (tạo) một giá trị (secret value) cho nó.

Đảm bảo rằng secret value này giống với thông số trong file cấu hình của ONLYOFFICE.

grep -w secret\" -A16 /opt/zimbra/onlyoffice/documentserver/server/Common/config/default.json

Các giá trị cho inbox, outbox, session, và browser cần thống nhất và giống với giá trị trong ZIMBRA. Ví dụ, chúng sẽ giống như sau:

"secret": { "inbox": { "string": "XPgqQds9", "file": "" }, "outbox": { "string": "XPgqQds9", "file": "" }, "session": { "string": "XPgqQds9", "file": "" }, "browser": { "string": "XPgqQds9" } }

Nếu giá trị secret bị thiếu hoặc không đồng bộ, chạy lệnh sau với quyền root để tạo lại cấu hình:

/opt/zimbra/onlyoffice/bin/zmonlyofficeconfig

2. Đảm bảo zimbra-rabbitmq-server và zimbra-erlang đã được cài đặt

rpm -qa | egrep 'zimbra-rabbitmq-server|zimbra-erlang|onlyoffice'

3. Kiểm tra onlyoffice database

mysql -e "show databases" | grep -i onlyoffice;

Nếu không thấy database, chạy lệnh sau để khởi tạo:

opt/zimbra/common/bin/mysql -S /opt/zimbra/data/tmp/mysql/mysql.sock -u root --password=$mysql_root_password < /opt/zimbra/onlyoffice/bin/createdb.sql

Bạn nhớ nhập đúng mysql root password của zimbra.

4. Đảm bảo zimbraDocumentServerHost đã được cấu hình đúng

zmprov -l gacf zimbraDocumentServerHost

5. Đảm bảo các zimlet sau đã được cài đặt và bật

zimbra-zimlet-document-editor
zimbra-zimlet-classic-document-editor

6. Đảm bảo các cổng TCP 7074 và 7084 đã được mở và từ zimbra server có thể truy cập onlyoffice (docs) server.

netstat -tulpn |grep -i 7074
netstat -tulpn |grep -i 7084