Installing and configuring software

Author	$Author: simon $	The author field is supplied automatically by the CVS; you should not change it manually.
Purpose	Template for Weft Technology Ltd internal documents.
Status	Current	one of 'Draft', 'Current', 'Obsolete'; where a document is marked as current, the latest version of that document in the CVS is the ruling version.
Version	$Revision: 1.4 $	The revision is supplied automatically by the CVS; you should not change it manually.
History	$Log: software.html,v $ Revision 1.4 2000/09/03 17:57:07 simon Correction of minor errors in setup instructions for Jigsaw.

Configuring Access

Microsoft Access is supposed to be installed on the machines in Yokohama before I get there, so let's hope it is! If it is, this is how we will configure it for the work we will be doing in the workshops:

Copy the files /inet2000/meeting.mdb and /inet2000/workshop.mdb from the CD-ROM to your local disk.
Open the Control Panel
Open 'ODBC Data Sources (32bit)'
In dialog 'ODBC Data Source Administrator'
- Select 'Add'
- In dialog "Create New Data Source"
  - Select 'Microsoft Access Driver'
  - Select 'Finish'
- In dialog 'ODBC Microsoft Access Setup'
  - Set data source name to 'meeting'
  - Click 'Select'
  - In dialog 'Select Database'
    - find and select 'meeting.mdb'
    - Click 'OK'
  - Click 'OK'
- Click 'OK'
Similarly configure another ODBC data source called 'workshop' for the database called 'workshop.mdb'

Java SDK 1.3

The conditions of the Java SDK license are such that I can't distribute it on the CD-ROM. I'm hoping that it will have been installed on the machines in the terminal room before I get to Yokohama, but if it has not been you will need to download it from <URL:http://java.sun.com/j2se/1.3/>

License

Sun Java has a typically complex commercial license. Read it yourself - I don't claim to be able to summarise it.

Installing and configuring Java SDK 1.3

Double click the installation archive
- In dialog "Welcome"
  - click "Next"
- In dialog "Software License Agreement"
  - read or ignore the legalese
  - click "Yes"
- in dialog "Choose Destination Location"
  - accept the suggested installation directory
  - click "Next"
- in dialog "Select Components"
  - click "Next"
- wait while files copy
- in dialog "Setup Complete"
  - select "Yes, I want to restart my computer now"
  - click "Finish"

Jacquard 1.0.1

Jacquard is Weft's Servlet toolkit. It's not nearly as important or general as the other components listed here; there are other toolkits equally good or possibly better. However, it will help us to glue all the other bits together and allow us to make reasonable progress in the time we have available.

Jacquard is on the CD both unpacked in /inet2000/jacquard and packed in /inet2000/distributions/linux/jacquard_1.0.1.tgz and /inet2000/distributions/windows/jacquard_1.0.1.zip

Erratum: on about half the CDs, the unpacked source code for Jacquard is in uk, not in jacquard/uk as it should be.

License

Jacquard is released under BSD-style license; you may alter it, copy it, give it away, and use it in things you sell. If you do so you should include an acknowledgment line in your documentation. Jacquard is included on the CD-ROM unpacked in /inet2000/jacquard and packed in /inet2000/distributions/linux/jacquard_1.0.1.tgz and /inet2000/distributions/windows/jacquard_1.0.1.zip

Installing and configuring Jacquard

You don't need to do anything to install and configure Jacquard.

Jigsaw 2.0.5

Jigsaw is the World Wide Web consortium's reference Web server; it is also a good servlet server and is relatively easy to configure. For that reason we'll be using it in the workshops.

Note that the unpacked version is slightly modified from the standard distribution; I've put the JAR files for all the packages we'll use into the classes subdirectory, and modified the CLASSPATH in the Windows and UN*X startup scripts to find them all. I've also set up the demonstration Servlets WorkshopForm and WorkshopList..

Jigsaw is on the CD-ROM both unpacked in /inet2000/Jigsaw and packed in /inet2000/distributions/linux/jigsaw_2.0.5.tar.gz and /inet2000/distributions/windows/jigsaw_2.0.5.zip

Installing and configuring Jigsaw

Copy the unpacked Jigsaw distribution from /inet2000/Jigsaw on the CD-ROM to your local hard disk
Follow the instructions in the README file
if, when running the jigsaw batch file you get an error Out of environment space
- Go to the Windows 'Start' menu and choose 'Run'
- Type 'sysedit'
- find the file 'config.sys'
- add the line
  SHELL=c:\command.com c:\ /e:2048 /p
- Restart the computer
- Try running the jigsaw batch file again
Select the http-server zone in the Server Browser
Expand the 'servlet' item in the tree
Select WorkshopForm and Right-click to select 'Edit Resource'
In window 'Edit Resource'
- Find the 'Servlet Parameters' field and click 'Edit'
- In window 'Edit'
  - Type in key 'driver_name' and value 'sun.jdbc.odbc.JdbcOdbcDriver'
  - Click 'add'
  - Similarly set 'db_url' to 'jdbc:odbc:workshop'
  - Other properties you can set if you want include
    
    action
    
    The URL which is to be the action of this form. Optional. Defaults to this form (best ignorethis one).
    
    allow_logout
    
    Boolean. if set and not 'true', suppress the logout widget
    
    doctype
    
    The SGML doctype to declare for this page. Optional. Defaults to HTML 4 Strict.
    
    stylesheet
    
    The URL of the CSS stylesheet to be used to format this page. Optional. (A suitable value would be "style/jacquard.css")
    
    title
    
    The title of this page. Optional.
    
    identity
    
    The identity string to be returned by this servlet in the getServletInfo() call. Optional.
    
    content_type
    
    The mime type of the output of this servlet. Optional. Defaults to 'text/html'.
    
    cookie_ttl
    
    The default time to live for cookies created by this servlet. Optional, defaults to one day.
    
    db_password
    
    The password to be used to communicate with the database. Optional, if not set you'll get a login form.
    
    db_username
    
    The username to be used to communicate with the database. Optional, if not set you'll get a login form.
    
    debug
    
    Boolean. If 'true', turn on context dumps when exceptions are reported.
    
    timezone
    
    The timezone to use to parse and display dates and times. Optional. Defaults to BST.
    
    countrycode
    
    The countrycode to use to calculate the locale. Optional. Defaults to UK.
    
    language
    
    The language to use to calculate the locale. Optional. Defaults to EN (English).
  - Click 'OK'
- Click 'commit'
- From the 'Resource' menu, choose 'Close Resource Window'
Similarly set up the servlet called List
- set:
  - driver_name to sun.jdbc.odbc.JdbcOdbcDriver
  - db_url to jdbc:odbc:workshop
  - query_template to select * from WORKSHOP
  - action_url to WorkshopForm
  - action_field to Workshop
  - link_field to Title
- You may also set values for
  
  can_add
  
  String: if supplied, add a link with this text to allow the user to add a record.
  
  can_search
  
  Boolean: if 'true', show a widget to allow the user to filter the list..
  
  search_prompt
  
  The prompt string for the search widget
  
  search_help
  
  The help string for the search widget
Important! Click the floppy disk icon on the Server Browser toolbar, or all your servlet configuration will be lost when you reatart Jigsaw!

License

Jigsaw is released under BSD-style license; you may alter it, copy it, give it away, and use it in things you sell. If you do so you should include an acknowledgment line in your documentation.

Installing and configuring Jigsaw Copy the directory /inet2000/Jigsaw to c:\Program Files\Jigsaw

Tomcat 3.1

Tomcat is the Apache Foundation's new Servlet server; it is also the reference implementation of the Java Servlet 2.2 API specification. While it is undoubtedly a good Servlet server we won't be using it in the course because it is somewhat more difficult to configure than Jigsaw. We will, however, be using the servlet API from the Tomcat package. Tomcat is included on the CD-ROM.

License

Tomcat is released under Apache license; you may alter it, copy it, give it away, and use it in things you sell. If you do so you should include an acknowledgment line in your documentation.

Installing and configuring Tomcat

We won't be installing Tomcat during the course. If you want to do so when you get home, the instructions are here.

Xalan-J 1.1

Xalan is the Apache Foundation's XSL-T processor, contributed to Apache by IBM. It is included on the CD-ROM unpacked in /inet2000/xalan_1_1/, and packed in /inet2000/distributions/linux/xalan-j_1_1.tar.gz.

License

Xalan is released under Apache license; you may alter it, copy it, give it away, and use it in things you sell. If you do so you should include an acknowledgment line in your documentation.

Installing and configuring Xalan

You don't have to do anything to install or configure Xalan.

Xerces-J 1.1.2

Xerces is one of the Apache Foundation's XML parsers (Xerces was contibuted to Apache by IBM; the Crimson parser was contributed to Apache by Sun). We will be using Xerces on Tuesday's course, Moving to XML, only. Xerces is included on the CD-ROM unpacked in /inet2000/xerces-1_1_2 and packed in /inet2000/distributions/linux/Xerces-J-bin.1.1.2.tar.gz and /inet2000/distributions/linux/Xerces-J-src.1.1.2.tar.gz

License

Xerces is released under Apache license; you may alter it, copy it, give it away, and use it in things you sell. If you do so you should include an acknowledgment line in your documentation.

Installing and configuring Xerces

You don't have to do anything to install or configure Xerces.

Working with it

Copy the folder /inet2000/work from the CD-ROM to your local disk. Open an MS-DOS prompt window and cd to the work directory. Use notepad to edit your files; always save them in your work directory.

Java

To compile Java source files,

in your MS-DOS window type javacomp <filename>
e.g. javacomp WorkshopForm.java
Note that javacomp is just a batch file which I have written which sets up the classpath you need and then runs javac, the Java compiler

Servlets

To install a servlet,

compile the Java source to a .class file
copy that class file into the directory Jigsaw/WWW/servlet under your Jigsaw directory.
In the Server Browser,
- select the servlet resource
- select reindex.
- You may need to close and reopen the servlet resource before you see your servlet.
- Right click on your servlet in the servlet resource and select Edit Resource
- set up any properties you need
Now use your Web browser to open the URL http://127.0.0.1:8001/servlet/<servlet>
e.g. http://127.0.0.1:8001/servlet/WorkshopForm

XSL

To transform XML files using XSL stylesheets,

in your MS-DOS window type xslt <xslfilename> <xmlfilename> <outputfilename>
e.g. xslt meeting.xsl meeting.xml meeting.html
Note that xslt is just a batch file which I have written which sets up the classpath you need and then runs the Xalan xslt processor

Simon Brooke