User Reference: Troubleshooting

There is one rule that's valid for every data transformation: Keep a back-up of your original files. ALWAYS!

In general nothing can happen with your emails, except when you use "Move to Trash". So use this feature with care.

There are two kinds of problems in Mail Archiver X. Either there are problems during archival or with the Email Viewer. Or the database is corrupt.

What do you do if a crash occurs?

First you notice it. An application crash is different from a hard crash, where the OS wants to send information to Apple. Here is a screenshot of a manufactured application crash:

Error Report Window

Add a description what the problem is about and what you did before.

Mail Archiver records some data what it has been doing. This is written into "Session Log" files in the Application Support Folder. The files are deleted after 30 days. These files are sent with the email.

You can view the session logs when you select the menu item Help/View Session Logs.

View the session logs

You can also send an email at any time about an error without having the application crashing with the menu item Help/Send error report.

If for some reason you can't send an wmail you can get to the session logs in Finder with the menu item Help/View Session Logs in Finder.

Troubleshooting the Database

The menu items of File/Database gives you the possiblity to get information about your database and its problems.

  • Information: Gives information for the currently open database like the version of Valentina used.
  • Diagnose: Runs a report on the currently open database. If any problems are found they are written to the error log.
  • Open to Diagnose: Diagnoses a database, which hasn't been opened.
  • Rebuild Index: Deletes the index and creates it new.
  • Compact: Make the database smaller after deleting a lot of emails.
  • Clone: Creates a copy of the database file.
  • Open to Clone: Create a clone of a database, which hasn't been opened.
  • Dump: If the database is corrupt it's possible to use the combination Dump/Load Dump to try to fix the problems. Use Dump to save the data of the archive somewhere.
  • Load Dump: After using Dump use Load Dump to locate the dumped data and load it into a fresh database.

When you open an archive a file will be created with the name "Mail Archive.journal" if the name of your archive is "Mail Archive". This is used to protect the database from data loss in the case of a crash. Just ignore this file. Similarly, the file "Mail Archive.DBIndex" is a helper file that contains the index for the database.

Handling Database Corruption

Whenever the application crashes when accessing the database there is a risk that the database is damaged. When you restart Mail Archiver and it takes a while to open the last access archive then Mail Archiver tries to restore the data. But this doesn't work in 100% of all cases. What can you do if you get an error message after archival? This is how the error message looks:

Error message when archive is corrupt

If you ignore this message it's very likely that you are going to lose data!

Go to the menu item Database/Dump.

Next you will see a dialog to save your dump data somewhere:

Save your database dump

You will need to wait a while. Also, you need to know that resulting file will be HUGE so select a location that has lots and lots of free space. Afterwards close the open archive. Then go to the Database menu again and select Database/Load Dump.

You need to select your file that was just created.

Select a database dump

A new database will be created after you have selected a location and a name. Then the last step is done - the data is loaded.




RSS Icon

RSS Feed for Blog

Moth Software
Beatrix Willius
Walterslebener Strasse 23a
55262 Heidesheim
Phone: +49-(0)6132-509659
Contact - Imprint

@ 2003 - 2021 Moth Software

Any questions that this page didn't solve? Go to Moth Software support and ask.