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.

> - `com.tolstoy.testjc.FileAttributesTest`: Lets you view and set the attributes for files and folders.
> - `com.tolstoy.testjc.TestResFork`: shows how to copy a Mac file's data and resource forks to a new file. Copying the file's attributes is left as an exercise.
> - `com.tolstoy.testjc.MakeLink`: shows how to create a Windows shortcut, but could be adapted for the Mac.

## 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