Host Multiple Installations On One Server

Introduction

In versions of Squore prior to Squore 18.0, it was possible to install Squore as many times as needed on one Windows machine.

This capability has been removed by default in Squore 18.0, because it could lead to broken registry entries and issues when upgrading.

If you still need to install more than one Squore Server on your Windows machine with Squore 18 and up, you can follow the procedure on this page.

Tip:

  • If you are using Linux, these restrictions do not apply to you, but you should still be careful to take into account the memory allocated to each installation.
  • Consult the Installation and Administration Guide for more details about the installation prerequisites.

Procedure: Installing multiple instances of Squore on the same machine

  • Rationale

Installing multiple Squore Servers on the same machine is not possible with the default setup mechanism.
This is due to the Windows installation technology (Wix) for which each Squore version is considered as a unique product.

Although it is usually recommended to separate Squore server installations on different machines (e.g. one server for production on one machine, one server for development on another machine), if your environment mandates multiple Squore Server installations on the same machine, please follow these instructions.

  • Installing

To install multiple instances of Squore, you must use the official Squore setup in command line mode. Open a console in administrator mode, and type in the following command :

msiexec /i <squore-x.y.z-windows-x86_64.msi> /l install.log MSINEWINSTANCE=1 TRANSFORMS=":I<N>"

Where:

  • <server-setup-x.y.z-squoring-windows-x86_64.msi is the official Squore setup file
  • N is an installation instance number. This number accepts values from 1 to 10.

Example:

To install the 18.0.0 version of Squore instance 1, type in the command:

msiexec /i squore-18.0.0-windows-x86_64.msi /l install.log MSINEWINSTANCE=1 TRANSFORMS=":I1"

To install the 18.0.0 version of Squore instance 2, type in the command:

msiexec /i squore-18.0.0-windows-x86_64.msi /l install.log MSINEWINSTANCE=1 TRANSFORMS=":I2"

To install the 18.0.1 version of Squore instance 3, type in the command:

msiexec /i squore-18.0.1-windows-x86_64.msi /l install.log MSINEWINSTANCE=1 TRANSFORMS=":I3"

  • Upgrading

To upgrade an instance of Squore installed using the previous procedure, just launch the setup in command line mode again, specifying the instance you wish to upgrade.

Example:
Suppose Squore 18.0.0 has been installed on instance 1. To upgrade it to version 18.0.1, type in the command:

msiexec /i squore-18.0.1-windows-x86_64.msi /l install.log MSINEWINSTANCE=1 TRANSFORMS=":I1"

Suppose Squore 18.0.0 has been installed on instance 2. To upgrade it to version 18.0.1, type in the command:

msiexec /i squore-18.0.1-windows-x86_64.msi /l install.log MSINEWINSTANCE=1 TRANSFORMS=":I2"

  • Uninstalling

To uninstall one of the Squore instances, double click the instance you want to remove from the Add/Remove Programs page of the Windows Control Panel

Tip

Clicking one of the installed instances of Squore in the Add/Remove Programs page of the Control Panel displays more details about which instance is about to be uninstalled.

With the .msi installer:

It still possible to uninstall Squore from the .msi file used for the installation. In this case, you have to use this command in the CLI:

msiexec /x server-setup-18.1.0-SNAPSHOT-squoring-windows-x86_64.msi -l*v desinstallation18-1-0-logs.txt  MSIINSTANCE=1 TRANSFORMS=":I2"

Don't forget to change the instance in the command according to your needs.



Article ID: 1316
Last updated: 2019-04-15
Revision: 4
Squore -> Basics and (Un)Installation -> Host Multiple Installations On One Server
https://kb.vector.com/entry/1316/