Adding and Setting up a Tenant Instance
  • 07 Nov 2022
  • 2 Minutes to read
  • Dark

Adding and Setting up a Tenant Instance

  • Dark


In a Multi-Tenancy, a Tenant Instance represents one independently running Instance within a Multi-Tenant environment. This Instance consists of an identical copy of the application running on the Control Instance with its unique database.

The following document discusses adding a Tenant Instance to a Multi-Tenant environment. 


  1. From Decisions Studio in the Control Instance, create an Account and Assign it to the Control Instance.
  2. Navigate to System >Hosting and click ADD INSTANCE. 
  3. From the Add Instance window, copy the Authentication Key into a text editor for later reference. 
  4. Under Admin Account, PICK an Account that was created in the Control Instance. 
  5. Under the DATA category, provide the desired name in the Instance Name field. 
  6. Configure the Instance Base URL. Then, click ADD INSTANCE. Users can also configure the Internal Instance Base URL for internal communication between the tenant instance and the Control instance. 
    Instance Base URL Considerations 
    For a Self Hosted installation, the default Instance URL is typically configured as http://localhost:[Port Number of the Instance].

    Alternately, the URL may be configured as http://[IP Address of the machine].

    For an IIS Installation, the Instance URL should match the BasePortalUrl of the Tenant machine.

  7. Verify that the newly added Instance is present in the Hosting Folder

  8. From the machine location of the Tenant Instance, download the v.8 DecisionsServerInstaller.exe.

  9.  Upon opening the Installer, select INSTALL. Then, from the Select Installation Type screen, select Multi-Tenancy Server (Tenant), then click Next

  10. Proceed through the installation process as usual until the Tenant Server Setup window is reached.

    Then, provide the previously defined Instance Name, reference the Control Instance URL and the copied Control Instance Authentication Key, and click Next

  11. Continue and finish the rest of the installation process, then launch the Decisions Portal for the Tenant Instance. 

  12. From the Login window, log in to the defined Admin Account for the Tenant Instance, and select the proper Instance from the SELECT INSTANCE options. 

  13. From the Decisions Studio of the Tenant, verify that the Hosting Folder can be Active status now states "True".

    Secured Key Error
    If the Tenant Instance is inaccessible after setup and the Instance's Logs display the following error:
    "Secured Key passed in is no more valid"
    Matching the Timezone/Time on each Tenant and the Control will fix the issue. 

Tenant Login Page Customization

After Decisions has been installed on the Tenant Instance, the Login Page may be customized with a user-defined Logo. This is done via the following process.

  1.  From the Control Instance, navigate to the Hosting Folder. Then, right-click the desired Tenant Instance and select Edit Instance.
  2. Navigate to the LOGIN PAGE section and enable Override Login Page Logo
  3. Via Drag File Here, or Choose a File, add the desired image. Then, click OK. 
  4. Navigate to the Tenant Instance and verify that the Login Page Logo has been updated. 

For more information regarding Multi-Tenancy, see Decisions Forum: Multi-Tenant.

Was this article helpful?