How to enable tenant mode [v11]

Tenant mode is best suited for installations that require support for multiple customers using a single DashboardFox installation and database. This guide is designed for the DashboardFox server administrator, who should be familiar with server administration, Internet Information Services, and operating system best practices.

In most instances, you won't want your customers accessing DashboardFox as an agent or builder to see security groups, folders, or reports belonging to other customers. Similarly, they should not use the default "All users" group or see contacts of other customers while scheduling reports.

Tenant mode resolves these concerns by:

• Filtering the security group list to only show groups that users belong to.
• Removing the "All Users" group from these lists.
• Limiting the contact list to only those contacts that belong to user's groups when scheduling reports.

Step 1 - Enable Tenant Mode

1. Launch Notepad as an administrator.
2. Open the file at the following location: C:\Program Files (x86)\dashboardfox\Config\appSettings.config.

<setting>
      <key>tenant_mode</key>
      <value>true</value>
      <encrypt>2</encrypt>
</setting

Step 2 - Restart the DashboardFox IIS Application Pool

1. Open the Internet Information Services (IIS Manager).
2. Expand the Server name on the left and highlight Application Pools.
3. Highlight dashboardfoxAppPool, then click the Stop link on the left. Wait a few seconds, then click Start.

Congratulations! You have now successfully enabled the Tenant Mode.