How to: Install for the First Time (Velocity)

  • Article

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

Before you can install Microsoft project code named "Velocity" for the first time, you must prepare the cluster configuration storage location. All cache server installations use the same location for reading and editing configuration settings.

The first cache server installation establishes where the cluster configuration settings will be stored: in SQL Server or a shared folder. For more information about these options, see Cluster Configuration Storage Options (Velocity).

How to install "Velocity" for the first time

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

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

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

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

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

  4. 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:

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

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

  5. 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.

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

    2. 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).

  6. 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.

  7. 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

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

  9. (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).

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

See Also

Tasks

How to: Prepare the Development Environment (Velocity)
How to: Install an Additional Cache Server (Velocity)
How to: Uninstall a Cache Server (Velocity)

Other Resources

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