skip to Main Content

Requirements

In order to install NodeXL Basic or NodeXL Pro you need to register on this page.  After that you will receive an email with a download link to the software.

Please note that the installation of NodeXL Basic and NodeXL Pro requires the operating system Microsoft Windows™ (7, 8, 10) and Microsoft Office™ (2007, 2010, 2013, 2016, 2019 or 365).  You can find further information about system and software requirements on the FAQ page.  Mac and Linux users should have a look here.

Installation Guide

  • If you are installing NodeXL for the first time, follow the steps below under A1. First Installation.
  • If you are upgrading from NodeXL Basic to NodeXL Pro, first proceed to the section A2. Upgrade from NodeXL Basic to NodeXL Pro.
  • If you are having any issues with the installation, please scroll down to the section B. Installation Issues to find solutions to the most common problems.

Feel free to request tech support from team NodeXL by filling out this form or sending an email to info@smrfoundation.org including a screenshot or text copy of the error message.

A1. First Installation

  1. After registering for NodeXL Basic or NodeXL Pro you will receive an email with a download link to the software and installation instructions.
  2. Download the NodeXL Pro Excel Template or NodeXL Basic Excel Template from the link provided in the email and then run it (as administrator).
  3. If you are asked to accept the “Microsoft Visual Studio 2010 Tools for Office Runtime (x86 and x64)”, click the “Accept” button.
  4. When you are asked “Are you sure you want to install this customization?”, click the “Install” button and wait for the installation to finish.
  5. To open NodeXL, open the Windows Start menu or Start screen, search for “NodeXL”, then click “NodeXL Excel Template” in the search results or look for the desktop shortcuts named NodeXL Excel template.
  6. When opening NodeXL Pro for the first time, you will be asked to provide the location of your NodeXL Pro User license. Please have a look below at the section License Activation.

A2. Upgrade from NodeXL Basic to NodeXL Pro

In order to run NodeXL Pro, please uninstall NodeXL Basic first. If you don’t do this, NodeXL Pro Excel Template will install successfully, but you will get an error message when you attempt to run the new version. The error message includes the word “COMException.”

Solution 1: Uninstall NodeXL Basic

  1. Uninstall the NodeXL Template.
  2. Then download and install the NodeXL Pro Excel Template and install it (see above).

If you still get the same error message, please proceed to Solution 2.

Solution 2: Delete folder

  1. Uninstall NodeXL.
  2. Go to the following path before installing NodeXL Pro: C:\Users\[user_profile]\AppData\Local\Apps\2.0
  3. You should see two folders: One named Data and another folder with a strange name, that is where the old NodeXL is stored.
  4. Please delete the folder with the strange name and try reinstalling NodeXL Pro.

A3. NodeXL Pro License Activation

The license activation process for NodeXL Pro takes just a few steps:

  1. Download the license file (.lic) containing your NodeXL Pro license(s) from the email you have received after registering your license.
  2. Place the license file (.lic) in any location on the local system. Do NOT use a shared folder like OneDrive or Dropbox. You may want to create a special folder to hold the NodeXL Pro license key file – this can be a good way to ensure the file is not moved or deleted.
  3. Open NodeXL Pro by searching for “NodeXL” from the START menu in Windows or look for the desktop shortcuts named NodeXL Excel template. If NodeXL Pro has not been registered before, or if the NodeXL Pro license file has been moved or damaged, you will be asked to select the file.
  4. Use the Browse… button to open a file open dialog and navigate to the location of the license file that was sent to you. Then select OK.

A4. Using your license key on multiple machines

You can use a single NodeXL Pro User License Key on any number of machines, but only one at a time. The NodeXL Pro License Key file we send to you must be placed on any machine you would like to use to run NodeXL Pro. When a license file is authorized, the copy of the license file is imprinted with machine specific data that prevents it from running on any other machine. Here is how you authorize and re-authorize a machine:

  1. Place the NodeXL Pro License Key file anywhere on the target machine’s file system. DO NOT place it in a shared folder like OneDrive or Dropbox.
  2. When NodeXL Pro opens, it will ask you to locate this License Key file. This will then authorize the use of NodeXL Pro on that machine. When a machine is authorized for NodeXL Pro, all other machines that are running NodeXL Pro are de-authorized. NodeXL Pro will not operate on these machines until one of them is re-authorized.
  3. To re-authorize a machine, copy the ORIGINAL license file (the one attached to the license email) to the target machine. DO NOT use the license file from any other machine. Only the original license file can (re-)authorize a machine.

Installation Issues

Below you find a list of the most common installation issues. If you run into an error message please find one or more keywords in the message and search for it in the text below (Ctrl+F).

If you cannot resolve your issue, feel free to request tech support from team NodeXL by filling out this form or sending an email to info@smrfoundation.org including a screenshot or text copy of the error message.

 

B1. Installation Error: Trusted Publisher and Trusted Sites

  • Error message: System.Security.SecurityException: Customized functionality in this application will not work because the certificate used to sign the deployment manifest for NodeXL Excel Template or its location is not trusted. Contact your administrator for further assistance.

There are two solutions to this problem:

Solution 1: Add Trusted Publisher

You need to add the certificate to your Trusted Publisher list. Please follow these steps to do so:

  1. Right click on NodeXL setup file “NodeXLProExcelTemplate2014Setup.exe” and click “Properties”
  2. Select “Digital Signatures” tab
  3. In the “Signatures list” select the entry “Social Media Research Foundation”
  4. Click on “Details”
  5. A new dialog should appear, click on “View Certificate”
  6. On the new windows that appears, click “Install Certificate…”, it will start the “Certificate Import Wizard”
  7. Select “Local Machine” and click “Next”
  8. In the next screen choose “Place all certificates in the following store”
  9. Click “Browse” and select “Trusted Publishers” in the dialog, click “OK”
  10. Click “Next” and then “Finish”
  11. The certificate import is finished! Close all the opened dialog windows and run the setup again.

Solution 2: Add Trusted Sites

On some systems (often in large corporations or universities) access to websites needed by NodeXL are blocked.  To resolve this issue, these web site addresses can be added to a list of trusted sites. NodeXL needs access to the NodeXLGraphGallery.org web site. To enable access to this web site, do the following:

  1. From the Windows Start menu, search for “Internet Options”
  2. Then select “Security” and “Trusted Sites”.
  3. There is a button below the Trusted Sites menu: “Sites” – select this to add the NodeXLGraphGallery.org web site to the exception list.
  4. The Trusted Sites dialog will allow you to enter the following three web addresses:
  • http://*.nodexlgraphgallery.org
  • https://*.nodexlgraphgallery.org
  • https://www.nodexlgraphgallery.org

NOTE: It is necessary to UNCHECK “Require server verification (https:) for all sites in this zone”.

B2. Installation Error: The deployment manifest could not be downloaded

  • ************** Exception Text **************
  • Sytem.TimeoutException: The deployment manifest could not be downloaded because a connection to the network could not be established. Ensure that you can connect to the network, and try again. […] TimeSpan timeout.

Reason: A firewall or antivirus software is blocking NodeXL from downloading the required installation files.

Solution 1: Add exception

Please ask your administrator to add an exception to www.nodexlgraphgallery.org so NodeXL can download the files it needs to install.

Solution 2: Temporarily disable firewall

Temporarily disable your firewall or antivirus software and then try to install the NodeXL Template again.

Solution 3: Try a different network connection

If possible, switch your internet network connection and then try to install the NodeXL Template.

  1. Place the NodeXL Pro License Key file anywhere on the target machine’s file system. DO NOT place it in a shared folder like OneDrive or Dropbox.
  2. When NodeXL Pro opens, it will ask you to locate this License Key file. This will then authorize the use of NodeXL Pro on that machine. When a machine is authorized for NodeXL Pro, all other machines that are running NodeXL Pro are de-authorized. NodeXL Pro will not operate on these machines until one of them is re-authorized.
  3. To re-authorize a machine, copy the ORIGINAL license file (the one attached to the license email) to the target machine. DO NOT use the license file from any other machine. Only the original license file can (re-)authorize a machine.

B3. Visual Studio Tools for Office Solution Installer I

  • Visual Studio Tools for Office Solution Installer: Attempting to uninstall a customization that has not been installed on this computer or has already been uninstalled from this computer. Please correct the parameter values and try again.

Reason: This error message is related to the upgrade from NodeXL Basic to NodeXL Pro.

Solution: Please have a look above at A2. Upgrade from NodeXL Basic to NodeXL Pro.

 

B4. Visual Studio Tools for Office Solution Installer II

  • Visual Studio Tools for Office Solution Installer: The following Microsoft Office solution cannot be installed due to a general installer error: Smrf.NodeXL.ExcelTemplate.vsto.
  • 0x800704C7

Solution 1: Trusted publisher and trusted sites

Please try the solutions shown in chapter B1. Trusted publisher and trusted sites.

Solution 2: Install VSTO

Please install VSTO from https://www.microsoft.com/en-us/download/details.aspx?id=48217

B5. Visual Studio Tools for Office Solution Installer III

  • Visual Studio Tools for Office Solution Installer
  • C:\Program Files (x86)\Common Files\Microsoft Shared\VSTO\10.0\VSTOInstaller.exe:
  • Windows cannot access the specified device, path, or file. You may not have the permissions to access the item.

Solution: Rename VSTOInstaller.exe

  1. In Windows Explorer, navigate to the VSTO 10.0 folder and open the path indicated in the error message which should be something similar to
    C:\Program Files (x86)\Common Files\Microsoft shared\VSTO\10.0 or C:\Program Files\Common Files\Microsoft shared\VSTO\10.0.
  2. In that folder, you should find a file named VSTOInstaller.exe.config. Rename it to VSTOInstaller.exe.config.old. (Ignore the warning from Windows about the file becoming unusable.)
  3. Run installation again.

B6. Visual Studio Tools for Office Solution Installer IV

  • Visual Studio Tools for Office Solution Installer
  • The value of the property ‘type’ cannot be parsed. The error is: Could not load file or assembly ‘Microsoft.Office.BusinessApplications.Fba, Version=14.0.0.0, Culture=neutral, …. The system cannot find the file specified.

Reason: You are not logged in as administrator.

Solution 1: Run as Administrator

  1. Right click on the NodeXL Template.
  2. Click Run as Administrator.

Solution 2: Rename VSTOInstaller.exe

  1. In Windows Explorer, navigate to the VSTO 10.0 folder and open the path indicated in the error message which should be something similar to C:\Program Files (x86)\Common Files\Microsoft shared\VSTO\10.0 or C:\Program Files\Common Files\Microsoft shared\VSTO\10.0.
  2. In that folder, you should find a file named VSTOInstaller.exe.config. Rename it to VSTOInstaller.exe.config.old. (Ignore the warning from Windows about the file becoming unusable.)
  3. Run installation again.

B8. Deployment and application do not have matching security zones

  • URLDownloadToCacheFile failed with HRESULT ‘-2146697208’
  • Error: An error occurred trying to download ‘http://www.nodexlgraphgallery.org/NodeXLBasicSetup/Smrf.NodeXL.ExcelTemplate.vsto
  • ************** Exception Text **************
  • System.Deployment.Application.InvalidDeploymentException: Deployment and application do not have matching security zones.   at Microsoft.VisualStudio.Tools.Applications.Deployment.ClickOnceAddInDeploymentManager.GetManifests (TimeSpan timeout)

Reason: A firewall or antivirus software may be blocking NodeXL from downloading the required files.

Solution: Please ask your network administrator to allow access to www.nodexlgraphgallery.org or if possible, try a different internet connection.

 

B7. Specified argument was out of range of valid values

  • ************** Exception Text **************
  • System.ArgumentOutOfRangeException:Specified argument was out of the range of valid values. Parameter name: entryValue

Reason: The ClickOnce cache is corrupted.

Solution: Reset ClickOnce cache

  1. Go to the following path: C:\Users\[user_profile]\AppData\Local\Apps
  2. Delete the folder named “2.0”
  3. Try installing NodeXL

B9. The referenced assembly is not installed on your system.

  • The referenced assembly is not installed on your system. (Exception from HRESULT: 0x800736B3)

Reason: This happens during NodeXL update because NodeXL or ClickOnce cache got corrupted

Solution 1: Reinstall NodeXL

  1. Go to “Control Panel”
  2. Click “Programs and Features”
  3. Locate “NodeXL Excel Template” and click “Uninstall”
  4. Reinstall NodeXL

Solution 2: Reset ClickOnce cache

  1. Go to the following path: C:\Users\[user_profile]\AppData\Local\Apps
  2. Delete the folder named “2.0”
  3. Try installing NodeXL

B10. Another version is currently installed

  • The customization cannot be installed because another version is currently installed and cannot be upgraded from this location.

Reason: There is already an installation of NodeXL on your system.

Solution: Uninstall NodeXL Excel Template

  1. Please use Add or Remove Programs to uninstall this program: NodeXL Excel Template.
  2. Then install the NodeXL template again.

B11. Specified cast is not valid

  • Specified cast is not valid.

Reason: NodeXL is a ClickOnce setup and it requires that the User Access Control be at the “Notify” level otherwise Windows will not run the setup.

Solution: For more information have a look at this URL https://stackoverflow.com/questions/24287717/clickonce-wont-run-getting-specified-cast-not-valid

B12. The filename, directory name, or volume label syntax is incorrect

  • ************* Exception Text **************
  • System.IO.FileNotFoundException: The filename, directory name, or volume label syntax is incorrect. (Exception from HRESULT: 0x8007007B)

Reason: This usually happens when OneDrive is used to synchronize Desktop and the user has a non-English character in their OneDrive account.

Solution: Remove OneDrive synchronization

  1. Remove Desktop from the synchronization with OneDrive.
  2. Try installing NodeXL again.

B13. HTTP redirect is not allowed

  • ************** Exception Text **************
  • System.Deployment.Application.InvalidDeploymentException: HTTP redirect is not allowed for application files and assemblies. Cannot download SnapGraphMetricCalculatorForCliquesOnly.exe.   at Microsoft.VisualStudio.Tools.Applications.Deployment.ClickOnceAddInDeploymentManager.DownloadAddIn (TimeSpan timeout)

Reason: If a user has set Internet Explorer Advanced Security option “Warn if changing between secure and not secure mode” on the deployment target computer, and if the setup URL of the ClickOnce application being installed is redirected from a non-secure to a secure site (or vice-versa), the installation will fail because the Internet Explorer warning interrupts it.

Solution: Check Internet Options

To resolve this, you have to uncheck “Warn if changing between secure and not secure mode” in Internet Options.

B14. The application binding data format is invalid

  • ************** Exception Text **************System.Runtime.InteropServices.COMException (0x800736B2): The application binding data format is invalid. (Exception from HRESULT: 0x800736B2)    at System.Deployment.Internal.Isolation.IsolationInterop.CreateActContext(CreateActContextParameters& Params)

Reason: The ClickOnce cache is corrupted.

Solution: Reset ClickOnce cache

  1. Go to the following path: C:\Users\[user_profile]\AppData\Local\Apps
  2. Delete the folder named “2.0”
  3. Try installing NodeXL.

B15. File, Donate.jpg, has a different computed hash than specified in manifest

  • File, Donate.jpg, has a different computed hash than specified in manifest.
    ************** Exception Text **************

    System.Deployment.Application.InvalidDeploymentException: File, Donate.jpg, has a different computed hash than specified in manifest. …(TimeSpan timeout)…

Reason: An antivirus/firewall is blocking NodeXL from downloading the required files.

Solution 1: Add an exception for www.nodexlgraphgallery.org to your antivirus/firewall.

Solution 2: Try a different internet connection.

Other Error Messages

If you run into any problem you cannot solve, feel free to request tech support from team NodeXL by sending an email to info@smrfoundation.org including a screenshot or text copy of the error message.

Back To Top