Configuring File System Back-end Connections for Agentry Applications

For Agentry applications that communicate over a file system connection, use Management Cockpit to configure the SAP Mobile Platform Server to connect to the host system. Certain tasks may or may not pertain to a particular implementation environment and you should perform a careful review of the application’s requirements and functionality before proceeding.

Prerequisites
  • Obtain and record the numeric identifier for the file system connection definition from the Agentry Editor.
  • Determine whether users are authenticated during synchronization by logging them in to the host system.
  • Obtain and record the Windows User Domain for user authentication.
  • Determine the location in whichSAP Mobile Platform Server stores temporary script files for execution. The default location is the Windows TEMP folder as configured for the system.
  • Determine whether the previous user should be connected to the Windows system when a user change occurs on the clients. You might want to omit this portion of synchronization to expedite the file transfer process.
  • Create a user account for SAP Mobile Platform Server to connect to the host system.
Task
  1. From Management Cockpit, select Applications > Back End.
  2. Under File, edit file-related connection settings. These configuration options are for a single NT File system connection, and control connection behavior between the server and the server’s host system. There may be only one File-n section within the agentry.ini file. This section must exist for an NT File system connection definition within the application. The n portion of the section name must be replaced with the ID value generated by the Editor for the system connection definition.
    Definitions Values Descriptions
    Enable Authentication Boolean value of true or false. Default: false Whether users are authenticated against the host system for this system connection. At least one system connection within the application must perform user authentication.
    Enable Previous User Authentication Boolean value of true or false. Default: false Whether previous users are authenticated against the host system for this system connection. This authentication occurs when a user change occurs on the client. If Allow Previous User Login is false, this setting has no affect.
    User Domain Text value of a configured user domain. The domain under which all users are logged in to the host system. It is only used on Windows, to control which Active Directory domain users are authenticated against by Agentry, when the file back end is configured to do authentication.
    Temporary Path Valid full path. The location where temporary files produced by the server for file system processing are stored (normally the batch file defined in the application). If this option is null or not included, the configured Windows temporary folder is used.
    Allow Previous User Login Boolean value of true or false. Default: true Whether previous users are logged in to the file system when a user change occurs on the client. If not logged in, no file system connection processing defined in the application is performed for the previous user.
    Name Text value. This setting can contain any text value used to identify the system connection in log files and other areas. Set this to a unique value, especially when working with multiple system connections.
    PAM Service Name agentry Name of the Pluggable Authentication Modules (PAM) service that Agentry should use to authenticate users on UNIX platforms.
Parent topic: Defining Back-end Connections for Agentry