Troubleshoot migration from functional accounts to shared accounts

8.4. Troubleshoot migration from functional accounts to shared accounts#

During the migration of functional accounts to shared accounts, a network failure or another unexpected error can leave a shared account half-configured. You might encounter one of the following states:

Functional account still exists

The functional account is still present, and the shared account is partially configured. Rerun the script with the same parameters as before to retry the migration.

Functional account no longer exists

The functional account no longer exists, so only the final migration step remains. The remaining step is to modify the email address of the shared account and remove the tmp_ prefix. To remove the prefix, use either the Management UI or the udm command.

Deployment — All: Nubus for UCS and Nubus for Kubernetes

This section applies to both deployments.

Use the Management UI on Nubus for Kubernetes or in cases where you don’t have access to the UDM command-line. Use the following steps:

  1. Sign in to the Management UI and navigate to the LDAP directory module.

  2. Select the container for the shared accounts. The default container is cn=shared_accounts,cn=open-xchange,<ldap_base>.

  3. Open the affected shared account.

  4. Change the email address and remove the tmp_ prefix.

  5. Click Save.

Verify that the shared account uses the expected email address and no longer has the tmp_ prefix.

Deployment — Nubus for UCS

This section applies to the Nubus for UCS deployment.

To remove the prefix with the udm command in Nubus for UCS, run the command shown in Listing 8.35. Define the following parameters:

SHARED_ACCOUNT:

The DN of the affected shared account, for example "cn=test,cn=shared_accounts,cn=open-xchange,$(ucr get ldap/base)"

EMAIL:

The email address of the shared account.

After you ran the command, verify that the shared account uses the expected email address and no longer has the tmp_ prefix.

Listing 8.35 Remove the tmp_ prefix from the email address of a shared account#
$ export SHARED_ACCOUNT="<DN of affected shared account>"
$ export EMAIL="<email address of the shared account>"
$ udm \
   oxmail/shared_account \
   modify \
   --dn "$SHARED_ACCOUNT" \
   --set mailPrimaryAddress="$EMAIL"