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
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:
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.
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
