Installing the Handheld Clients

ZENworks Handheld Management provides IP clients for Windows CE and Palm OS devices that can make TCP/IP connections, a RIM BlackBerry Client, and Desktop Synchronization software for handheld devices that use Palm HotSync or Microsoft ActiveSync to synchronize.

The following sections contain additional information:


Installing the Windows CE IP Client

ZENworks Handheld Management provides an IP client for Windows CE that can make TCP/IP connections.

The Windows CE IP client supports multiple types of Windows CE devices. ZENworks Handheld Management provides a wizard that creates CAB files for all supported devices. The appropriate CAB file must then be installed on the device.

When running the wizard, you will be prompted for the name of the computer (or IP address) of the ZENworks Handheld Management Server or the computer with the Access Point installed.

The computer name or IP address is built into the CAB file so that when the CAB file is installed on the handheld device, it is ready to communicate.

NOTE:  If Windows CE devices use Microsoft ActiveSync on a computer that has the Access Point or Desktop Synchronization software installed, the appropriate CAB file is configured and automatically installed on the device when you synchronize the Windows CE device using ActiveSync. In this situation, the following procedure is not necessary. For more information, see Access Point and Desktop Synchronization Integration Software.

To create CAB files for the Windows CE IP client:

  1. Insert the ZENworks Handheld Management CD in the CD drive.

    The installation program will autorun. If it does not, run winsetup.exe from the root of the CD.

  2. Click Handheld Management.

  3. Click English.

  4. Click Handheld Clients, then click Windows CE IP Client.

  5. Click Next.

  6. Review the destination location where the installation program will install the Windows CE IP client (browse to a different location, if desired), then click Next.

  7. In the Access Point text box, type the computer name or IP address of the server or computer to which your handheld devices will connect (where the Access Point is installed).

    You can leave this text box empty if you want to configure this setting on the handheld device.

    If you are using an IP address to specify the location of the ZENworks Handheld Management Server or Access Point computer, the IP address should remain constant (for example, it doesn't change because of DHCP).

  8. (Optional) Select the Enable HTTP Encapsulation check box.

  9. (Optional) Select the Enable SSL check box, then check the Accept Next Root Certificate from Access Point (And Then Disable) check box, if desired.

    You can also configure the Access Point settings (HTTP, SSL, and ports) using the cfgip.exe program (in the /program files/novell/zfhap directory, by default). If you select the Publish Root Certificate for Client Download check box using cfgip.exe, the root certificate will be automatically downloaded. For this root certificate to be accepted, you must select the Accept Next Root Certificate from Access Point (And Then Disable) check box.

  10. (Optional) If you want to change the default port that ZENworks Handheld Management uses, deselect the Use Default Port check box, then type the desired port number in the Port text box.

    If you change the default port number, you must also change it at the computer where the IP conduit is installed.

  11. Click Next.

  12. (Optional) Select the Create Shortcut to the Client Console on CE Device check box, then click Next.

  13. Review the information on the Start Copying Files page, then click Next.

  14. Click Finish.

The wizard will create CAB files for the following types of devices and copy them to the program files\novell\zfh ceipclient directory by default:

Device Type CAB File to Install

CE 3.0 (Handheld 2000) client for ARM-based Handheld PCs

zfhipclientforce.hpc2000_arm.cab

CE 3.0 (Handheld 2000) client for MIPS-based Handheld PCs

zfhipclientforce.hpc2000_mips.cab

CE 2.11 client for SH3-based Handheld PCs

zfhipclientforce.hpc211_sh3.cab

CE 2.11 client for ARM-based Handheld PCs

zfhipclientforce.hpc211_arm.cab

CE 2.11 client for MIPS-based Handheld PCs

zfhipclientforce.hpc211_mips.cab

MIPS-based Pocket PC 2000s (some Cassiopeia models)

zfhipclientforce.ppc_mips.cab

SH3-based Pocket PC 2000s (some Jornada models)

zfhipclientforce.ppc_sh3.cab

ARM-based Pocket PCs (iPAQ and all PPC2002 models)

zfhipclientforce.ppc_arm.cab

Pocket PCs running Windows Mobile 2003

zfhipclientforce.ppc2003_arm.cab

To install the Windows CE IP client:

  1. Find the CAB file appropriate for your device in the directory where the CAB files were created (program files\novell\zfh ceipclient by default).

  2. Copy the CAB file to the device, using the method most appropriate for your environment (for example, Microsoft ActiveSync).

  3. After the CAB file is on the device, run it by clicking it.

    The Windows CE IP client is installed on the handheld device.


Installing the Palm OS IP Client

If you have Palm OS devices that can make a TCP/IP connection, you can install the ZENworks Handheld Management Palm OS IP client on each device.

To install the Palm OS IP client:

  1. Insert the ZENworks Handheld Management CD in the CD drive.

    The installation program will autorun. If it does not, run winsetup.exe from the root of the CD.

  2. Click Handheld Management.

  3. Click English.

  4. Click Handheld Clients, then click Palm OS IP Client.

  5. Click Next.

  6. Review the destination location where the installation program will install the Palm OS IP client (browse to a different location, if desired), then click Next twice.

  7. In the Handheld Configuration page, type the computer name or IP address of the ZENworks Handheld Management Server (or the computer on which you installed the Access Point).

    If you are using an IP address to specify the location of the ZENworks Handheld Management Server (or Access Point, if it is installed on a computer other than the server), the IP address of the computer should remain constant (for example, it doesn't change because of DHCP).

  8. (Optional) Select the Enable HTTP Encapsulation check box.

  9. (Optional) Select the Enable SSL check box.

  10. (Optional) If you want to change the default ports that ZENworks Handheld Management use, deselect the Use Default Ports check box, then type the desired port number in the TCP Port and SSL Port text boxes.

    If you change these port numbers, you must also change them at the computer where the Access Point is installed (the ZENworks Handheld Management Server or the computer on which you installed the Access Point).

  11. Click Next.

  12. In the Connections Options page, fill in the fields:

    Client Should Auto Connect to Server: Select an option from the drop-down list:

    • Never: The Palm OS IP client never automatically connects. The user must manually connect the Palm OS IP client by clicking the ZENworks Handheld Management Console icon on the Palm OS device, then clicking Connect Now.

    • When IP Connection Exists: The Palm OS IP client automatically connects whenever an IP connection exists and it is time to connect.

      For example, if the device is cradled using an Ethernet cradle, the device has Bluetooth* running on the device, or if the device dials up using a modem, and it is time to connect (as specified in the Client Should Connect Every option), the Palm OS IP client automatically connects.

    • Always: The Palm OS IP client tries to establish an IP connection and connect to the IP conduit automatically if it is time to connect.

    Client Should Connect Every: Specify how often (in hours or minutes) the Palm OS IP client should connect.

    At Connection Time, Display to User: Specify an option from the drop-down list:

    • Nothing (Just Connect): The Palm OS device user sees a visual indication that the Palm OS IP client has connected, but the user is not be prompted to do anything.

    • Flashing Icon (Subtle): A flashing icon displays on the Palm OS device when it is time to connect. The user can connect by clicking the reminder icon and then clicking OK.

    • Dialog: A dialog box displays on the Palm OS device whenever it is time to connect. The user can connect by clicking Connect.

    • Dialog With Timeout: A dialog box with a timeout value displays on the Palm OS device whenever it is time for the Palm OS IP client to connect. If the user does not respond by clicking Connect or Cancel during the timeout period, the Palm OS IP client connects.

      For example, if the device is cradled using an Ethernet cradle and you are away from your desk when it is time for the Palm OS IP client to connect, the Palm OS IP client waits until the timeout period has passed and then connects.

  13. If desired, click Advanced Settings, then fill in the fields:

    Connection Timeout (Seconds): The number of seconds you specify determines how long the Palm OS IP client tries to connect before it stops trying if a connection cannot be established.

    Session Timeout (Seconds): The number of seconds you specify determines the length of time that the Palm OS IP client stays connected. If the session reaches the limit you specify, the Palm OS IP client session terminates.

    For example, if you lose an IP connection, the Palm OS IP client session terminates after the number of seconds that you specify has passed.

    Connect Retry (Seconds): Specify the number of seconds that you want the Palm OS IP client to wait after a failed connection before trying to connect again.

    Maximum Connect Retries: Specify the maximum number of retry attempts you want the Palm OS IP client to attempt.

    Timeout (Seconds): Specify the number of seconds you want to allow before closing the alarm dialog box before trying to make the connection.

    Message: Type a message to be displayed on the Palm OS device when it is time for the Palm OS IP client to connect.

  14. Click OK.

  15. Click Finish twice.

    The wizard will create Palm OS IP client files and copy them to the program files\novell\zfh palm ip client directory by default.

Rather than running the ZENworks Handheld Management installation program to install the Palm OS IP client, you can also copy the contents of the program files\novell\zfh palm ip client directory to a Palm OS device using the HotSync Manager Install Tool.


Installing the RIM BlackBerry Client

The ZENworks Handheld Management RIM BlackBerry client is the software that manages BlackBerry devices that use the BlackBerry wireless platform.

NOTE:   If BlackBerry devices use RIM Desktop Manager on a computer that has the Access Point or Desktop Synchronization software installed, ZENworks Handheld Management automatically creates the necessary installation files for the RIM BlackBerry client and adds them to the BlackBerry Application Loader. In this situation, the following procedure is not necessary. For more information, see Access Point and Desktop Synchronization Integration Software.

To install the RIM BlackBerry client:

  1. Insert the ZENworks Handheld Management CD in the CD drive.

    The installation program will autorun. If it does not, run winsetup.exe from the root of the CD.

  2. Click Handheld Management.

  3. Click English.

  4. Click Handheld Clients, then click RIM BlackBerry Client.

  5. Click Next.

  6. Review the destination location where the installation program will install the RIM BlackBerry client (browse to a different location, if desired), then click Next twice.

    The RIM BlackBerry client files that will be copied to the destination location include two client .dll files: one file for devices that use the Mobitex network and one file for devices that use the DataTAC network. The copied files also include the .alx installation file that will be used by the BlackBerry Application Loader and the configuration application file.

    NOTE:  If your RIM Desktop Manager software is not at least version 2.1.3 (2.1 SP3), it might not recognize .alx files. If this is the case, you must use the BlackBerry Application Loader to copy the appropriate .ali file to your BlackBerry devices (zfhbbmtexclient.ali for the Mobitex network or zfhbbdtacclient.ali for the DataTAC network). The two .ali files are found in the \blackberryclient directory on the ZENworks Handheld Management CD.

  7. Type the service user's e-mail address to be used by the BlackBerry client software that you specified in Step 28.

  8. Click Finish.

    The installation program copies the RIM BlackBerry IP client files to the program files\novell\zfhblackberryclient directory.

  9. In the InstallShield Wizard Complete page, click Add Client to BlackBerry's Application Loader to have ZENworks Handheld Management automatically add the necessary files to the BlackBerry Application Loader.

    You should enable the Add Client to BlackBerry's Application Loader option if you are running the BlackBerry Client installation wizard from the machine on which the BlackBerry device synchronizes

  10. Click Finish.


Installing Desktop Synchronization Integration Software

You must install the ZENworks Handheld Management Desktop Synchronization Integration software on users' desktops if:

IMPORTANT:  When you install ZENworks Handheld Management Server using the installation program, the ZENworks Handheld Management Desktop Synchronization Integration software is automatically installed on the same computer.

To install the Desktop Synchronization Integration software:

  1. Insert the ZENworks Handheld Management CD in the CD drive on a user's computer.

    The installation program will autorun. If it does not, run winsetup.exe from the root of the CD.

  2. Click Handheld Management.

  3. Click English.

  4. Click Handheld Clients, then click Desktop Synchronization Integration Software.

  5. Click Next.

  6. Read the License agreement, then click Yes if you agree with the terms of the License Agreement.

    If you do not agree with the terms of the license agreement, do not install the software.

  7. Review the destination location where the installation program will install the Desktop Synchronization Integration software, then click Next.

    By default, the installation program copies the files to the program files\novell\zfhds directory.

  8. Type the username and company information, then click Next.

  9. Ensure that the components that you want to install are selected, then click Next.

  10. Type the name or IP address of the computer where the ZENworks Handheld Management Server is installed, then click Next.

    If you are using an IP address, the IP address of the computer where the ZENworks Handheld Management Server is installed should remain constant (for example, it doesn't change because of DHCP).

    If you are using a DNS or computer name, be sure your handheld devices can resolve the name if the devices are being cradled and using a third-party synchronization package.

  11. Type the name or IP address of the computer where the Access Point is installed (the ZENworks Handheld Management Server or the computer on which you installed the Access Point).

    If you are using an IP address to specify the location of the computer that the Access Point is installed on, the IP address should remain constant (for example, it doesn't change because of DHCP).

    If you are using a DNS or computer name, be sure your handheld devices can resolve the name if the devices are being cradled and using a third-party synchronization package.

  12. (Optional) Select the Enable HTTP Encapsulation check box.

  13. (Optional) Select the Enable SSL check box, then select the Accept Next Root Certificate from Access Point (And Then Disable) check box, if desired.

    You can also configure the Access Point settings (HTTP, SSL, and ports) using the cfgip.exe program (in the /program files/novell/zfhap directory, by default). If you select the Publish Root Certificate for Client Download check box using cfgip.exe, the root certificate is automatically downloaded. In order for this root certificate to be accepted, you must select the Accept Next Root Certificate from Access Point (And Then Disable) check box.

  14. (Optional) If you want to change the default port that ZENworks Handheld Management uses, deselect the Use Default Port check box, then type the desired port number in the Port text box.

    If you change this port number, you must also change the port number at the computer where the Access Point is installed (the ZENworks Handheld Management Server or the computer on which you installed the Access Point).

  15. Click Next.

  16. Review the information in the Start Copying Files page, then click Next.

  17. After the files are copied, ensure that the Start Desktop Sync check box is selected, then click Finish.