The FE Setup installs TM FrontEnd to the IIS and FE Core to the Services. The Frontend is the main UI for daily interaction with TM. 

Installation

Execute the following installation steps:

  1. Run the TM.Frontend.Setup.msi setup
  2. On the opened ‘Welcome’ screen: Click ‘Next’. 

    The TM – Frontend setup wizard
  3. On the opened ‘Destination Folder’ screen:

    1. Enter the input path, where TM Frontend should be installed.
    2. Click Next.

  4. On the opened ‘Configuration settings’ screen:
    1. Enter the settings according to your setup. Example is in the table below.

      Example of filled Luware-TM-FE Configuration Settings screen
    2. Click Next.

      All the settings are automatically saved in registry (path:  HKEY_LOCAL_MACHINE\SOFTWARE\Luware AG\TM-FE) and in front end app settings file (default path: C:\Program Files\Luware AG\TM-FE\AppSettings.config). For each new front end version installation, the settings are prepopulated with previously existed values.


      The TM front end installation wizard settings are explained in the table below:

      Key in TM ConfiguratorHow to get the value
      Instance NameEnter the server instance name


      The setting is stored in  C:\Program Files\Luware AG\TM-FE\AppSettings.config as

      <add key=‘InstanzName’ value=‘BROWN’/>

      Port NumberEnter the server port number


      The setting is stored in  C:\Program Files\Luware AG\TM-FE\AppSettings.config as

      <add key=‘PortNumberToAdd’ value=‘4000’/>

      Site Port NumberEnter the site port number. The port number 80 is recommended for http and 443 for https. The used site port number should be not used by other sites


      The setting is stored in  IIS.

      Security ProtocolChoose the security protocol between http and https


      The setting is stored in  IIS.

      System Administrator GroupEnter the Distinguished name value of the System Administrator Group from Active Directory


      In the following format without spaces:

      CN=GroupName,OU=OrganizationalUnitName,OU=OrganizationalUnitName,

      DC=DomainComponent,DC=DomainComponent


      The setting is stored in  C:\Program Files\Luware AG\TM-FE\AppSettings.config as

      <add key=‘SystemAdministratorGroup’ value=‘CN=TM2,OU=TM2,OU=Development,DC=dev,DC=local’/>

      ReadOnly  Administrator Group

      Enter the Distinguished name value of the ReadOnly Administrator Group from Active Directory

      In the following format without spaces:

      CN=GroupName,OU=OrganizationalUnitName,OU=OrganizationalUnitName,

      DC=DomainComponent,DC=DomainComponent


      The setting is stored in C:\Program Files\Luware AG\TM-FE\AppSettings.config as

      <add key="ReadOnlyAdministratorGroup" value="CN=TM2,OU=TM2,OU=Development,DC=dev,DC=local"/>

      User DomainIf the ‘User Domain’ field is empty:


      1. If user enters his login on FE without domain,
        → the system uses the domain, where FE is installed.

      2. If user enters his login on FE with some domain,
        → the system uses the entered by the user domain.


      If the ‘User Domain’ field is filled:

      1. If user enters his login on FE without domain,
        → the system uses the domain from the ‘User Domain’ field.
      2. If user enters his login on FE with some domain,
        → the system uses the entered by the user domain.


      The setting is stored in  C:\Program Files\Luware AG\TM-FE\AppSettings.config as

      <add key=‘UserDomain’ value=‘dev.local’/>

      Default Sip Domain

      It is possible to enter the Service FWD Target on TM Front End -> Activated Teams -> Forward Settings.

      If the Default Sip Domain is empty, it is possible to use only sip address as the Service FWD Target and impossible to use the phone number, because it will not work.

      If the Default Sip Domain is filled, it is possible to use the sip address and the phone number as the Service FWD Target. If the Default Sip Domain was filled in the setup during the installation or directly in the FE AppSettings.config file, the user should enter on the FE the tel number in format tel:+xxxxxxxxxxx and the TM will add the configured Default Sip Domain to this number. Exactly this action makes it possible to set the phone number as the Service FWD Target.

      Usually the Default Sip Domain value corresponds to Lync sip domain.

      Disable Windows AuthenticationIf the check box is ‘true’,  windows credentials are not applied automatically and user will be redirected to Login page.


      By default is set to ‘false’.

      Configure Certificate Security

      If the check box is ‘true’  the certificate settings has to be defined during the installation:

      – server settings specify which settings other services will use while connecting to FE and FE Core

      – client settings specify which settings FE and FE Core will use while connecting to PS

      (info) Note: The system reports all errors related to  connection or certificate issues to a log file ‘C:\Program Files\Luware AG\TM-ICH\log\connectionIssues.log’.

      Install GAL-Search Service

      The GAL-Search Service allows a TM front end team member to perform a search of contacts in the GAL (Global Address List). He can insert these contacts as FWD/SimRing-Targets. To start the search user should enter at least 3 characters. The search can be by First Name, Last Name, Display Name, Company, Department, Job Title or City.

      The Reader Service automatically runs in 'Windows Services' and the GAL-Service executable is installed in the TM-FE folder.

      Good to know

      By default the GAL is configured as follows:

      • GAL-Search Service is checked in TM-FE Installation Setup.
      • "GalMinifiedLayout" flag is set to 'False' in AppSettings.config file.
      • All the flags for GAL-Search options are set to 'True' in AppSettings.config file.

      (lightbulb) The service writes cache-file and updates once day (during night). Values that are stored in in Cache (in Memory/Local) are:
      FirstName, LastName, DisplayName, Company, Department, JobTitle, City, Sip, Phone, PhoneOther, PhoneHome, PhoneHomeOther, PhonePager, PhonePagerOther, PhoneMobile, PhoneMobileOther, PhoneFax, PhoneFaxOther, PhoneIP, PhoneIPOther

      Default value: true

      (info) GAL offers further customization. See the "Configuration" chapter below.

      Enabled Reporting

      Set to ‘true’ to make the ‘Reporting’ page available on front end

      Set to ‘false’ to make the ‘Reporting’ page unavailable on front end


      Default value: true
      Disabled Team Member Login

      Set to ‘true’, to make a Team Member with activated team choice able to log in on FE.

      Set to ‘false’, to make a Team Member with activated team choice unable to log in on FE. With ‘false‘ value a Team Member will see the ‘Not authorized Message‘ when trying to log in.


      Default value: false
      Enabled Workflow Resources

      Set to ‘true’, to make the ‘Workflow Resources’ page available on front end

      Set to ‘false’, to make the ‘Workflow Resources’ page unavailable on front end


      Default value: true

      When using Reporting Portal Option

      For using the Reporting Portal both ReportingMdxConnectionString and ReportingSqlConnectionString must be configured.
      (warning) If one of the strings is not configured, it may result in several issues, e.g. Service Overview page works using the ReportingMdxConnectionString, but the information, when the last integration job has run is only available, if ReportingSqlConnectionString is configured.


  5. On the opened ‘Ready to install’ screen, 
    Click Install.

  6. If User Account Control pop-up appears, click "Yes".
  7. Wait until the installation is finished.
  8. Click Finish.


Access Configuration

Grant FE Access to Administrators

When installing the Frontend for the first time you should check and / or grant Administrator Group Permissions on Application Machines. This allows Administrators to use their AD credentials to login to the TM Frondend and avoids accidental lock-out using Role Based Access.

GAL (Global Address List) Search Parameters

Team members can perform a search of contacts in the GAL (Global Address List) when the feature has been installed together with FEThe search for GAL-Contacts is available from TM-Frontend wherever teams, forward targets, users or other contact objects may be entered.

Customize output design

Service FWD Target and TM Forward SIP URI fields have help buttons. When clicked on a hint with URIs examples will appear:

  • The results (in the dropdown) have the second'design' which looks similar to the design of Outlook: <Lastname> <Givenname><Department><City>.
  • There is a setting (in AppSettings.config file) that allows the administrator to switch between the design for the search results already existing and the new one: GalMinifiedLayout: True/False


GAL-Search result in MinifiedLayout view

Customize output fields

It is configurable which telephone/sipaddress-fields are used/displayed on the UI (during rendering).There are flags (true/false) for each option in AppSettings.config file:

Configurable fields of GAL-Search

Post-Installation Frontend Check

After FE is installed and configured, you might want to check how the User Interface operates.

You can check the operation by opening Internet Information Services on your Server machine and see if the TM-FE Website is up and running.