33.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 11 on the new server in the same Management Zone. Consequently, the new server becomes the first Primary Server.

The first Primary Server and the second 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)

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

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. (Conditional) If the first Primary Server has add-on images:

    1. In ZENworks Control Center for the second Primary Server, click the Bundles tab, then click the Imaging bundle.

      The Summary tab is displayed.

    2. Click Edit next to Add-on Image File.

      The Bundle Add-on Image wizard is displayed.

    3. On the Add Image Server Address page, select the first Primary Server that is associated with the bundle, then click Remove.

    4. Click Add.

    5. Click Open Folder icon next to the Servers folder to navigate through the folders until you find the second Primary Server.

    6. Select the second Primary Server to display its name in the Selected list, then click OK.

    7. Click Finish.

      The add-on image is associated with the second Primary Server, and the add-on image content is created on the second Primary Server.

    8. In the Summary tab of the bundle, click the Increment Version underlined link for Version, then click Yes in the Confirm Version Increment dialog box.

  3. (Conditional) If the first Primary Server has a ZENworks Imaging bundle, copy the bundle to the second Primary Server:

    1. Manually copy all the files with the .zmg extension from the /content-repo/images directory of the first Primary Server to the /content-repo/images directory on the second Primary Server.

    2. In ZENworks Control Center of the second Primary Server, click the Bundles tab, then click the Imaging bundle.

    3. Click the Actions tab.

    4. Click the ZENworks Image action.

      The Edit Action dialog box is displayed.

    5. In the ZENworks Image field, click Browse icon.

      The Server and Path Information dialog box is displayed.

    6. In the Server Object, IP or DNS field, click Browse icon to browse for and select the second Primary Server.

    7. In the File Path on Server field, click Browse icon to browse for and select the image.zmg file.

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

    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. 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 32.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 32.4, Restoring the Certificate Authority.

  6. 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.

  7. (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.

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

  9. (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 11 Command Line Utilities Reference.

  10. (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 29.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 30.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 30.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 30.7, Configuring the ZENworks Server to Point to the New Oracle Database Containing Data Moved from Another Oracle Database.

  11. 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 10.5, Removing Satellites from the Server Hierarchy.

  12. (Conditional) If the first Primary Server has ZENworks Reporting Server installed, decommission ZENworks Reporting Server.

    For detailed information on how to decommission an existing instance of ZENworks Reporting Server, see Performing a Backup of Reports before Decommissioning an Existing Instance of ZENworks Reporting Server in the ZENworks 11 Reporting Server Installation Guide.

  13. (Conditional) On the second Primary Server, install ZENworks Reporting Server, and restore the reports that you backed-up in Step 4 by using the zman Report commands.

    For detailed information on how to install ZENworks Reporting Server, see ZENworks 11 Reporting Server Installation Guide.

    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.

  14. 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 11 Command Line Utilities Reference.

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

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

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

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