Installing ZENworks for Handhelds

After you have performed the steps in Performing Pre-installation Tasks, you are ready to install the ZENworks for Handhelds software.

The following sections provide detailed information about installing ZENworks for Handhelds:


Installing the ZENworks for Handhelds Server

  1. Insert the ZENworks for Handhelds CD in the CD drive on a Windows NT/2000/XP machine where you want to install the ZENworks for Handhelds server.

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


    Screen shot of the ZENworks for Handhelds Installation window.

  2. Click Server Installation Options.


    Screen shot of the ZENworks for Handhelds Server Installation window.

  3. Click Server Installation, then click Next.

  4. 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.

  5. Review the destination location where the installation program will install the ZENworks for Handhelds server software (browse to a different location, if desired), then click Next.


    Screen shot of the Select Components window.

  6. On the Select Components window, select the components you want to install:

    • Novell ConsoleOne Snap-In: Extends ConsoleOne functionality to allow you to manage handheld devices. This option is enabled by default. You should have previously installed ConsoleOne 1.3.3 or newer on at least one workstation or server before you install the ZENworks for Handhelds server. For more information, see Installing ConsoleOne.

    • RIM BlackBerry Device Support: Adds support for managing RIM BlackBerry devices. If you select this option, you must have set up a MAPI profile for e-mail access. For more information, see Creating a MAPI Profile (BlackBerry Device Support Only).

  7. Click Next.

  8. On the Start Copying Files window, review the settings, then click Next.

  9. On the InstallShield Wizard Complete window, check the Display Readme File check box to review the Readme file for installation notes and product issues that you need to know as you install and use ZENworks for Handhelds, then click Finish.

  10. Click Next.

  11. Select Internal ODBC-Compatible Database if you want ZENworks for Handhelds to create a database for you.

    or

    Select Microsoft SQL Server, specify the machine name, specify the database name, then click OK.

    In order to use an SQL database, SQL Server must already be installed.

    NOTE:  If you are currently using ZENworks for Desktops, you cannot extend the ZENworks for Desktops database to include the handheld inventory information; the inventory databases for ZENworks for Handhelds and ZENworks for Desktops are currently separate.

  12. In the Service User window, specify the domain name, account name, and password for the account that you created in Creating the ZENworks for Handhelds Server's Windows User Account , then click Next.

  13. In the Directory User Information window, specify the server name where eDirectory is installed, the username, and password for the account that you created in Creating the Service Object's User Account, then click Next.

    NOTE:  The user needs rights to create the service object in the container you specify and rights to create handheld objects and to access application and policy objects in the tree. Browse to the user in the tree and specify the full context name.

  14. If you want to access objects or store retrieved files on a NetWare volume: in the NetWare Access window, select Enable Access to NetWare, specify the tree, then click Next.

  15. Select the container where you want the Service object created, then click Next.

    To browse to a container you must have a valid LDAP user configured.

  16. Click Next twice.

  17. If you chose to enable RIM BlackBerry support, type the service user's e-mail address to be used by the BlackBerry client software, then select the MAPI profile that you created in Creating a MAPI Profile (BlackBerry Device Support Only).

  18. Click Finish.


Installing the Proxy Service and the Handheld Client

Before installing the proxy service, log in as the primary user to the computer that a handheld device synchronizes with.

The proxy service software runs on any computer running Windows 95 and above that communicates via TCP/IP with the ZENworks for Handhelds server.

If you are installing the proxy service on a Windows NT/2000/XP computer, you must log in as a member of the Administrators group.

The following sections contain additional information:


Installing the Proxy Service

  1. Insert the ZENworks for Handhelds CD in the CD drive.

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


    Screen shot of the ZENworks for Handhelds Installation window.

  2. Click Proxy Service Installation.

  3. On the Welcome page, click Next.

  4. 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.

  5. Select the destination location for the ZENworks for Handhelds proxy service, then click Next.

  6. On the Customer Information page, enter the user's user and company name, if necessary, then click Next.

  7. On the Select Components page, select Handheld IP conduit if you will be installing the IP client on Palm OS and Windows CE devices that can connect using TCP/IP, then click Next.

  8. Type the computer name or IP address of the machine where the ZENworks for Handhelds server is installed, then click Next twice.

  9. If prompted, restart your computer before continuing.

    The ZENworks for Handhelds proxy service will start automatically after restarting your computer. On Windows NT/2000/XP computers, the proxy will start as a service.

  10. Click Finish.

The first time that the proxy service computer connects to the network using TCP/IP, a registration message is sent to the ZENworks for Handhelds server.

NOTE:  You can install the proxy service software on users' desktop or laptop machines using ZENworks for Desktops (ZfD) Application Management. Additionally, you can populate the proxy.ini file with the appropriate settings so that you can perform silent (unattended) installations of the proxy service. For more information, see Installing the ZENworks for Handhelds Proxy Service Using a ZENworks for Desktops Silent Install.


Installing the Handheld Client

When the ZENworks for Handhelds proxy service starts on the Windows computer, the proxy service will check for the existence of synchronization software for Palm OS and Windows CE devices. If synchronization software is detected, the proxy service will install the handheld client and ensure that the handheld client and conduit to the proxy service computer are available for the handheld device and synchronization software.

After the sync client is installed on the handheld device, you might need to configure the synchronization software so it recognizes the conduit.

NOTE:  If the sync client is manually deleted from the handheld device, it will be automatically re-installed the next time the device is synchronized.

For BlackBerry devices, you must install the BlackBerry handheld client (bbclient.alx) using the BlackBerry Application Loader. By default, bbclient.alx is found in the program files\novell\zfh\bbclient directory.


Palm HotSync Manager, Microsoft ActiveSync, and Pumatech Intellisync

If you are using Palm HotSync Manager, Microsoft ActiveSync, or Pumatech Intellisync software, the conduit to the proxy service computer is installed automatically by the proxy service.

The proxy service detects the synchronization software and installs the sync client software on the handheld device the first time the handheld device synchronizes after the proxy service is installed.

The next time the handheld device synchronizes, the device is registered and is assigned a unique ID by the proxy service.

When the proxy service computer connects to the ZENworks for Handhelds server, the handheld device object appears in ConsoleOne.


Installing the IP Conduit and ZENworks for Handhelds IP Client

The ZENworks for Handhelds IP client connects directly to the IP conduit on the proxy service computer, allowing management of Palm OS and Windows CE devices without requiring any third-party synchronization software.

If you have Palm OS and Windows CE devices that can connect via TCP/IP, you can use the appropriate ZENworks for Handhelds IP client.

IMPORTANT:  Handheld PCs require the WinCE IP client; they cannot use the sync client. Pocket PCs can use either the IP client or the sync client.

The ZENworks for Handhelds BlackBerry IP client is the software that manages BlackBerry devices that use the BlackBerry wireless platform.

The following sections contain additional information:


Installing the IP Conduit

Choose a computer where your handheld devices can connect via TCP/IP, and install the proxy service software on that computer. See Installing the Proxy Service and the Handheld Client for more information.

When you are installing the proxy service software, select Handheld IP Server in the Select Components window to install the IP conduit software. To configure the conduit properties, see Configuring the IP Conduit.


Installing the ZENworks for Handhelds Palm IP Client

If you have Palm OS devices that can make an TCP/IP connection, you should install the ZENworks for Handhelds IP client for Palm OS devices on each device.

To install the ZENworks for Handhelds Palm IP client:

  1. Insert the ZENworks for Handhelds CD in the CD drive.

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

  2. Click Handheld Client Agents, then click Palm IP Client.

  3. Click Next.

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

  5. On the Handheld Configuration window, type the computer name or IP address of the ZENworks for Handhelds server, then click Next.

    If you are using an IP address to specify the location of the IP conduit, the IP address of the computer where the IP conduit 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.

    By default, ZENworks for Handhelds uses TCP/IP port number 2400. If you change this, you must also change it at the computer where the IP conduit is installed.

  6. On the Connections Options window, fill in the fields:

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

    • Never: The ZENworks for Handhelds IP client will never automatically connect. The user must manually connect the IP client by clicking the ZfHConsole icon on the Palm device, then clicking Connect Now.

    • When IP Connection Exists: The Palm IP client will automatically connect 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 IP client will automatically connect.

    • Always: The Palm IP client will try 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 IP client should connect to the IP conduit.

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

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

    • Flashing Icon (Subtle): A flashing icon will display 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 will display 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 will display on the Palm OS device whenever it is time for the Palm IP client to connect. If the user does not respond by clicking Connect or Cancel during the timeout period, the IP client will connect.

      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 IP client to connect, the IP client will wait until the timeout period has passed and then connect.

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

    Connection Timeout (Seconds): The number of seconds you specify determines how long the Palm IP client will try 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 IP client will stay connected. If the session reaches the limit you specify, the Palm IP client session will terminate.

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

    Connect Retry (Seconds): Specify the number of seconds that you want the Palm 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 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: Enter a message to be displayed on the Palm OS device when it is time for the Palm IP client to connect.

    1. Click OK.

  8. Click Finish twice.

Rather than running the ZENworks for Handhelds installation program to install the Palm 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 ZENworks for Handhelds WinCE IP Client

The ZENworks for Handhelds IP client supports multiple types of Windows CE devices. ZENworks for Handhelds 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) where the IP conduit is 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 with the IP conduit.

To create CAB Files for the ZENworks for Handhelds IP client:

  1. Insert the ZENworks for Handhelds CD in the CD drive.

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

  2. Click Handheld Client Agents, then click WinCE IP Client.

  3. Click Next.

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

  5. When prompted, type the computer name or IP address of the ZENworks for Handhelds IP conduit that the handheld device should connect to.

    If you are using an IP address to specify the location of the IP conduit, the IP address of the computer where the IP conduit 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.

    By default, ZENworks for Handhelds uses TCP/IP port number 2400. If you change this, you must also change it at the computer where the IP conduit is installed.

  6. Click Next.

  7. On the Choose Options window, click the Create Shortcut to the Client Console on CE Device, if desired, then click Next.

  8. Review the information on the Start Copying Files window, then click Next.

  9. Click Finish.

The wizard will create CAB files for the following types of devices and copy them to the program files\novell\zfh\ipclientcabs 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

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

zfhipclientforce.ppc_arm.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

To install the ZENworks for Handhelds IP client:

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

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

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

    The ZENworks for Handhelds IP client will be installed on the handheld.


Installing the ZENworks for Handhelds BlackBerry Client

The ZENworks for Handhelds BlackBerry client is the software that manages BlackBerry devices that use the BlackBerry wireless platform.

To install the ZENworks for Handhelds BlackBerry client:

  1. Insert the ZENworks for Handhelds CD in the CD drive.

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

  2. Click Handheld Client Agents, then click BlackBerry Client.

  3. Click Next.

  4. Review the destination location where the installation program will install the ZENworks for Handhelds BlackBerry IP client (browse to a different location, if desired), then click Next twice.

    The ZENworks for Handhelds BlackBerry IP 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 for Handhelds CD.

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

  6. Click Finish.

    The installation program will copy the ZENworks for Handhelds BlackBerry IP client files to the program files\novell\zfhblackberryclient directory.

  7. On the InstallShield Wizard Complete window, click the Add ZfH BlackBerry Client to BlackBerry's Application Load to have ZENworks for Handhelds automatically add the necessary files to the BlackBerry Application Loader.

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


Installing ConsoleOne Snap-Ins on a Remote ConsoleOne Installation

ConsoleOne and the ZENworks for Handhelds ConsoleOne snap-ins can be installed on any number of machines so that you can give other administrators or help desk staff access to ZENworks for Handhelds from multiple locations on your network.

To install the ConsoleOne snap-ins on a remote ConsoleOne installation:

  1. On the machine that you installed the ZENworks for Handhelds server software, create a share to the installation directory.

    The default location is c:\program files\novell\zfh.

  2. On a machine where ConsoleOne is installed, insert the ZENworks for Handhelds CD in the CD drive.

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

  3. Click Remote ConsoleOne Snap-in Installation, then follow the instructions in the wizard.