ibaan OpenWorld Adapter Suite 2.3 Configuration Guide for MSMQ

Transcription

1 ibaan OpenWorld Adapter Suite 2.3

2 A publication of: Baan Development B.V. P.O.Box AC Barneveld The Netherlands Printed in the Netherlands Baan Development B.V All rights reserved. The information in this document is subject to change without notice. No part of this document may be reproduced, stored or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Baan Development B.V. Baan Development B.V. assumes no liability for any damages incurred, directly or indirectly, from any errors, omissions or discrepancies between the software and the information contained in this document. Document Information Code: U7996A US Group: User Documentation Edition: A Date: August, 2002

3 Table of contents 1 Introduction Overview Example of an ibaan OpenWorld environment that uses MSMQ 1-2 Prerequisites To install and register MSMQ connection points 2-1 To create MSMQ connection points Installation of MSMQ Installation of MSMQ To create a MSMQ queue To register connection points in the Directory Service i

4 Table of contents ii

5 About this document This guide describes how to configure MSMQ for use with ibaan OpenWorld. MSMQ stands for Microsoft Message Queueing. This document refers to both MSMQ 1.0, as provided with the Windows NT 4 Option Pack, and MSMQ 2.0, as delivered with Windows This guide is intended for system managers responsible for installation and maintenance of components in an ibaan OpenWorld environment that uses MSMQ. This document does not explain how to install ibaan OpenWorld Adapter or the complete MSMQ server software, but details the basic actions you must perform to install and configure MSMQ for use with ibaan OpenWorld Adapter. Chapter 1, Introduction, describes the function of MSMQ in ibaan OpenWorld Adapter and provides an example installation configuration. This chapter also describes the basic requirements for an MSMQ installation. Chapter 2, To install and register MSMQ connection points, describes the steps you must take to install message queues on ibaan OpenWorld clients and the subsequent actions you must take to set up MSMQ for use with ibaan OpenWorld. Related documents ibaan OpenWorld Adapter Suite Installation and Configuration Guide for Adapter (U8008A US) ibaan OpenWorld Adapter Suite Installation and Configuration Guide for Adapter for ibaan ERP (U7978A US) ibaan OpenWorld Adapter Suite Configuration Guide for MQSeries (U7995A US) iii

6 About this document iv

7 1 Introduction ibaan OpenWorld offers integration between various software components by transporting XML documents. ibaan OpenWorld Adapter supports several thirdparty Message Oriented Middleware (MOM) applications to actually transport the XML documents, of which MSMQ is one. Overview On the client side, an application requests data from an OpenWorld-enabled server (for example, ibaan ERP). The ibaan OpenWorld Adapter creates an XML document that defines the request. MSMQ places the document in a queue that is serviced by the OpenWorld-enabled server. On the server side, the ibaan OpenWorld Adapter retrieves the XML document from the queue, interprets it, and invokes the appropriate function on the server application. The server then acts on the contents of the XML document; it can, for example, produce a list of customers. The Adapter creates an XML document that contains the response. MSMQ then takes care of delivering the message to the client that requested the data. MSMQ is a Message Oriented Middleware (MOM) product that provides an asynchronous facility to transport the XML documents. MSMQ keeps track of all MSMQ objects (such as machines and queues) dynamically. This improves scalability, as administrative operations, such as adding computers or moving queues, can be performed centrally and do not require any changes to be made to individual computer configurations. In addition, applications on any computer within an MSMQ Enterprise can send messages to an application on any other computer, with no preconfiguring of channels or routes required. The MSMQ transport layer is hidden from the user and the integration developer. MSMQ runs in a Microsoft Windows environment on NT/2000 servers/clients and on Windows 95/98. For more information on MSMQ, refer to the documentation that is provided by Microsoft. 1-1

8 Introduction Example of an ibaan OpenWorld environment that uses MSMQ In each environment in which you run MSMQ middleware, you need a server that runs the MSMQ Enterprise Controller and one or more servers that run the MSMQ Site Controller. 1 The Enterprise Controller holds details of the queue locations and other servers that have access to queues and messages. It supplies information to all other computers when they need to locate a queue. A Site Controller holds details about machines that have a fast connection between them, for example, all computers in a single building. If your environment is fairly simple, the Enterprise Controller can also provide the services of a Site Controller. The following figure provides an example of what the Baan OpenWorld environment in which you run MSMQ can look like: Client computers BaanSCS Client Baan Windows icrm Client Laptop icrm queue queue queue queue LDAP Directory Service BaanERP Baan OW Broker icrm MSMQ Enterprise Controller Site Controller BaanSCS Server computers In this example, three applications (BaanERP, icrm, BaanSCS) use MSMQ to connect to the Baan OpenWorld environment. Each of these applications needs an MSMQ message queue, which is a bucket that holds messages that are either in transit or waiting for collection. Each server computer needs MSMQ client or server software. If more than one application runs on a server or on a client, you need a message queue for each of the applications. 1 For Windows2000, an Enterprise Controller is no different from a Site Controller. You need one or more servers that run MSMQ. 1-2

9 Introduction Prerequisites For information on how to install MSMQ and the installation prerequisites, refer to the MSMQ documentation. Although this section does not describe the installation prerequisites in detail, some highlights are described. Before you start to install queues and server software on servers and clients that must connect to ibaan OpenWorld, you must have an MSMQ Enterprise Controller and a Site Controller on your network. BackOffice-related prerequisites To install MSMQ successfully, you need one of the following Windows editions on the MSMQ server: Windows NT 4.0 Enterprise Edition with which MSMQ 1.0 is released. NOTE Windows2000 Server, with which MSMQ 2.0 (also known as Message Queuing Services) is released. Note that MSMQ heavily relies on the Windows security. As the Windows security is based on the domains concept, the machines that participate within an MSMQ configuration must be located in one and the same Windows domain. MSMQ 1.0 uses SQL Server 6.5; and ibaan ERP uses SQL Server 7.0. You cannot run both versions of SQL Server on the same server. This means that if you want to install ibaan ERP and an MSMQ Enterprise or Site Controller on the same machine, you must use a non-sql-server database for ibaan ERP; or switch to MSMQ 2.0 and Windows To install an MSMQ 1.0 message queue successfully on the client, you require: Windows NT 4.0 SP3 or Windows 95/98. Windows NT Option Pack 4.0. To install an MSMQ 2.0 message queue successfully on the client, you require: Windows2000, with the Message Queueing Services (MSMQ) component installed. 1-3

10 Introduction ibaan OpenWorld Adapter prerequisites The ibaan OpenWorld Adapter software does not need to be installed before you install MSMQ and the message queues that are required for the ibaan OpenWorld environment. You must have an LDAP Directory Service available to register the MSMQ message queues after you install them. ibaan OpenWorld Adapter provides a BusComponent Editor utility for easy registration in the Directory Service. The registration steps are described in the ibaan OpenWorld Adapter Suite Installation and Configuration Guide for Adapter (U8008A US). Chapter 2, To install and register MSMQ connection points, describes the MSMQ connection point installation and assumes that you have a Server that hosts a previously-installed Enterprise Controller and Site Controller. 1-4

11 2 To install and register MSMQ connection points Each application (whether server or client) that is connected to ibaan OpenWorld Adapter by MSMQ middleware has a connection point; that is, a message queue that processes the XML documents for the application. This connection point must be registered in the Directory Service. This chapter describes how to create a connection point that can be used for ibaan OpenWorld Adapter and how to register connection points in the Directory Service. To create MSMQ connection points Before you create a connection point, make sure that the MSMQ Enterprise Controller and the Site Controller(s) are properly configured in your network. The following installation procedure is an MSMQ client installation and must be performed on each participating machine that is not an MSMQ Enterprise Controller or Site Controller. You can run the installation with the NT 4 Option Pack or with the Windows 2000 installation CD-ROM. You must first create an administrator user (Administrative Account). 2-1

12 To install and register MSMQ connection points Installation of MSMQ 1.0 To install MSMQ 1.0, log on with an NT administrator account for the computer on which you install MSMQ and take the following steps: 1 Insert the NT 4 Option Pack CD-ROM and start the installation of the Option Pack. After you accepted the license agreement, click Custom. The following dialog box appears. 2 Clear all listed components. Then select the Microsoft Message Queue check box. The Setup program automatically selects all other required components. Click Next. 2-2

13 To install and register MSMQ connection points The following dialog box appears. 3 Choose an installation folder and click Next. 2-3

14 To install and register MSMQ connection points The following dialog box appears. 4 Select Remote administration if you want to maintain queues remotely; this is probably the most practical option if you have many message queues to maintain in your environment. Fill in the Administrator Account field, the Password field, and the Confirm Password field. Click Next. 2-4

15 To install and register MSMQ connection points The following dialog box appears. 5 Select Independent Client; this allows you to work even if you are not connected to the network or if the network is not available. The client synchronizes with the rest of the MSMQ once it is connected to the network. Click Next. 2-5

16 To install and register MSMQ connection points The following dialog box appears. 6 Enter the name of the server on which the MSMQ Site Controller resides. Click Next and the installer browses the network for the Site Controller. 2-6

17 To install and register MSMQ connection points When it is found, the following dialog box appears. 7 Choose the installation folder and click Next. The installer now starts to copy files. When the installation process has completed, click Finish. The following dialog box appears. 8 Click Yes. Your MSMQ software installation is complete. After the computer has restarted, continue with the section To create a MSMQ queue to actually create and configure the message queue. 2-7

18 To install and register MSMQ connection points Installation of MSMQ 2.0 To install MSMQ 2.0, log on with a Windows administrator account for the computer on which you install MSMQ, and take the following steps: 1 On the Start menu, point to Settings, and click Control Panel. 2 In Control Panel, double-click Add/Remove Programs. 3 Click Add/Remove Windows Components. 4 Select the Message Queueing Services component, then click Next. 5 Select Message Queueing server and click Next 2. If this is the first MSMQ server in the domain, the installation continues with Step 7. 2 For some Windows2000 versions (for example, Professional), this dialog box is slightly different. The Message Queueing server option button is called Independent client in these cases. If that dialog box appears, select Independent client and click Next. 2-8

19 To install and register MSMQ connection points 6 Select Message Queueing will access a directory service, fill in the Domain controller and click Next. 7 The MSMQ installation now starts; follow the on-screen instructions. To create a MSMQ queue 1 Start the MSMQ Explorer (for MSMQ 1.0, usually Start NT Option Pack Microsoft Message Queue Explorer; for MSMQ 2.0, usually Start Programs Administrative Tools Computer Management, then Services&Applications Message Queueing). 2 For MSMQ 1.0, open your own Sites folder. For MSMQ 2.0, open the Public Queues folder. 2-9

20 To install and register MSMQ connection points 3 Right-click the icon and click New Queue. The following dialog box appears. 4 Enter the message queue name and click OK. NOTE Do not select the Transactional check box. 5 For MSMQ 1.0, open the folder for your computer. 6 Right-click the message queue you created and select Properties. On the Security tab, click Permissions. Define the user permissions. Users that read from this queue must have Special Access. You can either define permissions for individuals or choose to define special access for Everyone. The following example dialog boxes show Special Access for Everyone. 2-10

21 To install and register MSMQ connection points 7 Select Everyone and in the Type of Access list, select Special. The following dialog box appears (in MSMQ 2.0, both dialog boxes are integrated as one and access restrictions do not differ between MSMQ 1.0 and MSMQ 2.0). 8 Make the selections you want in the Special dialog box and click OK. In the Queue Permissions dialog box, fill the other fields and click OK. You have now installed the MSMQ message queue with appropriate permissions. This sequence of steps must be repeated for all other clients and servers that must link to the ibaan OpenWorld environment with MSMQ message queues. 2-11

22 To install and register MSMQ connection points To register connection points in the Directory Service EXAMPLE Each connection point has a Uniform Resource Identifier (URI). This URI always starts with a protocol type that determines the transport layer that must be used. For MSMQ, the URI also defines the server on which the message queue is located and the name of this message queue on this server. The URI syntax for MSMQ is defined as: msmq://queueserver/queuename msmq://cnl07812/baanqueue1 Use the ibaan OpenWorld BusComponent Editor to enter this data in the Directory Service. Note that you must use the correct spelling and case. For more information, refer to ibaan OpenWorld Adapter Suite Installation and Configuration Guide for Adapter (U8008A US). 2-12