Siebel Store-and-Forward Messaging Guide for Handheld > Installation and Configuration of Siebel Store-and-Forward Messaging > Process of Deploying IBM MQe Queue Managers >
Installing the MQe Servlet
You deploy MQe as a Java 2 Enterprise Edition (J2EE)-compliant Web application, or servlet. You install this Web application into a J2EE-compliant Web server or Web server plug-in (container or servlet container). NOTE: The Web server that hosts the MQe Servlet can be based on either the Windows or Unix operating system.
To perform this procedure, it is recommended that you first be familiar with installing Java servlets on the Web server. To install the MQe Servlet
- Make sure your system meets the following requirements:
- Locate the MQe servlet on your installation media.
The servlet is delivered as part of the Siebel Server installation package, in the <Siebel_Server>\classes\SiebelSMQServlet.war file. You can open .war files with winzip or any extraction tool that can decompress zip files.
- Follow the procedure specific to your Web server or servlet engine for installing the MQe servlet.
This might mean copying the servlet directory tree into a directory that is specified by the Web server or servlet engine. Alternatively, it might mean running a configuration utility built into the server or engine. For a Tomcat server, you run the Tomcat Manager utility and deploy Context Path /smq using the complete path to your SiebelSMQServlet.war file as the WAR or Directory URL. For details of this procedure, see the documentation for your Web server or servlet engine.
The MQe queue manager is deployed in a directory that conforms to the J2EE Web application specification. This structure consists of specially-named subdirectories containing the necessary Java class files and configuration information. The layout is as follows:
<root>\ WEB-INF\ web.xml lib\ MQeBase.jar MQeSecurity.jar SiebelSMQ.jar
The files in this directory structure are described in the following table.
|
|
web.xml |
Deployment descriptor file that configures the servlet according to the J2EE servlet specification |
MQeBase.jar |
Redistributable binary file from MQe |
MQeSecurity.jar |
Redistributable binary file from MQe |
SiebelSMQ.jar |
Siebel servlet implementation |
- Make a backup copy of the Web server's web.xml file, then open the web.xml file in a text editor and complete the following steps to change the DataDir parameter to specify the directory where you want the queues to be stored:
- Locate the following portion of the file:
<web-app> ... <servlet> ... <servlet-name>ServerQM</servlet-name> <init-param> <param-name>DataDir</param-name> ... <param-value>CHANGE_ME</param-value> </init-param> </servlet>
- Replace CHANGE_ME with the path to the directory where you want Store-and-Forward Messaging queues to be located.
NOTE: Queues will be located in the MQe\servlet-name subdirectory of the directory that you specify. For example, if you specify a DataDir value of C:\Siebel and leave the default servlet name of ServerQM unchanged, then queues will be located in C:\Siebel\MQe\ServerQM.
- Save and close the web.xml file.
- Restart the servlet.
At runtime, after the first time the servlet runs, the system populates the directory specified by the web.xml file's DataDir parameter with the queues.
After installation, the servlet starts automatically the first time a client or a Siebel Server accesses it. The servlet shuts down when the Web server shuts down.
|