DISCLAIMER This documentation is provided for reference purposes only. While efforts were made to verify the completeness and accuracy of the information contained in this documentation, this documentation is provided as is without any warranty whatsoever and to the maximum extent permitted, Lotus and IBM disclaim all implied warranties, including without limitation the implied warranties of merchantability, noninfringement and fitness for a particular purpose, with respect to the same. Lotus and IBM shall not be responsible for any damages, including without limitation, direct, indirect, consequential or incidental damages, arisign out of the use of, or otherwise related to, this documentation or any other documentation. Notwithstanding anything to the contrary, nothing contained in this documentation or any other documentation is intended to, nor shall have the effect of, creating any warranties or representations from Lotus and IBM (or their suppliers or licensors), or altering the terms and conditions of the applicable license agreement governing the use of this software. COPYRIGHT Under the copyright laws, neither the documentation nor the software may be copied, photocopied, reproduced, translated, or reduced to any electronic medium or machine-readable form, in whole or in part, without the prior written consent of IBM Corporation, except in the manner described in the documentation or the applicable licensing agreement governing the use of the software. Licensed Materials - Property of Lotus Copyright 1985-2001 Lotus Development Corporation Copyright IBM Corporation Lotus Software, IBM Software Group One Rogers Street Cambridge, MA 02142 All Rights Reserved. Printed in the United States. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP schedule contract with IBM Corp. This product includes software developed by the Apache Software Foundation (http://www.apache.org/) Copyright 1999-2000 The Apache Software Foundation, PilRC Copyright 1997-1999 Wes Cherry (http://www.ardiri.com) and RCPalm (http://freewarepalm.com/utilities/rcpalm.shtml). All rights reserved. sync router of Intuwave Copyright 2001 Revision History: Original material produced for Lotus Notes and Lotus Domino Release 5.0. List of Trademarks Domino, cc:mail, Notes, and Notes/FX are trademarks and Freelance, Freelance Graphics, Lotus, Lotus Notes, LotusScript, NotesSQL, NotesView, 1-2-3, Organizer, SmartIcons, and SmartSuite are registered trademarks of Lotus Development Corporation and/or IBM Corporation in the United States, other countries, or both. OS/2 Warp and PowerPC are trademarks and AIX, IBM, OS/2, Presentation Manager and SNA are registered trademarks of International Business Machines Corporation. Tivoli/Courier is a trademark of Tivoli Systems Inc. and/or IBM Corporation in the United States, other countries, or both. All other trademarks are the property of their respective owners.
This page intentionally left blank.
Contents DominoEveryplace Enterprise Server Administrator s Guide... What is Domino Everyplace Enterprise?... Procedural overview... Configuring your Domino server to work with DEES... Installing the Domino Everyplace Enterprise Server... The DEES Administration database... How Domino applications become mobile applications... The developer's role... The administrator's role... Mobile application security settings... Configuring mobile applications... Enabling an application... Assigning mobile applications to new mobile users or groups... Getting started... Creating a Device Profile... Creating a Device Profile Template... 11 Changing a synchronization filter in a Device Profile... 12 Editing a Mobile Application Profile... Reviewing a filter document... 13 Information to provide to your mobile users... 14 14 Installing the encryption library (Pocket PC only)... 16 Assigning an additional application to established users... 17 Removing an application from users' catalogs... 18 Deleting an application profile from the DEES Administration database... 18 The Domino Everyplace Log... Resolving synchronization conflicts... Index... 21 1 1 2 3 4 5 6 6 7 7 8 9 9 10 10 12 19 iii
This page intentionally left blank.
DominoEveryplace Enterprise Server Administrator s Guide The Domino Everyplace Enterprise Server Administrator s Guide tells administrators how to configure their Domino server to work with Domino Everyplace Enterprise, how to install the Domino Everyplace Enterprise Server, how to ready mobile applications for download to users, and how to assign specific mobile applications to users. Audience This guide is intended for Domino administrators responsible for deploying mobile applications to Mobile Notes users. In addition to this guide, administrators might need to refer to Administering the Domino System and the Notes, Domino and Domino Designer Release Notes. What is Domino Everyplace Enterprise? Domino Everyplace Enterprise is a set of products that provides the tools to develop Domino mobile applications, to administer mobile applications to users, to run mobile applications on handheld devices, and to synchronize mobile applications. Domino Everyplace Enterprise consists of three components: The Domino Everyplace Enterprise Mobile Application Designer The Domino Everyplace Enterprise Server (DEES) The Mobile Notes client Domino Everyplace Enterprise Mobile Application Designer The Domino Everyplace Enterprise Mobile Application Designer is a development tool that creates mobile Notes applications for handheld devices. It enables the application developer to specify Domino forms and views for the mobile application, to test the application on a handheld device or emulator, and to publish the application s profile to a DEES Administration database on a Domino Everyplace Enterprise Server. For more information about the Mobile Application Designer, see the Domino Everyplace Enterprise Mobile Application Developer s Guide. 1
Domino Everyplace Enterprise Server The Domino Everyplace Enterprise Server is an HTTP servlet that provides synchronization services for Domino servers. The Domino Everyplace Enterprise Server can run on top of any type of Domino server a mail, application, or enterprise server. The Domino Everyplace Enterprise Server includes the DEES Administration database for administering mobile applications to users. Mobile Notes users connect to the Domino Everyplace Enterprise Server to load and to synchronize their mobile applications. The Domino Everyplace Enterprise Server Administrator s Guide explains how to configure a Domino server to work with the Domino Everyplace Enterprise Server and how to use the DEES Administration database to deploy and manage mobile applications. Mobile Notes The Mobile Notes client provides the Lotus Notes functionality for your handheld device. With Mobile Notes, you can create, modify, and delete documents from your mobile applications. When you connect your handheld device to the Domino Everyplace Enterprise Server, you can synchronize your mobile applications from the Mobile Notes interface. For more information about how users work with Mobile Notes, see the Domino Everyplace Enterprise User s Guide. Procedural overview To administer the Domino Everyplace Enterprise Server (DEES), you must configure a Domino server to work with DEES and set up proper access to the DEES Administration database (a Domino application for performing the major administrative tasks for the DEES). You then install DEES on the same system as the Domino server, and use the DEES Administrative database to configure mobile applications for deployment and assign the applications to the handheld devices of Mobile Notes users. The following procedure outlines the setup for DEES. Each step is covered in detail in this guide. 1. Configure a Domino server to work with DEES. 2. Install DEES on the Domino server. 3. Configure the DEES Administration database. 4. Check mobile application ACL settings. 5. Configure mobile applications created by application developers. 6. Configure new mobile users or groups. 7. Provide information to the mobile users so that they can load the mobile applications on their devices. 2 Domino Everyplace Enterprise Server Administrator s Guide
Configuring your Domino server to work with DEES Domino Everyplace Enterprise Server is an HTTP servlet that runs on top of Domino 5.0.6 or higher. Before you install DEES, you must configure a Domino server to work with DEES and edit the Domino Directory so that administrators can access the DEES Administration database (a Domino application for performing the major administrative tasks for the DEES). To configure the Domino server 1. From the Domino Administrator, select the server on which you want to install DEES. 2. If the Domino server on which you want to install DEES is not a Domino Web server, edit the server s Configuration Settings document to enable HTTP. For more information, see Administering the Domino System. Tip You can check whether a Domino server is a Domino Web server by entering show tasks at the server console. A Domino Web server shows HTTP Server in its list of active tasks. 3. Click the Configuration tab. 4. Expand the Server section in the view pane, and click Current Server Document. 5. Click Edit Server. 6. Click the Internet Protocols - Domino Web Engine tabs. 7. Under Java Servlets, in the Java servlet support field, select Domino Servlet Manager. 8. Click Save and Close. 9. Go to Installing the Domino Everyplace Enterprise Server. To set up access to the DEES Administration database The DEES Administration database ACL has No access as the default and gives Manager access to a group named DEESAdmin. You must create the DEESAdmin group in your Domino Directory and add to that group the names of application developers and administrators who will publish or manage mobile applications or manage mobile users. Members of the DEESAdmin group can then use their Notes workspace or the Domino Administrator to open the DEES Administration database from their systems. Enhancing the level of transport encryption using the Domino single sign-on (SSO) feature To encrypt messages exchanged between DEES and handheld devices, a DES encryption key is used. This key is generated from user-specific as well as device-specific information. To enhance the level of security, an Domino Everyplace Enterprise Server Administrator s Guide 3
additional Domino system-wide secret can be included in the key generation process by using the Domino single sign-on feature. Whenever SSO is installed and enabled on a Domino server running DEES, information in a domain-wide Web SSO Configuration document is automatically added to the information that DEES uses to generate the encryption key. For Pocket PC devices, the Microsoft High Encryption Pack for Pocket PC Version 1.0 must be installed in order to enable this encryption feature. For information on how to enable your Domino server for SSO, see the Notes, Domino and Domino Designer Release Notes. Installing the Domino Everyplace Enterprise Server To install the Domino Everyplace Enterprise Server (DEES), you must have a Domino server configured to work with DEES. All components of Domino Everyplace Enterprise, including DEES, are contained on the Domino Everyplace Enterprise CD. A single installation program allows you to choose which components to install, as shown in the following table. Option Desktop (Optional) Device Server Sync router (Palm and Nokia devices Only) (Optional) Description Installs the Domino Everyplace Enterprise Mobile Application Designer to develop mobile applications. Installs Mobile Notes on the PC so a user s handheld device can run mobile applications. Installs Domino Everyplace Enterprise Server on a Domino server to administer mobile applications. Installs the sync router feature on a PC to connect a handheld device with the Domino Everyplace Enterprise Server through a serial port connection on the PC. Where to install this component On a PC that runs Domino Designer 5.0.6 or higher. On a PC that has Palm Desktop, PC Suite for Nokia 9210 Communicator, or ActiveSync for Windows CE installed. On a server that runs Domino 5.0.6 or higher. On a PC. 4 Domino Everyplace Enterprise Server Administrator s Guide
The procedure below tells you how to install the server component of Domino Everyplace Enterprise. Note that your developers and users will use the other options listed in the table to install other Domino Everyplace Enterprise components. To install Domino Everyplace Enterprise Server 1. Make sure Domino 5.0.6 or higher is installed on the server where you will install DEES. 2. Configure the Domino server to work with DEES. 3. Exit the Domino Server program. 4. Place the Domino Everyplace Enterprise CD in the CD-ROM drive. The installation program launches automatically. The InstallShield Wizard prompts you through the installation process. 5. (Optional) Domino Everyplace Enterprise can detect previously installed versions of itself. a. If the installation prompts you to modify the current installation: Select Remove, and then click Next. Note Make sure you do not select the Modify or Repair options at this time. b. In the Confirm File Deletion dialog box, click Yes, and then click Finish. c. To continue installation after you uninstall Domino Everyplace Enterprise, you must manually launch SETUP.EXE. Open Windows Explorer, and then navigate to the Setup directory on the CD-ROM drive. Double-click SETUP.EXE. 6. In the Setup Type panel, you can deselect the Desktop, Device, and Sync router options, and you must select the Server option. 7. Complete the information in the product registration wizard. The Domino Everyplace Enterprise Server installation is now complete. 8. To begin administrative tasks, see The DEES Administration database. The DEES Administration database You use the DEES Administration database, DEESAdmin.nsf, to perform the major tasks for administering the Domino Everyplace Everywhere Server. The DEES install (server option) places the DEES Administration database in the Domino data directory on the Domino server on which DEES runs. Domino Everyplace Enterprise Server Administrator s Guide 5
If DEES is installed on multiple Domino servers If DEES is installed on multiple Domino servers in your enterprise, you need to replicate the DEES Administration database installed on the first server to all the other servers running DEES. Do not copy the database or create a new database, as having copies of the database whose replica IDs do not match would keep mobile users from synchronizing with servers. Getting started administering DEES Before you begin administration tasks, you must know which mobile applications you are deploying to users and which servers these applications reside on. Make sure that the server and path information is specified in the Application Profile in the DEES Administration database. It is also a good idea to check the ACL settings for each application to prevent access problems when users begin synchronizing their handheld devices with the DEES. Then, once you open the DEES Administration database from your system, you can configure mobile applications. How Domino applications become mobile applications To create Domino Everyplace Enterprise mobile applications, developers first create or modify Domino applications in Domino Designer, tailoring the design of these applications to the requirements of handheld devices. The developer's role Using Domino Everyplace Enterprise Mobile Application Designer, a developer creates a Mobile Application Compiler document in an application database, and uses this document to specify which design elements from an application forms, views, fields, and so on to include in the mobile application. The developer also modifies the filter template in the application database, specifying the default views and folders that will synchronize with handheld devices. The application is then compiled and specially formatted to run on handheld devices. The developer then replicates the mobile application database to a server, and publishes documents about the application and its filter to the DEES Administration database on the Domino Everyplace Enterprise Server. Finally, the developer provides the administrator with the information necessary to complete the mobile application documents in the DEES Administration database. 6 Domino Everyplace Enterprise Server Administrator s Guide
For more information about mobile application development, refer to the Domino Everyplace Enterprise Mobile Application Developer s Guide. The administrator's role The administrator adds the information provided by the developer to the mobile application documents, enables the application and then configures mobile users by creating profiles for users handheld devices. The administrator also determines whether or not users can edit the filter document associated with each mobile application. Mobile application security settings Mobile applications inherit the access control list (ACL) settings of the original Domino application. Check the following settings for each application to prevent access problems when users begin synchronizing their handheld devices with the Domino Everyplace Enterprise Server (DEES). Server access Make sure that the proper name of the Domino Everyplace Enterprise Server is in the ACL of the original Domino application or in a group or role in the ACL, and that the server has full Manager access with Delete privileges. The DEES uses the server ID to enforce user access control and to detect changes in document status. Problems arising from the server s having insufficient access to the application database will be indistinguishable from insufficient user access. If the mobile application resides on a Domino server other than the server where you installed DEES, confirm that the LocalDomainServers group or another group containing the names of the servers is in the ACL of the original application. For each application, you should create groups or roles in the ACL for each level of access needed: server access, administrator access, and the various levels of user access. Because servers require explicit, full access, you should take care in setting up ACLs to avoid allowing any access you did not intend. For more information on Domino security and ACLs, see Administering the Domino System. If you are using roles to enable user access to the database, add the name of the Domino Everyplace Enterprise Server to the roles. Domino Everyplace Enterprise Server Administrator s Guide 7
User access The Domino Everyplace Enterprise Server checks the mobile application ACL to ensure that the user has access to the application. If the user has access, the tasks that the user can perform are limited by the privileges granted to him in the ACL. Except for private views and agents, which should not be enabled, you can allow mobile users the same privileges as Notes users. The DEES does not enforce access control for document sections. If the application requires that some users be denied access to sections of documents, you should devise another mechanism to achieve partial access. For example, you could ask your application developer to design two applications for the same database, with different sets of mobile forms allowing either full access or no access to different sections of a document. Configuring mobile applications The Domino Everyplace Enterprise application design process streamlines the administrative task of preparing mobile applications for deployment to users. The last step in the design process creates the following documents and publishes them to the DEES Administration database: A Mobile Application Profile for each mobile application A Filter document for each a mobile application A newly published Mobile Application Profile appears in the New Applications subview of the Applications view. As administrator, you need to verify the server, file path and name of the mobile application are entered into the Application Profile. You must enable the application before assigning users to the application. After enabling the mobile application, the application profile moves to the By Name subview of the Applications view once you click Enable. There are filter documents associated with the application. These documents specify the data that will be sent to a handheld device. The application developer can ensure that a published Filter document has a default view or folder by modifying the application s filter template. As administrator, in order to synchronize documents from a server to a device, you need to ensure that the view field in the Filter document contains a value. You can also create a new filter document if desired. 8 Domino Everyplace Enterprise Server Administrator s Guide
Enabling an application Before you can assign a new application to a user or group, the application must be enabled. 1. In the DEES Administration Database, expand the Applications section in the view pane. 2. Click New Applications. 3. Select the application profile(s) that you want to enable, and then click Enable Application. The application profile moves to the By Name subview of the Applications view. 4. Go to Assigning mobile applications to new mobile users or groups. Assigning mobile applications to new mobile users or groups Domino Everyplace Enterprise identifies Mobile Notes users by their handheld devices. To assign mobile applications to a new mobile user, you need to create a Device Profile in the DEES Administration database for each handheld device that the user owns. You can assign the same applications to multiple individuals and groups by creating a Device Profile Template, which automatically creates an individual profile for each user (or member of a group) that you select from the Domino Directory. You assign a synchronization filter (supplied by the developer with the mobile application and configured by the administrator in a filter document) at the same time that you assign an application to a user. Synchronization filters reduce the amount of data that the server has to transfer to and from the handheld device. Once you have created Device Profiles, users can set up their handheld device to synchronize with their assigned applications. Note Mobile Notes users authenticate with the Domino Everyplace Enterprise Server by entering a Domino Internet password. Make sure that each mobile user has an Internet password defined in his Person Document in the Domino Directory. All Device Profiles are stored in the DEES Administration database in case you need to edit them later, and can be sorted by application, owner, device type, filter, or status (whether a device is enabled or disabled). Domino Everyplace Enterprise Server Administrator s Guide 9
Getting started Make sure you have enabled the application and the application profile is listed in the By Name subview of the Applications view. To assign mobile applications and filters to a single user, see Creating a Device Profile. To assign mobile applications and filters to multiple users and groups, see Creating a Device Profile Template. Creating a Device Profile To assign mobile applications to a new mobile user, you need to create a Device Profile in the DEES Administration database for each handheld device that the user owns. For background information on assigning applications, see Assigning mobile applications to new mobile users or groups. If you want to save time by assigning the same set of mobile applications to multiple new users or groups, see Creating a Device Profile Template. Before you begin Make sure that each mobile user has an Internet password defined in his Person Document in the Domino Directory. To create a Device Profile 1. In the DEES Administration database, choose Create - Device Profile. 2. On the Basics tab, complete these fields: In this field Enabled Device Type Owner Language Do this Accept the default setting (Yes). This is a required field. Select the type of handheld device. This is a required field. Specify the user that owns this device. This is a required field. (Optional) Select a language for the handheld device. The default setting is English. Note The Identifier field is filled in the first time a user synchronizes the device with the server. The identifier is a unique number that DEES uses to ensure that the device is authorized to synchronize with the server. 3. On the Applications & Filters tab, click Assign Application. 4. Select an application and a synchronization filter, and click OK. 5. Click File - Save. 6. Repeat Steps 3 to 5 for each application you want to assign to this user. 10 Domino Everyplace Enterprise Server Administrator s Guide
7. Click Save and Close. 8. Go to Information to provide to your mobile users. Note If you don t want users to be able to edit a filter you assigned, refer to Reviewing a filter document. Creating a Device Profile Template You can assign the same mobile applications and filters to multiple new users and groups by creating a Device Profile Template. This template automatically creates an individual Device Profile for each user (or member of a group) that you select from the Domino Directory. For background information on assigning applications, see Assigning mobile applications to new mobile users or groups. Before you begin Make sure that each mobile user has an Internet password defined in his Person Document in the Domino Directory. To create a Device Profile Template 1. In the DEES Administration database, choose Create - Device Profile Template. 2. On the Basics tab, complete these fields: In this field Device Type Enabled Language Domino Directory Assign to Users Do this Select the type of handheld device. This is a required field. Accept the default setting (Yes). This is a required field. (Optional) Select a language for the handheld device. The default setting is English. Select the Domino Directory that contains all the users and groups who will be using this type of handheld device. This is a required field. Note You can have only one Domino Directory in this field. If you have users in a different Notes domain, you need to create a separate Device Profile Template for that domain. Specify all the users and groups who will be using this type of handheld device. This is a required field. 3. On the Applications & Filters tab, click Assign Application. 4. Select an application and a synchronization filter, and click OK. 5. Repeat Steps 3 and 4 for each application you want to assign to users. Domino Everyplace Enterprise Server Administrator s Guide 11
6. Click Create Device Profiles. You see a message as soon as a Device Profile has been successfully created for each user and group you specified. Check the Log tab for any errors. 7. Click Save and Close. 8. Go to Information to provide to your mobile users. Note If you don t want users to be able to edit a filter you assigned, refer to Reviewing a filter document. Adding more new users to the template later You can add other new users to the Assign to Users field in a Device Profile Template later on. When you click Create Device Profiles, only the profiles for the additional users will be created. Changing a synchronization filter in a Device Profile If the mobile application developer included more than one synchronization filter with an application, you can change which filter is assigned to a user. To change a filter in a Device Profile 1. In the DEES Administration database, expand the Device Profile section in the view pane. 2. Click By Owner. 3. Click the name of the user, and then click Edit. 4. On the Applications & Filters tab, click Change Filter. 5. Select the filter you want to use, and click OK. 6. Click Save and Close. Note If you don t want the user to be able to edit the filter on the handheld device, refer to Reviewing a filter document. Editing a Mobile Application Profile If there is a need for a change to the server, path or other fields in the Mobile Application Profile, you can edit the profile. 1. In the DEES Administration Database, expand the Applications section in the view pane. 2. Click the application profile in the By Name view that you want to complete, and then click Edit Document. 12 Domino Everyplace Enterprise Server Administrator s Guide
3. On the Synchronization tab, in the Database Location field, do one of the following to indicate the type of server on which the mobile application resides: Select Domino Mail Database if the mobile application is an e-mail application, and go to Step 6. Select Domino Server for all other kinds of mobile applications, and go to Step 5. 4. In the Database Server and Database Path and Name fields, verify the name of the server where the mobile application resides, and the path and file name of the mobile application. Tip You can select both the server name and file name at once by clicking Choose DB Name & Path on the right-hand side of the workspace. 5. (Optional) In the User Selectable field, do one of the following: If you want this application to be synchronized with the handheld device every time the user synchronizes with the server, select No. If you want the user to select which applications to synchronize before connecting to the server, keep the default Yes setting. 6. Click Save. 7. Click Close. 8. Repeat Steps 3 to 7 for each Mobile Application Profile you need to edit. Reviewing a filter document There are filter documents associated with the application. These documents specify the data that will be sent to a handheld device. The application developer can ensure that a filter document has a default view or folder by modifying the application s filter template. As administrator, you need to check that the view field in the filter document contains a value, and set whether or not users can edit the filter document. You can also create a new filter document. For more information about filter document fields, see The Domino Everyplace Enterprise Mobile Application Developer s Guide. To review a filter document 1. In the DEES Administration database, click Filters in the view pane. 2. Click the filter document that you want to review, and then click Edit Document. 3. In the Views field, check that the name of the view or folder has been entered. If this field is empty, contact the application developer to obtain the name you need to enter. Domino Everyplace Enterprise Server Administrator s Guide 13
Note If the Views field is empty, data can only be synchronized in one direction. Users will not be able to synchronize any documents from the server to the handheld device for that application. However, documents can be can synchronized from the handheld device to the server. 4. (Optional) In the Can user edit filter field, do one of the following: If you don t want users to edit the filter document, select No. If you want users to edit the filter document, keep the default Yes setting. 5. Click Save. 6. Click Close. 7. Repeat Steps 2 to 6 for each filter document you need to review. 8. Go to Enabling an application. Information to provide to your mobile users Your mobile users need the following information to successfully configure their handheld devices to synchronize with the server: The TCP/IP address of the Domino Everyplace Enterprise Server that has access to the mobile applications. Note that the host name of the server will not work. The port number, whether the default port of 80 or some other port number. The port number is the one specified for the port on the Internet Protocols - Domino Web Engine tab of the Server document. (Pocket PC only) The URL to install the encryption library. The Domino Everyplace Log The Domino Everyplace Enterprise Server generates a synchronization log for each synchronization session with a handheld device, and stores the log in the Domino Everyplace Log file (DESLog.nsf) on the server. Note The Domino Everyplace Log file ACL has a -Default- setting of No access, and gives Manager access to the DEESAdmin group. Make sure that you add anyone who needs Manager access to the log file to the DEESAdmin group in the Domino Directory. If you want mobile users to be able to check the log themselves, you need to create a group for this purpose and set its access to Reader. 14 Domino Everyplace Enterprise Server Administrator s Guide
Since the status message on the device is much abbreviated from the server log entry, a user should also provide the administrator with the device ID or user name and the time a problem occurred in order to help identify the log entry that corresponds to the problem. The following table lists the error codes that the user sees in the device s status dialog box during synchronization and then lists the corresponding messages that the administrator sees in the log file. For example, for error 602, the user might see Communication error -602 Synchronization ended, while the log file would indicate the reason synchronization failed. The last two columns of the table provide descriptions and solutions. Error codes 300.00 301.00 302.00 303.00 605.00 606.00 607.00 608.00 699.00 304.00 609.00 Error message Failed to open adapter Failed to load adapter Failed to close adapter Sync Engine setup failed Failed to receive acknowledgment Failed to open Net library Failed to load Net library Failed to close Net library Unknown network error Authentication failed - synchronization aborted Failed to resolve host name Description Internal error codes that provide diagnostic information. The codes indicate an installation problem, such as a missing component or a component that does not work properly. Incorrect server preferences settings. Server TCP/IP address entered in the server preferences cannot be found. Solution Delete the Mobile Notes files from the handheld device, then reinstall Mobile Notes. Note Error 606 may indicate a network connection error. Make sure that you are connected to the network, then synchronize with the server again. This error can occur if you remove the handheld device from the cradle while synchronizing. User or short name and/or Internet password were entered incorrectly. Check the server preferences for the user name and password settings. Check the TCP/IP address. continued Domino Everyplace Enterprise Server Administrator s Guide 15
Error codes Error message Description Solution 600.00 601.00 602.00 603.00 Failed to open connection Failed to establish connection Failed to send request Failed to receive reply Communication errors that result when: Network is unstable or busy Server is busy or not responding Check the network connection, then try again. 604.00 Time out while receiving reply 58004.00 Internal component error Internal error code that indicates a component is not working properly. Attempt to solve the problem as follows. If Step 1 doesn t work, proceed to Step 2, and so on. 1. Reopen the mobile application and try again. 2. Restart Mobile Notes and try again. 3. Restart the device and try again. 4. Remove the application from the device, reload the application, and try again. Installing the encryption library (Pocket PC only) Mobile Notes supports encryption of all data transmitted between the Mobile Notes client running on the handheld device and a Domino Everyplace Enterprise server. For Pocket PC devices, the Microsoft High Encryption Pack for Pocket PC Version 1.0 must be installed in order to enable this encryption feature. The Microsoft High Encryption Pack for Pocket PC is available from the download section of Microsoft s Pocket PC homepage http://www.pocketpc.com. If you want to encrypt data, the Microsoft Encryption Pack for Pocket PC must be installed before the Mobile Notes synchronization session is started. 16 Domino Everyplace Enterprise Server Administrator s Guide
If the user wants to do Transport encryption, the user must enable it on their device. To enable Transport encryption 1. Select Mobile Notes - Sync - Communications Preferences on the Pocket PC. 2. Select Enable. Note If this is the first time Transport encryption is enabled, select the Get New Key as well. 3. Select OK. Assigning an additional application to established users After you have configured users by creating their Device Profiles, you can assign an additional mobile application to single or multiple users at any time by editing the Mobile Application Profile. Tip For a single user, you can also assign one or more additional applications by editing the user s Device Profile. 1. In the DEES Administration database, expand the Applications section in the view pane. 2. Click By Name. 3. Click the name of the application, and then click Edit Document. 4. On the Assignment tab, click Add Application to Assigned User(s). 5. In the Domino Directory field, click Choose Domino Directory and specify the Domino Directory of the user or users to whom you are assigning the additional application. Note If the users are in different Domino Directories, you must complete Steps 5 through 7 for users in one directory, and then repeat Steps 5 through 7 for users in the other directory. 6. In the Assigned User(s) field, click the down arrow, and specify the user or users to whom you are assigning the additional application. 7. Click Save. 8. Click Close. Domino Everyplace Enterprise Server Administrator s Guide 17
Removing an application from users' catalogs You can remove mobile applications from the list of applications assigned to one or more users devices by editing the Mobile Application Profile. Tip For a single user, you can also remove one or more applications by editing the user s Device Profile. 1. In the DEES Administration database, expand the Applications section in the view pane. 2. Click By Name. 3. Click the name of the application you want to remove, and then click Edit Document. 4. On the Assignment tab, click Remove Application from Assigned User(s). 5. In the Domino Directory field, click Choose Domino Directory and specify the Domino Directory of the user or users from whose catalog you are removing the application. Note If the users are in different Domino Directories, you must complete Steps 5 through 7 for users in one directory, and then repeat Steps 5 through 7 for users in the other directory. 6. In the Assigned User(s) field, click the down arrow, and specify the user or users from whose catalog you are removing the application. 7. Click Save. 8. Click Close. Deleting an application profile from the DEES Administration database When you remove a Mobile Application Profile from the DEES Administration database, you can choose whether to also remove it from all of the Device Profiles which reference it. You might want to retain an application in Device Profiles if you will soon be replacing the deleted application profile with one for an upgraded application with the same name. To delete a Mobile Application Profile 1. In the DEES Administration database, expand the Applications section of the view pane. 2. Click By Name, and then click the name of the application you want to remove. 3. Choose Edit - Clear. 18 Domino Everyplace Enterprise Server Administrator s Guide
4. Do one of the following: If you want to remove the application from all device profiles that reference it, click Yes. If you want the application to remain in all device profiles that reference it, click No. Note If change your mind, you can choose Edit - Undo Delete and the application profile will not be deleted from the Administration database. 5. Press F9 to refresh the view and delete the application profile. Resolving synchronization conflicts As the DEES administrator, you need to periodically scan any Domino applications assigned to mobile users for synchronization conflicts and then resolve them. A synchronization conflict occurs when two or more Notes users (either mobile users or users at workstations) edit the same document in an application and synchronize or save the application. Mobile users can also cause conflicts when they attempt to modify documents on their devices that contain less information than the server version of the document. Note Because conflicts must be resolved manually and because trying to resolve them can lead to further conflicts, it is best to design mobile applications so that conflicts can be avoided altogether. For more information, see the Domino Everyplace Enterprise Mobile Application Developer s Guide. How Domino Everyplace Enterprise treats synchronization conflicts After two or more users save or synchronize the same document, Domino Everyplace Enterprise designates the one that was saved first (the one on the server) as the main document, since the server version usually contains more complete information. A separate conflict document that contains the updates from the handheld device is created in the application on the server, and the mobile user is notified of the conflict. To resolve a synchronization conflict To resolve a conflict, you can manually save information from the conflict document to the server document and then delete the conflict document, or just delete the conflict document. 1. From your Notes workspace or the Domino Administrator, open the conflict document. 2. Do one of the following: Domino Everyplace Enterprise Server Administrator s Guide 19
To save any information from the conflict document, select the information and choose Edit - Copy. To delete the conflict document, go to Step 6. 3. Open the server document in Edit mode. 4. Place the cursor where you want the information and choose Edit - Paste. 5. Choose File - Save to save the server document. 6. Select the conflict document. 7. Choose Edit - Clear or press DELETE. 8. Press F9 to refresh the view and delete the conflict document. 20 Domino Everyplace Enterprise Server Administrator s Guide
Index A ACL DEES Administration database, 3 Domino Everyplace Log, 14 mobile applications and, 7 roles, 7 Applications enabling, 9 Authentication single sign-on and, 3 C Configuration documents overview, 8 Web SSO Configuration document, 3 Configuring mobile applications, 8 mobile users, 9, 14 Conflicts resolving, 19 D Databases DEES Administration, 3, 5 DEES described, 2 overview, 2 DEES Administration database ACL, 3 overview, 5 Device Profile Templates creating, 11 Device Profiles changing filters in, 12 creating, 10 Documents Web SSO Configuration document, 3 Domains Device Profile Template for, 11 Domino applications relationship to mobile applications, 6 Domino Directory specifying in the Device Profile Template, 11 Domino Everyplace Enterprise Mobile Application Designer described, 1 Domino Everyplace Enterprise Server. See DEES, 2 Domino Everyplace Log file ACL, 14 using, 14 Domino servers DEES requirements for, 3 using DEES on more than one server, 6 E Editing Mobile Application Profiles, 12 Enabling applications, 9 Encryption single sign-on feature and, 3 Error codes described, 15 F Filter documents Reviewing, 13 Filters changing, 12 G Groups assigning mobile applications to, 9, 17 removing applications from, 18 I Installing DEES, 4 Encryption library, 16 L Log file using, 14 M Mobile Application Profiles deleting, 18 Editing, 12 Mobile applications ACL, 7 assigning, 9, 17 configuring, 8 designing and deploying overview, 6 removing from users' catalogs, 18 Mobile Notes described, 2 Mobile users assigning additional mobile applications to, 17 assigning applications to, 9 information needed to configure devices, 14 removing applications from, 18 P Profiles for devices, 10, 12 for mobile applications, 18 R Reviewing Filter documents, 13 21
S Single sign-on for mobile users, 3 Synchronization conflicts from, 19 errors during, 15 T Troubleshooting synchronization errors, 15 U Users. See Mobile users, 14 22 Domino Everyplace Enterprise Server Administrator s Guide