Prerequisites

  • Installation files are provided as a zip on request and may be downloaded from the XIMES cloud.
  • Have your License-Info file ready.
  • If upgrading from any version older than TIS 6.2 a database update to this version as an intermediate step is necessary. Please use TIS6_2_0-33960 for this process.
  • See also System requirements

Useful tools to install

Installation Procedure

  • (warning) Please make sure that you have the specific PLANO build of TIS 

No

Description

Screenshot

1

  • Extract zip to C:\Install

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

Get-ChildItem . -Recurse | Unblock-File

2

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

3

  • Execute TISInstaller.exe as Administrator


4

  • 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


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.

5

  • Reboot if requested

6

  • select Make config in Deployment menu

7

  • create a new tisconfig and select template as template machine
  • enter your host name
    • this results in an individual folder in tisconfig\machines

7a

Change site name (optional)

  • default is TIS
  • rename folder tisconfig\machines\<yourhostname>\hosts\tis to your site name
  • adapt TISBoardSettings.js
    • TISBoard.MAINCONNECTURL = "/<sitename>/TISBoard/Dispatcher.svc';
    • TISBoard.SitePatch = '/<sitename>';
  • adapt EditorSettings.js
    • window.EditorSettings.site_path = "<sitename>";


8b

  • create a new database TISDB for MSSQL
  • enter database name
  • enter a password for the database user
  • enter default TISAdmin username
    • as a result specified user has CLIENTADMINISTRATOR role
    • has permission for User Management
  • by Data directory and Collation if the Server instance is already filled in, clicking on the browse icon will set the default values taken over from the server
  • (warning) do not change client ID "01" (must be synchronized with other config files)
  • (warning) if Administrator and Password left empty, the Windows domain user will be used for the DB login

8c

  • create a new database TISDB for Oracle
  • enter database name
  • enter a password for the database user
  • enter default TISAdmin username
    • user must be available in the specified identity server
    • as a result specified user has CLIENTADMINISTRATOR role
    • has permission for User Management
  • (warning) do not change client ID "01" (must be synchronized with other config files)

9

  • select target folder for ximesdalconfig.xml by selecting the your host name folder in machines folder and your site name in the hosts folder

10

Create/update a database and save ximesdalconfig.xml to your tisconfig\machine\template\hosts\tis folde




Adapt tisconfig

  • copy or rename folder tisconfig\machines\template to your hostname e.g. tisconfig\machines\myhost.com

adapt file tisconfig\machine\template\hosts\settings.xml

  • set MachineConfig\Name to your hostname (FQDN)
  • set MachineConfig\IISSettings\HostName to your hostname (FQDN)


11

adapt the tisconfig\machine\<yourhostname>\hosts\tis\settings.xml

  • optionally set SiteConfig\Name to another name for the base path in the resulting URL
  • use your License-Info file for following settings
    • set SiteConfig\Licensing\CustomerId
    • set SiteConfig\Licensing\CustomerGuid
    • set SiteConfig\Licensing\SiteId

12

  • Deploy TIS software select machine and site from the tisconfig folder
  • optionally select Create a self-signed certificate for SSL
  • (warning)In the case of offline deployment without an internet connection, untick Install Certificates and follow the instructions at step 13




13

Certificate installation for offline deployment(optional)

  • In C:\ProgramData\XIMES\TIS\!!!hostname\!!!sitename\ you will find the u_iis_tiss_tis.csr file for upload.

  • Upload CSR and download certificate (zip):
    • Select Certificate provider and click on Upload csr











       
      • Upload your certificate signing request file
















      • Download your certificate in ZIP format












      • Copy the downloaded Certificate into C:\ProgramData\XIMES\TIS\!!!hostname\!!!sitename\


      • Run deployment again but only tick Install Certificates and untick everything else
      • From the Certificate for Import dropdown list select your Certificate.



















14