Skip to main content

Notice: This Wiki is now read only and edits are no longer possible. Please see: for the plan.

Jump to: navigation, search

Aperi Device Server Design R2

Revision as of 13:56, 15 January 2007 by Unnamed Poltroon (Talk) (Installation and Configuration)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Document Author: Christoph Reichert

Latest Update Jan, 2007



The primary goal of the 2nd phase of the Aperi Eclipse project is to add extensibility that is based on Eclipse technology.

This document describes the enhancements for extensibility for the Aperi device server. Because the device server is a combination of three functional blocks for disk, tape and fabric support, this document focuses on the separation and the dynamic extensibility of the functional blocks.

This document does not cover the design of the Aperi device sever itself. Changes to this design that are done because of the Aperi work will be discussed in this document.

Design Overview and Goals

A main goal for the Aperi project is to create a extensible platform where different parties can contribute by refining the existing base, adding new functions or extend specific functions. This can only be archieved by providing an extensible and modularised code base. Therefore the existing device server is split into separated plugins and features that provide base functionality like logging or generic discovery and device specific extensions like disk discovery.

The former device server consists of a service manager that starts up all components defined as "services" in a file and deployed them as webservices. The service manager itself was started as a servlet during initialization within a servlet container. Using the Eclipse/OSGi infrastructure the "services" will be redefined as OSGi services. A connector component will look for these services and publish their APIs as webservices. The code belonging to the service is defined as a OSGi bundle, so the OSGi container cares about the bundle lifecycle and service starting and stopping. Defining dependencies between the OSGi bundles and assigning them to different runlevels ensures the correct startup order of the bundles.

The implementations of the existing service and component registrations is done by execution of java code (e.g add object and constants to registry hashtable). With Eclipse plugin registration this should migrated to a XML-property based registration wherever possible, to support lazy service initialization.

This document does not cover the extensibility of the Aperi common services (like logging or job handling) but refers to used extension points. It is assumed that similar common services from the dataserver needs to be merged into single Aperi infrastructure components. Additional, existing plugins from other eclipse projects that provide such "common services" should be reviewed and included into the base Aperi infrastructure.

Design Rationale

The design follows the existing building blocks the device server consists of and provide these as extensible components with less changes to the code as possible. Some components would require a large rework to provide detailed extensibility, these will be left as larger blocks which can be reworked as needed later in the Aperi project.

Open Items

  • Component shutdown/removal: There is no common strategy to deregister device server components. How can a component or the OSGi service container know if parts are used by running jobs or required by managed devices?
  • Detectability: Detectability service is highly dependent on the underlying database schema, so we should consider to treat it as a database component. Detectability is not designed for dynamic extensibility, there are a lot of numeric constants and if-then-else constructs that need more in-depth analysis and design.

Requirements Addressed and Features Provided

Aperi Extensibility can be grouped in different categories:

  • Special Device Extensibility
    • Support for a kind of Storage Devices (like Disk Arrays) can be extended to support special features of a device or to provide a fix/workaround for a special device.
  • Additional Device Extensibility
    • Support for new kind of devices like NAS devices can be added to Aperi.
  • API Extensibility
    • The API provided by WebServices and internal Services can be extended.

Main Components of the Architecture

Device Servers Platform Components

The Infrastructure components have to be moved from the Device-Server to the Aperi platform. Some main building blocks need to be defined as Eclipse Plugins (OSGi Bundles) that the device-server apps can use and extend. Others are just used as-is and will not be separated in different plugins in this phase. The base code that is used together with Data server is located in the org.eclipse.aperi.common and org.eclipse.aperi.common.utils project. Some OSGi services are defined there and started by the org.eclipse.aperi.server.device bundle

Device Server - org.eclipse.aperi.server.device
Component Description Comments
OSGi Bundle name org.eclipse.aperi.server.device -
OSGi service org.eclipse.aperi.sanmgmt.dbconnparms.interfaces.IConfigService included interfaces:
  • org.eclipse.aperi.sanmgmt.dbconnparms.interfaces.IConfigService
Webservice name ConfigService -
consumed Extension points none -
defined Extension points none -

Discovery - org.eclipse.aperi.discovery

Aperi Discovery is a framework to detect SAN devices and query their configuration data. The detection and identification of new devices or their providers is called "discovery", collection of the configuration data of a specific storage device is called "probe".

The abstract class DiscoverProcess is the main extension point for different process steps that has to performed for a discovery or device probe. If more than one DiscoverProcess step needs to be performed for a discovery, the IStep Interface provides a container for combining and executing different DiscoverProcess' in the required order.

Depending on the Device type discovered, number and sequence of the DiscoverProcess steps may vary. Therefore the different DiscoverProcesses are registered in the Router component, which selects the DiscoverProcess based on the DiscoverProcess name and different device attributes like Vendor name, device type etc, which is provided by the DiscoverProcess RegistrationData. Plugins that want to extend the Aperi Discovery has to implement the required DiscoverProcess and register them within the Router.

Discovery plugin
Component Description Comments
OSGi Bundle name org.eclipse.aperi.discovery -
other OSGi service org.eclipse.aperi.discovery.interfaces.IDiscoverRouterService internal Router to select and run DiscoverProcess, not available as WebService
consumed Extension points none -
defined Extension points DiscoveryProcessPlugin
  • used for identifying of device type and collecting of basic device data
  • extends org.eclipse.aperi.disk.discovery.DiscoveryProcessPlugin
  • Extension point attributes define which registered extension to choose
  • extends org.eclipse.aperi.DiscoverProcess used during discovery and probe of devices.
  • Extension point attributes defines which registered DiscoverProcess to choose
Exported Classes/Interfaces
  • DiscoverProcess

The abstract DiscoverProcess class provides common functionality for the Discovery framework. Derived classes implements the technology or device specific part of the discovery.

  • IStep

Interface and basic implementations for combining the DiscoverProcess needed for a full device Discovery or probe run.

  • Router

Picks up and registers the DiscoverProcess from the eclipse extension registry and provide API for manual DiscoverProcess registration. DiscoverProcess can also be registered with instantiated objects with name only by using the Router.addProcess() method. Available as IDiscoverRouterService from OSGi service

Control - org.eclipse.aperi.control

Within Aperi, control functions like Volume creation on a storage subsystem are implemented using a Controller class. Plugins that want to provide control functions have to extend this abstract class, which cares for asynchronous execution of control tasks and job handling.

Often Control functions APIs are additional published as WebServices.

Control plugin
Component Description Comments
OSGi Bundle name org.eclipse.aperi.control -
OSGi service org.eclipse.aperi.sanmgmt.middleware.interfaces.IService The plain control service has no API, it just implements the ISerivce interface to report the overal control service status.
Webservice name ControlService -
consumed Extension points none -
defined Extension points controller extended by a device specific implementation of org.eclipse.aperi.interfaces.IControl which has to define the specific control API.
Exported Classes/Interfaces
  • org.eclipse.aperi.interfaces.IController and the abstract implementation in class org.eclipse.aperi.control.Controller
    • provides the "management" methods of the specific control modules that extends the controller extension point.

Monitoring - org.eclipse.aperi.monitor

Monitoring is used to detect configuration and state changes of devices in the SAN. Aperi will register and listen for messages and indications sent by devices. These are internally distributed by JMS queues. Alerting is also part of the data server and extensability is discussed in the Aperi Phase 2 Data server design.

Monitoring plugin
Component Description Comments
OSGi Bundle name org.eclipse.aperi.monitor -
OSGi service org.eclipse.aperi.sanmgmt.sanmgr.eventcorrelator.interfaces.IEventMonitorService included interfaces:
  • org.eclipse.aperi.monitor.eventcorrelator.interfaces.IEventCorrelatorFactory
  • org.eclipse.aperi.tape.api.ITapeCollectionService
Webservice name SANEventCorrelatorFactory -
OSGi service 2 org.eclipse.aperi.sanmgmt.diskmgr.hostservice.manager.interfaces.ISANDiskMgrHostService no other interfaces included
Webservice name 2 SANHostMgr -
consumed Extension points none -
defined Extension points none *new IPopulator implementations are registered with the Devicetype using the IEventMonitorService.registerAlertPopulator() method. This should turn into an Eclipse plugin extension in future.

Database Mapper

The Database definition, helper classes and utilities like "Detectability service" are described in the Aperi Database design document. The javacode related to database helpers and tools is located in the plugin org.eclipse.aperi.common.

The Aperi database infrastructure defines some extension points that are mainly used by the discover and probe processes to translate device specific data into database entries and group tables to logical entities like a disk storage system. The data translation is done by database mappers that convert device and technologie specific properties like a CIM-SMIS class to generic values and store them to one or more database table entries.

The Aperi DB provides basic Mapper functions like a MapperPackage that registers all Mappers and a MapperRouter that select a specific Mapper for a given object and describing attributes. Also common mapper functions are provided with the DBAttributeMapper that can be extended for each table and device specific class.

DbAttributeMapper extension
Component Description Comments
defined Extension points dbAttributeMapper
  • implement org.eclipse.aperi.interfaces.IDBAttributeMapper
  • abstract DBAttributeMapper provide basic implementation
  • SMISMapperRegistrationData declares when to use the mapper class

Other base components

Component plugin Extension points Comments
Other base components:
  • Jobs
  • Events
  • Authorization
  • Configuration
  • Alerts
org.eclipse.aperi.platform IJobMgmtService

SANEventService ConfigService Alert

Because these base functions are unlikely extended in the first Aperi release and because they might be merged with similar services existing on the data server, a separation into different plugins may not be useful in this phase.

Standard Technology Support

Administration and configuration of different device types is based on the basic technologies like CIM/SMI-S or SNMP. Because Aperi platform should be extensible with additional "base technologies" and storage devices might rely on more than one of them, they should be separated in plugin-bundles a future release. Right now technologies are tied mainly to single technologies, therefore most part of the SMI-S code can be found in the Disk plugin whereas the Fabric plugin contains the SNMP support.



Aperi provides the basic technologies from the SMI-S/CIM standard of version 1.0.x and 1,1. This includes constants for classes, names and properties defined in the SMIS standards, the sblimCIMClient and management of CIMOMs. It consists of the following components:

sblim CIMClient - org.sblim.slp

Communication with the SMIS CIM Provider is done by use of the SBLIM CIM Client. It is not part of the Aperi project but used within the org.sblim.slp plugin. The Client API is wrapped within Aperi by a CIMClientWrapper that adds more control to the communication like specific timeout values.

CIMOM Management

The list of known CIM Providers, their access info and additional attributes are managed by the CIMOMManager, accessible through the ICIMOMMgmtService. Additional the CIMOMManager can be queried for a specific CIMOM to access a given storage device. As well a connection test is performed and faulty CIMOMs skipped.

OSGi Services

org.eclipse.aperi.common.api.ICIMOMMgmtService is part of the DiskManagerService Webservice API.

Basic Functionality

The Aperi framework for Discovery and Probe is based on querying device data, convert it to the database schema and persist it. The following components implements this for CIM/SMIS based data.

DB Mapper

The DB Mapper associate and convert the properties from the CIM objects to Aperi DB tables and fields. The mappers implement the IDBAttributeMapper interface and has to be registered to the IMapperRouterService.

CIM Monitoring/Indications

Registers and listen to SMIS/CIM Indications. It extends the Aperi Platform Monitoring and provides ICIMIndicationHandler

SMIS Discovery

The SMIS discovery extends the Aperi platform discovery by querying a given CIMOM for SMIS SAN devices like fabric, disk or tape devices. Device properties are retrieved to identify the device and store it into the Aperi database, afterwards a device type specific probe can be run to collect the device configuration. The DiscoverProcess is extended with the TopLevelDiscoveryProcess that provides the process for SMIS device discovery. To handle device and vendor specific properties DiscoverProcessPlugin Extensions can be created to add discovery of more SMI-S devices.

The Following components allow to the probe SMIS devices:

  • CIMScanner - interacts directly with the CIM client that performs CIM calls
  • AssociatorCIMQuery - extends the DiscoverProcess to perform SMIS CIM queries
  • Query - defines the CIM query that is executed within the AssociatorCIMQuery
  • CIMParser/CIMProcessor
  • DiscoverStep - executes CIM queries. For each CIM object retrieved as the query result subsequent Steps can be performed.
  • plus other CIM specific IStep implementations like caching of CIM elements.

Other standard technologies

Several other technologies are used by Aperi. Right now they are included within the Aperi platform or part of single devices but might be packaged in separate plugins later.

SLP - org.sblim.slp

SLP discovery is part of the CIM/SMIS discovery. Therfore Aperi uses the SBLIM SLP implementation in the org.sblim.slp bundle.

SNMP - org.eclipse.aperi.snmp

Aperi includes an client implementation for the SNMP protocol in the org.eclipse.aperi.snmp bundle.

Device Support

Based on the Aperi platform, the device type specific components of the device-server for disk, fabric or tape devices are provided as Eclipse feature bundles. These extends the platform components for specific Discover/Probe, Configuration and Monitoring functionality and depends on the technology the device is based on. The bundles provide there own APIs for there function blocks and register them as WebService.



Aperi supports Storage Subsystems that implements the Array- and InbandVirtualizer Profile with SMIS versions of SMI-S 1.0.x and 1.1. Some vendor specific funcions and fixes for non-compliant devices are already included. In future the device specific cimponents might be separated in additional plugins.

Tape plugin
Component Description Comments
OSGi Bundle name org.eclipse.aperi.disk -
OSGi service org.eclipse.aperi.disk.api.IDiskManagerService included interfaces:
  • org.eclipse.aperi.disk.api.IDiskManagerService
  • org.eclipse.aperi.disk.api.IDiskReportingService
  • org.eclipse.aperi.disk.api.IDiskCollectionService
  • org.eclipse.aperi.disk.api.IDiskConfigurationService
  • org.eclipse.aperi.common.api.ICIMOMMgmtService
Webservice name DiskManagerService -
OSGi service 2 org.eclipse.aperi.disk.api.IDiskMonitorService included interfaces:
  • org.eclipse.aperi.disk.api.IDiskMonitorService
Webservice 2 name DiskMonitorService -
consumed Extension points org.eclipse.aperi.control.controller

org.eclipse.aperi.discovery.discoveryProcessPlugin org.eclipse.aperi.discovery.discoverProcess org.eclipse.aperi.disk.storageConfiguration

defined Extension points org.eclipse.aperi.disk.storageConfiguration Control functions for different Disk devices may vary, several implementations of org.eclipse.aperi.disk.control.IStorageConfigurationManagementPlugin can be registered with the device specific attributes

IDiskManagerService API
  • API Interfaces/generic classes for Discovery and Probe
    • IDiskCollectionService
    • ProbeGenericSubsystemProcess extends DiscoverProcess
    • ProbeGenericMappingMaskingProcess extends DiscoverProcess
  • API Interfaces/generic classes for Control
    • IDiskConfigurationService
    • IStorageSubsystemControl
    • IStorageConfigurationPlugin/StorageConfigurationPluginFactory

The IStorageConfigurationPlugin is the extension point for specific implementations of control functions. The StorageConfigurationPluginFactory needs to use the extension registry to fetch the StorageConfigurationPlugins and return them based on the extensions XML-properties.

  • Extension Points and Interfaces/generic classes for Monitoring
    • IDiskMonitoringService
    • ICIMIndicationHandler/DiskIndicationHandlerFactory

The ICIMIndicationHandler is the extension point for different SMIS or device specific CIM-indications. DiskIndicationHandlerFactory dynamically registers the IndicationHandlers using the registerHandler() method. This can be changed to a Extension point is a later release.

  • for Reporting
    • IDiskReportingService
  • Other components
    • The disk component defines a common LogTraceHelper class for all disk related logging, encapsulating the underlying logging service.

Tape - org.eclipse.aperi.tape

Aperi supports discovery/probe and reporting for Tape devices following the SMI-S 1.1 standard. Because the structure and implementation of the Tape component is similar to Disk, there is only a list of the Extensions and interfaces provided.

Tape plugin
Component Description Comments
OSGi Bundle name org.eclipse.aperi.tape -
OSGi service org.eclipse.aperi.tape.api.ITapeManagerService included interfaces:
  • org.eclipse.aperi.tape.api.ITapeReportingService
  • org.eclipse.aperi.tape.api.ITapeCollectionService
  • javax.jms.MessageListener
Webservice name TapeManagerService -
consumed Extension points none Extended DiscoverProcess registered using IDiscoverRouterService.

Tape specific DBAttributeMapper still part of common-plugin.

Defined Extension points none -
API Interfaces and generic classes


- for Discovery and Probe


ProbeGenericTapeLibraryProcess extends DiscoverProcess

- for Monitoring


- for Reporting


Fabric - org.eclipse.aperi.fabric

Aperi supports Switch and Fabric discovery and configuration using SNMP and G3 protocol.

The Fabric support includes SNMP and G3 protocol support. Only the basic plugin APIs are defined for this release and a more modular fabric application structure is introduced with the integration of the fabric SMI-S support.

Fabric plugin
Component Description Comments
OSGi Bundle name org.eclipse.aperi.fabric -
OSGi service org.eclipse.aperi.fabric.api.IFabricManagerService included interfaces:
  • org.eclipse.aperi.fabric.api.IFabricManagerService
  • org.eclipse.aperi.fabric.api.IFabricReportingService
  • org.eclipse.aperi.fabric.api.IFabricCollectionService
  • org.eclipse.aperi.fabric.api.IFabricConfigurationService
  • org.eclipse.aperi.fabric.api.IAgentMgmtService
  • org.eclipse.aperi.common.api.IJobMgmtService
  • javax.jms.MessageListener
Webservice name FabricManagerService -
OSGi service 2 org.eclipse.aperi.snmpagent.manager.interfaces.ISNMPAgentManager included interfaces:
  • org.eclipse.aperi.snmpagent.manager.interfaces.ISNMPAgentManager
Webservice 2 name SNMPAgentManager -
consumed Extension points org.eclipse.aperi.control.controller org.eclipse.aperi.control.fabric.ZoneController
defined Extension points none -
API Interfaces/generic classes
  • for Discovery and Probe
    • SNMPScanner
    • IFabricCollectionService
  • for Control
    • IZoneControl
    • IFabricConfigurationService
  • for Monitoring
    • IFabricMonitor
  • for Reporting
    • IFabricReportingService

IBM SVC (SAN Volume Controller)


IBM SAN Volume Controller (SVC) provides some additional support that goes beyond the standard SMIS InbandStorageVirtualizer Profile. To demonstrate the Aperi Extension capabilities the SVC support resides in a separate Plugin Bundle. The SVC support will add additional API methods specific to the IBM SVC device and has to register revice specific discovery/probe and configuration modules.

Main Extensions
Component plugin Extension points Comments
org.eclipse.aperi.disk.SVCManagerService IDiskSVCManagerService Service registration/Bundle Lifecycle
Disk.Control org.eclipse.aperi.disk.control IDiskSVCConfigurationService -

SVCManagerService extends DiskManagerService

Extension Points and Interfaces/generic classes
- for Discovery and Probe
  • ProbeSVCSubsystemProcess extends ProbeGenericInbandVirtualizer
  • ProbeSVCMappingMaskingProcess extends ProbeMappingMaskingProcess
- for Control


- for Monitoring

no special Monitoring for SVC device, the base Disk Monitoring component will be used.

- for Reporting

no special Reporting for SVC device, the base Disk Monitoring component will be used.

Installation and Configuration


All Device Server components are packaged as OSGi bundles/Eclipse features and installed into an OSGi Container on top of the Aperi platform. Also a Aperi database must be installed and running.

The technology support bundle requires the Aperi platform, the device support bundles require the Aperi platform and may require one or more technology support bundles. The resolving of bundle and plugin dependencies is done by the OSGi Container.

Optional Enhancements

The following points may be useful future enhancements or new extension points that are not implemented yet.

SMI-S support bundle

As stated abovr, SMI-S support is not a separate plugin, but mainly part of the disk plugin. With upcoming support for other device types all SMI-S functionality should be grouped into one plugin as a base for all SMI-S device support

Job Management

A single plugin for Jobmanagement should be defined, as most components are residing in the common package but the Job API is not consistent and splitted between the device API of fabric, disk and discovery.

Device specific enhancements

Right now in the Disk and Tape plugin the SMI-S standard implementation resides together with device specific enhancements. Separate device specific plugins may improve maintainability of code and device support.

For example a device specific plugin to provide support for a IBM SVC might look like below:

Example: IBM SVC (SAN Volume Controller) - org.eclipse.aperi.disk.ibmsvc

IBM SAN Volume Controller (SVC) provides some additional support that goes beyond the standard SMIS InbandStorageVirtualizer Profile. The SVC support will add additional API methods specific to the IBM SVC device and has to register revice specific discovery/probe and configuration modules.

IBMSVC plugin
Component Description Comments
OSGi Bundle name org.eclipse.aperi.ibmsvc -
OSGi service org.eclipse.aperi.tape.api.ISVCManagerService extends the IDiskManagerService interface
Webservice name SVCManagerService -
consumed Extension points same as disk with device specifics -
defined Extension points no new extension points -
API Interfaces/generic classes
  • SVCManagerService extends DiskManagerService
  • for Discovery and Probe
    • ProbeSVCSubsystemProcess extends ProbeGenericInbandVirtualizer
    • ProbeSVCMappingMaskingProcess extends ProbeMappingMaskingProcess
  • for Control
    • IDiskSVCConfigurationService
  • for Monitoring
    • no special Monitoring for SVC device, the base Disk Monitoring component will be used.
  • for Reporting
    • no special Reporting for SVC device, the base Disk Monitoring component will be used.

Back to the top