Unattended command line installation

NVivo 10 Windows

This topic describes how you can perform an unattended installation and activation of NVivo 10 Windows using the Windows Installer (MSI) engine.

In this topic


 


Overview

You can use the Microsoft Windows Installer (MSI) engine to perform an unattended installation of NVivo 10 Windows. An unattended installation is undertaken entirely from the command line and requires no user interaction.

The MSI file and application files can be extracted from the NVivo 10 installer using one of the commands below. This creates a number of folders containing application files along with the QSR NVivo 10.msi file. 

  • For 32-bit installations, use: NVivo10.x86.exe /a

  • For 64-bit installations, use: NVivo10.x64.exe /a

If you require a silent installation (no messages or windows are displayed), you may need to change the command line options.

If you intend to install NVivo using the Windows Installer (MSI) engine, you will need to ensure that the prerequisites for NVivo are installed before you install NVivo—you can download these components from the Software download locations listed below. Instructions for installing these prerequisite components are provided.

You can also optionally install the supplementary add-ons for NVivo:

  • NCapture—this is a browser extension that allows users to gather material from the web.

  • NVivo Add-In for OneNote—this allows users to export content from OneNote for import into NVivo 10 Service Pack 1 (or later).

You can also optionally install the Windows-Mac Project Converter plug-in (NVivo 10 Windows Service Pack 5 or later) to enable users to convert projects between NVivo 10 Windows and NVivo 10 for Mac format. If you do not install this plug-in, it will be automatically downloaded and installed the first time the user converts a project between NVivo for Windows and NVivo for Mac formats.

NVivo 10 Windows Service Pack 2 (or later) allows users to work with YouTube videos (collected with NCapture). To play YouTube videos, users need to have Adobe FlashPlayer 11 and Internet Explorer 8 (or later).

NVivo 10 Windows Service Pack 5 (or later) provides streamlined import from Evernote. To support the import of audio files from Evernote, QuickTime Player 7 (a 32-bit component) is now required for both 32- and 64-bit versions of NVivo 10 Windows.

Top of Page

Software download locations

The NVivo 10 (32-bit and 64-bit) installer packages are available for download from the QSR website. Later releases of these components may become available. However we recommend that you use the versions listed below, as these have been tested with NVivo 10.

https://www.qsrinternational.com/support_downloads.aspx

Installing NVivo 10 and its prerequisites requires Windows Installer 4.5, which can be downloaded (if not already installed).

Windows Installer Packages for NVivo 10’s prerequisites are available for download using the following links:

Microsoft .NET Framework 3.5 SP1  (231 MB)

Microsoft SQL Server 2008 R2 SP2 Express Edition (x86) - For the 32-bit version of NVivo 10 only (110 MB)

Microsoft SQL Server 2008 R2 SP2 Express Edition (x64) - For the 64-bit version of NVivo 10 only (122 MB)

QuickTime Player 7.7  (37.1 MB)

Windows Media Player 11 (x86) - For Windows XP only (24.5 MB)

Adobe Flash Player 11 (16.0 MB)

You can optionally download and install supplementary add-ons for NVivo. The latest versions of these add-ons are available from the links below:

NCapture for IE - Requires Internet Explorer 8 or later

NCapture for Chrome - Requires Google Chrome 21 or later

NVivo Add-In for OneNote - Requires Microsoft OneNote (2007 or 2010) and Microsoft Word (2007 or 2010)

You will need additional files if you want to install the Windows-Mac Project Converter on behalf of your users—refer to Installing the Windows-Mac Project Converter.

Top of Page

Installing NVivo 10 Windows (32-bit)

  1. Go to the command line prompt.

  2. Install Microsoft .NET Framework 3.5 SP1 (if not already installed) using the following command line:

dotnetfx35.exe /qb

  1. Install NVivo 10’s Microsoft SQL Server 2008 R2 SP2 Express Edition database instance using the following command line.

Click in the field below and press CTRL + C to copy the code to your clipboard.

NOTE: Omit this step if you wish to install NVivo 10 for Windows without a local database component.

  1. Prepare to install QuickTime Player 7.7 by using this command line to extract its component packages:

QuickTimeInstaller.exe /extract

Then install each of its component packages using the following command lines:

AppleApplicationSupport.msi /qb

QuickTime.msi /qb DESKTOP_SHORTCUTS=0

AppleSoftwareUpdate.msi /qb

  1. Install Windows Media Player 11 for Windows XP (if not already installed) using the following command line:

wmp11-windowsxp-x86-enu.exe /q

  1. Install Adobe Flash Player 11 using the following command line:

install_flash_player_11_active_x.msi /qb

  1. (Optional) Install the supplementary add-ons:

NCapture for IE

NCapture.IE.exe /v"/qb"

NCapture for Chrome

NCapture.Chrome.exe /v"/qb"

NVivo Add-In for OneNote

NVivoAddIn.OneNote.exe /v"/qb"

  1. Install NVivo using the following command line:

msiexec /Option <Required Parameter> [Optional Parameter]

For example, you could install NVivo using the following:

msiexec /i "QSR NVivo 10.msi" /qb

Refer to Installation options and parameters for a list of command line options and public properties.

Top of Page

Installing NVivo 10 Windows (64-bit)

  1. Go to the command line prompt.

  2. Install Microsoft .NET Framework 3.5 SP1 (if not already installed) using the following command line:

dotnetfx35.exe /qb

  1. Install NVivo 10’s Microsoft SQL Server 2008 R2 SP2 Express Edition database instance using the following command line.

Click in the field below and press CTRL + C to copy the code to your clipboard.

NOTE: Omit this step if you wish to install NVivo 10 for Windows without a local database component.

  1. Prepare to install QuickTime Player 7.7 by using this command line to extract its component packages:

QuickTimeInstaller.exe /extract

Then install each of its component packages using the following command lines:

AppleApplicationSupport.msi /qb

QuickTime.msi /qb DESKTOP_SHORTCUTS=0

AppleSoftwareUpdate.msi /qb

  1. Install Adobe Flash Player 11 using the following command line:

install_flash_player_11_active_x.msi /qb

  1. (Optional) Install the supplementary add-ons:

NCapture for IE

NCapture.IE.exe /v"/qb"

NCapture for Chrome

NCapture.Chrome.exe /v"/qb"

NVivo Add-In for OneNote

NVivoAddIn.OneNote.exe /v"/qb"

  1. Install NVivo using the following command line:

msiexec /Option <Required Parameter> [Optional Parameter]

For example, you could install NVivo using the following:

msiexec /i "QSR NVivo 10.msi" /qb

Refer to Installation options and parameters for a list of command line options and public properties.

Top of Page

Installing the Windows-Mac Project Converter

After installing NVivo 10 Windows, you can optionally install the Windows-Mac Project Converter on behalf of your users who may be working with NVivo 10 for Mac (.nvpx) projects. The project converter is a software plug-in for NVivo 10 Windows Service Pack 5 (or later) that converts projects to or from the NVivo for Mac format.

To download and install the Windows-Mac Project Converter:

  1. Download the following files (or access them from your NVivo 10 USB flash drive):

ExtractConverter.exe (972 KB)

QSR.Tools.ProjectConverter.zip (184 MB)

  1. Install the Windows-Mac Project Converter using the following command line:

ExtractConverter.exe "QSR.Tools.ProjectConverter.zip"

The project converter files will be extracted from the zip file and installed in the appropriate folder on the user's computer.

If you choose not to install the project converter for the user, it will be automatically downloaded and installed on-demand the first time the user:

  • Opens, copies or imports an NVivo 10 for Mac project in NVivo 10 for Windows

  • Copies or exports an NVivo 10 for Windows project to NVivo 10 for Mac format

During an on-demand download and installation, the user needs to have an Internet connection but does not need administrator privilege.

Top of Page

Activating via command line and XML

NVivo 10 can be activated via the Internet using a command line script and an activation XML file. A valid license key is required for this process.

The following script needs to be run on each computer you intend to activate:

nvivo -i <license key> -a <activation filename> [-u <username> [-p <password>] [-d <domain>]]

This command performs a silent product initialization using the specified license key and the activation details in the specified activation file.

NOTE  

  • Enter the license key in the following format: xxxxx-xxxxx-xxxxx-xxxxx-xxxxx

  • If you want to use NVivo as a 30 day trial, you can use the  '-i' parameter without a license key.

  • If your organization's proxy server requires your activation request to be authenticated, you may optionally specify a username, password and/or domain. This information is not retained by QSR.

  • Angle brackets <  > indicate that the enclosed element is mandatory. You need to replace the text within the angle brackets with relevant information. Do not type the angle brackets themselves in the command line.

  • Square brackets [  ] indicate that the enclosed element is optional. Do not type the square brackets themselves in the command line.

Activation file format

Copy the text below into Notepad, set the values within the tags, and then save as an .xml file. Ensure that you save it with UTF-8 encoding.

<?xml version="1.0" encoding="utf-8" standalone="yes"?>

<Activation>

  <Request>

    <FirstName>John</FirstName>

    <LastName>Sysadmin</LastName>

    <Email>[email protected]</Email>

    <Phone>+1-555-555-5555</Phone>

    <Fax>+1-555-555-5555</Fax>

    <JobTitle>Your Job Title</JobTitle>

    <Industry>Your Industry</Industry>

    <Department>Your Department</Department>

    <Organization>Your Organization</Organization>

    <City>Boston</City>

    <Country>USA</Country>

    <State>Massachusetts</State>

  </Request>

</Activation>

You can also download a zip file containing the sample activation file. Extract the file and then open it in your text editor.

NOTE  You must observe the following rules, or the activation will fail:

  • Fields in bold are mandatory.

  • You must use a valid email address.

  • You must use abbreviations for the following countries:

  • For United States of America, use USA

  • For United Kingdom, use UK

  • For all other countries, capitalize the first letter of each word—for example, 'Mexico' or 'New Zealand'. Refer to the list of accepted country names for the specific format and spelling for your country name.

Top of Page

Extending or replacing a license key via command line

Enterprise licenses (formerly known as site licenses) enable multiple users in your organization to work with NVivo for a period of time. When an enterprise license is renewed, your organization will receive a new license key that you use to extend the existing license. For more information on extending a license via the command line, refer to Extending a license.

If your site has been issued multiple NVivo license keys and you encounter problems activating a particular license key—for example, if a license key has expired or has been activated too many times—then, you can use a different license key instead. For more information about replacing a license key via the command line, refer to Replacing a license.

 Top of Page

Deactivating via command line

NVivo 10 can be deactivated via the Internet using a command line script. The following script needs to be run on each computer you want to deactivate:

nvivo -deactivate [-u <username> [-p <password>] [-d <domain>]]

This command performs a ‘silent’ deactivation of the NVivo license.

NOTE  

  • If your organization’s proxy server requires your deactivation request to be authenticated, you may optionally specify a username, password and/or domain. This information is not retained by QSR International

  • Angle brackets <  > indicate that the enclosed element is mandatory. You need to replace the text within the angle brackets with relevant information. Do not type the angle brackets themselves in the command line.

  • Square brackets [  ] indicate that the enclosed element is optional. Do not type the square brackets themselves in the command line.

Top of Page

Removing NVivo 10 Windows using a command line

We recommend that you deactivate NVivo before uninstalling the software so that you can reuse the license key on another computer.

To remove the NVivo software using a command line, run the following command:

msiexec /x {49BFDB10-A9AC-4368-9BF1-236D569DD8F0} /qb

NOTE If the NCapture browser extension was also installed, you can remove it from the Control Panel.

Top of Page

Removing prerequisite components

NVivo relies on a number of other components to run, and if they are not already present when you install the software using the setup wizard, NVivo will install them for you. However, when NVivo is uninstalled, these components remain on the workstation.

These components can be removed individually from the Control Panel. For computers running:

  • Windows Vista, Windows 7 and Windows 8, use Uninstall a program.

  • Windows XP, use Add or Remove Programs.

You should only uninstall them if you are certain that they are not utilized by other programs on your computer.

The components to be removed, in order, are:

  • Microsoft SQL Server 2008 R2 SP2 Express Edition
  • Microsoft .NET Framework 3.5 SP1
  • QuickTime Player 7
  • Windows Media Player 11
  • Adobe Flash Player 11 (NVivo 10 for Windows Service Pack 2 or later)

Top of Page