To get around this issue we can modify the UpdateVersion.txt file to a lower value so that we can rerun the update.

Host

C:\Program Files\IMAGINiT Technologies\Clarity Monitoring Service

Task Server

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

Process

You will need to edit the UpdateVersion.txt file in Notepad.

The locations are shown above depending on if you need to rerun the Host or the Task Server update.

In the example below, I am on version 26.0.9, I need to change the 9 to an 8 so I can rerun the updater

You will likely get an error when trying to save it back into the original folder, so save it to the desktop, then drag it back into the original folder and overwrite it.

Rerun the Update

Now you can rerun the update by right clicking on the update icon on the desktop and Run as Administrator. 

The updater will run since it thinks it needs the update.

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                                                                                                  

• https://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityHost2025_1_History.txt
• https://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityTask2025_1_History.txt

 2025.0                                                                                                   

• https://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityHost2025_History.txt
• https://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityTask2025_History.txt

2024.1                                                                                                    

• https://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityHost2024_1_History.txt
• https://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityTask2024_1_History.txt

2024.0                                                                                                       

• https://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityHost2024_History.txt
• https://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityTask2024_History.txt

You can also see when updates are available for the host and task servers in the Clarity web portal.

In the Web Portal

Host

Navigate:
Server > Update Version > ’Update Available’ or ‘How to Update’

Task Servers

Navigate:
Tasks > Task Servers > ’Update Available’ or ‘How to Upgrade’

Blog Reference on Updating Clarity

How to Update the Clarity Host:  https://imaginit.helprace.com/i627-how-to-update-the-clarity-host

How to Update the Task Server:     https://imaginit.helprace.com/i644-how-to-update-the-clarity-task-server

 Blog by:  George Suarez

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 go to properties and unblock if necessary.

Then the rerun the updater by right clicking on the updater icon and run as administrator.

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 see a weekly backup of the RandRevit database in the Backups folder location specified on the Server tab, Settings, under File locations.

If you need instructions on how to backup the RandRevit database, please contact support@rand.com

Install Links

Host

http://s3.amazonaws.com/IMAGINiTSoftware/ClarityCentralHost2025.zip

Task Servers

http://s3.amazonaws.com/IMAGINiTSoftware/Clarity2025TaskServer.zip

Licensing

ANNUAL

If you have annual licenses, and they ARE NOT on the current version, they will need to be reset so you can reuse them…please contact support@rand.com

If you have annual licenses and they ARE the current version, I recommend that you copy the license file to the desktop in case it gets overwritten during the installation, then you can just copy it back into the license folder.

PERPETUAL

If you have perpetual licenses, you will need to get the new authcode for that version of Clarity to use to upgrade the license file.

Host License Location

C:\Program Files\IMAGINiT Technologies\Clarity Central Administrator\License

Task Server License Location

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

General Information

Make sure you log onto the machines as the designated Clarity account to do the installation to avoid permission issues.

If you have Clarity without any additional modules, please don’t select any during the install.   

If you do have additional modules, those have their own authcodes to enter during the licensing process.

Download and extract the installer locally on the machines, do not install from a network location.

Host

• Make sure you upgrade the host first, then the task servers. 
• Reference the readme.txt and upgrade.txt in the ClarityCentralHost2025 folder
• Recommended stopping the following Clarity services in Services: 
  • Clarity Active Directory Synch
  • Clarity Journaling Service
  • Clarity Monitoring Service
• Do not run the SQL installer again
• From the Central Administrator folder, Install the software by right clicking on the Setup.exe and run as administrator
• During the install, if you use your own instance of SQL, make sure to enter that information rather than the default!

360 Path Standardization

There is an extra step at the end of the install that fixes the paths in 360 projects.  This needs to be done.  If you opt to do it later, make sure that you backup the RandRevit database first before running the Path Migration from the C:\Program Files\IMAGINiT Technologies\Tools folder.

The help link below explains what it does.

https://s3.amazonaws.com/IMAGINiTSoftware/Documentation/Clarity/2025/index.htm#t=White_Papers%2FBIM360_ACC_Path_Standardization.htm

Task Servers

• Clarity 2025 supports Revit 2021-2025 on the task servers
• If you still need to run 2020 tasks, please leave a task server on 2024.1 to process those tasks.
• Log onto the task server as the designated Clarity account to do the install
• Stop the Clarity Windows Task Server service in Services
• Exit the Clarity Task Tray
• Install the software by right clicking on the Setup.exe and run as administrator

Install Videos

Below are the videos Matt did…about 7+ minutes in on the Host video is the information about the 360 path migration.

• https://s3.amazonaws.com/IMAGINiTSoftware/videos/ClarityHost2025Upgrade.mp4
• https://s3.amazonaws.com/IMAGINiTSoftware/videos/ClarityTaskServer2025Upgrade.mp4

Blogs

I have blog links below for general reference, but I have not created new ones yet for 2025 specifically.

• https://imaginit.helprace.com/i463-clarity-2023-2024-host-upgrade-detailed-installation-reference
• https://imaginit.helprace.com/i464-clarity-2023-2024-task-server-upgrade-detailed-install-reference

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

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

The task server update is a patch to the existing version of the Clarity Task Server software.  Example 24.1.13

Always log onto the task server as the designated Clarity account.  For most that is the service account set up for Clarity, however, if you have switched to Autodesk SSO, you will sign in with those credentials.

Process

Exit the Clarity Task Tray

Open Services

Stop the Clarity Windows Task Server service

Running the Updater

Right click on the Update Clarity Task Server for Revit and Run as Administrator

If a Windows permission dialog comes up select Yes to allow.

A dialog will come up to start the update process, if no update is needed it will say so.

If it is, it will download and install the update.

After the install completes it will report as Success or Failed. 

The dialog does not close on its own, you can close the dialog when it is finished.

Failed Update

If it failed, send the log file shown in the updater dialog box to support@rand.com so we can see what the issue is, then close the dialog.

Verify

Verify the Clarity Task Tray is running and the Clarity Windows Task Server service is running

Launch Task Server

From the desktop icon Launch Task Server for any version of Revit to post the update to the Clarity web portal.

Updates are patches to the current version you have installed.  For example 24.1.5

You can see if an update is available from the Server tab, Central Host to the right of the Update Version value.

Update Process

Log onto the Host server as the Clarity service account (application pool identity)

In Services, Stop the Clarity services

Right click on the desktop icon Update Clarity Host, Run as Administrator

The updater dialog will come up to determine if the update is needed, if so it will start downloading the files needed to update.

When the update completes, it will indicate if it succeeded or failed.

If it succeeds, close the dialog box.

Verify that the Clarity Services are running

Failed

If it fails, note the log file location and send that file to support@rand.com so we can determine what the issue is.  Close the dialog box.

DOWNLOADS

First you will need to download the following into a folder on the machine or on your network… For example C:\Clarity\Updates

Host

• http://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityHost2024.zip

Task Servers

• http://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityTask2024.zip

Updater Files

Download the updater files from the links below and place them in the same folder as the content above.  For this it will just bring up a web page with that text so just right click on the page and save as to save it to the proper folder.

Host

• http://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityHost2024.txt
• http://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityHost2024_History.txt
• http://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityHost2024.hash

Task Servers

• http://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityTask2024.txt
• http://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityTask2024_History.txt
• http://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityTask2024.hash

Configuration Change

Next we need to edit the config file so it knows where to pull the updater from.

• Open with notepad: IMAGINiT.Updater.exe.config
• Look for an entry in the XML file that says that the location for the UpdateLocation is:
  • http://s3.amazonaws.com/IMAGINiTSoftware/Updates/
• Replace THAT url shown below with the folder that you have, i.e.
  • C:\Clarity\Updates
• Host path C:\Program Files\IMAGINiT Technologies\Clarity Monitoring Service\
  • Host Config Example of location to change
  • 
• Task Server path C:\Program Files\IMAGINiT Technologies\Clarity Task Server for Revit
  • Task Server Config Example of location to change
  • 
• If you get an error saving the file, save it to the desktop, then move it into the folder and overwrite.
• Make sure it is still seen as a configuration file or it will not work.
• 

Running the Updater

Run the updater again by right clicking and Run as Administrator– it will look in that folder for the updates, find them, and copy them in.

While the upgrade is not as easy as our “patching” updates, it’s not too hard. These are “setup.exe” installations, and if you follow the instructions below, you are unlikely to run into any issues.

If you don't feel comfortable doing the upgrade yourself and would like to have us assist you with the upgrade process, please contact your sales representative to get some Design Assist hours (perhaps 2 hours).

ANNUAL LICENSES
If you have annual licenses let us know the activation count needs to be reset. Please provide your current authcode which can be found in the IMAGINiT.lic file on the task server in this folder: C:\Program Files\IMAGINiT Technologies\Clarity Central Administrator\License

If you have the Projectwise Module, that will also need to be reset.

Email us that information at Support@rand.com

I have included some video links related to the process.

BEFORE WE BEGIN VIDEO LINK

UPGRADE PROCESS

1. Log on to the host as the Clarity account (generally a service account setup for this).  Please make sure you have your Authorization code handy.
2. Document the identities assigned to the Clarity services and Application Pools in IIS
3. Download the most current installer and save it locally on the host machine (VIDEO LINK)
4. Extract to the local machine.
5. Shut down the following Clarity Services on the host before upgrading.  (VIDEO LINK)
   1. To access the Services tool, type in Services on the Search bar...you might want to pin it to the task bar for future use.
   2. 
   3. 
   4. If you have a task server on the machine, please shut down the Clarity Windows Task Server also.
6. Do not run the SQL installer again.
7. We have seen issues with overwriting the items below, to avoid that possibility I recommend you do these steps.
   1. On the desktop create a folder Clarity_Backup
      1. Create three sub folders named:  CA, CW and CR to place our backup files in prior to installing.
         1. CA=CentralAdministrator, CW=CentralWebservices, CR=CentralReporting
         2. 
   2. Make a backup copy of all the .config files in the following locations and copy the bin folder content from each and place in the corresponding folders mentioned above.  (VIDEO LINK)
      1. C:\inetpub\wwwroot\CentralAdministrator
      2. C:\inetpub\wwwroot\CentralWebservices
      3. C:\inetpub\wwwroot\ClarityReporting
   1. Make a backup of any custom datasheet templates and reports and place them in the CA folder
      1. C:\inetpub\wwwroot\CentralAdministrator\Templates\DataSheet
      2. C:\inetpub\wwwroot\CentralAdministrator\ReportTemplates
   2. If you have customized the look of the Clarity web portal to change colors, please also backup this file to the CA folder.
      1. C:\inetpub\wwwroot\CentralAdministrator\Content\Layout.css
8. Delete all the files in the following bin folders on the host or rename the folders so we can create new ones.  We saved copies of them already, but the fbin olders should be empty or renamed before installing  (VIDEO LINK)
   1. C:\inetpub\wwwroot\CentralAdministrator\bin
   2. C:\inetpub\wwwroot\CentralWebservices\bin
   3. C:\inetpub\wwwroot\ClarityReporting\bin

9. Move the IMAGINiT.lic file out of the license folder (shown below) and verify that the Clarity account has full permission to the C:\Program Files\IMAGINiT Technologies folder before proceeding with the install.

   1.   C:\Program Files\IMAGINiT Technologies\Clarity Central Administrator\License
      

Install Process

1. In the location where you saved the installer, browse to the CentralAdministrator folder  (VIDEO LINK)
   1. Example: E:\Software\Clarity 2023\ClarityCentralHost2023\Central Administrator
2. Right click on the setup.exe and run as administrator
   1. 
3. Follow the instructions in the dialogs to complete the install
   1. There may be a prerequisite that we need to install before installing Clarity.  Install that so we can proceed with the Clarity install.   
   2. 
4.  
5. 
6. 
7. 
8. 
9. 
10.  The default SQL is shown below, if you have your own database that Clarity is hosted on replace the default value with your database
    1. 
11. 
    
    1. The install takes a bit longer than normal since we will go through each project in Clarity in the database, you will see a dialog going through each project you have in Clarity that looks like the image below.
    2. 
12. When the install completes it should bring up the license dialog box, if it doesn’t, go ahead and move on to the next step to uncheck Check for Updates and Finish then reboot.
    1. 
    2. Enter your Authorization code and Authorize to license the software
       1. 
    3. On the InstallShield Wizard Completed screen, uncheck Check for Updates and Finish
       1. 
13. Reboot the Server

1. Log back into the server as the account you installed under (VIDEO LINK)
2. Stop the following services again
   1. 
3. From the desktop icon Update Clarity Host, right click and run as administrator
   1.                      
4. If you were not able to Authorize the product with the Authcode provided previously, go to the following folder and run the LicenseRequester.exe
   1. C:\Program Files\IMAGINiT Technologies\Clarity Central Administrator\License
   2. If you don’t see the Licensing dialog, we will need to replace the dlls in the folder above.

1. Download the following dlls to the desktop
   1. 2023.1:  https://www.dropbox.com/sh/5l8era3lu5h0wdw/AACuo5bp7sXCBBbEDxbnW4CKa?dl=0 
   2. 2024.0:  https://www.dropbox.com/s/8d95i8lsmuwa737/__Clarity%2024%20license%20dlls.zip?dl=0 
2. Extract the zip file content, verify that the dlls are not blocked, then copy and overwrite the ones in the folder.
   1. Right-click on each dll
   2. Click “Properties” at the bottom of the context menu
   3. If it shows as blocked, Tick the “Unblock” box in the “General” tab and hit “OK”
3. Rerun the license requester and enter the Authcode you were provided if you don’t already have a 2023 license. If you already have a valid license you will see a dialog like this
   1. 

1. After the host install completes, reset the Application Pool identities to your service account if needed.
2. Verify settings for the Clarity Monitoring service and the AD sync
3. If you have purchased the Projectwise module, install and license that also
   1. Stop the following services before running the installer
   2. 
4. Verify you can connect to the Clarity Web Portal on the host
   1. http://localhost/CentralAdministrator

If you receive an error, we will need the content of this folder for diagnostics.

1. C:\ProgramData\IMAGINiT Technologies\Clarity\Logs

ANNUAL LICENSES

If you have annual licenses let us know the activation count needs to be reset.  Please provide your current authcode which can be found in the IMAGINiT.lic file on the task server in this folder:  C:\Program Files\IMAGINiT Technologies\Clarity Task Server for Revit\License

Email us that information at Support@rand.com

INSTALL PROCESS

1. On the task servers log in as the designated Clarity account.
2. Make sure the new version of Revit is already installed, including addins needed for tasks.
   1. Revit 2023-24 only supported OS is Windows 10 or 11, make sure it is updated as well prior to the install.
3. Exit the Clarity Task tray and stop the Clarity Windows Task Server Service in Services. Note the identity assigned to the service in case it needs to be reset after the install.
   1. To access the Services tool, type in Services on the Search bar...you might want to pin it to the task bar for future use.
   2. 
   3. 
4. Verify that the Clarity account has full control permission to the C:\Program Files\IMAGINiT Technologies folder, if not, add full control for that account specifically.
5. Copy the License folder to the desktop:  C:\Program Files\IMAGINiT Technologies\Clarity Task Server for Revit\License
6. Delete the content from the license folder:  C:\Program Files\IMAGINiT Technologies\Clarity Task Server for Revit\License
   
7. Download and Extract the Task Server software to the local machine.
8. If you have customized any config files, make a backup of them, or create a copy of this folder:  C:\Program Files\IMAGINiT Technologies\Clarity Task Server for Revit and place it on the desktop, rename it to Clarity Backup in case we need to reference changes later.  Also backup the ClarityTaskService.config from this folder:  C:\ProgramData\IMAGINiT Technologies\Clarity Task Server 202#
9. Right click on the Setup.exe and run as administrator
   1. 
10. Follow the instructions in the install dialogs
    1. 
    2. 
    3. 
    4. 
    5. Enter the credentials and password used to run the Clarity Windows Task Server.
    6. 
    7. 

7.  Do not check for updates at the end of the installation, there tends to be issues stopping services.

1. Uncheck the box and finish
2. 

Licensing

1. If the license dialog box comes up, enter your authorization code to license the software for stand-alone installs.
   1. If you don’t see the Licensing dialog, we will need to replace the dlls in this folder: C:\Program Files\IMAGINiT Technologies\Clarity Task Server for Revit\License
      1. Download the following dlls to the desktop for the version you are upgrading to.
         1. 2023.1:  https://www.dropbox.com/sh/5l8era3lu5h0wdw/AACuo5bp7sXCBBbEDxbnW4CKa?dl=0 
         2. 2024:  https://www.dropbox.com/s/8d95i8lsmuwa737/__Clarity%2024%20license%20dlls.zip?dl=0 
         3. 2024.1:  https://www.dropbox.com/scl/fi/x2rx2n8o5tj1v3drrz3jv/Clarity_24_1-Lic-dlls.zip?rlkey=1gz7ylsymcvynf3sfgyv2tw7e&dl=0
      2. Extract the zip file content, verify that the dlls are not blocked, then copy and overwrite the ones in the License folder.
         1. Right-click on each dll
         2. Click “Properties” at the bottom of the context menu
         3. If it shows as blocked, Tick the “Unblock” box in the “General” tab and hit “OK”
      3. Rerun the license requester and enter the Authcode you were provided if you don’t already have a current license. If you already have a valid license you will see a dialog like this
         1. 

Updating Clarity

1. Exit the Clarity Task tray and stop the Clarity Windows Task Server Service.
2. Run the updater from the desktop icon by right clicking and run as administrator
3. If you use the Windows Service Task server also for tasks that don’t require opening Revit, Stop/Start the service and make sure that service is running and the proper identity is assigned to it.

Adding Revit 2023

1. Open the task configuration tray and add Revit 2023
2. Launch Task Server from Desktop icon to publish the changes back to the host.

Default Task Tray Credentials

If you are using the built in Clarity account for the task server user is below.  Please contact us if you need the default password.

1. Username: Clarity@rand.com            Password:  Contact us at support@rand.com
2. Be aware that if you changed the password for this account, you would use that password instead.

DOWNLOADS

First you will need to download and extract the following into a folder on the machine or on your network… For example C:\Clarity\Updates

Host

• http://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityHost2023.zip

Task Servers

• http://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityTask2023.zip

Updater Files

Download the updater files from the links below and place them in the same folder as the extracted content above.  For this it will just bring up a web page with that text so just right click on the page and save as to save it to the proper folder.

Host

• http://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityHost2023.txt
• http://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityHost2023_History.txt
• http://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityHost2023.hash

Task Servers

• http://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityTask2023.txt
• http://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityTask2023_History.txt
• http://s3.amazonaws.com/IMAGINiTSoftware/Updates/ClarityTask2023.hash

Configuration Change

Next we need to edit the config file so it knows where to pull the updater from.

• Open with notepad: Updater.exe.config
• Look for an entry in the XML file that says that the location for the UpdateLocation is:
  • http://s3.amazonaws.com/IMAGINiTSoftware/Updates/
• Replace THAT url shown below with the folder that you have, i.e.
  • C:\Clarity\Updates
• Host path C:\Program Files\IMAGINiT Technologies\Clarity Monitoring Service\
  • Host Config Example of location to change
  • 
• Task Server path C:\Program Files\IMAGINiT Technologies\Clarity Task Server for Revit
  • Task Server Config Example of location to change
  • 
• If you get an error saving the file, save it to the desktop, then move it into the folder and overwrite.
• Make sure it is still seen as a configuration file or it will not work.
• 

Running the Updater

Run the updater again by right clicking and Run as Administrator– it will look in that folder for the updates, find them, and copy them in.