Product Documentation

Configure Multi-Tenant StorageZones

A Multi-Tenant StorageZone is a ShareFile StorageZones Controller feature that enables Citrix Service Providers (CSPs) to create and manage a single StorageZone that is shared by all tenants.

If you are a CSP with a partner account provisioned by ShareFile, you can host one multi-tenant standard StorageZone on your domain that supports an unlimited number of tenants. Using a multi-tenant zone enables you to:

  • Provide each tenant with a unique ShareFile account and leverage all the great ShareFile features, such as custom branding, file retention preferences, and security settings.
  • Maintain a single storage repository for all of your tenants.
  • Onboard new customers faster and reduce the cost and management complexity of creating a separate StorageZone for each customer account.

1. Create a partner account.

You must have a partner account before you can register a Multi-Tenant StorageZone.

To create a partner account, you must register with the CSP program and order a stocking SKU with your preferred distributor that entitles you to offer ShareFile as a service. To apply to the CSP program, go to https://www.citrix.com/partner-programs/service-provider.html.

If you are already registered as a CSP and have ordered the appropriate ShareFile for CSPs stocking SKU a partner account has already been created for you. If you are unable to locate this new partner account, please contact ShareFile Account Services at acctsvcs@sharefile.com.

As you begin to provision customer accounts under your CSP ShareFile offering, we recommend creating a generic service account admin user on your partner account. In this way, the admin user can be the official partner admin of all of your customer accounts. Ensure that this service account admin user has the Manage Tenants permission turned on. With that, we encourage partners to create this partner admin now before filling out the CSP customer account request form (in step 4).

2. Install and set up a Multi-Tenant StorageZone.

a. Create a new Multi-Tenant StorageZone and associate it with your partner account. For details, see Install StorageZones Controller and create a StorageZone.

b. Install the StorageZone Controller in Multi-Tenant mode. Be sure to run the following specified command prompt in the Install article mentioned in the preceding step.

msiexec /i StorageCenter_5.0.1.msi MULTITENANT=1

Note:

In the preceding command, you may need to update the version number (5.0.1 in the example) to match the number of the msi you are trying to install.

3. Configure the new StorageZone and associate it with your partner account.

For details, see step 10 in Install StorageZones Controller and create a StorageZone.

Log into your partner account where you want to register the new zone.

Important

This account must have the following ShareFile permissions: Manage Tenants and Create and Manage Zones.

You can now log in to your partner account and see the new Multi-Tenant StorageZone. Click the Admin settings > StorageZones > Partner-managed tab.

4. Request Tenant Accounts for the Multi-Tenant zone.

To request tenant accounts, fill out the CSP Customer Account Request form.

When you request a tenant account, you must also specify a Partner Admin user. This partner admin must be an admin user on your partner account with the Manage Tenants permission enabled. When a tenant account is created, this partner admin user will be automatically provisioned on the account as an Admin user and will be to able to sign in and manage the tenant account. Since there cannot be two users on an account with the same email address, the partner admin email specified on the form cannot be the same as the customer admin on the same form.

To ensure the quickest turnaround, ensure that you provide the correct Org ID and the Multi-Tenant zone name that you want to use as the StorageZone for the tenant account.

You will receive an email after Citrix provisions the requested accounts. The email will include details on the tenant subdomain and an activation link to set up access. ShareFile will send you and your customers’ administrative users separate emails.

Your customers can then begin using ShareFile. Any new users provisioned to a tenant’s account will use the Multi-Tenant zone you specified as the default location for the user’s files.

Previewing Office files and PDFs with an Office Online Server:

This functionality is supported with supported Office Online Server environments. Click here for setup information.

Connector Sharing:

This functionality is supported with Multi-Tenant Zones.

Manage Tenants

Within the partner account, there is a Tenant Management dashboard located under Admin Settings > Advanced Preferences. This centralized dashboard allows you to check the status of all tenants linked to your partner account. The dashboard includes the license consumption, default StorageZone, storage consumption, and account status (Paid or Trial) for each tenant.

Note:

The dashboard is only available to users in your partner account that have the Manage Tenants user permission enabled.

Multi-Tenant Limitations

  • A Multi-Tenant StorageZone cannot be a Restricted StorageZone.
  • The ShareFile Information Rights Management feature (IRM) is not supported for Multi-Tenant StorageZones.

Troubleshooting

Failed to Create Zone: Forbidden

Upon StorageZone registration, if you receive the following error: “Failed to create zone: forbidden”, check that your user permissions include the “Manage Tenants” permission.

Configure Multi-Tenant StorageZones