74.11 Understanding the Upgrade Service

The Upgrade service runs as a service loaded by the Service Manager and performs the following functions:

  1. Migrates ZENworks for Desktops 4.x and ZENworks 6.5 Desktop Management database to ZENworks 7 Desktop Management database. For more information, see Inventory Database Migration.

  2. Converts the ZENworks for Desktops 4.x and ZENworks 6.5 Desktop Management residue .str files to ZENworks 7 Desktop Management .str files. For more information, see Conversion and Movement of ZENworks for Desktops 4.x and ZENworks 6.5 Desktop Management Residue Files.

The Upgrade service performs all the functions in a state-driven method. This is to make sure that the Upgrade service does not execute the same steps when one step is executed successfully. The Upgrade service runs as an uninterrupted service. Therefore, you cannot manually stop the Upgrade service. The Upgrade service stops automatically after completing all its functions.

This section contains the following:

74.11.1 Inventory Database Migration

The Inventory database migration consists of two phases, Schema migration and Data migration.

The Inventory database migration involves the following activities:

  1. The .zip files that contains all the SQL scripts are unzipped. Before the schema migration begins, the SQL files are transformed by filling the constants from the database.

  2. Schema migration phase: The tables, procedures, views, and other related schema objects are either altered or added in compliance with the ZENworks 7 Desktop Management schema. The grants are provided appropriately to the tables, procedures, and views.

  3. Data migration phase: The old data in the ZENworks for Desktops 4.x and ZENworks 6.5 Desktop Management schema is migrated to the ZENworks 7 Desktop Management schema. This phase consumes some time depending upon the size of the database.

  4. Post-migration corrections.

The Database migration activity is additionally traced into a migration log, which could be found in the installation_path\zenworks\inv\server\wminv\logs\migrationlogs directory.

74.11.2 Conversion and Movement of ZENworks for Desktops 4.x and ZENworks 6.5 Desktop Management Residue Files

The residue files are the ZENworks for Desktops 4.x and ZENworks 6.5 Desktop Management .str or .zip files that are collected before the ZENworks 7 Desktop Management Inventory services runs for the first time.

The Upgrade service performs the following functions:

  • Converts the .str files in the dbdir directory to ZENworks 7 Desktop Management .str files

  • Moves the .zip files in the dbdir directory to the dbdirconv directory

  • Moves the .zip files in the entpush directory to the entpushzipconv directory.

  • Moves the .str files in the entpush directory to the entpushstrconv directory.

  • Moves the .str files in the entmerge directory to the entmergeconv directory.

  • Moves the .str files and the .prp files in the dbdir\temp directory to the dbdirtempconv directory.

This is to make sure that the ZENworks 7 Desktop Management Storer and Sender-Receiver services process the residue files present in the dbdir, entpush, and entmerge directories before they process and refresh the new inventory information.

WARNING:You must not delete the residue files during or after upgrade.

Dbdirconv, entpushzipconv, entpushstrconv, entmergeconv, and dbdirtempconv are auxiliary directories created by the upgrade service to facilitate its functioning.