Professional Documents
Culture Documents
20-12-2013
KNOWLEDGE CENTER
Knowledge Center Knowledge Center eDocs Communities Discussions Blogs Alerts Sign in
Print View
10
Languages: Select
Article Feedback
Products
XenApp XenDesktop XenServer DesktopPlayer XenClient NetScaler NetScaler Gateway (Formerly Access Gateway) Receiver VDI-in-a-Box CloudBridge >> View All Products
Average Rating:
(7 ratings)
Summary
This article contains information about migrating the Farm Data Store and some common caveats that might be encountered while performing a migration. This article is a supplement to the Administrator Guide and CTX114746 - Advanced Concepts Guide - Citrix Presentation Server, Platinum Edition. Refer to the Administrator Guide and Advanced Concepts Guide for updated information pertaining to any of the following strategies before implementing them. Also refer to the following Knowledge Center articles: CTX677542 - Advanced Concepts - XenApp Farm Maintenance CTX121888 - Data Store Migration Between Different Database Products
Knowledge Resources
Product Documentation Interoperability Updates Troubleshooting Customer Service My Support Options
Migrating to Oracle on page 413 Migrating to IBM DB2 on page 417 In CTX106319 MetaFrame Presentation Server 4.0 Administrator's Guide: Migrating to SQL Server on page 58
Support & Maintenance Migrating to Oracle on page 61 Programs Migrating to IBM DB2 on page 66
New! Premier Support
The dsmaint command can migrate farm data between databases (dsmaint migrate) and reconfigure servers to use the new database (dsmaint config). The following examples show the syntax for the dsmaint migrate and dsmaint config commands: Note: Type the respective command as one continuous string at a command prompt. dsmaint migrate /srcdsn:dsnfile /srcuser:user /srcpwd:password /dstdsn:dsnfile /dstuser:user /dstpwd:password dsmaint config /user:username /pwd:password /dsn:dsnfilename Where: dsnfilename is the DSN file for the database, including the full path. Refer to CTX108699 - Dsmaint Config Command Fails with Error: Failed to connect to the data store. The settings will be reverted to the previous configuration for more information. username is the user name for the database. password is the password for the database. Migration can be performed with users logged on to the farm. Stopping and restarting the IMA Service does not affect currently connected sessions. However, no new connections are allowed until the IMA Service is completely restarted. Important: Restarting the IMA Service on more than 10 servers simultaneously can cause the database server to become a bottleneck, resulting in startup delays.
20-12-2013
4. Run the dsmaint config command on the original host server to point to the new DSN file. 5. Stop and restart the IMA Service on the host server. When the IMA Service on the host server is restarted, the remaining indirect servers begin accessing the new data store indirectly through the host server. Important: Restarting the IMA Service instead of restarting the server might cause the SNMP service to Dr. Watson if SNMP is enabled. This error is benign. 6. Copy the DSN file created in Step 2 to all remaining indirect servers in the farm. 7. Execute dsmaint config on all remaining indirect servers to establish a direct connection to the new database through the DSN copied in Step 6. 8. Stop and restart the IMA Service on all remaining indirect servers in the farm. Tip: You can complete Steps 6 through 8 on all the servers by using a simple batch file placed in a central location. For information about data store migration, refer to DSMAINT on page 368 in CTX106319 MetaFrame Presentation Server 4.0 Administrator's Guide.
6. 7. 8. 9.
Migrating the Database to the Same Version such as SQL 2005 to SQL 2008
Migrating from one database version to the other might be necessary to move the data store to a more powerful server. The best method for migrating between versions of the database is to back up and restore the database using the utilities provided by the database software vendor. To point a Presentation Server farm to a new database complete the following steps. For the best performance, complete this procedure on the data collectors after all other servers are reconfigured. 1. Back up the existing farm database and restore the database to the new server. 2. Create a new DSN file that points to the restored database. 3. Run the dsmaint config command on the server with the new DSN file. 4. Stop and restart the IMA Service. Important: Restarting the IMA Service instead of restarting the server might cause the SNMP service to initiate Dr. Watson if SNMP is enabled. This error is benign. Ensure that the server is pointing to the new data store by checking the following registry setting: HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\IMA\DataSourceName If the IMA Service started successfully, copy the new DSN file to all servers in the farm. Run the dsmaint config command to change the IMA Service configuration on all remaining servers in the farm. Stop and restart the IMA Service on all servers in the farm. Tip: You can execute Steps 6 through 8 on all the servers from a simple batch file placed in a central location.
5. 6. 7. 8.
Migrating to Access
Migration from Microsoft SQL Server or Oracle to Access is not supported.
http://support.citrix.com/article/CTX123111
2/2