How to Change a Contact's Tenant when the Multi-Tenancy Option is in Setup State.
search cancel

How to Change a Contact's Tenant when the Multi-Tenancy Option is in Setup State.


Article ID: 50148


Updated On:


CA IT Asset Manager CA Software Asset Manager (CA SAM) ASSET PORTFOLIO MGMT- SERVER SUPPORT AUTOMATION- SERVER CA Service Desk Manager - Unified Self Service CA Service Desk Manager CA Service Management - Asset Portfolio Management CA Service Management - Service Desk Manager



When Service Desk Manager has the multi-tenancy option set to "setup" and the tenant for a contact is set, the tenant for that contact cannot be changed using the web interface. However, the tenant for the contact can be changed by following the steps in this technical document.


Follow these steps to change the contact's tenant:

  1. Copy the file, settenant.xml, from the $NX_ROOT\samples\multi_tenancy directory to the $NX_ROOT\site\cfg directory, or if the file already exists in $NX_ROOT\site\cfg, use it in the proceeding steps.

  2. Ensure that the file, settenant.xsd, exists in the $NX_ROOT\site\cfg directory. If it does not, copy it from the $NX_ROOT\samples\multi_tenancy directory to the $NX_ROOT\site\cfg directory.

  3. Edit the file, $NX_ROOT\site\cfg\settenant.xml.

  4. Add an object definition to the settenant.xml file that corresponds to the contact for which you want to change the tenant using the following format:

    <Object name="cnt">
    <TenantRule type="Name">name-tenant</TenantRule>

    In the above definition, "userid" is the logon ID of the contact, and "name-tenant" is the tenant name.

    Be sure to add the object definition before the line containing the statement: </Set Tenant>

  5. Change the tenant name in the object definition in the settenant.xml file to the new tenant name. Save the file.

    The shaded area in Figure 1 below is a sample object definition for changing the tenant of a contact named "analyst2test" with a User ID of "analyst2" from "tenant1" to "tenant2".

  6. From a command prompt, navigate to the $NX_ROOT\site\cfg directory and issue:

    pdm_settenant -f settenant.xml

    See figure 2 below for sample output.

  7. Log into the web interface and confirm the contact now belongs to the new tenant.

    Figure 1.

    <Please see attached file for image>

    Figure 1

    Figure 2.

    <Please see attached file for image>

    Figure 2

Note: $NX_ROOT represents the Service Desk Installation directory. On Windows, this directory defaults to "C:\Program Files\CA\Service Desk Manager".


Component: ARGIS


1558698701742000050148_sktwi1f5rjvs16odu.gif get_app
1558698699728000050148_sktwi1f5rjvs16odt.gif get_app