Media Center Troubleshooting Guide: Difference between revisions

From wiki.jriver.com
Jump to navigation Jump to search
No edit summary
(Redirected page to Troubleshooting Guide)
 
(40 intermediate revisions by the same user not shown)
Line 1: Line 1:
#REDIRECT [[Troubleshooting_Guide]]
Media Center is usually a well-behaved application. Many users on [http://yabb.jriver.com/interact/index.php Interact] have it installed on a wide variety of known-stable hardware, and for most users it runs trouble-free with little needed system modification. However, MC is also a powerful application. It has a high-speed database at its core, that is custom designed to do what it does with the lowest possible latency. And, of course, it has a raft of options, some esoteric, and supports an immense amount of weirdo, high-end, often misbehaving, nerd hardware.

And, of course, it runs on a computer. Which is... Well, a computer. So it is subject to all of that regular stuff too.

This guide is designed to assist users in solving some of the more common issues we encounter that impact performance and reliability within Media Center. This will not address every possible issue. However, it will cover many of the more common cases we see in the real world.

= What This Document Covers =

This document is intended to cover troubleshooting steps that can be used to address problems with Media Center including:

* Crashes
* Dead Locks and Hangs
* Other related performance issues (stuttering, hiccuping, etc)

It is ''not'' intended to cover playback quality issues, which are addressed elsewhere on this Wiki and on Interact.

= First Steps =

Before you do anything else, there are a few common steps that apply to pretty much all issues, and we will cover these items first. '''Before you post about your issue on Interact, please ensure that you have worked through at least these steps.''' That will ensure we don't waste time covering something that is already addressed here.

== Make Sure You Are Running the Latest Build ==

The version of MC available on the [http://www.jriver.com/download.html main external JRiver Download Page] is not always, or even typically, the most recent build. The versions offered there are generally older builds that have proved reasonably trouble-free for most users. The version there is the same version that will be seen by the built-in Auto Update system in Media Center. Updates to this build only happen occasionally, if for no other reason than it isn't annoying that it pops up the "Update Me" dialog as often.

However, there are also public builds available on Interact. There generally come every week or so (though this timing fluctuates throughout development). You can get these by either:

# Go to: <span style="color:#8B4513">Options > Startup > Update Channels</span> and change it to Latest.
# Download them manually from Interact. The latest build is always "pinned" inside a thread at the top of the main board for your particular version of MC (such as: [http://yabb.jriver.com/interact/index.php?board=32.0 JRiver Media Center 19 for Windows], or [http://yabb.jriver.com/interact/index.php?board=36.0 JRiver Media Center 19 for Mac]). When you open the board, it will appear as a thread near the top, and will contain the build notes and a download link for the build.

[[File:MC19-Build_Thread_Example.png|frame|none|Showing an example of a pinned build thread on Interact.]]

It is essential to update to the most recent publicly available build of Media Center before reporting the issue (or trying additional steps to correct it). Otherwise, if the issue has been already addressed, you are only wasting everyone's time.

''Note:'' You can typically install new builds "over top" of existing installs of MC. However, if you are having trouble, a good troubleshooting step would be to try to uninstall MC completely, and then reinstall. The uninstaller does allow you to preserve all existing settings when doing this.

== Know What Type Of Misbehavior You're Seeing ==

When attempting to diagnose or report an issue, it is important to use consistent terminology to describe the situation you are encountering. Throughout this guide, if MC is:

'''Crashing'''

This is when an application forcibly exits without giving you an opportunity to respond. It will almost always show an error dialog of some kind (either as the last, dying gasp of MC itself, or from the OS), but it is non-recoverable and it ends the application immediately. The error message will often be something like: "Media Center XX.exe has encountered an error and needs to close" on Windows, or on OSX the OS says "X application quit unexpectedly".

'''Hanging'''

This is when an application's UI becomes unresponsive. The program might be still working, but if so and it goes on long enoug, it has either: forgotten to update its UI thread, or its UI thread is blocked for some reason. Windows will often show the "Application X" is not responding dialog box, but in this case you are able to either force it to quit, or wait longer to see if it comes back to life. In many cases, the application does eventually "come back to life". In some cases, an application really is "deadlocked". With multi-threaded applications like MC this usually means that two competing threads are both waiting on the same resouce, and stuck in an endless loop. Nothing ever really "goes wrong" (as far as the application can tell), but it gets stuck.

'''Blue Screen, Kernel Panic, or Sudden Reboot'''

These types of crashes always indicate a ''hardware'' issue or system corruption. They can be caused by bad drivers that need to be removed or updated, broken hardware, or a broken OS installation. In any case, if your entire machine actually crashes and has to reboot, suddenly, then MC itself ''cannot'' be the cause. MC might be, in these cases, the catalyst that exposes an otherwise possibly unnoticed issue, but it cannot (as in, the OS doesn't give it the power to) actually cause one of these errors. Only privileged code can do that (drivers and OS code, for example).

'''Stuttering, Hiccuping, or Quality Of Playback Issues'''

These are other, sometimes related, types of issues. For the most part, we won't address "quality" issues here. However, hiccuping or stuttering during playback is sometimes related and might be resolved by these steps.

== System Requirements ==

Please ensure that your computer meets the [[Installation_%26_Removal#System_Requirements|system requirements for Media Center]].

Later, if you suspect that you might be running into the general performance limits of your computer, it might be useful when asking for advice on the forum to provide:

# The results of the ''Benchmark'' under <span style="color:#8B4513">Help > Benchmark</span>.
# The contents of the ''Reporter'' under MC19. In the [[Organization_Tree|Tree]], open <span style="color:#006400">Services & Plugins > Reporter</span>. Then click the Copy to Clipboard button in the header on the right hand side, and paste it into a thread wrapped in code tags (after you paste the text in, while it is still selected, click the # button on the forum posting toolbar).

[[File:MC19_Reporter_Post_Example.png|thumb|700px|none|An example showing how to post the contents of MC19's Reporter function on Interact, wrapped in Code Tags.]]

== Enable Logging ==

MC includes a very thorough logging system that can help diagnose issues (especially crashing). But, for it to work, you have to turn it on first.

# With MC running, go to: <span style="color:#8B4513">Help > Logging</span>.
# Enable the ''Output to a Log file'' option.

If you enable this and then can recreate the issue, the Log might show the issue and help the JRiver staff to diagnose your particular issue.

== Make a Library Backup ==

Before you do ''anything'' to your system to diagnose these kinds of issues, make a Library Backup in Media Center. This saves the entire contents of your Library, along with all of MC's settings, and allows you to restore them later (or only one or the other, if you need to). Some of the "more advanced" steps we'll get into can require clearing your Library, or uninstalling MC entirely. Make sure you have a backup!

# Go to <span style="color:#8B4513">File > Library > Backup Library</span>
# Save the backup ZIP file somewhere safe where you'll be able to find it, and give it a clear filename.

''further information:'' [[Library_Manager|Library Manager]]

== Test To See If the Trouble Is Security Software Related ==

By far, the most common cause of performance-related issues such as hanging, stuttering, and hiccuping is interference by an Anti-Virus application, or similar security software. The first thing is to try to determine if a security application on your system is causing the issue.

'''The simplest and most effective means to rule the Anti-Virus program in or out as the root cause is to completely uninstall it, reboot, and then test MC in this state.'''

While most AV programs can be "disabled" somehow via their settings, this often does not disable all the behavior of the application (and so sometimes will seem to have no, or a limited, impact, when uninstalling reveals that it was the cause). Unfortunately, these "disable" settings can't be "trusted" in many cases. To be perfectly clear, the idea of this step is not that keeping the anti-virus application uninstalled is the solution. This is a test to indicate, once-and-for-all, it the issue is security software related.

'''Before reporting any issue that leads to a crash or non-responsiveness in Media Center, please try to reproduce the issue with your security software completely uninstalled.'''

''Note:'' If you are using Windows 8's Windows Defender, you cannot uninstall it, so just disable it (this works well with Defender, typically).

Be sure to record any serial numbers you need for your application, obtain the latest version of the installer (from the vendor's website, typically), and then completely uninstall the application however the vendor recommends (on Windows, typically via the Add/Remove Programs Control Panel). If the problem goes away (make sure to reboot), then you've found your cause. If not, then probably move on to something else.

If you determine that your Anti-Virus application is the cause of the issue, you will need to exclude Media Center and some of its associated auxiliary processes and locations from the software's activity. There are more details available about this process found under Next Steps below. We would also recommend that you report this behavior to the vendor of your particular software package.

== Disks and Locations ==

Media Center generally does not care where the media files it uses are stored on disk (whether internal, external, network, or any other volume you can mount in your OS). However, there are a few things to consider, especially if you are using a "slow" disk, such as a network or external disk.

=== Library Location on Disk ===

One area where Media Center does require as much performance as is possible is on the disk where its Library is stored. It is best to store this on the highest performing disk that is possible in your computer, especially if your computer has an SSD. Media Center's Library is not excessively large (the author's current library is 103MB with 119K files, for example), so size is not typically a serious constraint. '''Using a Library stored on a slow disk ''will'' degrade performance.'''

''Please Note:'' Whenever MC refers to "the Library" it '''does not''' mean the media files themselves. Instead, the Library refers to the database MC uses as its back-end.

By default, MC stores the library in your user profile's AppData directory, here:
* Windows: <tt>C:\Users\<username>\AppData\Roaming\J River\Media Center 19\Library</tt>
* OSX: <tt>/Users/<username>/Library/Application Support/J River/Media Center 19/Library</tt>

If you aren't sure where your current Library is stored, you can check its location using the [[Library Manager]] under Playing Now in the Tree.

Storing the Library on a network volume, slow "media drive", or external disk is not recommended. Whenever possible, it is better to store the Library on a fast, internal disk (or high-performance RAID volume), and access the media itself stored elsewhere (on a NAS, big external disk, etc). If needed, use the built-in Library Server functionality to share your Library with other machines. This system uses a local cache of the connected server's Library, which allows it to still have fast access, and it periodically syncs any changes with the server.

=== Media Files On a Slow or Network Disk ===

While we said that Media Center doesn't care where the media files themselves live on disk, if the storage where they're stored is unreliable in some way, it can certainly cause trouble. If you are having playback related issues and the media files are on a slow, network, or external disk:

# Copy a few of the misbehaving media files over to a fast, internal disk (such as your system drive).
# Try to reproduce the issue.
# If the issue vanishes, then you know the source of the issue is probably something to do with the place where the files are stored, and can investigate solutions to those issues.

One other issue you can encounter relates to a particular option in MC. If many of your media files are stored on a slow external or network disk which often "disconnects" (or goes to sleep), performance in MC can suffer when viewing large lists of files. If you have your files on a slow disk like this, and you find that MC hangs for a long while when first launching, or when first opening a particular view in the tree, then try:

<span style="color:#8B4513">Options > Tree & View > Advanced > Display missing file image in lists</span>: Disable

This option enables or disables the little red Xs that show up overtop of the icons or thumbnails for files that are missing from disk. This is a nice option to have enabled (because it immediately alerts you to files missing from disk), but it can be very slow if the files are on a "bad" disk.

= Next Steps =

Once you've completed the First Steps detailed above, please feel free to post a question about your issue on Interact. It is ''always'' best to post in a new thread specific to your issue, unless you see a recent thread from another user who is experiencing what seems to be the ''same exact issue''.

''Please Note:'' If you are very confident that you've found a bug that is ''non-specific to your computer'', then please post this report in reply to the most recent Build Thread on Interact. If you aren't sure, start a new thread on it and ask. JRiver staff monitor both the build threads and the forums in-general.

== Things To Include In Your Post On Interact ==

* The full version number of MC you are using.
* A description of the issue.
* Step-by-step instructions on how you reproduce the issue (whenever possible).
* The steps you've taken to investigate or address the issue (see above).

== Troubleshooting Guides ==

This section will provide links to step-by-step guides additional common troubleshooting steps. These are not all general purpose (not everyone should do all of these things), but we will try to cover the most common cases.

=== Tame Your Anti-Virus ===

''Applies To:''
* Potentially all issues

''Description:''<br>
If, [[Media_Center_Troubleshooting_Guide#Test_To_See_If_the_Trouble_Is_Security_Software_Related|after testing]], you've determined that the problem does lie with your Anti-Virus application, you'll want to set it to "exclude" a set of locations and programs that are used by MC and need to perform well. We can't, obviously, address every single AV application out there, but we'll use Windows Defender as an example. If you don't have Windows Defender, you want to try to exclude the same "things" in your own particular AV application.

''Guides:''
* [[Taming Windows Defender]]

=== Check Your Audio Setup ===

''Applies To:''
* Potentially all issues

''Description:''<br>
A frequent cause of trouble is a misconfigured, or misbehaving, audio device. If you've messed with a bunch of settings in there, or you are using a more esoteric hardware setup, then you might just have to tweak something.

'''Try:'''

# Work through the [[Audio_Setup|Audio Setup Guide]]
# Disable any DSP items you've enabled (perhaps one at a time), to see if one of them is causing the issue.
# If you can, try different audio outputs on the computer, to see if one in particular is having issues while others work.
# Make sure the device at the other end (speakers, receiver, DAC, etc) is functioning properly, set to the right inputs, etc. Try other sources on the same input.

If necessary, you might also try:

Disable any audio devices that might be misbehaving. Sometimes doing this through the Device Manager in Windows works, and sometimes it doesn't and you must physically disconnect the device. With external devices, like USB DACs, unplug it from the PC and try the same thing using the PC's built-in audio.

In many of these latter cases, a driver update (or rollback) will be needed. However, it could just need to be removed and re-added (or uninstalled and reinstalled).

=== Check Your Video Setup ===

''Applies To:''
* Video playback issues

''Description:''<br>
If the issue is with Video Playback, it is worth checking over your Video setup as well.

''Guides:''
* [[Troubleshooting Video Options]]

=== Check Your Drivers ===

''Applies To:''
* Audio and Video playback issues
* Theater View issues
* Crashing
* Blue-screen and Kernel Panic crashes

''Description:''<br>
If the issue is with Video Playback, it is worth checking over your Video setup as well.

''Guides:''
* [[Troubleshooting Drivers]]

=== Check Your Disks and OS For Trouble ===

''Applies To:''
* Potentially all issues

''Description:''<br>
If the issue is with Video Playback, it is worth checking over your Video setup as well.

''Guides:''
* [[Troubleshooting Disks]]

Latest revision as of 23:07, 24 March 2014