...
Installation Guide for DevOps Services (cloud)
Login to your DevOps Services cloud organization
Install 7pace Timetracker for DevOps Services (cloud)
Ensure the 7pace Timetracker cloud menu displays
Uninstall the 7pace Timetracker cloud extension
Installation Guide for DevOps Server (on-prem)
Download 7pace Timetracker Server (on-prem)
Install 7pace Timetracker Server (on-prem)
7pace Timetracker Server (on-prem) Configuration Wizard
Making 7pace Timetracker (on-prem) Configuration Changes
Common Issues During the Installation and Configuration Process of 7pace Timetracker (on-prem)
Upgrading 7pace Timetracker for DevOps Server (on-prem) and Updating DevOps Server
Uninstall 7pace Timetracker for DevOps Server (on-prem)
...
Configuring Internal Tasks (Vacation, Sick Days, Meetings, etc.)
Configuring Internal Tasks as an Administrator
Tracking Time for Internal Tasks as a Team Member
Viewing Time for Internal Tasks as a Manager or Team Lead
| Anchor | ||||
|---|---|---|---|---|
|
Prerequisites for 7pace Timetracker (on-prem & cloud)
Administrator rights on the local system and on Azure DevOps
3 latest versions of Microsoft® Edge, Firefox, Chrome (please note that Internet Explorer is no longer supported - you will need to use an older version of 7pace Timetracker if using IE).
Starting with Timetracker 5.3, Timetracker for Azure DevOps (formerly TFS) requires .NET 4.8 and higher to be installed on a machine.
Both DevOps server and 7pace Timetracker should use HTTPS.
Starting with Timetracker 5.46.0, Timetracker for Azure DevOps (formerly TFS) requires ASP.NET Core Runtime Hosting Bundle 6.0.14 and higher to be installed on a machine.
Starting with Timetracker 5.53.0, Timetracker for Azure DevOps (formerly TFS) requires ASP.NET Core Runtime Hosting Bundle 8.0.1 and higher to be installed on a machine.
For Azure DevOps Server:
Compatible with Azure DevOps 2019, 2020 and 2022
Microsoft SQL Server 2016, 2017
For TFS (Team Foundation Server):
Microsoft Team Foundation Server 2018, 2017 (RTM, Update 1 and later), 2015 (Update 2.1 and later)
Microsoft SQL Server 2012, 2014, 2016, 2017
Timetracker Server System Requirements:
Minimum: dual-core processor, 4 GB of RAM, and a fast hard-disk drive
Recommended: quad-core processor, 8 GB of RAM, and a fast hard-disk drive / SSD
Microsoft Windows Server 2012 or later
7pace uses Sectigo DV Wildcard SSL Certificate for the *.timehub.7pace.com domains. This certificate is valid and accepted by the majority of systems and applications, and can be validated under this address: https://crt.sh/?id=3448288647.
7pace Timetracker supports only general Latin collations in the SQL Server database (for example: SQL_Latin1_General_CP1_CI_AS)
IIS webSocket protocol needs to be installed and enabled, as per requirements for DevOps server
Prerequisites required for installing 7pace Timetracker for Windows App on the Microsoft Windows system:
Microsoft® Windows® 10
Network connection to the server running Timetracker
7pace Timetracker does not officially support a load balancer, but in case your DevOps servers are running behind a load balancer, then we have prepared a configuration that might potentially work for you: Running DevOps with a load balancer Timetracker configuration.
...
*A valid DevOps Services organization is required.
7pace uses Sectigo DV Wildcard SSL Certificate for the *.timehub.7pace.com domains. This certificate is valid and accepted by the majority of systems and applications, and can be validated under this address: https://crt.sh/?id=3448288647.
| Anchor | ||||
|---|---|---|---|---|
|
...
The browser displays the organization page.
...
Click the drop-down list and select your DevOps Services organization, then follow the prompts to install.
...
Download 7pace Timetracker Server (on-prem)
1. Access the https://www.7pace.com/ website.
2. On the main menu bar, click Try -> For Azure DevOps Server (On-Premises, Self-Hosted)
...
The wizard allows you to configure Timetracker installed locally with DevOps Server or installed locally but integrated with the remote DevOps Server. You can re-start this tool any time you want, if you need to make changes, by running the TimetrackerOnline.ConfigTool application from the "Tools" folder in your 7pace Timetracker installation location.
IMPORTANT: SSL v2 and v3 protocols are enabled, as some customers still use 7pace Timetracker with legacy TFS. To To switch off/on any protocols 7pace Timetracker uses in the configuration tool manually during your installation of 7pace Timetracker, please see the links, below, for guidance:
https://disablessl3.com/iis.html
https://www.digicert.com/kb/ssl-support/iis-disabling-ssl-v3.htm
Note: Timetracker was not tested with and does not officially support hosting in a relative/virtual directory and can only be hosted in the root directory.
...
The system displays the "Database Settings (Microsoft SQL Server)" page.
...
Note: On the "Database Settings (Microsoft SQL Server)" page, the option to select the same Microsoft SQL Server as DevOps Server is disabled if you are configuring your 7pace Timetracker with remote DevOps Server. In that case, you will need to specify the SQL Server details. Also please note that only general Latin collations in the SQL Server database (for example: SQL_Latin1_General_CP1_CI_AS) are supported.
4. Check that the database server name and authentication details are correct and click the Next button.
The system displays the "Internet Information Server (IIS) Settings" page.
...
Note: 7pace Timetracker is using the same technology as DevOps Server and we put a security cookie into every request. This cookie can, in some cases, interfere with the DevOps Server cookie. Having Timetracker on the same domain as DevOps Server can cause cookies to be overridden. The solution is to change the address of Timetracker to something distinct/different from the DevOps Server address.
5. Check that the "Host Name" and "Network Host Port" are correct.
Note: The HTTPS Certificate drop-down list only appears if you are using secured http (that is, 'https'). The configuration tool only looks for certificates in the Web Hosting store. If the certificate is stored in a personal or alternative store, it will not be listed.
6. Click the HTTPS Certificate drop-down list and select the certificate that you want to use.
7. Click the Build-in-Account drop-down list, and select the application pool account or click the Custom Account and specify the custom account details.
8. Click the Next button.
The system displays the "Service Account" page.
...
Here, you can configure the "Service Account" (found within the "Settings" page of 7pace Timetracker -> "Service Account") to display data that is usually not visible to all users. You can either enter the details for a "Custom Service Account" (we recommend that you use a team member who belongs to the Project Collection "Administrators" user group, since this has the highest permission level), or use the same account that you configured as the Application Pool Account. Important: The Service Account is required in order for server side
...
tracking and Work Item Automation to work. You can read more about it here: What is the Service Account used for?
9. Enter a valid username, including the domain name, if necessary.
10. Enter a valid password for the specified username.
11. Click the Next button to continue.
The Email Settings page displays.
...
If you "Enable Email Alerts", the users will receive an email notification when tracking was stopped by the system due to no response from the user during activity checks. Under "Authentication", most mail servers require authorization in order to send emails. Please enter your credentials here.
12. Click Next.
The Installing Work Item Form Contributions page displays.
...
This window allows you to select the Project Collections to which you want the 7pace Timetracker tab and "Start Tracking" button on the work item form to be installed.
13. Click Next.
The tool starts applying the settings.
...
14. Click Next.
After a "Kudos! 7pace Timetracker is configured and ready to go" message, the wizard setup will be complete.
15. Click the Finish button to close the wizard.
| Anchor | ||||
|---|---|---|---|---|
|
Making Configuration Changes
Once you successfully complete the installation of 7pace Timetracker for DevOps Server, and configure it with the automatic configuration tool wizard that is bundled with the installer, the configuration tool is a part of your system. This tool allows you to configure Timetracker installed locally with DevOps Server or installed locally but integrated with the remote DevOps Server. Should you need to make any configuration changes in the future, it's easy to open the tool and make those changes at a later time.
The Service Account is required for server side tracking and Work Item Automation to work. Additionally, there is a new page to assist you in setting up email notifications in the Timetracker configuration wizard.
You can find the 7pace Timetracker Configuration tool in the Tools directory at the default location (C:\Program Files (x86)\7pace Timetracker\) of Timetracker.
7pace Timetracker Configuration Tool
...
Starting and Stopping 7pace Timetracker
With the 7pace Timetracker configuration tool, you can start and stop the 7pace Timetracker application.
1. From the Windows start menu, run the 7pace Timetracker Configuration tool.
2. In the 7pace Timetracker Status field, check the current status of 7pace Timetracker (if it is running or stopped).
...
3. In the 7pace Timetracker Status field, click the Start/Stop Application link.
...
The "Start/Stop Application Pool" window displays.
If 7pace Timetracker DevOps Server is running, click the Stop button to stop the 7pace Timetracker application.
If 7pace Timetracker DevOps Server is stopped, click the Start button to start the 7pace Timetracker DevOps Server application.
4. Click the Close button to close the window.
Changing IIS Settings
With the 7pace Timetracker DevOps Server configuration tool, you can "Change IIS Settings".
1. From the Windows start menu, run the 7pace Timetracker Configuration tool.
2. In the Application Pool Account field, check the current application pool configuration.
...
3. In the Application Pool Account field, click the Change IIS Settings link.
...
The system displays the IIS Settings window.
4. Specify the appropriate values for the Host Name and Network Host Port.
(Optional) Click the HTTP Certificate drop-down list and select appropriate certificate.
Note: The HTTPS Certificate drop-down list only appears if you are using secured http (that is, 'https'). The configuration tool looks for certificates only in the Web Hosting store. If the certificate is stored in a Personal or other store, it will not be listed.
5. In the Application Pool Account section, select the account that you want to use or specify the custom account settings.
6. Click the Save button.
Changing the DevOps Server URL
From the DevOps Server Timetracker configuration tool, you can change the DevOps Server URL.
1. From the Windows start menu, run the 7pace Timetracker (on-prem) Configuration tool.
...
2. In the
...
DevOps Server URL field, you can see the DevOps Server URL that is currently configured.
...
3. In the DevOps Server URL field, click the Change DevOps Server URL link:
...
4. In the DevOps Server URL field, enter a valid DevOps Server URL.
(Optional) Click the Show me where to find this information link to for additional information on where you can get the correct DevOps Server URL.
5. Click the Save button.
Changing SQL Settings
From the 7pace Timetracker configuration tool, you can change the SQL Server settings.
1. From the Windows start menu, run the 7pace Timetracker Configuration tool.
2. In the SQL Server field, you can see the SQL Server that is currently configured.
...
3. In the SQL Server field, click the Change SQL Settings link.
...
The Database Settings window displays.
4. Select the appropriate server name and the authentication required for that server.
5. Click the Save button.
Changing the Service Account
Important: Please note that the Service Account is required for server side tracking and Work Item Automation to work. You can read more about it here: What is the Service Account used for?
1. From the Windows start menu, run the 7pace Timetracker Configuration tool.
2. In the Service Account field, you can see the Service Account that is currently configured.
...
Note: A blank status indicates that Service Account has not been configured.
3. In the Service Account field, click the Change Service Account link.
-> The system displays the Service Account window.
7pace Timetracker Service Account Window
...
Note: Users don't have the option to not use the Service Account when configuring Timetracker, as it is required for server side tracking to work.
4. Click the appropriate option for the Service Account.
5. If selecting the "Custom Service Account" option, enter the required username and password for the selected Service Account.
6. Click the Save button.
Changing Email Settings
From the 7pace Timetracker configuration tool, you can change Email Settings.
1. From the Windows start menu, run the 7pace Timetracker Configuration tool.
2. In the Email Settings field, you can see the email account that is currently configured.
...
3. In the Email Settings field, click the Change Email Settings link.
...
The Email Settings window displays.
4. You can choose to enable or disable email alerts. If enabled, users will receive an email notification when tracking was stopped by the system due to no response from the user during time tracking activity checks. Under "Authentication", most mail servers require authorization in order to send emails. Please enter your credentials here.
5. Click the Save button.
Update Availability
From the 7pace Timetracker configuration tool, you can update the "7pace Timetracker" tab and "Start Tracking" button (added to the work item form) settings.
...
Clicking the "Update availability" link allows you to reinstall the WiT "7pace Timetracker" tab and "Start Tracking" button (added to the work item form) to existing collections. If you create a new collection, you can navigate to the configuration tool and manually apply the "7pace Timetracker" tab and "Start Tracking" button here.
| Anchor | ||||
|---|---|---|---|---|
|
Activating 7pace Timetracker for DevOps Server (Online & Offline) and Activating Proxy Server Settings
Activating 7pace Timetracker
Note: Before purchasing a license for 7pace Timetracker for DevOps Server, install the trial version by downloading the application from www.7pace.com.
...
With the trial, you can use all 7pace Timetracker features for 28 days, without any limitations.
To determine the best 7pace Timetracker subscription for you and your team, please view our different per-user pricing plans at https://www.7pace.com/pricing. The purchasing experience is within the installed software. After starting a trial or installing Timetracker, head for the 'Organization Settings' of your Azure DevOps organization, and look for '7pace Timetracker'. Here, you can manage your subscription. For more information on purchasing before or after your trial expires, see How to Buy 7pace Timetracker After Your Trial Ends.
You will find your subscription ID on any invoice or email from the commerce system. 7pace Timetracker can then be activated via two different methods - online or offline.
Applying your license online
Online activation requires an internet connection to run 7pace Timetracker server. Support for a proxy server is available. For more information, see below.
We recommend online activation of your license because of the following benefits:
Upon renewal, activation continues without interruption of service
You only need to apply your subscription ID once
Changes to your subscription appear immediately in all your server systems
1. On the "Settings" page, selection "Subscription" or follow the direct path Organization Settings -> Extensions -> 7pace Timetracker -> Subscription.
...
2. On the "Subscription" page, you can click "Buy Now" if your trial has expired or under "Do you have an existing subscription?" copy and paste your subscription ID into the "Subscription ID" field and click the "Apply" button.
The page refreshes, displaying subscription info.
...
Applying your license offline
If your server cannot connect to the Internet, please contact us at support@7pace.com and provide us with your subscription ID. We will issue a file for offline activation for you.
1. On the 7pace Timetracker menu bar, click Settings - > Subscription or follow the direct path Organization Settings -> Extensions -> 7pace Timetracker -> Subscription.
2. Click the Enforce offline validation mode hyperlink.
...
The file dialog box opens.
4. Click the Continue to enforce Offline Activation link to select the license file.
5. Apply the license.
Enabling proxy server settings
When you use an online subscription ID to activate your 7pace Timetracker for DevOps Server license, Timetracker keeps connecting to the license server to check whether the subscribed license is active or not. However, if your DevOps server is behind a proxy server, Timetracker won't be able to connect to the license server and will display a message that your license is inactive.
Important: Currently, 7pace Timetracker only supports the http(s) proxy settings.
1. On the "Settings" page of the 7pace Timetracker menu, click on "Subscription" and follow the hyperlink or access directly from path Organization Settings -> Extensions -> 7pace Timetracker -> Subscription.
...
2. Click the Proxy settings link.
The Proxy Settings for the License dialog box opens.
...
2. Click the Enable proxy check box.
...
3. In the Server address and port field, specify the correct proxy server address with the port number.
(Optional) Click the Use PROXY authentication checkbox if your proxy server requires authentication.
4. In the Username and Password fields, type in your credentials.
5. Click the Apply button.
You might get an error message if the specified proxy server address is incorrect or the specified proxy server is not reachable.
| Anchor | ||||
|---|---|---|---|---|
|
Upgrading 7pace Timetracker for DevOps Server (on-prem) & Updating DevOps Server
7pace Timetracker 3 and later | Important
You can update DevOps Server while still keeping Timetracker 3 and above installed. Prior to Timetracker 3, you had to uninstall Timetracker first, before you were able to update DevOps Server. With Timetracker 3 and higher, you no longer have to uninstall Timetracker before beginning your DevOps Server update.
Timetracker 2.x | Important
For 2.x versions of Timetracker, you can update DevOps Server while keeping Timetracker 2.x installed if you are not crossing releases/updates of DevOps Server with architecture changes. Otherwise, you will have to uninstall Timetracker before upgrading your version of DevOps Server. For additional information and instruction on how to do this, please read this article in the "FAQ" section of our Knowledge Base.
Upgrading Timetracker
Upgrading 7pace Timetracker for DevOps Server to the latest available version does not require you to backup your data or save any custom settings from your current version; existing data and settings are retained in the database. In addition, there is not a fixed upgrade path that you need to follow; you can upgrade from any previous version of the application to the very latest version available on the 7pace Timetracker website. (Please note that there is no way to roll back from Timetracker to previous versions once the update has been done.) Although you can directly download 7pace Timetracker to your production environment, we recommend that you first do so to your test environment to identify any issues specific to your environment. You also need to ensure that your current version of DevOps Server supports the latest version of Timetracker.
Before You Start
Read and/or subscribe to the 7pace Blog for the most up-to-date list of features, fixes, and improvements in the version to which you want to upgrade.
Update DevOps Server
1. Ensure that DevOps Server is updated to the latest supported update. On your DevOps Server, open the Administration Console and check the current DevOps Server version in Application Tier Summary.
...
2. Access the Microsoft Visual Studio website (https://www.visualstudio.com/) and download the required update for your DevOps Server version (refer to the Microsoft MSDN website for information on the latest DevOps Server update).
3. After completing the update, check that you can successfully access DevOps Server. If it is running properly after the update, you are now ready to upgrade your version of 7pace Timetracker.
Install the Latest Version of 7pace Timetracker
1. Go to the 7paceTimetracker website (https://www.7pace.com/download).
2. On the Download page, check the supported system requirements.
3. Download the latest 7pace Timetracker version that will support the updated version of your Azure DevOps.
4. Install 7pace Timetracker, as per the installation guide, above.
5. After the installation has successfully completed, check the "About" or "Overview" page of Timetracker within the "Settings" page.
Go to Time > Settings > About.
Check that the version number has changed to the upgraded version.
| Anchor | ||||
|---|---|---|---|---|
|
Uninstalling 7pace Timetracker
Note: Uninstalling 7pace Timetracker Server does not remove its data from the database. You can install it again after uninstalling it and view your previous data on all pages (data will be retained for one year).
Go to your DevOps Server system where you installed 7pace Timetracker.
Open the Windows Control Panel and then select "Programs".
Click "Uninstall".
Select 7pace Timetracker and click the Uninstall button.
| Anchor | ||||
|---|---|---|---|---|
|
.NET Core Update Requirements
With the release of Timetracker 5.53.0, 7pace Timetracker made the switch to .NET 8
.NET 8 runtime bundle is a prerequisite for this update. Please make sure you install it before proceeding (see documentation).
System requirements: 7pace Timetracker no longer supports TFS 2015 (any version) and requires Windows Server 2016 or Windows 8.
Please ensure that your DevOps Server and Timetracker instances use HTTPS protocol.
This version of 7pace Timetracker introduces significant changes. Please make sure you backup your database before proceeding.
During the installation, you will be asked to enter all passwords (SQL Server, Service Account and Email) again when configuring Timetracker. Please ensure you are ready to enter the required information when prompted.
.NET 6 runtime bundle is
...
a prerequisite for 7pace Timetracker 5.46 - 5.52
Net Core 3.1 runtime bundle is a prerequisite for 7pace Timetracker 5.11 - 5.44.3
| Anchor | ||||
|---|---|---|---|---|
|
List of IP ports and URL’s that should be whitelisted
The following IP addresses must be whitelisted:
40.114.210.78
13.89.172.5
13.71.123.138
13.70.72.34
20.50.2.18
The following domains should be also whitelisted:
*.cdn.7pace.com
*.timehub.7pace.com/
timehub.7pace.com
*-7pace-timetracker.azureedge.net
panel.timehub-services.7pace.com
| Anchor | ||||
|---|---|---|---|---|
|
Inherited Process Model configuration vs XML
Starting with Azure DevOps Server 2019, the Inheritance Process Model configuration is supported. This has been the default process used in Azure DevOps for quite some time now.
Upon creating a new collection in your Azure DevOps Server 2019 and newer, you will be asked to choose the process model for the new collection (see screenshot, below).
...
The main difference for 7pace Timetracker (and the end user) is that to add Work Item Contributions (the additional "7pace Timetracker" tab and "Start Tracking" button on the work item form) for an XML-based collection, it is required to modify all Work Item types' XML and upload modified XML definitions back to DevOps server.
In the Inheritance Process Model, this is no longer required and supported, and extensions will work out-of-the-box after installation. In this case, the 7pace Configuration Tool will display a disabled checkbox on the "Installing Work Item Form Contributions" window:
...
To configure visibility in the inherited processes, you can navigate to Process Customization page and change visibility of Timetracker contributions (see details here).
| Anchor | ||||
|---|---|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
Collecting 7pace Timetracker Error Logs
7pace Timetracker does not generate error log files, however, you can use the Event Viewer application of the Windows operating system to collect any error details in Timetracker.
Timetracker Web Application
1. On the Windows system where you installed the 7pace Timetracker Server, open the Windows Event Viewer application.
...
2. In the left pane, click Event Viewer (Local) -> Windows Logs -> Application.
3. In the applications list, search for Error in the Level column.
4. Select the Error level.
...
The General tab displays the error details.
5. Copy the error details and paste those details into a text file.
6. Send the text file to the 7pace Timetracker Support team for further analysis of the error.
7pace Timetracker for Windows App
To access Windows App error logs, please navigate to:
%APPDATA%\Local\Timetracker\{win app version}\app.log
| Anchor | ||||
|---|---|---|---|---|
|
...
You can manage your internal targets in 7pace Timetracker in one of the following ways:
Include them as part of your project and/or sprint
Maintain them independently
Include Internal Targets as Part of Your Project
...
Managing internal targets independently from within a separate project has the following benefits:
Define once, use forever: You define the work items once in a separate project, irrespective of the project or sprint, and keep tracking time to them indefinitely.
Budget Assignment:You can assign a budget to the project that contains your internal targets and then ask your team members to track time against that budget. Once you set the budget, you can always check the time tracked for the internal targets across the budgeted time. This provides managers with detailed information about planned vs. tracked time by all team members for all internal targets.
Data Analytics: You can export time details for the project containing internal targets and generate reports that provide detailed analysis of the time spent on these tasks by all your team members. For example, if a team member took one vacation day in a given work week, they would fill out their timesheet for that week with eight (8) hours logged to an internal target/task that belongs to its own separate project. When the time details report is generated, you can clearly see the total time spent by that team member on true work items and the time logged as vacation.
| Anchor | ||||
|---|---|---|---|---|
|
...
Below, we have listed the steps that you, as an administrator, need to perform to configure internal targets/tasks, from identifying which tasks you want to include, to setting up the template, structure, and hierarchy.
Note: We have explained these steps according to the 'Scrum' project template, but you can use any template. You do, however, need to ensure that you maintain proper hierarchy from project to work items.
Step 1: Identify all required internal targets
For example, vacation, parental or extended leave, meetings, travel.
...
For example, "Internal Targets".
Note: While naming the project, we advise you to choose a name that you can easily recognize and distinguish from other projects as unique to internal targets.
Step 3: Create a "dummy" iteration to group the PBIs and tasks
For example, "Internal-tasks".
...
For example, int-vacation, int-leaves, int-travel, int-daily scrum, int-sprint review, int-sprint planning, and so on.
Note: You'll notice that the naming structure of the PBIs and work items we used starts with a specific string, like "Int". You can elect to follow a similar naming structure so it's easier to search for these work items when you add time or filter them in reports.
After performing these steps, the Azure DevOps project (with 'Scrum' template) structure will look something like this:
...