Diagnostic Logging
A diagnostic log is a detailed report of what the program is doing and it is used to diagnose problems. When you are requested to submit logs you need to enable logging. When finished you can continue logging or disable logging as shown below.
Wiki: TOC, VTOC, Home
Forum: Home, Gen, L4, Mac4
Videos
Logging in Logos4
See Also
Bug Report
Uploading Logs
Page Contents
PC
How do I get a diagnostic Log?
To turn on logging for one session, hold down the CTRL key as you start Logos 4 (it will also permit you to open to a blank layout).
If that is not clear or working, watch this video http://vimeo.com/8230899 or see Starting from desktop.
To permanently enable logging, run (Open) this Java script by clicking on it: EnableLogging.js.
It should display a dialog box saying “Logos 4 logging has been enabled”.
Log files are written to (My) Documents\Logos Log Files
To disable logging, run (Open) by clicking on DisableLogging.js.
If you tried to use the Java script, but that file opens in an editor/just shows you text.
Download the script file by right-clicking on its title above, choose “Save Link As...” or “Save Target As...” and Save it in (My) Documents\Logos Log Files (create the folder if necessary).
Double-click EnableLogging.js to turn logging on and double-click DisableLogging.js to turn logging off.
I can’t run JavaScript. What’s that script really doing, anyway?
To enable logging
Copy the following three lines into Notepad:-
Windows Registry Editor Version 5.00
[HKEY_CURRENT_USER\Software\Logos4\Logging]
"Enabled"=dword:00000001
Save as “EnableLogging.reg”
Note that Notepad will probably append “.txt” to that name, so you’ll have to rename the file as EnableLogging.reg from within Windows Explorer (right-click on it and select Rename).
Double click on that newly saved file, accept the change, and logging will be enabled.
To disable logging
Copy the following three lines into Notepad:-
Windows Registry Editor Version 5.00
[HKEY_CURRENT_USER\Software\Logos4\Logging]
"Enabled"=dword:00000000
Save as “DisableLogging.reg”
Note that Notepad will probably append “.txt” to that name, so you’ll have to rename the file as DisableLogging.reg from within Windows Explorer (right-click on it and select Rename).
Double click on that newly saved file, accept the change, and logging will be disabled.
What do I do with them?
Most often you will be asked to upload the logs to the Forums but they can also be used in conjunction with a Bug Report.
Note that the logs are overwritten each time you start Logos 4, so it’s best to rename or capture the logs before you start Logos again. It also helps to compress (zip) the log files before you upload them as they can be very large.
How do I “zip” my log file(s)?
- You will find the log file(s) in a folder called Logos Log Files inside your Documents folder (My Documents in XP). You might find one or more of the following files: Logos4.log, Logos4Error.log, Logos4Indexer.log, PrerequisitesInstall.log, DigitalLibraryInstall.log, Logos4setup.log.
- Select whichever log files are appropriate to upload (PrerequisitesInstall.log, DigitalLibraryInstall.log and Logos4setup.log if the problem happened during installation/setup; Logos4.log and Logos4Indexer.log if the problem happened during indexing; or Logos4.log & Logos4Error.log. Otherwise zip whatever files a Logos support person asks you for). To select multiple files, click to select the first one, then hold down the Ctrl key while clicking on subsequent files.
- To zip the selected files in Win 7 or XP:
Right-click on any one of the selected files; choose “Send To”; choose “Compressed (zipped) Folder”. A new file will be created named with the .zip extension and the icon will look like a folder with a zipper on it. The part of the filename before the .zip will depend on which log file you selected first (rename it if necessary).
- To zip the selected files in Vista:
Right-click on any one of the selected files; choose “Add to archive...”; under Archive Format, select ZIP; click OK. This will create a file called Logos Log Files.zip.
Mac
Diagnostic logging was enabled until Logos 4.3 Beta 5 (version 4.30.0.0586), when default was changed to match PC to improve performance.
Forum Logos 4 Mac AppleScript Applications has an AppleScript application that displays current Diagnostic Logging setting; if Logos 4.3 Beta 5 or newer is installed, then have option to change Diagnostic Logging setting.
Enable Mac logging for one session
Caveat: Logos 4.5b on Mac has a regression so using command key fails to enable logging.
To turn on logging, launch Logos 4 Mac, then quickly press and hold command key until Sign In appears, release command key. Optional: click “Use Blank Layout” Click Sign In
Enable Mac logging always
- Quit Logos 4 Mac application
- Open Terminal (inside Utility folder in Applications)
- defaults write com.logos.Logos_Bible_Software_4 LoggingEnabled -bool YES
Note: use defaults read command to display current setting, value of 1 means Logging is Enabled
- defaults read com.logos.Logos_Bible_Software_4 LoggingEnabled
- Launch Logos 4 Mac
- Optional – Quit Terminal
Disable Mac logging always
- Quit Logos 4 Mac application
- Open Terminal (inside Utility folder in Applications)
- defaults write com.logos.Logos_Bible_Software_4 LoggingEnabled -bool NO
Note: use defaults read command to display current setting, if “does not exist” or value of 0, then Logging is Disabled
- defaults read com.logos.Logos_Bible_Software_4 LoggingEnabled
- Launch Logos 4 Mac
- Optional – Quit Terminal
Up to FAQ