Installing the IBM WebSphere sMash CLI
In the Introduction, we talked about the four different IBM WebSphere sMash offerings. For the purposes of this book, any version should be appropriate. So, feel free to download the latest Project Zero build or the latest IBM WebSphere sMash Developer Edition. Before we do that, though, let's prepare our Java development environment.
First Things First: Java Development Environment
Prior to installing the sMash CLI, you must ensure that you have a functional Java SE Development Kit (JDK™) version 5 or 6 installed. It is important to remember that you cannot use the Java SE Runtime Environment (JRE™) to develop with sMash. The AppBuilder development environment requires libraries found only in the JDK and not in the JRE. This is a common problem with first-time users. You may choose to use either the JDK from Sun or IBM. They can be found in the locations in Listing 1.1.
Listing 1.1. Locations of Supported JDKs
IBM: http://www.ibm.com/developerworks/java/jdk/ Sun: http://java.sun.com/javase/downloads/index.jsp
After you have downloaded a JDK, install it per the instructions provided for your operating system. The following steps show the configuration using the Linux® command line. For Windows® users, you need to open a command prompt and alter the statements appropriately. When installed, you can verify your JDK installation by running the commands in either Listing 1.2 or Listing 1.3.
Listing 1.2. Linux Java Version Check
$ java -version java version "1.6.0" Java(TM) SE Runtime Environment (build pxi3260sr3-20081106_07(SR3)) IBM J9 VM (build 2.4, J2RE 1.6.0 IBM J9 2.4 Linux x86-32 jvmxi3260- 20081105_25433 (JIT enabled, AOT enabled) J9VM - 20081105_025433_lHdSMr JIT - r9_20081031_1330 GC - 20081027_AB) JCL - 20081106_01
Listing 1.3. Windows Java Version Check
C:\>java -version java version "1.6.0" Java(TM) SE Runtime Environment (build pwi3260sr2-20080818_01(SR2)) IBM J9 VM (build 2.4, J2RE 1.6.0 IBM J9 2.4 Windows XP x86-32 jvmwi3260-20080816 _22093 (JIT enabled, AOT enabled) J9VM - 20080816_022093_lHdSMr JIT - r9_20080721_1330ifx2 GC - 20080724_AA) JCL - 20080808_02
The output shown in the listings indicates that I am running the IBM JDK version 1.6.0 on a Linux x86 platform. If running the Sun JDK, a similar output will be shown. The important thing is that you get JDK version information back and not some random error. Now that we have the JDK installed and have ensured that it is working, we can move on to downloading and installing WebSphere sMash.