Tasks you might need
to perform to remove servers from your farm or remove XenApp software from a
- Removing XenApp
from a computer in your farm or forcing its removal
- Repairing a XenApp
- Reinstalling XenApp
after a hardware failure, which includes renaming the server
- Removing a server from a farm
or moving it to another farm
- Removing a server
from your farm if the hardware hosting XenApp fails
that you remove XenApp by using
and Features while the server is still connected to the farm and
the network. Select
Uninstall. After the program is finished, restart
This method removes
the host information from the farm data store and removes the server from the
farm properties displayed in the management tools.
To remove XenApp
remotely, you can do so from within a Remote Desktop Connection (RDC) session
or using tools such as Microsoft Configuration Manager 2007 (formerly Systems
Management Server (SMS)).
If you want to
remove only specific components of XenApp, do so in the following order:
- Citrix Management (such as
Delivery Services Console)
- XenApp Advanced Configuration
utility or Presentation Server Console, if installed
- Citrix XenApp
- Citrix Web Interface
- Citrix Licensing
uninstall XenApp and all its components from a command line, use the
XenAppSetupConsole.exe /uninstall:XenApp command. From
the server console, run
XenAppServerSetup.exe. For more details about using
these commands, see
Configuring XenApp from the Command Line.
Removal of XenApp
To force the removal
of XenApp from a computer, you can use
msiexec on a command line to add the property:
CTX_MF_FORCE_SUBSYSTEM_UNINSTALL. Set its value to
The following sample
command line enables logging of the uninstallation operation and forces the
removal of XenApp:
mps.msi /L*v c:\output.log
mps.msi is the name and location of the msi package.
Before you start,
log off from all sessions and exit any applications running on the server.
After you finish, restart the server when prompted.
When you run the
repair utility from
and Features, XenApp overwrites all files and settings with those
from the original installation. If you customized any of the files or features
in your XenApp installation, running the repair utility replaces your
customizations with the original files and settings.
XenApp Due to Hardware Failure
If the hardware for
a server fails and needs to be replaced, change its name to the same name as
the failed server before you connect its replacement server to your network.
Assigning the replacement server the failed server’s name lets the replacement
have the same properties and functionality as the failed XenApp server. The
records in the data store for the old server apply to its replacement of the
Ensure that the
replacement server settings are identical to the failed server, including:
- Server name
- Operating system
- Settings for
applications made during installation or when the application was published
- User accounts
Server From a Farm
Caution: If you remove all servers belonging to a single domain and have
Citrix administrators in the domain, their user accounts cannot be enumerated
by the Delivery Services Console and appear as a question mark (?) in the list
of Citrix administrators.
To remove a server
from a farm, use the XenApp Server Configuration Tool to leave the farm or join
the server to another farm. Access the Server Configuration Tool from the
Server Role Manager or use
XenAppConfigConsole.exe from the command line. (For
information on using
Configuring XenApp from the Command Line.)
If you cannot use
the Server Configuration Tool – for example, because the hardware for the
server fails or the server cannot be started – use this alternative method to
remove the server from the farm:
- Open the Delivery
Services Console from another server in the farm.
- In the left
pane, select the server you want to remove.
- From the
Action menu, select
Other Tasks > Remove from farm.
- Run the
dscheck command on the farm’s data store to repair
any consistency errors.
- If you want
reuse the server, Citrix recommends reimaging the server and reinstalling
XenApp before joining the server to a farm.
Backing Up and
Restoring the XenApp Data Store
Many data store
maintenance tasks are performed using the DSMAINT and DSCHECK commands. For
more information, see the
Database Reference documentation.