Important Considerations of Velocity (Powershell Command)

When using the PowerShell commands described in this topic, it is important to consider the following points:

• The security identity of the person using these PowerShell commands must have administrator privileges on all cache servers in the cache cluster.

• Parameter values for the commands are case sensitive. For example, if you create a cache called NamedCache1, the command Get-CacheConfig -CacheName namedcache1 will not work. You must match the case, as in Get-CacheConfig -CacheName NamedCache1.

• When making XML-based cluster configuration changes with the Export-CacheClusterConfig and Import-CacheClusterConfig commands, you can change cluster configuration settings (XML attributes) in the XML file, but adding or removing named caches and cache hosts by inserting or removing XML elements is not supported.

• Start-CacheCluster, Stop-CacheCluster, and Restart-CacheCluster cache cluster commands involve coordinating the state of the cache host Windows service on all cache servers in the cluster. These commands may take longer when lead hosts perform the cluster management role; there must be a majority of lead host running while the rest of the cache hosts stop and start.

• Stop-CacheCluster or Restart-CacheCluster cache cluster commands cause all data to be flushed from the memory of all cache hosts in the cluster.

• Set-CacheConfig and Import-CacheClusterConfig commands require you to restart the cache cluster with Restart-CacheCluster in order for changes to take effect.

• Remove-Cache and New-Cache commands can be used to change a named cache configuration without impacting other named caches in the cluster.

Posted in: .Net Programming| Tags: .net .net 4.0 CTP CTP 3 Distribute Cache 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.

Posted in: .Net Programming| Tags: .net 4.0 CTP 3 Distribute Cache Uninstall Velocity

---

How to install an additional cache server and join it to the cache cluster

Confirm hardware and software requirements and install pre-requisites on the cache server. For more information, see the "Velocity" download page.

Download the "Velocity" installation program from the "Velocity" download page and copy it to the cache server. There are two installation programs available:

MicrosoftDistributedCache-i386.exe: Use this program to install "Velocity" on 32-bit computers.

MicrosoftDistributedCache-amd64.exe: Use this program to install "Velocity" on x64-based computers.

Perform the cache server installation using the setting of the cache cluster you want the cache server to join. This can be done manually with the graphical user interface (GUI) or by using command-line parameters to automate a "silent" installation. For more information about a cache server installation, see Cache Server Installation (Velocity).

GUI installation: To begin the GUI installation, double-click on the installation program.

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

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.

Set the PowerShell execution policy for signed assemblies, this is required to run the cache administration cmdlets. Depending on how your cache server is configured, you may not be prompted to set the policy. Follow the prompt or set the policy manually using the command: Set-ExecutionPolicy -ExecutionPolicy AllSigned

Join the cache server to the cache cluster using the Start-CacheHost command. For example, if you performed the cache server installation on a computer named CacheServer1 with the default values for the TCP/IP port numbers, you would use the following command to start the server's cache host service: Start-CacheHost -HostName CacheServer1 -CachePort 22233. For more information about the cache administration commands available, see Cache Administration with PowerShell (Velocity).

Posted in: .Net Programming| Tags: .net .net 4.0 CTP CTP 3 Distribute Cache Install Velocity

---

How to install "Velocity" for the first time

Determine how you will store the cluster configuration settings. For more information, see Cluster Configuration Storage Options (Velocity).

Prepare the cluster configuration storage location and assign the necessary security permissions to the security identity of the person or account performing the installation.

For more information about preparing a SQL Server-based cluster configuration, see How to: Prepare a SQL Server Database for Cluster Configuration Settings (Velocity).

For more information about preparing a shared folder, see How to: Prepare a Shared Network Folder for Cluster Configuration Settings (Velocity).

Confirm hardware and software requirements and install pre-requisites on the cache server. For more information, see the "Velocity" download page.

Download the Microsoft project code named "Velocity" installation program from the "Velocity" download page and copy it to the cache server. There are two installation programs available:

MicrosoftDistributedCache-i386.exe: Use this program to install "Velocity" on 32-bit computers.

MicrosoftDistributedCache-amd64.exe: Use this program to install "Velocity" on x64-based computers.

Perform the cache server installation. For more information, see Cache Server Installation (Velocity). This can be done manually with the graphical user interface (GUI) or by using command-line parameters to automate a "silent" installation.

GUI installation: To begin the GUI installation, double-click on the installation program.

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

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.

Set the PowerShell execution policy for signed assemblies, this is required to run the cache administration cmdlets. Depending on how your cache server is configured, you may be prompted to set the policy. Follow the prompt or set the policy manually using the command: Set-ExecutionPolicy -ExecutionPolicy AllSigned

Start the cache cluster using the command Start-CacheCluster. For more information about the cache administration commands available, see Cache Administration with PowerShell (Velocity).

(optional) To create your first cache, named FirstCache, use the command New-Cache FirstCache. For more information about cache settings, see the Cache Settings section in Cluster Configuration Settings (Velocity).

Install the cache client assemblies on the "Velocity" development environment or cache-enabled application server. For more information, see Installing Cache Client Assemblies (Velocity).

Posted in: .Net Programming| Tags: .net .net 4.0 CTP CTP 3 Distribute Cache Velocity

---