Installing the Agentry Test Environment

Prerequisites
Address the following items prior to performing this procedure:
  • The SAP Mobile Platform SDK 3.0 installer must already have been run and access to the items it installed must be available form the system to which the Agentry Test Environment is being installed.
  • Determine the installation location of the Agentry Test Environment on the intended host system. By default this location is C:\Agentry\Test Environment. You can specify a different location during the installation if desired.
  • Log into the host system as an administrator, with privileges to install software to the desired location.
Task

This procedure describes the steps necessary to install the Agentry Test Environment software component. This component is used as a client test tool during development of applications using the Agentry archetype. It is not intended for end users. It can only be installed to Windows desktop systems and cannot be installed to mobile devices.

Perform this procedure to:
  • Test modifications of the mobile application, when those modifications affect client-side behavior or client-server communications or synchronization.
  • Test or debug run time issues in a Production environment. The Agentry Test Environment can be connected to the Agentry Production Server just as a normal client can.

When this procedure is complete, the Agentry Test Environment is available for use to test the client-side behaviors of any modifications made to the mobile application.

  1. Start the Agentry Test Environment installer on the host system where you are installing this component by running the program Agentry_7_0_x_x_TestEnvironment.exe (NOTE: The value x represents the latest service pack or patch release of the system, depending on the version downloaded). This displays the Welcome to the Agentry Test Environment Setup Wizard screen.
  2. Click the [Next] button to advance the wizard. This displays the License Agreement screen.
  3. Click the [Yes] button to accept this agreement and advance the wizard. The Choose Install Location screen is displayed.
  4. Enter the desired directory path in the Destination Folder field. This can be a new path, an existing location selected by clicking the [Browse] button, or the default location. Click the [Next] button to install the Agentry Test Environment to the specified directory. This displays the Shortcuts for Agentry Test Environment screen.
  5. Select the desired shortcut locations by selecting or deselecting the listed shortcut options. Once the shortcuts are configured, click the [Install] button to begin the installation of the Agentry Test Environment software component.

    The selected shortcuts are created by the installer. The Installation Status screen is displayed next indicating the installation progress. When the installation is complete, the Completing the Agentry Test Environment Setup wizard screen is displayed.

  6. To start the Agentry Test Environment now, leave the box checked on this screen. Otherwise, deselect this box. Click the [Finish] button to close the wizard.

With the completion of this procedure, the Agentry Test Environment is installed to the selected location and is available for use in testing mobile applications in development, configuration, implementation, or production issue resolution scenarios.

Next

Just as with a standard client installation, the Agentry Test Environment needs to connect to an Agentry Server to perform an initial transmit. Prior to performing this transmit, the proper client platform to be mimicked, enabling or disabling scan and GPS simulations, and other similar selections should be made.