Web Start Auxiliary Files

This file (WebStartAuxFiles.htm) together with Readme.htm and other auxiliary files are automatically downloaded into the UrvbaseJ directory from the program's Java archive (urvall.jar) whenever the program is first run in Web Start mode. These files could be of interest to some users but none is required for Web Start operation. Some of the files can be applied directly only in a Windows/batch file environment but it should be fairly easy for users with other operating systems to adapt them to their environment.

Auxiliary files other than Readme.htm and this file (WebStartAuxFiles.htm) are listed in the following table.

jre_path.bat

Microsoft (MS) batch file that sets the path for the Java Runtime Environment (jre) with the most recent date. It is compatible with Windows XP and later versions (both 32 and 64-bit). It is called by other Java-related batch files.

CacheExtractor.class

Java class file that is used to copy the program's files from Java's cache directory to the UrvbaseJ directory.

CacheExtractorRun.bat

MS-batch file that, when run from the UrvbaseJ directory, will run the CacheExtractor program which will copy the program's files from Java's cache directory to the UrvbaseJ directory.

jarRun.bat

MS-batch file that will launch the program directly from its jar files (urvall.jar, jh.jar and jnlp.jar) if these files are located in the UrvbaseJ directory. The program is run uninstalled and completely external to Web Start.

jwsJACV.bat

MS-batch file that opens the Java Cache Viewer from which the "Unravel WebStart" Application can be selected and launched (either off-line or on-line). At the time of writing it works for all versions of Windows from XP to Windows 8. For Windows XP, the Viewer can also be opened via Start : Settings : Other Control Panel Options : Java : Java Control Panel : General > Temporary Internet Files : View : Java Cache Viewer. The steps are similar for other versions of Windows.

jwsRun.bat

MS-batch file that will launch the program in Web Start mode from the website. Running this executable file has the same effect as a double click on the Java Network Launching Protocol urvwbs.jnlp file that can be copied to the UrvbaseJ directory by the CacheExtractor program.

Note: Usually the program will be downloaded correctly to a default cache directory but running it can present problems. The Web Start security setting needs to be set not greater than "medium" for the program to be provided with the option for the user to select to run it.

UnravelDesktop.ico

Icon that can be used, if desired, as the icon for a Desktop shortcut for launching the Unravel program.

unravel/licence/
Licence.htm

Licence.htm provides licence details that are always downloaded when the program is first run in Web Start mode. Licence details can also be observed from About Help when the Unravel program is run.

unravel/licence/
licence1.gif

Image used by Licence.htm.

unravel/licence/
licence2.css

Support file for Licence.htm.

The CacheExtractor copies the program's Java Archive (jar) files, (urvall.jar, jh.jar and jnlp.jar), and the jnlp file (urvwbs.jnlp) from the cache directory used for Web Start to the UrvbaseJ directory. Java archives jh.jar and jnlp.jar are standard Sun Microsystems files which are not included in their jre Java Runtime Environment used for the Unravel program.

The CacheExtractor presents file size and modification dates and gives the user the option to reject copying the file. When rejected, the CacheExtractor will search for another copy. Since old copies of the files are often retained in the cache, it may be worth initially running the CacheExtractor without performing any copying so that the files with the latest modification dates can be identified. The required files can be copied when the CacheExtractor is run a second time. It is good practice to delete superseded versions of UnravelJ WebStart via the Cache Viewer and simplifies the selection of files to copy.

While the files used to extract the jar files from the cache work properly at the time of writing (Jan 2014), changes to the Operating System or the Java Runtime Environment over time could render them unworkable.

If the CacheExtractor does not work for some reason, the user can locate the Java Cache directory from Java Control Panel: General: Temporary Internet Files: Settings: Location. Then search the index files (*.inx) for the jar filename (eg. urvall.jar) within the inx file and then locate a file of the same name but without the inx extension in the same directory and that will be the required jar file.

It is to be emphasized that the jar files are not required in the UrvbaseJ directory for running the program in Web Start mode. However, for those who may like to store all the files required to run the program on a CD or other removable medium, the UrvbaseJ directory would now contain everything required. CD storage of the unravel sub-directory and its child directories is not required unless the urvstart.ini file holds the user's color selection that differs from the default.

If the required jar files have been extracted from the cache, the Unravel program can be run uninstalled in various ways other than via Web Start. Two ways are outlined below:

For convenience with either of the above approaches, a shortcut to the relevant file can be created and placed on the Desktop. If that is done it is recommended that the shortcut be renamed UnravelJ Direct and that the default icon be replaced with the one supplied (unravelDesktop.ico).