2.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 SP3 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 SP3 installed.

NOTE: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. Before replacing the First Primary Server with the Second Primary Server, take a reliable backup of the following on all Primary Servers in the Management Zone:

  2. Ensure 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.

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

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

  5. (Conditional) If the first Primary Server has ZENworks Reporting installed, take a reliable back-up of the reports.

    For more information about backup of ZENworks reports, see Managing the Export Settings in the ZENworks Reporting 5 System Reference.

  6. 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 1.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 1.4, Restoring the Certificate Authority.

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

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

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

  10. (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 SP3 Command Line Utilities Reference.

  11. (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, MasterPrimary role, and CertAuth role from the first Primary Server (applicable for Embedded Sybase):

      1. Log into the database.

      2. In the SQL editor, execute the following SQL queries to remove the corresponding role entries for the first Primary Server from the zZENServerRoles table:

        delete from zZENServerRoles where Roles='Database';
        delete from zZENServerRoles where Roles='MasterPrimary';
        delete from zZENServerRoles where Roles='CertAuth';
        commit;
        
    4. To add the database role to the Second Primary Server (applicable for Embedded Sybase):

      1. Log into the database.

      2. In the SQL editor, execute the following SQL commands to assign the database role, MasterPrimary role, and CertAuth role for the Second Primary Server:

        Insert into zZENServerRoles (id, Roles, position) values (0x<second PS GUID>, 'Database', (select max(position) from zZENServerRoles where id=0x<second PS GUID>)+1);

        Insert into zZENServerRoles (id, Roles, position) values (0x<second PS GUID>, 'MasterPrimary', (select max(position) from zZENServerRoles where id=0x<second PS GUID>)+1);

        Insert into zZENServerRoles (id, Roles, position) values (0x<second PS GUID>, 'CertAuth', (select max(position) from zZENServerRoles where id=0x<second PS GUID>)+1);

        commit;

    5. 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 internal Sybase database, see Moving the Internal Sybase Database from One Primary Server to Another Primary Server in the ZENworks 11 SP3 Database Management Reference.

      External Sybase: For detailed information on how to move the data from one external Sybase database to another external Sybase database, see Moving the Data from One External Sybase Database to another External Sybase Database in the ZENworks 11 SP3 Database Management Reference.

      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 Configuring the ZENworks Server to Point to the New MS SQL Database Containing Data Moved from Another MS SQL Database in the ZENworks 11 SP3 Database Management Reference.

      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 Configuring the ZENworks Server to Point to the New Oracle Database Containing Data Moved from Another Oracle Database in the ZENworks 11 SP3 Database Management Reference.

  12. 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 Removing Satellites from the Server Hierarchy in the ZENworks 11 SP3 Primary Server and Satellite Reference.

  13. (Conditional) On the second Primary Server, install ZENworks Reporting, and restore the reports that you backed-up in Step 5.

    For more information on how to install ZENworks Reporting, see ZENworks Reporting 5 Installation Guide.

    For detailed information about restoring the ZENworks reports. See Managing the Import Settings in the ZENworks Reporting 5 System Reference.

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

    For detailed information on how to uninstall ZENworks Reporting, see ZENworks 11 SP3 Uninstall Guide.

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

    For detailed information on how to uninstall ZENworks 11 SP3, see ZENworks 11 SP3 Uninstall Guide.

    NOTE:If Multizone is configured for this server (which has got replaced with a new Primary Server) as Publisher, then all its subscribers must be updated with the new IP address and certificate of this server.

    1. Log in to ZENworks Control Center (ZCC) of subscribers.

    2. Navigate to Subscribe And Share > Subscriptions > <subscription_name> > Remote Server > Base URL > Edit.

    3. Update the IP address with the new IP address of the Primary Server (Publisher).

    To update the new certificate:

    1. Navigate to Subscribe And Share > Subscriptions > <subscription_name> > Remote Server > Update Certificate.

    2. Update the certificate.