If you need to make any sort of changes to the database, it is highly recommended to backup the RandRevit database. 

It's also a good idea to have an up to date backup in case of disaster recovery.

Connecting to the database

RDP into the machine where the SQL Database is installed, if you are using the SQL database installed with Clarity it will be on your host server.

• Log onto the server as the Clarity Service account that runs the services and application pools, this should allow you to Log into SQL with Windows Authentication
• Open the SQL Server

I thought it might be helpful to see some examples of what the in-session Appearance settings looked like and what the time differences and file size difference are.

Time Saving Tip

In a nutshell, unless you are printing 3d views for final prints, you can probably get away with Low for the raster settings for Appearance.

Hardware

In this test I am using the Clarity PDF driver the Task Server on my laptop

• Windows 11
• 13th Gen Intel(R) Core(TM) i7-13850HX 10 GHz
• 64gb Ram
• NVIDIA 6gb gpu

Clarity 2025

Same set each time with Raster set to Color

Clarity PDF

Reboot the machine after upgrading if you haven’t done so already, this may fix the issue.

The 503 Error means there is an issue with the application pools, typically this means they aren't running and the most common reason is the credentials.

Log onto the host machine as the Clarity service account

Check the Application Pools Open IIS (Internet Information Services) Select Application Pools on the Left

There are three Clarity application pools Right click on each one in turn and stop the service if it is running

Right click again and go to Advance Settings

Select Identity then select

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

If you are trying to update the software and are running into the following error message

Could not load file or assembly Ionic.zip, you will need to copy the file from another location to resolve the issue.

Resolution

Log onto the host as the Application Pool identity

Through File Explorer, browse to: C:\Program Files\IMAGINiT Technologies\Clarity Monitoring Service

Copy the "Ionic.Zip.dll" file to a network location that you can access from the task server. Copy that dll into the following folder on your task server: 

C:\Program Files\IMAGINiT Technologies\Clarity Task Server for Revit Make sure it isn't blocked by right clicking and

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

This new version includes:

• Bluebeam Integration
• Multi-Project Actions
• Task Management Enhancements

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

Date: Wednesday November 27, 1pm EST.

Register Here

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.

If you do not receive it within a couple of days, please:

1. Check the spam filter

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

This change is Revit version specific!

If you are running into issues with the Revit DBExport task and want to skip certain categories, you can modify a config file to do that.

Process

This change is Revit version specific!

• You will need to log onto the task server as the designated Clarity account
• Exit the Clarity task tray
• Make a copy of the highlighted config file for the version of Revit you want to change C:\Program Files\IMAGINiT Technologies\Clarity Task Server for Revit\202#\Plugins\RevitDBExport.dll.config
• Change the extension from .config to .orig so we have a backup copy of the original settings
• Modify

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: