Novell Doc: ZENworks 10 Configuration Management System Administration Reference - Replacing the First Primary Server with the Second Primary Server

11.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 Configuration 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 Configuration 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:

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.
(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 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.
(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 .
  
  The Server and Path Information dialog box is displayed.
6. In the Server Object, IP or DNS field, click to browse for and select the second Primary Server.
7. In the File Path on Server field, click to browse for and select the image.zmg file.
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 10.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 10.4, Restoring the Certificate Authority.
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.
(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.
Refresh all the devices (Primary Serves, Satellites, and managed devices) in the Management Zone so that they get the new closest server rules.
(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 Configuration Management Command Line Utilities Reference.
(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 33.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 34.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 34.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 34.7, Configuring the ZENworks Server to Point to the New Oracle Database Containing Data Moved from Another Oracle Database.
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 7.5, Removing Satellites from the Server Hierarchy.
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 Configuration Management Command Line Utilities Reference.
After ensuring that all the operations in the Management Zone are working as expected, uninstall ZENworks 10 Configuration Management on the first Primary Server.

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