Deployment Guide

Software Requirements

Ampler requires the following software components to be installed:

  • Microsoft .NET Framework 4.5 or newer (download link)
  • Microsoft Office 2007-2019 or Office 365

 

Deployment

Download the latest version of the Ampler installer. You can choose between an EXE or MSI installer depending on your needs:

The Ampler installer is a standard Windows Installer. You may use your preferred deployment tool, e.g. Microsoft Deployment Toolkit (MDT), Group Policy Object (GPO) or System Center Configuration Manager (SCCM) to deploy Ampler.

 

The command to install Ampler depends on which products you want to enable. Make sure that you only enable products that you have a valid license for. If you enable a product that you don’t have a license for, Ampler will start a free trial for that product.

 

To install Ampler for PowerPoint use one of the following commands depending on whether you’re using the EXE or MSI installer:

AmplerInstaller.exe /s /v"/qn ALLUSERS=1 ADDLOCAL=Core,PowerPoint"
AmplerInstaller.msi /qn ALLUSERS=1 ADDLOCAL=Core,PowerPoint

 

To install Ampler for PowerPoint and Excel use one of the following commands:

AmplerInstaller.exe /s /v"/qn ALLUSERS=1 ADDLOCAL=Core,PowerPoint,Excel"
AmplerInstaller.msi /qn ALLUSERS=1 ADDLOCAL=Core,PowerPoint,Excel

 

To install Ampler for PowerPoint, Excel and Word use one of the following commands:

AmplerInstaller.exe /s /v"/qn ALLUSERS=1 ADDLOCAL=Core,PowerPoint,Excel,Word"
AmplerInstaller.msi /qn ALLUSERS=1 ADDLOCAL=Core,PowerPoint,Excel,Word

 

The parameters used in the above commands are:

  • /s instructs the installer to execute silently.
  • /v passes the parameters inside the quotes to the MSI. Please note, that there is no space after the /v.
  • /qn instructs the MSI to execute silently.
  • ALLUSERS=1 performs a per-machine installation. If this parameter is omitted, the installer will perform a per-user installation, i.e. Ampler will only be available to the user executing the command. Per-machine installations are recommended for company deployments.
  • ADDLOCAL=Core,PowerPoint,Word,Excel specifies that the Core feature as well as the PowerPoint, Word and Excel features should be installed. If this parameter is omitted, only the Core and PowerPoint features are installed.

 

To pre-activate Ampler for users, please download your license file from
your account. The license file contains the license itself and all of your company customizations.

The license file must be placed at this location:

  • For 32-bit Windows: %programfiles%\Smart\SmartTools\Ampler.license
  • For 64-bit Windows: %programfiles(x86)%\Smart\SmartTools\Ampler.license

If you have a network share that stores installation resources for your rollouts, you can distribute the license file using a command like the following:

copy /Y /V "\\my-network-share\Ampler\Ampler.license" "%programfiles(x86)%\Smart\SmartTools\Ampler.license"

 

 

Uninstallation

Upon normal uninstallation, Ampler will remove the installation directory and all registry keys. User settings files will, however, be kept. If you wish to uninstall and remove user settings files simultaneously, then please use either the .bat script or PowerShell script below depending on what suits you best. Both scripts perform the same set of actions.

 

UninstallAmpler.bat Full

@echo off

 

set mode=%1

 

wmic product where name="Ampler" call uninstall /nointeractive >nul 2>&1

 

if /i "%mode%"=="Full" (

 

rmdir /s /q "%appdata%\Smart" 2>nul

rmdir /s /q "%localappdata%\Smart" 2>nul

rmdir /s /q "%localappdata%\Programs\Smart" 2>nul

 

if exist "%programfiles(x86)%\Smart" (

rmdir /s /q "%programfiles(x86)%\Smart" 2>nul

)

 

if exist "%programfiles%\Smart" (

rmdir /s /q "%programfiles%\Smart" 2>nul

)

 

)

 

UninstallAmpler.ps1 -Full

Param (

[Parameter(Mandatory=$false, HelpMessage="Specify an uninstall mode. Valid values are 'Full'.")]

[ValidateNotNullOrEmpty()]

[ValidateSet('Full')]

[string]$Mode

)

 

$ErrorActionPreference = "Stop"

 

function Uninstall() {

 

$uninstall32 = gci "HKLM:\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall" | foreach { gp $_.PSPath } | ? { $_ -match "Ampler" } | select UninstallString

$uninstall64 = gci "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall" | foreach { gp $_.PSPath } | ? { $_ -match "Ampler" } | select UninstallString

 

$uninstall = ( &{ if ($uninstall32) { $uninstall32 } else { $uninstall64 } } )

 

$uninstall = $uninstall.UninstallString -Replace "msiexec.exe", "" -Replace "/I", "" -Replace "/X", ""

$uninstall = $uninstall.Trim()

 

Start-Process "msiexec.exe" -arg "/X $uninstall /qn" -Wait

 

}

 

function Remove-Tree($path) {

Remove-Item $path -Force -Recurse -ErrorAction SilentlyContinue

 

if (Test-Path "$path\" -ErrorAction SilentlyContinue) {

$folders = Get-ChildItem -Path $path -Directory -Force

foreach ($folder in $folders) {

Remove-Tree $folder.FullName

}

 

$files = Get-ChildItem -Path $path -File -Force

 

foreach ($file in $files) {

Remove-Item $file.FullName -Force -ErrorAction SilentlyContinue

}

 

if (Test-Path "$path\" -ErrorAction SilentlyContinue) {

Remove-Item $path -Force -Recurse -ErrorAction SilentlyContinue

}

}

}

 

function Delete-Configuration() {

 

Remove-Tree "$env:APPDATA\Smart"

Remove-Tree "$env:LOCALAPPDATA\Smart"

Remove-Tree "$env:LOCALAPPDATA\Programs\Smart"

$programFiles = (${env:ProgramFiles(x86)}, ${env:ProgramFiles} -ne $null)[0]

Remove-Tree "$programFiles\Smart"

}

 

Uninstall

 

if ($Mode -eq "Full") {

 

Delete-Configuration

 

}

 

Try free