Novell ZENworks 7 Server Management with Support Pack 1 Interim Release 1

October 2, 2007

1.0 Overview

Novell® ZENworks® 7 Server Management with Support Pack 1 Interim Release 1 (SP1 IR1) contains files that were updated for ZENworks 7 Server Management after the SP1 release. The Server Management product is shipped in two packages, one package for Windows* and NetWare®, and a second for ZENworks 7 Server Management Services on Linux*.

We recommend that you check the readme of the shipping version of ZENworks 7 Server Management with Support Pack 1 for issues that pertain to all of its interim releases.

2.0 Downloading and Extracting Interim Release 1 for Windows and NetWare

  1. Locate the Interim Release download at the Novell downloads Web site, then search for the ZENworks 7 product and this IR1 release.

  2. Follow the prompts to copy the download file, zsm7_sp1_ir1.zip, to a suitable network path. This is the location where the self-extracting file will be decompressed.

    We recommend that you extract this Interim Release to the root of a local drive of a Windows workstation or to the root of a network server volume because it contains directory paths that could exceed the DOS limits.

  3. At the download location, double-click zsm7_sp1_ir1.zip, then extract the file’s contents.

    IMPORTANT:If you chose to download zsm7_sp1_ir1.zip to a location that includes a space in the path, for example, c:\documents and settings\downloads, the .zip fails to extract. To work around this problem, run the .zip from a DOS command prompt.

    The .zip file extracts to a folder named zsm7_sp1_ir1.

3.0 Installing the Interim Release to Your ZENworks Servers

We recommend that you back up your existing installation before applying the files from this interim release. The interim release installation updates a limited number of files.

NOTE:You must follow the proper installation order when you upgrade to IR1. For more information, see Section 3.1, Interim Release 1 Installation Order.

3.1 Interim Release 1 Installation Order

Interim Release 1 is not a full overlay of ZENworks 7 Server Management with Support Pack 1. You must have the shipping version of ZENworks 7 Server Management with Support Pack 1 already installed on the server before you can install IR1. IR1 is a comprehensive maintenance release, which means that it includes all of the fixes made after Support Pack 1 shipped.

Policy and Distribution Services should be updated first to update the Software Packaging feature because Server Inventory and Remote Management use this for their updates. Then you can update Server Inventory, Remote Management, and Management and Monitoring Services in any order.

3.2 Installing Policy and Distribution Services

Installing IR1 for Policy and Distribution Services requires updating the software then updating the plug-ins and snap-ins.

3.2.1 Interim Release 1 Installation Methods

You can install IR1 either manually or using the Software Package feature:

3.2.1.1 Installing IR1 by Copying Files

This can be done only for NetWare and Windows servers. Linux servers must be updated using the Software Package method described in Automatically Installing IR1 Using a Software Package.

  1. Stop the Policy and Distribution Services processes (Server Management and Tiered Electronic Distribution) on the target servers running Policy and Distribution Services.

    This allows the files being copied in Step 3 to be overwritten. See the ZENworks 7 Server Management Installation Guide for instructions on starting and stopping these processes.

  2. Rename the existing versions of these files.

  3. Based on the folder structure in this patch under the ...\zsm7_sp1_ir1\zfs_ted\dirstruc directory, copy the files in this patch to the target servers running Policy and Distribution Services.

    If prompted to overwrite files, select Yes to All.

  4. Restart the Policy and Distribution Services processes.

3.2.1.2 Automatically Installing IR1 Using a Software Package

You can use this update method for NetWare, Windows, and Linux servers.

  1. Make sure that no Distributions are currently running or are set to run.

    For example, make sure that all other Channels are set to Inactive until after IR1 CPK has been sent and extracted. You will be creating separate Channels for this Interim Release CPK.

  2. Copy the ...\zsm7_sp1_ir1\zfs_ted\cpk\zsm7sp1ir1_polydist.cpk file to the Distributor server.

  3. Create a Software Package Distribution to include the zsm7sp1ir1_polydist.cpk file.

  4. Because Distributor servers must be updated first, do the following:

    1. Create a Channel for this Interim Release that will be used to update the Distributor servers.

      If you were to include a Subscriber (that is on the same device as a Distributor) in the same channel as all of the other Subscribers, it could cause the Distributor to stop in the middle of sending IR1 to the other Subscribers, because the CPK restarts the ZfS Service and the send would not resume until the Channel's Send schedule starts again.

    2. For each Distributor server, subscribe its Subscriber to this Channel.

    3. Add the Software Package Distribution to this Channel.

    4. Set the Channel's Send schedule to Immediate.

    5. If necessary, resolve the certificates.

      If you installed the server new before installing IR1, you need to resolve certificates.

    6. Refresh the Distributor that owns this Software Package Distribution.

      This causes the Distributor to build the Software Package Distribution so that IR1 can be sent and installed on all Distributor servers via their Subscribers.

    7. After the Distributions have been sent and extracted, set this Channel to Inactive so that it won't be sent again to these Subscribers.

  5. After the Distributors have received and extracted the patch, do the following for the target Subscriber servers:

    1. Create a separate Channel for this Interim Release that will be used to send it to all of the Subscribers needing to receive the patch.

    2. Subscribe all of these Subscribers to this Channel.

      Be sure to exclude any Subscribers where their Distributors have already been updated.

    3. Add the Software Package Distribution to this Channel.

    4. Set the Channel's Send schedule to Immediate.

    5. Refresh the Distributor to install IR1 on the Subscriber servers.

      The Subscriber servers will be updated with IR1 according to each Subscriber’s Extract schedule.

    6. After the Distributions have been sent and received, set this Channel to Inactive so that it won't be sent again to these Subscribers.

      The Subscriber servers will be updated according to the Channel's Send and Subscribers’ Extract schedules.

  6. If desired, you may run a utility that was included with previous patches. It can determine if the patch was applied properly.

    This tool can be run from the following locations:

    Netware: sys:\temp\zsm7\patch\utils\checkpolydistfiles.ncf

    Windows: c:\temp\zsm7\patch\utils\checkpolydistfiles.bat

    Linux and Solaris: Check the version of the RPM.

    After you have run this utility, it generates a cpdf.log file that contains the results of the patch installation.

3.2.2 Updating the iManager Plug-ins

  1. Based on the folder structure in this patch under the ...\zsm7_sp1_ir1\zfs_ted\dirstruc\imanager2.6\webapps\nps directory, copy the files in this patch to the target servers running Novell iManager plug-ins.

    If prompted to overwrite files, select Yes to All.

    Target path examples:

    iManager Mobile: installation_location\imanager\tomcat\webapps\nps\

    iManager on NetWare: sys:\tomcat\4\webapps\nps\

  2. Restart TomCat.

3.2.3 Updating the ConsoleOne Snap-ins

  1. Shut down ConsoleOne® if it is running.

  2. Based on the folder structure in this patch under the ...\zsm7_sp1_ir1\zfs_ted\dirstruc\consoleone directory, update the ConsoleOne snap-ins with the new JAR files in this patch.

    If prompted to overwrite files, select Yes to All.

    Target path examples:

    NetWare: sys:\public\mgmt\consoleone\

    Windows: c:\novell\consoleone\

  3. Restart ConsoleOne.

3.3 Installing Server Inventory and Remote Management

Installing IR1 for Server Inventory and Remote Management requires updating the Inventory Server software and the ConsoleOne components, then updating the agents using Software Packages.

3.3.1 Updating the Inventory Server and ConsoleOne Components

  1. Stop ConsoleOne, if it is running.

  2. Stop the Inventory service and XML Proxy service, if they are running.

    For more information on how to stop these services, see the ZENworks 7 Server Management Administration Guide.

  3. (Conditional) While upgrading the NetWare server using the Inventory Agent software package file ( zsm7sp1ir1_invagnt.cpk), ensure that no scan is scheduled on the server.

  4. In the downloaded and unzipped files, locate and edit ...\zsm7_sp1_ir1\zfs_invrm\zfs7sp1hp6invrm_updt.bat to set the value for the following variables:

    1. CD_ROOT = extraction_directory\zfs_invrm\zfs .

    2. (Conditional) To upgrade the ConsoleOne components of Server Inventory or Remote Management, set the value of C1_ROOT = ConsoleOne_installation_path, where c:\consoleone\1.2 is the default value.

    3. (Conditional) If ZENworks 7 Server Management is installed on a NetWare server, then set the value of NWSYS to the drive mapped to the SYS: volume on the NetWare server.

    4. (Conditional) To upgrade the Inventory server, set the value of ZENPATH = ZENworks_installation_path, where c:\zenworks is the default value.

  5. Run zfs7sp1hp6invrm_updt.bat from the Windows device where zsm7_sp1_ir1.zip was extracted.

    If you are upgrading an Inventory server and have more than one Inventory server installed in your network, you must repeat Step 4 and Step 5 for each Inventory server.

  6. Execute queryswsupportpack_fix.sql on the database (use mssql_queryswsupportpack_fix.sql in case of MS SQL).

    The script is available in the respective directories ( sybase, oracle or mssql) of Inventory_server_installation_path\zenworks\inv\ server\wminv\properties\sql.zip on Windows and /etc/opt/novell/zenworks/inv/sql.zip on Linux.

    To run the script on Sybase*, create a new folder and copy the queryswsupportpack_fix.sql from the sql.zip file to the new folder. Navigate to Inventory_server_installation_path\zenworks\inv\ server\wminv\bin in case of Windows or /opt/novell/zenworks/bin in case of Linux and run sybindex -path full path of the newly created folder .

  7. Restart the Inventory and XML Proxy services, if they are installed on the server.

    For more information on how to restart these services, see the ZENworks 7 Server Management Administration Guide.

  8. Restart ConsoleOne.

3.3.2 Installing the Inventory Agent Using a Software Package

  1. Create a separate Channel for this Interim Release CPK.

  2. Copy the ...\zsm7_sp1_ir1\zfs_invrm\cpk\zsm7sp1ir1_invagnt.cpk file to the Distributor server.

  3. Create a Software Package Distribution to include the zsm7sp1ir1_invagnt.cpk file.

  4. Create a separate Channel for this Interim Release.

  5. Add the Software Package Distribution to a Channel that contains all of the Subscribers to receive the patch.

  6. Refresh the Distributor.

3.3.3 Installing the Remote Management Agent Using a Software Package

  1. Copy the ...\zsm7_sp1_ir1\zfs_invrm\cpk\zsm7sp1ir1_remmgmt.cpk file to the Distributor server.

  2. Create a Software Package Distribution to include the zsm7sp1ir1_remmgmt.cpk file.

  3. Create a separate Channel for this Interim Release.

  4. Associate all Subscribers to the Channel which are to receive the Remote Management agent CPK.

  5. Create a CPK variable MIRROR in the Subscriber object.

    If you want to install Mirror Driver, set the value as YES; otherwise, set the value as NO.

  6. Add the Software Package Distribution to the Channel that contains all of the Subscribers to receive the patch.

3.4 Installing Management and Monitoring Services

  1. Stop Management and Monitoring Services.

  2. Based on the folder structure in this patch under the ...\zsm7_sp1_ir1\zfs_mms directory, copy the files in this patch to the target servers running Management and Monitoring Services.

    If prompted to overwrite files, select Yes to All.

  3. Restart Management and Monitoring Services.

4.0 Fixed Issues

For a list of the issues fixed in ZENworks 7 Server Management with Support Pack 1 Interim Release 1, see TID 10097369 in the Novell Knowledgebase.

5.0 Documentation Conventions

In this 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.

6.0 Legal Notices

Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes.

Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. 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.

Any products or technical information provided under this Agreement may be subject to U.S. export controls and the trade laws of other countries. You agree to comply with all export control regulations and to obtain any required licenses or classification to export, re-export, or import deliverables. You agree not to export or re-export to entities on the current U.S. export exclusion lists or to any embargoed or terrorist countries as specified in the U.S. export laws. You agree to not use deliverables for prohibited nuclear, missile, or chemical biological weaponry end uses. Please refer to http://www.novell.com/info/exports/ for more information on exporting Novell software. Novell assumes no responsibility for your failure to obtain any necessary export approvals.

Copyright © 2007 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher.

Novell, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at http://www.novell.com/company/legal/patents and one or more additional patents or pending patent applications in the U.S. and in other countries.

For a list of Novell trademarks, see the Novell Trademark and Service Mark list at http://www.novell.com/company/legal/trademarks/tmlist.html.

All third-party products are the property of their respective owners.