How to: Uninstall a Cache Server (Velocity)

  • Article

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

This topic describes how to uninstall Microsoft project code named "Velocity" from a cache server and remove it from a cache cluster. Depending on how the cache cluster was deployed and the number cache hosts in the cluster, a running cache cluster may not be able to accommodate losing a cache host if it is a lead host that performs the cluster management role. For more information, see Lead Hosts and Cluster Management (Velocity).

How to uninstall a cache server and remove it from the cache cluster

  1. Open the PowerShell-based cache administration tool from the shortcut that was installed on the desktop of the cache server. Note: On Microsoft Windows Vista and Microsoft Windows Server 2008 operating systems, you will have to right-click the "Velocity" PowerShell shortcut and select Run as administrator for the cache administration tool to work correctly.

  2. Before the cache host service can be uninstalled on the cache server, use the PowerShell-based cache administration tool to stop the service with the Stop-CacheHost command. For example, if you want to uninstall the cache host service on a computer named CacheServer1, and it was installed with the default values for the TCP/IP port numbers, you would use the following command to stop the server's cache host service: Stop-CacheHost -HostName CacheServer1 -CachePort 22233. For more information about the cache administration commands available, see Cache Administration with PowerShell (Velocity).

  3. If the Stop-CacheHost command was not successful and returns the error ERRCAdmin013, "Cluster Quorum would be disturbed…", stop the cache cluster using the command Stop-CacheCluster. This error is returned because there must always be a majority of cache hosts designated as lead hosts available for the cache cluster to remain running. This error also suggests that (after you uninstall this cache host) you will need to designate another cache host as a lead host before you can start the cache cluster. For more information about how to do that, see How to: Set the Cluster Management Role and Lead Host Designations (Velocity).

  4. Perform the cache host service uninstallation. This can be done manually with the Windows operating system program removal console or by using command-line parameters to automate a "silent" uninstallation.

    1. Windows uninstallation: Use the operating system's Add or Remove Programs or Programs and Feature console to remove the program titled Microsoft project code named "Velocity" CTP3.

    2. Automated installation: To perform an automated uninstallation, open the CMD.exe command-line tool and navigate to the folder you saved the installation program. Then, execute the installation program using the automated uninstallation parameters. For more information, see Automated Cache Server Installation (Velocity).

  5. (optional) Depending on the options you selected for the uninstallation, you may need to re-apply the corporate standard firewall configuration settings.

See Also

Tasks

How to: Prepare the Development Environment (Velocity)
How to: Install for the First Time (Velocity)
How to: Install an Additional Cache Server (Velocity)

Other Resources

Installation Overview (Velocity)
Configuring the Cache Cluster (Velocity)
Configuring the Cache Client with XML (Velocity)
Using Configuration Methods (Velocity)