In order for Clarity tasks to be processed on the Task Servers, the Task Servers must be logged in with the designated Clarity account at all times.

If the machine does automatic Windows update, we cannot automatically sign back in and this will cause tasks to time out until the task server is signed back in.

In addition to that, the Clarity Task tray must be running in order to process Revit tasks.

For Clarity Windows Task Server tasks, that service must be running.

The 360 Token for these tasks uses the credentials tied to the project in the Clarity

Want to see what’s updated in Clarity?

Clarity updates are issued as needed, rather than on a schedule, so you can check to see what is in each update in the links below.

Update Links 

Check your version(s) below for the latest notes and updates. Keeping up to date with the most current Clarity Version is always a good practice and may help prevent Task issues that may arise during your daily workflow.

 2025.1                                                    

We recommend that the task servers be at least comparable to workstations used in production, if not stronger, especially if you are planning on running multiple sessions of Revit and or multiple logins (not typically recommended due to permission issues). 

When referring to the Revit System Requirements.

Do not go with anything lower than the Value, but Performance is recommended, or value with double the ram if you have large models with multiple links.

If you choose to use virtualization, be aware that graphic intense tasks will not perform as well without a physical graphics card.  Refer to the Virtualization section below.

If you have anti-virus installed on the task server, it can interfere with processing tasks.

This post is for task servers not installed on the host server.

Symptom

Clarity Task Tray disappearing or not running.  Lots of tasks fail with "The task has apparently died."

Anti Virus is removing the file or folders.

Resolution

Clarity Exclusions

Add exception for the following path

C:\Program Files\IMAGINiT Technologies\Clarity Task Server for Revit

Add exclusion for the following files

• ClarityTaskTray.exe
• Clarity.TaskServerWinService.exe
• LaunchTaskServer.exe
• IMAGINiT.Updater.exe
• Clarity.BIM360Utils.Delegate.exe
• Clarity.Task.Delegate.exe
• LicenseRequester.exe

Autodesk Exclusions

For a full list of exceptions please refer to the Autodesk link below.

https://www.autodesk.com/support/technical/article/caas/sfdcarticles/sfdcarticles/Are-there-antivirus-exclusions-I-can-implement-to-make-programs-run-better.html?msockid=37b62c7b126b64c91a12382f13396502

There is a way to place the task back into the queue if it opens in one session of Revit with an exception, so that it can be tried again.

If you prefer the task fail, the setting will need to be False.  If you want the task to be put back into the queue, the value should be True.

There is not currently a configuration for a number of attempts, so it will continue until it times out if set to True.

This change is on a per Revit version basis!

Process

• Log onto the task server as the

For certain types of tasks, addins are required.

We recommend only installing the addins needed for tasks. 

Some Autodesk addins install automatically with the software, but others are a separate install.  If they are not on this list, please do not install them as they may interfere with the Clarity software.

Please also be aware that some addins can cause ownership issues when processing tasks.

Additionally, some addins are build specific and may vary by Clarity version.  Please refer to the information below.

Revit Addins

Additionally, you will need to install the necessary add ins per version as needed for

In order to enable Clarity to access ACC projects, the account manager must specifically enable access at the Account level.

To enable access:

1. Sign into the ACC portal as an Account Admin:  https://acc.autodesk.com/
2. Select the Apps icon
3. Select the IMAGINiT Clarity app and Install

   2. We only need access to Document Management
4. The icon will change to look like the image below and will show as Active.
5. The published files should show up in Clarity after about 5 – 10 minutes.

  Note: The Clarity ACC integration relies on the Forge interface for Project/model information; therefore, the models do not exist

We'll share what we're thinking about the Roadmap for Clarity, and you can give us your ideas of what we should focus on.

Join below for the August 22 session.

Clarity 2025.1 Webinar

There are certain types of errors that will kill a Revit task.  Previously it was necessary to manually modify a config file.

In Clarity 2025, you can now just make the configuration changes in the Clarity task tray.

Make sure you log onto the task server as the designated Clarity account

Error Handling Overrides

• Open the Clarity task tray
• On the Revit tab

On the Revit tab, under Revit Error Handling Option, there are a few options, if you want to make selections you will want to set it to specified.

• None
  • No overrides
• Detached Only
  • This would only apply

The Clarity Windows Task Server will process tasks that don’t require opening Revit. 

Some of the setup is inside of the Clarity Revit Task Tray, but since this runs as a service by default, the rest happens in the properties of the service itself.

Settings in the Clarity Task Tray for Revit

To limit the Windows tasks run on the task server, open the Clarity task tray, select the Server and Edit, go to the Tasks tab, expand Windows and Uncheck any tasks you don’t want processed on this task server.

Settings for the Service

Open the Services panel and select the

Issue:

If you get an alert like this, that means that the Autodesk identity on the task server is no longer logged in.

ClarityRevitTaskServer: BIM360 Token Gone Bad TASKSERVER02

The Autodesk BIM360 Token on TASKSERVER02 has recently gone bad! 

This is the Revit/AutoCAD sign-in, which is used to keep Autodesk products running in a batch mode. Clarity tasks will attempt to continue, but will likely be impacted!

• Time Since the Last Change: 12.3 hours
• # of times it successfully refreshed before failing: 0
• Application that (we believe) made the last change: AdSSO.exe v13.7.7.1807
• Desktop Connector Version: 16.5.0.2083
• Autodesk AdSSO Version:

Issue

You are trying to test something manually in Revit on the task server, and the Task dialog is launching when you launch Revit, even though the Clarity Task Tray is exited.

Cause

When the Clarity Task Tray for Revit is running, it puts an addin in the addins folder while Revit launches to pick up a task, when we are done with the task, we try to delete it...if we are unable to delete it due to permissions issues generally, then that dialog will come up even though the task tray is not running.

Resolution

You need to make

Introduction

These prerequisites are required for all types of Clarity host.

This guide does not cover the full configuration and operation of the software – merely the host prerequisites.

Hardware/Operating System Requirements

Clarity requires a server-class Windows Server operating system to be the central web server. 

A dedicated server is highly recommended.  Whether you will be using Revit Server in your environment or not, the prerequisites are the same for Clarity, so the System requirements below should be referenced.

I highly recommend that you go with the Performance requirements, but no less than the Value for either circumstance of concurrent

If a task is stuck in the claimed status, the task server started opening the model, but something happened during that process that hung things up.  We aren’t able to kill it from the Clarity web portal, so you either have to wait for it to time out, or manually kill it on the task server.

If you are trying to get other tasks to run, you probably don’t want to wait for that to happen, so the resolution is to manually fix the issue on the task server.

Causes:

If we are waiting for a response in Revit while

General

Updates are patches to the current version you have installed.  For example 24.1.5

You can see if an update is available from the Server tab, Central Host to the right of the Update Version value.

Update Process

Log onto the Host server as the Clarity service account (application pool identity)

Right click on the desktop icon Update Clarity Host, Run as Administrator

The updater dialog will come up to determine if the update is needed, if so it will start downloading the files needed to update.

When the update completes, it will indicate if it succeeded or failed.

If

BIMTrack integration requires its own credentials to access all projects on BIMTrack for the Backup task and Upload post action.

In BIMTrack, it is a two-legged OAuth Token, giving access to Clarity to a particular BIMTrack hub.

There is NOT a different set of credentials per user.

You only need one API token to have access to all projects on a BIMTrack hub.

Setup

• Go to your BIMTrack hub and retrieve the API Access token.

  • In BIMTrack - Hub Settings > Gear Icon > API Access Token

  • Go to the Clarity Server/Settings/OAuth page, BIMTrack and add credentials.

  • Enter the hub name

The monitoring logs, with the default settings, will roll over at 100kb.

If you have a large amount of data, they will likely roll over too quickly for us to find the information we need for diagnostics.  To resolve this, and capture more data, we need to modify a config file.

Log onto the host machine as the Clarity Service Account

Go to the following folder:

• C:\Program Files\IMAGINiT Technologies\Clarity Monitoring Service

• Make a copy of this file: Log4net.config and rename the copy extension to .ORIG

• Edit the Log4net.config with Notepad

• Change the value as shown below to increase the file size

Prerequisite

.NET 6.0 Runtime installed

Download Link

Make sure the service is set to Log On as the Clarity Service account.

Issue:

The Journaling service won’t stay running even though the dotnet 6 is installed.

Solution:

We need to make a configuration change to the appsettings.json file in this folder on the host:  C:\Program Files\IMAGINiT Technologies\Clarity Journal Service

Process

Make a backup of the appsettings.json file and change the extension to .orig

Modify the .json file in Notepad.

Add the line below, (highlighted in green in the screen shot) after the password but before the “

;TrustServerCertificate=True

If you get

The Clarity team is happy to announce the availability of Clarity 2025!

This new version includes:

• Support for Revit 2021 thru 2025, with limited support for 2020.
• Revit Error Resolutions
• Aconex Integration  (additional cost module)
• Enhancements to Clarity Space Programming
• And more.

You are welcome to join us at the link below for a short webinar related to what's coming in the Clarity 2025 product.

Date: Thursday May 30, 1pm EST.

https://register.gotowebinar.com/register/6735875851840934743

How Will I Get My Copy?

An email will be sent in the next day or so to the designated contact for your company with the new download

You want to know if you can enable FIPs on Clarity machines.

What is FIPS? FIPS stands for Federal Information Processing Standards These are standards and guidelines for federal computer systems that are developed by National Institute of Standards and Technology (NIST) in accordance with the Federal Information Security Management Act (FISMA) and approved by the Secretary of Commerce.

If you are working on government projects, this is something that will likely apply to you.

You can find out more about FIPS at the link below. https://www.nist.gov/standardsgov/compliance-faqs-federal-information-processing-standards-fips#2

Clarity General Information Clarity should sense that FIPS is enabled. This information will