Network Install with PowerShell

NCache provides integration with Windows PowerShell so that you can easily automate NCache processes on your network. You can manage NCache remote installation/uninstallation tasks on your network through a single computer using PowerShell scripts. NCache also allows you to automate the activation process on all your cache servers and cache clients by using NCache PowerShell scripts.

Remote Installation/Uninstallation

For NCache Remote installation or uninstallation, you need to use the PowerShell script InstallNCache.ps1 or UninstallNCache.ps1. You can find these scripts on GitHub.

Prerequisites for Remote Installation/Uninstallation

  • All remote machines must be logged in as Administrators.
  • The NCache setup .msi file must be placed in the same location on all remote machines.

Remote Installation/Uninstallation

To remotely install or uninstall NCache, do the following:

Note

Make sure that the email address provided in the installation commands below is the one used during registration with Alachisoft.

  1. Download the GitHub repository.

  2. For the machine from where you’re installing or uninstalling NCache remotely, search for Windows PowerShell and select Run as Administrator.

  3. Go to the path where you have downloaded the GitHub repository and open the scripts folder.

  4. Execute either of the following commands, modifying the values according to your environment. Note that the server names (IP or hostnames) must be separated by BLANK space. Note that these examples install the Cache Server with credentials for John Smith. It is assumed that NCache is installed on the default path C:/Program Files.

    • Single Server Commands

      Installation

      This example installs NCache Cache Server on remote machine 20.200.20.39. Please replace the server IP 20.200.20.39 with your remote machine IP.

      ./installNCache.ps1 /i 0 /k XXXXXXXXXXXXXXXXX /file "ncache.ent.net.x64.msi" /file-path "D:\" /f "John" /l "Smith" /email "john@yourdomain.com" /company "your_company_name" /s 20.200.20.39

      Uninstallation

      This example uninstalls NCache on remote machine 20.200.20.39. Please replace the server IP “20.200.20.39” with your remote machine IP.

      ./UninstallNCache.ps1 20.200.20.39

    • Multiple Server Commands

      Installation

      This example installs the NCache Cache Server on three machines (20.200.20.38, 20.200.20.39, and 20.200.20.40). Please replace these server IPs with your own remote cache server machine IPs.

      ./installNCache.ps1 /i 0 /k XXXXXXXXXXXXXXXXX /file "ncache.ent.net.x64.msi" /file-path "D:\" /f "John" /l "Smith" /email "john@yourdomain.com" /company "your_company_name" /s 20.200.20.38,20.200.20.39,20.200.20.40

      Uninstallation

      This example uninstalls NCache on three machines (20.200.20.38, 20.200.20.39, and 20.200.20.40). Please replace these server IPs with your own remote cache server machine IPs.

      ./UninstallNCache.ps1 20.200.20.38,20.200.20.39,20.200.20.40

  5. Upon successful installation or uninstallation, you will see a message with Return Value:0 or 1614.

Remote Installation Properties

Argument Description
/file The name of the setup file along with the file extension.
/file-path The complete file-path/file-location of the setup file.
/k Valid installation key obtained from Alachisoft.
/s or /servers(for Open Source) A comma-separated list of Server Names or IP Addresses of machines where NCache is going to be installed.
/f User's first name.
/l User's last name.
/i (for Enterprise and Community) NCache installation.
0: Cache Server Remote Installation.
2: Developer Remote Installation.
3: Remote Client Remote Installation
The default is 0.
/email The email address which is used during registration with Alachisoft.
/company Company name.
/install-dir Path to install NCache. The default is C:/Program Files.
/set-per Sets permissions for quite mode. The default is 1.
/? Displays command syntax and options for the utility.

See Also

Evaluation Period Management
License Management
Command Line Installation
Windows Installation