For users who experience difficulties with Web Start or who wish to download just the basic program and run it direct from the application's jar file urvall.jar, the steps described below can be used. To differentiate between this method of running the program from UnravelJ WebStart (the title for the application when run from WebStart), the method here will be referred to as UnravelJ Direct. All users can run UnravelJ Direct uninstalled. Windows users are provided with the option of running UnravelJ Direct installed.
UnravelJ Direct Uninstalled (all users)
To set up for running UnravelJ Direct uninstalled, zip file UnravelJ.zip needs to be downloaded from the web site. This file may be unzipped anywhere. To be able to run the program, the user must have Java Runtime Environment (e.g. jre7 or jre8 which may also be referred to as jre1.7.0 or jre1.8.0). For those running Windows, it is recommended that the extracted UrvbaseJ directory and files be placed in:
C:\ProgramData\KFFraser Software\Java Unravel\
and for Unix and Linux users they could be placed in:
/ProgramData/KFFraser Software/Java Unravel/
for conformity with that used for Web Start. Any new folders would need to be created. The Unravel program can be run in various ways two of which are outlined below:
Double click on the urvall.jar file which has been set up to be executable. Normally, when Java is installed, jar files are associated with javaw.exe with the -jar option. If that association has not been made it will need to be done before the program can be run in this manner.
Use a command line instruction. For Windows users jarRun.bat (or UnravelJ.exe that is an exe version of jarRun.bat), which is also extracted from the zip file, can be used. Non-Windows users could create their own version of jarRun.bat.
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 unravelDesktop.ico that is included in the unzipped UrvbaseJ directory.
Unravel Direct Installed (Windows users only)
Windows users can conveniently obtain an installed version of UnravelJ Direct by downloading the InstallExtnUnravelJ.zip file from the website to any directory and unzipping it. The following files will appear in the directory named UnravelJ Install:
createInstallUnravelJ.bat
zipinst.exe
Installation Instruction.htm (read before attempting the installation)
To do the installation, the UnravelJ.zip file must be downloaded and stored in the UnravelJ Install directory. The UnravelJ.zip file must not be unzipped (that will be done by the installer). When the UnravelJ Install directory has been populated as indicated above, run createzInstallUnravelJ.bat. File InstallUnravelJ.exe will be created. Run that file to do the installation. Once installed, the program can be run from any of the following:
UnravelJ Direct icon on the desktop.
Progams:KFFraser Software:Java Unravel:UnravelJ Direct from Start Menu.
C:\ProgramData\KFFraser Software\Java Unravel\UrvbaseJ directory by double clicking the UnravelJ.exe file.
While the same default directories are used for UnravelJ WebStart and UnravelJ Direct, they can share the same directories and still run independently. If some of the directories required for the installation already exist, the ZipInstaller installation program will respond with "The folder already exists, do you want to continue anyway ?". Users must answer Yes to allow the installation to proceed.
The application, which is listed as UnravelJ Direct, can be uninstalled via the Control Panel: Settings or by the Start Menu shortcut:
Start Menu: Progams: KFFraser Software: Java Unravel: Uninstall UnravelJ Direct
The uninstallation instructions are stored in file uninst1~.nsu in the Java Unravel directory. If the program has been run, it will install further sub-directories and files that will not appear in the uninstallation instructions. Any added files or directories can be removed manually by deleting the Java Unravel directory. Users should not delete any directories if they are still running the application from UnravelJ WebStart and have saved cube state etc. data that they need to keep. Users should not delete the KFFraser Software directory if they have installed the Cpp Unravel version which has a child directory (Cpp Unravel) of the KFFraser Software parent directory.
Licence (all users)
Licence details are provided in file UrvbaseJ/licence/Licence.htm that is included in the UnravelJ.zip file.