This version has only been tested on a RedHat 5.0 Linux system, using the blackdown.org JDK1.1.6v2. Specifically, jdk1.1.6-v2-glibc.tar.gz.On x86 Linux systems, JConfig will use native code to provide some functionality. On all other Unix systems, JConfig does not yet use native code, just Java.
The shared library 'libjconfiglx0.so' contains the Linux native code. If you're running on Linux, and you have problems related to this library, please send us the details. You can remove this library from your LD_LIBRARY_PATH, and JConfig will use the all-Java Unix version of its code.
Only some of the file methods have been implemented so far. This means that ImageMeister and the DiskBrowser sample should generally work. However, some of the functionality illustrated by the TesterW sample app is not yet implemented.
A minimal implementation of the FileRegistry.launchURL() method is provided; a future Linux version will provide a more robust implementation.
No special installation is required. You will, however, need to modify the shell scripts to match your own setup, as indicated below.
The ImageMeister application is run using the shell script 'imrunlx', which is in the 'imeister' folder. To run ImageMeister, you may need to edit the first few lines of this file to reflect your setup, as described in the next section.For more information on ImageMeister, see imagemeister.html.
Two shell scripts are provided:jconfig/browselx - runs the DiskBrowser sample app imeister/imrunlx - runs the ImageMeister applicationYou'll need to modify these files to match your own setup.
Linux
You need to make sure that JConfig.zip is in the classpath, and that 'libjconfiglx0.so' is in the LD_LIBRARY_PATH. Both of these items are in the 'common' directory. For instance, using the blackdown.org JDK1.1.6v2:export SAMHOME=/mnt/win/samizdat export JAVA_HOME=/usr/jdk1.1.6 export DISPLAY=:0 export PATH=$SAMHOME/common/:$JAVA_HOME/bin:$PATH export LD_LIBRARY_PATH=$SAMHOME/common:$LD_LIBRARY_PATH export CLASSPATH=.:$SAMHOME/common/JConfig.zip:$JAVA_HOME/lib/classes.zipUnix
On Unix systems other than Linux, JConfig does not yet use native code, making this easier than Mac and Windows. Just make sure that JConfig.zip is in the classpath. You can use a modified version of the script given above.
Currently, the icons for disk objects are displayed using a set of bitmap files. This will change in future versions. If you want to replace the icons with your own, note that the icons ending in 'l' (for large) must be 32 by 32 pixels, and those ending in 's' (for small) must be 16 by 16 pixels. All these must be 8-bit, uncompressed Windows .bmp files.
JConfig determines that it is running on a non-Linux Unix system by checking that "/", "/usr", and "/etc" exist, and are directories. This is not optimal, because these paths may not exist on all Unix systems, and also because it would be possible to setup a Mac with these same paths.
If you have any problems running this on a Unix system, please send us the details.