Creating a Group

About this task

The global administrator creates a group to store the email addresses or domains of recipients whose mail will be managed by the group administrator responsible for that group. Groups must be created on the central server (CSM). Group names must:

  • contain only alphanumeric characters, hyphens, and underscores (all other characters are invalid)
  • not begin with a number, hyphen, or underscore
  • consist of at least two characters

To create a group:

Follow these steps

  1. Log on to the central server as the "pmx6" user.
  2. Run the following command:
    pmx-group --add --group <Name> --description <GroupDescription>

    where Name is the name of the group and GroupDescription is additional descriptive text about the group. Be sure to enclose the Name and GroupDescription text strings in quotation marks if the strings contain spaces.

    The newly created group is stored in a subdirectory of the /opt/pmx6/etc/members-per-group directory. When you add a group, single-letter subdirectories are automatically created based on the first two letters of the group name. This is done to ensure that the maximum files per directory limit is not exceeded in cases where organizations have large numbers of groups.

  3. Run pmx-makemap --grouplist -g to create a CDB list that can be synchronized with the database.
  4. Run pmx-profile sync-to-db to synchronize the list data with the database.

What to do next

Note: PureMessage uses pmx-profile and pmx-makemap --grouplist -g to synchronize data with edge servers. If these jobs are enabled via the Local Services tab of the PureMessage Manager, it is not necessary to run these commands manually.

See the pmx-group man page (man pmx-group) for more information.