This document describes the cluster deployment, which is available starting from v 6.4 and fully integrated in TISInstaller. Main configuration must be done in sites.xml

Limitations

Prerequisites

  • Installation files are provided as a zip on request
  • Have your License-Info file ready
  • See also System requirements

System architecture



Configuration

No

Description

Screenshot

1a

Make config for a node

use node's hostname

1

adapt tisconfig\machines\<yourhostname>\hosts\settings.xml
  • MachineConfig\Name the name of the load balancer should be provided
  • MachineConfig\IISSettings\HostName detto


2/a

  • create tisconfig\machines\<yourhostname>\hosts\<sitename>\sites.xml 
    there are two sections that need to be created
    • Sites\PrimarySite
      <Name>TIS</Name> - Site name
      <RedisAPPID>4061</RedisAPPID> - Redis application ID
      <Config>
              <PublicSiteUrl>https://yoursitename/TIS</PublicSiteUrl> - Public Site URL
              <APPID>2060</APPID> - Application instance ID
              <Protocol>https</Protocol> - Http/Https protocol
              <Port>443</Port> - Http port
              <HostName>localhostname</HostName> - Host name for the instance
              <TISBoardBindingName>TISBoard0SecureBinding</TISBoardBindingName>
              <SecurityMode>Transport</SecurityMode>
              <WebAppTIServicePipeName>WebApp_TIService_TIS</WebAppTIServicePipeName>
      </Config>



2/b

  • the second section that needs to be created:
    Sites\ServerFarm
    <Name>TISFarm</Name> - TISFarm name in IIS
    <InstanceCount>8</InstanceCount> - Desired number of instances
    <FirstAPPID>2061</FirstAPPID> - The starting ID number for the first instance, incrementing by every instance
    <FirstPort>6031</FirstPort> - IIS access port
    <InstanceConfig>
          <PublicSiteUrl>https://yoursitename/TIS</PublicSiteUrl> - Public Site URL
          <Protocol>http</Protocol> - Http/Https protocol
          <HostName>localhostname</HostName> - Host name for the instance
          <TISBoardBindingName>TISBoard0Binding</TISBoardBindingName>
          <SecurityMode>None</SecurityMode>
          <WebAppTIServicePipeName>WebApp_TIService_TIS</WebAppTIServicePipeName>
    </InstanceConfig>


2/c

  • Redis-configuration 
    in the tisconfig folder redisconfig.xml must be set like the standalone version but the Bind must be 0.0.0.0 on the node which runs redis




  • on the other nodes Bind must be deleted and as host the IP should be the same as on the first node which runs redis



3

Windows Firewall on primary node running Redis

  • Set Inbound Rules by adding an exception for Redis access 
  • Protocol TCP

  • Local Port 6379


4

Add load balancer name to hosts file

  • 127.0.0.1 lb-addr




Preparation

The following steps should be executed on every machine

No

Description

Screenshot

1

  • Extract zip to C:\Install


2

  • Run Powershell as Administrator and execute  the following command
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

3

  • prepare
    • ARR


Installation

No

Description

Screenshot

1

  • deploy


2

  • Open services and start the redis service on the primary machine

3

  • start the Guard and the TIService Instances on all machines

4

  • Start application pool for TIS and TISBoard on all machines

Internals



URL Rewrite rules

Outer L7-Load Balancer

"sticky session"

e.g. SERVERID

Set Load Balancer weight to 1 instead of 100