APPENDIX A ■■■ Linux Installations This appendix provides comprehensive instructions for installing on Linux- and Unix-like oper- ating systems all the software that is required for running applications discussed in the book. The JDK installation is common and is required by all the examples in this book. Thus, it is listed first. Following that section, the installation procedures are listed by chapter for your conven- ience. Also, any installation instructions presented in earlier chapters are not repeated here. JDK 1.5.0 You can download the jdk-1_5_0_06-linux-i586.rpm archive from the following URL: http://java.sun.com/j2se Double-clicking on this installer guides you through the various steps of installation. These steps are not exhaustive; they simply ask you to accept the license agreement and specify the folder where you would like to install the software. After installing the software, you need to set the JAVA_HOME environment variable, which you do by using the following command: export JAVA_HOME=/usr/java/jdk1.5.0 Add the bin folder to your PATH environment variable as follows: export PATH=$PATH:$JAVA_HOME/bin ■Note The environment variables can be set permanently by adding the given commands to the \etc\profile file. To make the changes visible, use the source command. 449 450 APPENDIX A ■ LINUX INSTALLATIONS Chapter 2 You need to install Apache Xerces, XMLBeans, and Ant to run the applications found in Chapter 2. Apache Xerces You can download Apache Xerces project code from one of the following URLs: http://xml.apache.org/xerces2-j/ or http://archive.apache.org/dist/xml/xerces-j/ The Apache Xerces project is available in binary and source distribution. You can down- load the Xerces-J-bin.2.7.1.tar archive and unzip it to the desired folder. After installing software, add the xml-apis.jar file to your classpath as follows: export CLASSPATH=$CLASSPATH:/usr/xerces/xml-apis.jar Apache XMLBeans You can download Apache XMLBeans project code from the following URL: http://xmlbeans.apache.org/ Download the xmlbeans-current.tgz archive and unzip it to the desired folder. Update your environment by using the following commands: export XMLBEANS_HOME=/usr/xmlbeans export PATH=$PATH:$XMLBEANS_HOME/bin Apache Ant The Apache Ant project is available in binary and source distribution. You can download the binary distribution from the following URL: http://ant.apache.org/bindownload.cgi Unzip the archive to the desired folder and update your environment as follows: export ANT_HOME=/usr/ant export PATH=$PATH:$ANT_HOME/bin APPENDIX A ■ LINUX INSTALLATIONS 451 Chapter 4 Running applications from Chapter 4 requires you to install the Tomcat web server and Apache SOAP toolkit. Apache Tomcat You have to download apache-tomcat-5.5.9.tar.gz from the following URL: http://archive.apache.org/dist/jakarta/tomcat-5/ Unzip the archive to the desired folder. Set the environment by using the following commands: export CATALINA_HOME=/usr/tomcat export PATH=$PATH:/$CATALINA_HOME/bin You can run the Tomcat server by using the following command: ./startup.sh The command to shut down the server is as follows: ./shutdown.sh You can test the Tomcat installation by opening the following URL in the browser: http://localhost:8080 Apache SOAP You can download the Apache SOAP toolkit from the following URL: http://mirrors.isc.org/pub/apache/ws/soap/version-2.3.1/ Apache SOAP is available in binary and source distribution. If you are using the binary distribution, simply unzip the downloaded archive. Copy the soap.war file to the webapps folder of the Tomcat installation and restart the Tomcat server if you are running it. Make sure that you have the mail.jar and activation.jar files in the shared\lib folder of the Tomcat installation. Now you can test the installation by opening the following URL in the browser: http://localhost:8080/soap 452 APPENDIX A ■ LINUX INSTALLATIONS Chapter 5 Running applications from Chapter 5 requires you to install code for the Apache Xalan project. Apache Xalan The Apache Xalan project code is available in binary and source distribution. You can down- load it from the following URL: http://xalan.apache.org/ Unzip the downloaded binary archive to the desired folder. Add the required JAR files to your classpath as follows: export CLASSPATH=$CLASSPATH:/usr/xalan/xalan.jar:/usr/xalan/xsltc.jar Chapter 6 Running examples from this chapter requires you to install the Apache FOP project code. Apache FOP The Apache FOP project code is available in binary and source distribution. You can download it from the following URL: http://xmlgraphics.apache.org/fop/download.html Download the fop-current-bin.tar.gz archive and unzip it to the desired folder. Add the required JAR file to your classpath as follows: export CLASSPATH=$CLASSPATH:/usr/fop/xml-apis.jar Chapter 7 This chapter requires you to install Cocoon on your machine. Apache Cocoon Download the cocoon-2.1.8-src.tar archive from the following URL: http://cocoon.apache.org/ Unzip the downloaded archive file to the desired folder. You have to build Cocoon to create a WAR file. You can do this by running the build.sh file as follows: ./build.sh war This will create a cocoon.war file in the \build\cocoon directory of the Cocoon installation folder. Copy this WAR file to the webapps folder of your Tomcat installation and restart Tomcat if it is already running. Test your installation by opening the following URL in the browser: http://localhost:8080/cocoon APPENDIX A ■ LINUX INSTALLATIONS 453 Chapter 8 Running applications from this chapter requires you to install XML-Security project code on your machine. Apache XML-Security Download the distribution archive from the following URL: http://xml.apache.org/security/dist/java-library/ Unzip the archive to the desired folder. Modify the classpath by using the following command: export CLASSPATH=$CLASSPATH:/usr/xml-security/libs/xmlsec-1.3.0.jar Chapter 9 Running applications from this chapter requires you to install Apache Xindice project code on your machine. Apache Xindice Download the xml-xindice-1.0.tar.gz archive from the following URL: http://xml.apache.org/xindice/download.cgi Unzip the archive to the desired folder. You have to set the XINDICE_HOME environment variable to the Xindice installation folder. You have to add $XINDICE_HOME\bin to your path so that you can use xindice and xindiceadmin commands from anywhere. Modify the environ- ment by using the following commands: export XINDICE_HOME=/usr/xindice export PATH=$PATH:$XINDICE_HOME/bin You should have the JAVA_HOME variable set to the Java installation folder to run the Xindice server. The classpath has to be modified to include the xindice.jar file: export CLASSPATH=$CLASSPATH:/$XINDICE_HOME/java/lib/xindice.jar You can run the Xindice server by using the following command: cd $XINDICE_HOME ./start 454 APPENDIX A ■ LINUX INSTALLATIONS Chapter 10 Running applications from this chapter requires you to install Apache Forrest project code on your machine. Apache Forrest You can download Apache Forrest code from the following URL: http://www.apache.org Unzip the downloaded apache-forrest-0.7.tar.gz file to the desired folder. Create a new environment variable called FORREST_HOME and set its value to your installation folder of Forrest. Also add FORREST_HOME to your path. This can be done as follows: export FORREST_HOME=/usr/forrest export PATH=$PATH:$FORREST_HOME/bin Index ■Symbols ■A != XPath operator, description of, 207 About menu, creating with Forrest, 432 “ (double quotes) ac command in Xindice, adding collection replacement for, 4 with, 379 using in Xindice, 383 actions element of sitemap document, & (ampersand), replacement for, 4 overview of, 294–295 ‘ (single quote), replacement for, 4 actor attribute of SOAP message, overview * (asterisk) of, 116 appearance next to Forrest commands, AddDocument.java application, running, 419 392, 395, 398 quantity specifier used with DTDs, 16 addFiles method, using with Xindice using with digital signatures, 333–334 collections, 395–396 wildcard used in XPath queries, 204 addmultiple command in Xindice, using, 380 XPath operator, 207 addNewCustomer method, calling in + (plus) XMLBeans, 101 quantity specifier used with DTDs, 15 Admin tool, deploying RPC-style web service XPath operator, 207 with, 159 - (dash) XPath operator, description of, 207 administrator utilities, running for Tomcat, . and .. expressions in XPath, descriptions of, 154 201 AES (Advanced Encryption Standard) ... (ellipsis), using in generate element, 294 algorithm, using with / expression EncryptPO.java application, 363 description of, 201 algorithms, examples of, 343 using with XSLT documents, 212 all tags, using in XML document, 30–31 // expression in XPath, description of, 201 ampersand (&), replacement for, 4 < (left angle bracket) ancestors of nodes, specifying with XPath as less than XPath operator, 207 axes, 205, 207 replacement for, 4 and XPath operator, description of, 207 using with markup, 5 annotation tag, using with XML schemas, 24 = XPath operator, description of, 207 anonymous types > (right angle bracket) creating, 35 as greater than XPath operator, 207 using with XML schemas, 27–28 replacement for, 4 Ant build file, running modified trade order using with markup, 5 application with, 93 ? quantity specifier, using with DTDs, 16 Ant tool @ expression in XPath, description of, 201 downloading for Linux installation, 450 @* wildcard, using in XPath queries, 204 running application for counting | (pipe character) customers with, 89 combining XPath paths with, 205 using with XMLBeans, 83–84 description of, 207 ANY keyword, using with DTD elements, 14 using with DTD elements and Apache Ant. See Ant tool subelements, 15 Apache Avalon framework website, 322 Apache Cocoon. See Cocoon ■Number Apache FOP. See FOP (Formatting Objects 128-bit symmetric key, generating with AES, Processor) 363 Apache Forrest. See Forrest 455 456 ■INDEX Apache SOAP. See SOAP (Simple Object block element Access Protocol) creating in XSL-FO document, 262 Apache Tomcat.