The Tenants page enables you to manage the tenants that are available in your POS installation. This page is activated when you enable the Tenant Manager role during setup.
The main tenants page lists the available tenants. From this page you can:
- Add a new tenant.
- Edit the tenant details.
- Reload a tenant – this can be helpful on the rare chance you have tenant problems, or need to apply changes.
- Disable a tenant that no longer should be active.
a) Create Tenant
To create a new tenant, click Add Tenant and provide the following information:
- Enter an internal ID for the tenant.
- The naming convention for this is:
- The Organization ID, if this tenant is cloud tenant.
- The Store ID, if this tenant is a store tenant.
- CORP if this tenant is the corporate server tenant.
- Tenants for staging, test and other purposes do not need to follow this convention.
- Enter the purpose of the tenant.
- Url Prefix
- This value indicates that incoming web requests to this URL will resolve to the new tenant.
- This is not used for cloud tenant deployments, but it may be helpful for store and corporate deployments.
- Host Name
- This value indicates that incoming web requests to this hostname will resolve to the new tenant.
- This value is used for cloud tenant deployments.
- It requires that a DNS entry for the hostname to be made to the IP address of the POS server.
- Select POS_Tenant.
- Once configured, you can use the tenant’s Setup Guide to assign the tenant’s role, enable features, and apply configuration.
- Database Type
- Select SQL Server.
- Table Prefix
- Leave blank.
- Connection String
- Set to the connection string of the database that will contain the tenant’s data.
- You will need to manually create this database using SQL Server tools if it doesn’t already exist.
For SQL Server, the connection string must be configured to support multiple active result sets. The connection string should include the following parameter: MultipleActiveResultSets=True.
Press Create to create the tenant in an unitialized state.
To continue configuration of the tenant, click Setup on the tenant within the tenant list. This will display another page to enter additional information that is required for the tenant setup.
b) Setup Tenant
Enter the following values to continue the setup:
- Enter a descriptive title for the tenant.
- This value will be used as the default title of web pages served by the site.
- For a corporate server install, you’ll typically enter your organization name.
- For a store server install, you’ll typically enter your store ID.
Default Time Zone
- This should be the default time zone from which your organization operates.
- When integrated with current version of the Fusion Register, the time zones for all POS tenants and installations within the organization must be the same.
Super User UserName
- Use Administrator.
- This is the username of the super user that has administrative access to all tenant features.
- Enter a secure password.
- Enter the email address, enter the email address of the administrator.
- For Fusion Support, this is typically firstname.lastname@example.org
When installing POS server tenants, Fusion Support should follow checklists to ensure that all steps are required and tracked (e.g. passwords in the password manager).
c) Continue Tenant Configuration
Once the tenant has been created, you can login to the tenant Admin console and continue configuration through the Setup Guide.