You are on page 1of 8

DESWIK.

SUITE

INSTALLATION GUIDE
RELEASE: 2016.2
RELEASE DATE: NOVEMBER 2016
DOCUMENT DETAILS

Copyright

Copyright over this document and any accompanying models or data is reserved by Deswik Mining Consultants
(Australia) Pty Ltd ("Deswik".) This document is only to be used by the Client under the terms outlined herein. It
may not be distributed to third parties, reproduced or circulated in the public domain, or edited or amended in
any way, unless expressly agreed to by Deswik. Products and registered logos referred to in this document are
trademarks of their respective owners and these trademarks are hereby acknowledged.

Confidentiality

This document is subject to Deswik's Standard Terms and Conditions which detail the confidentiality
obligations of both Deswik and the Client. The Client should treat this document and any accompanying
documents, models or data as confidential at all times.

Disclaimer

This document may not be used or relied upon for any other reason than the intended purpose outlined
herein. Deswik will not be held liable for any loss or damage caused by such use or reliance.

2
Installation Guide

CONTENTS

General Information 4

Benefits of the new 64-bit installer 4

Using the new 64-bit installer 4

Using the previous 32-bit installer 4

Information for IT Departments - 64-bit Installer 5

Prerequisites for Deswik.Suite 2016.2 5

Technical background information about the new 64-bit installer 5

Deswik.Suite 64-bit installer parameters 5

Deswik.LicenseServer parameters 5

Deswik.FM parameters 6

Install type parameters 6

64-bit installer command-line install example 6

64-bit installer command-line uninstall example 6

Installing patches 7

Information for IT Departments - 32-bit Installer 8

Prerequisites for Deswik.Suite 2016.2 8

Technical background information about the 32-bit installer 8

32-bit Installer command-line options (case sensitive) 8

32-bit Installer command-line examples 8

3
General Information

GENERAL INFORMATION

As of the 2016.1 release, Deswik.Suite is now packaged with a new installer for 64-bit installations.

BENEFITS OF THE NEW 64-BIT INSTALLER


l The size of patches is significantly reduced - a great benefit for our remote customers.
l A more feature rich installer environment enabling the Deswik.MDM to be packaged into the normal
Deswik.Suite installation and into the Deswik.Suite.Portable package.
l Support for enterprise deployment methods, including providing install settings and options via the
command-line.
l Self-healing installations and truly clean uninstalls.
l Faster installs and patches.

USING THE NEW 64-BIT INSTALLER


l For the new 64-bit installer, only one full install (Setup 64bit.exe) will be created for each major version
(e.g. 2016.1, 2016.2).
l Patching the Deswik.Suite installation to later builds is undertaken by installing a patch (Patch 64bit.exe)
file for that major version.
l You cannot use the 64-bit installer on 32-bit Windows.

USING THE PREVIOUS 32-BIT INSTALLER


l For the 32-bit installer, a full install (Setup 32bit.exe) and a patch (Patch 32bit.exe) is built for each patch
build.
l Patching the Deswik.Suite installation to later builds is undertaken by installing a later Patch 32bit.exe file
or the entire full Setup 32bit.exe.
l You cannot use the 32-bit installer on 64-bit Windows.
l You can download the 32-bit installer from its own directory in the Downloads section of the Client Portal:
Public > Deswik.Suite > 2016.1 > Deswik.Suite (32 bit).

4
Installation Guide

INFORMATION FOR IT DEPARTMENTS - 64-BIT INSTALLER

PREREQUISITES FOR DESWIK.SUITE 2016.2


l 64-bit Windows 7 or higher
l .NET 4.5
l Windows update KB2999226 or Windows 10.0.10240 (Universal C Runtime)
l VC++ 2010 redistributable files 32 & 64-bit, version 10.0.30319 or higher
l VC++ 2012 redistributable files 64-bit, version 11.0.61030 or higher
l VC++ 2013 redistributable files 32 & 64-bit, version 12.0.21005 or higher
l VC++ 2015 redistributable files 64-bit, version 14.0.23026 or higher

 If you do not already have these prerequisites installed, the installer will try to download them. Therefore, an
internet connection will be required by the installer if they are not already installed.

TECHNICAL BACKGROUND INFORMATION ABOUT THE NEW 64-BIT INSTALLER


l The 64-bit install for Deswik.Suite is a 64-bit MSI inside an EXE bootstrapper.
l The EXE bootstrapper is required by some of our customers in order to work with the Windows UAC and
enable elevated permissions.
l The EXE bootstrapper takes all the same command-line options as MSIEXEC - these options are passed
through to the MSIEXEC when running the embedded MSI.
l The EXE bootstrapper also passes through installer properties and parameters through to the MSI.
l The MSI and associated CAB file can be extracted by running the command:

"Deswik.Suite 2016.2 - Setup 64bit.exe" /extract


l All patches are cumulative.

DESWIK.SUITE 64-BIT INSTALLER PARAMETERS

Deswik.LicenseServer parameters

Parameter Default Description


Value
SETUP_ false If 'false', doesn't configure any licensing settings. Set to 'true' in order to configure
LICENSE licensing. Without this parameter set to true, all other licensing parameters are
not used.

LICHOST Set this to the host name of the license server.

LICPORT 5053 Set this to the client license port of the license server.

LICADPORT 5054 Set this to the admin license port of the license server.

5
Information for IT Departments - 64-bit Installer

Deswik.FM parameters

Parameter Default Description


Value
SETUP_FM false If 'false', doesn't configure any Deswik.FM settings. Set to 'true' in order to
configure Deswik.FM. Without this parameter set to true, all other Deswik.FM
parameters are not used.

FMSERVER Set this to the file manager server name.

FMPORT 80 Set this to the port of the file manager.

FMSSL false Set this to 'true' if the Deswik.FM service uses SSL.

Install type parameters

Parameter Default Description


Value
INSTALLTYPE Default If you want to install the shortcuts to Deswik.MDM, Deswik.MDM Configuration
and Deswik.MDM Connections, set this parameter to 'full'.

64-BIT INSTALLER COMMAND-LINE INSTALL EXAMPLE

Installs the Deswik.Suite silently and sets the license server details, Deswik.FM Server details and specifies a full
install which includes Deswik.MDM components:

"Deswik.Suite 2016.2 - Setup 64bit.exe" /quiet /norestart SETUP_LICENSE="true" LICHOST="LicServerName"


LICPORT="5053" LICADPORT="5054" SETUP_FM="true" FMSERVER="FMServerName" FMPORT="80"
INSTALLTYPE="full"

64-BIT INSTALLER COMMAND-LINE UNINSTALL EXAMPLE

Performs a full uninstall of Deswik.Suite.

This command can only be run on the unpacked .msi installer, it therefore requires two steps:

"Deswik.Suite 2016.2 - Setup 64bit.exe" /extract

Then:

msiexec /x "Deswik.Suite 2016.2.msi" /qb /norestart

6
Installation Guide

INSTALLING PATCHES

1. Installing patches manually will automatically uninstall any previously applied patches before applying the
required patch. This makes it easy to roll back a patch.

2. Applying the patch via the command-line with no user interface will require elevated administrator
permissions in order for it to apply properly.

3. Applying the patch via the command-line with no user interface will not uninstall any previously applied
patches, unlike the user interface scenario in point 1 above. The process for patching via command-line is:

a. Apply all patches with elevated administrator privileges.

b. Applying multiple patches, with each patch being a later patch, without uninstalling previous
patches is fine.

c. If a patch rollback is required, later patches must be specifically uninstalled first before reverting to
or applying the required patch.

7
Information for IT Departments - 32-bit Installer

INFORMATION FOR IT DEPARTMENTS - 32-BIT INSTALLER

PREREQUISITES FOR DESWIK.SUITE 2016.2


l .NET 4.5
l Windows update KB2999226 or Windows 10.0.10240 (Universal C Runtime)
l VC++ 2010 redistributable files 32-bit, version 10.0.30319 or higher
l VC++ 2012 redistributable files 32-bit, version 11.0.61030 or higher
l VC++ 2013 redistributable files 32-bit, version 12.0.21005 or higher
l VC++ 2015 redistributable files 32-bit, version 14.0.23026 or higher

TECHNICAL BACKGROUND INFORMATION ABOUT THE 32-BIT INSTALLER


l The 32-bit install for Deswik.Suite is packaged via an NSIS installer.
l Deswik is moving away from this technology in the medium term.
l The 32-bit installer is difficult to effectively deploy via enterprise deployment mechanisms.
l All patches are cumulative.

32-BIT INSTALLER COMMAND-LINE OPTIONS (CASE SENSITIVE)


l /S runs the installer or uninstaller silently.
l /D sets the default installation directory. It must be the last parameter used in the command line and must
not contain any quotes, even if the path contains spaces. Only absolute paths are supported.
l No other command-line options or setup parameters can be passed through to the installer.

32-BIT INSTALLER COMMAND-LINE EXAMPLES


l "Deswik.Suite 2016.2 - Setup 32bit.exe" /S
l "Deswik.Suite 2016.2 - Setup 32bit.exe" /D=C:\Program Files\Deswik\Deswik.Suite 2016.2
l "Deswik.Suite 2016.2 - Setup 32bit.exe" /S /D=C:\Program Files\Deswik\Deswik.Suite 2016.2