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 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 /inet2001/meeting.mdb and /inet2001/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 /inet2001/jacquard and packed in /inet2001/distributions/linux/jacquard_1.4.5.tgz and /inet2001/distributions/windows/jacquard_1.4.5.zip

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 /inet2001/jacquard and packed in /inet2001/distributions/linux/jacquard_1.0.1.tgz and /inet2001/distributions/windows/jacquard_1.0.1.zip

Installing and configuring Jacquard

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

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.

Note that this is not the latest version of Tomcat - it's one which is proven and tested with all the other bits of software we're using.

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

For the purposes of the course, simply copy the jakarta-tomcat-3.2.1 directory from the CD-ROM onto your hard disk. Note that this is a slightly tweaked tomcat installation, including the Jar files needed during the course.

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.

Note that this is not the latest version of Xalan - it's one which is proven and tested with all the other bits of software we're using.

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

Note that this is not the latest version of Xerces - it's one which is proven and tested with all the other bits of software we're using.

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

give me feedback on this page // show previous feedback on this page