3. Starting Jaikoz

3.1. General Startup Instructions

You can start Jaikoz using the shortcut that should have been created in your Start Menu Jaikoz.exe. Alternatively you can start Jaikoz using the batch file jaikoz.bat

If everything is OK there will be a short delay whilst Jaikoz initialises and then it should start.

Select Path to Open a File Dialog and find the license file that you should have received by email (license.jai) and select Open. Then select OK to verify the license.

If the license is verified Jaikoz will start

3.2. Uninstalling Jaikoz

Run Uninstall Jaikoz from your Start menu If you wish to completely remove the application folder and any work saved in it, you will have to delete this folder manually.

3.3. Memory Management

With Jaikoz 64bit it will use a maximum of 75% of your system memory, Jaikoz 32bit will use 800mb regardless of how much physical memory your machine has.

The setting for 64bit Java should be fine but you may want to increase the value set for Jaikoz 32bit. If you are attempting to load many songs (more than 10,000) you may get a warning that memory is low, also note that if you are using Jaikoz 32bit the maximum value you can set the memory to is about 2GB, there is no such limit if using Jaikoz 64bit.

3.3.1. Jaikoz 64bit

In the same folder as Jaikoz64.exe is a Jaikoz64.ini file

Within Jaikoz64.ini edit the value of vm.heapsize.max.percent=75 to specify the maximum percentage heap size in megabytes.

3.3.2. Jaikoz 32bit

In the same folder as Jaikoz.exe is a Jaikoz.ini file

Within Jaikoz.ini edit the value of vm.heapsize.preferred to specify the actual maximum heap size in megabytes.

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.4. 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 Jaikoz folder in your home directory, for example C:\Documents and Settings\paul\Jaikoz\Logs 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.

Usually Jaikoz is run using Jaikoz.exe, but you can also run it using Jaikoz.bat. If you hide extensions within File Explorer both files will be listed as Jaikoz, but Jaikoz.exe will have a Insect icon and have type of Application and Jaikoz.bat will have a DOS icon and a type of MS-DOS Batch File. Logging is adjusted differently depending on which file you use.

3.4.1. Jaikoz.exe

In the same folder as Jaikoz.exe is a Jaikoz.ini file

Within Jaikoz.ini edit the value of arg.1 from -l1 to -l7, the default is -l2.

Within Jaikoz.ini edit the value of arg.2 from -m1 to -m7, the default is -l2.

3.4.2. Jaikoz.bat

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