Close menu

INTRODUCTION

Introduction

What is Carbonio?

Zextras Carbonio is a totally private digital workspace that includes:

  • E-mail, Contacts, and Calendar Essentials are all domain-shareable.
  • A full mailserver that includes anti-spam and anti-virus software.
  • Video and text conversations
  • File Management System with collaborative editing and document sharing capabilities

Carbonio’s strong characteristics include:

  • concentrate on data sovereignty and privacy
  • installation as Linux packages and ready to use out of the box
  • a full collection of collaboration and communication tools at the enterprise level
  • Scalability: start with a single server, then add nodes as the company’s infrastructure and needs expand.
Browser Compatibility

 All Carbonio functionalities are available via a browser, as shown in Table 1.

List of supported browsers

Browser

Version

OS

Supported

Microsoft Edge (Chromium)

Latest

Windows

 Yes

Microsoft Edge (Chromium)

Others

Windows

 Limited

Microsoft Edge (EdgeHTML)

Any

Windows

 No

Internet Explorer

Any

Windows

 No

Mozilla Firefox

Latest

Windows/Linux/OSX

 Yes

Mozilla Firefox

ESR

Windows/Linux/OSX

 Yes

Mozilla Firefox

Others

Windows/Linux/OSX

 Limited

Google Chrome

Latest

Windows/Linux/OSX

 Yes

Google Chrome

Others

Windows/Linux/OSX

 Limited

Safari

Latest

OSX

 Yes

Safari

Others

OSX

 Limited

Items marked as “ Limited” are only supported on the browser’s two previous stable

Hint

We suggest to always use the latest version available of the browser.

Languages Available

The primary language of Carbonio is English, and the Web GUI is accessible in these languages.

Languages officially included

  •  English (GB, US, AU)
  • Dutch
  • French
  • German
  • Hindi
  • Indonesian
  • Italian
  • Japanese
  • Portugese (PT/BR)
  • Russian
  • Chinese that has been simplified
  • Spanish
  • Thai

Languages supported by the community

  • Polish
  • Turkish
Participation in Documentation

Carbonio’s documentation source code is now accessible in a public repository hosted on Github.

We welcome any type of documentation provided in accordance with the criteria in the form of a pull request. If you have a suggestion for the documentation or are unsure about utilising Python Sphinx (the framework we use for producing documentation), please contact documentation@zextras.com.

 
General and Common Knowledge
In every situation, generic and common information is required: this type of data enables to grasp the context in which the issue occurred. The output of each of the following commands must be saved to a text file.
 
zextras$ zmcontrol -v

zextras$ carbonio --host all_servers core getVersion

zextras$ carbonio core getLicenseInfo

zextras$ zmprov gas

zextras$ zmprov gas mailbox

zextras$ systemctl status carbonio-*

zextras$ journalctl

Hint

To save the output of to a text file, you use the > operator, for example

zextras$ zmcontrol -v > zmcontrol.txt
 

An additional task that help the Technical Support Team is to enable debug logging, then attach to the ticket the log files generated:

increase the log verbosity on the mailbox server by running

  1. increase the log verbosity on the mailbox server by running

    zextras$ carbonio config server set $(zmhostname) \
attribute ZxCore_LogLevel value 0

  2. Recreate the problem

  3. Run to restore the regular log verbosity.

    zextras$ carbonio config server set $(zmhostname) \
attribute ZxCore_LogLevel value 1

Once completed, the log files to attach are as follows:

  • The mailbox server’s mailbox.log file

  • The files nginx.log and nginx.access.log from the Proxy Node

Mobile Devices and Apps

Follow these instructions on an email account and a mobile device, then attach the log files generated by the method.

Procedure

  1. Activate an account logger in debug mode on one of the affected devices using the command

    zextras$ carbonio mobile doAddAccountLogger user@domain.tdl
debug /path/to/log/file.log

  2. Remove the account from the device

  3. Add the account on the device again

  4. Try to reproduce the issue

Files and information to attach

  • The mailbox.log and the sync.log files

  • A brief explanation of how to reproduce the issue

  • Manufacturer, model and exact OS version of the mobile device

  • The output of the following commands, making sure to replace the uppercase parameters with the e-mail account and the ID of the device

    zextras$ carbonio mobile getDeviceList JACK.SMITH@ACME.EXAMPLE

    zextras$ carbonio mobile getDeviceInfo JACK.SMITH@ACME.EXAMP

Chats with Carbonio

If you are having issues with Carbonio Chats, save the output of the following instructions. JACK.SMITH@ACME should be replaced.EXAMPLE: Take a look at one of the impacted accounts. You may alternatively create a test account with no Administrator credentials and run the tasks again.

zextras$ carbonio config dump global

zextras$ carbonio chats clusterStatus

zextras$ carbonio chats getServices

zextras$ carbonio chats iceServer get

zextras$ for cos in $(carbonio prov gac); do carbonio prov gc $cos; done

zextras$ carbonio prov ga JACK.SMITH@ACME.EXAMPLE

zextras$ for cos in $(carbonio prov gac);
do echo $cos;
carbonio config cos get $cos;
done

zextras$ carbonio config account get JACK.SMITH@ACME.EXAMPLE

zextras$ for dom in $(carbonio prov gad);
do carbonio prov gd $dom zimbraPublicServiceProtocol \
zimbraPublicServiceHostname zimbraPublicServicePort;
done

zextras$ carbonio powerstore getAllVolumes

Attach the following files to the ticket as well.

  • the mailbox.log file in relation to a mailboxd restart with zmmailboxdctl restart

  • mailbox.log, zmmailboxd.out, nginx.log, and nginx.access.log files over the previous two days

The Carbonio Files

In the event of a problem with Carbonio Files, please supply the output of this script

zextras$ for dom in $(carbonio prov gad);
do carbonio prov gd $dom zimbraPublicServiceProtocol
zimbraPublicServiceHostname zimbraPublicServicePort;
done

 As well as the files /var/log/carbonio/files/files.log and /var/log/carbonio/docs-connector/docs-connector.log 

Carbonio Storage Facility

In the case of Carbonio Storages, you must additionally give information regarding Carbonio’s storage infrastructure (volumes, discs).

zextras$ mount


zextras$ df -h


zextras$ df -i

Then, gather information on the Carbonio Storages setup.
 
zextras$ carbonio powerstore getAllVolumes


zextras$ carbonio powerstore getHsmPolicy


zextras$ carbonio powerstore getMovedMailboxes


zextras$ carbonio powerstore getNonLocalMailboxes


zextras$ carbonio config dump server $(zmhostname)

Backup for Carbonio

As with Carbonio Storages, first gather certain environmental data.

zextras$ mount

locating the Backup Path and other configuration:

zextras$ ls -l $(carbonio config dump server $(zmhostname) | grep ZxBackup_DestPath | tr -s ' ' | cut -d ' ' -f 3)


zextras$ carbonio config dump server $(zmhostname)


zextras$ carbonio backup getBackupInfo

Client-side concerns

If you encounter a client-side problem, follow the steps below to gather the necessary information:

  • Launch a new browser window (Chrome or Firefox).

  • Open the Javascript Console (Windows and Linux: Ctrl + Shift + j, Mac: Cmd + Opt + j).

  • Access webmail from the same tab where the Javascript Console is active.

  • Wait for the webmail to finish load.

  • Reproduce the issue

  • Navigate to the Javascript Console’s Console tab, right-click anywhere, and choose Save as… to save the tab’s content as a text file

  • To save the tab’s content as a text file, go to the Network tab of the Javascript Console, right-click anywhere, and choose Save as HAR with content.

  • Attach both the console export and the network export files to the ticket.