Command Line Installation (Silent Mode)

Important

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

  • .NET Framework >= 4.8
  • .NET Core 3.1

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

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

Install NCache

Note

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

  1. Install Cache Server: Run msiexec.exe utility from Command Prompt to install NCache Server as following. 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.x64.msi" INSTALLMODE=0 KEY=XXXXXXXXXXXXXXXXX USERFIRSTNAME="John" USERLASTNAME="Smith" COMPANYNAME="Alachisoft" EMAILADDRESS="john@alachisoft.com" USERNAME="Admin" PASSWORD="Password" INSTALLDIR="C:\Program Files\NCache" BINDTOIP="20.200.20.11" ENABLEFIREWALLPORTS=1 STARTCACHE="True" /qn

  2. Install Developer/QA: Run msiexec.exe utility from Command Prompt to install NCache Server as following. Notice INSTALLMODE=2 indicates “Developer” installation. 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.x64.msi" INSTALLMODE=2 USERFIRSTNAME="John" USERLASTNAME="Smith" COMPANYNAME="Alachisoft" EMAILADDRESS="john@alachisoft.com" USERNAME="Admin" PASSWORD="Password" INSTALLDIR="C:\Program Files\NCache" STARTCACHE="True" /qn

  3. Install Remote Client: Run msiexec.exe utility from Command Prompt to install NCache Remote Client as following. The downloaded .msi file names for both .NET Framework and .NET Core 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.x64.msi" INSTALLMODE=3  USERFIRSTNAME="John" USERLASTNAME="Smith" COMPANYNAME="Alachisoft" EMAILADDRESS="john@alachisoft.com" USERNAME="Admin" PASSWORD="Password" INSTALLDIR="C:\Program Files\NCache" /qn
Important

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.

Uninstall NCache

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

msiexec.exe /x "C:\NCacheSetupPath\ncache.ent.x64.msi" /qn
  • You can refer to Getting Started to get you started with setting up NCache environment.

Silent Mode Installation Properties

Mandatory Properties

The following properties 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 Core installation only.

    Switch/Properties Purpose Default Value
    USERNAME User name of the account with administrative credentials. User name 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 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 installation.

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

    See Also

    Windows Installation
    Network Installation with PowerShell
    Evaluation Period Management
    License Management