| This
is work in progress. Please check back soon for actual content. |
Info
This section describes a "how-to" for an intial setup of Lotus
Expeditor integrator and the step-by-step configuration for the different
use cases described in section
6.2
Solution design. For further details
of use and administration please check Lotus Expeditor integrator UsersGuide.pdf
and AdministratorsGuide.pdf (contained in installation image).
Prerequisites
Nevertheless Lotus Expeditor integrator is self contained it makes sense
only in combination with a Backbone Service Bus at the Head Office. For
testing purposes you need to setup a VMWare image with following software
- Microsoft Windows Server 2003 Standard
Edition SP2
- Adober Acrobat Reader 8.1.2
- WebSphere MQ 6.0.2.4
Installation
of Lotus Expeditor integrator
All described installation steps are related to a Windows 2003 Server operating
system (U.S. english). For other operating systems and languages please
check Lotus Expeditor integrator Infocenter.
1. Detach the software into installation base directory,
.
2. Execute
\desktop\install and follow
the installation setup dialog.
3. Finally, you should have Lotus Expeditor integrator installed in
C:\Program
Files\IBM\Lotus\Integrator.
Installation directory overview
At next you could execute
XPDintegStart.bat to verify your installation.
There will occur two command windows for initialization, than disappear
and a new one will show the OSGi console window.
Lotus Expeditor integrator first start
Congratulations! You've successfully installed Lotus Expeditor integrator
on your system. At next we'll step trough the basich configuration of connectivity
and the uses cases described in in section
6.2
Solution design to create a template
for mass rollout. Keep the command line window open for further investigation.
Warning
Please do NOT close the console window with "Close" button! It
will keep underlying JVM open and bring the system in an inconsistent status.
Type "exit" instead of in the console window if you want to stop
Lotus Expeditor integrator accordingly. If you should have closed console
window with "Close" button or system has been crashed you can
reset Lotus Expeditor integrator with C:\Program Files\IBM\Lotus\Integrator\XPDintegReset.bat.
Note
The console window of Lotus Expeditor integrator is intended for testing
purposes only. In a production environment you'll run Lotus Expeditor integrator
as a service without console. Please check for further configuration of
this service the AdministratorsGuide.
Basic configuration
If you're dealing with pure Lotus Expeditor integrator without a management
software like Lotus Expeditor Server or WebSphere Premises Server than
there's one file that contains all necessary configuration information
C:\Program Files\IBM\Lotus\Integrator\config\XPDinteg.xml. You should
copy this file to a working location for further editing. If you've made
some changes you need to copy the changed file into
C:\Program Files\IBM\Lotus\Integrator\config\new
directory. Lotus Expeditor integrator has a pre-configured Flow built-in
that monitors this directory for a file named XPDinteg.xml. If this file
occurs Lotus Expeditor integrator will pick up, validate and update his
configuration. Let's see how this looks like.
1. Copy the file to a working location. At this step, change nothing. We'll
keep the file for further work at this work location.
2. Take the file and copy it to
C:\Program Files\IBM\Lotus\Integrator\config\new.
Lotus Expeditor integrator update
The last two entries in console window show that Lotus Expeditor integrator
has successfully picked up the new file and updated his configuration.
The file in
C:\Program Files\IBM\Lotus\Integrator\config directory
has been replaced by the new one too. Let's now start with the enterprise
connectivity configuration (to Backbone Service Bus).
Configure enterprise connectivity to the Head Office
At first, open the file
XPDinteg.xml that you have copied to the
work loaction with an appropriate XML editor. It could be of course Rational
Application Developer, even if this can also host Lotus Expeditor Toolkit
for development of custom Activities. Move to the following section
100
First of all, enter a value for
location_id,
this will be included in any transaction event for recognition of this
Lotus Expeditor integrator instance. For our example we've used the value
100. Keep the file
XPDinteg.xml at work loaction open.
Now we'll configure WebSphere MQ for
as representation of Backbone Service Bus. For all WebSphere MQ related
tasks we've used WebSphere MQ Explorer. Once you have installed WebSphere
MQ you must create a default Queue Manager.
WebSphere MQ Queue Manager configuration
At next create the message queues as
shown in next picture. For a more detailed description of the queues check
the AdministratorsGuide.
WebSphere MQ Queue configuration
Now we'll add the configuration for
the micro broker bridge. Remove following section (marked bold) in XPDinteg.xml
at work location
60000
jms/XPDinteg_ConnectionFactory
com.ibm.pvc.jndi.provider.java.InitialContextFactory
local
com.ibm.rcp.integrator.messagingservice.impl.SampleJNDISecurity
At next move to following section
XPDinteg_SampleTopic
jms/XPDinteg_SampleTopic
and replace the bold marked lines as
shown below (these lines have been copied from
C:\Program Files\IBM\Lotus\Integrator\config\samples\Sample_XPDinteg.xml
and modified with the appropriate values matching the curretn system configuration)
com.ibm.pvc.jndi.provider.java.InitialContextFactory
local
com.ibm.rcp.integrator.messagingservice.impl.SampleJNDISecurity
com.ibm.mq.jms.MqConnectionFactory
jms/XPDinteg-MQConnectionFactory
localhost
1414
SYSTEM.DEF.SVRCONN
DEFAULT.QMgr
XPDinteg100
com.ibm.mq.jms.MQQueue
jms/MQ_syncQ
XPDinteg.SyncQ
com.ibm.mq.jms.MqQueue
jms/MQ_deadLetterQ
XPDinteg.DeadLetterQ
com.ibm.mq.jms.MqQueue
jms/MQ_inQ
XPDinteg.ResInQ100
com.ibm.mq.jms.MqQueue
jms/MQ_outQ
XPDinteg.ReqOutQ100
com.ibm.mq.jms.MqQueue
jms/MQ_eventQ
XPDinteg.EventQ
com.ibm.mq.jms.MqQueue
jms/MQ_ctrlQ
XPDinteg.CtrlQ100
com.ibm.mq.jms.MqQueue
jms/MQ_logQ
XPDinteg.LogQ
jms/MQ_ServerReqOutQ
jms/MQ_ServerCtrlOutQ
XPDinteg_ResOutQ
XPDinteg_LogQ
XPDinteg_EventQ
XPDinteg_ServerDeadletterQ
AlwaysConnectedConnectionPolicy