Domains

Domains provide a logical partitioning of a hosting organization's environment that achieves increased flexibility and granularity of control in multitenant environments. By default, the installer creates a single domain named "default."

Administrators use different domains within the same SAP Mobile Platform installation. Domains enable the management of application metadata within a partition, including server connections, packages, role mappings, domain logs, and security, so that changes are visible only in the specific domain.

Considerations when implementing domains in a multitenant environment include:

Create and manage domains using SAP Control Center from the SAP Mobile Platform administration perspective of SAP Control Center.
You can support multiple customers inside the same SAP Mobile Platform cluster.
You can configure security specifically for individual domains by creating one or more security configurations in the cluster, and then assigning those security configurations to a domain. You can then map the security configurations to one or more packages. A user accessing the package from a device application is authenticated and authorized by the security provider associated with the package.
Customers may require their own administrative view on their portion of the SAP Mobile Platform-enabled mobility system. By granting domain administration access to your customers, you can allow customers to customize their deployed applications packages and perform self-administration tasks as needed.

The "default" domain

The "default" domain is a special domain where critical runtime configuration artifacts exist. These artifacts include:

An "admin" security configuration – this security configuration is mapped to the "default" domain and is used to authenticate and authorize administrative users. For this reason, administrators are not allowed to unassign the "admin" security configuration from the "default" domain.
Cache database (CDB) data source connections – for the "default" CDB data source, users can configure the Pool Size property in the "default" domain according to their requirements. This setting allows the maximum number of open connections to the SQL Anywhere database server hosting the CDB.
Monitor database data source connections – the customer can modify the existing monitoring data source properties according to their configuration requirements, or create a new monitoring datasource in the "default" domain.
Domain log database data source connections – the customer can modify the existing domain log data source properties according to their configuration requirement, or create a new domain log data source in the "default" domain. By default, the name of domain log data source is "domainlogdb".

Since these critical runtime-related artifacts are located in the "default" domain, administrators are not allowed to delete this domain. SAP recommends creating new domains to facilitate tenants according to their application requirements.

Creating and Enabling a New Domain
Create and configure multiple domains within a single SAP Mobile Platform installation. A domain must be enabled for application users to access the packages deployed in the domain. Enabling a domain also triggers synchronization of the domain changes to the secondary nodes in the cluster. Application users who attempt to access a disabled domain receive an error message.
Deleting a Domain
Remove a domain and its contents from the cluster when you no longer require the partition.
Registering a Domain Administrator User
A platform administrator can add domain administrators, so these users can administer domains to which they are assigned. This process registers an administrator with the cluster, so the user can be assigned as an administrator for a domain.
Assigning Domain Administrators to a Domain
Assign domain administration privileges to a domain administrator. You must be a platform administrator to assign and unassign domain administrators.
Viewing Applications for a Domain
View applications registered for a specific domain.
Viewing Application Connections for a Domain
View application connection information for a specific domain. Optionally select the relevant columns of information to display.
Scheduling Accumulated Data Cleanup for Domains
Periodically clean up accumulated data maintenance items in cache that are no longer needed, by creating a data purge schedule. Set the schedule to perform the clean up processes when system usage is low.
Domain Logs
The domain log enables an administrator to monitor application activities throughout the system. Detailed views of application activities are available by subsystem. The administrator can review activities in a specific subsystem log view, view correlated data in multiple subsystems, or view a unified log across all subsystems. The administrator must enable logging, and then use log filters to view data of interest.
Client Logs
Client logs capture data about client application operations for all devices that are subscribed to a package. You can use the data to track errors and identify performance issues.
Connections
Connections allow SAP Mobile Server to communicate with data sources. To facilitate the connection process, define a set of properties for each data source. Establish connections and connection pools for each domain.
Configuring Domain Security
Configure security for an individual domain to meet the customer's security requirements.

Parent topic: Administer