In this section: |
iWay Service Manager provides support for servlet deployment within various application servers, such as Apache Tomcat, IBM WebSphere, Sun Application Server, and JBoss. The Deployment Manager allows you to create a standalone configuration under iWay Service Manager and then create a corresponding web application (.WAR) that encapsulates the configuration. The web application includes all the required components for the configuration and the iWay Software components necessary to run iWay Service Manager as a standalone web application.
Note: Any required third-party components must be registered separately with the application server. The deployed iWay Service Manager servlet is designed to be used as a run-time environment. Only one .WAR can be used per Application Server configuration.
You must first install the iWay Service Manager release on your local system and then create a configuration that can include channels, web services, and any other required components for the solution. Once the configuration has been fully tested and is ready to be deployed to the Application Server, follow the steps below.
To create web applications based on iSM configurations:
http://host:port
where:
Is the name of the server where iSM is installed.
Is the port on which the server console is listening. The default is 9999.
The Deployment Manager pane opens.
The following table lists and describes each parameter for the Deployment Manager.
Parameter Name |
Description |
---|---|
Name |
Name of the web application module. |
Descriptions |
Optional description for the created module. |
Deployment Profile |
Lists the available deployment profiles:
Additional custom profiles may be created. |
Server Configuration |
List of available server configurations. Select the configuration for which you created a deployment. You do not need to select base since it is included by default. |
The Special Registers pane opens, which list the special registers defined within the selected configuration. Select the special registers you wish to modify for this deployment.
Note: Do not select the ibse port. The default application server port will be used for running web services.
After the process is complete, the Deployment file is displayed in a list and can be selected for download.
To download the module click on the download icon as shown in the following image.
The downloaded Deployment file can now be deployed to an Application Server and will reflect the contents of the deployed iSM configuration that was selected.
This section describes the deployment of the iSM-based web application module to the WebSphere environment. This process would be different depending on the Application Server. Refer to the User Guide of your Application Server for details on the Application Deployment. To deploy within the WebSphere 6.1 environment you can follow the steps provided.
To deploy the web application module to WebSphere:
Note: The Context root must be consistent with the web.xml file.
On the following screens of the WebSphere deployment process, you can either accept all the default configuration parameters or modify them to fit your WebSphere environment.
Once it is saved successfully, the application can be managed by navigating to Applications and selecting Enterprise Applications. It is recommended to restart the server after the installation has been completed.
http://host:port/Contextroot/console
where:
Is the server where the web application is running.
Is the port where the web application is running.
Is the context root provided for the application.
You will be prompted for the user/password to log on to the iSM console. After providing the information, you can use the full iSM Console to manage your configuration and ensure that it is running properly.
The web.xml file is a text-based XML file that provides configuration and deployment information for the web components that comprise a web application. The web.xml file resides in the WEB-INF directory under the context of the hierarchy of directories that exist for a web application. Examples of web components are servlet parameters, servlet and JavaServer Pages (JSP) definitions, and Uniform Resource Locators (URL) mappings. The Java Servlet 2.4 specification defines the web.xml deployment descriptor file in terms of an XML schema document. For backwards compatibility of applications written to the Java Servlet 2.3 specification, web containers are also required to support the Java Servlet 2.3 specification.
You can deploy iWay Service Manager as a web application. Additionally, you can use the Deployment Manager to create a customizable and reusable web application.
The following sample illustrates a typical web.xml that is created by the Deployment Manager:
<?xml version="1.0" encoding="UTF-8"?> <web-app xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd" xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" id="homebase" version="2.4"> <display-name>iWay 7 smsp2.13562 - homebase</display-name> <servlet> <servlet-name>homebase</servlet-name> <servlet-class>com.ibi.edaqm.ServiceManager</servlet-class> <init-param> <param-name>console</param-name> <param-value>web</param-value> </init-param> <init-param> <param-name>config</param-name> <param-value>base</param-value> </init-param> <init-parm> <param-name>MySpecialRegister</param-name> <param-value>ABC123</param-value> </init-parm> </servlet> <servlet-mapping> <servlet-name>homebase</servlet-name> <url-pattern>/*</url-pattern> </servlet-mapping> </web-app>
This section describes the group of special predefined parameters that are reserved to help control the behavior of iWay Service Manager.
This parameter names the configuration that the servlet is based on. If omitted its default value is base.
<init-param> <param-name>config</param-name> <param-value>base</param-value> </init-param>
console
This optional parameter controls the support of a console. It may be omitted or its value may be left empty. If it is missing or invalid, no console support is assumed. Currently the only valid value is web.
<init-param> <param-name>console</param-name> <param-value>web</param-value> </init-param>
ibsp
This optional parameter names the location of the IBSP that the iWay adapter will reference. Note that the URL defined in the connection parameters of iWay adapter targets (typically set to http://localhost:9000) changes as iSM is deployed as a servlet. To accommodate this change we instruct IBSP to replace the target endpoints as follows. The value is taken as a base URL.
<init-param> <param-name>ibsp</param-name> <param-value>http://localhost:8080</param-value> </init-param>
In addition to the reserved parameters, there may be additional parameters in your web.xml file. The web application driver of iWay Service Manager treats these parameters as System Special Registers. This allows an Administrator the reconfigure the values of these variables by updating the web.xml file according to your specific application server implementation. For example:
<init-param> <param-name>MySpecialRegister</param-name> <param-value>ABC123</param-value> </init-param>
iWay Software |