William C. McCain - Independent Software Vendor
 
Product Support: Disc Library · Music Library · XM Control

Disc Library Product Documentation
Quick Start         User Guide         Technical Reference         Sample AMX Code

Music Library Product Documentation
Quick Start         User Guide         Technical Reference         Sample AMX Code

XM Control Product Documentation
Quick Start         User Guide

User-Contributed Tools & Skins:               Click Here

Troubleshooting: Questions & Answers

Q. When I try to run SETUP.EXE, it shows an error message and then quits. The error message looks like this:

A. This message indicates that the setup program could not find javaw.exe installed on your computer. That means that you apparently have not installed the Java Runtime Environment (JRE) before installing Disc Library or Music Library or XM Control. Please install the JRE (1.5.0 or later is recommended, although 1.4.0 or later is supported) and then re-run the SETUP.EXE program. The JRE is available as a free download from http://www.java.com.




Q. Your product appears to install successfully (the SETUP.EXE program finishes with no error messages). However, there are no shortcuts installed on my Desktop, and when I look at your product's Program Group folder in the Start Menu, it has only entries for the documentation and the "uninstall" program. What gives?

A. This situation occurs when Java 1.4.x is the most recent version of Java installed on your computer. The best solution is to install Java 1.5.0 or later (also known as Java 5 or later) and then re-install our product. The latest version of Java is available as a free download from http://www.java.com. (It is not necessary to uninstall our product before re-installing it.)

If you absolutely must use Java 1.4.x, please contact us by email and we will send you specially customized shortcuts that will access the programs that you have already installed. We will need to know the exact version of Java that you have on your computer, for example "1.4.0_03". You can find this by looking in your "C:\Program Files" folder. Look for a subfolder with a name similar to this:

C:\Program Files\Java\j2re1.4.0_03




Q. When I double-click on a Disc Library or Music Library or XM Control shortcut on the Desktop or in the Start Menu, either nothing happens, or an error message flashes by so quickly that I can't read it, or I get the following error message:

A. This usually indicates that the setup program found an older version of Java on your computer and it has put the path to that older version in the "Target:" field of all the shortcuts that it generated. This problem will not happen if you have a reasonably up-to-date version of Java properly installed on your computer (Java 1.5.0 or later, also known as Java 5 or later). The best solution is to install Java 1.5.0 or later and then re-install our product. The latest version of Java is available as a free download from http://www.java.com. (It is not necessary to uninstall our product before re-installing it.)

Another way to fix this problem is to manually edit the shortcuts to point to the correct version of javaw.exe. (This solution is possible only if you actually do have Java 1.4.0 or later installed on your computer.) Right-click the shortcut, click "Properties", and then edit the "Target:" field. The first portion of the "Target:" field is the complete path to javaw.exe, usually contained in double quotes. A typical example of a correct path is:

"C:\Program Files\Java\j2re1.4.0_03\bin\javaw.exe"




Q. I can't get Apple iTunes AAC files to import or play in Music Library. The AAC file types M4A, M4B, and M4P do not appear in the Import Music Files dialog or the Add One Music File dialog.

A. You must install QuickTime (6.4 or later) on your computer to enable the iTunes AAC music file support. QuickTime and iTunes are free downloads from http://www.apple.com/itunes/. (QuickTime is automatically installed when you install iTunes.)

When QuickTime is installed, it places an interface file named QTJava.zip in the lib\ext subfolder of your Java run-time library. If you installed Java after you installed QuickTime, this file will not be in the Java library. Also, if you have more than one version of Java installed on your computer, the QTJava.zip file may have been installed in a different Java library than the one that Music Library is using. (This is the most common reason for Music Library not activating the AAC music file support.)

To fix this problem, it will be necessary to locate the QTJava.zip file and copy it into the Java library that Music Library is using. When QuickTime is installed, it places a copy of the QTJava.zip file in the following folder:

C:\Program Files\QuickTime\QTSystem

To determine where to copy this file, right-click the Music Library Master shortcut, click "Properties", and then look at the "Target:" field. The first portion of the "Target:" field is the complete path to javaw.exe, usually contained in double quotes. A typical example looks like this:

"C:\Program Files\Java\jre1.5.0_04\bin\javaw.exe"

Using the above path to javaw.exe as an example, you would need to copy the QTJava.zip file into the following folder:

C:\Program Files\Java\jre1.5.0_04\lib\ext

After you have copied QTJava.zip into the above lib\ext folder, a listing of that folder should look something like this:

    QTJava.zip           1,179,993  WinZip File          10/17/2005 06:06 PM
    localedata.jar         797,371  Executable Jar File  06/03/2005 03:00 AM
    dnsns.jar                8,176  Executable Jar File  06/03/2005 02:00 AM
    sunpkcs11.jar          175,414  Executable Jar File  06/03/2005 01:18 AM
    sunjce_provider.jar    153,235  Executable Jar File  06/03/2005 01:18 AM




Q. I am running your product under Windows Vista. When I start the program, the screen flashes a lot and the following balloon pops up:

A. This indicates that the most recent version of Java installed on your computer is Java 1.5.x or earlier. Under Vista, you must install Java 1.6.0 or later (also known as Java 6 or later). The latest version of Java is available as a free download from http://www.java.com. After you install Java 1.6.0 or later, you must update the shortcuts to our product so that the "Target:" field in each shortcut refers to the new version of Java. The easiest way to do that is to simply re-install our product. (It is not necessary to uninstall our product before re-installing it, and all your configuration and database files are preserved whenever you re-install or uninstall the product.)




Q. I have Disc Library or Music Library or XM Control configured for "remote support", and I'm running Windows Vista (or Windows XP with Service Pack 2 installed). When I start the Master, I get a message from the Windows Firewall. Windows Vista says that certain features of the application have been blocked. Windows XP says that an unauthorized application, javaw.exe, wants to accept incoming network connections, and this is a security exposure. What should I do?

A. There are several ways to deal with this situation. The easiest way is to click the button that tells Windows to unblock the application (this allows javaw.exe to accept network connections).

To see a list of programs that have been unblocked, you can double-click on the Windows Firewall icon in the Control Panel. (Under Windows Vista, you must, in addition, click a link entitled Allow a program through Windows Firewall. You will find this link near the upper-left corner of the main Windows Firewall dialog panel.) Then you will see a dialog panel similar to the following (all the following examples are taken from Windows XP):

Note that javaw.exe is now listed as a potential "exception", and its entry is checked, which means that it is now authorized to accept network connections. However, listing javaw.exe as an exception not only authorizes Disc Library or Music Library or XM Control to accept network connections, it authorizes all Java applications to do so. That is because Java applications look like data files to the operating system, they all share a single executable program, which is javaw.exe (also known as the Java Virtual Machine). Since Java programs are not truly "executable code", Java is a very unlikely language for somebody to use for writing a malicious program such as a virus or Trojan horse. But that does not mean it will never happen!

This "exposure" is okay if your home network uses a router that translates a "private IP address space" into a single shared external IP address used by your DSL or cable modem. In that case, network applications such as Disc Library or Music Library or XM Control are "invisible" to the outside Internet; they can accept network connections only from other computers on your home network.

On the other hand, if your home network uses a block of externally visible "static" IP addresses, you need to be more cautious. In that case, you should consider adding more protection to the javaw.exe entry in the Firewall exception list. If you select the javaw.exe entry and click the Edit... button, you will see the following pop-up dialog:

Then click the Change scope... button and you will see this next dialog:

Initially, the above dialog will have the "Any computer" option selected. As you can see, we have selected the "My network (subnet) only" option. This is secure enough for almost any situation. However, if you want to restrict javaw.exe even further, you can enter a "Custom list" of specific IP addresses that will be accepted.

There is another approach to Firewall security that is even safer than listing javaw.exe as an exception. The second approach is to list the Master's IP ports as exceptions, rather than the Java Virtual Machine program. In this case, you do not click the button that tells Windows to allow javaw.exe to accept network connections. (If you have already done so, you can delete javaw.exe from the exception list in the Firewall panel.) This method requires adding "port exception" entries to the Firewall exception list. You must do this before running the Master program, as Windows will not prompt you for this option. First, double-click on the Windows Firewall icon in the Control Panel, and then click the Add Port... button. You will see the following dialog, which we have shown filled-in, using Disc Library's (and Music Library's) default IP port number:

(If you a configuring the Firewall for XM Control, the default IP port number is 65519.) Then save the above entry and (for Disc Library or Music Library) click the Add Port... button again. Fill in a second "port exception" entry as follows:

(If you are using Disc Library's or Music Library's support for DMX satellite radio, you will need a third entry, with IP port number 65521.) For added security, you probably should click the Change scope... button on each of these "port exception" entries. Then you can restrict them to "My network (subnet) only", exactly as was shown above for the javaw.exe program. After you have saved both "port exception" entries, your Windows Firewall panel will look something like this:

Note that there are other ways to configure security exceptions in the Windows Firewall, by using the Advanced tab. We tried that, but we could not get it to work. That probably just means that Microsoft's documentation is unclear.

Support Issues:    support@metaconnect.com

Music Library Version 2.5  •  SAVR3 Adapter  •  William C. McCain

           William C. McCain
Independent Software Vendor
      Music Library Version 2.5