Upgrading Clarity to a new version of the software requires running the Setup.exe.  While it is not as simple as running the Updater from the desktop, it is not overly complex. There are video links below on the install process.  If you would like assistance with the install, please contact your sales representative to get some Design Assist hours (perhaps 2 hours) for a typical installation. IMPORTANT NOTE:  Backup the RandRevit Database It is recommended that you have a current backup of the RandRevit database. If Backup System Database is set to True in the General System Settings, you should see a weekly backup of the RandRevit

This blog is to cover the basic task setup Above the Line

When I say ‘above the line’ I am referring to the area shown below which is common to most tasks.

I am using a PDF task in this example, but this will apply to most Task types.

Above the Line

This is where you will set the basic settings of the task

1. Name

   1. The name of the task: I tend to name mine relevant to what type of task it is and how they are set up
      1. In the example above PDF is the type of task, E1

We’re excited to announce that the 2026 release of Clarity is now live! This update brings powerful new features and enhancements designed to help you work smarter and more efficiently.

Join us tomorrow at 1:00 PM for our kickoff webinar, where we’ll walk through the new technology and show you what’s possible with this release.

Date: Thursday May 29, 1pm EST.

https://register.gotowebinar.com/register/6979865186520532829?source=a2uVU0000043ENVYA2

We can’t wait to share what we’ve been working on—see you there!

The Only on Change setting is intended to save unnecessary tasks from running, so if nothing has changed in the model, the task does not run.

What Determines if the Task Runs

When setting a task schedule to Only on Change, that means that even though that task is set to run at a set day/time, it will only run if one of the following occurs:

• The date of the target file changed in Clarity since the last time it ran?

  • You can see that date on the Project Home page or

  • The Files tab for that file

    • If a

When setting up a Revit PDF task and defining the Page Setup area of the task, you can use a Named Page Setup, or define the settings in the task [In-Session]

It is important to know that the PDF driver that is used is set on the Task Server in the Clarity Task tray, unless you are using the Revit Export settings in this task (Revit 2022+)

The only PDF driver that can run in multiple sessions of Revit aside from the Revit PDF Export, is the PDFx driver. 

All other pdf drivers can only run in one instance of

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

This new version includes:

• Support for Revit 2022 thru 2026, with limited support for 2021.
• Data analytics and Business Intelligence Enhancements
• Secure Service Accounts
• And more.

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

Date: Thursday May 29, 1pm EST.

https://register.gotowebinar.com/register/6979865186520532829?source=a2uVU0000043ENVYA2

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 and Authorization Codes.

If

Each version of Clarity supports a specific build of the BIT tools

Below is a list of the support versions, please contact support@rand.com if you need a specific version.

5/1/2025

Clarity 2025.0 and 2025.1

Revit 2021-2025        9.2.2

Clarity 2024.1

Revit 2021 - 2024      9.1.8599 Revit 2020                 9.0.8326

Clarity 2024.0

Revit 2024                 9.1.8503 

Revit 2020 - 2023      9.0.8326

A task sequence bundles together multiple tasks in a project so that they will run together, in a single operation, in a guaranteed sequence.

That means, that regardless of the server settings, the targets in this task will all run at the same time and in the order specified in the task setup. 

If you are running a sequence on multiple targets, this could cause issues with tasks failing due to timeout issues.

The task server that claims the sequence will do all of the tasks in the sequence, for all models, in one session.

Guidelines

• You cannot mix File scoped and Project scoped

There are specific versions of the Desktop Connector that are supported/recommended for Clarity.

Please check with support@rand.com before upgrading the DC on the task servers.

Clarity 24.1

• 16.9.1 

Clarity 25.0.22 (03/05/2025)

• 16.12 

Clarity 25.1.6 (03/05/2025)

• 16.12 

• If you have a mixed environment of Clarity task servers (25.1  and 24.1 for example) and update the DC on older task servers, you will need to manually select projects on those task servers and uncheck the automation in the Task Tray

Autodesk Desktop Connector Previous Versions Download Links

You can download older versions of the DC from the following Autodesk Link

https://help.autodesk.com/view/CONNECT/ENU/?guid=Historical_Releases_Desktop_Connector

Interested in seeing what is coming in the next version of Clarity?

Come to our webinar on April 16. Click Here to Register

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