This is documentation for the current major version Apprenda 7.
Documentation for older versions are also available.

The "Apprenda" Tenant and Platform-Hosted Apprenda Components

Apprenda is comprised of various processes and web services that work together to facilitate all Platform functionality.  In order to take advantage of Apprenda's security and access restriction features, as well as its ability to imbue any hosted application with multi-tenancy, some of these Apprenda components are hosted on the Platform itself in the same way that any other guest application is hosted.

In order to deploy these components as Platform-hosted guest applications, at install time the Apprenda Platform creates the "Apprenda" Tenant account.  Through this Tenant account, all Apprenda components hosted as guest applications are deployed and managed.  As with all other Tenant accounts on the Platform, when the account is created, an initial User account (named Apprenda Administrator) is also created as the administrator of the "Apprenda" Tenant account.  This User account (username: admin@apprenda.com) inherits the same password as was created for the initial Platform Operator account at install time, so the initially-defined Platform Operator also inherits control of the Apprenda Tenant administrator account (the Apprenda Administrator User also inherits Platform Operator permissions at install time).

The Platform automatically handles all normal deployment and upkeep tasks for Apprenda components that are hosted under the "Apprenda" Tenant; no intervention from the Platform Operator is necessary for these components to function seamlessly as part of the Apprenda grid.  However, the Platform Operator may in certain situations find it useful to log in as the Apprenda Administrator User in order to specifically manage the way these components are deployed on the Platform.  For example, it might be desirable that specific components deploy only to specific Platform servers that have special security features in place.  In a case like this, the Platform Operator would be able to use the Apprenda Tenant account to access these components through the Developer Portal and configure specific Custom Property settings to work in concert with one or more Application Deployment Policies in order to target specific servers for specific component deployments.

Please Note: Since the Apprenda components listed here are treated by the Platform just the same as all other hosted guest applications, any Platform settings that affect guest applications will affect these components as well.  If an Apprenda component is unable to deploy or is forced to deploy to an invalid location because of Platform settings introduced or modified by the Platform Operator, Platform functionality may be compromised.  Therefore, Platform Operators are advised to be cautious in applying or updating any settings for Platform-hosted Apprenda components in the way described above; likewise, caution is advised when applying/updating any global settings (such as App Deployment Policies) which may affect these components.  Applying/updating these global or component-specific settings might not immediately affect the deployed components, but might adversely affect their redeployment in the case of a server reboot or an upgrade of the Apprenda Platform (or any other situation that would necessitate the redeployment of the component).

List of Apprenda Components Hosted as Guest Applications

Through the "Apprenda" Tenant account, the following Apprenda components are deployed and hosted as Platform guest applications:

Component Name

Name displayed in the Developer Portal for the Apprenda Tenant

Description

Describes the component and its role on Apprenda

Type

Indicates the application component type(s) deployed

Location

Indicates which server(s) the component must be running on

Account Portal
The user interface and web services that facilitate management of Tenant accounts.
UI, Apprenda Service

UI: Windows Web Servers

Apprenda Service: Windows Application Servers (at least one on each Cloud)

Apprenda Guest Application API Provider Hosts an internal API used by the Linux Container to configure Java Web Application components for deployment and retrieve information for the Java Guest Application API UI Windows Web Servers
Authentication Services The user interface and web services that provide authentication mechanisms such as login/logout and signup capabilities. UI, Apprenda Service

UI: Windows Web Servers

Apprenda Service: Windows Application Servers (at least one on each Cloud)

Cataloging Services Maintains an index of application components, as well as deployed workload metadata. Apprenda Service Windows Application Servers (at least one on each Cloud)
Conmmon UI Resources A collection of UI resources such as shared CSS, Javascript, and images used by the Apprenda portals. UI Windows Web Servers

Developer Portal

The user interface and web services that facilitate developer creation, publishing, monitoring, and management of guest applications. UI, Apprenda Services

UI: Windows Web Servers

Apprenda Services: Windows Application Servers (at least one on each Cloud)

Extensibility Services

Runs all Add-ons and Bootstrap Policies in a safely controlled environment to prevent any unexpected side effects. Apprenda Service Windows Application Servers (at least one on each Cloud)

Federation

Interfaces with Active Directory Federation Services (AD FS) to establish a trust relationship and assist with authentication. Apprenda Service Windows Application Servers
Maintenance Interface A user interface that is displayed in place of application that is being upgraded by the Platform. UI Windows Web Servers

Monitoring Service

Aggregates workload resource utilization data for persistence. Also manages dynamic and scheduled workload scaling, as well as min/max instance count enforcement. Apprenda Service Windows Application Servers (at least one on each Cloud)

Onboarding Service

Leveraged by the Developer Portal when onboarding Tenants to an application. Apprenda Service Windows Application Servers

Presentation Controlling Services

Provides IIS administrative management capabilities. Apprenda Service All Windows Web Servers

Scheduling Services

Provides scheduling services for time-based and delayed execution of web service calls. Apprenda Service Windows Application Servers (at least one on each Cloud)

Storage Controlling Services

Interfaces with SQL Server and Oracle to create, delete, and otherwise configure storage for your application's databases. Apprenda Service Windows Application Servers designated as Storage Controlling Services hosts (at least one on each Cloud)
Storefront Interface Publishes application subscription/feature matrices and allows tenant self-provisioning for multi-tenant applications. UI

Windows Web Servers

System Operations Center

The user interface that facilitates Platform management. UI Windows Web Servers

Please note that there are additional guest applications listed in the Apprenda Tenant's Developer Portal that do not appear in the above table; these applications (for example, the Apprenda Container) are also Apprenda components, but are treated slightly differently by the Platform, and can't be managed as regular Platform-hosted guest applications in the way that the above-listed components can be.  These other applications represent Apprenda Windows Service components which are described in more detail here.