Main Page
    Cookbook/Overview     ImageMeister     the jcprops file     Licensing     Please Vote!
    Binary Installation & Configuration [ Win · Mac · Nix · OSX ]     Changes
    Public API
    Source Code Main Page
        Java [ Common · Win · Mac · Nix ]     Native Code [ Common · Win · Mac · Nix ]     Manifest
        Native Code Overviews [ Common · Win · Mac · Nix · Strings ]     Macros [ General · Native Macros ]
        Walkthroughs [ Java only · Java and native ]     Building [ Win · Mac · Nix · OSX ]     Distribution Issues

Unix/Linux Installation and Configuration Notes

Platforms

This version has been tested on a RedHat 6.1 Linux system using the www.blackdown.org JDK1.1.8v1 and JRE1.2.2rc4, and the IBM JRE1.1.8.

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 post the details to the JConfig Support Forums (see readme.html for the URL). 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 Tester 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.

Installation

No special installation is required. It is highly recommended that you unzip the distribution file into /home/jconfig. That way, the .sh files might only require minimal editing.

Running ImageMeister

The ImageMeister application is run using the shell script imrun.sh, 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.

Running The Sample Applications

Two shell scripts are provided:
jconfig/browse.sh - runs the DiskBrowser sample app
imeister/imrun.sh - runs the ImageMeister application

You'll need to modify these files to match your own setup.

In addition to DiskBrowser, three other samples are provided.

Run these in a similar fashion to running DiskBrowser. See the comments in these files for more information.

Paths and Classpaths

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.8v1:

export SAMHOME=/home/jconfig/samizdat
export JAVA_HOME=/usr/local/jdk118

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.zip

java com.jconfig.DiskBrowser

Unix
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.

Additional Information

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 post a message to the JConfig Support Forums.


Main Page · JConfig · ImageMeister · System Properties Repository · Native Macros · Free Samples · WordMeister · Java Freeware · Links · Contact Us
Copyright (c) 1997-2002 Samizdat Productions. All Rights Reserved.
JConfig and ImageMeister are trademarks of Samizdat Productions. Other trademarks are the property of their respective owners.
samizdat@tolstoy.com