Installation requires either of the following versions, based on your environment:
- .NET Framework >= 4.8
- .NET Core 3.1
NCache can also be installed via an interactive Windows installer by following these steps:
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. Please note that the .msi file may have a different name for .NET Core installation.
msiexec.exe /I "C:\NCacheSetupPath\ncache.ent.x64.msi"
The following Welcome to the NCache Installation Wizard screen appears:
The next screen asks you to accept the license agreement.
By clicking I accept the terms in the License Agreement, you are making a legal commitment to abide by the Alachisoft Software Agreement for NCache. You cannot proceed without accepting the license agreement.
The Select NCache Installation Type appears.
Select the installation option that you want (Cache Server for now) and click Next.
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 and client cache.
Developer/QA installs standalone local cache along with restricted access to remote caches. Note the following limitations on Developer/QA Installation Type while connecting to remote caches:
Throttling of 100 requests/sec for each client: All such clients that are licensed under DEV/QA license will not be able to make more than 100 requests/sec to the remote cache.
Limited number of requests (200,000) a client can send to remote cache: In a lifetime of client application in case it is licensed under DEV/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."
Developer/QA licensed clients can make requests to local caches without any limitation.
Evaluation Information dialog appears which asks for the installation key. (For Cache Server Only)
This is the key which you have received from Alachisoft when you registered to download NCache Enterprise Edition.
If you do not have the Install Key, then click Get Evaluation Key. Registration page from Alachisoft website is displayed. Enter all the required information and press Register or Login and an Install Key is emailed to you. Then, enter that Install Key in the above dialog.
User Information dialog appears which asks for your information. Enter all required information and then press Next.
Make sure that the email address provided is the one used during registration with Alachisoft.
The next dialog confirms the location where NCache should be installed. Keep the defaults or change if you must. Click Next.
The Setup Environment Prerequisites dialog box ensures the following following prerequisites:
- NIC binding in case of multiple server IP addresses.
- Configure NCache specific ports in case of firewall
From the dropdown menu, select the IP address to which you want to bind NCache services.
By default, firewall will be configured for all ports used by NCache. Disable the checkbox in case you want to disable firewall.
Click on Next.
Set Account to Run NCache Services dialog box is only for ASP.NET Core installation.
The next dialog box 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 local system account.
For .NET Core installation, if you choose to provide account other than the local account, you have to allow this user to logon to NCache service. See troubleshooting for more details.
By default, NCache service will create and start a demo cache named demoCache of topology Partitioned-Replica at the end of setup installation. You can disable this options from this dialog box by unchecking the Start demo cache at the end of installation. option. Click on Install when done.
After the installation is completed successfully, the following dialog is displayed. On this dialog box, there is an option to Launch Web Manager on Finish which automatically launches the NCache Web Manager on your localhost after successfully setup installation. You can uncheck this option if you do not wish NCache service to automatically launch NCache Web Manager.
If you don’t see this dialog then it means the installation did not complete successfully.
Click Finish to exit the installation setup.
You can refer to Getting Started to set up NCache environment.
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 custom user as service. 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 are listed.
Click on the Add User or Group... button and add the user here.
Click on OK and Apply to apply these changes.