Welcome to Simplicity Professional!
PLEASE READ THIS CAREFULLY FOR IMPORTANT INSTALLATION NOTES!
Last updated : July 24, 2000
Installation notes
NOTE: Before beginning the install, you must have installed a
JDK1.1.4 or greater on your computer. This must be a full JDK;
a JRE is not enough. If you have any problems with the
installation, please send an email to:
support@datarepresentations.com.
Platform-specific notes
Windows 95/98/NT
- On Windows NT you must use jdk 1.1.7B or higher. You can download the JDK
from Sun ( http://java.sun.com/j2se ).
- The installer is called simpro.exe. Double click
this file to begin the installation.
- A 'Simplicity Professional' item will be added to your
Start menu. Start Simplicity Professional using this
Start menu item.
Mac OS
- Macintosh users must first install the MRJ 2.1.4 available
from http://developer.apple.com/java/.
- We highly recommend having at least 64 MB of RAM installed
to use Simplicity Professional on the Macintosh.
- The installer will create an icon called 'Simplicity Professional'
in the directory you choose for the installation. Use this
icon to start Simplicity Professional.
OS/2 Warp
- The installation must be performed on an HPFS drive.
- We recommend using jdk117 from IBM. This can be found
at
http://www.ibm.com/Java/jdk/download/. Do NOT use
jdk116, as it contains a bug which will crash the WPS
when you exit from Simplicity. If you are using jdk118,
be sure to apply the latest jdk fixpaks.
(ftp://ftp.hursley.ibm.com/pub/java/fixes/os2/11/ ).
- The distribution for OS/2 is called simpro.zip. Unzip
this file using an unzip utility, being careful to maintain the directory
structure.
- OS/2 users may wish to execute the simpwps.cmd file.
This REXX script will create a WPS object on the
OS/2 desktop for starting Simplicity Professional.
- The debugger needs to have the localhost interface enabled. You can do
this by typing the following command in an OS/2 window:
ifconfig lo 127.0.0.1 up
Note that this will be reset when you next reboot your computer.
- The Remote testing tool also needs localhost to be setup correctly for it to
work. You can do this by going to System setup, and opening TCP/IP
Configuration. On the hostnames tab, go to page 2. Add an entry, where
the ip address is your actual ip address, and the Hostname is "localhost".
This may not work if you have a setup with dynamic ip addresses.
Linux
- Be certain to use the latest revision of the JDK from
www.blackdown.org.
Simplicity Professional will work properly
with either jdk1.1.7_v3, jdk1.2.2_rc3, or jdk1.2.2_rc4.
Simplicity will also work with jdk 1.3.
- Suse Linux users: the rpm packaged blackdown jdk from
older Suse distributions contains an incomplete version of
libjpeg.so. This causes the jdk to be unable to display
jpeg files. To fix this, install the .tar.gz distribution
from blackdown (jdk1.1.7), and then copy the libjpeg.so
from that distribution over the one in /usr/X11R6/lib.
- The distribution for Linux is a .tar.gz file, named
simppro.tar.gz. To install, copy the distribution to
your user directory and execute the following commands to unpack
the archive:
gzip -d simppro.tar.gz
tar -xf simppro.tar
- In the resulting directory is a script called 'Simplicitypro'.
You need to edit the two variables in the file which correspond
to the location of the java executable on your machine and the location
of the Simplicity install directory.
- Set the script to be executable (using the
chmod
command.)
You can start Simplicity Professional
for Java by typing "./Simplicitypro" in this directory. This
file can be moved to your $HOME/bin directory if you wish.
Solaris / Other Unix
- The distribution is a .tar.gz file, named
simppro.tar.gz. To install, copy the distribution to
your user directory and execute the following commands to unpack
the archive:
gzip -d simppro.tar.gz
tar -xf simppro.tar
- In the resulting directory is a script called 'Simplicitypro'.
You need to edit the two variables in the file which correspond
to the location of the java executable on your machine and the location
of the Simplicity install directory. You may also need to edit the first line
of the script to use ksh.
- Set the script to be executable (using the
chmod
command.)
You can start Simplicity Professional
for Java by typing "./Simplicitypro" in this directory. This
file can be moved to your $HOME/bin directory if you wish.
- On some Solaris machines, Simplicity Professional will stall
shortly after starting. This can be fixed by disabling the
JIT. To do this, edit the lines defining the JIT variable in the
startup script.
Startup Customization
On most OS's, the installer will create a startup script from
which Simplicity can be invoked.
You also may wish to start Simplicity Professional manually. To do
so, make sure that your CLASSPATH environment variable includes
Simplicitypro.jar, swingall.jar, javax.servlet.jar, com.mortbay.Jetty.jar,
gnujsp.jar, pbclient31RE.jar, pbnetwork31RE.jar, and datarep_common.jar.
For example, on Windows 95,
set CLASSPATH=C:\SimplicityProfessional\simplicitypro.jar;
C:\SimplicityProfessional\swingall.jar;
C:\SimplicityProfessional\javax.servlet.jar;
C:\SimplicityProfessional\com.mortbay.Jetty.jar;
C:\SimplicityProfessional\gnujsp.jar;
C:\SimplicityProfessional\pbclient31RE.jar;
C:\SimplicityProfessional\pbnetwork31RE.jar;
C:\SimplicityProfessional\datarep_common.jar
On Linux,
$SIMPLICITYPRO=/home/user/Simplicitypro
export CLASSPATH=$SIMPLICITYPRO/simplicitypro.jar:
$SIMPLICITY/swingall.jar:
$SIMPLICITY/javax.servlet.jar:
$SIMPLICITY/com.mortbay.Jetty.jar:
$SIMPLICITY/gnujsp.jar:
$SIMPLICITY/pbclient31RE.jar:
$SIMPLICITY/pbnetwork31RE.jar:
$SIMPLICITY/datarep_common.jar
Simplicity is started using the following command:
java -mx100m datarep.Simplicity
Documentation
The Simplicity Professional manual and tutorials are provided in
two formats. The first is HTML, which can be found in the doc
directory. It can be viewed with any browser directly, or
from the Help menu in the Simplicity IDE. The documentation
and tutorials are also provided in Adobe Acrobat format,
suitable for printing. This file can be found in Simplicity's
installation directory, called Simplicity.pdf.
Audio Support
All audio support in Simplicity Professional is handled by a class
called datarep.common.ApplicationAudioClip which implements the
java.applet.AudioClip interface and uses sun.audio.* to provide
platform-specific audio processing.
In order to comply with the 100% Pure Java Specifications, the
ability to play audio files (*.au) has been removed. The
default ApplicationAudioClip class (found in the datarep_common.jar
file) will produce a simple beep sound regardless of the contents
of the audio file you are attempting to play.
*** You can re-enable full audio support by replacing the
datarep_common.jar file in the main installation directory with
the one in the 'NotPureJava' directory.
Using this class introduces non-pure Java into Simplicity.
It is known to work well on many platforms, though,
including Win95/98/NT, MacOS, OS/2 Warp, and Solaris.
Go to the top