Command Line Installation

Important

Installation requires the following versions, based on your environment:

  • .NET Core 3.1

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

Install/Uninstall NCache Professional

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

In case of custom account, refer to the troubleshooting section first.

  1. Install Cache Server (.NET Core): Run msiexec.exe utility from Command Prompt to install NCache Server as following. Notice INSTALLMODE=0 indicates “cache server” installation. /qn indicates Silent Mode.

    Note

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

    msiexec.exe /I "C:\NCacheSetupPath\ncache.pro.x64.msi" INSTALLMODE=0 KEY=XXXXXXXXXXXXXXXXXXXXXXXX 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 STRATCACHE="True" /qn

  2. Install Developer (.NET Core): Run msiexec.exe utility from Command Prompt to install NCache Server as following. Notice INSTALLMODE=2 indicates “Developer” installation. /qn indicates Silent Mode.

    msiexec.exe /I "C:\NCacheSetupPath\ncache.pro.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. Notice INSTALLMODE=3 indicates “remote client” installation. /qn indicates Silent Mode.

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

  4. Uninstall NCache (Server or Remote Client): Run msiexec.exe utility from Command Prompt to uninstall NCache as following. It’s the same command for uninstalling Server and Remote Client.

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

Silent Mode Installation Properties

Mandatory Parameters

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 receive from Alachisoft Sales upon downloading NCache. -
INSTALLMODE Specifies the installation type. Possible values are:
  • 0 (Cache Server)
  • 2 (Developer)(For .NET)
  • 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 Parameters

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

    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

    During installation through msiexec.exe, 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