The following procedure explains the configuration of
the Agentry
Server to
act as a web server, allowing web browser client access to the application.
This is done for BlackBerry Handheld Browser and Internet Explorer
support. It involves the modification of the [Web Server
Front End] and [Web Server MIME Types] sections
of the Agentry.ini file.
Prerequisites
The following items
and tasks should be addressed prior to performing the procedure provided here:
- Determine the proper port on the host system for the Agentry
Server to listen for web client requests. The default is 80
for HTTP and 443 for HTTPS (SSL) communications.
- Determine if SSL is to be used. If so, obtain the needed
authentication certificates either from a trusted certificate authority (CA)
or by creating your own self-signed certificate, for the Agentry
Server. Trusted root certificates of the client devices must
match this authentication certificate. See the topic Authentication
Certificates in the Security collection for
information about creating and installing certificates.
- Determine if any additional MIME types not configured on the
client devices, and not contained in the default Agentry.ini file [Web Server MIME
Types] section are needed. Review this section of the Agentry.ini file to obtain the default
settings.
- Configure the front end with a proper PKCS#12 (PFX) file containing a server
certificate and private key. This can be, but does not have to be, the same
PFX file that ANGEL is using. The settings needed in this section for
setting which file to use are the same as the ones in [ANGEL Front End]. See
Agentry Server: [ANGEL Front End] Configuration Section for
details.
Task- Start the SAP
Control Center.
Connect to the system where the SAP Mobile Platform with the running Agentry
Server is
installed.
- In the navigation pane of SAP
Control Center,
expand the Applications node and select the Agentry application.
- In the administration pane, click the Configurations
tab.
- Select the check box for Web Server Front End. Here,
the communications between browser clients and the Agentry
Server are
configured.
The items modified in this section for most implementations
are described next:
- listenOn: This is the
port number used by the Agentry
Server to
listen for requests made by browser clients. The default of 80 is
used for non-SSL connections. If SSL is to be used, the default
is 443. In either case the port number may be changed for firewall
support or if the default ports are in use by other applications
or processes.
- If the MIME types must be modified, you must navigate
to the installation location of the Agentry
Server.
Here open the Agentry.ini configuration file and
search for the section [Web Server MIME Types].
These MIME types are for the Agentry
Server and
are not applied to the client devices. The Agentry
Server makes
use of those MIME types configured on the host system as well those
listed in this section. If a type is defined in both locations,
the configuration found in the Agentry.ini file
will override the one configured on the host.
- Once changes have been completed for the [Web
Server MIME Types] section, you can close and save the Agentry.ini file.