What the Support Pack Upgrade Does and Does Not Do

In the following table, the applicable Server Management components are indicated for the upgrade actions. A "T" means the statement is true for the component; an "F" means it is not; and, a "-" means it is not applicable to the component.

NOTE:  P = Policy and Distribution Services; S = Server Inventory; R = Remote Management; M = Management and Monitoring Services; T = true; F = false; and, - = not applicable.

Upgrading Servers Incrementally

Incremental upgrading does not apply to Remote Management or Management and Monitoring Services.

You can upgrade all ZENworks 6.5 servers to the support pack in one pass, or incrementally (such as for geographical locations).

The wizard copies files to each server, one server after another. If you have many Subscribers, consider the time that it might take to upgrade them. If that time frame is too long, select your target Subscribers in groups so that you can upgrade one group at a time, or use the software package upgrade method.

Because upgrading Policy and Distribution Services on Linux and Solaris servers is done locally one at a time using a script, incremental upgrading doesn't apply. If you want to perform incremental upgrades of groups of Linux or Solaris servers, consider using a Server Software Package.

For more information on upgrading with software packages, see Upgrading to a Support Pack Using a Server Software Package.

Upgrading Servers on Multiple Trees

Upgrading across multiple trees does not apply to Remote Management or Management and Monitoring Services.

When selecting servers in the wizard, you select them by their NCP Server objects, not their ZENworks objects. If your ZENworks servers reside in multiple trees, you must be logged into each of those trees to be able to select the servers.

You can also upgrade servers across multiple trees by using a Server Software Package (see Upgrading to a Support Pack Using a Server Software Package).

Cluster Issues with Upgrading

The following cluster issues do not apply to upgrading Remote Management or Management and Monitoring Services:

• Upgrading Cluster Ready versus Cluster Aware Servers
• Cannot Upgrade Clustered Servers Using the Server Software Packages

zsm651_polydist.cpk or zsm652_polydist.cpk 
zsm651_invagnt.cpk or zsm65sp2_invagnt.cpk 
zsm651_remmgmt.cpk or zsm65sp2_remmgmt.cpk 
RemStandAlonePacPro.zip

Pre-upgrade Checklist

• Review the ZENworks 6.5 Server Management Support Pack Readme on the ZENworks 6.5 Web site for any last-minute information concerning upgrading to the support pack.
• Make sure that ZENworks 6.5 Server Management has been installed on the servers you want to upgrade to the support pack.
• Make note of any clustered servers and determine whether they have ZENworks installed as cluster ready or cluster aware. For more information, see Cluster Issues with Upgrading.
• If you are upgrading Server Inventory, you must perform the following tasks:

  1. Identify the servers that need Server Inventory reinstalled.

  2. Stop the Inventory service.

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

    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/2003 Inventory server: In the Control Panel, double-click Administrative Tools, double-click Services, select Novell Inventory Service, then click Stop.

  3. Stop the Inventory database.

  • On NetWare: At the Sybase console prompt, press the Q key.
  • On Windows 2000/2003: In the Control Panel, double-click Administrative Tools, double-click Services, select Novell Database - Sybase, then click Stop.
• If you have any instance of ConsoleOne running on a target server via a mapped drive from a workstation, or running from the installation machine, exit those instances of ConsoleOne before running the installation program.

  If ConsoleOne is running on a target server via a mapped drive on your installation machine, or if it is running from the installation machine, the ZENworks Server Management snap-ins for ConsoleOne are not installed at those locations.

• If you have not already done so, log in to the eDirectory trees that contain the NCP Server objects for the servers where you will be updating the ZENworks 6.5 software to the support pack.

  You are automatically authenticated to all of the target NetWare servers in the trees you are logged in to during installation, so that you can select those servers for installing the Server Management software.

  If you are not logged in to a tree, you cannot select its server objects during the upgrade process.

  You can run the wizard as many times as necessary.

• If you will install software to any Windows servers, make sure that you have authenticated to the servers.

  This enables you to select Windows servers from their domains for installing the Distributor and Subscriber software. However, if you are not logged in to a Windows server before starting the installation, you can authenticate during installation using a username and password in the Add Server dialog box where you select the Windows server for installation.

• If you will install software to any Windows servers, make sure you have closed the Services window on each Windows server.

  The installation program automatically stops all ZENworks Server Management services. However, the Server Management services cannot be registered if the Services window is left open during installation to the server.

• If you will be installing a support pack to a ZENworks 6.5 Inventory server that has been previously upgraded from ZENworks for Servers 3.x, you must start the Inventory service and the database at least once prior to upgrading the server to ZENworks 6.5 SPx Server Management.

Upgrading to a Support Pack

To upgrade ZENworks 6.5 Server Management to a support pack, do the following tasks in order:

1. Start the Support Pack Wizard
2. Select the Servers to Upgrade
3. Review the Support Pack Upgrade Summary

Select the Servers to Upgrade

1. On the Server Selection page, click Add Servers to display the Add Servers dialog box.

   
   

2. Browse for the NCP Server objects where you want to install the support pack upgrade, then click OK.

   You can browse for NetWare servers by selecting eDirectory Trees from a drop-down box, or browse for Windows servers by selecting Microsoft Domains (or Microsoft Active Directory) from a drop-down box. You can select servers in the following ways:

   • Select servers individually or in multiples by using the Ctrl and Shift keys
   • Select servers in groups by selecting eDirectory containers, Windows workgroups, or Microsoft domains, then clicking the Add All Servers button

     IMPORTANT:  If you choose to remotely install the Inventory Agent or the Remote Management Agent on a Windows 2003 server configured as Domain Controller, you must specify the hostname or the IP address of the server in the Add Server Via Hostname/IP Address field.

   • Select all NetWare servers in the tree by selecting the tree and then clicking the Add All Servers button

   IMPORTANT:  If you select Add All Servers, the Selected Servers list box includes servers that cannot be upgraded (such as those that do not have ZENworks 6.5 installed). Then, when you click OK to continue, those servers will not be included on the Server Selection page. However, for each server that is not included, a message is displayed indicating this, and you must click OK to continue. To speed up the process, if you can determine in the Selected Servers listing which servers do not have ZENworks 6.5 installed, remove them from this list before clicking OK to continue to the Server Selection page.

   For more information on using the Add Servers dialog box, click its Help button.

   Make sure that you have selected all of the NetWare and Windows servers that you want to upgrade to the support pack before exiting the Add Servers dialog box.

   The selected servers are displayed below the Local Machine option on the Server Selection page:

   
   

   The ZENworks 6.5 Server Management components that have been installed and can upgraded to the support pack are indicated by a check mark in their check boxes. Click the plus signs to expand the tree structure to view the components.

3. You cannot install a support pack to both a virtual server's cluster object and the NCP Server objects for each of its nodes; therefore, if you have selected both, you must remove one or the other to prevent errors caused by zfs.ncf being run from two different locations in the cluster.

   For more information, see Cluster Issues with Upgrading.

4. Click Next and continue with Review the Support Pack Upgrade Summary.

Review the Support Pack Upgrade Summary

1. On the Installation Summary page, review the information to determine if the wizard will be doing what you planned.

   You can click Back to make changes.

2. Click Finish to begin the support pack upgrade process.

3. After the support pack wizard has finished, review the installation log file to determine whether any components failed to install.

   The log file is located in the installation machine's temporary directory as determined in its Windows environment settings. Examples:

   Policy and Distribution Services: 

   %temp%\_resnnn.txt

   where nnn is increased incrementally each time a new log is created.

   Server Inventory: 

   %temp%\invrc.log

4. After successfully upgrading the software to the support pack, click Exit to close the wizard.

   At this time, the software has been upgraded to the support pack and the Server Management services should be restarting on the upgraded servers, if those services were running on the server prior to being upgraded.

   If a server did not have its Server Management services running before it was upgraded, you must restart them manually. These instructions are provided in the one of the next sections.

5. Continue with Upgrading the Novell iManager Plug-Ins.

Upgrading the Novell iManager Plug-Ins

This section is only applicable to Policy and Distribution Services.

If you have Novell iManager 2.0.2 or 2.5 installed in your network, and you need to upgrade the iManager plug-ins to ZENworks 6.5, or install the plug-ins for the first time, do the following:

1. Run winsetup.exe.

   Winsetup.exe can be found at:

   download_location\zen65sp1\winsetup.exe

   or

   download_location\zen65sp2\winsetup.exe

   where download_location depends on where you unzipped the download file. The default is c:\temp.

   This starts the wizard that contains the support pack upgrade menu options.

   For instructions on downloading the support pack file containing the winsetup.exe file, see the ZENworks 6.5 Server Management Support Pack Readme on the ZENworks 6.5 Web site.

2. On the main menu, select Server Management.

3. Select Web-Based Management Components to start the wizard and display the License Agreement page.

   
   

4. Accept the License Agreement, then click Next to view the Login Information page.

   
   

5. Fill in the fields:

   DNS/IP Address: Specify the address of the server where iManager is installed.

   Port: Specify the port number to use when communicating with iManager. It is most likely 443 if SSL is used; if not, use 8080.

   Use SSL: By default, this check box is not selected. If you have iManager configured to use SSL, you should enable this check box.

   iManager Username: Specify the iManager (fully distinguished) login name of the user with rights to iManager. This must be entered in the format indicated (for example, cn=admin.o=novell). Installation cannot continue if the username cannot authenticate.

   iManager Password: Specify the iManager password of the user running the wizard.

   Install the Policy and Distribution Services Plug-Ins to Novell iManager: Select the check box to install the Remote Web Console and Tiered Electronic Distribution plug-ins to iManager so that you can manage these components from a Web browser.

   Install the ZENworks Certificate Authority: Select the check box to install the ZENworks certificate authority servlet for inter-server communications security. This provides additional security to ensure that data received from outside your secured network is from a trusted source, that it has not been tampered with en route, and that the data received can be trusted by other machines. This is accomplished through the use of signed security certificates and digital signatures.

6. Click Next to view the Summary page.

   
   

   The installation summary indicates that the selected Web components are to be installed to the Tomcat installation directory.

7. Click Finish.

8. When the installation has completed, click Yes to view the installation log file.

   If the log file contains errors, you can print it for reference. To look up error messages, see Installation Error Messages. Correct the error, then repeat the installation steps.

   The ZENworks Server Management role in iManager should still be set up, because the information for it is stored in eDirectory.

9. After successfully upgrading the iManager plug-ins, close the log file.

10. If you installed the plug-ins to iManager 2.5, do the following:

    1. Log in to iManager 2.5.

    2. When prompted with an install/upgrade task, install the new or updated plug-ins.

11. For iManager to recognize the new plug-ins, stop Tomcat, then restart Tomcat:

    • NetWare  

      Stop: tc4stop.ncf

      Start: tomcat4.ncf

    • Windows 

      In the Services window, start or stop the Tomcat service.

    • Linux 

      Restart: /etc/init.d/tomcat4 restart

      or:

      Stop: /etc/init.d/tomcat4 stop

      Start: /etc/init.d/tomcat4 start

12. Continue with Starting the Services.

Starting the Services

If the support pack upgrade did not automatically stop and restart the services, or the services were not running before you upgraded the server, and you want the services to be running at this time, start the services at this time.

IMPORTANT:  If you have upgraded the Inventory server, you must manaully start the Inventory service after the support pack upgrade.

• On NetWare Servers
• On Windows Servers

Verifying That the Services Are Running Successfully

• On NetWare Servers
• On Windows Servers

Verifying That the Server Has Been Upgraded to the Support Pack

• Using iManager
• On a NetWare Server
• On a Windows Server

volume:\zenworkszfsversion.log

Repeating the Upgrade

You might need to run the GUI wizard again for the following reasons:

• If you are upgrading incrementally, repeat the upgrade instructions beginning with Upgrading to a Support Pack.

  You can also do this at a later date, because ZENworks 6.5 servers that are upgraded to the support pack work with ZENworks 6.5 servers that are not yet upgraded to the support pack. In other words, ZENworks 6.5 Distributors can send its Distributions to ZENworks 6.5 SPx Subscribers.

• If you have other workstations where the Server Management snap-ins to ConsoleOne are installed, you can repeat the upgrade instructions beginning with Upgrading to a Support Pack on each of those machines to upgrade them to the support pack. You do not need to select any servers. This ConsoleOne upgrade on workstations can be performed at any time.
• If you have Linux or Solaris servers to upgrade to the support pack, continue with Upgrading Policy and Distribution Services on Linux and Solaris Servers. Otherwise, you have completed upgrading Policy-Enabled Server Management to the support pack, except for the following post-upgrade tasks:
  • Post-Upgrade Inventory Task
  • Post-Upgrade Manual Distribution Task

Post-Upgrade Inventory Task

1. Stop the Inventory service.

2. (Conditional) If a ZENworks 6.5 Inventory server receives ZENworks software dictionary updates from a ZENworks 6.5 SPx Inventory server, you must perform the following tasks on the ZENworks 6.5 Inventory server:

   1. Make a reliable backup of desktopcommonutility.jar located in the Inventory_server_installation_path\zenworks\inv\server\wminv\lib directory.

   2. Copy desktopcommonutility.jar from ZENworks 6.5 SPx Companion CD\companion2\zen65patch\inv\server\wminv\lib to the Inventory_server_installation_path\zenworks\inv\server\wminv\lib directory.

3. Add non-English enumerated values for Inventory Attributes to the database by running the AddEnums utility.

   To run the AddEnums utility:

   • On Sybase Inventory database: Perform the steps explained in "Adding Non-English Enumerated Values for Inventory Attributes into the Sybase Inventory Database" in "Server Inventory" in the Novell ZENworks 6.5 Server Management Administration Guide.

   • On Oracle8i Inventory database: Perform the step "Add non-English enumerated (enum) values for certain Inventory attributes into the Inventory database."explained in "Creating the Oracle8i Inventory Database on a Windows Server" in "Server Inventory" in the Novell ZENworks 6.5 Server Management Administration Guide.

   • On Oracle9i Inventory database on Windows: Perform the step "Add non-English enumerated (enum) values for certain Inventory attributes into the Inventory database."explained in "Creating the Oracle9i Inventory Database on a Windows Server" in "Server Inventory"in the Novell ZENworks 6.5 Server Management Administration Guide.

   • On Oracle9i Inventory database on UNIX: Perform the step " Add non-English enumerated (enum) values for certain Inventory attributes into the Inventory database."explained in"Creating the Oracle9i Inventory Database on a UNIX Server" in "Server Inventory" in the Novell ZENworks 6.5 Server Management Administration Guide.

   • On MS SQL Inventory database: Perform the step "(Optional) Add non-English enumerated (enum) values for certain Inventory attributes into the Inventory database." explained in"Configuring the MS SQL Server 2000 Inventory Database" in "Server Inventory" in the Novell ZENworks 6.5 Server Management Administration Guide.

4. Start the Inventory service.

Post-Upgrade Manual Distribution Task

Manual Distributions created in ZENworks 6.5 do not work in a support pack. You must re-create them using the support pack Manual Distribution Wizard.

For steps on creating manual Distributions, see "Manually Importing and Exporting Distributions" in the ZENworks 6.5 Server Management Administration Guide.

Running the Upgrade Script

Perform the following tasks individually on each Linux and Solaris server to upgrade it from ZENworks 6.5 Server Management to the support pack:

1. Review the ZENworks 6.5 Server Management Support Pack Readme on the ZENworks 6.5 Web site for any last-minute information concerning upgrading to the support pack.

2. Log in as root.

3. If you are running X Windows on the Linux or Solaris server, open an XTerm window.

4. To run the Policy and Distribution Services script, enter one of the following commands in an XTerm window:

   Red Hat Linux: /mnt/cdrom/ZfS/TedPol/platform/zfs-pds-upgrade

   SUSE LINUX: /media/cdrom/ZfS/TedPol/platform/zfs-pds-upgrade

   where platform is either Linux or Solaris.

5. Press Enter to display the license agreement, press the Spacebar to scroll through the license agreement, type y, then press Enter to accept the license agreement.

   The following is displayed (including errors, if any) for a Linux installation while the server is upgraded:

   Installing the novell-zen-zfs RPM... 
   Preparing...         ######################################## [100%] 
      1:novell-zen-zfs    ########################################### [100%]

   Error messages are displayed at this point. After any error messages, the upgrade concludes by displaying the following:

   ZENworks Server Management Policy and Distribution Services has been restarted. 
   You may check its status by running: 
     /etc/init.d/novell-zfs status 
   You can reconfigure this service by running: 
     /opt/novell/bin/zfs-pds-configure

6. To verify that Policy and Distribution Services is running, enter:

   /etc/init.d/novell-zfs status

   Policy and Distribution Services is now ready to use on your Linux or Solaris server.

7. Repeat Step 2 through Step 6 on each ZENworks 6.5 Server Management server to be upgraded.

8. Continue with Verifying That the Server Has Been Upgraded to the Support Pack.

Verifying That the Server Has Been Upgraded to the Support Pack

• Using iManager
• On a Linux Server
• On a Solaris Server

Pre-upgrade Checklist

To prepare for upgrading Management and Monitoring Services component of ZENworks 6.5 Server Management:

• Review the ZENworks 6.5 Server Management Support Pack Readme on the ZENworks 6.5 Web site for any last-minute information concerning upgrading to the support pack.
• Make sure you have fulfilled all of the installation requirements listed in Preparation.
• Make sure that you have installed the Management and Monitoring Services Site Server of ZENworks 6.5 Server Management and ZENworks 6.5 Server Management SP 1.
• To upgrade the Server Management Agent^TM (NMA), ensure that you have installed NMA 6.0.3, which shipped with ZENworks 6.5 Server Management and ZENworks 6.5 Server Management SP 1.
• To upgrade the Advanced Trending agent (ATA), make sure that you have installed ATA 6.5, which shipped with Zenworks 6.5 Server Management.
• Authenticate to the eDirectory tree that contains all of the NetWare servers that you want to upgrade.
• At the server console prompt, enter stopmms to stop the Management and Monitoring Services. It may take time to stop the services.

  Use "java -show" command to verify that following Java services are absent:

  com.novell.zfs.mms.utility.servicemanager.zfs_mms_LanzSlpDis

  com.novell.zfs.mms.utility.servicemanager.zfs_mms_Services

Upgrading to a Support Pack

1. Run winsetup.exe.

   Winsetup.exe is found at:

   download_location\zen65sp1\winsetup.exe

   or

   download_location\zen65sp2\winsetup.exe

   where download_location depends on where you unzipped the download file. The default is c:\temp.

   This starts the wizard that contains the support pack upgrade menu options.

   For instructions on downloading the support pack file containing the winsetup.exe file, see the ZENworks 6.5 Server Management Support Pack Readme on the ZENworks 6.5 Web site.

2. On the main menu, select Server Management.

3. Select the Management and Monitoring Services option.

4. Select the Site Management Services and Agents option.

   The Management and Monitoring Services Upgrade Installation Wizard launches.

5. Click Next to continue.

6. After you have read and agreed to the Software License Agreement, click Yes to continue with the installation.

7. Select the desired ZENworks 6.5 Server Management support pack components listed in the following table:

   Server Component	Upgrade On
   Management Site Servers	Management server
   Server Management Agent	All NetWare servers that you want to upgrade
   Advanced Trending Agent	All NetWare servers that you want to manage

8. Click Next.

9. If you selected to upgrade the Management Site Servers, complete the following; otherwise, skip to Step 10:

   1. Browse to and select the volume name of the NetWare server that is your management site server, then click Next.

   2. To start the auto-discovery process, select Start the Auto-Discovery Process.

   3. To start the back-end services, select Start the Backend Services on the Server.

   4. To copy the ConsoleOne snap-ins, select Copy ConsoleOne Snap-ins to the Management Site Server.

10. If you selected to upgrade only the Site server, skip to Step 12.

11. If you selected to upgrade the Server Management Agent or Advanced Trending Agent, select the NetWare servers to upgrade on each server, then click Next.

12. Review the summary list of selections you made in the preceding steps.

    To change a setting, click Back.

13. Click Finish to upgrade ZENworks 6.5 Server Management to the support pack.

14. If you chose not to start all the backend services and the auto-discovery process during the upgrade, you need to manually start the backend services and the auto-discovery process now.

    For Managed servers on NetWare, the ZENworks agents are automatically started.

15. Continue with Upgrade the ConsoleOne Snap-Ins.

Upgrade the ConsoleOne Snap-Ins

You can install multiple management consoles for accessing data on a management server. You must have Admin rights to the workstation to install the management console software on a Windows 2000/XP workstation.

To upgrade the ZENworks Server Management ConsoleOne software:

1. If you want to upgrade a remote server, you need to log in as an administrator or a user with Admin equivalent rights.

2. Run winsetup.exe.

   Winsetup.exe is found at:

   download_location\zen65sp1\winsetup.exe

   or

   download_location\zen65sp2\winsetup.exe

   where download_location depends on where you unzipped the download file. The default is c:\temp.

   This starts the wizard that contains the support pack upgrade menu options.

   For instructions on downloading the support pack file containing the winsetup.exe file, see the ZENworks 6.5 Server Management Support Pack Readme on the ZENworks 6.5 Web site.

3. On the main menu, select Server Management.

4. Select Management and Monitoring Services, the select Site Management ConsoleOne Snap-ins.

5. Specify a destination folder for the snap-ins or click Next to accept the default destination folder.

   The snap-in files are installed.

6. Select to view the Readme file, then click Finish.