Default language.

Offboarding a tenant


You can offboard a tenant from the multi-tenant  setup for the following reasons:

  • A customer is unsubscribed from the environment
  • A tenant must be moved from one cluster to another

To offboard a tenant, you must first delete the tenant, then delete the tenant , and then clean up the  cache. Cleaning up the cache ensures that the resources are made available for other tenants and that there is no contention of resources.

Before you begin

  • Delete a realm from BMC Atrium Single Sign-On (SSO).
  • Disable multitenancy support from BMC Atrium Single Sign-On (SSO). 

To offboard a tenant

  1. Log on to the Mid Tier Configuration Tool.
  2. Click the Tenant Offboarding link.
    The Tenant Settings page opens.
  3. Select the tenant that you want to delete.
  4. Click Delete.
  5. Click the Next step button or the Tenant AR Server tab.
    tenant_offboarding_tenant_ARServer.jpeg
  6. On the AR Server Settings page, select the server that you want to delete.

    Tip

    Ensure that the tenant name and the tenant  name are similar so that you can easily identify which tenant was mapped to the . This procedure assumes that the administrator remembers which tenant is mapped to the tenant .

  7. Click Delete.
  8. Click the Next step button or the Cache Cleanup tab.
    tenant_offboarding_cache_cleanup.jpeg
    .
  9. On the AR Server Cache Cleanup page, in the Action column, click Cleanup Cache for the server whose cache you want to clean up.

    Because cache cleanup is a resource-intensive operation, perform it during off-peak hours. It can take hours to finish, especially when the  is serving multiple s.

  10. After the cache cleanup is completed, click Remove From List to remove the .

    The Remove From List button appears only when the cache cleanup status is Completed.

    If multiple s are in the cluster, you must perform cache cleanup on each .

    If you are removing the last server from the , you must flush the cache instead of clicking the Remove From List button.

    You cannot clean up the cache unless you delete the , and you cannot delete the  unless you delete the tenant that is mapped to the server.

The cleanup process might result in any one of the following states:

  •     Not started
  •     Starting
  •     Running
  •     Completed
  •     Failed

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*