JSPWiki/Glassfish Install (Part 4 of 18: Gather Components)

For our project there are several pieces of software you will need to obtain from various locations on the Internet. This software will not cost you anything. However, if you need commercial support down the road chances you will be able to get it, at least for the JDK and Java EE Container.

Collect all of these items and save them to your desktop or a location where you are sure you will be able to find them:

  1. Java SE Development Kit (JDK)

    1. The Glassfish container requires a JDK to run

    2. Download JDK Version 6 from Sun Microsystems

    3. http://java.sun.com/javase/downloads/index.jsp

    4. There are several versions on the download page

    5. You want “jdk-6-windows-i586.exe”

  2. Java EE Container

    1. JSPWiki need to run within a container. We’re going to use Glassfish

    2. Download Glassfish from Java.net

      1. Note: Glassfish is the development version of what will eventually become the next version of Sun’s Java System Application Server (SJSAS) but the release of that product is a little bit down the road. So, for now, we’re going to download Glassfish-V2.

        1. You’ll notice that when you login to Glassfish you will see that it already has a lot of Sun’s branding an logos on the interface

    3. https://glassfish.dev.java.net/public/downloadsindex.html

    4. There are several version on the download page

    5. You want “Build 33e 21-February-07” or newer from the Glassfish v2 Beta Branch

  3. Ant

    1. Ant if a build tool that we will need to complete our install of Glassfish.

    2. Download Ant

    3. http://ant.apache.org

    4. You want version 1.7.0

  4. JDBC driver

    1. Glassfish will need to be able to communicate with MS-SQL server. JDBC is the method used by the Java platform to communicate with relational database systems

    2. Note: You by no means need to use MS-SQL. It just so happens that my user tables are already setup in a database that resides on my MS-SQL server for use by another application. For me, in this instance, using MS-SQL is the path of least resistance. If you already have a database from another vendor installed chances are you’ll be able to find a JDBC driver for your existing database system. If you don’t have any database system installed you may want to consider PostgreSQL, its reliable and the JDBC drivers are solid.

    3. Download jTDS

    4. http://jtds.sourceforge.net/

      1. Click on the “Downloads” link

    5. You want version “jtds-1.2-dist.zip”

  5. Tomcat (or a couple of pieces of it anyway)

    1. Even though all of this software will be running on our re-purposed server we are going to want our Apache web server to coordinate all of the web activity. For this to work we’re going to need to borrow specific “jars” (a jar is a zip file that holds Java stuff) from the Tomcat project. The setup we’re building together, Apache in the front and a Java container behind, is pretty common. Who knows, maybe in the future the folks who write Glassfish/SJSAS will just include the necessary jars to allow this configuration in Glassfish by default. But for now we’ll need to track down these extra parts ourselves.

    2. Download Tomcat

      1. http://tomcat.apache.org

      2. You want version 5.5.20

  6. Commons-Logging

    1. Again this is another “jar” that will be needed in order to get Apache and Glassfish to work together

    2. http://jakarta.apache.org/commons/logging

    3. You want version 1.1

  7. Text Editor (Optional but Recomended)

    1. We’re installing our software on the Windows platform. However, most of this software was probably developed on some kind of Unix platform. This isn’t a problem for us as most Java software runs in pretty much the same on any platform. There is one rub which is the format of the configuration files. Unix and Windows handle plain text files differently. If we try to edit these files using Notepad on Windows the files look funny and it makes it easier to make mistakes when editing. I strongly recommend installing gVim to get around this problem.

    2. Download gVim

    3. http://www.vim.org/download.php

    4. You want “gvim70.exe”

    5. Note: After you install gvim you will have a gVim icon on you desktop. You can drag and drop the configuration files you need to edit onto this icon/shortcut to open and edit the file in question.

  8. Compression Software (Optional but Recomended)

    1. Sometimes the compression software built into Windows creates a strange internal layout of newly compressed files. 7-zip is also significantly faster at both decompressing/compression operations and will give you a bit more control over how the internals of the compressed files are handled. I strongly recommend you use 7-zip for this exercise.

    2. Download 7-zip

    3. http://www.7-zip.org

    4. You want the most recent stable version 4.22

  9. JSPWiki

    1. Download JSPWiki

    2. http://www.jspwiki.org/wiki/JSPWikiDownload

    3. You want the STABLE version 2.4.100

Whew! That was a lot of hunting and finding. The good news is this is just about everything we need. There will be an additional component that we will need to install on our Apache server but we will rely on the package tools built in to our Linux distribution to handle that bit of work.