Solar Archive Knowledge Base
  • 👋Welcome
    • Solar Archive's Structure
    • Contacting Support
    • Selling Email Archiving
    • White-label / Private Label
  • ⚡Quick Start
    • 1️⃣Creating a Tenant
    • 2️⃣Setting up Live Email Feed
    • 3️⃣Importing Old Email
    • 4️⃣Creating User Accounts
    • 5️⃣Checking Live Mail Receipts
    • ✅Finished Setup
    • 🆕Automated Onboarding
      • 1️⃣Admin Setup
      • 2️⃣Tenant Setup
      • 🔄Data Import
      • ☑️User Setup
  • 🧑‍🦲Managing Users
    • User Types
    • Creating Local User Accounts
    • Creating Basic User Accounts
    • Creating Data Guardian User Accounts
    • Creating Privileged User Accounts
    • Searching the User Directory
    • Adding a Delegation Link
    • Adding as Delegate
  • 🧙‍♂️Managing Tenants
    • Setting up a T1 Tenant
    • Setting up a T2 Tenant
    • Setting up a T3 Tenant
  • ⚙️Basic Configuration
    • Accessing Admin Options
    • Updating Company Information
    • Configuring Outbound Email Settings and Email Alerts
    • Configuring Global Account Settings
    • Managing Mail Server Connections
    • Configuring LDAP Settings
    • Managing Email Domains
    • Managing Email Addresses
    • Configuring Email Collector
    • Configuring SMTP Service Settings
    • Downloading / Emailing System Logs
    • Managing Exclusion Rules
  • ⚒️Advanced Configuration
    • Enabling Premium SSO
    • Configuring OAuth Connection Settings
    • Configuring Google Workspace OAuth and Service Account
    • Configuring Okta
      • Configuring Okta with SAML
      • Configuring Okta with SSO
    • Configuring Advance Company Settings
    • Setting Retention Period
    • Setting Search Date Limit
    • Setting Report Consolidation Period
    • Setting Case Folder Configuration Limits
    • Configuring Global Settings
    • Configuring SMTP Settings
    • Configuring Web Security Settings
    • Configuring System Alert Settings
    • Managing LDAP Search Filters
    • Viewing Company Summary
    • Managing Date Formats
    • Managing Headers
    • Configuring Error Email Respool Settings
    • Configuring De-Duplicated Email Respool Settings
    • Configuring Excluded Email Respool Settings
    • Configuring Windows File Share Settings
    • Tenant Deletion Procedure
    • Adding Custom Scripts to your Archive
    • Setting up Stubbing
    • OAuth Setup with Solar Archive
  • 🗃️Using the Archive
    • 🔎Search
      • Searching your Archive
      • Saving your Search
      • Sharing your Search
      • Filtering Search Results
      • Search (Classic Interface)
    • 📦Spaces
      • Creating a Space
      • Adding to a Space
      • Sharing a Space
    • 📄Results
      • Downloading a Single Result
      • Downloading Multiple Results
      • Printing Results
      • Result Headers
      • Forward Results
      • Restore Results
      • Saving to Space
      • My Archive
    • ⏳History
      • Saved Searches
      • Recent Search History
  • 🔐Legal Hold
    • Creating a Legal Hold Request
    • Managing Legal Hold Requests
  • 🗑️Authorised Delete
    • Requesting a Deletion
    • Managing Deletion Requests
  • 🏛️Archive Management
    • 🧲Importing Data
      • 📥Mailbox Reader
        • Creating a New Mailbox Reader Import
        • Monitoring Mailbox Reader Imports
      • 🗂️Configuring Folder Replication
        • Getting Started
        • Configuring a new Connection for Folder Replication
        • Monitoring Folder Replication
        • Completion of Folder Replication Process
        • Using Folder Replication
    • 🎨Branding
    • 💰Billing
      • Monitoring Usage
      • Submitting Reports
  • 🔌Outlook Add-in
    • Local Add-in Install
    • Centralised Add-in Install
    • Introduction to the Outlook Add-in
    • Searching via the Outlook Add-in
    • Pinning the Outlook Add-in
    • Continuing your Add-in Search on the Archive Interface
  • 🛰️Release Notes
    • 26-01-2024 (v9.4.4-b69-00)
    • 11-10-2023 (v9.4.4-b52-00)
    • 10-05-2023 (v9.4.4-b52)
    • 06-03-2023 (v9.4.4-b50)
    • 20-01-2023 (v9.4.4-b46)
    • 06-05-2022 (v9.4.4-b29)
    • 28-01-2022 (v9.4.4-b21)
    • 09-12-2021 (v9.4.4-b15)
    • 15-10-2021 (v9.4.4-b14)
    • 05-10-2021 (v9.4.4-b12-00)
    • 30-07-2021 (v9.4.3-b8)
    • 18-05-2021 (v9.4.3-b7)
    • 19-02-2021 (v9.4.3-b1)
    • 04-02-2021 (v9.4.2-b20)
    • 15-01-2021 (v9.4.2-b17)
  • OAuth setup with Office 365
Powered by GitBook
On this page

Was this helpful?

  1. Advanced Configuration

Configuring Error Email Respool Settings

How to configure your archive's error email respool settings

An email may occasionally error in the Solar Archive server for a number of different reasons and at any point in the processing sequence. To prevent such emails from failing due to intermittent issues, like network connectivity or LDAP connections, the system will automatically respool some classes of erroring email. These emails will be re-processed up to three times before they fully error. There will be a delay of some hours between each reprocessing attempt.

If, after any respool attempts, an email errors, the Solar Archive server will:

1. Preserve the source email file in an Error directory on the primary Solar Archive system.

2. Preserve the cause of the error (known as a stack trace) alongside the error email file.

3. Send an error alert for the first email that errors with a particular ‘class’ of error that day.

4. Send a summary report each day, indicating the number of errored emails.

5. Error emails are grouped into ‘exception classes’. The class relates to the cause or reason for the item that has errored.

The Error Email Manager provides visibility to the headers of mail that failed to successfully process into the archive. It also shows the cause of the error (the stack dump).

Errors may occur at any part of the processing path for an email. Here are some key points:

  • Read and validate an email file. A number of key attributes (message-id, date, sender etc.) are determined at this stage. An invalid/unreadable email file will error under the “Unknown-Account” error section.

  • The Email Date is critical because emails are stored in date based data stores, for efficient search and recovery. If the Date: header in the email is not of the RFC822 standard format, or is very old (before 1st Jan 2000 or before any retention period), then the email will error. Solar Archive can use the date found in a “Received: From” header – which is stamped with the date/time of the sending email server.

  • For Unwrapped emails: Expand Email addresses via LDAP. This de-aliases any local email addresses (convert any secondary email addresses to the primary email address); and then if the address is a distribution group, then expand these to list all recipients of that group. LDAP related errors may occur at this point.

  • Encrypt & Compress the email and Store the email and ‘envelope’ recipient data. Errors are unusual at this stage, but may occur when obtaining or storing the email identifiers and message-id into a database.

  • Extract the keywords from the email text and attachments. Store this in a Lucene Index. Errors with keyword extraction / attachment reading and Index issues will occur here.

  • If there is a Mirror server, repeat the store and index processes on the Mirror. Errors with communication and connectivity to the mirror, as well as processing errors, can occur at this stage.

The Error Email Manager provides visibility to the headers of mail that failed to successfully process into the archive. It also shows the cause of the error (the stack dump) which helps you decide the action to be taken on these emails.

The Error Email Manager groups issues under the Company name or the “Unknown-Account”. And then further groups under the Exception Class name which caused those emails to error.

Configuring Error Email Respool Settings

  1. Navigate to Email Management > Error Email Manager.

  2. Enter / Select the required values in the fields. Refer to the table below for field names and descriptions.

  3. Click the Apply button.

  4. The respool settings for error emails will be configured successfully.

Field
Description

Include Respool Error

Specifies whether or not the respool error message should be included.

Message to Respool - All

Specifies whether or not messages should be sent to respool.

Apply Action

Action to be applied on error emails. The option available are: Normal Respool - It simply moves the error items back into the spool queue where they will be re-processed. This option can be used when some action has been taken to resolve the issue. Respool using date from ‘Received’ header - It is for a group of emails that have errored due to a date related issue. Delete - It will remove all mails from the selected error classes, with an associated audit report.

PreviousManaging HeadersNextConfiguring De-Duplicated Email Respool Settings

Last updated 2 years ago

Was this helpful?

⚒️