Installing and Running
CellarBoss is available both as
source code and a pre-built executable jar file from the
downloads page and also as source code from
Subversion
(for those who want the latest
bugs fixes)
Prerequisites
-
A properly installed Java6 JRE is all
that is needed to run
CellarBoss.
CellarBoss has only been tested
with the Java6 JRE provided by Sun
-
For development you will need to install
- Java6 JDK
You can get this directly from
java.com or (probably) from your favourite package
manager (sun-java6-jdk for Ubuntu).
- Derby java database
Available from
the Apache Derby site
or (possibly) from your favourite package
manager (sun-java6-javadb for Ubuntu).
- Jasper Reports
Available from Jasper Reports
- Netbeans (recommended)
I use NetBeans
as my development environment so, if you would like to work
on the code, it would probably be worth installing that too.
There is also a plugin available from the
Jasper Reports site
that embeds the iReport report designer into NetBeans.
Installing the stand-alone program
-
Download the
CellarBoss.jar
file from the
downloads page.
Running the stand-alone program
-
On most systems you should be able to run the program
by double-clicking its icon in your file browser or from
the command line with
java -jar CellarBoss.jar
On some systems the default application associated with
.jar
files is an archive manager.
In this case you need to change the file association
for .jar
files to 'java -jar'
.
Usually the right-click menu will provide a way to
achieve this.
Installing the source code
-
Download the
CellarBoss_src_n.n.n.zip
source code package from the
downloads page.
Extract the files from the archive using your favourite zip tool
or from the command line with
unzip CellarBoss_src_n.n.n.zip
This will create a directory called CELLARBOSS_n.n.n
that is the base of the NetBeans project structure.
-
or get the latest code from
Subversion
You should use the following command to just get the latest
code ...
svn co https://cellarboss.svn.sourceforge.net/svnroot/cellarboss/trunk cellarboss
Leaving off the '/trunk
' will download all
the branches and tags that represent the different releases
of the code. This is probably not what you want, but you are
welcome to do so if you wish.