DESWIK.

SUITE

INSTALLATION GUIDE
RELEASE: 2016.1
RELEASE DATE: MARCH 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
 Deswik.Suite 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.1 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 5

Install type parameters 6

64-bit installer command-line install example 6

Installing patches 6

Information for IT Departments - 32-bit Installer 7

Prerequisites for Deswik.Suite 2016.1 7

Technical background information about the 32-bit installer 7

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

32-bit Installer command-line examples 7

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.MSP)
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 Installs and Patches > 2016.1 > Deswik.Suite 32bit.

4
 Deswik.Suite Installation Guide

INFORMATION FOR IT DEPARTMENTS - 64-BIT INSTALLER

PREREQUISITES FOR DESWIK.SUITE 2016.1

l .NET 4.5.
l VC++ 2010 version 10.0.30319 or higher.
l VC++ 2012 version 11.0.61030 or higher.
l VC++ 2013 version 12.0.21005 or higher.

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/parameters through to the MSI.
l The MSI and associated CAB file can be extracted by running the command "<Deswik.Suite EXE Name >.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

DESWIK.FM PARAMETERS

Parameter Default Description

Value

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

FMSERVER "" Set this to the file manager server name

5
 Information for IT Departments - 64-bit Installer

Parameter Default Description

Value

FMPORT "" Set this to the port of the file manager

FMSSL "false" Set this to 'true' if the 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 Deswik.Suite silently and sets the license server details, Deswik.FM Server details and specifies a full install
which includes Deswik.MDM components:

msiexec /i "Deswik.Suite 2016.1.msi" /quiet SETUP_LICENSE="true" LICHOST="LicServerName" SETUP_FM="true"

FMSERVER="FMServerName" FMPORT="80" INSTALLTYPE="full"

or

<Deswik.Suite Setup Filename>.exe /quiet SETUP_LICENSE="true" LICHOST="LicServerName" SETUP_FM="true"

FMSERVER="FMServerName" FMPORT="80" INSTALLTYPE="full"

INSTALLING PATCHES

1. Installing patches manually will automatically uninstall any previously applied patches before applying the
required patch - this effectively allows an easy patch rollback process for end users.

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

3. Applying the MSP 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.

6
 Deswik.Suite Installation Guide

INFORMATION FOR IT DEPARTMENTS - 32-BIT INSTALLER

PREREQUISITES FOR DESWIK.SUITE 2016.1

l .NET 4.5.
l VC++ 2010 version 10.0.30319 or higher.
l VC++ 2012 version 11.0.61030 or higher.
l VC++ 2013 version 12.0.21005 or higher.

TECHNICAL BACKGROUND INFORMATION ABOUT THE 32-BIT INSTALLER

l The 32-bit install for Deswik.Suite is packaged via as 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 installer.exe /S
l installer.exe /D=C:\Program Files\NSIS
l installer.exe /S /D=C:\Program Files\NSIS