Installing the Software

An upgrade installation is identical to a new installation. The following steps provide only the information you need to launch the installation program and make choices specific to upgrading. For more detailed installation information, see Installing the ZENworks Desktop Management Server.

1. From the installing workstation, authenticate to eDirectory as a user with administrative rights to the eDirectory tree whose schema you extended for ZENworks 6.5 (see Extending the eDirectory Schema).

2. Insert the Novell ZENworks 6.5 Desktop Management CD into the CD drive of the workstation to autorun the ZENworks 6.5 installation program.

   If the installation program does not autorun, launch winsetup.exe from the root of the CD.

   
   

3. Select Desktop Management, then select English to display the ZENworks 6.5 Desktop Management page.

   
   

4. Select Desktop Management Services to launch the ZENworks Desktop Management Server installation program.

5. Follow the prompts until you've added the servers you want to upgrade and the Server Selection page is still displayed, as shown below.

   
   

6. Deselect any components you don't want installed to the server.

   For example, if you are not yet upgrading Workstation Inventory, deselect Inventory Database, Inventory Server, and Inventory Proxy Server. Select a component to display a description in the Component Description box.

7. (Optional) If you don't want the installation program to check the target servers to ensure that they meet the ZENworks 6.5 prerequisites, deselect the Prerequisite Check option.

   With the Prerequisite Check option selected, if a target server does not meet the prerequisites, installation does not occur on that server until you upgrade the server or rerun the installation program with the option deselected.

8. Click Next, then follow the remaining prompts to install the software.

9. Review the information in the following sections to complete the upgrade process:

   • Completing the Application Management Upgrade
   • Completing the Workstation Management Upgrade
   • Completing the Remote Management Upgrade
   • Completing the Workstation Imaging Upgrade

Completing the Application Management Upgrade

The following sections provide information to help you complete your upgrade of the Application Management component of ZENworks Desktop Management:

• Managing Terminal Server Applications
• Transitioning from System Requirements to Distribution Rules

For information about new Application Management features in ZENworks 6.5 Desktop Management, see What's New In ZENworks 6.5 Desktop Management.

Completing the Workstation Management Upgrade

When you extended your eDirectory tree to accommodate the ZENworks 6.5 Desktop Management schema (see Extending the eDirectory Schema), new ZENworks 6.5 policy attributes were added. Your existing ZfD 4.x policies are migrated to ZENworks 6.5 policies and can be administered with the ZENworks 6.5 snap-ins. No additional actions are required to upgrade policies.

The ZfD 4.x Workstation Manager will continue to apply the ZENworks 6.5 policies. However, new policy features are not available on a workstation until the workstation is upgraded with the ZENworks 6.5 Workstation Manager. This upgrade is done as part of installing the ZENworks 6.5 Desktop Management Agent. See Upgrading Managed Workstations.

For information about new features in Workstation Management, see What's New In ZENworks 6.5 Desktop Management.

For more information about managing and using ZENworks 6.5 policies, see "Workstation Management" in the Novell ZENworks 6.5 Desktop Management Administration Guide.

Completing the Remote Management Upgrade

After extending your eDirectory tree schema for ZENworks 6.5 and installing ConsoleOne 1.3.6 and the ZENworks 6.5 Desktop Management snap-ins, you can use the Remote Management features in ConsoleOne 1.3.6 to perform remote operations on any workstation that has the ZfD 4.x or ZENworks 6.5 Remote Management Agent installed.

If you are using the standalone Remote Management console, you can continue to use the ZfD 4.x Remote Management console or you can upgrade to the ZENworks 6.5 Remote Management console. The Remote Management console is included on the Novell ZENworks 6.5 Companion 2 CD and can be installed by launching winsetup.exe on that CD, selecting Companion Programs and Files, clicking the More button, and then selecting Inventory and Remote Management Console.

No additional actions are required to upgrade Remote Management.

For information about new features in Remote Management, see What's New In ZENworks 6.5 Desktop Management.

For more information about using Remote Management, see "Remote Management" in the Novell ZENworks 6.5 Desktop Management Administration Guide.

Completing the Workstation Imaging Upgrade

After upgrading your ZfD 4.x Servers to ZENworks 6.5, complete the following tasks to finish upgrading Workstation Imaging:

• Upgrading Standalone Imaging Servers
• Upgrading the Workstation Imaging Engine

For information about new features in Workstation Management, see What's New In ZENworks 6.5 Desktop Management.

For more information about managing and using ZENworks 6.5 policies, see "Workstation Inventory" in the Novell ZENworks 6.5 Desktop Management Administration Guide.

Pre-Upgrade Considerations

Before you upgrade ZENworks for Desktops 4.x Inventory components to ZENworks 6.5, review the facts in the following sections:

• Inventory Server
• Inventory Agent
• Management Console

Tasks To Be Performed Before Upgrade and Database Migration

After reviewing the facts mentioned in Pre-Upgrade Considerations, you must perform the following tasks before you upgrade from ZENworks for Desktops 4.x to ZENworks 6.5 Desktop Management:

1. Stop the Inventory service.
   • On a NetWare Inventory server: At the server console prompt, enter sys:\system\invstop.ncf.

     NOTE:  If you do not want the Sybase database to be stopped automatically when you stop the Inventory services, comment the Unload dbsrv8.nlm line in the sys:\system\invstop.ncf file.

   • On a Windows 2000 Inventory server: In the Control Panel, double-click Administrative Tools > Services, select Novell Inventory Service, then click Stop.
2. Stop the Inventory database.

   To stop the Sybase Inventory database:

   • On NetWare: At the Sybase console prompt, press the Q key.
   • On Windows 2000: In the Control Panel, double-click Administrative Tools > Services, then select Novell Database - Sybase > click Stop.
3. Stop the ZENworks Web server.
   • On Windows NT: In the Control Panel, double-click Services, select Novell ZFS Web Server, then click Stop.
   • On Windows 2000: In the Control Panel, double-click Administrative Tools > Services, select Novell ZFS Web Server, then click Stop.
4. If Java has not been unloaded on the target NetWare servers, unload java.nlm (at the server console, enter java -exit).

   IMPORTANT:  This command stops all Java processes running on the server. Verify that all Java processes can be stopped while you are installing ZENworks 6.5 Desktop Management.

5. On the target Windows servers, close the Services window.
6. Make sure that you have made and archived a reliable backup of the ZENworks for Desktops 4.x database.
7. Make sure that the ZENworks for Desktops 4.x database is not accessed from ConsoleOne.
8. Make sure that the recommended ZENworks 6.5 Workstation Inventory requirements are met. For more information, see Preparation.
9. If zenworks_installation_path\zenworks\inv\server\wminv\ properties\ inventoryremoval.properties has been modified after the ZENworks for Desktops 4.x installation, take a reliable backup of inventoryremoval.properties.
10. If you have a ZENworks for Desktops 4.x database running Oracle, you must perform the following tasks before the migration:

1. In inventory_database_installation_path\init.ora_path\init.ora, set the value of db_block_buffers to obtain a net value of approximately 128 MB for the database buffer cache.

   If the db_block_size is 4096 then the minimum value must be 32768. This allocates 128 MB of database cache for the Inventory database. If the existing value of db_block_buffers is greater than 128 MB, do not change the value.

   We recommend you to set the Oracle's Shared Global (SGA) memory to 30-40% or above during the database migration.

2. Ensure that the Inventory database is up and running.

3. You must have a larger rollback segment because the database migration and the storage of further data will not succeed due to ORA-01555 and other rollback segment related issues.

   To increase the value of rollback segment, execute the following sql script to add an additional data file to rollback segment (rbs) and to add a Redo log group:

   connect internal;

   alter tablespace rbs add datafile 'Inventory_database_installation_path\rbs2.ora' size 40M autoextend on next 50K maxsize 60M;

   alter rollback segment rb0 storage (maxextents unlimited);

   alter rollback segment rb1 storage (maxextents unlimited); 

   ALTER DATABASE ADD LOGFILE GROUP 3 ('Inventory_database_installation_path\log3.ora') SIZE 50M;

Upgrading the ZENworks for Desktops 4.x Inventory Database

During the ZENworks 6.5 Desktop Management Server installation, if you choose to install Sybase and you do not choose to overwrite the database files, the server installation program automatically upgrades the existing ZENworks for Desktops 4.x database engine only. During the Sybase database upgrade, a message indicating that the existing database can be migrated is displayed. If you choose Yes, then the existing database will be overwritten by the new ZENworks 6.5 Desktop Management database files. If you choose No, the database will be migrated when the Inventory service starts for the first time.

You must perform the following tasks to upgrade the Inventory database:

1. If you have a ZENworks for Desktops 4.x Oracle database object, or if you have manually created Sybase database objects, you must manually migrate the database object using the Inventory Migration tool. For more information, see Manually Migrating the Database Objects.

2. If you have a ZENworks for Desktops 4.x database running Sybase, ensure that the value of Sybase cache ("-c" parameter) is set to 25% or above of the server's memory.

   • To change the database cache size on a NetWare database server:

     1.Close all connections to the Inventory database.

     2. Quit the Sybase server.

     3. Open the mgmtdbs.ncf file in the sys:\system directory.

     4. Modify the -c parameter. For example, -c 128M sets the cache size to 128 MB

     5. Save the file.

     6. On the server console, load the Inventory database. Enter MGMTDBS.

   • To change the database cache size on a Windows database server:

     1. Stop the Sybase service. On Windows NT, in the Control Panel, double-click Services, select Novell Database - Sybase, then click Stop. On Windows 2000, in the Control Panel, double-click Administrative Tools > double-click Services, select Novell Database - Sybase, then click Stop.

     2. On the database server, run the ntdbconfig.exe file from the dbengine directory. Ntdbconfig.exe is a ZENworks database configuration utility for the ZENworks database using Sybase on Windows NT/2000 servers. This utility enables you to reconfigure the Sybase service.

     3. Modify the -c parameter.

     4. Click OK.

     5. Restart the Sybase service. On Windows NT, in the Control Panel, double-click Services, select Novell Database - Sybase, then click Start. On Windows 2000, in the Control Panel, double-click Administrative Tools > double-click Services, select Novell Database - Sybase, then click Start

3. If you have a ZENworks for Desktops 4.x database running MS SQL, ensure that the value of fixed memory is 25% or above of the server memory.

IMPORTANT:  You can upgrade multiple Inventory servers and database servers at the same time by running the Desktop Management Server installation program.

However, you must manually migrate the existing ZENworks for Desktops 4.x Workstation Inventory policy, Database Location policy, and Roll-up policy. If you have manually created the database object, you must also migrate the database object. For more information on how to manually migrate the policies, see Manually Migrating the Database Objects.

Upgrading the ZENworks for Desktops 4.x Inventory Server

Before you upgrade a ZENworks for Desktops 4.x Inventory server, ensure that you have stopped the Inventory services and have upgraded the associated database server.

You can upgrade the ZENworks for Desktops 4.x Inventory server by installing ZENworks 6.5 Desktop Management Inventory server if the server where you want to install the ZENworks 6.5 Desktop Management Inventory server meets the installation requirements. For more information on how to install the ZENworks 6.5 Desktop Management Inventory server, see Installing the ZENworks Desktop Management Server. The ZENworks 6.5 Desktop Management Inventory server supports the same set of roles as ZENworks for Desktops 4.x. Therefore, when you upgrade from ZENworks for Desktops 4.x to ZENworks 6.5 Desktop Management, the role of the Inventory server is retained.

IMPORTANT:  If you have a ZENworks for Desktops 4.x Inventory server attached to a ZENworks for Desktops 4.x database and if you upgrade either the Inventory server or the database to ZENworks 6.5 Desktop Management, you must upgrade the associated component to ZENworks 6.5 Desktop Management (the ZENworks for Desktops 4.x Inventory services should not interact with ZENworks 6.5 Desktop Management compliant database and vice versa).

If you have multiple ZENworks for Desktops 4.x Inventory servers connected to a ZENworks for Desktops 4.x database server and if you upgrade the database server to ZENworks 6.5 Desktop Management, you must also upgrade all the associated ZENworks for Desktops 4.x Inventory servers.

The ZENworks 6.5 Desktop Management installation program automatically migrates only the ZENworks for Desktops 4.x Inventory Service object to ZENworks 6.5 Desktop Management. Before starting the Inventory service, you must manually migrate the existing ZENworks for Desktops 4.x policies to ZENworks 6.5 Desktop Management policies using the ZENworks Inventory Migration tool. For more information, see Manually Migrating ZENworks for Desktops 4.x Inventory Policies.

Manually Migrating ZENworks for Desktops 4.x Inventory Policies

1. In ConsoleOne with ZENworks 6.5 Desktop Management Workstation Inventory snap-ins installed, click Tools > ZENworks Inventory > Inventory Migration.

2. Click Browse to browse for and select the Inventory Service object or the container that has the Inventory Service object.

3. If you selected a container in Step 2, do the following:

   1. If you want to search for the Inventory Service object in all the subcontainers within the selected container, select the Search SubContainers check box.

      The Search SubContainers check box is available only if you select a container in Search Context.

   2. Select the Search for Policies check box to search for the Inventory policies associated with the Inventory Service object within the selected container.

      This option is available only if you select a container in Search Context. By default, this option is selected.

   3. Click Find.

      All the ZENworks for Desktops 4.x Inventory policies that are associated with the Inventory Service object and are found within the specified context are displayed in the Report panel.

4. Click Migrate.

5. Click Close.

The ZENworks 6.5 Inventory agents obtain the software scan configuration rules from the private dictionary and the general dictionary, instead from the Workstation Inventory policy. But the ZENworks for Desktops 4.x Inventory agents would continue to use the Workstation Inventory policy for software configuration.

After migrating the policies, perform the following tasks:

1. Start the ZENworks 6.5 Desktop Management Inventory services.

   When you start the Inventory service, the Upgrade Service automatically migrates the ZENworks for Desktops 4.x database schema and the inventory data to a ZENworks 6.5 Desktop Management database. The data migration process might take a significant amount of time. On the Inventory server screen, messages indicating that the database has been successfully migrated and initialized are displayed.

   After the database is migrated, the Inventory ConsoleOne utilities (Query, Summary, Inventory Report, and Database Export) and the Storer can access the database.

2. Create and configure the Dictionary Update policy to get the latest version of the dictionary for ZENworks 6.5 Inventory Agent. For more information on how to create the Dictionary Update policy, see "Workstation Inventory" in the Novell ZENworks 6.5 Desktop Management Administration Guide.

Post Database Migration Tasks

You must perform the following tasks after upgrading the Inventory server and migrating the Inventory database is complete:

1. Stop the Inventory service.

2. If your Inventory database is running Oracle, do the following to improve the database performance:

   1. In the inventory_database_installation_path\_start.sql file, delete the existing entries and add the following entries:

      SET ECHO ON

      CONNECT INTERNAL

      SET ECHO OFF

      STARTUP PFILE= 
      inventory_database_installation_path\path_to_init.ora\init.ora

      SET NUMWIDTH 20

      SET CHARWIDTH 40

      SET ECHO ON

      connect mw_dba;

      SET ECHO OFF

      alter table cim.t$product cache;

      SET ECHO ON

      connect internal

      SET ECHO OFF

      @<path to oracle home directory>/rdbms/admin/dbmspool

      call sys.dbms_shared_pool.keep('zenworks.zenpin','P');

      EXIT

   2. Execute the oracle\common\oracle_perf.sql and oracle\common\oracle_perf2.sql files from the Inventory_server_installation_path\zenworks\inv\server\wminv\properties\sql.zip to add performance enhancing indexes to the database.

   3. Execute oracle_dbexport_perf.sql from the Novell ZENworks 6.5 Companion 2 CD\database\oracle8i\common directory.

   For more information on how to improve the performance of the Inventory database, see "Performance Tips" in "Workstation Inventory" in the Novell ZENworks 6.5 Desktop Management Administration Guide.

3. (Optional) If the Inventory database is running MS SQL, execute the following scripts from Inventory_server_installation_path\zenworks\inv\server\wminv\properties\sql.zip with appropriate user logins as explained below from the MS SQL Query Analyzer:

   1. Login as CIM and execute the mssql_perf_cim.sql

   2. Login as mw_dba and execute mssql_perf_mw_dba.sql

   3. Login as zenworks and execute msswl_perf_zenworks.sql

   This enhances the performance of the Inventory database.

   For more information on how to improve the performance of the Inventory database, see "Performance Tips" in "Workstation Inventory" in the Novell ZENworks 6.5 Desktop Management Administration Guide.

4. Start the Inventory services.