WebSphere WebSphere Application Server Express, Version 6.0.x Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Installing the SIBWS and endpoint listener applications

Use this topic to install into an application server the service integration bus Web services enablement (SIBWS) and endpoint listener applications. These applications are copied to your file system by the WebSphere Application Server installation program.

Before you begin

This topic assumes that you have already determined the set of servers on which to install the SIBWS and endpoint listener applications, and completed the steps and prerequisites that are described in Installing the service integration technologies resource adapter.

By default, even if global security is enabled, all users can access any inbound service deployed to an endpoint listener. You change this default and restrict access as described in Password-protecting inbound services. For SOAP over JMS, you can make these security changes after you have installed the endpoint listener application. However, if you want to change the default SOAP over HTTP endpoint listener security role, you must do so before you install the HTTP endpoint listener application.

Why and when to perform this task

The SIBWS application enables Web services configuration and access through a service integration bus.

An endpoint listener is the point (address) at which messages for an inbound service are received. The endpoint listeners that are supplied with WebSphere Application Server support SOAP over HTTP and SOAP over JMS bindings. For an overview of endpoint listeners, see Endpoint listeners and inbound ports - entry points to the service integration bus. The installation of endpoint listeners is optional. However, if you want to create inbound services, you must install at least one endpoint listener.

You install the SIBWS and endpoint listener applications by using the wsadmin scripting client to run the sibwsInstall.jacl script. This script is provided in the install_root/util directory, where install_root is the root directory for the installation of IBM WebSphere Application Server.

Complete the following steps for every server on which you want to install the SIBWS or an endpoint listener application:

Steps for this task

  1. Open a command prompt, then change to the install_root/bin directory.
  2. Optional: If you have installed a synchronous SOAP over JMS endpoint listener application, and you want to change the default values for the activation specification (or listener port ), modify the installed applications by completing the following steps for each endpoint listener application:
    1. In the administrative console navigation pane, click Applications > Enterprise Applications. A list of all installed enterprise applications is displayed.
    2. Click the name of the endpoint listener application (for example SOAPJMSendpoint listener1). Configuration details for the application are displayed.
    3. Scroll down through the configuration details to the Additional Properties pane, then click Provide listener bindings for message-driven beans. The Binding enterprise beans to listener port names or activation specification JNDI names pane is displayed.
    4. Under the Bindings section, select either Listener port or Activation Specification.
    5. Change the activation specification JNDI name (or listener port name) to the required value, then click OK to return to the Additional Properties pane.
    6. Save your changes to the master configuration.
  3. Optional: If you have installed a synchronous SOAP over JMS endpoint listener application, and you want to change the default value for the reply queue connection factory, modify the installed application by completing the following steps:
    1. In the administrative console navigation pane, click Applications > Enterprise Applications. A list of all installed enterprise applications is displayed.
    2. Click the name of the endpoint listener application (for example SOAPJMSendpoint listener1). Configuration details for the application are displayed.
    3. Scroll down through the configuration details to the Additional Properties pane, then click Map resource env entry references to resources The Mapping resource environment references to resources pane is displayed.
    4. Change the connection factory value from (for example) jms/SOAPJMSFactory1 to the required value, then click OK to return to the Additional Properties pane.
    5. Save your changes to the master configuration.
  4. Optional: If you have installed a synchronous SOAP over JMS endpoint listener application, bind the JMS resources by stopping then restarting the application server.

You are now ready to configure the SIBWS to work in a secure service integration bus.

Related tasks
Installing the SDO repository
Installing the service integration technologies resource adapter
Related reference
SIBWS installation files and locations

Task topic

Terms of Use | Feedback

Last updated: 2 Aug 2005
http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.pmc.express.doc\tasks\tjw_install_sibws_epl.html

© Copyright IBM Corporation 2004, 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)