3. Starting Jaikoz

3.1. General Startup Instructions

You can start Jaikoz by selecting if from the Application folder. If you wish you can add Jaikoz to the Dock and start it from there

If you do not have yet have Java 1.5 installed you will see this dialog

In which case, please download from the Apple website and retry. Otherwise unless there is a licensing problem jaikoz should now start

3.2. Java Problems

This section discusses problems starting Jaikoz due to problems with your Java configuration

Java is not recognized as an internal or external command,operable program or batch file..

There is a problem with your JRE Installation. Please ensure that Java is installed and can be found in your path

Unable to load help set

There is a problem with your JRE Installation. Please ensure that Java is installed and can be found in your path

3.3. Uninstalling Jaikoz

To uninstall Jaikoz just drag it from the Application Folder to the Trash

3.4. Memory Management

Warning this section is for experienced users of Java only

By default Jaikoz allocates a proportion of your physical memory to Jaikoz. If you are attempting to load a large number of songs you may get a warning that memory is low, you may wish toincrease the maximum value of memory than can be used you will be able to load larger amount of files if you require it. You should not set the memory to the actual amount that your system has because your computer requires some memory to run the operating system and other programs, additionally trying to load too many files may place too high a CPU load on your computer and could severely affect performance.

Jaikoz is usually run using Jaikoz.app from the Finder, but you can also run it using jaikoz.sh using the Terminal, memory is adjusted differently depending on which file you use.

3.4.1. Jaikoz.app

If you are running Jaikoz you need to modify the value of -Xmx within the Info.plist

  • Go to where you installed Jaikoz

  • Show pop-up, and select 'Show Package Contents'

  • Go into Contents/

  • Select pop-up on Info.plist and choose Open With Other...

  • Select Application/TextEdit

  • Find the line that says <string>-Dapple.awt.brushMetalLook=true</string>> and add a new line below

  • Increase the value of Xmx to the value you require i.e. to set memory usage to 2GB set it to <string>-Xmx2000M</string>

3.4.2. jaikoz.sh

  • From Finder select Utilities/Terminal

  • From Terminal cd /Applications/Jaikoz.app/Contents/Resources/java

  • From Terminal vi jaikoz.sh

  • Within the Jaikoz.sh file , adjust parameters -Xmx800m to set the max heap in megabytes, adjust this value and run jaikoz.sh for it to take effect

You can confirm you have made the change correctly when you start Jaikoz. Click on the Console tab at the bottom and the first line should say how much memory Jaikoz has been allocated. If you cannot see the console you may have hidden the Detail Pane, make sure it is checked in View/Show View Pane.

3.5. Logging

Jaikoz uses two log files, jaikozuser0-0.log contains the same information as is written to the Console Panel, it contains general information about what you've done within Jaikoz. The jaikozdebug0-0.log file contains warnings and debugging information that helps diagnose problems when running Jaikoz. These files are held in the within your log folder, for example /Users/paul/Library/Logs/Jaikoz and are renamed when they get to a certain size, the latest file is always called jaikozuser0-0.log, the next most recent is called jaikozuser0-1.log. if you require support with Jaikoz it is important to send both types of log files, to help diagnose the problem. The amount of logging written to the jaikozdebug0-0.log file can be adjusted, if you have a problem that you can reproduce it would be helpful if you could increase the amount of information logged, recreate the problem, send the logs and then return the logging to the normal levels.

You can send your logs and other support files from within Jaikoz by selecting Advanced/Create Support Files and then emailing the zip file created.

The following parameters effect logging

-l2 -m2

The -l2 parameter specifies how much logging output should be generated by Jaikoz, the -m2 parameter specifies how much output should be generated when reading and writing files. The number 2 can be replaced by any value from 1 to 7, a value of 1 is the minimum and a value of 7 is the maximum. Setting a high value will noticeably slow the performance of Jaikoz, so changes should only be made temporarily to diagnose a problem.

Jaikoz is usually run using Jaikoz.app from the Finder, but you can also run it using jaikoz.sh using the Terminal, logging is adjusted differently depending on which file you use.

3.5.1. Jaikoz.app

If you are running Jaikoz you need to modify the value of -l and -m within the Info.plist

  • Go to where you installed Jaikoz

  • Show pop-up, and select 'Show Package Contents'

  • Go into Contents/

  • Select pop-up on Info.plist and choose Open With Other...

  • Select Application/TextEdit

  • Find the line that says <string>-l2</string>

  • Modify the -l value as required, -l0 is minimal loggging and -l7 is maximum logging

  • Find the line that says <string>-m2</string>

  • Modify the -m value as required, -m0 is minimal loggging and -m7 is maximum logging

3.5.2. Jaikoz.sh

  • From Finder select Utilities/Terminal

  • From Terminal cd /Applications/Jaikoz.app/Contents/Resources/java

  • From Terminal vi jaikoz.sh

  • Within the Jaikoz.sh file, the parameters-l2 -m2 -f sets the logging, adjust this value and run Jaikoz.sh for it to take effect