The following page is a working document to explain the architecture of the Maya code contribution. The intention is to use this as a starting point for discussions including as a guide for the conference call scheduled on April 5th.
Architecture View 1
Architecture View 2
- Maya should be able to be initially installed either using one of the native installers to be made available or via a web-based installer technology. Once installed, Maya will be configured with appropriate directory structures given the target system.
- On Windows XP, Maya's executable and cache files will be installed in the program file path either defaulting to C:\Program Files\Maya or in a directory configured by a user.
- On Unix, Maya's executable will be installed in /usr/bin/maya with the temporary working files including the cache stured on /var/cache/maya.
- On all systems, the user-specific configuration directories will be created under the user's home directory.
- On Windows Vista, Maya will need to be updated to use temporary cache files in a generally writeable to allow execution with UAC.
Extension Points in Maya
The following areas are places for extensibility planned or in place in Maya. Where appropriate an extension point has been flagged as either planned (planned) or part of the Cisco contribution (existing). The expectation is that through discussions with the Eclipse community, we further refine additional areas of extensibility needed to support richer offerings on top of the Maya platform.
The majority of the extensibility in Maya is focused on the server as the server's role is to perform the majority of the rule processing and dependency validation as needed on behalf of the client. Maya has been architected to keep client-side complexity to a minimum allowing for reliable updates to flows without having potential service-impacting complications on the client.
- Software Filtering and Visibility Extension Point (planned)
- Extensibility to restrict which software is available to a particular user. Potential usages include:
- Filter software based on authenticated user.
- Filter software based on client operating system or resources (ex. memory).
- Filter software based on associated user groups and memberships.
- Filter software based on licensing restrictions.
- Filter software based on stability of code (release, stable, integration, nightly).
- Authentication System Extension Point (exists)
- Extensibility to hook Maya into external authentication systems. Potential usages include:
- Authenticate user based on enterprise or organizational user registry.
- Authenticate user into a single-signon session for cross-server credentials.
- Group Membership Extension Point (exists)
- Extensibility to hook Maya into existing group membership systems. Potential usages include:
- Provide access to software or profiles based on group membership.
- Provide default or system level contraints based on group membership.
- Statistics Tracking Extension Point (planned)
- Extensibility to track usage statistics for Maya-based provisioning. Potential usages include:
- Track usage of particular software components in an organization.
- Track trending of components typically used together.
- Track frequency of use of particular engineers (if privacy restrictions allow).
- Profile Instantiation Post Processing Extension Point (planned)
- Extensibility to augment the response to the client when preparing to launch a profile. The extension point will be tied in after the standard software provisioning instructions have been added. Potential usages include:
- Augment instruction set to client to install additional software outside of Maya's direct scope.
- Augment instruction set to configure other environment settings including workspace configuration.
- Data Model Extension Point (exists)
- Extensibility to augment the attributes returned on existing objects as well as to register additional objects to be exposed via Maya's data model services. Potential usages include:
- Augment data objects to use additional attributes as part of provisioning including exposing to client for administration.
- Augment object schema to allow storage of additional data entities to be distributed by Maya but not directly supported.
- Web Service Actions Extension Point (exists)
- Builds on the Equinox HTTP server extension points to allow easier abstraction of web services in an efficient fashioned to be leveraged as part of Maya's provisioning workflow. The Maya Launcher component expects to see web services following a simple convention exposed by this extension model. Potential usages include:
- Exposure of custom backing services for particular advanced services to be exposed to the client.
- Exposure of additional functions for administrating an extended provisioning system built on top of Maya.
- Launcher Flow Configurability (exists)
- Allows XML configuration of the workflow presented to the Maya Launcher including customizing the wizard of questions that allows a profile to be dynamically built by the user. Potential usages include:
- Configuring the list of questions to be tailored to a particular user group for Maya.
- Configuring the software to be associated with given wizard responses.
- Download Mirror Overrides (partial)
- Allows the download mirrors to be used for given update sites to be overridden. Potential usages include:
- Override the download mirrors to pick up enterprise-internal mirrors in place of public mirrors for optimal download speeds.
- Override the mirrors list to remove known-problematic download mirrors (probably not ideal).
The following extensibilty is provided client-side primarily to support extensions enabled by the server. The majority of Maya's extensibility is server-side as it is more easily managed and applied across all users of the system.
- Launcher Page Extension Point (exists)
- Extensibility to register additional pages to be used in the launcher flow as defined on the server. Potential usages include:
- Provide custom pages for license agreements to be presented to the user.
- Provide custom pages for advanced flows for defining or extending profiles.
- Instruction Type Extension Point (planned)
- Extensibility to register additional instruction types to be able to be processed by the launcher when instantiating a profile. Potential usages include:
- Provide hooks for installation of non-Eclipse software artifacts.
- Provide hooks to perform custom system configuration such as Windows registry settings.
- Provide hooks to perform additional advanced validation before installing the profile.
Plug-ins to be Contributed
The following plugins are going to be contributed as part of the Cisco contribution to the Maya project. The plugins are listed in alphabetical order.
- org.eclipse.maya.admin.ui -- Provides administative perspective for Maya supporting creation and update of profiles.
- org.eclipse.maya.launcher.application -- Provides the Eclipse application constructs for the Launcher.
- org.eclipse.maya.launcher.launchlets -- Provides the base framework for the Launcher.
- org.eclipse.maya.launcher.launchlets.ui --- Provides standard pages for use by the Launcher flow.
- org.eclipse.maya.server.application -- Provides the Eclipse application constructs for the standalone OSGi HTTP server.
- org.eclipse.maya.server.servlets -- Provides abstract services shared across all Maya servlets.
- org.eclipse.maya.server.servlets.launcher -- Provides the web services used to support the Launcher client.
- org.eclipse.maya.server.servlets.model -- Provides the web services used to expose data models to the client user interfaces.
- org.eclipse.maya.services.client -- Provides base services client-side for connecting to the Maya web services.
- org.eclipse.maya.services.client.model -- Provides base services for accessing Maya-exposed data models.
- org.eclipse.maya.services.download -- Provides client-side services for downloading software including automatic mirror detection.
- org.eclipse.maya.services.execution -- Provides server-side services for converting profiles to execution instructions including dependency resolution.
- org.eclipse.maya.services.profiles -- Provides server-side data model objects for the Profile data schema.
- org.eclipse.maya.services.sitesync -- Provides the update site sync service to scan update sites for software to potentially expose in Maya.
- org.eclipse.maya.services.statistics -- Provides the statistics collection hooks for tracking software usage.
- org.eclipse.maya.services.type -- Provides common enums and constants to be shared between the client and the server.
- org.eclipse.maya.services.ui -- Provides base services shared across various Maya user interfaces.
- maya-bootstrap -- Provides the native launcher that provides the initial Launcher download.