Page 2
Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.
Page 3
Novell Trademarks ConsoleOne is a registered trademark of Novell, Inc., in the United States and other countries. eDirectory is a trademark of Novell, Inc. GroupWise is a registered trademark of Novell, Inc., in the United States and other countries. NetWare is a registered trademark of Novell, Inc., in the United States and other countries.
Novell ZENworks 7 Handheld Management Administration Guide. Documentation Conventions In Novell documentation, a greater-than symbol (>) is used to separate actions within a step and items in a cross-reference path. ® A trademark symbol ( , etc.) denotes a Novell trademark. An asterisk (*) denotes a third-party trademark.
Page 8
When a single pathname can be written with a backslash for some platforms or a forward slash for other platforms, the pathname is presented with a backslash. Users of platforms that require a forward slash, such as Linux or UNIX, should use forward slashes as required by your software. Novell ZENworks 7 Handheld Management Installation Guide...
ZENworks 7 Handheld Management is part of the Novell ZENworks 7 product suite, which also includes ZENworks Desktop Management and ZENworks Server Management. ZENworks products provide directory-enabled life cycle management for all of your network components.
ZENworks Handheld Management provides the following types of policies: User-based policies: Lets you manage handheld devices based on user credentials stored in eDirectory. Handheld-based policies: Lets you manage handheld devices without user authentication. Novell ZENworks 7 Handheld Management Installation Guide...
Page 11
Windows CE devices using the Palm Security and Win CE security policies respectively. Perform Remote Control or Remote View operations on the Windows CE devices The administrator or remote users can remotely control or view the Windows CE devices using the WinCE Remote Management policy. What Is Novell Handheld Management?
ZENworks 7 Handheld Management Benefits Table 1-1 Benefit Description Centralized Software distributions are scheduled using ConsoleOne. The administrator scheduling specifies: The files to distribute When distributions should run When applications are installed How frequently distributions should run Novell ZENworks 7 Handheld Management Installation Guide...
The following sections provide an overview of the key components of ZENworks Handheld Management: Section 1.3.1, “ConsoleOne,” on page 14 Section 1.3.2, “ZENworks Handheld Management Server,” on page 14 Section 1.3.3, “Handheld Client,” on page 14 Section 1.3.4, “Access Point,” on page 14 What Is Novell Handheld Management?
The Desktop Synchronization Integration Software is also required on machines if you want to use ZENworks Handheld Management to distribute software to BlackBerry devices. The Desktop Synchronization Integration Software is required for Palm OS devices that do not support TCP/IP communications. Novell ZENworks 7 Handheld Management Installation Guide...
Page 15
When you install the ZENworks Handheld Management Server or the ZENworks Handheld Management Access Point using the installation program, the ZENworks Handheld Management Desktop Synchronization Integration Software is automatically installed on the same computer. What Is Novell Handheld Management?
Installing ZENworks Handheld Management ® ® The following sections describe how to plan for and install Novell ZENworks 7 Handheld Management software: Section 2.1, “Planning the Installation,” on page 17 Section 2.2, “Performing Pre-installation Tasks,” on page 20 Section 2.3, “Installing ZENworks Handheld Management Server Components,” on page 25 Section 2.4, “Installing the Handheld Clients,”...
30 MB of disk space at the time of installation A minimum of 128 MB of RAM ® The Novell Client if you want to access Novell NetWare volumes to store application data or retrieved files For step-by-step installation information, see Section 2.3.1, “Installing the ZENworks Handheld...
Section 2.4.3, “Installing the RIM BlackBerry Client,” on page Java-Based BlackBerry Client The Novell ZENworks 7 Handheld Management Agent for Java BlackBerry Devices is the software for extending ZENworks Handheld Management capabilities to Java-based Blackberry devices. The Novell ZENworks 7 Handheld Management Agent for Java BlackBerry Devices can be installed on BlackBerry 6000, 7000, and 8000 series devices.
The ZENworks Handheld Management Server requires a valid Windows user account that is a member of the Administrators group on the local machine in order to log in as a service and to access the ZENworks Handheld Management database and application data. Novell ZENworks 7 Handheld Management Installation Guide...
To create the server user account in the Administrators group: 1 On a supported Windows machine, log in as the Administrator or as a member of the Administrators group. 2 Click Start > Settings > Control Panel. 3 Double-click Users and Passwords. 4 Click Add.
Before running the schema extension tool, ensure that you are logged in to the tree that you want to extend. To extend the schema: 1 Insert the ZENworks 7 Handheld Management CD on a machine that has the Novell Client running. The installation program will autorun. If it does not, run from the root of the winsetup.exe...
Page 23
3 Click Schema Extension and Product Licensing. 4 On the Software License Agreement page, do the following: Installing ZENworks Handheld Management...
Page 24
4c Click Next. 5 On the eDirectory Tree for Creating Objects page, do the following: 5a Click to select the eDirectory tree for creating the objects. 5b Select the Extend Schema option. 5c Click Next. Novell ZENworks 7 Handheld Management Installation Guide...
6 Provide the license code, then click Next. If you do not provide the license code, you can use the product for only 90 days. 7 Review the installation summary. To make any changes, click Back. Click Finish to complete the schema extension and product licensing.
Page 27
5 (Conditional) The Choose Options page is displayed only when you want to reinstall, upgrade, or uninstall the Handheld Management Server component. Select any of the following options: Update: Upgrades the ZENworks Handheld Management Server component from ZENworks 6.5 Handheld Management to ZENworks 7 Handheld Management. Repair (Recopies all data): Recopies the ZENworks Handheld Management Server component.
Page 28
If you do not agree with the terms of the license agreement, do not install the software. 9 Review the destination location where the installation program will install the ZENworks Handheld Management Server software (browse to a different location, if desired), then click Next. Novell ZENworks 7 Handheld Management Installation Guide...
Page 29
10 On the Select Components page, 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.6 or later on at least one workstation or server before you install the ZENworks Handheld Management Server.
Page 30
NOTE: If the ZENworks Handheld Management Server is running on the same machine as Novell eDirectory, the ZENworks Handheld Management Server fails to start when enabling HTTP unless the HTTP port is changed. By default, eDirectory uses port 80, which is the same default port the ZENworks Handheld Management Server uses.
Page 31
In order to use an SQL database, SQL Server must already be installed. NOTE: If you are currently using ZENworks Desktop Management, you cannot extend the ZENworks Desktop Management database to include the handheld inventory information; the inventory databases for ZENworks Handheld Management and ZENworks Desktop Management are currently separate.
Page 32
Browse to the user in the tree and specify the full context name. 21 (Conditional) In the Product Activation dialog box, select the Activated option and provide a license code for the product. Novell ZENworks 7 Handheld Management Installation Guide...
Page 33
If you want to use the evaluation version of the product for 90 days, select Evaluation. 22 Click Next. 23 If you want to access objects or store retrieved files on a NetWare volume in the specified tree, select the Enable Access to NetWare option. 24 Click Next.
Page 34
Add, specify the container to add to the container list, then click OK. Select the Enable User Authentication option if you want to use user-based management rather than just using device-base management. 27 Click Next. Novell ZENworks 7 Handheld Management Installation Guide...
30 On the computer where you installed the ZENworks Handheld Management Server software, create a Read/Write share to the installation directory. The default location is c:\program files\novell\zfh 2.3.2 Installing the ZENworks Handheld Management Access Point on Additional Computers When you install the ZENworks Handheld Management Server using the installation program, the ZENworks Handheld Management Access Point is installed on the same computer.
Page 36
1 Insert the ZENworks 7 Handheld Management CD in the CD drive. The installation program will autorun. If it does not, run from the root of the winsetup.exe 2 Click Handheld Management. 3 Click Handheld Management Services. Novell ZENworks 7 Handheld Management Installation Guide...
Page 37
4 Click Access Point (Optional). 5 (Conditional) The Choose Options page is displayed only when you want to reinstall, upgrade, or uninstall the ZENworks Handheld Management Access Point. Installing ZENworks Handheld Management...
Page 38
7 (Optional) The Prerequisite Check option is selected by default. Retain the selection if you want the installation program to verify that the machines meet the installation requirements for the ZENworks Handheld Management Access Point component. Novell ZENworks 7 Handheld Management Installation Guide...
Page 39
The installation program checks the version of the machines’ operating system. If the operating system and support/service packs are not the correct version, the installation displays a warning and does not continue until the required software is installed and detected or until you deselect the option.
Page 40
The installation program copies the files to the destination location specified in Step 9 on page 14 On the InstallShield Wizard Complete page, do the following: 14a Ensure that the Start Access Point option is selected. Novell ZENworks 7 Handheld Management Installation Guide...
14b (Optional) Select the Configure Access Point HTTP and SSL Settings option. 15 (Conditional) If you select the Configure Access Point HTTP and SSL Settings option, see Appendix A, “Configuring SSL and HTTP Settings,” on page 81, then proceed to Step 16 on page 16 Click Finish.
Page 43
Handheld Management ConsoleOne snap-ins to it. If the installation program is unable to locate the directory, it copies the Handheld Management ConsoleOne snap-ins files to . If required, c:\program files\novell\zfh\consoleone\consoleone you can manually copy the contents of this directory to the ConsoleOne installation directory. Installing ZENworks Handheld Management...
To create CAB files for the Windows CE IP client: 1 Insert the ZENworks 7 Handheld Management CD in the CD drive. The installation program will autorun. If it does not, run from the root of the winsetup.exe 2 Click Handheld Management. Novell ZENworks 7 Handheld Management Installation Guide...
Page 45
3 Click Handheld Clients. 4 Click Windows CE IP Client. Installing ZENworks Handheld Management...
Page 46
(where the ZENworks Handheld Management Access Point is installed). You can leave this text box empty if you want to configure this setting on the handheld device. Novell ZENworks 7 Handheld Management Installation Guide...
Page 47
Access Point (And Then Disable) option, if desired. You can also configure the ZENworks Handheld Management Access Point settings (HTTP, SSL, and ports) using the program (in the /program files/novell/zfhap cfgip.exe directory, by default). If you select the Publish Root Certificate for Client Download option using , the root certificate is automatically downloaded.
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 7 Handheld Management CD in the CD drive. Novell ZENworks 7 Handheld Management Installation Guide...
Page 49
The installation program will autorun. If it does not, run from the root of the winsetup.exe 2 Click Handheld Management. 3 Click Handheld Clients. 4 Click Palm OS IP Client. Installing ZENworks Handheld Management...
Page 50
7 Review the information on the Start Copying Files page, then click Next. The installation program copies the files to the destination location specified in the previous step. 8 On the Handheld Configuration page, do the following: Novell ZENworks 7 Handheld Management Installation Guide...
Page 51
8a On 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 ZENworks Handheld Management Access Point). If you are using an IP address to specify the location of the ZENworks Handheld Management Server (or ZENworks Handheld Management 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).
Page 52
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. Novell ZENworks 7 Handheld Management Installation Guide...
The wizard creates Palm OS IP client files and copy them to the directory by default. program files\novell\zenworks palm ip client 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 directory to a Palm OS device using the HotSync Manager Install Tool.
Page 54
1 Insert the ZENworks 7 Handheld Management CD in the CD drive. The installation program will autorun. If it does not, run from the root of the winsetup.exe 2 Click Handheld Management. 3 Click Handheld Clients. Novell ZENworks 7 Handheld Management Installation Guide...
Page 55
4 Click RIM BlackBerry Client. 5 On the Welcome page, 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. 7 Review the information on the Start Copying Files page, then click Next. Installing ZENworks Handheld Management...
Page 56
9 Click Finish. The installation program copies the RIM BlackBerry client files to the program files\novell\zenworks blackberry client directory by default. 10 On 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.
1 Download the agent for Java BlackBerry device available with TID 2972388 to a temporary directory on a machine having RIM BlackBerry Desktop Manager software installed. For more information on TID 2972388, see the Novell Support Knowledgebase (http://www.novell.com/ support/). 2 Double-click the agent executable.
1 Insert the ZENworks 7 Handheld Management CD in the CD drive on a user’s computer. The installation program will autorun. If it does not, run from the root of the winsetup.exe 2 Click Handheld Management. Novell ZENworks 7 Handheld Management Installation Guide...
Page 60
Update: Upgrades the Desktop Synchronization Integration Software from ZENworks 6.5 Handheld Management to ZENworks 7 Handheld Management. Repair (Recopies all data): Recopies the Desktop Synchronization Integration Software. Uninstall: Uninstalls the Desktop Synchronization Integration Software. 6 On the Welcome page, click Next. Novell ZENworks 7 Handheld Management Installation Guide...
Page 61
NOTE: This page is displayed only during the new install of ZENworks Desktop Synchronization Integration Software. 7 (Optional) The Prerequisite Check option is selected by default. Retain the selection if you want the installation program to verify that the machine meets the installation requirements for the ZENworks 7 Desktop Synchronization Integration Software.
Page 62
11 Ensure that the components that you want to install are selected, then click Next. 12 Type the DNS name or IP address of the computer where the ZENworks Handheld Management Server is installed, then click Next. Novell ZENworks 7 Handheld Management Installation Guide...
Page 63
NOTE: This page is displayed only during the new install of ZENworks Desktop Synchronization Integration Software. 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).
Page 64
The installation program copies the files to the destination location specified in Step 9 on page 15 After the files are copied, ensure that the Start Desktop Sync option is selected, then click Finish. Novell ZENworks 7 Handheld Management Installation Guide...
Set up the policies that can be associated with handheld objects. For more information, see the ZENworks 6.5 Handheld Management Administration Guide (http://www.novell.com/ documentation/zenworks65). 2.5.1 Creating the Handheld Service Package A policy package is an eDirectory object containing one or more individual policies.
1 In ConsoleOne, right-click the Handheld Service Package object that is created during Section 2.5.1, “Creating the Handheld Service Package,” on page 65, then click Properties. 2 Select the check box under the Enabled column for the Handheld Import policy. Novell ZENworks 7 Handheld Management Installation Guide...
Page 67
You can modify the settings of the Import policy. For more information, see “Setting Up Handheld Import” in the Novell ZENworks 7 Handheld Management Administration Guide. 3 Click the Associations tab, then click Add. 4 To associate the package, browse for the ZENworks Handheld Management Service object, the container containing the Service object, or the container object created during the installation of ZENworks Handheld Management server components.
Integration Software Using a Silent Install ® ® In most Novell ZENworks 7 Handheld Management installations, you need to install only the ZENworks Handheld Management Server. The Handheld Management Server runs as a service on a supported Windows machine (server or workstation). The ZENworks Handheld Management Server...
Page 70
Windows platforms to setup.iss the proxy directory that you copied in Step 4 Copy the proxy directory to the network location from which it will be distributed. Novell ZENworks 7 Handheld Management Installation Guide...
Page 71
You can now run the file from the proxy directory in the network location to install the setup.exe ZENworks Handheld Management Access Point or Desktop Synchronization Integration Software on users’ desktop computers. To install the ZENworks Handheld Management Access Point, run setup.exe -s /accesspoint To install the Desktop Synchronization Integration, run setup.exe -s...
Upgrade ® In the following sections, the first section provides information about what’s new in Novell ® ZENworks 7 Handheld Management, and the other section provide instructions to upgrade from ZENworks 6.5 Handheld Management to ZENworks 7 Handheld Management: Section 4.1, “What’s New in This Release,” on page 73 Section 4.2, “Upgrading from ZENworks 6.5 Handheld Management,”...
For detailed information about configuring the Handheld Application object, see “Configuring a Handheld Application Object” in the Novell ZENworks 7 Handheld Management Administration Guide. Novell ZENworks 7 Handheld Management Installation Guide...
Before upgrading the ZENworks 6.5 Handheld Management Server, ensure you have ConsoleOne 1.3.6 installed. You must also prepare the directory by extending the Novell eDirectory schema. For detailed information on how to extend the schema, see Section 2.2.4, “Schema Extension and Product Licensing,”...
Synchronization Integration Software,” on page 58 procedure. Using the Proxy (ZENworks Handheld Management Access Point) Upgrade Utility 1 Run (in installation_path). prxytask.exe 2 Click Upgrade - Update Your Proxy Clients to the Most Recent Version. Novell ZENworks 7 Handheld Management Installation Guide...
3 Click the desired option: Show Status Dialogs During Upgrade: Select this option if you want ZENworks Handheld Management to display an informational dialog box on the Proxy Service (ZENworks Handheld Management Access Point) machines to instruct users to not reboot during the upgrade process.
Novell ZENworks Handheld Management Access Point NOTE: If you are uninstalling the ZENworks Handheld Management Server, you do not see the Novell ZENworks Handheld Management Access Point component listed. You see this component only if you installed the ZENworks Handheld Management Access Point on additional computers or if you upgraded the ZENworks for Handhelds 5.x Proxy...
Page 81
Configuring SSL and HTTP Settings ® ® By default, Novell ZENworks 7 Handheld Management uses TCP/IP for communications between the ZENworks Handheld Management Access Point and ZENworks Handheld Management Server and between the handheld device and the ZENworks Handheld Management Access Point.
ZENworks Handheld Management wizard. 2d3 Read the information on the initial screen, then click Next. 2d4 On the Database Type page, select Microsoft SQL Server and specify the new name in the Machine name option. Novell ZENworks 7 Handheld Management Installation Guide...
Page 83
Base64 format. Handheld PCs running Windows CE 3.0 and Pocket PC 2000 devices do not support certificates originating from NCS. 3 Perform the following steps to have the certificate self-signed by Novell Certificate Services (NCS) : 3a Launch Consoleone 3b In the left pane, click Security.
Access Point and the Handheld Devices You can configure SSL and HTTP communication between the ZENworks Handheld Management Access Point and the Handheld devices during the installation or by using (located in the cfgip.exe folder). ZfHAP Novell ZENworks 7 Handheld Management Installation Guide...
Page 85
We recommend you to use SSL for communication between the ZENworks Handheld Management Access Point and the Handheld devices because SSL provides the following primary security services: Message Privacy: All transmissions after the initial handshake between the ZENworks Handheld Management Access Point and the Handheld device are encrypted. Session Integrity: A secure channel is opened between the ZENworks Handheld Management Access Point and the Handheld device.
Page 86
Handheld PCs running Windows CE 3.0 and Pocket PC 2000 devices do not support certificates originating from NCS. 3 Have the certificate signed by a Certificate Signing Authority, such as Novell Certificate Services (NCS) or VeriSign. To have the certificate signed by NCS, continue with...
5c Ensure that the Process the Pending Request and Install the Certificate option is enabled, then click Next. 5d Browse to the location where you saved the certificate during Step 2h, then click Open. 5e Click Next. 5f Click Finish. 6 You can publish a trusted SSL root certificate that Windows CE clients automatically download when they connect.
Configure IP - ZENworks Handheld Management Access Point dialog box: 1a Deselect the Use Default Ports option. 1b Type the desired TCP, SSL, HTTP, and HTTPS ports that you want the ZENworks Handheld Management Access Point to use. Novell ZENworks 7 Handheld Management Installation Guide...
Page 89
1c Click OK. 2 On the Handheld device, open the ZENworks console and do the following: For Palm OS devices, click the ZENworks menu > Server, then deselect the Use Default Port option. Type the port that you want the device to use for connecting to the ZENworks Handheld Management Access Point.
This section contains information on documentation content changes that have been made in the ® ® Installation Guide after the initial release of Novell ZENworks 7 Handheld Management. The information helps you to keep current on updates to the documentation.
Added informatation related to Pocket PCs running Windows 2005 Mobile Devices. B.4 December 9, 2005 The page design of the entire guide was reformatted to comply with revised Novell documentation standards. B.5 October 7, 2005 Updates were made to the following sections. The changes are explained below.
Page 93
Location Change “RIM BlackBerry Client” on This is a new section. page 19 Section 2.4.5, “Installing Desktop This is a new section. Synchronization Integration Software,” on page 58 Documentation Updates...