If you want to set up Office Locations to specify for Task Servers, there are a few places that needs to be set.

In the Clarity Web Portal

• Log into the Clarity web portal as an Admin
• On the Server tab, Offices, add the office locations.
• Once you assign an office to a project, it will increase the number of projects.
• Once you assign an Office Location to a task server, it will increase the number of Task Servers.

On the Task Servers

• Log onto the task server as the designated Clarity account
• Open the Clarity Task Tray
• On the

Issue

You replaced a task server, but you can still see the old one on the Task Servers list

Cause

The task servers will drop off the last after Clarity hasn’t seen them for 21 days, unless there are still projects assigned to it.

You can force the removal as long as there are not projects assigned to the task server.

Solution

In the Clarity web portal, Task tab, Task Servers, select the task server to see if there are any projects assigned to it. 

If there are Projects assigned, you will need to go to each of the projects

Issue:

Error sending task diagnostics from the host when things are locked down due to security reasons.

If sending diagnostics normally works, then clearing the logs folder will likely resolve the issue and this configuration change is not needed.

Please refer to the following blog to clear the logs folder:  https://imaginit.helprace.com/i602-how-to-clear-the-task-server-logs-folder

 Process:

1. Log onto the task server as the designated Clarity account
2. Exit the Clarity task tray and stop the Clarity Windows task server service in Services
3. Zip the content of the logs folder (replace the highlighted value with your version of Clarity if different): C:\ProgramData\IMAGINiT Technologies\Clarity Task Server 2024\Logs
4. Delete

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

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

It may be necessary to increase the amount of time we wait before trying to send files to post action.  The default wait time is 30 seconds.

Increasing the wait time may be needed if you are seeing errors like this on tasks during post action:

The process cannot access the file because it is being used by another process: UNKNOWN APPLICATION (NONE FOUND)"

To make this configuration change we will need to add a line to the ClarityRevitTaskServer.dll.config file located in the following folder:

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

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

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

There are cleanup options in the Clarity task tray, which if checked will try to run once a day about 24 hours after the task tray was started last. Note: We cannot do the cleanup if Revit is running, so if tasks are always running, the cleanup may not occur. There could also be permission issues with deleting things as well at times.

So, if you want to clean up things manually, I have listed the locations below where you can regain some drive space.

You may also want to consider using the Windows Task Scheduler to clean things up.

Issue

If you are unable to send diagnostics from the Clarity web portal completed task id, sometimes clearing the content of the logs folder will resolve the issue.

Process

• Log onto the task server as the designated Clarity account
• Exit the Clarity task tray, by right clicking on the Clarity icon and select Exit
• Open Services and Stop the Clarity Windows Task Server Service
• From File Explorer browse to the logs folder for your version of Clarity
• Example: C:\ProgramData\IMAGINiT Technologies\Clarity Task Server 2024\Logs
  • You can zip the logs folder if you want an archive copy or need to send them

Due to a new project limit restriction on the 16.x versions of the Desktop Connector, we have added a new setting in the Clarity task tray, that will allow us to swap out the least used project, with a new one.

IMPORTANT NOTE:

If the screen is left in a locked state, it is not possible for any UI Automation to run. This is a Microsoft limitation from a security perspective.  That means that in order for this to work and swap projects, the machine must remain unlocked.

Desktop Connector

You will need to make sure you first select the

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

Windows path length limitations will come into play when the fully qualified file name exceeds 260 characters, or the directory name is greater than 248 characters.

The error will look like this in the AdminWebservice Log

TaskService - UploadFile(): Exception while uploading file System.Web.Services.Protocols.SoapException: Unable to create target folder on server! PathTooLongException ---> System.IO.PathTooLongException: The specified path, file name, or both are too long. The fully qualified file name must be less than 260 characters, and the directory name must be less than 248 characters.

There is a configuration change that can be made on the task servers (versions 22.1.11

There is now a way in Clarity 2024, to configure an override when there is an error opening the model like the one shown below.

For Clarity 2025 refer to this blog:  https://imaginit.helprace.com/i659-clarity-2025-task-tray-configuration-for-error-overrides 

Error: One or more dimension references are or have become invalid.

This configuration change is done at your own risk and will apply to all models on this task server that have the configuration files modified.

WARNING

This modification will allow us to delete the dimension(s) so we can continue processing the task, this means that those elements will not show up in the model for that task. 

This change is on a per Revit version basis.

For Clarity 2025, Refer to this blog post:  https://imaginit.helprace.com/i659-clarity-2025-task-tray-configuration-for-error-overrides 

There is a way to say “Continue Loading” for this kind of Schema Conflict dialog.

We are currently programmed to always hit “Do not load” for that specific issue, because there’s a risk of data loss.  When we do that it kills the task.

IMPORTANT NOTE

Please be aware, this configuration change is at your own risk, and you understand that it will change the model during the task, and you are ok with that.  For most tasks, we don't save the changes

This is done at your own risk and will apply to all models on this task server that have the configuration files modified.

WARNING Modifying the ClarityTaskTray.exe.config and setting it to “true” will “Always hit the OK button, if there is one”, we feel like this is at least a little bit dangerous, so we don’t have it on by default.  There will still be dialogs this won't work on, since not all dialogs have an OK response.

Make a copy of the original config file before modifying it so you have a backup. If you edit the config file incorrectly

The Navisworks conversion and Autocad tasks are run as a Clarity Windows Task Server task.

The following must be done on each task server that will be running the tasks.

Start by logging onto the task server as the designated Clarity account.

Clarity Task Automation Service Configuration

In the Clarity task tray, you must set it to use the Clarity Windows Task server.

On the Configuration tab, Edit the Server

Expand Windows and make sure that the tasks you want to process are selected.  Ok out of dialogs.

Services

Set the logged-on Clarity Windows user account as the Log

The process is the same as in Windows 10, but they did a better job of hiding it.

To add a form

• Go to Control Panel\Hardware and Sound\Devices and Printers • Select the printer you want to add a form to • Select Print Server Properties • In the Print Server Properties dialog, Forms tab • Create New Form • Enter name and dimensions (These are intentionally entered backward in here) • • Save Form