This article describes server cloning with Presentation Server 4.0 and Presentation Server 4.5.
For XenApp 6, refer to Citrix Documentation Preparing for XenApp Imaging and Provisioning with Windows 2008 R2.
Note: This article amends pages 56-59 of CTX107059 – Advanced Concepts Guide for Presentation Server 4.0.
Server cloning can provide more rapid deployment than a scripted installation. A few steps are required for cloning servers. These steps vary depending on the type of data store used for the farm, and are described in the following sections. Presentation Server is compatible with server cloning, but cloning software can cause the operating system or its add-ons to function incorrectly after being cloned. When using server cloning, it is important to clone one server and test its functionality before deploying the rest of the farm. Also, note that although Citrix supports server cloning if done by documented procedures, it is considered a better practice to use an automated installation process for building and rebuilding servers so that a clean server build is assured.
Caution! Do not image a server with an SSL certificate installed because SSL certificates are unique to the hardware.
Zone settings are not retained when cloning a server. When the Citrix IMA Service on the cloned server starts for the first time, the server joins the default zone. The name of the default zone is the ID of the subnet on which the cloned server resides. When deploying images to servers on multiple subnets, assign zone information for each server after the imaging process completes.
If the Presentation Server's settings are changed when creating a server image, the Presentation Server configuration might not be retained properly so that the data store does not manage configured server information.
Before changing the Security ID (SID) on the machine used to access the Presentation Server Console, add one of the following user accounts as an administrator with full privileges.
A domain administrator
The local administrators group
A local administrator from a machine where the SID is not being changed
Note: You must complete the following tasks before re-imaging a server that is already a member of a server farm. See CTX108361 – The Access Suite Console for Advanced Access Control Shows Different STAs Using the Same STA ID.
To deploy an already created image to a server that already has Presentation Server installed and exists in a current Citrix Farm. A customer might wish to re-image a MetaFrame XP server in a Farm to a newer version, say Presentation Server 4.0. Complete the following steps:
From the Presentation Server Console, remove the list of servers configured to host any applications.
Remove the server from the server farm using CHFarm (CTX736659 – How to Change Farms Using the CHFARM Utility) or by uninstalling Presentation Server.
If CHFarm is used, Presentation Server still must be uninstalled.
If the server entry still exists in the Presentation Server Console server list, right-click the server name and remove it from the server list.
Apply the system image and add the server to the existing server farm.
Important! If a server is not removed from a server farm before a new system image is applied to it, performance problems can result. The Presentation Server Console can display invalid data if the server is returned to the same server farm because the old server’s host record in the data store is applied to the newly imaged server.
If cloning is not an option, you can create custom unattended installation scripts for both the operating system and applications, including Presentation Server.
Note: Removing the WSID (workstation ID) line from the DSN file is no longer necessary when imaging and deploying Presentation Server.
When using Microsoft Access (MSDE), you must install the first server in the new server farm that hosts the data store. You can then create an image of the second server in the farm for the deployment of additional servers.
To image a server for rapid deployment with Access, complete the following steps:
Install the first server in the farm.
Install a second server in the farm with an indirect connection to the data store you created on the first server.
With the second server successfully installed and restarted, log on to the console of the second server as a local or domain administrator.
On the second server, delete the Wfcname.ini file, if it exists, from the root drive of the server.
Stop the Citrix IMA Service using the Services Control Panel. Set the start up type to Manual.
If the Enterprise Edition’s components of Presentation Server are installed, see the paragraph, Cloning Citrix Presentation Server Enterprise Edition Systems in this article.
Take the image of the second server. Then, restart the second server.
Deploy the image obtained in preceding Step 7.
Important! It is important that you use some type of SID generation utility when deploying Windows 2000 Server or Windows Server 2003 images.
To set up the server and verify that it is added, use these steps:
Set the SID of the server with your chosen SID generator.
Rename the new server with a unique name.
Start the Citrix IMA Service and set the service to start automatically.
Verify that the server is successfully added to the farm by running qfarm at a command prompt. If the addition is successful, the newly imaged server appears in the list of servers.
Modify the following registry values:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\IMA
change value “ServerHost” to “[newservername]”
HKEY_CLASSES_ROOT\AppID\{BBBF5400-E091-11D8-AD76-005056C00008}
Note: This subkey might be alphanumerically different - you might need to search for Ctx_SmaUser to find the correct subkey change the value “RunAs” to “ [newservername]\Ctx_SmaUser”.
Note: Verify the existence and validity of Ctx_SmaUser account and its relative NTFS and DCOM permissions.
CTX106393 - Required Permissions and Rights for the Ctx_SmaUser Account
Note: For 64-bit systems with the 64-bit version of Presentation Server 4.0 installed, the correct path is as follows:
\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432NODE\CITRIX\IMA
Restart the server.
When using Microsoft SQL Server, Oracle, or IBM DB2 for the server farm’s data store, you can create an image of the first server in the farm and use it to deploy all other servers.
To image a server for rapid deployment with SQL Server, Oracle, or IBM DB2, use the steps below:
Install the first server in the farm.
When the server is successfully restarted, log on to the console as a local or domain administrator.
Delete the Wfcname.ini file, if it exists, from the root drive of the server.
Stop the Citrix IMA Service and set the startup type to Manual.
If the Enterprise Edition’s components of Presentation Server are installed, see Cloning Citrix Presentation Server Enterprise Edition Systems further in this document.
Take the image of the server and then restart the server.
Deploy the image obtained in Step 6.
Important! It is important that you use some type of SID generation utility when deploying Windows 2000 Server.
To verify that the server is added, follow these steps:
Set the Security ID of the server with your chosen SID generator.
Rename the new server with a unique name.
Manually start the Citrix IMA Service and set the service to start automatically.
Verify that the server is successfully added to the farm by running qfarm at a command prompt on any server in the farm. If the addition is successful, the newly imaged server appears in the list of servers.
Modify the following registry values:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\IMA
change value “ServerHost” to “[newservername]”
HKEY_CLASSES_ROOT\AppID\{BBBF5400-E091-11D8-AD76-005056C00008}
Note: This subkey might be alphanumerically different - you might need to search for Ctx_SmaUser to find the correct subkey.)
change value “RunAs” to “ [newservername]\Ctx_SmaUser”
Note: Verify existence and validity of Ctx_SmaUser account and its relative NTFS and DCOM permissions.
CTX106393 - Required Permissions and Rights for the Ctx_SmaUser Account
Note: For 64-bit systems with the 64-bit version of Presentation Server 4.0 installed, the correct path is as follows:
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432NODE\CITRIX\IMA
Restart the server.
If you are running Resource Manager on a server with Presentation Server Enterprise Edition, you must delete the local database used by Resource Manager (named RMLocalDatabase) so that the cloned server does not retain information from the server you are using as the cloning source. The RMLocalDatabase is installed in Citrix Resource Manager\LocalDB in the default installation directory, <Program Files>\Citrix. On the cloned server, the RMLocalDatabase file is recreated automatically when the Citrix IMA Service starts.
A few manual steps are required for cloning Presentation Servers. These steps vary depending on the type of data store used for the farm, and are described in the following sections. Presentation Server is compatible with server cloning, but cloning software can contain issues that cause the operating system or its add-ons to function incorrectly after being cloned. When using server cloning, it is important to clone one server and test its operation before deploying the rest of the farm.
Caution! Do not attempt to image a server with an SSL certificate installed because SSL certificates are unique to the hardware.
Zone settings are not retained when cloning a server. When the IMA service on the cloned server starts for the first time, the Presentation Server joins the default zone. The name of the default zone is the ID of the subnet on which the cloned server resides. When deploying images to servers on multiple subnets, assign zone information for each server after the imaging process completes.
Prior to changing the Security Identifier (SID) on the machine used to access the Presentation Server Console, add one of the following as a Citrix Administrator with read-write privileges:
A domain administrator
The Local Administrators group
A local administrator from a machine where the SID is not being changed
Caution! Do not attempt to use drive image software to restore an image of a Presentation Server with remapped drives. Remapped drives partially revert to the original configuration on the deployed server rendering the server unusable. Servers with remapped drives may be duplicated using a hardware solution such as Compaq Smart Array controllers with RAID1 drive mirroring.
If you plan to apply an image to a server that is already a member of a Presentation Server farm, you must do the following before applying the image:
To prepare a server in a Presentation Server farm for re-imaging, use the following steps :
From the Presentation Server Console, remove the list of servers configured to host any applications.
Remove the server from the server farm by uninstalling Presentation Server.
If the server entry still exists in the Presentation Server Console server list, right-click and manually remove the server name from the server list.
Apply the system image and add the server to the server farm.
Important! If a server is not removed from a Presentation Server farm before a new system image is applied to it, performance problems can result. The Presentation Server Console can display invalid data if the server is added back to the same server farm. This is because the old server's host record in the data store is applied to the newly imaged server.
If cloning is not an option, such as when configuring with remapped drives, you can create custom unattended installation scripts for both the operating system and applications, including Presentation Server.
Manually install the first server in the new Presentation Server farm that will host the data store. You can image the second server in the farm for the deployment of additional servers.
To image a server for rapid deployment with Access or SQL Express, do the following steps:
Follow all necessary steps from the Citrix Presentation Server Administrator’s Guide to install the first server into the farm.
Install a second server into the farm with an indirect connection to the data store created on the first server.
With the second server successfully installed and restarted, log on to the console of the second server as a local or domain administrator.
On the second server, delete the Wfcname.ini file, if it exists, from the root drive of the server.
Stop the IMA service using the Services Control Panel. Set the startup type to Manual.
Stop the Citrix SMA service using the Services Control Panel. Set the startup type to Manual.
If Enterprise edition components are installed, see Cloning on Presentation Server, Enterprise Edition Systems.
Take the image of the second server and then restart the second server.
Deploy the image obtained in Step 7.
Important! It is important that you use some type of SID generation utility when deploying Windows 2000 or Windows 2003 images.
To set up the server and verify that it is added, use the following steps:
Set the SID of the server with the SID generator of choice.
Rename the new server with a unique name.
Manually start the IMA Service and set the service to start automatically.
Manually start the Citrix SMA Service and set the service to start automatically.
Verify that the server was successfully added to the farm by running qfarm at the command prompt. The newly imaged server appears in the list of servers.
Change the registry value HKEY_LOCAL_MACHINE\software\citrix\IMA\ServerHost (32-bit server) or HKEY_LOCAL_MACHINE\software\Wow6432node\citrix\IMA\ServerHost (64-bit server) to the new server name.
Verify that integrity of data store by running dscheck /full servers at a command prompt on any server in the farm. There should be no invalid server record.
Restart the server.
When using Microsoft SQL Server, Oracle, or IBM DB2 for the server farm data store, you can image the first server in the farm and use it to deploy all other servers.
Note: Removing the WSID line from the DSN file is no longer necessary when imaging and deploying MetaFrame XP with Feature Release 3 or later.
To image a server for rapid deployment with SQL Server, Oracle, or IBM DB2 use the steps below:
Follow the steps from the Presentation Server Administrator’s Guide for installing the first Presentation Server into the farm.
When the server is successfully restarted, log on to the console as a local or domain administrator.
Delete the Wfcname.ini file, if it exists, from the root drive of the server.
Stop the IMA Service and set the startup option to Manual.
Stop the Citrix SMA Service using the Services Control Panel. Set the startup type to Manual.
If Enterprise edition components are installed, see Cloning on Presentation Server, Enterprise Edition Systems.
Take the image of the server and then restart the server.
Deploy the image obtained.
Important! It is important that you use some type of SID generation utility when deploying Windows 2000 and Windows 2003.
To set up the server and verify that it is added, use the following steps:
Set the Security ID of the server with the SID generator of choice.
Rename the new server with a unique name.
Manually start the IMA Service and set the service to start automatically.
Manually start the Citrix SMA Service and set the service to start automatically.
Verify that the server was successfully added to the farm by running qfarm at a command prompt on any server in the farm. The newly imaged server appears in the list of servers.
Change the registry value HKEY_LOCAL_MACHINE\software\citrix\IMA\ServerHost (32-bit server) or HKEY_LOCAL_MACHINE\software\Wow6432node\citrix\IMA\ServerHost (64-bit server) to the new server name.
Verify that integrity of data store by running dscheck /full servers at a command prompt on any server in the farm. There should be no invalid server record.
Restart the server.
To re-create the RMLocalDatabase, do the following steps:
Delete <Program Files>\Citrix\Citrix Resource Manager\LocalDB\RMLocalDatabase.*
The next time the IMA service is started, it re-creates the database.