Assigning virtual roots to users

Users must have a valid virtual root assigned to access Global Mailbox. Global Mailbox administrators can assign a virtual root to a user so that they can access Global Mailbox.

Before you begin

Create the mailbox that you want to assign as a virtual root for a user
Important: The UserPurgeJob runs weekly at 2:00 AM (local time of the data center where the initial Global Mailbox node is installed and on the day of the week it is installed). Any new Sterling B2B Integrator user that is granted a virtual root and permission to Global Mailbox must exist in all data centers before the UserPurgeJob runs. If a user is not created or imported in other data centers before the UserPurgeJob runs, the virtual root and permissions for that user are removed by the purge process.

About this task

The users from each registered application are listed in the User Explorer page. The virtual root that is assigned to each user is displayed. If a user is not assigned to a virtual root, the message Undefined Virtual Root is displayed. If the virtual root is an invalid path, the user virtual root is listed in red with an X icon.

Important: Users are not assigned a default virtual root. A Global Mailbox administrator must assign a virtual root to each Global Mailbox user.

Procedure

To assign a virtual root to a user, complete the following steps:

  1. From the User Explorer page, select an application.
  2. Click the Find a User tab.
  3. Type the name of the user in the User field.
  4. Select the user name from the Matching Users list.
  5. Click the virtual root icon.
    Tip: There are three possible virtual root icons. Each icon indicates the state of the virtual root for the user:
    Valid virtual root
    All mailboxes exist that are specified for the virtual root path. The user can access the mailboxes within the virtual root.
    Undefined virtual root
    A virtual root is not assigned for the user.
    Invalid virtual root
    One or more mailboxes do not exist that are specified for the virtual root path. The user cannot access the mailboxes within the virtual root.
  6. You can either set a valid virtual root from the mailbox navigation pane, or type in the Virtual Root Path field to specify the valid directory path that you want to assign for the user.
  7. Ensure that Automatically manage permissions is selected (default).

Results

When a virtual root is assigned and Automatically manage permissions is selected, the VIEW_MAILBOX and EXECUTE permissions are assigned to that user (if the application specifies EXECUTE as a custom permission). If the user was assigned a virtual root previously, any existing permissions are revoked and only the new virtual root is valid.

If you have upgraded from an earlier version to 6.0 or later, and if you have moved the virtual root to a different mailbox, and try to access the virtual root for the user, a system error occurs and the tree hierarchy is not displayed. In such a case, log out of Global Mailbox, and log in again. The virtual root for the user is seen correctly and the issue is no longer seen.