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

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

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

The AdminWebservice logs, with the default settings will roll over at 100kb. If you have a large amount of data you have may roll over too quickly for us to find the information we need for diagnostics.

On the host machine go to the folder below and edit the Log4net.config as follows:

C:\inetpub\wwwroot\CentralWebservices

Change the value as shown below to increase the file size to 1mb.

<maximumFileSize value="1000000" />

You can also increase the quantity if you like.  

 You may get an error when trying to save the file, so Save As and make sure that the Save as Type

Issue:

Port changes with new email sending library called MailKit.

Cause:

Customers were starting to run into occasional issues where we had problem sending email with TLS/SSL, and because it was related to a Microsoft Component for sending mail that they’ve deprecated. In Clarity 2022 we brought in a new email sending library called “MailKit”.

It turns out that Mailkit behaves a bit differently than the original Microsoft component.

- It basically ignores the “Use SSL” option you specify, and infers the setting from the port number. MailKit said: “You do not have a valid certificate for this mail server”.

The RandRevit database is where all the information for projects, tasks and more is housed, so having a current backup on hand is always a good idea.

Setting an Automated Backup in Settings

There is a configuration for this in Settings on the General tab to Backup the System Database.

The system will attempt, once per week, to make a backup of the RandRevit centralized database to the Backups folder defined in settings.

Manually Backing up the Database

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

The following Windows update (see things to check) causes the ClarityWebAppPool and the ClarityWebServicesAppPool to fail to stay running.

Symptoms

• When accessing the web portal you get a 503 error Service Unavailable
• Web app pools above will not stay started.

Things to Check

• Were any Windows Updates installed?
  • Update for Microsoft Windows (KB4601555)
    • May 11, 2021-KB4601555 Cumulative Update for .NET Framework 3.5 and 4.8 for Windows 10, version 1809 and Windows Server, version 2019 (microsoft.com)
  • Security Update for Microsoft Windows (KB5003243)
    • KB5003243: Servicing stack update for Windows 10, version 1809: May 11, 2021 (microsoft.com)

Event Logs

System Event Warning WAS

Prerequisite

.NET 6.0 Runtime installed

Download Link

Make sure the service is set to Log On as the Clarity Service account.

Issue:

The Journaling service won’t stay running even though the dotnet 6 is installed.

Solution:

We need to make a configuration change to the appsettings.json file in this folder on the host:  C:\Program Files\IMAGINiT Technologies\Clarity Journal Service

Process

Make a backup of the appsettings.json file and change the extension to .orig

Modify the .json file in Notepad.

Add the line below, (highlighted in green in the screen shot) after the password but before the “

;TrustServerCertificate=True

If you get