Onboard Tenants

This article contains the following topics:
casm1401
HID_Onboarding_Tenant
This article contains the following topics:
After the Unified Self-Service installation, create tenants by onboarding them. Tenants are your customers or partners who share Unified Self-Service environment and can use the Unified Self-Service capabilities.
Create a Tenant
Create a unique tenant in Unified Self-Service so that the tenant can access the Unified Self-Service capabilities.
Follow these steps:
  1. Log in to the following URL as the administrator:
    http://Web Host:Tomcat Port/web/guest/onboarding
    On Windows you can also select Start, Program, All Programs, CA, Unified Self-Service, Onboarding to create a tenant.
  2. Provide the following details:
    • Company Name
      Specifies the company name of the tenant that you want to onboard. Depending on your input for this field, Web ID, Mail Domain, and Company Host fields are pre-populated. You can modify these pre-populated fields according to your organization requirements.
      Example:
      Company Inc
    • Web ID
      Specifies the web domain of the tenant. This ID is a user-generated ID for the instance. A web ID must be unique.
      Example:
      company.com
    • Mail Domain
      Specifies the mail domain of the tenant that you are boarding. Unified Self-Service uses this information to send email notifications from the portal. This mail domain is a domain part of the email address. If your email is [email protected], then company.com is the mail domain.
      Example:
      company.com
    • Company Host
      Specifies a unique host name for the tenant. There can be multiple examples within the same domain. For example, Finance.company.com, HR.company.com. Here, Finance or HR are tenant host names.
      Example:
      test.company.com
      The Web ID, Mail Domain, and Company Host must not contain special characters.
  3. Click
    Next
    .
  4. Provide the login credentials of the tenant administrator.
    • Admin ID
      Specifies the user name of the tenant administrator.
    • Password
      Specifies the password for the tenant administrator.
    • Confirm Password
      Enter the password again.
  5. Click
    Next
    .
    The OnBoarding summary page is displayed.
  6. Click
    Start Onboarding
    .
    The OnBoarding page is displayed.
    Add an entry in the DNS server with the Company Host of the new tenant pointing to the Unified Self-Service server. For the testing purpose, you can add an entry in the C:\Windows\System32\drivers\etc\hosts on the client machine for the onboarded tenant.
    Format:
     <
    Unified_Self_Service_Server_IP_Address
    > <
    Company_Host
    >
    Example: 
    10.131.87.34 test.company.com
  7. Click
    Go to Company Portal
    .
    The Company portal opens. Share this portal detail with the tenant. After you create a tenant, the onboarding process creates a set of default users with different roles.
  8. Log in to the Unified Self-Service tenant control panel as a tenant administrator.
    Example:
    http://<
    Company_Host_Name>
    :8686/group/control_panel
  9. Navigate to Control Panel, Users and Organizations.
    The default users are listed. The default users are created with the password aquila.
Disable Onboarded Tenant
An administrator can disable an onboarded tenant from the Unified Self-Service control panel. This action cannot be performed by the tenant administrator from the Unified Self-Service tenant control panel.
Note:
A default tenant cannot be disabled.
Follow these steps:
  1. Log in to the Unified Self-Service control panel as the administrator.
    Example:
    http://<
    Unified_Self_Service_Server_Name>
    :8686/group/control_panel
  2. Select Server, Portal Instances, and click on the Web ID of the onboarded tenant.
    The onboarded tenant details are displayed.
  3. Clear the
    Active
    check box and click
    Save
    .
    The tenant is disabled.