Command Line Installation (Silent Mode)

This page explains all the steps required to install NCache .NET Edition in Windows in silent mode along with the neccessary prerequisites.

Prerequisites

Installation requires either of the following versions, based on your environment:

  • .NET Framework 4.8
  • .NET 8.0

NCache provides a Windows Installer (.msi) with which you can install NCache through command line silent mode.

Install NCache Using Command Line Installation

Note

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

  • Search for Command Prompt on the Windows Start menu. Right-click on the search result Command Prompt, and select Run as Administrator.

  • Install Cache 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 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


  • Install Developer/QA: Run msiexec.exe utility from Command Prompt to install NCache Server as follows. Notice INSTALLMODE=2 indicates “Developer” installation. The downloaded .msi file names for both .NET Framework and .NET are different. Please change the .msi file name accordingly.
msiexec.exe /I "C:\NCacheSetupPath\ncache.ent.net.x64.msi" INSTALLMODE=2 USERFIRSTNAME="John" USERLASTNAME="Smith" COMPANYNAME="your_company_name" EMAILADDRESS="john@yourdomain.com" USERNAME="Admin" PASSWORD="Password" INSTALLDIR="C:\Program Files\NCache" STARTCACHE="True" /qn


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


Important

For .NET installation, if you choose to provide an account other than the local account, you have to allow this user to log in to the NCache Service. See troubleshooting for more details.

Uninstall NCache Using Command Line Installation

Run msiexec.exe utility from Command Prompt to uninstall NCache as follows. It’s the same command for uninstalling Server/Developer/Remote Client.

msiexec.exe /x "C:\NCacheSetupPath\ncache.ent.net.x64.msi" /qn

Installer Reference

Following are the mandatory and optional properties that you need to provide while installing NCache using command-line installation.

Mandatory Properties

The following properties are to be provided for NCache installation through msiexec.exe. Note that all of these properties MUST be provided.

Switch/Properties Purpose Default Value
/I <.msi Package Path> Path where you have downloaded .msi file from the Alachisoft website. Empty
KEY The key you are provided with upon downloading NCache. -
INSTALLMODE Specifies the installation type. Possible values are:
  • 0 (Cache Server)
  • 2 (Developer)
  • 3 (Remote Client)
    		•  0 (Cache Server)
    USERFIRSTNAME Your first name. -
    USERLASTNAME Your last name. -
    COMPANYNAME Your company name. -
    EMAILADDRESS Your email address which is used during registration with Alachisoft. -
    INSTALLDIR Directory where you want NCache to be installed. Most commonly, this should be C:\Program Files\NCache. C:\Program Files\NCache
    /qn Quiet mode: Install NCache without any user intervention. Empty

    Optional Properties

    The following properties are optional for NCache installation through msiexec.exe.

    Note

    USERNAME and PASSWORD are required for .NET installation only.

    Switch/Properties Purpose Default Value
    USERNAME Username of the account with administrative credentials. Username of local account.
    PASSWORD Password of the account with administrative credentials. Password of local account.
    BINDTOIP IP address that NCache Service binds to. IP address of local machine.
    ENABLEFIREWALLPORTS Flag that defines rules to allow NCache ports if the firewall is enabled. 1 (enable)
    STARTCACHE Flag that defines whether to start the default demoCache at the end of installation or not. True
    Note

    For Cache Server installation, the STARTCACHE flag is set to true by default, which means that the cache will automatically start at the end of the installation.

    Note

    If you encounter any issues during installation, please refer to the troubleshooting section.

    See Also

    Windows Installation
    Network Installation with PowerShell
    Evaluation Period Management
    License Management