Installing the Agentry Components of the SAP Mobile SDK

Within the SAP Mobile SDK there are included installers for Agentry development tools, as a part of the overall SAP Mobile SDK. Each of these components is installed to a system separate from the SAP Mobile Platform runtime environment and are intended for developers, implementors, and administrators.

With the exception of the Agentry SAP Framework Foundation, all the components described here can be found in the SAP Mobile SDK. This SDK is available on the SAP Service Marketplace as a part of the resources for the SAP Mobile Platform.

The Agentry SAP Framework Foundation is an ABAP add-on installed to the SAP system to which the mobile application is to connect and with which it will synchronize data. Since this component is not installed to the same system as the other components of the Agentry development tools, but instead to the SAP system, it is provided as a separate download within the list of SAP Mobile Platform components on the SAP Service Marketplace website.

Each of these components is described briefly below in the context of the SAP Mobile SDK. For those familiar with the Agentry Mobile Platform provided previously by Syclo, this content will be familiar. However, there are certain differences related to installation and configuration which are called out in these descriptions. From a functional and developer experience standpoint, there have been no changes to Agentry-based application development.

For information on the SAP Mobile Platform runtime, including how Agentry operates within it, see information provided on configuration, clustering, and similar topics within the guides provided for the SAP Mobile Platform runtime environment.

Note: The resources discussed here are also available on DVD’s, which match the download images available on SAP Service Marketplace. Instructions refer only to the Service Marketplace. If you are installing from DVD’s, the same structure information is applicable.

Agentry Server

The Agentry Server provided in the SAP Mobile SDK is installed to a host system for use by developers. Licensing for this component is limited to 5 devices, per the license keys provided in the plain text file found within the SAP Mobile SDK. See the procedure “Installing the Agentry Server for Windows” for details on locating and using this licensing information. This Agentry Server installation is used for development work, providing the Agentry Server by itself and outside of the overall SAP Mobile Platform implementation. When installed as a Production Server, it is used for deployment preparation of a mobile application and all its resources, prior to being deployed to the SAP Mobile Platform runtime environment.

The installation program itself provides the options Development Server and Production Server, which should be familiar if you have worked with the Agentry Mobile Platform versions 6.0.x or earlier. However, the Production Server option, which was previously used for runtime environments with live users, is now provided only to support development and migration processes.

Agentry Editor

The Agentry Editor is the primary development tool for mobile applications built using the Agentry archetype within the SAP Mobile Platform. This is provided as a plug-in to the Eclipse IDE. The proper version of Eclipse must be installed and configured first, followed by the installation of the plug-in to the Eclipse implementation. The Agentry Editor provides a point and click development environment, within which the mobile application can be built or an existing mobile application can be modified for specific implementation needs.

For those familiar with the Agentry Mobile Platform versions 6.0.x or earlier this procedure is the same, and the Agentry Editor user interface experience has not been modified. The development concepts and architecture have also not been affected with the integration to the SAP Mobile Platform.

Agentry Test Environment

The Agentry Test Environment provides an Agentry Client which runs within a test and monitoring interface. This interface provides tools to inspect data stored on the client device, including objects, transactions, complex tables, and data tables. Actions and transactions can be debugged as they are executed or instantiated. Client devices hardware features including barcode scanners and GPS units can be mimicked within the Agentry Test Environment to support full functional testing of client-side behavior of the mobile application. The Agentry Test Environment can also mimic various client device types and form factors.

For those familiar with the Agentry Mobile Platform versions 6.0.x or earlier the installation of the Agentry Test Environment and its usage have not been affected by the integration to the SAP Mobile Platform.

Agentry SAP Framework Foundation and Related Resources

The Agentry SAP Framework Foundation is an ABAP Add-On that is installed to the SAP system with which the mobile application is to connect and synchronize. This component is only used for SAP systems and other enterprise systems will not use this component. The Agentry SAP Framework Foundation provides the framework within which the needed synchronization support for the mobile application is implemented. This includes exchange data model components such as triggers, mobile data objects, rules, filters, and other similar pieces.

This component of the SAP Mobile Platform is provided on SAP Service Marketplace as an available download. However, if the intention of your installation is to deploy a packaged mobile application built on Agentry, this component should not be installed. Rather, the Agentry SAP Framework ABAP Add-On provided with that application, which will include application-specific components, should instead be installed. The Agentry SAP Framework Foundation is provided for user cases in which a new mobile application for an existing SAP system is being developed form the ground up.

Agentry SDK

The Agentry SDK installer is provided for two development scenarios. The first is when it is desired to develop ActiveX controls for use on Windows Mobile devices. The second is when it is necessary to develop interprocess communications between the Agentry Client and another process running on the mobile device. If neither of these scenarios are applicable to your environment, this component need not be installed. If the Agentry SDK is to be installed and used, see the installation procedure provided in the SAP Mobile SDK installation guide, as well as the information on the structure and usage of the API’s within this SDK provided in the Developer Guide: Agentry Applications.