Integrating JWSDP Components into the Sun(TM) ONE Application Server, Standard Edition

Integrating JWSDP Components on the Sun^TM ONE Application Server, Standard Edition, Evaluation Only Version

You can use the jwsdponsunone script to integrate Java^TM Web Services Developer Pack (Java WSDP) components into the Sun^TM ONE Application Server 7, Standard Edition, Evaluation Only version.

Make sure that you download the version that includes Sun ONE Studio:

Click here to download the S1AS 7 software for Microsoft Windows XP/2000 and Linux.
Click here to download the S1AS 7 software for Solaris.

This document explains how to use the script with different targets to do the following:

Set up the S1AS server environment to use the Java WSDP 1.3 components
Start the S1AS administrative server
Start the S1AS server instance
Stop the S1AS server instance
Reverse the changes to the S1AS server

Note: You must have performed a "Typical" installation of Java WSDP (installed all of the components) if you want to use the installation for integration with the S1AS server. If you performed a "Custom" installation, not all of the required JAR files would have been installed. If the jwsdponsunone script cannot locate these JAR files, it will not execute properly and the integration will fail.

You can either execute these instructions by changing to the <JWSDP_HOME>/jwsdp-shared/bin directory or by using the full path of the shell script (jwsdponsunone.sh) or batch file (jwsdponsunone.bat).

Setting up the S1AS Server Environment to use the Java WSDP 1.3 Components

Complete the following steps to set up the S1AS server environment:

Modify the following properties in the <JWSDP_HOME>/jwsdp-shared/bin/s1as.props file:
- USERNAME: Enter your Sun ONE Application Server admin username.
- PASSWORD: Enter your Sun ONE Application Server admin password.
- S1AS_HOST: Enter the location where the S1AS server is running. The default setting for this property is localhost, which you do not need to change if you are running the S1AS server on the same machine where you are running the script.
  
  This setting is only needed for starting and stopping the S1AS server.
- ADMIN_PORT: Enter the port number where the S1AS administrative server is listening. The default value is 4848.

Note: Perform this step exactly one time; do not repeat the setup step.

Execute the appropriate target to integrate all the required JAR files into the Sun ONE Application Server and update the CLASSPATH of the server:

	`jwsdponsunone.sh <S1AS_HOME>`		[UNIX/Linux]
	`jwsdponsunone.bat <S1AS_HOME>`		[Windows]

The setup process may take 5 to 10 minutes to complete, depending on your machine. Do not terminate the setup process; wait for it to complete.

Starting the S1AS Administrative Server

You need to start the S1AS administrative server to deploy Web applications.

Execute the appropriate target to start the administrative server:

	`jwsdponsunone.sh <S1AS_HOME> startadmin`		[UNIX/Linux]
	`jwsdponsunone.bat <S1AS_HOME> startadmin`		[Windows]

Starting and Stopping the Sun ONE Application Server

Starting the Sun ONE Application Server

Execute the appropriate target to start the Sun ONE Application Server:

	`jwsdponsunone.sh <S1AS_HOME> start-s1as`		[UNIX/Linux]
	`jwsdponsunone.bat <S1AS_HOME> start-s1as`		[Windows]

Wait for the server to start up completely.

Stopping the Sun ONE Application Server

Execute the appropriate target to stop the Sun ONE Application Server:

	`jwsdponsunone.sh <S1AS_HOME> stop-s1as`		[UNIX/Linux]
	`jwsdponsunone.bat <S1AS_HOME> stop-s1as`		[Windows]

Wait for the server to shut down completely.

Reversing Changes to the Sun ONE Application Server

Execute the appropriate target to back out all of the changes that were made to the S1AS server during the integration of the Java WSDP components:

	`jwsdponsunone.sh <S1AS_HOME> revert.s1as.changes`		[UNIX/Linux]
	`jwsdponsunone.bat <S1AS_HOME> revert.s1as.changes`		[Windows]

Please send feedback on this Java WSDP release to jwsdp-feedback@sun.com.