The RandRevit database is the core of everything in Clarity, including projects, tasks, and more.

There is an option in the Clarity Server Settings to automatically backup the RandRevit database weekly to the backup location specified in settings.

Why you might need to backup the database

• You need to make changes to the database
• You need to send it to development to look over
• Disaster recovery
• Server migration

What you will need:

• Remote Access to the machine where the database lives (typically the same as your Clarity Host).
• Be able to sign in with your Clarity Service account (or perhaps the

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

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

What is the Clarity Task Utility?

It is a Windows-based tool, installed with the Clarity Host software, which can do some batch updates on tasks and task definitions.

Where is It?

C:\Program Files\IMAGINiT Technologies\Tools\Clarity.TaskUtility

What Can It Do?

• Manage Current Tasks
  • Select the tasks in the grid, then for the selected tasks:
    • Kill Them (request that Revit be shutdown if it's working on them)
    • Delete them (remove them if Revit has not yet claimed them)
    • Reprioritize them to a new priority level
• Manage Task Definitions
  • Select the tasks in the grid, then for the selected tasks:
    • Batch Copy them to

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. 

When referring to the Revit System Requirements I recommend that you go with the performance requirements.  If you choose to use virtualization be aware that graphic intense tasks will not perform as well without a physical graphics card.

System Requirements

Please refer to the link below for specific information.

Revit System Requirements

Operating Systems:  Windows 10 or 11

Supported Versions of Revit

Revit 2019-2023

Software Licensing

Any

Issue

Projects are showing as Stale in Clarity

Cause/Things to Check

• Autodesk Health
  • Were there Autodesk outages that may have affected things?
    • https://health.autodesk.com/

• In Clarity

  • Is the Clarity Monitoring Service still running?
    • Stop/Start the service to rescan everything
      • Server tab, Central Host
  • Is the Oauth for that project still valid?
    • Server tab, Settings, Oauth
      • https://imaginit.helprace.com/i484-clarity-how-to-reset-the-360-oauth-credentials
  • Select Check to see what Hubs/Projects you can see with that Oauth 
    • IF YOU DON'T SEE THE HUB WHEN YOU CHECK, THERE IS SOMETHING WRONG WITH THE APP IN ACC.
      • Try removing the app and reinstalling it and verify it is active. 
    • If you see

If you changed the password to the account you use to run your Clarity services, this will stop Clarity from functioning properly until the password is updated in all locations it is used.

Host

On the Host this identity is generally used for the following:

IIS

• ClarityReportingAppPool
• ClarityWebAppPool
• ClarityWebServicesAppPool

To Update

• Right Click and select Advanced Settings
• Select Identity, then the ...
•       
• Select Set
•      
• Enter the Domain\Username, then password and confirm.
• Start the Application Pool
• Repeat for the other two.

Services

• Monitoring Service
• Clarity AD Sync Service

To update

• Right click and select Properties

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 as well as blog links.  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

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

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

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

The ClarityClient2021ClientRevit.exe is built with InstallShield, which supports most MSI-style options, including passing them thru to the MSI.

See this link for install options for the Clarity Client installer: 

https://docs.revenera.com/installshield21helplib/helplibrary/IHelpSetup_EXECmdLine.htm

You can increase productivity by running some of your tasks with Worksets set to None.  This will improve the open time, dramatically in some cases, depending on the size of the file and the number of links.

Below is a list of tasks that can run with worksets set to None without impacting the output from the task.

Revit Tasks

• Backup Project
• Backup Revit Server
• BIM360/ACC Publish
• BIM 360 Migrate
• Family Upgrader
• Harvest Families
• Index Families
• Index Model Families
• Model Checker
• Model Metrics
• Model Review
• Model Upgrader
• Performance Advisor
• Quantity Snapshot
• Revit Audit and Compact
• Revit Database Export
• Unless you

Oauth Credentials

360 projects that are in Clarity require that the 360 Oauth identity be Valid so that we can see the Project and files.

This identity must be a member of each project you want to add to Clarity and also be assigned to the document management team.

Symptoms of an invalid Oauth

• Can’t add new 360 projects because they don’t show up on the list of available projects for the hub
• 360 Post actions will not work
• Projects are showing as stale
• Files not showing on the project home page or as task targets

Reauthenticating the Oauth

• Log

Issue

There is a security feature in Clarity, if you try to log into the web portal, or through the task server configuration with the incorrect password more than the number of times set in settings, the account will be disabled.  

You can modify this setting from the Server tab, Settings.

The task servers commonly use the Clarity@rand.com login, this account is sometimes also used in the Clarity Active Directory Synch tool on the host on the Clarity tab, you will want to update it there as well.

You will need to update it in all locations or it will

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

When troubleshooting issues in Clarity, diagnostics tell us where to look to resolve the issues.  The diagnostics come from different places depending on where the issue is occurring.

Diagnostics roll over pretty quickly, the more projects/tasks, the faster they roll over. 

Please send in the diagnostics as close to time the issue occurred, or recreate the issue/rerun the task, then send in the diagnostics.

If you are unable to create a case when sending in diagnostics from the web portal you can email the manually gathered diagnostics to support@rand.com

Task Issues

• If a task runs, but doesn't complete, we need

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

Below is a list of the only supported versions of the tools for a specific version of Clarity/Revit.

If you need a specific version of the tools, please contact support@rand.com.

Clarity 2026.0

Revit 2023-2026        10.0.3

Revit 2022                   9.2.3

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             

How does Daylight Savings Time affect Clarity?

For 2 hours per year (at least in the US) there are some odd Clarity issues. 

When Time Springs Forward

In the springtime, the clocks jump nearly instantly from 2am to 3am the night of Daylight savings time:

• Any tasks set for 2:00 "might" run (small chance)
• Any tasks set for 2:15, 2:30 or 2:45 will not run

When Time Falls Back

In the fall, the clocks jump from 3am back to 2am on the night of Daylight Savings Time:

• Any tasks set to 2:00 am, 2:15, 2:30, 2:45 or 3am may get

There are several factors that control or impact task processing, please refer to the information below.

Types of Task Servers

There are several types of Task Servers that can be enabled in the Clarity task tray.  For each of these, the proper identity must be associated to it.  For Revit tasks, the logged in windows session should be the designated Clarity account.  For the Windows task server, the service account identity needs to be the “log on” in that service.  Forge requires credentials and a key.

• Clarity Revit Task Server
  • This will process tasks that require opening the Revit model.

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