Posted May 10 by Edmund Clayton.
Updated Oct 30.

Advice on setting up tenants following a primary installation of the AppWorks Gateway

Last activity Oct 30 by Edmund Clayton.
502 views. 0 comments.

Chapter 10 – Deploying AppWorks Gateway for Multi-Tenancy

A multi-tenant AppWorks Gateway installation enables you to create multiple AppWorks Gateway instances on the same server, each with their own database and OTDS configuration details. Each tenant installation can have a separate adminstrator, with the administrator of the primary AppWorks Gateway having overall control.

To create a new tenant for a primary AppWorks Gateway installation:

  1. Install AppWorks Gateway on a server.

  2. From the Admin Menu, click Settings > General Settings.

  3. In the List of Tenants field, type one or more tenants. Tenant names can include the characters 'a' to 'z', and '0' to '9'. Upper case characters are not valid.

  4. Click Update Settings. A URL is created for each tenant name. For example, if you type “tenant001” in the **List of Tenants field, the URL http://host:port/awtenant/tenant001/ is created.

  5. To complete the installation, enter the URL for the tenant into a browser address bar. A configuration page appears with options to specify a database and an OTDS instance. This is the same page that you use to complete the configuration of any AppWorks Gateway installation.

  6. For Step 1: Database Configuration, specify a database, and click Configure Database Connection. The database for each tenant must be unique. It must not be the same as the database for the primary AppWorks Gateway installation.

  7. For Step 2: OTDS Configuration, choose Connect to existing OTDS service
    and enter the OTDS server details that you used for your primary AppWorks
    Gateway installation.

  8. For each tenant, provide details for the Gateway Admin Username/Password, and OTDS Administrative Account/Username. You can use the same administrator as your primary installation, or you can create different administrators for each tenant.

  9. For each tenant, provide a Resource Name and Gateway User Partition Name.

  10. Click Configure OTDS.

Top of page

Table of Contents

Your comment

To leave a comment, please sign in.