So you have a shiny new Rainmaker environment setup and possibly already have at least one tenant added after running the App Studioconfiguration wizard.  Hopefully for you it’s time to add more tenants and understand how to administer them.


Each tenant you add will need to have its own OU in the Active Directory domain.  I like to keep things clean by creating a Tenants OU under the root App Orchestration OU and adding all tenants under this new OU.  It is good practice to use the name of the tenant as the name of the OU.  You will see later when creating a new tenant this will save you some trouble of having to remember what you named the OU.

When adding subscriptions for tenants you will need to have users in this OU.  You will learn more about this in the Managing Subscriptions blog, but now is a good time to add users to the tenant OU since we are in the Active Directory Users and Computers window.  Simply add the users to the tenant OU.  You can add users individually or create groups of users.

Here you can see my OU structure and the user group in the tenant.

OU structure
OU Structure

Adding a Tenant

Now that the OU structure is setup we can add a tenant.  Clicking on Tenants from the top navigation bar of the App Studio site will bring you to the tenant administration page.  This page will show you all the tenants that have been added.

To add a new tenant click the “Import Tenant” button in the upper right corner.  You should be presented with a pop up wizard.  In the first step enter the new tenant’s name.  You also have the option to enter a description and tags for the Tenant.  These are not mandatory and can
be left blank.  Once you have entered the name and selected another field you will see the Tenant root OU become auto populated with a suggested OU.  If you followed the procedure I suggested in the Prerequisites section, this OU should match what you created.  If the OU does
not match your OU structure, update it so it does.

Step two allows you to define the isolation level of the Web Interface the tenant would like to have.

Shared Site

The site is accessible by other tenants who also have Share Site isolation within the App Orchestration environment.  The same URL will be shared by all tenants with Shared Site isolation.

Private Site

A separate site on the Web Interface server will be created just for this tenant.  The tenant will be the only tenant to have access to this site and URL.

Private Server

This provides the most isolated mode.  The option will require a new Web Interface server to be added to the tenant’s Infrastructure OU.  The new server will only be accessed by the tenant.  When this option is selected, you will be prompted to enter an import OU.  It defaults to an OU named “Infrastructure” under the tenant root OU.  This OU is where the App Orchestration Engine will look for new Web Interface machines.  Neither the OU nor the server needs to exist at the time of creation.  This will simply tell App Orchestration to monitor this OU for new Web Interface servers.  Once you have completed adding the new tenant you will need to provision a new Web Interface site (App Orchestration: Provisioning Machines Part 1).

Once you have added the tenant you can view its details by clicking on the name in the tenants list.  The tenant’s detail page will show you the OU it resides, its Isolation mode, and the sites that are available to it.  The sites are where the tenant’s users will point their Citrix Receivers
to access apps.

The details page also contains a tab bar at the bottom.  The first tab will show you the subscriptions available to the tenant.  You can select
a subscription to view more details about it. The second tab is for helpdesk administrators which is a future feature so you can disregard it for now.  The final tab will display any workflows that are assigned to the tenant.

Add subscription

Now that you have the tenant setup the next step will be to add some subscriptions to that Tenant.  Check back soon to see a blog on this very subject.

Edit a Tenant

Once you have added a tenant you can edit it at any time.   From the main Tenant page click on the tenant you would like to edit.  Once the detail page for the tenant you selected has loaded click the Edit button in the upper right corner.

You can edit the Description, Tags, and change the Isolation level of the Tenant’s Web Interface site.  Once you have made the desired changes, click Save Tenant.

Delete a Tenant

If you would like to remove a tenant select tenant from the list on the main Tenants page.  On the tenant’s details page select the Delete button in the upper right corner.  A confirmation window will be presented.  Once you select Delete Tenant workflows designated to deleting tenants will begin.  Once they have completed the tenant will be removed.

Provisioning machines Part 1 & Part 2
• Managing Tenants (this blog)
Managing Advertisements
• Managing Subscriptions (coming soon)
• Patching Workload Machines (coming soon)
Understanding Workflows Part 1, Part 2, Part 3
• Troubleshooting (coming soon)
• Integration with CloudPortal Services Manager (coming soon)