System Requirements | Installation Instructions | Troubleshooting

System Requirements

The Java WSDP software is supported on the following platforms:

• Solaris ^TM Operating Environment versions 9 (Sparc and x86) and 10 (Sparc and Opteron)
• Linux on Intel Pentium machines with kernel version 2.4.18-14 and 2.4.21-4 (for example, Red Hat 9.0 and Red Hat AS 3.0)

In addition, the Java WSDP software can also be installed, but is unsupported, on other versions of Linux, Mac OS X 10.1 or higher, and most other BSD-based UNIX platforms.

To install the Java WSDP software, you need the J2SE 5.0 JDK software already installed on your computer. Download J2SE 5.0 JDK from here.

You should have at least 140 megabytes of free disk space and 140 megabytes of free temporary disk space before attempting to install the Java WSDP software.

Installation Instructions

Before you download and install Java WSDP, download and install a Web container to use. Get the Web containers (Sun Java System Application Server 8.1 Platform Edition 2005Q2 UR2 or Tomcat 5 for Java WSDP) here. You can use Glassfish as your Web container if you want to install JAX-WSA and an experimental version of JAX-WS. You can also use later versions of Tomcat (versions 5.x or 6.x) as your Web container. However, note that these containers have only been tested minimally.

Run the self-installing executable to unpack and install the Java WSDP software bundle. If you have any difficulties, see the Troubleshooting section at the end of this document or use this link to report an installation problem.

1. Check the download file size.

   If you saved the self-installing executable to disk without running it from the download page at the Java Software web site, check to see that you have the complete file:

   jwsdp-2_0-unix.sh     26,385,040 bytes

2. Uninstall previous versions of the Java WSDP.

   If you have installed a previous version of the Java WSDP, uninstall it by running the ><JWSDP_HOME>/uninstall.sh uninstall script. To uninstall this version of Java WSDP, you also run the <JWSDP_HOME>/uninstall.sh script.

3. Run the Java WSDP Installer.

   The file jwsdp-2_0-unix.sh is the Java WSDP installer. If you downloaded it instead of running it directly from the web site, execute the following command in a shell to launch the installer:

       % /bin/sh jwsdp-2_0-unix.sh
   

   Follow the instructions that the installer provides.

   You can also install the Java WSDP from the command line, by using the console option, as shown:

       % /bin/sh jwsdp-2_0-unix.sh -console
   

   If you are doing the -console install on a remote machine (after rlogin), set the DISPLAY environment variable to your local host.

   Select either no Web container or the Web container into which you will install or have installed and integrate the Java WSDP software. Follow the instructions that are displayed.

   If did not install a Web container, you can get one here or select the "no Web Container" option. Then, after you obtain and install a supported container, run the jwsdponcontainer integration script for that container to integrate your Java WSDP installation into your Web container installation. See the Integration Notes for more information.

   The Java WSDP installer places the Java WSDP technologies under <jwsdp.home> and the integration scripts copy the appropriate JAR files to the container directories.

   Note that a custom installation is required to install JAX-WSA.

4. Delete the downloaded file. (Optional)

   If you want to recover disk space, delete the file (or files) you originally downloaded.

5. Update the PATH variable.

   You can run the Java WSDP without setting the PATH variable, or you can optionally set it as a convenience.

   Should I set the PATH variable?

   Set the PATH variable if you want to be able to conveniently run the Java WSDP executables (for example, startup.sh, shutdown.sh, ant, and so forth) from any directory without having to type the full path of the command. If you don't set the PATH variable, you need to specify the full path to the executable every time you run it, such as:

       % /home/myuser/jwsdp-2.0/jwsdp-shared/bin/startup.sh
   

   It's useful to set the PATH permanently so it will persist after rebooting. To set the PATH permanently, add the full path of the bin directory in the Java WSDP installation directory to the beginning of your PATH variable. Typically this full path looks something like /home/myuser/jwsdp-2.0/jwsdp-shared/bin.

6. Set up Linux to use the version of Ant that is shipped with the Java WSDP.

   On Linux systems, even if you set your ANT_HOME and PATH environment variables to point to the version of Ant that is installed with the Java WSDP 2.0, when you run the Java WSDP's Ant scripts, your system will look in the /etc/ant.conf configuration file and execute the version of Ant that is configured there. If you want to use the version of ANT that is shipped with Java WSDP, comment out the line that configures Ant in the /etc/ant.conf configuration file and your ANT_HOME and PATH environment variable settings will be used.

7. Start using the Java WSDP.

   Your computer system should now be ready to use the Java WSDP.

   To verify that the installation was successful, start (or restart) your Web container. If you are using Tomcat 5 for Java WSDP, browse to http://localhost:8080/index.html; if you are using the Application Server, browse to http://localhost:8080/JWSDP.html and click on the links for the deployed Java WSDP applications, such as the saaj-simple appliction.

8. Uninstalling the Java WSDP.

   If you should ever want to uninstall Java WSDP, execute the <JWSDP_HOME>/uninstall.sh script. You can also uninstall the Java WSDP in console mode:

      uninstall.sh -console
      

Troubleshooting the Installation

Here are some tips for working around problems that could be seen during or following an installation. Since the Java WSDP installer is written in the Java programming language, it is possible that you may encounter problems that are due to the particular Java^TM 2 SDK that is installed on your machine. If you encounter a problem that is not listed below, please check the Java FAQ for additional troubleshooting information.

• If you see the following error message

     Temporary directory /var/tmp does not have YYY kilobytes of space available
  

  then you probably do not have enough space on the disk that contains your /var/tmp directory. You can correct this problem by deleting unneeded files on the partition that contains your /var/tmp directory. Or, you can specify a different directory for the installer to use as its temporary directory by running the installer with the following arguments:

      jwsdp-2_0-unix.sh -is:tempdir /your_temporary_directory
  

• If you see the following error message

     Cannot find Java(TM) 2 Platform, Standard Edition
  

  then the installer could not find a Java^TM 2 SDK to run itself. If you do not have J2SE 5.0 JDK installed on your machine, download J2SE 5.0 JDK from here and install before you run the Java WSDP installer.

  If you already have J2SE 5.0 JDK installed on your machine, correct this problem by running the installer with the following arguments:

      jwsdp-2_0-unix.sh -is:javahome /your_JavaTM_installation_directory