Troubleshooting

Author: Toshihiro Kamiya
Created: 2008/May/2
Contact: info@ccfinder.net
Copyright: 2005-2010 © Toshihiro Kamiya. All rights reserved.

TOC

1. I can't invoke GemX
2. The tool stopped with a message something like "abnormal termination..."
3. The tool neglects some existing source files
4. Source code is shown as garbled characters
5. The tool does not use extra CPU cores

I can't invoke GemX

• In order to read the error message, invoke "gemx.bat" at the command line (cmd.exe). Or invoke "gemx.sh" at the shell.
• For Windows users
  • At command line, execute "java -version" in order to check the version of the JavaVM. 1.5 or later is required. In some version of windows, java.exe is not in path because the Java VM's installer doesn't modify path variable. In such case, modify path variable manually.
  • Check the environment variables PATH and CLASSPATH. (Some application seems to overwrite the class path.)
• For Ubuntu users
  • Did you put the license key file on the /bin of the install directory?
  • Confirm the required apt-get commands were done.
  • Check the system's default Java VM is Sun's one, not gcj.
  • Check the version of Python is 2.5 or 2.6. Python 3.x is not supported, yet.
  • Despite of Python interpreter being installed on your PC, ccfx (or GemX) says it can't find Python, set the environment variable CCFINDERX_PYTHON_INTERPRETER_PATH to a path where Python interpreter has been installed. When Python intalled to the non-default directory or when two or more versions of Python have been installed, this error may occur.

The tool stopped with a message something like "abnormal termination..."

• Your PC has a memory more than 1GB?
• HDD has enough free space?
• In case a lot code clones are included in one file, clicking or dragging of the file in Scatter Plot may cause out-of-memory error. This limitation will be relaxed somehow with JavaVM's -Xmx option.
• From menu settings » ccfx settings, specify the smaller value for "Chunk Size" (the default value is 60M).
• Check "use prescreening" at clone detection in GemX. This option removes too clone-prone source files from target of clone detection.

The tool neglects some existing source files

• The tool will determine whether a file to be a source file or not, by checking its extension (for exmple, a file with extension .COB or .CBL is a COBOL source file). If you really want to make the tool read a file with a special extension, use a file list.

Source code is shown as garbled characters

• Check encoding of the source file. In case of Ubuntu, encoding must be UTF-8. Try to open the source file by a text editor.

The tool does not use extra CPU cores

• By default, CCFinderX uses single thread. Specify number of threads in Max Worker Threads in a dialog shwon by menu Preferences » Ccfx Preferences.