Integrating the Java WSDP Component Technologies with a Web Container

This document explains how to run the integration scripts that come with the Java WSDP. These scripts allow you to integrate the Java WSDP technologies with a web container, if you originally installed the Java WSDP with the "No Web Container" option, or with a web container that is different from the one that you selected at installation time.

This document also describes the steps you need to follow to perform an integration after performing a "Custom" installation and explains what you must do before you uninstall the Java WSDP.

Integrating the Java WSDP Component Technologies with the Sun Java System Application Server Platform Edition 8

Complete the following steps to integrate the Java WSDP 1.6 component technologies with Sun Java System Application Server Platform Edition 8:

  1. Change to the <JWSDP_HOME>/jwsdp-shared/bin directory.

  2. Modify the following properties in the sjsas.props file:

    1. Set the USERNAME property to your admin username.

    2. Set the PASSWORD property to your admin password.

    3. Set the SJSAS_PORT property to your http server port.

    4. Set the DOMAIN_DIR property to the domain directory.

    5. Set the ADMIN_PORT_LIST property to a comma-separated list of the admin ports from each domain.

    6. Set the DOMAIN_DIR_LIST property to a comma-separated list of domain directories.

    7. Set the DOMAIN_NAME_LIST property to a comma-separated list of domain_names.

    8. Set the SJSAS_PORT_LIST property to a comma-separated list of the http server ports from each domain.

    9. Set the DOMAIN_NAME property to the domain name.

    10. Set the ADMIN_PORT to your admin port.

  3. If you performed a "Typical" installation (installed all of the Java WSDP 1.6 component technologies), run the jwsdponsjsas.sh (Solaris/Linux) or jwsdponsjsas.bat (Windows) integration script.

    If you performed a "Custom" installation (installed a subset of the Java WSDP 1.6 component technologies), run the integration script using the following targets:

    1. integrate.init to initialize the integration

    2. integrate.<component-technology> to integrate the component technology or technologies

      Look at the setup target to see what target(s) you need to execute for the component technology or technologies that you installed.

  4. Edit the <jwsdp.home>/conf/jwsdp.properties file, then add and set the following properties:
    http.proxyHost=
    http.proxyPort=

    so applications, such as the WS-I Sample application, can access servers outside a firewall.

  5. Run the integration script using the revert.sjsas.changes target before you uninstall the Java WSDP.

Integrating with the Sun Java System Web Server 6.1

Complete the following steps to integrate the Java WSDP 1.6 component technologies with the Sun Java System Web Server 6.1 Container:

  1. Change to the <JWSDP_HOME>/jwsdp-shared/bin directory.

  2. Modify the following properties in the sjsws.props file:

    1. Set the SERVER_INSTANCE property to the server instance directory name (typically with the format https-<servername>) and the SERVER_INSTANCE_LIST property to a comma delimited list of server instances.

    2. Set the SJSWS_PORT property to the server instance port number and the SJSWS_PORT_LIST property to a comma delimited list of server instance port numbers which correspond to the server instances in the SERVER_INSTANCE_LIST property.

  3. If you performed a "Typical" installation (installed all of the Java WSDP 1.6 component technologies), run the jwsdponsjws.sh (Solaris/Linux) or jwsdponsjsws.bat (Windows) integration script.

    If you performed a "Custom" installation (installed a subset of the Java WSDP 1.6 component technologies), run the integration script using the following targets:

    1. integrate.init to initialize the integration

    2. integrate.<component-technology> to integrate the component technology or technologies

      Look at the setup target to see what target(s) you need to execute for the component technology or technologies that you installed.

    3. stop-sjsws to stop the Web Server

    4. start-sjsws to restart the Web Server

    5. If applicable, any of the following targets to deploy the installed sample applications:

      • deploy.wsi-sampleapp.webapps deploys the WS-I Sample application
      • deploy.saaj.webapps deploys the SAAJ sample applications
      • deploy.registry-server.webapps deploys the Java WSDP Registry Server
  4. Edit the <jwsdp.home>/conf/jwsdp.properties file, then add and set the following properties:
    http.proxyHost=
    http.proxyPort=

    so applications, such as the WS-I Sample application, can access servers outside a firewall.

  5. Run the integration script using the revert.sjsws.changes target before you uninstall the Java WSDP.

Integrating the Java WSDP Component Technologies with the Tomcat 5.0 for Java WSDP Container

Complete the following steps to integrate the Java WSDP 1.6 component technologies with the Tomcat 5.0 for Java WSDP Container:

  1. Make sure that your JAVA_HOME and CATALINA_HOME environment variables have been set.

  2. Change to the <JWSDP_HOME>/jwsdp-shared/bin directory.

  3. If you performed a "Typical" installation (installed all of the Java WSDP 1.6 component technologies), run the jwsdpontomcat.sh (Solaris/Linux) or jwsdpontomcat.bat (Windows) integration script.

    If you performed a "Custom" installation (installed a subset of the Java WSDP 1.6 component technologies), run the integration script using the following targets:

    1. integrate.init to initialize the integration

    2. integrate.<component-technology> to integrate the component technology or technologies

      Look at the setup target to see what target(s) you need to execute for the component technology or technologies that you installed.

  4. Edit the <jwsdp.home>/conf/jwsdp.properties file, then add and set the following properties:
    http.proxyHost=
    http.proxyPort=

    so applications, such as the WS-I Sample application, can access servers outside a firewall.

  5. Run the integration script using the revert.tomcat.changes target before you uninstall the Java WSDP.


Please send feedback on the Java Web Services Developer Pack to users@jwsdp.dev.java.net.

Copyright © 2005 Sun Microsystems, Inc. All rights reserved.