Repair a domain

Starting in Vera 2025.1, Vera includes a startup process that checks for records and routes that aren’t assigned to any domain. These missing items aren't visible in the Vera UI and can't be accessed by users.

This startup routine repairs most issues automatically. In some cases, you may need to complete manual fixes. A new log file is created during startup to help you identify and address any unresolved records or routes.

Configure the log file

To track domain repair activity, update your logging-settings.json file located in the Configs directory. Add the following section:

Copy 
"Domain Repair": {
    "MinimumLevel": "Information",
    "WriteTo": [
      { "Name": "File",
        "Args": {
          "path": "%VERA_SERVER_DATA_DIR%/Logs/vera-server-domain-repair-.txt",
          "outputTemplate": "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {Message}{NewLine}",
          "rollingInterval": "Day",
          "rollOnFileSizeLimit": true,
          "hooks": "Vera.Logging.SerilogHooks::ArchiveHooks, Vera.Logging"
        }
      }
    ]
  }

Review the log file

After restarting the server, open the vera-server-domain-repair log to check for unresolved items. If the log shows orphaned records, you'll see an entry like the following:

Copy 
2025-03-17 14:49:30.430 -05:00 [INF] The following records are not part of any domain and must be repaired manually:
| Id                        | Name                 | Type            | Status   | Connection       | Project |
| c95e521b-f880-4d7c-af88-5 | TC-1 - Dev 2 Test #1 | qTest Test Case | Rejected | Tx3 qTest Server | 17      |

To fix the issue:

  1. In Vera, go to Administration > Domain Management.

  2. Select the correct domain.

  3. Add the associated project to that domain.

Once the project is added, Vera automatically links all records and routes from that project to the selected domain.

If the log shows missing location data, you may see this entry:

Copy 
| Id                        | Name              | Record ID                 | Status    | Connection             | Project                   |
| 848d67a8-93fe-4460-90b6-9 | Jira Bug Approval | 5426d6db-0977-4df8-8598-2 | Cancelled | Location Data Missing! | Location Data Missing!    |

These entries indicate that both the connection and project data are missing. Open a support ticket and attach the log file.