Multitenancy

Understand how to manage multiple subtenants through a single master tenant.

Master Tenant

Master tenant is the core tenant from which you can manage configurations for all the linked subtenants.

There are two types of master tenants:

Master tenant with administrator capabilities

This type of master tenant allows you to link existing tenants as subtenants to your master tenant and manage the connectors packs and tenant plans associated with those subtenants.

Setting up a master tenant with administrator capabilities

To set up a master tenant with administrator capabilities, send us an email to support-wmio@softwareag.com from your registered email address requesting for the master tenant with administrator feature.

Once the master tenant is created, login to it by providing the username and password associated with the tenant. This takes you to your master tenant dashboard where you can see the following main menus:

Let’s now understand each of these main menus in detail.

Home

The Home menu lets you view the usage statistics associated with the subtenants.

When you click on the Home menu you see the following sections:

Production Environment Usage

This section shows the total number of transactions used on the production environments of the linked subtenants collectively, out of the total production environment transactions allocated to the subtenants.

Sandbox Environment Usage

This section shows the total number of transactions used on the sandbox environments of the linked subtenants collectively, out of the total sandbox environment transactions allocated to the subtenants.

Alerts Stream

This section shows the list of overage alerts for the subtenants associated with your master tenant.

Subtenants Information

This section shows the list of all subtenants linked to your master tenant and their execution activity details for the last 24 hours. You can optionally use the search box to retrieve the execution activity details of a specific subtenant.

Tenants

The Tenants menu lets you link, view, and manage subtenants of your master tenant.

Linking tenants

Click on the + icon or the Link Tenant button to link an existing tenant created under the master account on Software AG Cloud as a subtenant to your master tenant.

Next, enter the following details in the Link Tenant dialog box that appears:

Master Account Name: Enter the name of the Software AG Cloud master account.

Master Account Username: Enter the username associated with the Software AG Cloud master account.

Master Account Password: Enter the password of the Software AG Cloud master account.

Once you have entered these details, click Next.

In the next screen that appears, you will be prompted to select an account.

Account : Select the account created under the master account on the Software AG Cloud.

As soon as you select an account, a few more fields will be populated to the Link Tenant dialog box.

Tenant Name: Select the name of the environment (tenant) you want to link.

Tenant Plan: Select the plan you want to assign to the selected tenant. The transactions allocated to the selected plan will be the maximum number of transactions that can be consumed by this tenant.

Connector Packs: Select the connector pack(s) you want to assign to the tenant. Only the connectors that are present under the selected connector pack(s) will be available to the selected tenant.

Once this is done, click Add.

This will link the specified tenant as a subtenant to your master tenant.

Viewing linked tenants

All tenants linked to your master tenant are listed on the Tenants screen.

On each subtenant card, you will find the following details:

Managing linked tenants

You can update the plan and connector pack(s) assigned to a tenant by clicking the Edit icon. When you do so, the Update Tenant dialog box will appear where you can specify the required changes.

Tenant Name: You cannot update the Tenant Name field. It will show the name of the selected subtenant.

Tenant Plan: Select the tenant plan you want to assign to the subtenant.

Connector Pack: Select the connector pack(s) you want to assign to the subtenant.

Once this is done, click Update.

With this, your subtenant configurations will be updated.

Connector Packs

The Connector Packs menu lets you add and manage the connector packs of your master tenant. Each connector pack can consist of one or more connectors. Once a connector pack is created, it can be assigned to any subtenant as per the requirements.

There are two types of connector packs:

  1. System Connector Packs: These are the global connector packs that are provided by webMethods.io Embed by default and available to all master tenants. They cannot be edited or deleted. When you first click on the Connector Packs menu, you can see the list of all available system connector packs.
  2. Custom Connector Packs: These are the custom connector packs that are created by the administrators of a master tenant. They can be edited and deleted as per the requirements.

Adding connector packs

To add a new connector pack, click the Add New Pack button.

In the Add Connector pack dialog box that appears, enter the following details:

Connector Pack Name: Provide a name for the custom connector pack.

Select Connectors: Click on the drop-down button and select the required connectors you want to add to the pack. The selected connectors will be displayed under the Selected Connectors list. You can click on the associated delete button to remove any selected connector.

Once this is done, click Add to add the connector pack.

Managing connector packs

You can view and manage the connector packs of your master tenant by clicking the Connector Packs menu.

Connector Pack name: Name of the connector pack.

Connector Count: Number of connectors present inside the connector pack.

Type: Whether the connector pack is of type System or Custom.

Actions: Contains action controls to manage the connector pack.

Tenant Plans

The Tenant Plans menu lets you view, create, and manage the tenant plans and their allocated transactions. These tenant plans can then be assigned to subtenant(s) to specify the maximum number of transactions they can consume.

Adding tenant plans

To create a new tenant plan, provide the following details:

Plan Name: Provide a name for the tenant plan.

Transaction Allocated Per Month: Provide the total count of transactions that should be assigned to this plan every month.

Once this is done, click Add Plan. This adds the specified tenant plan in your master tenant.

Managing tenant plans

You can view and modify the details of your tenant plans. To do so, click the Tenant Plans menu.

Master tenant with administrator and Embed capabilities

This type of master tenant allows you to link existing tenants as subtenants to your master tenant and manage the connectors packs and tenant plans associated with those subtenants. Apart from this it also contains all the features available under webMethods.io Embed Admin Portal.

Setting up a master tenant with administrator and Embed capabilities

To set up a master tenant with administrator and Embed capabilities, send us an email to support-wmio@softwareag.com from your registered email address requesting for the master tenant with administrator and Embed feature.

Once the master tenant is created, you can login to it by providing the username and password associated with the tenant. This will take you to the webMethods.io Embed dashboard.

To navigate to the master tenant, click on the profile icon and then select Manage Tenants option.

This takes you to your master tenant dashboard.

Let’s now understand each of these main menus in detail.

Home

Please refer to Home topic under the Master tenant with administrator capabilities section for detailed information on this menu.

Tenants

Please refer to Linking tenants and Viewing linked tenants topics for detailed information.

Managing linked tenants

You can manage the plan, connector pack(s), and solutions assigned to a specific subtenant by clicking the vertical ellipsis icon on the subtenant card.

Editing tenant

Select the Edit Tenant option to change the plan and connector pack(s) assigned to the selected tenant.

Managing Solutions

Select the Manage Solutions option to add and manage solutions for the selected subtenant.

The Sandbox Solutions tab shows the list of solutions added by the master tenant to the sandbox environment of the selected subtenant. It shows following details for each solution:

Similarly, the Production Solutions tab shows the list of solutions deployed to the production environment of the selected subtenant along with the above-mentioned details.

Adding Solutions

You can add solutions that are deployed and published to the production environment of the master tenant to any of the subtenants.

To add a solution to a subtenant, click on either Sandbox Solutions or Production Solutions tab based on the environment where you want to add solution(s) and then click the Add Solutions button.

In the Add Solution to Subtenant dialog box that appears, select the solution(s) you want to add to the selected subtenant.

Once this is done, click Add Solutions.

This adds the solution to the specified environment of the selected subtenant.

Connector Packs

Please refer to Connector Packs topic under the Master tenant with administrator capabilities section for detailed information on this menu.

Tenant Plans

Please refer to Tenant Plans topic under the Master tenant with administrator capabilities section for detailed information on this menu.

Subtenants

The working of the subtenants remains the same as any of the ordinary tenants enabled with webMethods.io Embed feature, except for the connector and transaction limitations.

Connector limitation

Only those connectors that are present under the connector pack(s) assigned by the master tenant administrator will be available to the subtenant. This means that the subtenant administrator can create solutions using only those connectors that are present in the assigned connector pack.

Transaction limitation

The tenant plan assigned to a subtenant by a master tenant will determine the maximum total number of transactions available for consumption for that subtenant.