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 6.0

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

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

Install NCache Using Command Line Installation

Note

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

  • 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

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.

    Troubleshooting

    In the case of NCache .NET installation, if you choose to use a custom user instead of local for the required administrative rights, you need to log in to that custom user as a 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.

    • Click on OK and Apply to apply these changes.

    See Also

    Windows Installation
    Network Installation with PowerShell
    Evaluation Period Management
    License Management