Download and Installation
License
What you need
What you do
Configuring SmART
License
SmART is free software; you can redistribute it and/or modify it under the terms of the
GNU General Public License. A copy of this license has been included in the SmART package.
Downloading SmART is not necessary unless you are unable to use the online version
which is available under http://smart.sbronner.com. Using the online version does not require
to download any file!
What you need
For running SmART on your own computer while being offline, you need three things:
- The file smart.war, providing the SmART web application (see below
for downloading the file).
- SmART requires a Servlet Container being installed, e.g.
Apache
Tomcat or Jetty.
- A Servlet Container requires a Java Runtime Environment
(JRE), some versions additionally require a Java Compiler. If you want to play it
safe you should install either both or a Java Software Development Kit (SDK)
which includes a JRE plus a compiler.
The official Java JRE and SDK are provided by
Sun.
Alternatively, you can use Kaffe
as a JRE and/or Jikes
as a Java Compiler.
What you do
- First, check if you have a JRE installed. If your Operating System
is Linux or Mac OSX open a Shell, if you are working with Windows open a DOS Box.
In both cases, type java -version. If the version of your JRE is displayed
you are lucky. Otherwise, download the
Sun JRE or
Kaffe and install it according
to the documentation included. As far as I know,
a JRE should suffice for the Tomcat Servlet Container under Windows but not
under UNIX/Linux. In the latter case, check if a Java Compiler has been installed
by typing javac -help. If no help text is displayed download the
Sun SDK or
Kaffe plus
Jikes and install it
(in the latter case first Jikes, then Kaffe). After installation,
java -version should result in a version number rather than an error message.
- Download a Servlet Container like
Apache
Tomcat or Jetty
and install it according to the documentation included.
Start the program by calling the appropriate Shell Script under Linux or Mac OSX
or by double-clicking some executable file under Windows.
You can configure the Servlet Container so that it will run as a server process,
i.e. start automatically when your computer is booted. Otherwise you will have
to start the Servlet Container each time your computer has been shut down.
Refer to the Servlet
Container's install documentation for further instructions.
- Download the file smart.war by right-clicking this
link and choosing "Save Target As". Save the file in the Servlet Container's
"webapps" directory. Stop your Servlet Container and start it again. The
file smart.war should be unpacked automatically to a subdirectory "smart"
in the "webapps" directory.
- Now it's time (drum roll). Start your favorite web browser and type
http://localhost:8080/smart
into its address line. If everything works fine enjoy SmART!
- If you encounter any problems contact your system administrator and in case you
don't have one available feel free to contact me via
carsten
cmziegert.org.
Configuring SmART
SmART comes with a predefined relation hierarchy which is easily configurable
if you are familiar with XML. Open the file RelationConfig.xml in your favorite
text editor. (You will find it in the "config" subdirectory of your "smart" directory
which is located in your Servlet Container's "webapps" subdirectory.)
If you have opened the file define new relations, or arrange the existing ones
by means of the <grp>
tag into groups and sub-groups.
Please consider that the <rel> tag (representing a semantic relation)
has two attributes: name is the relation name which is displayed in SSA
output such as graphic export (the "real" name) whereas out denotes
the relation's designation in the list the user chooses from during the analysis
process.

Please note: The English (RelationConfig.xml) and the German relation
hierarchy (RelationConfig_de.xml) don't agree with each other in all details. The reason
is that different sources were used: The book "A Semantic and Structural Analysis of
Philippians" by John Banker for the English version and the lecture "Greek
III" by Dr. Heinrich von Siebenthal at Freie
Theologische Akademie for the German version.
|