FE - Frontend

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.

      

      An Example the Luware-TM-FE Configuration Settings screen. Your settings may vary!

   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 Configurator	How to get the value
      Instance Name	Enter 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 Number	Enter 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 Number	Enter 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 Protocol	Choose the security protocol between http and https The setting is stored in  IIS.
      System Administrator Group	Enter 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 Domain	If the ‘User Domain’ field is empty: If user enters his login on FE without domain, → the system uses the domain, where FE is installed. 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: If user enters his login on FE without domain, → the system uses the domain from the ‘User Domain’ field. 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 Authentication	By default is set to ‘false’ (disabled). When enabled the password Password input and Login button are not shown and the user needs to sign in with an O365 account. Disabled Enabled
      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  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.  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  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
      Allow Team Choice for Admins (systemwide)	This setting applies when you define your own TeamManager admins (without using  using Role Based Access instead by applying the the "AdministratorTeam" or "AdministratorSystem" role) Allows team admins to toggle the "Active" (Team Choice) state for their members, even when the Team Choice Feature is disabled for members. Within Appsettings Config:: "AllowTeamChoiceForAdminsSystemwide" Within Setup: "Allow Team Choice for Admins (systemwide)" Default: false

      When using Reporting Portal Option

      For using the Reporting Portal both ReportingMdxConnectionString and ReportingSqlConnectionString must be configured.
       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.
   
9. 

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 FE. The 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
  
  

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:

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.