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.

2026.0

• https://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityHost2026_History.txt
• https://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityTask2026_History.txt

2025.1                                              

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

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

If you have annual licenses in Clarity, the license start and end dates are tied to your subscription start and end dates.

The license will start on your subscription start date and end a year and 10 days later.  There is a 10 day grace period built in which allows you time to renew your subscription and get a new authcode and license in place without a lapse in service.

When a new version of Clarity comes out, your assets are automatically updated in our system to that version of Clarity.

That doesn’t change anything on your system, but if

They each have their own unique uses, so this document is to help you decide which one is the best one to use depending on what you need.

Unified Sync

Unified Sync Help Link

Task Processor:  Clarity Windows Task Server

Scope:  Project

Oauth:  Default or the one specified in the project.

BIM360:  Published files

File Types:  All*

 This task has a variety of Platforms for you to choose from to either Synchronize between the two, or just backup from one to the other.

* IMPORTANT NOTE

Keep in mind that this can transfer all file types, however some platforms may

Archiving a Project enables you to make a full backup of your Clarity Project and all of its components:

• Project Database
• Tasks
• File Filters
• Datasheets
• Reports
• Project Artifacts
• Revit Models (via pre-existing Clarity backups)

This process can be used to take Projects offline (and bring them back later), or to migrate a Project from one server to another.

Notes About Archive Requirements:

• The project must be Active (not deactivated in Clarity)
  • You can see deactivated projects from the Projects tab by selecting the icon shown below.
    • To reactivate, put a checkmark in the box of the project and select Activate.

For the silent install please refer to this article:  https://imaginit.helprace.com/i285-clarity-client-for-revit-silent-install-options - Alternatively, if your deployment system would prefer to work with MSIs, it's possible just by running the executable to retrieve the underlying MSI from the %TEMP% folder, and copy it elsewhere for usage. Other Configuration:

The other configuration cannot be dealt with in scripts, you will have to push config files out to people. The following are the relevant configuration files:

This has relevant info about what information to send in (unauthenticated), plus the "DefaultServerForMetrics" indicates what server it should be sent to when not authenticated. This also includes the

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 system requirements and 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

Forbidden Characters

As a rule, all of the symbols below should be avoided, in both file names and folder names to reduce the likelihood of issues in various environments.  An underscore _ as a separator is always acceptable.

The table below shows what and where a symbol not allowed (No) or is allowed (Yes) or not specifically listed as not allowed.

• Don’t add a space at the beginning or end of a file or folder name. 
• Use less than 260 characters in file or folder paths, 245 for Egnyte.

Current Clarity version at this posting:  2024.1.2

2/9/2024

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

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

When setting up a Clarity task on a scheduled time, there are some things to keep in mind.

• Scheduled tasks are controlled by the Clarity Monitoring Service that runs on the host.

  • If the Monitoring service is not running, scheduled tasks will not run.

• Tasks must be set to Enabled ‘Yes’
• The time the tasks run is based on the equivalent time in the host timezone.
• If the task is set to ‘Only on Change’
  • Has the model date changed since the last time the task was run? (using the date as shown on the project homepage)
  • Has the task definition

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

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.  Install Videos Below are the videos Mandi did…about 7+ minutes in on the Host video is the information about the 360 path migration. https://s3.amazonaws.com/IMAGINiTSoftware/videos/ClarityHost2026Upgrade.mp4 https://s3.amazonaws.com/IMAGINiTSoftware/videos/ClarityTaskServer2026Upgrade.mp4 If you would like assistance with the install, please contact your sales representative to purchase some Design Assist hours (perhaps 2-4 hours) for a typical installation. IMPORTANT NOTE:  Backup the RandRevit Database It is recommended

In the event of a Disaster, these are the following items that we recommend backing up for Disaster Recovery

This is currently a manual process.

• Backup of the Rand Revit database in SQL Express
  • https://imaginit.helprace.com/i732-how-to-manually-backup-the-randrevit-database
• Make a backup copy of the Web.config file in the following locations
  • C:\inetpub\wwwroot\CentralAdministrator
  • C:\inetpub\wwwroot\CentralWebservices
  • C:\inetpub\wwwroot\ClarityReporting
• Optional backup of the Project Databases in SQL Express (although these can be re-constituted from the Revit models)

Locations shown in the Web portal on the Server tab, Settings, General, File Locations 

• Optional backup of the Project Artifacts Folders
  • Default: C:\ProgramData\IMAGINiT Technologies\Clarity\RevitArtifacts
• Optional backup of the Datasheets Folders
  • Default: C:\inetpub\wwwroot\CentralAdministrator\Templates

As of Clarity 2023 we have had the ability to set the task server to perform the post action locally.  This applies to all post actions.  The one thing to be aware of is, depending on the type of post action and where it is processed, the identity can be different.

If you need to change the path, the version or any other setting specified in the project settings you will need to edit the project.

How to Edit the Project

From the Project Home page, select the pencil and checkbox in the upper right corner, Edit Project.

Select the Project Type tab

To Change the Version of Revit in the Project

If you need to change the version of Revit used for the project select update version. 

This will not upgrade models, it simply sets the version of Revit used to perform tasks.

On the Project Type tab, select Update

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

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 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