2.2 Replacing an Existing Primary Server with a New Primary Server

If you have only one Primary Server in the Management Zone and if you want to replace the device hosting the Primary Server with a new device that has the same host name and IP address as the old device, you must move the Primary Server to the new device.

The existing Primary Server and the new Primary Server must have the same version of the ZENworks 11 installed.

NOTE:This scenario has been tested on the following platform combinations:

  • Windows Server 2003 (32-bit) to Windows Server 2008 (32-bit)

  • Windows Server 2003 (32-bit) to Windows Server 2008 (64-bit)

  • SUSE Linux Enterprise Server (SLES) 11 (32-bit) to SLES 11 (32-bit)

  • SUSE Linux Enterprise Server (SLES) 11 (32-bit) to SLES 11 (64-bit)

This scenario is not supported on Windows to Linux and vice-versa platform combinations. It applies to platforms having the same network identity.

  1. Take a reliable backup of the existing ZENworks Server.

    For detailed information on how to take a backup of the ZENworks Server, see Section 1.1, Backing Up a ZENworks Server.

  2. (Conditional) Take a reliable backup of the certificate authority of the Primary Server.

    For detailed information on how to take a backup of the certificate authority, see Section 1.3, Backing Up the Certificate Authority.

    During the ZENworks Server backup, certificates are backed up for Primary Servers having an internal Certificate Authority and the same network identity (IP, FQDN, and Cert). Also, during the ZENworks Server restore, the Certificate Authority is restored.

  3. (Conditional) Take a reliable backup of database in any of the following scenarios:

    • You are using an internal ZENworks database (embedded Sybase SQL Anywhere).

    • You are using an external database installed on the device hosting the Primary Server and you do not plan to use the device after uninstalling the Primary Server.

    For detailed information on how to take a backup of an internal database, see in Backing Up the Embedded Sybase SQL Anywhere Database in the ZENworks 11 Database Management Reference.

    To take a backup of an external database, see the documentation for the database.

  4. (Conditional) If the first Primary Server has ZENworks Reporting Server installed, take a reliable back-up of the reports by using the following zman command:

    zman rpsv (destination folder)

    For detailed information about the zman Report Commands, view the zman man page (man zman) on the server or see zman(1) in ZENworks 11 Command Line Utilities Reference.

  5. Stop all the ZENworks services on the Primary Server.

    For detailed information on how to stop the ZENworks services on Windows, see Stopping the ZENworks Services in the ZENworks 11 Primary Server and Satellite Reference. For detailed information on how to stop the ZENworks services on Linux, see Stopping the ZENworks Services in the ZENworks 11 Primary Server and Satellite Reference.

  6. Take a reliable backup of the content-repo directory of the Primary Server.

    The content-repo directory is located in the ZENworks_installation_directory\work\ directory on Windows and in the /var/opt/novell/zenworks/ directory on Linux.

  7. Disconnect the device from the network.

  8. Install ZENworks 11 on the new server with the following settings that are same as that of the old Primary Server:

    • Installation drive and path. For Windows, ensure that the installation path points to C:\Program Files (x86).

    • ZENworks Ports

    • Management Zone name

    For detailed information on how to install ZENworks 11, see Installing the ZENworks Server in the ZENworks 11 Server Installation Guide.

  9. If you are replacing a Windows 32-bit Server with a 64-bit Server, edit the database configuration file to point to C:\Program Files (x86). Also, edit thetomcat\conf\server.xml file to point to a folder in C:\Program Files (x86). This applies only to Windows Servers. For Linux Servers, no changes are required.

  10. Do the following on the new Primary Server:

    1. Restore the backed-up ZENworks Server.

      For detailed information on how to restore the ZENworks Server, see Section 1.2, Restoring a ZENworks Server.

    2. (Conditional) Restore the backed-up database.

      For detailed information on how to restore the internal ZENworks database, see in Restoring the Embedded Sybase SQL Anywhere Database in the ZENworks 11 Database Management Reference.

    3. (Conditional) Restore the backed-up Certificate Authority.

      For detailed information on how to restore the certificate authority, see Section 1.4, Restoring the Certificate Authority.

    4. Re-create all the default and custom deployment packages.

      Default Deployment Packages: At the server’s command prompt, enter the following command:

      novell-zenworks-configure -c CreateExtractorPacks -Z

      Custom Deployment Packages: At the server’s command prompt, enter the following command:

      novell-zenworks-configure -c RebuildCustomPacks -Z

    5. Copy the backed-up content-repo directory to the ZENworks_installation_directory\work\ directory on Windows or to the /var/opt/novell/zenworks/ directory on Linux.

    6. (Conditional) Run the following scripts:

      • delete from zzenserverroles where Roles = ‘ReportCMSServer’ or Roles = ‘ReportApplicationServer’

      • delete from zopaquedata where name = ‘boe.mysql.database.pwd’

      • delete from zopaquedata where name like ‘%zone.configuration.reports%’

    7. (Conditional) On the new Primary Server, install ZENworks Reporting Server. For detailed information on how to install ZENworks Reporting Server, see ZENworks 11 Reporting Server Installation Guide.

    8. (Conditional) If you install ZENworks Reporting Server on the new Primary Server, restore the reports that you backed-up in Step 4 by using the following zman command:

      zman rpld (source folder)

      For detailed information about the zman Report Commands, view the zman man page (man zman) on the server or see zman(1) in ZENworks 11 Command Line Utilities Reference.

      NOTE:If you change the SSL configuration of ZCM, then follow the procedure Configuring the ZENworks Reporting Server Tomcat Server When the ZENworks Certificate Changes in Section 4.0, Reconfiguring a Zone Certificate Before It Expires.

  11. Ensure that the new server is running correctly. Subsequently, uninstall ZENworks 11 from the old device.

    For detailed information on how to uninstall ZENworks 11, see Uninstalling ZENworks Software in the ZENworks 11 Server Installation Guide.

WARNING:After the new Primary Server starts running, you must disconnect the old Primary Server from the network and uninstall ZENworks, or disable ZENworks services so that it cannot register back to the zone.

NOTE:If you install the ZENworks Reporting Server immediately after installing ZENworks Configuration Management before restoring previous zone’s database and certificate authority, do the following:

  1. Back up the BOE mysql database:

    1. Run the following script and save it as a text file:

      select data from zopaquedata where name = 'boe.mysql.database.pwd'

    2. Restore the database. Copy the data from the text file and run the following script:

      Update zOpaquedata set data='value from text file' where name=’boe.mysql.database.pwd’.