HomeKurzweil 3000 (K3000)Kurzweil 3000 (General)Guide: MSI Deployment + Remote Installation - K3000 v16 (Win)

1.51. Guide: MSI Deployment + Remote Installation - K3000 v16 (Win)

Last Updated: June 2018

Applies to Versions: Kurzweil 3000 Windows Version 16 - Standalone, Network, Web License

This article is written for system or network administrators attempting to create an enterprise-level silent installation/deployment of Kurzweil 3000 (K3000).

Step Summary:

1. Uninstall any older version of K3000 on the computers

2. Download the latest full build installer for K3000 v16, don't use the DVD

3. Extract and copy the K3000 installation files to your distribution point

4. Install Visual C++ and .NET dependencies before K3000 v16

5. Install K3000 v16 from the MSI

6. Testing the MSI

7. Install Acapela Voices

Additional Info:

- How to install future MSI patches for K3000

- How to use Orca to modify MSI files to "bake in" property values instead of command-line arguments

1. Uninstall any older version of K3000 on the computers

For K3000 v16 to install properly, you must first uninstall any older version of K3000. For example, if you have K3000 v15 installed, you must uninstall K3000 v15 first before installing K3000 v16.

All of K3000's MSI installers can also work as uninstallers if you pass the msiexec uninstall command switch /x to the MSI.

If you still have your K3000 v15 installation files on your distribution point, you can use those to uninstall K3000 v15; you would need K3000 v14 installation files to uninstall K3000 v14, etc.

Instructions:

1. Locate the K3000 v15 installation files on your distribution point (network share drive).

2. If you no longer have the K3000 v15 installation files, you can download them from here: https://www.kurzweiledu.com/k3000-previous-downloads.html

3. The command-line to silently uninstall K3000 v15 would be:
msiexec /x "<path to K3000 v15 installation files>\Software\Kurzweil 3000 v.15.msi" /qn /norestart

4. Deploy the uninstall job, ensuring that the older version of K3000 is uninstalled on the computer grouping.

5. Get ready to prepare your K3000 v16 silent install following the instructions below.


2. Download the latest full build installer for K3000 v16, don't use the DVD

We release a new build of K3000 v16 (i.e. an updated version) at the beginning of each month. It's always recommended to install from the latest downloadable build, because the build on the DVD is often outdated.

Download the latest build of K3000 v16 from here: https://www.kurzweiledu.com/k3win

Make sure to download the correct edition, e.g. if your organization purchased the Web License edtion, make sure to download that; don't download Standalone if you need to install Web License.


3. Extract and copy the K3000 installation files to your distribution point (network share)

The downloaded file is a self-extracting .exe. Running or extracting the .exe will create an InstallTemp[...] folder that contains the installation files for the latest full build of K3000 v16. To simplify instructions, rename that InstallTemp[...] folder to K3000v16.

Copy the K3000v16 folder to a distribution point, usually a shared folder or drive, on your network.


4. Install Visual C++ and .NET dependencies before K3000 v16

A regular full UI install of K3000 (i.e. double-clicking Setup.exe file and following the GUI prompts) will automatically install the following Visual C++ and .NET redistributables if they're not already installed on the computer; however, when the K3000 installer is run silently (i.e. a msiexec deployment made with a /qn switch) it does not install these redistributables.

The following redistributables must be installed before doing a silent MSI install of K3000:

Microsoft .Net Framework 4.0 Full

Download: https://www.microsoft.com/en-us/download/details.aspx?id=17718

Silent install command-line example:

<filename>.exe /q /norestart

General info regarding deployment: https://blogs.msdn.microsoft.com/astebner/2010/05/12/silent-install-repair-and-uninstall-command-lines-for-the-net-framework-4/

How to create and install as a MSI: https://blogs.msdn.microsoft.com/astebner/2010/06/04/how-to-create-an-administrative-install-point-for-the-net-framework-4/

Microsoft .Net Framework 4.0 Full Update KB2468871

Download: https://www.microsoft.com/en-us/download/details.aspx?id=3556

Microsoft Visual C++ 2013 Redistributable Package x86 & x64

Download: http://www.microsoft.com/en-us/download/details.aspx?id=40784

Microsoft Visual C++ 2013 Redistributable Package x86 (required for both 32-bit and 64-bit OSes)
Microsoft Visual C++ 2013 Redistributable Package x64 (required for 64-bit OS only, must be installed after the x86 package)

Silent install command-line example:

vcredist_x86.exe /install /quiet /norestart
vcredist_x64.exe /install /quiet /norestart

How to create and install as a MSI from the redistributable: http://www.applepie.se/visual-c-2013-silent-install-and-msi

Warning: There's a third version of the 2013 Visual C++ redistibutable, the arm version which is made for Windows 8 tablets, and may be downloaded as part of an automatic update from the Windows Store. The arm version is not compatible with K3000. If this package is installed, make sure to uninstall it from the computers first.

Microsoft Visual C++ 2017 Redistributable Package x86 & x64

Download: https://www.visualstudio.com/downloads/, https://go.microsoft.com/fwlink/?LinkId=746572

Direct link (x86): https://aka.ms/vs/15/release/VC_redist.x86.exe

Direct link (x64): https://aka.ms/vs/15/release/VC_redist.x64.exe

Silent install command-line example:

vcredist_x86.exe /install /quiet /norestart 
vcredist_x64.exe /install /quiet /norestart


5. Install K3000 v16 from the MSI

In step 3, you extracted the installation files to a K3000v16 folder and copied it to your distribution point. Keep the files together in their relative location in the K3000v16 folder, with the path to the MSI being <path to distribution point>\K3000v16\Software\Kurzweil 3000 v.16.msi

Remember to install the correct edition of the software. So if your organization owns the Web License edition, use the command-line properties for Web License.

Standalone Edition

Properties

Values

Description

AUTO

1

Required property value for silent installs.

EDITION

standalone

Determines the type of client that is installed.

Command-line example (single line):

msiexec /i "<path to distribution point>\K3000v16\Software\Kurzweil 3000 v.16.msi" AUTO="1" EDITION="standalone" /qn /norestart

Note:

The Standalone edition in order to be usable must be activated on each computer after installation. This can be accomplished by completing a registration chute within the K3000 software after installation. Registration requires a serial number (the serial number should start with 31600...)

 

Network Edition - Standard Network Client

Properties

Values

Description

AUTO

1

Required property value for silent installs.

EDITION

net

Determines the type of client that is installed.

SERVER

<IP address>

e.g.: 172.3.1.0

This is the internal static IP address of the computer where the Kurzweil 3000 Network Engine (the network licensing server) is installed. The IP address of "172.3.1.0" is an example.

Command-line example (single line):

msiexec /i "<path to distribution point>\K3000v16\Software\Kurzweil 3000 v.16.msi" AUTO="1" EDITION="net" SERVER="172.3.1.0" /qn /norestart

 

Network  Edition - Remote/Take Home Client

Properties

Values

Description

AUTO

1

 Required property value for silent installs.

EDITION

netpro

Determines the type of client that is installed.

Command-line example (single line):

msiexec /i "<path to distribution point>\K3000v16\Software\Kurzweil 3000 v.16.msi" AUTO="1" EDITION="netpro" /qn /norestart

Note:

It is advised to not install Network Remote Clients remotely or through deployments.  The idea behind a Network Remote Client is to install Kurzweil 3000 on a user's home computer, where it will temporarily function without access to the Internet or a network connection.

After installation the Network Remote Client will not function until it is activated with a License-to-Go code. You can generate License-to-Go codes from your Kurzweil 3000 Network Engine (your license server).  Generating such codes will "check out" the license from your server.

Warning: The Network Remote Client will only function when run by an Administrator.  Restricted users cannot run the Network Remote client.

 

Web License Edition

Properties

Values

Description

AUTO

1

Required property value for silent installs.

EDITION

web

Determines the type of client that is installed.

Command-line example (single line):

msiexec /i "<path to distribution point>\K3000v16\Software\Kurzweil 3000 v.16.msi" AUTO="1" EDITION="web" /qn /norestart

 
Disabling Auto-Updates During Installation (Optional)

By default, Kurzweil 3000 (any edition) will attempt to search for updates and install any updates it finds when launched by an Administrator on a computer.  This can be disabled during installation by adding the optional property value.

Properties

Values

Description

AUTOUPDATE

0

Disables auto-updates.

 

1

Default value if not specified. Kurzweil will check for updates and install any it finds each time it's launched by an Administrator.

Command-line example (Web License Edition):

msiexec /i "<path to distribution point>\K3000v16\Software\Kurzweil 3000 v.16.msi" AUTO="1" EDITION="web" AUTOUPDATE="0" /qn /norestart

6. Testing the MSI

Before you create a deployment, you may want to test the installer manually.

1. Run cmd.exe (right-click > Run as Administrator if UAC is enabled on the computer)

2. Excecute a Windows Installer (msiexec.exe) installation via a command-line example above.

3. To monitor installation, you can observe the msiexec.exe process in Task Manager.

4. The installation should be considered complete when:
    a) All instances of the msiexec.exe process are no longer taking any CPU resources.
    b) There is a Kurzweil 3000 shortcut created on the desktop.
    c) There is an entry Kurzweil 3000 v.16 in Windows' installed programs.


7. Install Acapela Voices

If you want extra high quality Text-to-Speech (TTS) voices and languages to use within K3000 v16, we recommend installing the Acapela high quality voices that are licensed for K3000. They're free for you to download.

Note that K3000 will already come installed with high quality US English, Spanish, and French Canadian voices. Installing additional Acapela voices is entirely an optional step.

Instructions:

1. Download the installers.

The Acapela voice installers can be found here: http://www.kurzweiledu.com/k3win

The installers are packaged as self-extracting EXE files. Running or extracting the EXE will create a folder named (for example) InstallTemp_AcapelaEnglishNonUSVoices_1600 containing the installation files. Feel free to rename the folder.

2. Copy the folder to your distribution point.

3. There are no special property values required to be passed to the Acapela voice MSI installers.

Command line example for a silent install without restarting:

msiexec /i "<path to distribution point>\AcapelaEnglishNonUSVoices_1600\Acapela English Non-US Voices.msi" /qn /norestart



How to use Orca to modify MSI files to "bake in" property values instead of command-line arguments

Kurzweil requires a certain set of property values to be passed to the MSI in order to install correctly. These property values can be passed via command-line as noted in the above tables and examples. However, when deploying through systems where these additional command-line switches may not be guaranteed to pass properly, it is recommended to directly modify these property values in the Kurzweil 3000 v.16.msi file's database Property table.  This way you can "bake in" everything to the .msi, so you can simply add the MSI to a job and it will install properly.

If you own a Windows server, it is recommended to download and install Orca to edit values in the database Property table of the Kurzweil 3000 v.16.msi file.

Orca is normally included in the Windows SDK. For your convenience, we've included it as an attached download at the bottom of this article (scroll down).

Instructions:

1. Download and install Orca. Choose to do a Complete install.

2. Navigate to <path to distribution point>\K3000v16\Software\Kurzweil 3000 v.16.msi and right-click the MSI > Edit with Orca.

3. Find the Property table (in the left column of Orca's GUI).

4. Rows for AUTOEDITIONSERVER, and AUTOUPDATE are all found in the Property table (found in the table on the right side of the GUI). Sort the Property table alphabetically so you can easily find the applicable fields. Click in the applicable value fields to edit them. Do not attempt to edit fields/values not specified within this article.

5. When entering values in to database fields, do not include "quotes" around each value like you would when passing Property values via command-line. Edit the applicable values and then File > Save changes to the Kurzweil 3000 v.16.msi file. Do not create a .mst file to apply the changes.

6. After saving the changes and exiting Orca, right-click the Kurzweil 3000 v.16.msi file > Edit with Orca again, go back to the Property table and to verify that your changes took.

If you edit the file this way you do not have to worry about passing these property values during installation via command-line.


How to install future MSI patches for K3000

If you have older versions of K3000 v16 installed, you may want to update the software (e.g. from v16.01 to v16.04) through installing a patch. We have MSI patches available that can can be installed silently.

You only need to install the latest patch to fully update K3000. For example, if you have v16.01 installed and want to update to the latest verison, which at the time would be v16.04, then you only need to install the v16.04 patch. You don't have to install the v16.02 patch and then the v16.03 patch.

Instructions for silently installing the .msi patch can be found here: http://support.cambiumtech.com/index.php?pg=kb.page&id=1793


Knowledge Tags

Downloads

This page was: Helpful | Not Helpful