|
Change farm:
is used to change the farm
membership of a MetaFrame XP server.
Syntax
chfarm
Remarks
You can
use chfarm
when you want
to move a MetaFrame XP server from its current server farm. You can move the server to an
existing IMA-based server farm or create a new server farm at the same
time that you move the server. Citrix recommends that you back up your
data store before running chfarm.
Important
If the server
you want to move provides information for a Resource Manager summary database, update the summary
database before using chfarm. If you do not update the summary database,
you will lose approximately 24 hours worth of summary data stored on the
server. To update the summary database,
click the Resource Manager node in the Management Console
for MetaFrame XP, select the Summary Database tab, and click Update Now.
The
chfarm utility is installed in
%ProgramFiles%\citrix\system32\citrix\IMA. To run this utility, choose
Run from the Start menu. Enter chfarm.
Warning
Be sure that the
Management Console is closed before you run the
chfarm
command.
Running chfarm
while the console is
open can result in loss of data and functionality.
Chfarm
stops the IMA
service on the server. The data store configuration part of the MetaFrame XP Setup wizard appears. On the first
page, you can select to join an existing server farm or create a new
server farm.
The wizard continues and
you specify an existing data store (to join an existing server farm) or
set up a new data store (if you create a new server farm).
While running
chfarm, you are prompted for the user name and
password of the user you want to designate as the initial MetaFrame XP
administrator for the farm. For information about data store setup and
server farm configuration, see "Configuring the Data Store" on page
116.
If chfarm reports any error, continuing the process
can corrupt the data store. If you cancel out of the data store
configuration part of the MetaFrame XP Setup wizard, the server you are
switching rejoins the original farm.
Appendix A MetaFrame
XP Commands 331
After the farm membership is changed or a
new farm is created, reboot the
MetaFrame XP
server.
Do not remove a server
that hosts a server farm’s data store from the server farm.
Doing so renders
the farm unstable.
Important Notes for Using MSDE for the Data Store
This
section explains how to use chfarm to create a new farm — which
uses
Microsoft SQL Server 2000 Database Engine (MSDE) for the
server farm’s data store — when changing a MetaFrame XP server’s farm
membership.
If you want to use MSDE to host a new server farm’s data
store, a named instance of MSDE must be installed on the server on which
you run chfarm. The default named instance that chfarm uses is
CITRIX_METAFRAME. Running chfarm does not automatically install MSDE; you
must install it separately. For information about installing MSDE on the
MetaFrame XP server, see "Microsoft SQL Server 2000 Desktop Engine (MSDE)"
on page 56.
Chfarm Options When Using MSDE
Use these options when running chfarm to create a new farm
with MSDE as the
data store:
/instancename: <name>
The name of the MSDE instance to which to migrate. The
default value is
CITRIX_METAFRAME.
/database: <name>
The name of the MSDE database to which to migrate. The
default value is
MF20.
|
