There is no additional client code that must be installed on an Apple device for it to connect to an IBM® Lotus Notes® Traveler server. However, you must configure the Microsoft® Exchange account on the device so that it can use ActiveSync to connect to the Lotus Notes Traveler server. Apple devices can be configured either manually or by using profiles. This topic also describes how to customize profiles (also known as .mobileconfig files) to work in your environment.
Lotus Notes Traveler ships with a default Apple profile that includes all of the information necessary for the mobile device to connect directly to the Lotus Notes Traveler server. Table 1 describes the profiles and includes their locations. When a mobile user on an Apple device accesses the Lotus Notes Traveler user home page and selects the Configure your Apple iPhone/iPod Touch/iPad
link, a page prompts the user to generate an Apple profile. When the user does so, the profile data from traveler\cfg\client\Apple.xml
is converted to the file ILNT.mobileconfig and automatically downloaded to the Apple device. When the Apple device detects a download of a file with the extension .mobileconfig, it automatically starts the installation of the profile.
Table 1. Apple client configuration files
|AppleTemplate.xml||This is the Apple client configuration template file, which contains all the default configuration information. Do not edit this file in case the original default information is needed again later.|
When the Lotus Notes Traveler server is installed, AppleTemplate.xml is installed in the Domino data directory\traveler\cfg\client directory on the server.
If the client configuration file Apple.xml does not exist when the Lotus Notes Traveler task on the server starts, the file generates from the AppleTemplate.xml file in the same directory on the server.
|Apple.xml||This is the Apple client configuration file on the Lotus Notes Traveler server (located in the Domino data directory\traveler\cfg\client directory).|
The Apple.xml file contains variables (described in the following table) that are used to pass default values to the client configuration file. These values are passed on Apple devices at run time when users log into the Lotus Notes Traveler user home page to configure their devices.
Apple.xml should handle most Lotus Notes Traveler server setups using the values provided. However, if a setup uses non-default settings, an administrator may need to customize this file. For example, if your setup uses a reverse proxy, you must set the Lotus Notes Traveler server address to be the proxy server address rather than the Lotus Notes Traveler server address (the default).
Note: After Apple.xml is created, Lotus Notes Traveler does not modify the file. However, if the file is corrupted and needs to be recreated from scratch, delete Apple.xml and Lotus Notes Traveler uses AppleTemplate.xml to recreate it.
|.mobileconfig||This is the Apple client configuration file that goes on user devices.|
The .mobileconfig file is dynamically generated for a user based on the Apple.xml file when the user logs on to the Lotus Notes Traveler user home page and creates an Apple account using an Apple profile (by selecting Configure your Apple iPhone/iPod Touch/iPad ) rather than creating the Apple account manually.
Note: Because the .mobileconfig file is dynamically generated, it cannot be digitally signed which means users get a prompt on the device saying that the file is not signed. Despite this, users should select Install Now.
Customizing for a reverse proxy environment
If your environment is using a reverse proxy in front of the Lotus Notes Traveler server, then you need to customize the default Apple.xml profile. If using a proxy, edit Apple.xml and change:
/servlet/traveler should be replaced with the actual host and URL path of the proxy server that is set up for your Lotus® Traveler server. Also, if you are using a reverse proxy, then you have most likely configured that server to use SSL. In this case, you should force the SSL configuration setting by replacing:
See Table 2 and 3 below for additional information about the settings in Apple.xml and .mobileconfig.
Table 2. Apple.xml variables
Table 3. .mobileconfig parameters
|ILNT_Address||The email address of the user|
|ILNT_HostName||The server host name|
|ILNT_HostPath||The servlet path name (for example, /servlet/traveler)|
|ILNT_HostPortHTTP||The server host port when using HTTP (for example, 80) |
|ILNT_HostPortHTTPS||The server host port when using HTTPS (for example, 443) |
|ILNT_HostProtocol||The server host protocol (0 for SSL off, or 1 for SSL on) |
|ILNT_User||The name of the user|
|UserName||ILNT_User||ILNT_User is replaced with the Lotus Notes Traveler login user ID used when the profile is generated.|
|EmailAddress||ILNT_Address||ILNT_Address is replaced by the email address of the user when the profile is generated.|
|Host||ILNT_HostNameILNT_HostPath||Lotus Notes Traveler server host name or IP address and the path, /servlet/traveler. If you are using a reverse proxy in front of Lotus Notes Traveler, this must be replaced with the reverse proxy server.|
|SSL||ILNT_HostProtocol||Use <false/> to force off SSL and <true/> to force SSL on. Otherwise, ILNT_HostProtocol is replaced based on your current connection type when the profile is generated.|
|PayloadDisplayName||IBM Lotus Notes Traveler for user name||The name of the profile which displays when the profile is presented for installation. This can be any string. The name of the profile is also what you see when you try to uninstall it. It is shown as the mail account name in some applications.|
|PayloadDescription||Configures the device for use with IBM Lotus Notes Traveler for user name||The description of the profile, shown with the display name, which displays when the profile is presented for installation. This can be any string.|
|PayloadOrganization||IBM Lotus Notes Traveler ||The organization of the profile, shown with the display name and description, which displays when the profile is presented for installation. |
Parent topic: Configuring Lotus Notes Traveler server