<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" URIEncoding="UTF-8"/>
- About Us
When TEAMS-RDS is installed, whether by itself or through TEAMS-IDE Server, TEAMS-RDS’ Tomcat server is configured to listen on port 80. If and when IIS is installed and enabled, Tomcat won’t be able to listen on port 80, thus you will not have access to the TEAMS-RDS server. This document will cover how to change the Tomcat server port so that it does not conflict with IIS. Giving you access to TEAMS-RDS.
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" URIEncoding="UTF-8"/>
Service agents often do not have access to the internet and this may prevent TEAMATE from uploading session logs to TEAMS-RDS server at the end of a troubleshooting session. To work around this problem, TEAMATE can be configured to automatically email sessions logs at the end of a troubleshooting session using the user’s Microsoft Outlook email application. The logs are then queued as emails in the Outbox and email to TEAMS-RDS when Outlook has connection to the email server.
NOTE 1: Service Agents must have Microsoft outlook installed and configured for outgoing email for this solution to work.
NOTE 2: System Administrator will need to setup and configure an email account accessible via IMAP. TEAMS-RDS will monitor this email address for emails with a specific subject line. Outgoing email for TEAMATE needs to be configured for this email address and subject line.
In the TEAMS-RDS server, edit %RDS_HOME%\conf\mail.Properties to set the email protocols (IMAP, POP, IMAPS, POPS), subject line, authentication information and 15 minute polling interval. See the changes highlighted in green text below:
<!--To enable session logs emailed by TEAMATE user (using Outlook) to be consolidated into TEAMS-RDS, set "service.teamate.mail.logs.enable" to true --> <entry key="service.teamate.mail.logs.enable">true</entry> <!-- Email address being monitored by TEAMS-RDS for TEAMATE session logs --> <entry key="service.teamate.outlook.email.to"><![CDATA[email@example.com]]></entry> <!-- Subject line for TEAMATE session logs email --> <entry key="service.teamate.mail.subject">TEAMATE session log</entry> <entry key="service.teamate.mail.body">TEAMATE session log file attached</entry> <!-- Session log attachment has to have this file extension for the log to be consolidated. Delete this line to allow any file extension--> <entry key="service.teamate.mail.file_extension">zip</entry> <!-- How often to check for email --> <entry key="service.teamate.mail.cronexpression">0 0/15 * * * ?</entry>
For production customers, QSI may configure custom installers pre-configured with email address and subject line for email synchronization. To manually configure TEAMATE for email synchronization edit the “%RDS_HOME%\conf\rdsProperties.xml” and make the changes highlighted in green text below:
<!--To enable session logs emailed by TEAMATE user (using Outlook) to be consolidated into TEAMS-RDS, set "service.teamate.mail.logs.enable" to true--> <entry key="service.teamate.mail.logs.enable">true</entry> <!-- Email address being monitored by TEAMS-RDS for TEAMATE session logs --> <entry key="service.teamate.outlook.email.to"><![CDATA[firstname.lastname@example.org]]></entry> <entry key="service.teamate.mail.subject">TEAMATE session log</entry> <entry key="teamate.outlook.email.on_end_session">true</entry> <!-- email session log when suspending a session --> <entry key="teamate.outlook.email.on_suspend_session">true</entry>
Different Development and Production versions of TEAMS-RDS allow different number of concurrent sessions. Each Guided Troubleshooting or Telediagnosis connection counts as one session. The restrictions are enforced by the licensing module based on the product key as the software for all configurations of TEAMS-RDS are otherwise identical.
Please note that TEAMATE, being a portable guided troubleshooting solution meant to be deployed on laptops is for non-networked sessions and should not be used as server.
TEAMS-RDS uses the Database for persistent storage of information such as models, session logs, and user information.
The file system is used to accelerate the performance (e.g., models are retrieved from database and saved in %RDS_BASE%\models for access by the reasoner and search indices are compiled and saved in %RDS_BASE%\search). The contents of these directories can be recreated from the database on startup, and are refreshed whenever the information in the database changes. However, no changes in these directories are ever pushed back to the database.
We recommend the following settings for JVM when used with Apache Tomcat
-Drds.home=%RDS_HOME% -Drds.base=%RDS_BASE% -Djava.library.path=%RDS_HOME%\bin -Djna.library.path=%RDS_HOME%\bin
We recommend a three prong backup strategy:
Instead of using its own database to authenticate users, TEAMS-RDS can be configured to connect to a corporate active directory server to authenticate and authorize users.
NOTE – Active Directory support is available only on TEAMS-RDS version 12.x and later.
There are two ways of configuring TEAMS-RDS to support active directory authentication, depending on the version of TEAMS-RDS, or where TEAMS-RDS is installed:
The user roles are obtained from the active directory “memberOf” attribute. These roles are unlikely to match the user roles expected by TEAMS-RDS. To map the Active Directory user roles to TEAMS-RDS roles, edit. The general format is:
For example, assume that we want to grant users who are members of “Technical Support Staff” and “Field Engineer” the TEAMS-RDS role of “Field Technician”:
Now, when a user who is a member of “Technical Support Staff” or “Field Engineer” logs into TEAMS-RDS, he will have the privileges of a Field Technician.
All the available TEAMS-RDS roles are specified in; edit the file to map TEAMS-RDS roles to the active directory attribute(s) for users.
NOTE – The following feature is not available on TEAMATE version prior to 14.0.
TEAMATE is already configured to use Windows authentication AND to automatically log the user in. The configuration specified inas described above is not applicable for TEAMATE.
Since TEAMATE mainly operates in offline mode, it will use the user information that is cached by Windows.
When connecting to TEAMS-RDS for model/log synchronization via HTTP, the user will need to enter his Windows credential to log in to TEAMS-RDS to synchronize, even if TEAMS-RDS has been configured for “single sign-on”.
NOTE – If TEAMATE displays the Windows Security logon prompt, instead of automatically logging in the user, then the site http://127.0.0.1 needs to be added to the “Local intranet” site:
1. Open Programs and Features under Control Panel.
2. Select the appropriate version of Microsoft SQL Server from the list of programs and select Uninstall/Change.
3. Select Remove when prompted for an action.
4. Click on OK in the Setup Support Rules step to continue.
5. Click on OK in the Select Instance step to continue.
6. Click on Select All and press Next.
7. Click on OK in the Removal Rules step to continue.
8. Click on Remove to begin the un-installation process.
9. Click on Close to continue.
10. The un-installation process will remove several components from your computer. The Microsoft SQL Server 20xx R2 Native Client will remove on your computer, it does not need to be un-installed.
11. Delete the data files left by Microsoft SQL Server 20xx. For example, for SQL Server 2008 Express delete the following directory “C:\Program Files (x86)\Microsoft SQL Server\MSSQL10_50.SQLEXPRESS\MSSQL\Data”. The “MSSQLXX_XX” changes depending on the version of SQL Server installed.
Congratulations you have successfully un-installed Microsoft SQL Server.
For further assistance please contact our support team at: email@example.com
By default TEAMS-RDS is not configured to send jobs or receive job logs via email. In order to enable this feature, TEAM-RDS need to be configured to use a dedicated email account. The email account may be on either an in-house email server, such as Microsoft Exchange, or on a web email service, such as Google’s Gmail. (using pop/imap or SSL pops/imaps).
There are two steps to setup TEAMS-RDS for emails:
%RDS_HOME% refers to the RDS installation directory:
To retrieve session logs via email server, TEAMS-RDS polls the email server periodically for any incoming logs via the specified protocol. Open the file in a text editor, and edit the protocol as shown in Figure 1 below, at the top of the mail.properties file. Uncomment one of the blocks (i.e., remove the character ‘#’ from the beginning of the lines) to specify the email protocol supported by the email server so that TEAMS-RDS server can retrieve emails containing session logs. Note: If more than one block is uncommented then the last block will take effect.
The default ports for POP and IMAP protocols are 995 and 993 respectively. They can vary in your organization. So please contact your IT department.
Enter the SMTP (Send Mail Message Protocol) to send jobs to field engineers using TEAMS-PackNGo and/or TEAMATE applications on their smart phones or laptops respectively. See Figure 2.
Open the rdsProperties.xml file in a text editor (may require administrative privilege), and enter the email account to be used to send job notifications to field users, and receive the session logs from the TEAMS-PackNGo and TEAMATE users as shown in Figure 3, and Figure 4 below respectively.
For PackNGo settings, search for the text ‘service.packngo.resultsemail.to’ in the rdsproperties.xml, and edit as shown in Figure 3. Users can edit the email address to use for sending the job, and the subject lines expected from PackNGo app (so that TEAMS-RDS can poll the email account and look for only those emails with that subject). The subject line should be customized for each TEAMS-RDS server in the organization so that each server can look for the email meant for that server. Users can also specify how often the email account need to be polled for session logs using the cron expression, and also specify at what milestones of the troubleshooting job, the PackNGo needs to send the session logs (for example at the job start, at job close, when job is suspended and when the job is resumed etc.,).
Similarly, to be able to send job emails to TEAMATE and receive session logs from field TEAMATEs search for the text ‘service.teamate.outlook.email.to´ in the rdsproperties.xml and edit as shown in Figure 4. Users can edit the email address, and the subject lines expected from TEAMATEs so that TEAMS-RDS can poll the email account and look for only those emails with that subject. Users can also specify how often the email account need to be polled for session logs using the cron expression, and at what milestones of the job the TEAMATE needs to send the session logs (for example at the job start, at job close, when job is suspended and when the job is resumed etc.,).
This concludes setting up the TEAMS-RDS server.
In you require further assistance, contact our support team at firstname.lastname@example.org.