.NET Cache Installer

This page guides you through the options available to Install NCache when they should employed, along with where you can find further details about the installation process.

Note

To learn about the supported .NET versions, please refer to the NCache Installation Guide.

.NET Cache Installation Types

The most common deployment configuration of NCache is as discussed below:

Cache Servers

Web application servers process user requests and generate dynamic content, while NCache servers, store frequently accessed data in memory for rapid retrieval. NCache can be installed on separate machines for enhanced scalability or on the same machine as web servers for smaller deployments, reducing communication overhead.

The Cache Server option is for setting up NCache Servers. You must install this on atleast 2 servers for reliability. These can be dedicated servers or your web/app servers. For 3 or more web/app server environments, we recommend a dedicated caching tier. In this case, we recommend a 4:1 or 5:1 ratio between web/app servers and Nache Servers.

If you're installing an NCache Server on your web/app servers, then make sure you have sufficient memory and CPU power available for both your application and NCache.

To install NCache Server, run msiexec.exe utility from Command Prompt to install NCache Server as follows. Notice INSTALLMODE=0 indicates “Cache Server” installation. /qn indicates Silent Mode. The downloaded .msi file names for both .NET Framework and .NET Core are different. Please change the .msi file name accordingly.

msiexec.exe /I "C:\NCacheSetupPath\ncache.ent.net.x64.msi" INSTALLMODE=0 KEY=XXXXXXXXXXXXXXXXX USERFIRSTNAME="John" USERLASTNAME="Smith" COMPANYNAME="your_company_name" EMAILADDRESS="john@yourdomain.com" USERNAME="Admin" PASSWORD="Password" INSTALLDIR="C:\Program Files\NCache" BINDTOIP="20.200.20.11" ENABLEFIREWALLPORTS=1 STARTCACHE="True" /qn

Remote Clients

This installs the remote client libraries along with the client cache. Install this on all your web/app servers from where you want to remotely access the cache servers. Do not install it on cache servers.

To install Remote Client, run msiexec.exe utility from Command Prompt to install NCache Remote Client as follows. The downloaded .msi file names for both .NET Framework and .NET are different. Please change the .msi file name accordingly. Notice INSTALLMODE=3 indicates “Remote Client” installation. /qn indicates Silent Mode.

Note

Install Remote Client when you want to use the OutProc cache.

msiexec.exe /I "C:\NCacheSetupPath\ncache.ent.net.x64.msi" INSTALLMODE=3 USERFIRSTNAME="John" USERLASTNAME="Smith" COMPANYNAME="your_company_name" EMAILADDRESS="john@yourdomain.com" USERNAME="Admin" PASSWORD="Password" INSTALLDIR="C:\Program Files\NCache" /qn

Please refer to the Installation Guide for more details on the Installation process.

What has been Installed?

Once you have installed NCache Enterprise, the following components are installed in the directory specified at the time of installation. This directory will either be the default directory or the custom directory specified.

Installed Services

These services are automatically installed to enable different aspects of NCache functionality:

  • NCache Service: This is the core service responsible for all NCache operations, such as cache creation, management, and any other runtime processes.
  • NCache Bridge Service: This is the service responsible for all Bridge operations and data synchronization across geographically distributed caches.
  • NCache Execution Service: This is the service responsible for handling tasks related to loading data in the cache from a data source, ensuring optimized and automated data population.
  • NCache Cloud Service: This is the service that monitors cloud-activated environments, gathers system metrics, and triggers custom actions based on cloud usage or performance conditions.

Configuration Files

NCache includes several configuration files available in the config folder of your installation directory, each serving a specific purpose in setting up and managing your cache environment:

  • config.ncconf: This is the main server-side configuration file. It defines cluster configurations, cache settings, and other critical NCache properties.
  • client.ncconf: This is the main client-side configuration file used by applications connecting to the cache. It contains connection details, server mappings, and client-specific settings.
  • bridge.ncconf: This is the main bridge configuration file that contains information regarding all registered bridges and is used whenever you add an existing bridge in the NCache Management Center.
  • security.ncconf: This is the configuration file that keeps security information for operations that require administrative privileges, it provides node-level security services to all users.
  • monitoring.ncconf: This is the configuration file that determines which counters have been enabled for publishing.

Additional Components

Moreover, your NCache directory will also contain the following:

  • Binaries (bin): This folder contains all the assemblies required to run NCache. It includes executables for the services, command-line tools, and the NCache Management Center. These tools are essential for NCache operations.
  • Common Libraries (lib): This folder contains the common libraries used by NCache required for its operations and tools.
  • Log Files (log-files): This folder contains the logs generated during NCache operations, which are essential for debugging, monitoring, and auditing NCache operations. These include:
    • Cache logs
    • Client logs
    • Event logs
    • Service logs
    • Execution Service logs
    • NCache Manager logs

See Also

NCache Installation Guide
Create a Cache
Simulate Cache Usage
Monitor Caches