Skip to content

Latest commit

 

History

History
91 lines (58 loc) · 7.89 KB

multitenant-setup-guide.md

File metadata and controls

91 lines (58 loc) · 7.89 KB
Raw
title description ms.custom ms.date ms.reviewer ms.service ms.topic
Manage Application and Tenant Databases in a Multitenant Deployment
Learn about the tasks for managing application and tenant databases for a multitenant deployment
bap-template
evergreen
04/14/2024
jswymer
dynamics-365-op
conceptual

Multitenant Deployment Setup Guide

This article provides an introduction to the most common tasks you'll do to set up and maintain a [!INCLUDEserver] multitenant deployment.

Multitenant architecture overview.

Create an application database

The application database includes tables that store information about the application and system, required by all tenants. There are two ways to create an application database:

Configure the [!INCLUDEserver] for multitenancy

To set up the [!INCLUDEserver] instance for multitenancy, make the following changes to the server instance configuration:

  1. Enable the Multitenant setting.
  2. Set the server instance to connect to the application database by changing these settings: DatabaseServer, DatabaseInstance, and DatabaseName.

For more information, see Configuring Business Central Server and Connecting a Business Central Server Instance to a Database.

Tip

Instead of doing the two previous steps, you could use the Mount-NAVApplication cmdlet. Running this cmdlet will enable the Multitenant and set up the data base connection.

Configure the Web client to accept host names for tenants (optional)

If you want to use host names to access [!INCLUDEnav_web] for your tenants, follow this instructions at Configure Business Central Web Server to Accept Host Names for Tenants.

Publish the symbols and extensions

Before mounting tenants, publish the system symbols and extensions that make up your application. Publish the system application and base application extensions as a minimum. Then, as needed, publish any Microsoft and third-party extensions tenants may use.

For more information, see Publishing and Installing an Extension.

Create, mount, and synchronize tenants

The tenant database includes tables for storing customer data that's accessible from the application. The tenant database is often referred to as just the tenant. The basics tasks for getting a new tenant up and running, and keeping it up to date, are as follows:

  1. Create an empty database with the wanted collation in SQL Server.

  2. Mount the database as a tenant of the [!INCLUDEserver] instance.

    This operation connects the tenant database to the [!INCLUDEserver] so it can process data requests from the application. See Mount or Dismount a Tenant.

  3. Synchronize the tenant database with the application.

    The application database stores information that defines the basic structure or schema required for all tenant databases. This operation updates the tenant database schema with the definitions in application database. See Synchronizing the Tenant.

  4. Synchronize and install extensions.

    The last step is to install all the extensions that you want to use on the tenant. Many extensions define table objects and table extension objects for storing data. So, before you can install an extension, you have to synchronize it with the tenant to update the tenant database's schema. See Publishing and Installing an Extension.

Tip

For more detailed steps, see Create a Tenant Database.

See Also

Multitenant Deployment Overview Architecture
Multitenant Deployment Architecture