Adding and Setting up a Tenant Instance
  • 17 May 2022
  • 1 Minute 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 that is running on the Control Instance with its own unique database.

The following document discusses how to add 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. then, from the Global Action Bar, 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 URL. Then, click ADD INSTANCE. 
    Instance 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 and 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, and reference the Control Instance URL as well as 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, login 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 accessed and that the Tenant's 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?