V3 Documentation
Search

Manual Installation Instructions

It's recommended that you only try to install NCrunch manually if you are experiencing problems with the MSI package(s). The MSIs contain useful steps that will make normal install situations less error-prone while also making it easier to remove the product in future.

Visual Studio 2017

To install NCrunch from a ZIP file for Visual Studio 2017, follow these instructions:

  1. Download the NCrunch VS2017 ZIP file from the download page
  2. Find your VS2017 install directory. VS2017 can be installed to any location (user specified). The default is at C:\Program Files (x86)\Microsoft Visual Studio\2017\SKU
  3. Find your VS IDE extensions directory. Under the Professional version of VS2017 with a default install path, this will be C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\Common7\IDE\Extensions.
  4. Extract the contents of the ZIP file to your VS extensions directory, so that the contents are under Remco Software. Ensure that Windows does not block the contents of this ZIP file when you decompress it (check the extracted file properties using explorer and click 'Unblock' if this option exists).
  5. Using a command prompt or run dialog, execute the following command as an administrator in your Visual Studio's Common7\IDE directory: devenv.exe /setup /nosetupvstemplates
  6. Wait for the devenv.exe process to finish executing (watch it in Windows Task Manager)
  7. Load Visual Studio 2017 - NCrunch should now show as installed

If in future you choose to upgrade to a new version via installer or a newer zip package, make sure you remove ALL the installed files from the previous version first, then perform steps 4 to 7 (running devenv /setup) in order to reset Visual Studio's extension cache.

If you wish to remove NCrunch, you need to delete the installed files and then also perform steps 5 to 6 again.

Visual Studio 2015

To install NCrunch from a ZIP file for Visual Studio 2015, follow these instructions:

  1. Download the NCrunch VS2015 ZIP file from the download page
  2. Extract the contents of the ZIP file to your Program Files\Microsoft Visual Studio 14.0\Common7\IDE\Extensions directory, so that the contents are under Remco Software. Note that the Program Files directory will be Program Files (x86) if you are running on a 64-bit machine. Ensure that Windows does not block the contents of this ZIP file when you decompress it (check the extracted file properties using explorer and click 'Unblock' if this option exists).
  3. Using a command prompt or run dialog, execute the following command as an administrator: Program Files\Microsoft Visual Studio 14.0\Common7\IDE\devenv.exe /setup /nosetupvstemplates
  4. Wait for the devenv.exe process to finish executing (watch it in Windows Task Manager)
  5. Load Visual Studio 2015 - NCrunch should now show as installed

If in future you choose to upgrade to a new version via installer or a newer zip package, make sure you remove ALL the installed files from the previous version first, then perform steps 3 and 4 (running devenv /setup) in order to reset Visual Studio's extension cache.

If you wish to remove NCrunch, you need to delete the installed files and then also perform steps 3 and 4 again.

Visual Studio 2013

To install NCrunch from a ZIP file for Visual Studio 2013, follow these instructions:

  1. Download the NCrunch VS2013 ZIP file from the download page
  2. Extract the contents of the ZIP file to your Program Files\Microsoft Visual Studio 12.0\Common7\IDE\Extensions directory, so that the contents are under Remco Software. Note that the Program Files directory will be Program Files (x86) if you are running on a 64-bit machine. Ensure that Windows does not block the contents of this ZIP file when you decompress it (check the extracted file properties using explorer and click 'Unblock' if this option exists).
  3. Using a command prompt or run dialog, execute the following command as an administrator: Program Files\Microsoft Visual Studio 12.0\Common7\IDE\devenv.exe /setup /nosetupvstemplates
  4. Wait for the devenv.exe process to finish executing (watch it in Windows Task Manager)
  5. Load Visual Studio 2013 - NCrunch should now show as installed

If in future you choose to upgrade to a new version via installer or a newer zip package, make sure you remove ALL the installed files from the previous version first, then perform steps 3 and 4 (running devenv /setup) in order to reset Visual Studio's extension cache.

If you wish to remove NCrunch, you need to delete the installed files and then also perform steps 3 and 4 again.

Visual Studio 2012

To install NCrunch from a ZIP file for Visual Studio 2012, follow these instructions:

  1. Download the NCrunch VS2012 ZIP file from the download page
  2. Extract the contents of the ZIP file to your Program Files\Microsoft Visual Studio 11.0\Common7\IDE\Extensions directory, so that the contents are under Remco Software. Note that the Program Files directory will be Program Files (x86) if you are running on a 64-bit machine. Ensure that Windows does not block the contents of this ZIP file when you decompress it (check the extracted file properties using explorer and click 'Unblock' if this option exists).
  3. Using a command prompt or run dialog, execute the following command as an administrator: Program Files\Microsoft Visual Studio 11.0\Common7\IDE\devenv.exe /setup /nosetupvstemplates
  4. Wait for the devenv.exe process to finish executing (watch it in Windows Task Manager)
  5. Load Visual Studio 2012 - NCrunch should now show as installed

If in future you choose to upgrade to a new version via installer or a newer zip package, make sure you remove ALL the installed files from the previous version first, then perform steps 3 and 4 (running devenv /setup) in order to reset Visual Studio's extension cache.

If you wish to remove NCrunch, you need to delete the installed files and then also perform steps 3 and 4 again.

Visual Studio 2010

To install NCrunch from a ZIP file for Visual Studio 2010, follow these instructions:

  1. Download the NCrunch VS2010 ZIP file from the download page
  2. Extract the contents of the ZIP file to your Program Files\Microsoft Visual Studio 10.0\Common7\IDE\Extensions directory, so that the contents are under Remco Software. Note that the Program Files directory will be Program Files (x86) if you are running on a 64-bit machine. Ensure that Windows does not block the contents of this ZIP file when you decompress it (check the extracted file properties using explorer and click 'Unblock' if this option exists).
  3. Load Visual Studio 2010 - NCrunch should now show as installed

If in future you choose to upgrade to a new version via installer or a newer zip package, make sure you remove ALL the installed files from the previous version first.

Grid Node Server

Where possible, it's strongly recommended you use the MSI to install the NCrunch Grid Node Server. A manual installation of this component is more complex than that of the NCrunch Visual Studio package.

To install the NCrunch Grid Node Server from a ZIP file, follow these instructions:

  1. Download the NCrunch Grid Node Server ZIP file from the download page
  2. Extract the contents of the ZIP file to a directory you'd like to install to. Ensure that Windows does not block the contents of this ZIP file when you decompress it (check the extracted file properties using explorer and click 'Unblock' if this option exists).
  3. Open a command prompt with administrator privileges
  4. Use the SC command to register the service application. You'll need to specify the full path to the NCrunch.GridNode.Service.exe file, regardless of where the command prompt is opened. Ensure the service is named 'NCrunch Grid Node Service' - this is important as otherwise the service configuration tools won't work correctly. For example, if the ZIP was extracted to "C:\NCrunch Grid Node Server", you would run: sc create "NCrunch Grid Node Service" binPath= "C:\NCrunch Grid Node Server\NCrunch.GridNode.Service.exe" start= auto
  5. Run the NCrunch.GridNode.WizardLauncher.exe application with Administrator Privileges. Do not skip this step! Otherwise the service will be started using a default password when the computer is next restarted, which is a potential security issue.
  6. Complete the wizard. When the wizard finishes, it will automatically start the service application.
  7. If you wish to further tune the configuration of the service, you can also run NCrunch.GridNode.Configuration.exe.
  8. Make sure you add an exclusion to your firewall so that the service application can accept incoming TCP connections. Unless changed, the service will use TCP port 41141.

Console Tool

To install the NCrunch Console Tool manually, follow these instructions:

  1. Download the NCrunch Console Tool ZIP file from the download page
  2. Extract the contents of the ZIP file to a directory you'd like to install to. Ensure that Windows does not block the contents of this ZIP file when you decompress it (check the extracted file properties using explorer and click 'Unblock' if this option exists).
  3. If you are using TFS, you need to set a system-level environment variable 'NCrunchConsoleInstallDir' to point to the directory you've extracted the files to. Make sure you have a blackslash at the end of the directory name, i.e. 'C:\Program Files (x86)\NCrunch Console Tool\'.

License Server

See here for the License Server installation instructions.