1.1

• Extract the TISInstaller zip to C:\Install. 

• For each TIS version, please preserve at least the extracted TISInstaller folder of the latest release for other purposes like uninstalling TIS or installing certificates, etc.

• Run Powershell as Administrator and set the execution policy to RemoteSigned

1.2

• Optionally unblock files from the Internet. On some servers files might be blocked by the operating system and must be unblock explicitly. See also Microsoft's documentation

1.3

• Execute TISInstaller.exe as Administrator

2.1

• On a new Windows Machine prerequisites have to be installed using the Deployment/Prepare command
  • Select all items in dialog
    • select sqlcmd only for MSSQL

2.2

Prepare.ps1 might exit with error:

Please check whether you have access to the internet. If it is not the case, you will need to install .NET Framework 3.5 offline using your Windows installation DVD.

2.4

• Reboot if requested
• Note that on a totally fresh machine (TIS has never been installed using TISInstaller), it could happen that the computer is automatically rebooted after preparation without any notice. This is however not harmful to TIS installation and the computer.

3.1

• Select Make config in Deployment menu

3.2

• Create a new tisconfig and select tis as template machine
• Choose whether you want to overwrite the template or create an individual folder in tisconfig (or elsewhere, ajdust the path). In the latter case, name the folder of your deployment configuration (usually your hostname).

3.3

• Switch to the "Basic info" tab.
• Enter your host name and site name
• Enter your license information
• In case of a cluster deployment, tick the "Enable cluster deployment" option

3.4

• Provide Redis config

3.5

• Should Selenium testing be enabled, switch to "Selenium testing" tab and fill in the form

3.6

In case of a cluster deployment (if "Enable cluster deployment" was chosen in step 3.3)

3.6.1

• Switch to "Common cluster config" tab and fill in the form

3.6.2

• Switch to "Servers" tab and add a new host by clicking on "Add" button. Fill in the host name, IP address and instance count in the table on the right. Adjust First APPID and port. 

3.6.3

• It is possible to specify additional attributes for TIService, TISBoard and EMail in their respective tabs. For more information see TIService Settings.

3.6.4

• Should Redis cluster be enabled, tick the option "Enable Redis cluster" in tab "Redis"
• Switch to tab "Redis cluster" and define master nodes and replicas. Note that the number of master nodes must be odd and start from 3.

4.1.1

• Choose "DB Management"/Create database/MSSQL
• Enter admin credentials

4.1.2

• Enter server and database names
• Enter a password for the database user
• By Data directory and Collation if the Server name is already filled in, clicking on the browse icon will set the default values taken over from the server
• Select the target folder of the the generated file ximesdalconfig.xml(.s) to $TISCONFIG\deploymentconfigs\MyDeploymentConfig
•  if Administrator and Password are left empty, the Windows domain user will be used for the DB login

4.1.3

• Enter client info, or
• Choose one of the provided templates
  • For plano customers, choose "01/TISAdmin"
  • For SPX customers, choose "default/SUPERUSER"

4.2.1

• Choose "DB Management"/Create database/Oracle
• Enter admin credentials

4.2.2

• Enter data source: one can provide either the server information, or a full Oracle connection string

4.2.3

• Provide database info
• Select the target folder of the the generated file ximesdalconfig.xml(.s) to $TISCONFIG\deploymentconfigs\MyDeploymentConfig

4.2.4

• Enter client info, or choose one of the provided templates
• Choose one of the provided templates
  • For plano customers, choose "01/TISAdmin"
  • For SPX customers, choose "default/SUPERUSER"

4.3.1

• Choose "DB Management"/Create database/PGSQL
• Provide the service name, which is stored in %APPDATA%\postgresql\.pg_service.conf
• Provide DB name, DB user password, and the location to  generate ximesdalconfig.xml

5.1.1

• Choose "DB Management"/Update/MSSQL
• Enter the required information. Please note the warning.

5.2.1

• Choose "DB Management"/Update/Oracle
• Enter datasource: one can provide either the server information, or a full Oracle connection string

5.2.2

• Enter the database username and password

5.2.3

• Update ximesdalconfig.xml of the existing database (Oracle only): if the source TIS version is older than 6.6 and the DBMS is Oracle, the file ximesdalconfig.xml needs to be updated to a new format by choosing "DB Management"/XimesDalConfig/Update/"Oracle Ximes DAL config"

6.1

• Choose  "Certificates"/"Generate csr"
• Enter the customer and site IDs
• Choose the location of the csr file

6.2

• Log on to account.ximes.com
• Choose "Certificate Provider"/"Upload csr"

6.3

• Upload the csr file

6.4

• Download the generated certificate

6.5

• Copy the dowloaded zip file to C:\ProgramData\XIMES\TIS\mycomputer.mycompany.com\1, where mycomputer.mycompany.com is the host name and 1 is the site name of the TIS installation (see step 3.3). If you put different values for host name and site name in step 3.3, please adapt the folder path here accordingly.

7.1

• Choose "Deploy TIS" from the menu

7.2

• Choose the tisconfig folder (see step 3.2)
• Choose SPX license file
• Note that if step 6 was executed, one can choose the certificate to import

7.3

• Enter the log level
• Choose "Pause at the end of certificate operations" if you would like to see the output of each step regarding installing the certificates, namely generating a certificate signing request (csr), uploading the csr file to our server, and importing the received certificate files.
• Choose "Do not deploy additional python packages" if you wish to install python packages separately. 

7.4

• Choose actions to be executed
  • Create Users and Groups: only relevant if TIS is NOT deployed as LocalSystem. In this case, specific users for running TISBoard and TISEditor will be created
  • Install TISComponents: enable to choose components to be installed on the right group box
  • Copy Licenses and Certificates 
  • Create application configurations: create TIServiceWindowService.exe.config
  • Create database configurations: create ximesdalconfig.xml
  • Create self-signed certificate: optionally required for SSL
  • Set Folder Rights 
  • Install Certificates
  • (Re-)start TIS
• Choose component(s) to be installed:
  • TISEditor/TISBoard
  • Python
  • PyPy (optional)
  • Redis
• Start the deployment by clicking OK