Windows Installation for Professional Edition

Important

Installation requires the following version, based on your environment:

  • .NET Core 3.1

NCache can be installed via an interactive Windows installer. Do the following.

  • Search for Command Prompt on Windows Start menu. Right-click on the search result Command Prompt, and select Run as Administrator. The reason for this is that NCache must be installed from an admin user.

  • Install NCache: Run msiexec.exe utility from Command Prompt to install NCache in an interactive mode as following.

msiexec.exe /I "C:\NCacheSetupPath\ncache.pro.netcore.x64.msi"
  • The following Welcome to the NCache Setup Wizard screen appears:

Welcome to NCache Install Wizard

  • Click Next.

  • The next screen asks you to accept the license agreement.

License Agreement Install Wizard

  • By clicking I accept the terms in the License Agreement, you are making a legal commitment to abide by the Alachisoft Software Evaluation Agreement for NCache. You cannot proceed without accepting the license agreement.

  • Once done, Click Next

  • The Select NCache Installation Type screen appears.

Select Installation Type

  • Select the installation type that you want (Cache Server for now):

    • Cache Server: installs the full server product along with the local client.

    • Remote Client: installs remote client libraries including ASP.NET session modules. It also installs an OutProc local cache.

    • Developer/QA: installs standalone local cache along with restricted access to remote caches. Note the following limitations for Developer/QA Installation Type while connecting to remote caches:

      • Throttling of 100 requests/sec for each client: All such clients that are licensed under Developer/QA license will not be able to make more than 100 requests/sec to the remote cache.

      • Limited number of requests (200,000) that a client can send to remote cache: In a lifetime of client application in case it is licensed under Developer/QA license, the client will stop making requests to remote cache after it has sent 200,000 requests to remote cache. Once the client has made 200,000 requests, a licensing exception will be thrown saying "Clients running under DEV license cannot send more than 200,000 requests to remote cache."

Note

Developer/QA licensed clients can make requests to local caches without any limitation.

  • Click Next.

  • Installation Key screen appears, which asks for the installation key (For Cache Server Only).

Enter NCache Installation Key

  • This is the key which you have received from Alachisoft Support when you registered to download NCache Professional Edition.

  • If you do not have the installation key, then click Get Installation Key. User Registration page from the Alachisoft website is displayed. Enter all the required information and click Register or Login and an installation key is emailed to you. Enter that installation key in the above box and click Next.

  • User Information screen appears, which asks for your information.

  • Enter all required information and then press Next.

Note

Make sure that the email address provided is the one used during registration with Alachisoft.

Enter User Information

  • The Select Installation Folder screen confirms the location where NCache should be installed. Keep the default location or change it if required. Click Next.

Select NCache Destination Folder

  • The Configure IP Binding and Firewall Ports screen ensures the following setup environment prerequisites:
    • NIC binding in case of multiple server IP addresses
    • Configure NCache specific ports in case of firewall

Setup Environment Prerequisites

  • Against the Select IP Address option, select the IP address to which you want to bind NCache services.

  • By default, the Enable firewall ports used by NCache option will be checked, which means a firewall will be configured for all NCache specific ports. To disable this prerequisite, uncheck this checkbox.

  • Click on the Next button to proceed.

  • The next screen asks for user credentials with administrative privileges that are required to monitor Perfmon counters in case of ASP.NET Core installation. Enter the account name and password or use a local system account.Click on Next.

User Credentials with Admin Rights

Important

If you choose to provide a account other than the local account, you have to allow this user to login to the NCache service. See troubleshooting for more details.

  • On installation, the NCache service will create and start a demo cache. You can disable this option by unselecting the Start demo cache at the end of installation option. Click on Install when done.

Ready to Install

  • After the installation is completed successfully, the following screen is displayed. On this screen, there is a Launch Web Manager on Finish option, which, if selected, launches the NCache Web Manager after installation. You can uncheck this option as per your requirement.

Exit installation setup

  • If you have used an expired installation key, you will be prompted with this screen instead of the exit installation screen:

Installation Key has Expired

  • If you have a license key or extension key, you don't need to worry about this message. Just use the Register-NCache PowerShell cmdlet to activate your license or extend your evaluation period. Otherwise, contact Alachisoft Sales to purchase NCache license or extend evaluation.

  • You can refer to Getting Started to get you started with setting up the NCache environment.

Troubleshooting

In case of NCache .NET Core installation, if you choose to use a custom user instead of local for the required administrative rights, you need to logon that service as custom user. Follow these steps for a workaround:

  • On Windows, search for Local Security Policy.

  • Go to Local Policies -> User Rights Assignment.

  • Double click on Log on as a service. This will open Local Security Settings where you will find all users who have access to the services.

  • Click on the Add User or Group... button and add the user here.

  • Click on OK and Apply to apply these changes.

See Also

Evaluation Period Management
License Management
Command Line Installation
Network Installation with PowerShell