You can upgrade the server from ZENworks 7.3 Linux Management to ZENworks 7.3 Linux Management with IR1 by performing an in-place upgrade over the previous version.
Review the following sections:
Before performing any type of upgrade, do the following:
Take a reliable backup of your object and data stores, and eDirectory. For more information, see ZENworks Object Store and Data Store Maintenance
in the Novell ZENworks 7.3 Linux Management Administration Guide.
Ensure that eDirectory is listening on port 10389.
Take an image of the ZENworks servers.
Ensure that the ZENworks Linux Management server and the server on which the Oracle or the PostgreSQL database is running are in time sync.
Remove openldap2 server package from the ZENworks Server, if it is installed on platforms other than RHEL 4.
To view the log information of the upgrade process in the zmd-messages.log file, set the value of the zmd preference to in the ZENworks Control Center. For more information on how to set the zmd preference, see Configuring the ZENworks Management Daemon (ZMD) Settings
in the Novell ZENworks 7.3 Linux Management Administration Guide.
If you want to upgrade the ZENworks 7.3 Linux Management server to ZENworks 7.3 Linux Management with IR1 by performing an in-place upgrade, you must additionally perform the following steps on the server if it was previously upgraded from ZENworks 7.2 Linux Management:
Run the following as a bash script:
/etc/init.d/ndsd stop
mv /etc/opt/novell/eDirectory/conf/nds.conf /etc
sed -i "s~/etc/opt/novell/eDirectory/conf~/etc~g" /etc/opt/novell/eDirectory/conf/.edir/instances.0
/etc/init.d/ndsd start
Run the ./zlm-upgrade command to manually upgrade to ZENworks 7.3 Linux Management with IR1.
Performing an in-place upgrade lets you upgrade from a previous ZENworks Linux Management release to ZENworks 7.3 Linux Management with IR1 by using the same ZENworks Primary Server. For example, suppose your Primary Server on your ZENworks 7.3 Linux Management system is installed on a SLES 9 32-bit device and you want to upgrade to ZENworks 7.3 Linux Management with IR1. Using an in-place upgrade results in the previously described ZENworks Linux Management system being upgraded to ZENworks 7.3 Linux Management with IR1 on that same SLES 9 32-bit device.
The upgrade process upgrades the ZENworks Server and lets you create upgrade bundles for each supported platform. The individual upgrade bundles are then pushed to assigned devices to install the new ZENworks Agent on each device.
An in-place upgrade is best suited for smaller ZENworks Linux Management systems consisting of fewer than 100 devices managed by a single ZENworks Primary Server. An in-place upgrade allows for an upgrade without scheduling down-time for the system because the server and devices are upgrading relatively quickly.
You can upgrade the server from ZENworks 7.3 Linux Management to ZENworks 7.3 Linux Management with IR1 in one of the following ways:
Before performing an in-place upgrade, verify if the ZENworks 7.3 Linux Management server was upgraded from ZENworks 7.2 Linux Management. If you have upgraded your ZENworks 7.3 Linux Management server from ZENworks 7.2 Linux Management, upgrading to ZENworks 7.3 Linux Management with IR1 fails because the default path of the eDirectory (8.8) configuration file, nds.conf, is changed from /etc to /etc/opt/novell/eDirectory/conf when you upgrade the server from ZENworks 7.2 Linux Management to ZENworks 7.3 Linux Management.
Do the following to avoid failure while upgrading to ZENworks 7.3 Linux Management with IR1 if the ZENworks Linux Management server was originally upgraded from ZENworks 7.2 Linux Management:
Run the following content as a bash script:
/etc/init.d/ndsd stop mv /etc/opt/novell/eDirectory/conf/nds.conf /etc sed -i "s~/etc/opt/novell/eDirectory/conf~/etc~g" /etc/opt/novell/ eDirectory/conf/.edir/instances.0 /etc/init.d/ndsd start
Run the ./zlm-upgrade command to manually upgrade to ZENworks 7.3 Linux Management with IR1.
Perform the following procedures in the order listed to upgrade the ZENworks Servers:
Make sure that the server is running, and meets the requirements. See Section 2.1, ZENworks Server Requirements.
At the Linux server, mount the Novell ZENworks 7.3 Linux Management with Interim Release 1 media by using the mount device mountpoint command.
For example, mount /dev/cdrom /zlm73.
If you are using an ISO image rather than a physical media, copy the ISO to a temporary folder on the Linux server, then mount the image using the following command:
mount -o loop /tempfolderpath/isomimagename.iso mountpoint
Replace tempfolderpath with the path to the temporary folder and replace mountpoint with the path to the file system location where you want to mount the image. The path specified by mountpoint must already exist.
For example:
mount -o loop /zlm73/ZEN73_LinuxMgmt.iso /zlm73/install
Log in as root, then start the upgrade program from the mount point by running the following command:
./zlm-upgrade
When prompted to upgrade ZENworks Linux Management, enter Y to continue.
Review the Software License Agreement, pressing Page Down to scroll down the page, then enter Y to accept the agreement.
Enter Y when you are asked if you are upgrading a ZENworks Primary Server.
Make sure all ZENworks services on Secondary Servers are stopped. You can execute /opt/novell/zenworks/bin/zlm-config --stop to shut down the services on Secondary Servers.
Press Enter to continue.
The upgrade program stops ZENworks services, subscribes to the upgrade channels, upgrades RPMs, upgrades zmd, runs upgrade scripts, and then upgrades the database schema.
(Conditional) If you have ZENworks Secondary Servers to upgrade, continue with Performing an In-Place Upgrade on a ZENworks Secondary Server.
Continue with Upgrading Managed Devices Manually.
You must upgrade the ZENworks Primary Server before upgrading the ZENworks Secondary Servers. For step-by-step information, see Performing an In-Place Upgrade on the ZENworks Primary Server.
Start all ZENworks Services on the Secondary Server by running the zlm-config --start command.
Make sure the server meets the requirements. See Section 2.1, ZENworks Server Requirements.
At the Linux server, mount the Novell ZENworks 7.3 Linux Management with Interim Release 1 Server media by using the mount device mountpoint command.
For example, mount /dev/cdrom /zlm73.
If you are using an ISO image rather than a physical media, copy the ISO to a temporary folder on the Linux server, then mount the image using the following command:
mount -o loop /tempfolderpath/isoimagename.iso mountpoint
Replace tempfolderpath with the path to the temporary folder and replace mountpoint with the path to the file system location where you want to mount the image. The path specified by mountpoint must already exist.
For example:
mount -o loop /zlm73/ZEN73_LinuxMgmt.iso /zlm73/install
Log in as root, then start the upgrade program from the mount point by running the following command:
./zlm-upgrade
When prompted to upgrade ZENworks Linux Management, enter Y to continue.
Review the Software License Agreement, pressing Page Down to scroll down the page, then enter Y to accept the agreement.
The install program stops ZENworks services, subscribes to the upgrade channels, upgrades RPMs, upgrades zmd, runs upgrade scripts, and then restarts the ZENworks services.
Enter N when you are asked if you are upgrading a ZENworks Primary Server.
Enter Y when you are asked if you have upgraded the ZENworks Primary Server.
The upgrade program stops ZENworks services, subscribes to the upgrade channels, upgrades RPMs, upgrades zmd, and runs upgrade scripts.
After the upgrade is complete, the ZENworks services are restarted. This might take a few minutes.
Manually copy ostargets.xml from /var/opt/novell/zenworks/lib/www/ on the ZENworks Primary Server to /var/opt/novell/zenworks/lib/www/ on the Secondary Server.
Change the ownership of ostargets.xml to zenworks by executing chown zenworks: zenworks /var/opt/novell/zenworks/lib/www/ostargets.xml at the server console prompt.
(Conditional) Repeat Step 1 through Step 10 for each ZENworks Secondary Server that you want to upgrade.
Continue with Upgrading Managed Devices Manually.
or
Continue with Upgrading Managed Devices by Using Upgrade Bundles.
Apply ZENworks 7.3 Linux Management Hot Patch 2. For more information on how to obtain and apply the Hot Patch, see TID 7003346 at Novell Support.
Upgrading the managed devices to ZENworks 7.3 Linux Management with IR1 installs the new ZENworks Agent.
You can upgrade the managed devices from ZENworks 7.3 Linux Management to ZENworks 7.3 Linux Management with IR1 in one of the following ways:
Make sure the managed device meets the requirements. See Section 2.3, Managed Device Requirements.
At the Linux managed device, mount the Novell ZENworks 7.3 Linux Management with Interim Release 1 Agent media by using the mount device mountpoint command.
For example, mount /dev/cdrom /zlm73.
If you are using an ISO image rather than a physical media, copy the ISO to a temporary folder on the Linux managed device, then mount the image using the following command:
mount -o loop /tempfolderpath/isoimagename.iso mountpoint
Replace tempfolderpath with the path to the temporary folder and replace mountpoint with the path to the file system location you want to mount the image. The path specified by mountpoint must already exist.
For example:
mount -o loop /zlm73/ZEN73_LinuxMgmt.iso /zlm73/install
Log in as root, then start the upgrade program from the mount point by running the following command:
./zlm-upgrade
When prompted to upgrade ZENworks Linux Management, enter Y to continue.
Review the Software License Agreement, pressing Page Down to scroll down the page, then enter Y to accept the agreement.
The install program stops ZENworks services, subscribes to the upgrade channels, upgrades RPMs, upgrades zmd, runs upgrade scripts, and then restarts the ZENworks services.
Upgrading managed devices to ZENworks 7.3 Linux Management with IR1 installs the new ZENworks Agent.
Make sure the managed device meets the requirements. See Section 2.3, Managed Device Requirements.
Complete the following tasks in the order listed:
On the ZENworks Linux Management server, mount the agent ISO by using the following command:
mount -o loop /tempfolderpath/isoimagename.iso mountpoint
Run the ./zlm-upgrade -b command to create an upgrade bundle on the ZENworks Linux Management server.
The command lists the platforms for which you can create the upgrade bundle.
Type the desired platform and press Enter.
In the ZENworks Control Center, click the
tab.Click the folder that you created while performing an in-place upgrade on the ZENworks Primary Server to hold the upgrade bundles.
Click the underlined name of the desired upgrade bundle to display its details.
Click the
tab.In the
section at the bottom of the Details page, click to display the New Scriptable Action dialog box.In the
drop-down list, select .In the
drop-down list, select .Paste the contents of the pre-install.sh script file into the box. You can access the script file from the /data directory located within the directory on which ZENworks 7.3 Linux Management with IR1 is mounted. For example, if ZENworks 7.3 Linux Management with IR1 is mounted on /zlm73/install, the pre-install.sh script file resides in the /zlm73/install/data directory.
If the managed device has bundle locks or package locks (package-locks.xml), the Pre-Installation script takes a backup of the bundle locks or package locks and places the backup in the /tmp/zmd directory.
Click
.In the
section at the bottom of the Details page, click to display the New Scriptable Action dialog box.In the
drop-down list, select .In the
drop down list, select .Paste the contents of the post-install.sh script file into the box. You can access the script file from the /data directory located within the directory on which ZENworks 7.3 Linux Management with IR1 is mounted. For example, if ZENworks 7.3 Linux Management with IR1 is mounted on /zlm73/install, the post-install.sh script file resides in the /zlm73/install/data directory.
NOTE:In the post-install.sh script file, the messages indicating the progress of the upgrade are commented out by default. If you want the messages to be displayed on the managed device, uncomment the messages.
The Post Installation script performs the following tasks:
Restores the bundle locks and package locks backup from the /tmp/zmd directory to the appropriate directories.
Creates the /tmp/zmd/upgrade_final.sh shell script that automatically stops the zmd service, removes the system catalogs, and restarts the service.
Uses the atd server to assign a scheduled task and execute the upgrade_final.sh shell script two minutes after the post-install.sh has completed execution.
Click
.Click
at the bottom of the Details page.In the RPM Package Bundle Settings section of the Details page, click
to deploy the new version of the bundle.Continue with Creating Catalogs for Upgrade Bundles.
In the ZENworks Control Center, click the
tab.Click
, then click to open the Create New Catalog Wizard.Specify a name for the catalog, then click
to display the Catalog Attributes page.Click
to display the Summary page.On the Summary page, click
.Click
to display the Select Bundles dialog box.Navigate to and click the desired upgrade bundle to move it to the
list, then click .Click
to display the Catalog Assignments page.Click
, navigate to and click the desired devices to move them to the list, then click to display the Bundles Options page.Click
to display the Finish page, review the information, then click .Depending on your needs, continue with Upgrading Managed Devices Other Than SLES 10 and SLED 10 by Using an Upgrade Bundle or Upgrading SLES 10 or SLED 10 Managed Devices by Using an Upgrade Bundle.
In the ZENworks Control Center, click the
tab.Click
, then click to display the Policy Type page.Select
, then click to display the Policy Name page.Specify a name for the policy, then click
to display the Remote Execute Policy page.From the
drop-down list, choose .Paste the contents of the policy.sh script file into the box. You can access the script file from the mount point /data directory.
The Policy script performs the following tasks:
Subscribes to the catalog containing the upgrade bundle.
Installs the upgrade bundle on the managed device.
Edit the script so that catalog_name is the catalog you created in Creating Catalogs for Upgrade Bundles and bundle is the bundle that you specified while creating the catalog (Step 7).
Click
to display the Summary page, then click to display the Policy Assignments page.Click
to display the Select Assignments dialog box, browse to and select the devices to which you want to assign the Remote Execute policy, then click .Click
to display the Policy Schedule page.In the
drop-down list, select , specify a start date and time to apply the policy, then click to display the Policy Groups page.NOTE:If you want to verify the upgrade immediately, set the start date to today and the start time to 12 a.m. The Remote Execute policy is executed at the next scheduled refresh for the devices. Alternately, you can manually refresh the devices.
Click
to display the Finish page, then click .The Remote Execute policy is enforced as scheduled, after the managed devices’ next scheduled refresh. If the time you specified in Step 11 occurs before the next scheduled refresh, the policy is enforced on the next refresh.
IMPORTANT:It takes approximately five minutes for the upgrade bundle to be installed and for the upgrade process to be performed. Do not perform any rug commands such as rug ref during the upgrade process. Executing rug commands during the upgrade process might cause the process to fail.
After the upgrade completes, you can verify that the upgrade was successful by executing the rug ping command or refer to upgrade.log. The upgrade was successful if the version of zmd is 7.3.0. If you perform the rug ping command prematurely, you receive an exception message. You can recover by stopping and restarting zmd. The /tmp/zmd/upgrade.log must contain the “Starting ZENworks Management Daemon...” message in the last line.
Perform the following steps on the SLES 10 or SLED 10 managed device:
Ensure that the agent is registered to the ZENworks Linux Management server. For more information on how to register devices, see Registering Devices
in the Novell ZENworks 7.3 Linux Management Administration Guide.
Execute the /usr/bin/rug sub catalog_name command, where catalog_name is the catalog assigned to the managed device.
Execute the /usr/bin/rug bin -y upgrade_bundle_name command, where upgrade_bundle_name is the upgrade bundle in the catalog assigned to the managed device.
IMPORTANT:It takes approximately five minutes for the upgrade bundle to be installed and for the upgrade process to be performed. Do not perform any rug commands such as rug ref during the upgrade process. Executing rug commands during the upgrade process might cause the process to fail.
After the upgrade completes, you can verify that the upgrade was successful by executing the rug ping command or refer to upgrade.log. The upgrade was successful if the version of zmd is 7.3.0. If you perform the rug ping command prematurely, you receive an exception message. You can recover by stopping and restarting zmd. The /tmp/zmd/upgrade.log must contain the “Starting ZENworks Management Daemon...” message in the last line.
If the device does not have the X Window System installed:
In ZENworks Control Center, click the upgrade bundle.
Click the
tab.In the
panel, select the following packages:Click
> .(Optional) If SLES 10 or SLED 10 are running on Dell server and the managed devices have the default zmd agent installed, do the following if you want to collect the Dell inventory of the devices:
In the
panel, select novell-zenworks-zmd-oem.Click
> .Upgrading managed devices to ZENworks 7.3 Linux Management with IR1 installs the new ZENworks Agent.
Apply ZENworks 7.3 Linux Management Hot Patch 2. For more information on how to obtain and apply the Hot Patch, see TID 7003346 at Novell Support.