How to Enable MACL Support for Existing Domains

This KB article will focus on the process of adjusting the Axigen configuration file for enabling sharing permissions to an existing domain

Solution

First check that your license includes the "SharedOrganizer" addon:
In case you are running a trial version this check is not required, proceed further down for instructions on how to enable this feature for existing domains.

- Login to the Webadmin interface.
- Click the "Global settings" button.
- Review the "Addons" section of your license details.
- If the addon is not present contact your Axigen Sales Department representative for details.

NOTE: If you are already using version 6.0.1, please follow the instructions from the bottom of this article.

Starting with Axigen release version 6.0.0 a new feature of sharing one account's information with other accounts on the server was implemented.
This feature is configured at domain level and can be enabled only at domain creation time. After the domain was created further configuration of this feature is not available using the Webadmin interface.
If an upgrade from previous versions of Axigen is performed this feature is, by default, disabled.
This article focuses on the process of enabling/disabling the MACL feature for domains that were already created or domains that had this feature disabled at creation time.

This process involves the hand editing of the Axigen configuration file.Before starting create a backup copy of this file located in the /var/opt/axigen/run or /var/axigen/run directory.
Open the axigen.cfg file in you favorite text editor and scroll to the section "domainStorageParams
The section should look like the one below:

primaryDomain = "example.org"
enableIOSynchronization = no
serverDataLocation = "file:////var/opt/axigen/serverData"
domainStorageParams = (
        {
            domainStorageLocation = "file:///var/opt/axigen/domains/example.org/"
            domainObjectStorageLocation = "file:///var/opt/axigen/domains/example.org//objects"
            messageStorageLocations = (
                "file:///var/opt/axigen/domains/example.org//messages"
            )

            enableMACLSupport = no
        }
    )

Please note that the MACL feature is a per domain setting allowing some domains to use this feature and others to not.

The configuration adjustment involves changing the value of the "enableMACLSupport" configuration variable from "no" to "yes" for the desired domains similar to the below example:

primaryDomain = "example.org"
enableIOSynchronization = no
serverDataLocation = "file:////var/opt/axigen/serverData"
domainStorageParams = (
        {
            domainStorageLocation = "file:///var/opt/axigen/domains/example.org/"
            domainObjectStorageLocation = "file:///var/opt/axigen/domains/example.org//objects"
            messageStorageLocations = (
                "file:///var/opt/axigen/domains/example.org//messages"
            )

            enableMACLSupport = yes
        }
    )

Starting with version 6.0.1, a button called "Enable groupware" has been included in the WebAdmin interface that will automatically enable groupware (MACL) support for a specific domain. This button is available in domain's configuration, after pressing the 'Edit' button for that respective domain.

After the configuration adjustment has been performed save the file and restart the Axigen service by issuing the following command:

/etc/init.d/axigen restart
OS: LinuxFreeBSDNetBSDOpenBSDSolaris
Distros: WindowsDEB based distros amd64