System Requirements | Installation Instructions | Troubleshooting

System Requirements

The Java WSDP software is supported on Microsoft Windows 2000, Microsoft Windows XP, and Microsoft Windows 2003 Server Professional Editions. In addition, the Java WSDP software can also be installed, but is unsupported, on Windows 95, 98, ME, and NT 4.0.

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.

Note: After the Java WSDP software has been installed, you may be asked to reboot your system. To continue using these instructions after rebooting, you should print them now.

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-windows-i586.exe     23,789,469 bytes

2. Uninstall previous versions of the Java WSDP.

If you have installed a previous version of the Java WSDP, uninstall it (Start --> Programs --> Java(TM) Web Services Developer Pack 1.x --> Uninstall).

3. Run the Java WSDP installer.

The file jwsdp-2_0-windows-i586.exe is the Java WSDP installer. If you downloaded it instead of running it directly from the website, double-click on the installer's icon. Then 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:

    C:\> jwsdp-2_0-windows-i586.exe -console
    

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.

In addition, there will be an entry for Java^TM Web Services Developer Pack 2.0 in the Start --> Programs menu.

4. Delete the downloaded file. (Optional)

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 (startup.bat, shutdown.bat, ant.bat, etc.) 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:

    C:> c:\jwsdp-2.0\jwsdp-shared\bin\startup.bat
    

It is useful to set the PATH permanently, so it persists after rebooting.

How do I set the PATH permanently?

To set the PATH permanently, add the full path of the bin directory in the Java WSDP installation directory to the PATH variable. Typically, with the Sun Java System Application Server Platform Edition 8.1 2005Q2 UR1, this full path looks something like C:\Sun\AppServer\jwsdp-2.0\jwsdp-shared\\bin. To set the PATH permanently:

1. Choose Start, Settings, Control Panel, and double-click System. Select the Advanced tab and then Environment Variables. Look for "Path" in the User Variables and System Variables. If you're not sure where to add the path, add it to the right end of the "Path" in the User Variables. A typical value for PATH is:

        C:\Sun\AppServer\jwsdp-2.0\jwsdp-shared\bin 
   

   Capitalization doesn't matter. Click "Set", "OK" or "Apply".

   The PATH can be a series of directories separated by semi-colons (;). Microsoft Windows looks for programs in the PATH directories in order, from left to right. You should only have one bin directory for a Java WSDP installation in the path at a time (those following the first are ignored), so if one is already present, you can update it.

2. The new path takes effect in each new Command Prompt window you open after setting the PATH variable.
6. 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 application.

7. Uninstall the Java WSDP.

If you should ever want to uninstall the Java WSDP, use the "Add/Remove Programs" utility in the Microsoft Windows Control Panel.

You can also uninstall the Java WSDP in console mode, by executing the uninstaller.exe file in the <JWSDP_HOME>/_uninst directory:

   uninstaller.exe -console
   

Troubleshooting the Installation

Here are some tips for working around problems that could occur during or following an installation. Since the Java WSDP installer is written in the Java programming language, 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

     Error writing file = There may not be enough temporary disk space
  

  you probably do not have enough space on the disk that contains your TEMP directory. You can correct this problem by deleting unneeded files on the disk that contains your TEMP 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 from an MS-DOS shell:

     jwsdp-2_0-windows-i586.exe -is:tempdir d:\your\temporary\directory
        

• If you see the following error message

     No Java(tm) Virtual Machine was found
  

  then the installer could not find a Java^TM 2 SDK to run itself. If you do not have the J2SE 5.0 JDK software already installed on your computer you need to install it before you run the Java WSDP installer. Download J2SE 5.0 JDK from here.

  If you already have Java^TM 2 SDK installed on your machine, you can correct this problem by running the installer with the following arguments from an MS-DOS shell:

      jwsdp-2_0-windows-i586.exe -is:javahome d:\your_JavaTM_installation_directory
        

• If you see the following error message

     This program cannot be run in DOS mode.
  

  do the following:

  1. Open the MS-DOS shell (Windows/Start/Programs/MS-DOS Prompt).
  2. Right-click on the title bar.
  3. Select Properties.
  4. Choose the Program tab.
  5. Push the Advanced button.
  6. Make sure the item "Prevent MS-DOS-based programs from detecting Windows" is unchecked.
  7. Select OK.
  8. Select OK again.
  9. Exit the MS-DOS shell.
  10. Restart your computer.

  If that does not help, the file you have downloaded is probably corrupted. Check its file size against the expected file size listed in these instructions. If they don't match, try downloading the bundle again.

• If you see the following error message on Windows 2000

     config.nt. The system file is not suitable for running MS-DOS 
     and Microsoft Windows Applications.
  

  there is a problem with the %SystemRoot%\System32\COMMAND.COM file. This problem has been seen on some installations of Windows 2000. If you encounter this error message when you try to launch the installer, consult the Microsoft website at

     http://support.microsoft.com/support/kb/articles/Q142/2/71.asp
        

  for information about resolving the problem.