Searching the Help
To search for information in the Help, type a word or phrase in the Search box. When you enter a group of words, OR is inferred. You can use Boolean operators to refine your search.
Results returned are case insensitive. However, results ranking takes case into account and assigns higher scores to case matches. Therefore, a search for "cats" followed by a search for "Cats" would return the same number of Help topics, but the order in which the topics are listed would be different.

Search for | Example | Results |
---|---|---|
A single word | cat
|
Topics that contain the word "cat". You will also find its grammatical variations, such as "cats". |
A phrase. You can specify that the search results contain a specific phrase. |
"cat food" (quotation marks) |
Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase. |

Search for | Operator | Example |
---|---|---|
Two or more words in the same topic |
|
|
Either word in a topic |
|
|
Topics that do not contain a specific word or phrase |
|
|
Topics that contain one string and do not contain another | ^ (caret) |
cat ^ mouse
|
A combination of search types | ( ) parentheses |
|
How to create and edit a tenant

-
From the main menu, click Tenants.
-
Click
New.
-
Enter the name and type. See Tenant details below.
-
Click Save.

-
From the main menu, click Tenants.
-
Click the tenant in the ID column to display the selected tenant.
-
Click the tab you want to view or edit. See Tenant details below. The General tab is displayed by default.
-
Save the changes.

-
General tab
Field Description ID Tenant ID. Name Tenant name. URL The URL to access this tenant. Type Tenant type:
-
Production: This tenant is an official production environment. Only production licenses can be assigned to production tenants.
-
DEV: This tenant is used to make all configuration changes. Only trial licenses can be assigned to DEV tenants.
-
Internal: This tenant can be used for internal demo. Only evaluation licenses can be assigned to internal tenants.
-
Trial: This tenant is used for trial with limited duration and capacity. Only trial licenses can be assigned to Trial tenants.
For more information about licenses, see Licenses.
Environment Tenant environment:
- Prod
- Test
- Staging
- Poc
- RND
- Unknown
- DR
Account The account specified for this tenant. The users belong to this account can access this tenant. Public service Defines which users of the account can access this tenant.
-
If this switch is on, all users of the account can access the tenant.
-
If this switch is off, only specified users of the account can access the tenant. Go to User tab to specify the users.
Note After you change this setting, make sure to click Hard sync user on the toolbar.
Tenant admin Tenant admin. Only tenant with a tenant admin specified can be deployed. The tenant admin receives an email notification after the tenant is deployed successfully.
The tenant admin is assigned the Tenant Admin role in Service Management automatically.
Owner Tenant owner. Created by
The user who created the tenant.
Description The description that captures the details of the tenant. Creation time The time that the tenant was created.
Activate date The date that the tenant was activated. Last update on The last time that the tenant was updated. -
-
This tab displays the users who are granted access to this tenant. If Public service is off, you need to specify the users that can access this tenant here.
-
License tab
This tab displays the license assignments of this tenant. To add a license assignment to this tenant, click
Add, specify the license pool, mode, edition, access type, and date, click Filter to get remaining capacity, then you can assign the available capacity to this tenant.

A tenant can be deployed if:
-
A tenant admin is specified
-
A license is assigned
To deploy a tenant, click Deploy.

The way to change the tenant type might vary slightly, depending on the tenant status.
To change the tenant type before tenant deployment:
-
(Optional) If license assignment is added to this tenant, go to Licenses tab, and then click Revoke to revoke the license.
-
On General tab, select the type from the drop-down list. Click Save.
To change the tenant type after tenant deployment:
-
In Licenses tab, click Revoke to revoke the license.
-
Click Change tenant type on the toolbar.
- Select the type from the drop-down list, click Change.

Status |
Description |
---|---|
New |
The tenant status is New after the tenant is created. |
Active |
|
Inactive |
|
Pending for removal | The tenant status becomes Pending for removal automatically if the tenant deployment fails. |

You can clone a tenant within the same suite instance. When cloning a tenant, make sure there are no other tenant operations such as importing tenant, exporting tenant, or Dev2Prod in the suite instance.
To clone a tenant:
-
Prepare an active tenant as the target tenant.
-
Select a tenant in the ID column as the source tenant.
-
Click Clone tenant on the toolbar.
-
Select the target tenant, and then click Clone.
Note
- The status of target tenant needs to be Active.
- The source tenant and the target tenant must belong to the same account.
- After the tenant is cloned, all users of target tenant are replaced by users of source tenant.

You can move a tenant to other suite instances by exporting and importing the tenant. When exporting or importing a tenant, make sure there are no other tenant operations such as cloning tenant, importing/exporting tenant, or Dev2Prod in source and target suite instances.
To move a tenant:
-
Prepare a tenant as target tenant.
-
In source tenant details page, click Export tenant. The tenant data is exported to the NFS share ({nfs_global_volume}/tenant-export). The exported package name is data-<tenantid>-<YYYYMMDDhhmmss>.tar.gz.
-
Copy the exported package to the NFS share ({nfs_global_volume}/tenant-import) of target suite instance.
-
Create a new user belonging to the account that is assigned to target tenant, the Upn of this user must be identical to the tenant admin of source tenant, and specify this user as tenant admin of target tenant.
-
In target tenant details page, click Import tenant on the toolbar.
-
Select the data file, click Import.
Note If you want to assign license to imported users in Service Management, complete the following tasks before assigning license:
- Get the Authentication type of these users in Suite Administration on previous suite instance.
- Create the same users in Suite Administration on current suite instance using Manage Persons API, make sure the authentication type property is included in the JSON.