Command line switches and deployment details

Summary

• Command-line options
• Installed content
• Registry keys
• Certificate
• Modified folders at run time

Command-line options

By default, UpSlide is installed for all users when you execute it with administrator permissions.

Command-lines for .exe installation

Install

The command line below silently installs UpSlide even if the user has Office applications running.

"pathToExeFile.exe" -q2

Uninstall

"pathToExeFile.exe" -q2 TsuRunMode=2 

Options for custom install

By default, UpSlide is installed in English in C:\ProgramData\UpSlide. You can use the optional switches below to change some default options.

• -q2 for silent installation.
• “CheckProcesses=0” allows UpSlide to install while Office PowerPoint, Excel and Word run. This option is enabled by default.
  • You can use “CheckProcesses=1” to force closing the Office applications before installing.
• “LANG=en-US” or “LANG=fr-FR” forces the UpSlide user interface to be in English (default) or French.
• /a1 to force single-user install.
• /a4 to force an all-users install (default). This option requests an administrator password to continue if the current user does not have sufficient permissions.
• “AllUserInstallFolder=CustomPath\UpSlide” “UpSlideServiceFolder=CustomPath\UpSlideService” to specify a custom location for installation and a custom location for the reactivation service installation. Note that these switches must be passed together using the same CustomPath.

Examples

To force a silent UpSlide installation in customPath\UpSlide

"pathToExeFile.exe" -q2 "AllUserInstallFolder=customPath\UpSlide" "UpSlideServiceFolder=customPath\UpSlideService"

To force a silent single-user installation in French

"pathToExeFile.exe" -q2 /a1 "LANG=fr-FR"

Installed content

Installation Folder

This folder contains just under 100 Mo of files, not including the Config folder, which contains the customization. It mainly consists of dlls and three .vsto files, one for each Office application, which will serve as entry points into UpSlide.

• C:\ProgramData\UpSlide is the default installation folder for the all user install.
• %USERPROFILE%\AppData\Roaming\UpSlide is the default installation folder for the single user install.

Config folder

Apart from deploying application files, the installer also creates a subfolder named Config to store the UpSlide customization, including:

• Content Libraries.
• Template and theme files for PowerPoint, Excel, and Word.
• Table of Contents option.
• Any other specific content.

Registry keys

Like any VSTO add-in, UpSlide needs a registry key to link Excel, PowerPoint, or Word to the application dll.

All-user Install

We highly recommend an all-user installation with admin permissions. The registry keys are created in the local machine hive HKEY_LOCAL_MACHINE.

• Software/Microsoft/Office/Excel/Addins/Finance3point1.UpSlide.Excel
• Software/Microsoft/Office/PowerPoint/Addins/Finance3point1.UpSlide.PowerPoint
• Software/Microsoft/Office/Word/Addins/Finance3point1.UpSlide.Word

For each application, 4 keys are created, all required for VSTO to function correctly:

• Friendly name (String) name displayed in the add-ins list of the Office application.
• Description (String) also displayed in the list of add-ins.
• LoadBehavior (DWord) specifies if the add-in is loaded during application start-up. It should always be set to 3.
• Manifest (String) this value links the Office application to the installed dlls. It points to the .vsto file in the installation folder. The |vstolocal string is appended to the path.

Please beware of two specific requirements:

• If the installation is carried out on an x64 machine with an x32 version of Office, the keys are inserted in HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node.
• An additional key value is needed in HKEY_LOCAL_MACHINE\SOFTWARE\Office\12.0\Common\General: EnableLocalMachineVSTO (Dword) set to 1.

Configuration keys

Installation parameters are also stored in the registry, in the Excel add-in key:

• User interface language is stored in a string value named LANG (as of now, value can either be “fr-FR” or “en-US”).
• The user license is stored in HKEY_CURRENT_USER/Software/Microsoft/Office/Excel/Addins/Finance3point1.UpSlide.Excel as a Dword value.

Single user Install

The same keys will be created in the HKEY_CURRENT_USER hive:

• Software/Microsoft/Office/Excel/Addins/Finance3point1.UpSlide.Excel
• Software/Microsoft/Office/PowerPoint/Addins/Finance3point1.UpSlide.PowerPoint
• Software/Microsoft/Office/Word/Addins/Finance3point1.UpSlide.Word

Certificate

To avoid an Office trust prompt when UpSlide is first used (see here), the installer installs the UpSlide certificate in the Trusted Publisher store.

Modified folders at run time

Temporary files

UpSlide handles its own Temp folder inside the installation folder.

User settings and log files

They are stored in the application data folder (e.g. %USERPROFILE%\AppData\Roaming\UpSlide in Windows 7). For a single user install, this is the same as the installation folder.

User profile content

All user specific content such as the tombstone database is stored by default in %appdata%\UpSlide\Content.

Config Folder

A user can modify the contents of the config folder (although not by choice), for example when UpSlide regenerates settings files for compatibility reasons.

For these reasons, the UpSlide installer gives read and write authorization to everyone on the Config folder.