Prerequisites

You need a Windows Application Server with Internet Information Services (IIS) installed.

Verify the IIS Configuration

Verify that IIS has the necessary server roles. In the Add Roles and Features Wizard, ensure that the following server roles are installed:

For IIS 8.5, the Add Roles and Features Wizard shows the following features installed.

For IIS 10, the Add Roles and Features Wizard shows the following features installed. Note that the example shows more features installed.

Extract the Suite Autoinstaller

The Suite Autoinstaller is distributed as a ZIP file. The file naming convention is as follows: Suite<version>Server<patch>Auto-Installation<autoinstaller-version>-with-Tomcat-<Tomcat-version>.zip, for example, Suite811Server_16_3_Auto-Installation-v1-with-Tomcat-9.0.89.zip.

Unzip the contents of the Suite Autoinstaller in C:\. This action creates the folder C:\Suite<version>ServerInstall, for example, C:\Suite811ServerInstall. The contents of C:\Suite811ServerInstallare similar to the following output. OpenJDK, Apache Tomcat, and Java versions may change.

   ChangeLog.txt
   IIS.ps1
   IIS.zip
   InstallSuite.bat
   InstallSuite.properties
   InstallSuite.ps1
   OpenJDK11U-jdk_x64_windows_hotspot_11.0.23_9.zip
   SuiteFiles.zip
   apache-tomcat-9.0.89-windows-x64.zip
   jdk-8u401-windows-x64.exe
   tomcat-connectors-1.2.40-windows-i386-iis.zip
   tomcat-connectors-1.2.40-windows-x86_64-iis.zip

Download the Latest Versions of Tomcat and Java/OpenJDK

The Suite Autoinstaller already contains the installation files for Tomcat, Java, and OpenJDK, however, we recommend that you compare the versions bundled in the Suite Autoinstaller with the latest versions available and replace the Tomcat and Java/OpenJDK versions in the Suite Autoinstaller with the latest versions.

Starting April 16, 2019, Java SE requires a subscription, for this reason, Suite comes with a version of OpenJDK to use as an alternative to Java SE.

To replace the old versions of Tomcat or Java/OpenJDK:

1. Download the latest Tomcat and Java installation files, or download OpenJDK if you won't be using Java.

2. Go to C:\Suite<version>ServerInstall, for example, C:\Suite811ServerInstall.

3. Replace the files. Delete the old versions and add the new ones. For example, Suite811Server_16_3_Auto-Installation-v1-with-Tomcat-9.0.89.zip has the following Tomcat, Java, and OpenJDK versions.

   • Tomcat: apache-tomcat-9.0.89-windows-x64.zip

   • Java: jdk-8u401-windows-x64.exe

   • OpenJDK: OpenJDK11U-jdk_x64_windows_hotspot_11.0.23_9.zip

Edit the InstallSuite.properties File

The InstallSuite.properties file contains the installation configuration used by the Suite Autoinstaller. Edit InstallSuite.properties if necessary. This section explains the configuration variables.

Example InstallSuite.properties file:

   #property.target.folder: The full path of where LM Server is to be installed.
   #NOTE: This defaults to and is usually “C:\Suite811”. The folder must not exist, the program will create it.
   property.target.folder="C:\Suite811"

   #property.source.folder: The full path of the folder containing the LM Server installation files. 
   #NOTE: This defaults to and is typically “C:\Suite811ServerInstall”.
   property.source.folder="C:\Suite811ServerInstall"

   #property.deployment.name: This is the name of the suite context in the URL. 
   #NOTE: This defaults to and is typically “suite811”.
   property.deployment.name="suite811"

   #property.instances: This is the number of Tomcat instances to be installed on the server. 
   #NOTE: This defaults to and is typically 2.
   #There should be about 1 instance per 25 concurrent users, with about 3 to 4 maximum instances per server depending on available memory. Refer to the Suite Server Installation Guide. 
   #The PowerShell installer script will not work with 5 or more instances, the server.xml files will have overlapping ports.
   property.instances=2

   #property.openjdk: This designates whether OpenJDK "true" or Oracle JDK "false" is to be used (“true” = OpenJDK, “false” = Oracle JDK”).
   #NOTE: This defaults to and is typically true.
   property.openjdk=true 

   #property.iis.enabled: This designates whether Windows IIS (Internet Information Services) is to be used.
   #NOTE: This defaults to and is typically false.
   property.iis.enabled=true

Unblock the InstallSuite.ps1 and IIS.ps1 files

Files InstallSuite.ps1 and IIS.ps1 might cause an error during installation: "The file C:\Suite811ServerInstall\InstallSuite.ps1 is not digitally signed. You cannot run this script on the current system". To prevent this error, unblock the files before running Suite Autoinstaller. Perform one of the following methods.

    unblock-file -path C:\Suite811ServerInstall\InstallSuite.ps1

    unblock-file -path C:\Suite811ServerInstall\IIS.ps1

Run Suite Autoinstaller

To use the Suite Autoinstaller:

1. Go to Windows Start, type cmd and press Enter.

2. Right-click Command Prompt and select Run as administrator.

3. On Do you want to allow this app to make changes to your device, click Yes.

4. Enter:

    cd C: \Suite<version>ServerInstall  

for example,

  cd C: \Suite811ServerInstall

5. Enter InstallSuite.bat.

6. The installation creates the following folders:

   CustomFiles
   OPENJDK (or JDK if you set property.openjdk = false)
   suite811-instance1-[ServerName]
   suite811-instance 2-[ServerName]
   suite811-instance 3-[ServerName]
   suite811-instance 4-[ServerName]
   tomcat
   Wars

7. Ensure the following ports are open and listening: 8005, 8090, 8091, 8092, 8093, 8094, 8443, 8020, 8021, 8022, 8023, 8024. On cmd, enter netstat -an to list the ports open and listening.

Update the Tomcat/conf/server.xml File

Perform this procedure if you downloaded the latest version of Tomcat instead of using the Tomcat version bundled in the Suite Autoinstaller. Add the following connectors to the Tomcat/conf/server.xml file:

<!-- Define a non-SSL/TLS HTTP/1.1 Connector on port 8080-->
    <Connector port="8090" protocol="HTTP/1.1"
        connectionTimeout="20000"
        redirectPort="8443" />
    <!-- A "Connector" using the shared thread pool-->

    <!-- Define an AJP 1.3 Connector on port 8009 -->
    <Connector port="8020" protocol="AJP/1.3" redirectPort="8443" />

Start the Tomcat Instances from Windows Services.

1. Go to Start > Programs > Administrative Tools > Services.

2. Look for the services whose names start with the following pattern: Apache Tomcatsuite-instance, for example, Apache Tomcat9.0suite811-instance1-WIN-SKD5UA2FHFE.

3. Right-click on the service and click Start.

Test Suite Installation

Ensure that Suite and BOXIR can be accessed.

1. Browse Suite. From the Suite server, open a browser and enter http://localhost/suite811.

Note: The context in the URL could be different depending on the value set in property.deployment.name in the InstallSuite.properties file.

2. Browse BOXIR by entering  http://localhost/boxir4. A blank webpage with boxir4 written in plain text appears.

Update the isapi_redirect.properties File

Update the isapi_redirect.properties file.

1. Run Notepad as an admin and open C:\inetpub\suite811\isapi_redirect.properties.
   Note: The context in the URL could be different depending on the value set in property.deployment.name in the InstallSuite.properties file.

2. Delete:

  log_level=debug

and replace with:

  log_level=info

3. Save the file.

4. Restart IIS. Go to Start > Settings > Control Panel > Administrative Tools.

5. Open Services and right-click on the IIS Admin Service.

6. Select Restart.

Uninstall Suite

This procedure creates a backup of the configuration files and uninstalls Suite and BOXIR by deleting the Suite installation manually.