Sun Java Solaris Communities My SDN Account
 
Developer Pack 1.1 Download

Installation notes - Unix

 

Installation Notes

Java Web Services Developer Pack v1.1 (Java WSDP)
Solaris Operating Environment (Supported)
Linux (Supported)
Mac OS X (Unsupported)
Other UNIX® Platforms (Unsupported)

System Requirements | Installation Instructions | Troubleshooting

The Java Web Services Developer Pack (Java WSDP) v1.1 software is supported on the following platforms:

  • Solaris Operating Environment, versions 8, and 9
  • Linux on Intel Pentium machines with kernel version 2.2.12 and glibc version 2.1.2-11 or later

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 version 1.3.1 or higher of the following software already installed on your computer:

  • Java 2 SDK, Standard Edition (J2SE SDK)

This software can be downloaded from the J2SE website.

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

Installation Instructions

In this procedure, you will 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 website, check to see that you have the complete file:
jwsdp-1_1-unix.sh  35,824,515 bytes

2. Uninstall Early Access Versions of the Java WSDP

If you have previously installed a version of the Java WSDP (EA or FCS), we recommend installing this version in a different directory. If you want to uninstall the previous version, run the uninstall.sh script.

3. Run the Java WSDP installer

The file jwsdp-1_1-unix.sh is the Java WSDP installer. If you downloaded it instead of running it directly from the website, execute the following command in a shell to launch the installer. Then follow the instructions that the installer provides. When done with the installation, you can delete the download file to recover disk space.

% /bin/sh jwsdp-1_1-unix.sh

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

% /bin/sh jwsdp-1_1-unix.sh -console

Follow the instructions that are displayed.

When you are done with the installation, you can delete the download file to recover disk space.

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.
Set the PATH variable to include ant, if you want to be able to conveniently run the Java WSDP samples that use ant (e.g., JAXB examples).

Add the full path of the ant bin directory in the Java WSDP installation directory to the beginning of your PATH variable. Prepend "jakarta-ant-1.5.1/bin" to the directory where JWSDP is installed.

Should I set the PATH variable?
Set the PATH variable if you want to be able to conveniently run the Java WSDP executables (startup.sh, shutdown.sh, ant, 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 specifythe full path to the executable every time you run it, such as:

% /home/myuser/jwsdp-1_1/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-1_1/bin.

6. Start using the Java WSDP!

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

7. Uninstalling the Java WSDP

If you should ever want to uninstall the Java WSDP, execute the uninstall.sh command in the jwsdp-shared/bin directory in the Java WSDP installation directory.

Troubleshooting the Installation

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

  • If you see the following error message when installing on Linux with J2SE SDK v1.4.1:
    Errors occured during installation

    and if the log.txt file in the installation directory contains error messages, such as the following:

    (error code = 315; message = ""; severity = 0)
    STACK_TRACE: 22
    ServiceException: (error code = 315; message = ""; severity = 0)
    at 
    com.ibm.wizard.platform.linux.LinuxRegistryServiceImpl.
    getPackageInfo(LinuxRegistryServiceImpl.java:221)

    click the Back button then the Next button to enable the installation to complete.

    If this does not work:

    • Install the Java WSDP v1.1 software with J2SE SDK v1.4.0.

      or

    • Install the Java WSDP v1.1 software on a different platform (preferably a UNIX platform) then copy the installation image over to your Linux machine.

  • If the installation hangs at the first screen, which remains blank

    Check your DNS configuration and make sure you can ping hosts in your local domain with an unqualified name.

  • If the installation hangs and the command window shows the message "NFS Server Not Responding"

    Remove any references to the unresponsive server from your PATH and file system mount table (i.e., unmount any file systens from that server).

  • 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-1_1-unix.sh -is:tempdir /your/temporary/directory
  • If you see the following error message:
    Cannot find Java 2 Platform, Standard Edition
    then the installer could not find a Java 2 SDK to run itself. If you do not have a Java 2 SDK installed on your machine, you need to download from the J2SE website and install it before you run the Java WSDP installer. If you already have Java 2 SDK installed on your machine, you can correct this problem by running the installer with the following arguments:
    jwsdp-1_1-unix.sh -is:javahome /your/Java/installation/directory

Oracle is reviewing the Sun product roadmap and will provide guidance to customers in accordance with Oracle's standard product communication policies. Any resulting features and timing of release of such features as determined by Oracle's review of roadmaps, are at the sole discretion of Oracle. All product roadmap information, whether communicated by Sun Microsystems or by Oracle, does not represent a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. It is intended for information purposes only, and may not be incorporated into any contract.