Advanced Logging Options

Top Articles


Retrospect has a number of built-in tools to help with tracking down problems. Our support team might ask you to send them configuration files, turn on debug logging or increase the log level, edit a retro.ini setting. These instructions walk through how to do both. Do not modify the files unless our support team instructs you to.

Note – These instructions apply to Retrospect for Mac 8.0 or higher and Retrospect for Windows 7.7 or higher.


Configuration File

Retrospect keeps all of its information in a configuration file at the following locations:

  Windows – C:\ProgramData\Retrospect\Config77.dat
  Mac – /Library/Application Support/Retrospect/Config80.dat

These config files are compatible with Retrospect for Mac 8.0 or higher and Retrospect for Windows 7.7 or higher.


Logging - File

Retrospect maintains a global operations log file for all of its activities. If you encounter a problem, be sure to check the log first. The log is available in the application at Reports > Operations Log on Windows and at View > Log on Mac. The file is at the following locations:

  Windows — C:\ProgramData\Retrospect\operations_log.utx
  Mac — /Library/Application Support/Retrospect/operations_log.utx

In addition, the Retrospect Client logs to a file at the following locations:

  Windows (pre-Vista) — C:\Documents and Settings\All Users\Application Data\Retrospect Client\retroclient.log
  Windows (pre-Vista) — C:\Documents and Settings\All Users\Application Data\Retrospect Client\qtsystray.log
  Windows — C:\ProgramData\Retrospect Client\retroclient.log
  Windows — C:\ProgramData\Retrospect Client\qtsystray.log
  Mac — /var/log/retroclient.log
  Linux — /var/log/retroclient.log

  # Retrospect 10 for Windows
  Windows (pre-Vista) — C:\Documents and Settings\All Users\Application Data\Retrospect Client\qtcontrolpanel.log
  Windows — C:\ProgramData\Retrospect Client\qtcontrolpanel.log

Logging - Mac Limit

On the Mac, the Log window only shows the last 500 lines of the log by default, indicated at the top of the window. For instance, it might say [Showing 500 lines out of 21325]. To change this setting, open Preferences > Console and change "Show up to __ lines in the operations log".

Kb mac log prefs


Logging - Log Level

To increase the logging level or turn on debug logging for the server, open Secret Preferences with one of the key combination below. For the client, follow the instructions below. Our support team will give you instructions about what options to change. The changes will be effective immediately; you do not need to restart the application.

MacCommand-Option-Comma

Kb mac secret prefs

WindowsCTRL-ALT-P-P

Kb win secret prefs

Mac ClientOpen System Preferences. Hold down the command key and click on "Retrospect Client". Select "Advanced" tab.

Kb mac client prefs advanced

Windows ClientHold down the control key for three seconds. The "Advanced" tab will appear.

Kb win client prefs advanced


Logging - Size Limit

You can adjust the maximum file size of the log in Preferences.

MacPreferences > General

Kb mac log limit prefs

WindowsConfigure > Preferences > Notifications > Logging

Kb win log limit prefs


retro.ini

Retrospect provides an options file for fine-grained control of the server called retro.ini, at the following location:

  Windows — C:\ProgramData\Retrospect\retro.ini
  Mac — /Library/Application Support/Retrospect/retro.ini

If you open the file, you will see the following options by default on Mac:

  [Options]
  SetUILogging=3
  SetFoundationLogging=3
  SetAppLogging=3
  SetDevicesLogging=3
  SetEngineLogging=3
  SetVolumesLogging=3
  SetBackupSetsLogging=3
  SetNetworkingLogging=3

Our support team might ask you to change the log level here instead of through the application. Here are the steps:

  1. Turn off the server by either quitting the Windows application or using System Preferences on the Mac.

  2. Open retro.ini in Notepad or TextEdit.

  3. If our support team suggests turning on "device logging to 6", change SetDevicesLogging=3 to SetDevicesLogging=6.

  4. Save the changes to retro.ini.

  5. Turn on the server by either launching the Windows application or starting it through System Preferences > Retrospect on Mac.

  6. Be sure to change the setting back after you’ve reproduced the issue.


Instant Scan

Instant Scan has a separate set of files for configuration, logging, and options, at the following locations:

  # Configuration Files
  Windows — C:\ProgramData\RetroISA\ConfigISA.dat
  Mac — /Library/Application Support/Retrospect/ConfigISA.dat

  # Scan Files
  Windows — C:\ProgramData\RetroISA\RetroISAScans\
  Mac — /Library/Application Support/Retrospect/RetroISAScans/

  # Log Files
  Windows — C:\ProgramData\RetroISA\retroISA.utx
  Mac — /Library/Application Support/Retrospect/retroISA.utx

  # Option Files
  Windows — C:\ProgramData\RetroISA\retro_isa.ini
  Mac — /Library/Application Support/Retrospect/retro_isa.ini

Grooming

For grooming, messages are logged to the Operations Log and Execution Log. However, for detailed debugging information, you can enable a grooming log by creating a file with a specific name next to the catalog file for the set you’re grooming: "Media Set A.rbc.grm.log" if you are grooming "Media Set A". This log is limited to 1GB, and you do not need to shutdown the engine to create it.

  • On Windows, navigate to the catalog’s folder and right-click to create a text document. Name it Media Set A.rbc.grm.log.

  • On Mac, open Terminal, navigate to the catalog’s folder, and run touch "Media Set A.rbc.grm.log".


Proactive Backup

For diagnosing issues with proactive backup, you can enable a specific log for this feature to send to our support team. You will need to shutdown the engine before creating it.

  • On Windows, navigate to the application’s data folder in "C:/ProgramData/Retrospect/" and right-click to create a text document. Name it proactive_backup_log.utx.

  • On Mac, open Terminal, navigate to the catalog’s folder, and run touch "/Library/Application Support/Retrospect/proactive_backup_log.utx".


Last Update: March 17, 2015