Whole Tomato Software - Home
  • RSS Feed

Automated installation

Improve consistency of installation settings and distribute a common activation key to a large number of machines with automated installation.

Steps for automated installation vary by IDE(s) installed. If you want to install Visual Assist to IDEs from both categories, run both sets of instructions, including both sets of instructions for the activation key.

Visual Studio 2012 and newer, per user account

To install Visual Assist in an automated manner, download the latest VSIX installer from the Microsoft Visual Studio Gallery. (Due to the inability the IDE to disable notifications of updates per extension, VSIX installers are available in the Gallery one to two weeks after general release on the Whole Tomato website. Contact support if you need a VSIX installer that is not yet available in the Gallery.)

Install the VSIX from the command line, on every machine and from every user account that requires Visual Assist. With the /q parameter, Visual Assist is installed quietly for the user to every IDE: Visual Studio 2012 and newer. Without /q, the VSIX installer prompts for the IDEs to which it should install Visual Assist.

User accounts do not require administrator privileges.

Do not run the VSIX installer from the admin account, unless the admin user requires Visual Assist.

Example:

%ProgramFiles(x86)%\Microsoft Visual Studio <IDE version>\Common7\IDE\VsixInstaller.exe /q VA_X_Setup2118.vsix

If you need to install an activation key for a new license of Visual Assist or for a renewal of maintenance, create a registry script similar to:

Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Whole Tomato\Visual Assist X]
"AutoRegLicenseUser"="it@mycompany.com (25-user license) Support ends 2017.08.31"
"AutoRegLicenseKey"="00001N-E0895K-GX9QBD-7QPT6T-EJRC14-EV4H0S-3KHMJ5-BG8MZ0-N639K1-0P964T-2F18K4"

; For 64-bit operating systems, add:
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Whole Tomato\Visual Assist X]
"AutoRegLicenseUser"="it@mycompany.com (25-user license) Support ends 2017.08.31"
"AutoRegLicenseKey"="00001N-E0895K-GX9QBD-7QPT6T-EJRC14-EV4H0S-3KHMJ5-BG8MZ0-N639K1-0P964T-2F18K4"

To force Visual Assist to use your activation key, in the event users have valid but unwanted activation keys, add the following lines to your registry script:

[HKEY_CURRENT_USER\SOFTWARE\Whole Tomato\Visual Assist X]
"UserName"=-
"UserKey"=-

; For 64-bit operating systems, add:
[HKEY_CURRENT_USER\SOFTWARE\Wow6432Node\Whole Tomato\Visual Assist X]
"UserName"=-
"UserKey"=-

Note that on x64 systems, both sections are required in the .reg file (add the second, do not replace the first).

Run the registry script on every machine and from every user account that requires Visual Assist. The script places the two lines of your activation key in HKCU, where Visual Assist looks when it discovers that it is not authorized to run for the current user.

After Visual Assist has loaded successfully in one Microsoft IDE, the AutoRegLicenseUser and AutoRegLicenseKey entries are unnecessary; they may be deleted from the registry. (UserName and UserKey are required.)

User accounts do not require administrator privileges.

Do not run the registry script from the admin account unless the admin user requires Visual Assist.

Visual Studio 2010, per user account

Contact support to obtain a VSIX installer specifically for Visual Studio 2010 and follow the automated installation instructions for Visual Studio 2012 and newer.

Visual Studio 2008 and older; requires administrator privileges

Download an executable (.exe) installer from www.wholetomato.com/downloads.

Run the .exe from the command line, with parameters, only once on every machine that requires Visual Assist. Run the .exe from an account that has administrator privileges, or from a script that impersonates an administrator.

Visual Assist installs itself to every IDE it finds.

Use /D to specify an installation directory, used only for Visual Studio 2008 and older.

Without the /D parameter, /S forces Visual Assist to install itself in the default directory. (Without /D and /S, Visual Assist prompts for an installation directory.)

If you need to install an activation key for a new license of Visual Assist, or for a renewal of maintenance, run the .exe with the /LU and /LK parameters.

Parameter Description
/S Silent install: no input prompts
/D Installation directory: if unspecified, defaults to %ProgramFiles(x86)%\Visual Assist X
/LU License user: the first line of an activation key
/LK License key: the second line of an activation key

Example to install Visual Assist in a specific directory for Visual Studio 2008 and older, and install an activation key:

VA_X_Setup2118.exe /S /D "e:\tools\va" /LU "it@mycompany.com (25-user license) Support ends 2017.08.31" /LK "00001N-E0895K-GX9QBD-7QPT6T-EJRC14-EV4H0S-3KHMJ5-BG8MZ0-N639K1-0P964T-2F18K4"

Example to install Visual Assist in the default directory, and if a key is required, let Visual Assist prompt for it when an IDE is launched:

VA_X_Setup2118.exe /S