Unattended command line installation

NVivo Windows

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

In this topic

• Overview

• Software download locations

• Installing NVivo Windows

• Installing the Windows-Mac Project Converter

• Installing language packs for auto-coding themes and sentiment

• Activating via command line and XML

• Replacing a license key via command line

• Deactivating via command line

• Removing NVivo Windows using a command line

• Removing prerequisite components

Overview

You can use the Microsoft Windows Installer (MSI) engine to perform an unattended installation of. 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 theinstaller using the command below. This creates a number of folders containing application files along with the NVivo.msi file.

• NVivo.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-on for NVivo, NCapture. This is a browser extension that allows users to gather material from the web.

You can also optionally install the Windows-Mac Project Converter plug-in to enable users to convert projects between NVivo Windows and NVivo 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.

NOTE  If users work with audio and video files, you may need to install additional codecs—for more information, refer to theNVivo Help.

Software download locations

The NVivo Windows 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 Windows.

NVivo Windows Installer

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

• Microsoft .NET Framework 4.8

• Microsoft SQL Server 2017 Express LocalDB

• Microsoft SQL Server 2019 Express LocalDB (NVivo releases 1.0 to 1.5 use Microsoft SQL Server 2017 Express LocalDB )

• Microsoft Visual C++ 2010 SP1 Redistributable Package
• Microsoft Visual C++ 2012 Update 4 Redistributable Package
• Microsoft Visual C++ 2015 Update 3 Redistributable Package

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 11

NCapture for Chrome - Requires Google Chrome 44 or later

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.

Installing NVivo Windows

1. Open the command line prompt as an administrator.

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

NDP48-x86-x64-AllOS-ENU.exe /showrmui /passive /norestart

NOTE: To ensure the other components install successfully, we recommend restarting the machine.

3. Install NVivo’s Microsoft Visual C++ 2010 SP1 Redistributable Package using the following command line.

vcredist_2010_x64.exe /passive

4. Install NVivo’s Microsoft Visual C++ 2012 Update 4 Redistributable Package using the following command line:

vcredist_2012_u4_x64.exe /passive  

5. Install NVivo’s Microsoft Visual C++ 2015 Update 3 Redistributable Package using the following command line:
   
   vcredist_2015_u3_x64.exe /passive  

6. Install NVivo’s Microsoft SQL Server 2019 Express local database instance using the following command line.

SqlLocalDB_x64.msi IACCEPTSQLLOCALDBLICENSETERMS=YES /qb

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

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

NCapture for IE

NCapture.IE.exe /v/

NCapture for Chrome

NCapture.Chrome.exe /v"/qb

8. Install NVivo using the following command line:

msiexec /Option Required Parameter [Optional Parameter]

For example, you could install NVivo using the following:

msiexec /i NVivo.msi /

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

Installing the Windows-Mac Project Converter

After installing NVivo Windows, you can optionally install the Windows-Mac Project Converter on behalf of your users who may be working with NVivo Mac (.nvpx) projects. The project converter is a software plug-in for NVivo Windows 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:

ExtractConverter.exe (972 KB)

QSR.Tools.ProjectConverter.zip (200 MB)

2. 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 Mac project in NVivo Windows

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

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

Installing language packs for auto-coding themes and sentiment

If you want to use the automated insights functionality in NVivo, you can install the available language packs on behalf of your users. There is a language pack for each supported language—English, Simplified Chinese, French, German, Japanese, Portuguese and Spanish. Language packs vary in size depending on the language.

If you choose not to install language packs for the user, the appropriate language pack will be automatically downloaded and installed on-demand the first time the user selects the feature in the Autocode Wizard—the language depend on the text content language setting of the project. During an on-demand download and installation, the user needs to have an Internet connection but does not need administrator privilege.

To download and install the language packs:

1. Download the following files:

OfflinePackageInstaller.exe (932 KB)

SalienceData_de-DE.zip (430 MB)

SalienceData_en-US.zip (260 MB)

SalienceData_es-MX.zip (136 MB)

SalienceData_fr-FR.zip (300 MB)

SalienceData_ja-JP.zip (28 MB)

SalienceData_pt-BR.zip (70 MB)

SalienceData_zh-CN.zip (239 MB)

NOTE: These file names use the standard language culture names.

2. Install language packs by doing one of the following:

• Install all languages using the following command line:

OfflinePackageInstaller.exe

• Install one language, for example English, use the following command line:

OfflinePackageInstaller.exe -i SalienceData_en-US.zip

To specify multiple languages, use a space as a delimiter. For example, install German and Spanish using the following command line:

OfflinePackageInstaller.exe -i SalienceData_de-DE.zip SalienceData_es-MX.zip

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

Activating via command line and XML

NVivo 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

This command performs a 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 14 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.

• After the activation command is run, NVivo sends an ENTER key to return focus to the command window. You can use the optional parameter -skr to suppress this. You will need to do this if you have scripted the activation command to run in a minimized window.

• 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>admin@yourorg.com</Email>

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

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

    <JobTitle>Your Job Title</JobTitle>

    <Sector>Your Sector</Sector>

    <Industry>Your Industry</Industry>

    <Role>Your Role</Role>

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

• https://download.qsrinternational.com/Software/NVivo12/SampleActivation.zip

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

• Fields in bold are mandatory.

• State is a mandatory field if you set the country field to USA, Canada or Australia.

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

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.

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.

Deactivating via command line

NVivo Windows 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

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.

Removing NVivo 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 {4D666D62-6024-47EF-A23E-D60EB7E9974D } /qb

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

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 using Uninstall a program.

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 Express LocalDB 2017
• Microsoft SQL Server Express LocalDB 2019 (NVivo releases 1.0 to 1.5 use 2017 version)
• Microsoft Visual C++ 2010 SP1 Redistributable Package
• Microsoft Visual C++ 2012 Update 4 Redistributable Package
• Microsoft Visual C++ 2015 Update 3 Redistributable Package
• Microsoft .NET Framework 4.8