10.1 Replacing the First Primary Server with the Second Primary Server

You can replace the first Primary Server in your Management Zone with an existing second Primary Server or with a new server. If you choose to replace the first Primary Server with a new server that has a different hostname and IP address, you must install ZENworks 10 Asset Management on the new server in the same Management Zone. Consequently, the new server becomes the second Primary Server.

The first Primary Server and the second Primary Server must have the same version of the ZENworks 10 Asset Management installed.

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

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

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

It has not been tested with ZENworks Reporting Server.

This scenario is not supported on Windows to Linux and vice-versa platform combinations.

To replace the first Primary Server with the second Primary Server:

  1. Make sure that all the contents of the content-repo directory of the first Primary Server are replicated to the second 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.

  2. Export the Certificate Authority role.

    1. Take a reliable backup of the Certificate Authority of the first Primary Server.

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

      IMPORTANT:You must use the -d option with the zman certificate-authority-export command to remove the Certificate Authority role of the local server.

    2. Restore the backed-up Certificate Authority on the second Primary Server.

      For detailed information on how to restore a backed-up Certificate Authority, see Section 9.4, Restoring the Certificate Authority.

  3. In the default closest server rule at the Management Zone level, move the first Primary Server as the last entry in the servers list.

    1. In ZENworks Control Center, click the Configuration tab.

    2. In the Management Zone Settings panel, click Infrastructure Management > Closest Server Default Rule.

    3. In the Collection Servers list, select the check box next to the first Primary Server, then click Move Down until the server is the last entry in the list.

    4. In the Content Servers list, select the check box next to the first Primary Server, then click Move Down until the server is the last entry in the list.

    5. In the Configuration Servers list, select the check box next to the first Primary Server, then click Move Down until the server is the last entry in the list.

    6. Click OK.

  4. (Conditional) If you have any additional closest server rules configured, remove the first Primary Server from the rules.

    1. In ZENworks Control Center, click the Configuration tab.

    2. In the Management Zone Settings panel, click Infrastructure Management > Closest Server Rules.

    3. Select a closest server rule, then click Edit.

      The Rule Construction dialog box is displayed.

    4. In the Collection Servers list, select the check box next to the first Primary Server, then click Remove.

    5. In the Content Servers list, select the check box next to the first Primary Server, then click Remove.

    6. In the Configuration Servers list, select the check box next to the first Primary Server, then click Remove.

    7. Click OK twice.

  5. Refresh all the devices (Primary Serves, Satellites, and managed devices) in the Management Zone so that they get the new closest server rules.

  6. (Optional) Reregister all the managed devices and Satellites to the new Primary Server.

    NOTE:You can choose not to perform this step because there is no loss in the functionality. However, the ZENworks icon and the zac zone-config command continue to display the IP address and the host name of the retired Primary Server.

    To reregister the devices, perform the following tasks on all the devices:

    1. Unregister the device from the Management Zone by running the following command:

      zac unr -f

    2. Register the device in the Management Zone by running the following command:

      zac reg https://ZENworks_Server_DNS_name:port_number

      For more information about zac, view the zac man page (man zac) on the device or see the ZENworks 10 Asset Management Command Line Utilities Reference.

  7. (Conditional) Move the database to another device 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 first Primary Server and you do not plan to use the device after uninstalling the Primary Server.

    To move the database to another device:

    1. (Conditional) If you are using an external database, ensure that you have a reliable backup of the database.

    2. Obtain the credentials of the database.

      To procure the credentials of the internal database, use one of the following commands:

      zman dgc -U administrator_name -P administrator_password

      or

      zman database-get-credentials -U administrator_name -P administrator_password

      To obtain the credentials of the external database, contact the database administrator.

    3. Remove the database role from the first Primary Server:

      1. Log into the database.

      2. In the SQL editor, execute the following SQL query to remove the database role entry for the first Primary Server from the zZENServerRoles table:

        delete from zZENServerRoles where Roles=‘Database’;

      3. In the SQL editor, execute the following SQL command:

        commit;

    4. If the database is installed on the same device as that of the first Primary Server, move the database.

      Internal Sybase: For detailed information on how to move the data from an internal Sybase database to an external Sybase database, see Section 28.6, Moving the Data from an Embedded Sybase Database to an External Sybase Database.

      External Sybase: For detailed information on how to move the data from one external Sybase database to another external Sybase database, see Section 29.3, Moving the Data from One External Sybase Database to another External Sybase Database.

      MS SQL: For detailed information on how to move the data to a new MS SQL database, see the MS SQL documentation. Later on, perform the steps described in Section 29.6, Configuring the ZENworks Server to Point to the New MS SQL Database Containing Data Moved from Another MS SQL Database.

      Oracle: For detailed information on how to move the data from one Oracle database to another Oracle database, see the Oracle documentation. Later on, perform the steps described in Section 29.7, Configuring the ZENworks Server to Point to the New Oracle Database Containing Data Moved from Another Oracle Database.

  8. Remove all Satellites under the first Primary Server from the Server Hierarchy.

    For more information on how to remove the Satellites from the Server Hierarchy listing in ZENworks Control Center, see Section 6.5, Removing Satellites from the Server Hierarchy.

  9. Retire the first Primary Server by entering one of the following commands at the second Primary Server prompt:

    zman zsret first_primary_server_object_name

    or

    zman zenserver-retire first_primary_server_object_name

    For more information about zman, view the zman man page (man zman) on the server or see zman(1)in the ZENworks 10 Asset Management Command Line Utilities Reference.

  10. After ensuring that all the operations in the Management Zone are working as expected, uninstall ZENworks 10 Asset Management on the first Primary Server.

    For detailed information on how to uninstall ZENworks 10 Asset Management, see Uninstalling ZENworks Software in the ZENworks 10 Asset Management Installation Guide.