Command Line Installation for NCache Professional

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

Important

Installation requires .NET 6.0.

Install/Uninstall NCache Professional

  1. Run command prompt as an administrator.

    Note

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

  2. Install Cache Server (.NET): Run msiexec.exe utility from Command Prompt to install NCache Server as following. Notice that 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.net.x64.msi" INSTALLMODE=0 KEY=XXXXXXXXXXXXXXXXXXXXXXXX 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 STRATCACHE="True" /qn

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

    msiexec.exe /I "C:\NCacheSetupPath\ncache.pro.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

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

  5. 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.net.x64.msi" /qn

  6. You can refer to Getting Started to get you started with setting up the NCache environment.

Silent Mode Installation Properties

This section contains the mandatory and optional parameters of the silent mode installation for NCache Professional through the command line.

Mandatory Parameters

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

    Troubleshooting

    During installation through msiexec.exe, if you choose to use a custom user instead of a local for the required administrative rights, you need to log on 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 here.

    • Click on OK and Apply to apply these changes.

    See Also

    Windows Installation
    Network Installation with PowerShell
    Evaluation Period Management
    License Management