Upgrading the Server Inventory Components Using a Server Software Package

You can also upgrade Server Inventory from ZENworks for Servers 3.0.2 or ZENworks for Servers 3 SP2 to ZENworks 6.5 Server Management using a Server Software Package upgrade file contained on the Novell ZENworks 6.5 Companion 2 CD.

This method allows you to automatically upgrade the following Server Inventory components:

To upgrade these components using a Server Software Package (CPK), perform the tasks in the following sections in the order listed:

  1. Preparing for Upgrade
  2. Upgrading the Inventory Server Using the Software Package
  3. Upgrading the Inventory Agent Using the Software Package
  4. Reinstalling the Inventory Agent Using the Software Package


Preparing for Upgrade

After reviewing the Pre-Upgrade Considerations, you must perform the following tasks in the order listed before you upgrade to ZENworks 6.5 Server Management:

  1. Extend the schema to ZENworks 6.5 using the ZENworks 6.5 Server Management installation program.

    For more information on how to extend the schema, see Extending the Schema in Policy-Enabled Server Management Installation.

  2. Upgrade Policy and Distribution Services to ZENworks 6.5.

    For more information on how to upgrade Policy and Distribution Services to ZENworks 6.5, see Policy and Distribution Services.

  3. Upgrade the Server Inventory ConsoleOne snap-ins.

    1. In a Web browser, access the Novell Support Web site.

    2. In the Choose a Product field, select ZENworks Server Management from the drop-down list, then click the Submit Search button.

    3. Under the Search Results section, click the Download button to download the snap-ins.

    4. Log in (or create a login).

    5. For zsm65c1snap_inv.zip, click the Download button.

    6. Save the .zip file to a location on your workstation.

    7. Unzip the file into your workstation's copy of ConsoleOne.

  4. Manually migrate the ZENworks for Servers 3.0.2 or ZENworks for Servers 3 SP2 Inventory policies.

    1. In ConsoleOne with ZENworks 6.5 Server Management Server 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 4b, 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. This option is available only if you select a container in Search Context
      2. If you want to search for the Inventory policies associated with the Inventory Service object within the selected container, select the Search for Policies check box. 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 Servers 3.0.2 or ZENworks for Servers 3 SP2 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 Server Inventory policy. However, the ZENworks for Servers 3.0.2 or ZENworks for Servers 3 SP2 Inventory agents would continue to use the Server Inventory policy for software configuration.


Upgrading the Inventory Server Using the Software Package

Depending on whether you have Policy and Distribution Services running on the target Subscriber servers, you can install the Inventory server software package using one of the following methods,


Automatically Installing the Inventory Server CPK

Using the Tiered Electronic Distribution component of ZENworks 6.5 Server Management, you can automatically distribute and install the Inventory server .cpk file to all servers that are running the Subscriber and Policy Package software.

IMPORTANT:  You cannot combine software packages into the same Distribution. You must create a separate Distribution object for each software package. Also, ensure that the Inventory server and the Inventory Agent Distributions are not simultaneously sent to the server using the same Channel. You must first send the Inventory server Distribution and after it is complete, you must send the Inventory Agent Distribution. This is because each software package unloads the JVM on NetWare, which prevents concurrent processing of multiple software packages.

To automatically install the Inventory Server .cpk file:

  1. Copy zsm65_invsrv.cpk from ZENworks 6.5 Companion CD 2\ zenworks server management - software pkgs\invrm to a temporary directory on a Distributor server you will use to install the software package.

  2. Set the Subscriber's Extract schedule.

    If the schedule is set to Run Immediate, you will probably interrupt the sending of the Distribution to Subscribers because the update process involves unloading Java. With Java unloaded, Distributions are temporarily halted until Java has been reloaded and the Channel's Send schedule fires.

    If the Subscriber is a parent that is sending the Distribution to subordinate Subscribers, it will be in the process of sending the Distribution when the software package tries to unload Java. However, the Distributions continue from where they left off after Java is started again.

  3. Create a Distribution for this software package.

    You can have only one software package per Distribution object. Although the software allows more than one software package to be selected in a single Distribution object, this is not allowed when distributing the ZENworks 6.5 Server Management software packages. The reason is that installing a software package unloads and reloads Java, which can prevent the remaining software packages from being successfully processed from a single Distribution object.

    Make sure to set the Distribution's Build schedule.

    The Distribution containing ZENworks 6.5 Server Management must be built, sent, extracted, and installed before sending any other Distributions containing other ZENworks 6.5 Server Management software packages.

    For detailed instructions on creating Distributions, see "Tiered Electronic Distribution" in the Novell ZENworks 6.5 Server Management Administration Guide.

  4. Associate the Distribution with a Channel so that it is sent based on the channel schedule.

    You might need to create the Channel. Be sure to set the Channel's Send schedule.

    The ZENworks 6.5 Server Management software packages unload and restart Java as part of the installation process. Therefore, you must process each software package individually. If you attempt to process multiple ZENworks 6.5 Server Management software packages simultaneously (such as by processing them at the same time in a given Channel), it is probable that one or more of the Software Package Distributions will fail on installation.

  5. Associate the Subscribers that you want to receive this software package with the Channel.

  6. Send the Distribution.

    For example, refresh the Distributor to build Distribution so that it can be sent and extracted. For detailed information on sending distributions, see "Tiered Electronic Distribution" in the Novell ZENworks 6.5 Server Management Administration Guide.

    The Distribution is automatically created when the Distribution's Build schedule starts. The Distribution is automatically be sent when the Channel's Send schedule starts. It will be extracted according to the Subscriber server's Extract schedule.

  7. Review the following log files to verify the success or failure of the .cpk file installation:

    • On a NetWare server: sys:\etc\cpk65logs\cpk65_invsrv.log, sys:\etc\cpk65logs\invsrv_nw_files.log, and sys:\etc\cpk65logs\cpk_ndsupdate.log
    • On a Windows server: %windir%\cpk65logs\cpk65_invsrv.log, %windir%\cpk65logs\invsrv_win_files.log, and %windir%\cpk65logs\cpk_ndsupdate.log

    If the .cpk file has been successfully installed, the Inventory service is automatically started. The Upgrade Service automatically migrates the database schema and the inventory data to a ZENworks 6.5 Server 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.

  8. 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 "Configuring the Dictionary Update Policy" in the Novell ZENworks 6.5 Server Management Administration Guide.


Manually Installing the Inventory Server CPK

If you are installing the Inventory server .cpk file to servers that are not running Subscriber software and the Policy/Package Agent, you must use the Standalone Package Processor included in the software package download to manually install the Inventory server .cpk file.

The Standalone Package Processor is required where Policy and Distribution Services agents are not running for both NetWare and Windows servers. However, it can be used on servers where Policy and Distribution Services agents are running.

IMPORTANT:  Before starting another software package installation, you must ensure that the previous installation is complete. Processing a new software package before the previous one is complete could cause the second software package installation to fail.

The following instructions should be repeated for each NetWare or Windows server where you will manually install the Inventory server .cpk file:

  1. (Conditional) If you are installing the .cpk file on a Windows Inventory server, make sure that users have not logged into eDirectory from that Inventory server.

  2. Copy invrem_standalonepacpro.zip from ZENworks 6.5 Companion CD 2\zenworks server management - software pkgs\invrm to a temporary directory on a NetWare or Windows Inventory server where you will install the software package.

  3. Extract invrem_standalonepacpro.zip to the following appropriate location:

    • NetWare server: sys:\
    • Windows server: c:\

    Invrem_standalonepacpro.zip contains a directory structure that includes temp as the first directory. The Standalone Package Processor files are unzipped into a TEMP directory at the root of the server's file system.

  4. Copy zsm65_invsrv.cpk to the temporary directory where the associated .bat or .ncf file exists. For example:

    • NetWare server: sys:\temp\zfs65
    • Windows server: c:\temp\zfs65
  5. If you are installing the .cpk file on a NetWare server, edit the zsm65_invsrv.ncf, which is associated with the software package, to set the values of the following variables:

    • envset ZFSHOMEDIR = Inventory_server_installation_path

      For example, envset ZFSHOMEDIR = sys:\zenworks

    • envset CPKTEMP = path where you have extracted invrem_standalonepacpro.zip

      For example, envset CPKTEMP = sys:\temp\zfs65

    • SEARCH ADD path where you have extracted invrem_standalonepacpro.zip\NETWARE

      For example, SEARCH ADD sys:\temp\zfs65\netware

  6. If you are installing the .cpk file on a Windows server, edit the zsm65_invsrv.bat associated with the software package to set the value of following variables:

    • set ZFSHOMEDIR = Inventory_server_installation_path

      For example, set ZFSHOMEDIR = c:\zenworks

    • set CPKTEMP = path where you have extracted invrem_standalonepacpro.zip

      For example, set CPKTEMP = c:\temp\zfs65

  7. From the temporary directory, run the .bat or .ncf file associated with the software package you want to install:

    • On NetWare, enter the following at the server prompt:

      sys:\temp\zfs65\netware\zsm65_invsrv.ncf

    • On Windows, run c:\temp\zfs65\win\zsm65_invsrv.bat
  8. Review the following log files to verify the success or failure of the .cpk file installation:

    • On a NetWare server: sys:\etc\cpk65logs\cpk65_invsrv.log, sys:\etc\cpk65logs\invsrv_nw_files.log, and sys:\etc\cpk65logs\cpk_ndsupdate.log
    • On a Windows server: %windir%\cpk65logs\cpk65_invsrv.log, %windir%\cpk65logs\invsrv_win_files.log, and %windir%\cpk65logs\cpk_ndsupdate.log

    If the .cpk file has been successfully installed, the Inventory service is automatically started. The Upgrade Service automatically migrates the database schema and the inventory data to a ZENworks 6.5 Server 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.

  9. 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 "Configuring the Dictionary Update Policy" in the Novell ZENworks 6.5 Server Management Administration Guide.


Upgrading the Inventory Agent Using the Software Package

You can automatically install the Inventory Agent .cpk file.

IMPORTANT:  You cannot combine software packages into the same Distribution. You must create a separate Distribution object for each software package. Also, ensure that the Inventory server and the Inventory Agent Distributions are not simultaneously sent to the server using the same Channel. You must first send the Inventory server Distribution and after it is complete, you must send the Inventory Agent Distribution. This is because each software package unloads the JVM on NetWare, which prevents concurrent processing of multiple software packages.

To automatically install the Inventory Agent .cpk file:

  1. Copy zsm65_invagnt.cpk from ZENworks 6.5 Companion CD 2\zenworks server management - software pkgs\invrm to a temporary directory on the Distributor server you will use to install the software package.

  2. Set the Subscriber's Extract schedule.

    If the schedule is set to Run Immediate, you will probably interrupt the sending of the Distribution to Subscribers because the update process involves unloading Java. With Java unloaded, Distributions are temporarily halted until Java has been reloaded and the Channel's Send schedule fires.

    If the Subscriber is a parent that is sending the Distribution to subordinate Subscribers, it will be in the process of sending the Distribution when the software package tries to unload Java. However, the Distributions will continue from where they left off after Java is started again.

  3. Create a Distribution for this software package.

    You can have only one software package per Distribution object. Although the software allows more than one software package to be selected in a single Distribution object, this is not allowed when distributing the ZENworks 6.5 Server Management software packages. The reason is that installing a software package unloads and reloads Java, which can prevent the remaining software packages from being successfully processed from a single Distribution object.

    Make sure to set the Distribution's Build schedule.

    The Distribution containing ZENworks 6.5 Server Management must be built, sent, extracted, and installed before sending any other Distributions containing other ZENworks 6.5 Server Management software packages.

    For detailed instructions on creating Distributions, see "Tiered Electronic Distribution" in the Novell ZENworks 6.5 Server Management Administration Guide.

  4. Associate the Distribution with a Channel so that it is sent based on the channel schedule.

    You might need to create the Channel. Be sure to set the Channel's Send schedule.

    The ZENworks 6.5 Server Management software packages unload and restart Java as part of the installation process. Therefore, you must process each software package individually. If you attempt to process multiple ZENworks 6.5 Server Management software packages simultaneously (such as by processing them at the same time in a given Channel), it is probable that one or more of the Software Package Distributions will fail on installation.

  5. Associate the Subscribers that you want to receive this software package with the Channel.

  6. Send the Distribution.

    For example, refresh the Distributor to build the Distribution so that it can be sent and extracted. For detailed information on sending distributions, see "Tiered Electronic Distribution" in the Novell ZENworks 6.5 Server Management Administration Guide.

    The Distribution is automatically created when the Distribution's Build schedule starts. The Distribution is automatically be sent when the Channel's Send schedule starts. It is extracted according to the Subscriber server's Extract schedule.

  7. Review the following log files to verify the success or failure of the Inventory Agent .cpk file installation:

    • On a NetWare server: sys:\etc\cpk65logs\cpk65_invagnt.log
    • On a Windows server: %windir%\cpk65logs\cpk65_invagnt.log

    If the .cpk file has been successfully installed, the ZENworks service is automatically started.


Reinstalling the Inventory Agent Using the Software Package

If you have installed the ZENworks 6.5 Inventory Agent on the inventoried server using the ZENworks 6.5 Server Management Program CD, and now you want to reinstall the ZENworks 6.5 Inventory Agent using the software package, you must do the following:

  1. Ensure that the value of InvAgentPath in sys:\system\zenworks.properties is <volume_name>:\zenworks\inv\agent.

  2. Follow steps explained in Upgrading the Inventory Agent Using the Software Package.