• No results found

Load balancing and Fault Tolerance of EMS servers

N/A
N/A
Protected

Academic year: 2021

Share "Load balancing and Fault Tolerance of EMS servers"

Copied!
83
0
0

Loading.... (view fulltext now)

Full text

(1)

Infosys

QUALITY SYSTEM DOCUMENTATION

Templates

Lab Guide for ES-TECH-FP-EAIS-SE-TIBCO Course

September, 2011 EAI, ES Academy

Document No. : 1.0 Version.Rev : V1

Authorized by: Yogesh Kumar Bhatt Signature/: Date

Shauvik Das 19th October 2011

(2)

Usage Guidelines

Do not forward this document to any

non-Infosys mail ID. Forwarding this document

to a non-Infosys mail ID may lead to

disciplinary action against you, including

termination of employment.

Contents of this material cannot be used

in any other internal or external document

without explicit permission from

E&R@infosys.com.

(3)

COPYRIGHT NOTICE

© 2011 Infosys Limited, Bangalore, India. All rights reserved.

Infosys believes the information in this document is accurate as of its publication date; such information is subject to change without notice. Infosys acknowledges the proprietary rights of other companies to the trademarks, product names and such other intellectual property rights mentioned in this document. Except as expressly permitted, neither this document nor any part of it may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, printing, photocopying, recording or otherwise, without the prior permission of Infosys Limited and/or any named intellectual property rights holders under this document.

Education and Research Department Infosys Limited Electronics City Hosur Road Bangalore - 561 229, India. Tel: 91 80 852 0261-270 Fax: 91 80 852 0362 www.infosys.com mailto:E&R@infosys.com

(4)

Document Revision History

Ver.

Revision Date Author(s) Reviewer(s) Description

V1 OCT,2011 Shauvik Das <Reviewer’s

comments and the implementation details have to be given here>

(5)

Contents

1. Installation of TIBCO Runtime Agent (TRA) 5.6.0 ... 6

2. RENDEZVOUS (RV) Hands-On ... 12

3. EMS Installation ... 16

4. EMS Hands-On ... 20

5. Adding and Configuring an Adapter Instance ... 28

6. Creating an Adapter Archive ... 31

7. Installation of TIBCO ADADB 5.5 ... 34

8. Active Database Adapter(ADB) Hands-On ... 38

9. Installation of TIBCO File adapter 5.4 ... 39

10. File adapter Hands-On ... 44

11. Transferring Records Using TIBCO BusinessWorks ... 48

12. Installation of administrator 5.6.0 ... 52

13. Navigating through Administrator GUI ... 60

14. TIBCO ADMINSTRATOR: User Management ... 62

15. Create Enterprise archive and deploy it in administrator ... 70

16. Installation of TIBCO Hawk 4.8 ... 71

(6)

1. INSTALLATION OF TIBCO RUNTIME AGENT (TRA) 5.6.0

1.1 Double click on application TIB_tra-suite_5.6.0_win_x86_32.exe

1.2 Select “Next”

1.3 Select “I accept the terms of the License Agreements”

Source: Screenshot taken from TIBCO Runtime Agent 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(7)

1.4 Select “Next”

Source: Screenshot taken from TIBCO Runtime Agent 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(8)

1.5 Select “Typical Install”.

1.6 Select directory for TIBCO installation (e.g. c:\TIBCO)

1.7 Select “Next”

Source: Screenshot taken from TIBCO Runtime Agent 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(9)

1.8 Uncheck use Vendor supplied Driver and Select “Next”

Source: Screenshot taken from TIBCO Runtime Agent 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(10)

1.9 Select “Finish”

1.10 Installation completes with this step.

1.11 Following are the products installed as part of TRA suite

i. TIBCO Rendezvous 8.1.1

ii. JRE 1.5.0 iii. TPCL 5.6

iv. TIBCO Hawk 4.8.1

v. TIBCO Runtime Agent 5.6.0

vi. Designer 5.6.0

1.12 Install TIBCO Runtime Agent(TRA) 5.6.2 in the same way as TRA 5.6.0

1.13 Verification of installation

i. Please do validation on installation by browsing through the locations specified in the above screen shots for the products specified above.

ii. e.g.: TIBCO Rendezvous 8.1.1 is installed in

d:\TIBCO\tibrv\8.1. Screenshot of verification is given below

(11)
(12)

2. RENDEZVOUS (RV) HANDS-ON

2.1 Starting of rvd

i. Press “Windows +R” and type cmd

ii. Go to directory where TIBCO RV is installed. iii. Type cd d:\TIBCO\tibrv\8.1\bin

iv. Type rvd

 Screen shot for the same is attached below:

 Validating whether rvd started properly

 Type following command in internet explorer http://localhost:7580/  Snapshot of GUI displayed is shown below:

Source: Screenshot taken from Command Prompt, © Microsoft Corporation. All rights reserved.

(13)

2.2 Receive message

i. Press “Windows +R” and type cmd

ii. Go to directory where TIBCO RV is installed. Then type “cd d:\TIBCO\tibrv\8.1\bin”

iii. Type command “tibrvsend -service 7503 -daemon tcp: 7503 test "My first RV test”

Note: you can confirm send is successful if there is listener already running. Use below commands for listener to be active

2.3 Sample send message

i. Press “Windows +R” and type cmd

ii. Go to directory where TIBCO RV is installed. Type cd d:\TIBCO\tibrv\8.1\bin

iii. Type command “tibrvlisten -service 7503 -daemon tcp: 7503 test”

2.4 Sample program

i. Example Description

a. This example demonstrates the use of all the Rendezvous activities within BusinessWorks. When a RV message is received on the subject "BW.Start" by a Rendezvous Subscriber, the process starts a Wait for

b. Rendezvous Subscriber listening to the subject

"BW.Request", as well as a Send Rendezvous Request on the Subject "BW.Request" and a Reply Subject "BW.Reply". When the RV message from Send Rendezvous Request is received by the Wait for Rendezvous Request, a Reply message is sent by the Reply to Rendezvous Request activity. A final Result message is produced by a

Source: Screenshot taken from Command Prompt, © Microsoft Corporation. All rights reserved.

(14)

Rendezvous Publisher on the subject "BW.Result". Please note that if you don't specify the reply subject in the Send Rendezvous Request activity, it will create its own inbox subjects and expects a reply on that subject).

ii. Setup

a. There is nothing to set up to run this project. However, you may change the subjects on which each of the activities use for publish or subscribe

Double click on the RVRPC object in the project tree panel (top left) to display the process in the design panel (top right)

Click on "Subscribe to BW.Start" and in the configuration panel and change the subject.

Similarly change the subject specified in "Send Request on BW.Request" and "Wait for BW.Request" configuration and the "replySubject" in the input tab. You may change also the subjects in "Publish Result on BW.Result".

iii. Running the example

a. In TIBCO Designer, load the RendezvousExample.zip

project using the Project->Import Full Project->Menu selection

b Click on the Start Test Mode tab to run the project in test mode.

c Open a Command window and type tibrvlisten

"BW.Result" to subscribe to the final result.

d Open a second Command window and type tibrvsend

"BW.Start" "hello world" to publish a message to trigger the process.

(15)

e Repeat tibrvsend "BW.Start" "with a different message" and observe the output.

iv. Expected Results

You should see "HELLO WORLD" in the tibrvlisten output. If you send a different RV message, you should see the result with all the lower case letters converted to upper case letters.

v. Troubleshooting

BW process is not starting

a. Make sure you are sending an RV Message on the same subject as configured in the "Subscribe to BW.Start"

b. If you see the test mode hung at "Send Request on BW.Request" activity make sure that if you have given some content in the data part of the input tab (right hand side in the Activity Input panel under body).

(16)

3. EMS INSTALLATION

3.1 Double click on application TIBCO Universal Installer.exe 3.2 Select “Next”

3.3 Select “I accept the terms of the License Agreements”

3.4 Select “Next”

Source: Screenshot taken from TIBCO EMS 5.0, Copyright © TIBCO Software Inc. All rights reserved

(17)

3.5 Select “Typical Installation”

Source: Screenshot taken from TIBCO EMS 5.0, Copyright © TIBCO Software Inc. All rights reserved

(18)

3.6 Select “Manual” and then select “Next”

3.7 Select “Install”

Source: Screenshot taken from TIBCO EMS 5.0, Copyright © TIBCO Software Inc. All rights reserved

(19)

3.8 Select “Finish”

Verification of installation

Please do validation on installation by browsing through the locations where TIBCO is installed.

e.g. D:\TIBCO\ems\5.0\bin

(20)

4. EMS HANDS-ON

4.1 Starting of EMS Server

i. Follow below specified steps:

ii. Create a folder “config” in D:\TIBCO\ems\5.0\bin iii. Copy all configuration files from

D:\TIBCO\ems\5.0\samples\config” to“D:\TIBCO\ems\5.0\bin\config”

iv. Modify file tibemsd.conf with changes in below snapshot

a. Press “windows + R” and type cmd

b. Type “cd D:\TIBCO\ems\5.0\bin” and execute following command“tibemsd.exe–config

D:\TIBCO\ems\5.0\bin\config\tibemsd.conf”

c. EMS server is started with this message

(21)

4.2 Login to ems instance Follow below steps to logon to ems instance: i. Press “windows + R” and type cmd

ii. Type “cd D:\TIBCO\ems\5.0\bin” and execute following command “tibemsadmin.exe”

iii. Type command connect

iv. Enter username and password

4.3 Create user with (trainee, trainer)

i. Logon to ems instance as specified in hands on II

ii. Type following commands

a. create user Trainee password=Trainee

b. create user Trainer password=Trainer

1. Use command “show users” to validate whether user has been created

4.4 Create queue (Infosys.Trainee.queue) with properties trace=body,global,sender_name_enforced,secure i. Logon to ems instance as specified in hands on II

Source: Screenshot taken from Command Prompt, © Microsoft Corporation. All rights reserved.

Source: Screenshot taken from Command Prompt, © Microsoft Corporation. All rights reserved.

(22)

ii. Type following commands

iii. Type command “create queue Infosys.Trainee.queue trace=body,global,sender_name_enforced,secure”

iv. Type command “show queue Infosys.Trainee.queue” to validate whether queue has been created or not

4.5 Create topic (Infosys.Trainee.topic) with properties trace=body,global,sender_name_enforced

i. Logon to ems instance as specified in hands on II ii. Type command “create topic Infosys.Trainee.topic

trace=body,global,sender_name_enforced”

iii. Type command “show topic Infosys.Trainee. topic” to validate whether queue has been created or not

4.6 Grant permission on users with view-all

i. Logon to ems instance as specified in hands on II

ii. To check permission on user type command “showacl

admin”

iii. Type command “grant admin user=Trainee

view-all,view- factory,view-connection,viewdestination,view-message,view-server”

Source: Screenshot taken from Command Prompt, © Microsoft Corporation. All rights reserved.

Source: Screenshot taken from Command Prompt, © Microsoft Corporation. All rights reserved.

(23)

iv. To check permission on user type command “showacl admin” after grant permission

v. Type command “commit” to save changes

4.7 Grant permission on queue topic for both users with

receive,send,browse

i. Logon to ems instance as specified in hands on II

ii. Type command “grant queue Infosys.Trainee.queue

user=Trainee receive,send,browse”

iii. Type command “grant queue Infosys.Trainee.queue

user=Trainer receive,send,browse”

iv. Type command “grant topic Infosys.Trainee.topic user=Trainee publish”

v. Type command “grant topic Infosys.Trainee.topic user=Trainer publish,subscribe”

vi. To validate type command “showacl queue

Infosys.Trainee.queue”

vii. To validate type command “showacl topic Infosys.Trainee.topic”

4.8 Bridge queue to topic

i. Logon to ems instance as specified in hands on II

Source: Screenshot taken from Command Prompt, © Microsoft Corporation. All rights reserved.

Source: Screenshot taken from Command Prompt, © Microsoft Corporation. All rights reserved. Source: Screenshot taken from Command Prompt, © Microsoft Corporation. All rights reserved.

(24)

ii. Type command “create bridge

source=queue:Infosys.Trainee.queue target=topic:Infosys.Trainee.topic”

iii. Type command “show bridges” to validate

4.9 Create connection factory for both queue and topic i. Logon to ems instance as specified in hands on II ii. Type command “create factory

Infosys_QueueConnectionFactory queue url=tcp://localhost:7234”

iii. Type command “create factory

Infosys_TopicConnectionFactory topic url=tcp://localhost:7234”

iv. Type command “show factories” to validate above statements

Source: Screenshot taken from Command Prompt, © Microsoft Corporation. All rights reserved. Source: Screenshot taken from Command Prompt, © Microsoft Corporation. All rights reserved.

Source: Screenshot taken from Command Prompt, © Microsoft Corporation. All rights reserved.

(25)

4.10 Publish and Subscribe Messaging Example i. Compiling the Sample Clients

To compile and run the sample clients you need to execute

"setup" script, which is located in the

EMS_HOME/samples/java directory. On Windows systems, the setup file is setup.bat

a. Make sure you have Java JDK 1.5 or greater installed and that you’ve added the bin directory to your PATH variable.

b. Open a command line or console window, and navigate to the EMS_HOME/samples/java directory.

c. Open the correct setup script file and verify that the TIBEMS_ROOT environmentvariable identifies the correct pathname to your EMS_HOME directory. For example, on Windows system this might look like:

d. Set TIBEMS_ROOT=C:\TIBCO\ems\5.0

e. Enter setup to set the environment and classpath: f. Setup

g. Compile the samples: h. javac -d . *.java

This compiles all the samples in the directory, except for those samples in the JNDI and tibrv subdirectories.

If the files compile successfully, the class files will appear in the EMS_HOME/samples/java directory. If they do not compile correctly, an error message appears.

ii. Start the Subscriber Clients

You start the subscribers first because they enable you to observe the messages being received when you start the publisher.

To start Trainer as a subscriber:

a. In the first command line window, navigate to D:\TIBCO\ems\5.0\samples\java

(26)

b. Type command “setup”

c. Type command “java tibjmsMsgConsumer –topic

Infosys.Trainee.topic-user Trainer”

To start Trainee as a subscriber:

a. In the first command line window, navigate to D:\TIBCO\ems\5.0\samples\java

b. Type command “setup”

c. Type command “java tibjmsMsgConsumer -topic

Infosys.Trainee.topic-user Trainee”

iii. Start the Publisher Client and Send Messages

a. In the first command line window, navigate to D:\TIBCO\ems\5.0\samples\java

b. Type command “setup”

c. Type command “java tibjmsMsgProducer -topic

Infosys.Trainee.topic-user Trainer Hello Testmessage”

Source: Screenshot taken from Command Prompt, © Microsoft Corporation. All rights reserved.

(27)

Source: Screenshot taken from Command Prompt, © Microsoft Corporation. All rights reserved. Source: Screenshot taken from Command Prompt, © Microsoft Corporation. All rights reserved.

(28)

5. ADDING AND CONFIGURING AN ADAPTER INSTANCE

5.1 Left-click the resource Generic Adapter Configuration in the palette panel.

a. Drag and release it in the design panel or b. Right-click a resource > Add this to project

5.2 Double-click the adapter instance in the project tree panel. 5.3 The two high level folders visible are:

a Adapter Services b Advanced

Tabs for Adapter Instance

Some Common tabs in the configuration panel for an instance are: i. Configuration

a Provide the name of adapter instance. b Associate Message Filters if any.

ii. Logging

(29)

a. To specify the types of messages (info, debug, warning, error) to be logged.

b. To customize the Log file name.

c. To Log to standard I/O.

iii. Startup

a. To provide startup banner.

b. State at startup.

iv. Monitoring

• To customize the Micro agents. 5.4 Configuring Adapter Services

i. Double-click the Adapter Services folder to open it

ii. Displays services supplied by the adapter in the palette panel (Publication, Subscription, Request – Response, Request- Response Invocation Services)

iii. Drag an adapter service resource from the palette panel into the design panel.

iv. The configuration panel is updated to allow you to configure the service.

v. Click through the tabs and specify the configuration details to configure the resource.

vi. Save the project, the resource is saved and can then be used at run-time

(30)

Source: Screenshot taken from TIBCO EMS 5.0, Copyright © TIBCO Software Inc. All rights reserved

(31)

6. CREATING AN ADAPTER ARCHIVE

If adapters are part of your project, you can create adapter archives and add them to the Enterprise archive.

The following example uses a Generic Adapter Configuration. The process would be the same for an adapter.

To Add a Generic Adapter Configuration Archive 6.1 Configure the adapter.

6.2 Select the Enterprise Archive resource in the project panel. If there are any configured adapters in your project, an Adapter Archive resource becomes available in the palette panel. If you’re working in palette mode, it is located in the adapter’s palette.

6.3 Drag the Adapter Archive into the design panel and specify information in the Configuration tab, then click Apply:

Source: Screenshot taken from TIBCO EMS 5.0, Copyright © TIBCO Software Inc. All rights reserved

(32)

6.4 After you have selected an adapter, the Advanced tab becomes available and you can optionally specify the following

information, then click Apply.

Software Type The type of adapter. This corresponds to the extension

of the adapter project file (multi-fileprojects). This field is only available for Generic Adapter Configuration or for adapters that allow multiple software choices, such as the TIBCO Adapter for Tuxedo. This value must match the value set by the software’s installer or specified when custom software was added to the administration domain.

Update

Version from Adapter

When you build the archive, TIBCO Designer includes the ActiveEnterprise version of the adapter associated with this archive by default. If you unselect this checkbox, you can supply a different version instead. If the box is unchecked, the deployment ActiveEnterprise version value could go out of sync with the adapter’s value (the adapter provides a button to manage the

Name Name of the Adapter Archive.

Description Optional description of the Adapter Archive.

Author Optional author of the Adapter Archive.

Adapter Click the browse button (the binoculars) and select

the adapter you wish to associate with the archive. Note that you need to create a new Adapter Archive for each adapter.

Deployment Plugin

Deployment plugin class. This class must be an implementation of the

com.TIBCO.tra.tsm.plugin.custom.CustomTSMPlugIn interface. TIBCO Administrator runs this code as part of the deployment process when it creates the .tra file.

In addition to providing a pointer to this class here, you must also add a .jar file to the Shared Archive that includes the class so the class will be in the classpath.

(33)

version).

Warning: Supplying a different version can have seriouscompatibility consequences.

Minimum Version

Minimum version for the adapter. The value of this field is provided by the adapter and can be changed.

6.5 To build the archive, select the Enterprise Archive (which is one level higher in the project tree) and click the Build Archive button.

(34)

7. INSTALLATION OF TIBCO ADADB 5.5

7.1 Double click on application TIB_adadb-suite_5.5.0_win_x86.exe 7.2 Select “Next”

7.3 Select “I accept the terms of the License Agreements”

Source: Screenshot taken from TIBCO ActiveMatrix Adapter for Database 5.5.0, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO ActiveMatrix Adapter for Database 5.5.0, Copyright © TIBCO Software Inc. All rights reserved

(35)

7.4 Select “Next”

7.5 Select “Typical install”

Source: Screenshot taken from TIBCO ActiveMatrix Adapter for Database 5.5.0, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO ActiveMatrix Adapter for Database 5.5.0, Copyright © TIBCO Software Inc..All rights reserved

(36)

7.6 Select directory for TIBCO installation (e.g. c:\TIBCO) 7.7 Select “Next “

7.8 Uncheck “use Vendor supplied Driver” and Select “Next” 7.9 Select “Finish”

Source: Screenshot taken from TIBCO ActiveMatrix Adapter for Database 5.5.0, Copyright © TIBCO Software Inc.All rights reserved

Source: Screenshot taken from TIBCO ActiveMatrix Adapter for Database 5.5.0, Copyright © TIBCO Software Inc. All rights reserved

(37)

Installation completes with this step. Verification of installation

Please do validation on installation by browsing through the locations specified in the above screen shots for the products specified above.

e.g.: TIBCO adb 5.5 is installed in D:\TIBCO\adapter\adadb\5.5 Screenshot of verification is given below

(38)

8. ACTIVE DATABASE ADAPTER(ADB) HANDS-ON Refer to document tib_adadb_examlpes_guide.pdf

(39)

9. INSTALLATION OF TIBCO FILE ADAPTER 5.4

9.1 Double click on application TIB_adfiles-simple_5.4.0_w32.exe

9.2 Select “Next”

Source: Screenshot taken from TIBCO Adapter For Files 5.4.0, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO Adapter For Files 5.4.0, Copyright © TIBCO Software Inc. All rights reserved

(40)

9.3 Select “I accept the terms of the License Agreements”

9.4 Select “Next”

Source: Screenshot taken from TIBCO Adapter For Files 5.4.0, Copyright © TIBCO Software Inc.

All rights reserved

Source: Screenshot taken from TIBCO Adapter For Files 5.4.0, Copyright © TIBCO Software Inc. All rights reserved

(41)

9.5 Select directory for TIBCO installation (e.g. c:\TIBCO)

9.6 Select “Typical” Install

9.7 Select “Next “

Source: Screenshot taken from TIBCO Adapter For Files 5.4.0, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO Adapter For Files 5.4.0, Copyright © TIBCO Software Inc. All rights reserved

(42)

9.8 Select “Finish”

Source: Screenshot taken from TIBCO Adapter For Files 5.4.0, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO Adapter For Files 5.4.0, Copyright © TIBCO Software Inc. All rights reserved

(43)

Installation completes with this step. 9.9 Verification of installation

Please do validation on installation by browsing through the locations specified in the above screen shots for the products specified above.

e.g.:TIBCO File adapter is installed in

D:\TIBCO\adapter\adfiles\5.4\bin Screenshot of verification is given below

(44)

10. FILE ADAPTER HANDS-ON

10.1 Set up for examples

The pre configured examples are located in the examples directory. The directory contains executable files for Windows and UNIX platforms.

Two subdirectories, reader and writer contain the directories used in the examples where input files exist and output files are placed. The reader directory is used by the publication service. The writer directory is used by the subscription service.

To access the examples directory on Windows:

cd C:\TIBCO\adapter\adfiles\<version number>\examples To access the examples directory on UNIX:

cd <install_path>/TIBCO/adapter/adfiles/<version number>/examples

10.2 Publishing Container Records - Example 1

Two examples are available that demonstrate how the adapter handles container records. The first example has a simple schema and the second has a more complex schema:

• ContainerReader and ContainerWriter Example • ContainerReader2 and ContainerWriter2 Example

In the ContainerReader and ContainerWriter Example, the publication service parses an input file container.txt which has the following records,

Department, Engineering, Employee, ID0045, Mary, Employee, ID0056,

(45)

Item, Stapler, 60, $8

Department, Accounts, Employee, ID0115, Vikram, Employee, ID0144,

Sundar

Item, NoteBook, 48, $5

The container record Department, has a repeating sub-structure because it contains another record Employee.

10.3 Running the Example

To run the example:

i. In a command window, change directory to the bin directory. For example, on Windows:

cd C:\TIBCO\adapter\adfiles\<version number>\bin

ii. Start the ContainerWriter (subscription service) by typing: adfilesagent.exe --propFile ..\examples\ContainerWriter.tra

iii. In another command window, change directory to the bin

directory, then start the ContainerReader (publication service) by typing:

adfilesagent.exe --propFile ..\examples\ContainerReader.tra The publication service publishes the

reader\input\container.txt file. The subscription service receives it and writes it to writer\output\outcontainer.txt. iv. Stop the subscription service by pressing Ctrl c in the

command window.

10.4 Results

The publication service parses the input file, processes it into objects, and publishes it. The subscription service receives the objects, and formats them according to the WriteSchema, where the Employee record is no longer contained within the Department record. Instead,

(46)

it is now a child record of the parent record Department. Therefore, all the records are written to a different line in the output file.

10.5 Understanding the Configuration

a. Publication Service

The publication service’s read schema has stored the base record Employee under the BaseRecords folder. The Department record contains the Employee record as the third field. The first two fields are field and field1.

Source: Screenshot taken from TIBCO Designer 5.6, Copyright © TIBCO Software Inc. All rights reserved

(47)

b. Subscription Service

The subscription service’s Write Schema is configured to write all file records to a separate line. Department is no longer a container record and does not have the Employee record as the third field. Instead, the Employee record is now a child record.

Source: Screenshot taken from TIBCO Designer 5.6, Copyright © TIBCO Software Inc. All rights reserved

(48)

11. TRANSFERRING RECORDS USING TIBCO BUSINESSWORKS

This example shows how to use the adapter services within a TIBCO BusinessWorks process to transfer records.

The example has three components, FAReader (publication service), FAWriter (Subscription Service), and ConnectFAReaderFAWriter (BusinessWorks process).

 FAReader uses the adapter’s Publication service to read delimited.txt from the reader/input directory and publish the message.

 ConnectFAReaderFAWriter subscribes to the message, does a field-to-field mapping, and publishes the message again.

 FAWriter uses the adapter’s Subscription service to subscribe to the republished message and write it to outdelimited.txt in the writer/output directory.

11.1 PREREQUISITES

You can start the adapter, TIBCO BusinessWorks, and the example in one of the following ways:

Using TIBCO Designer

Using TIBCO Administrator Enterprise Edition

The following software must be installed to run the example: TIBCO BusinessWorks

TIBCO Administrator Enterprise Edition TIBCO Adapter for Files

TIBCO Runtime Agent

11.2 RUNNING THE EXAMPLE USING TIBCO DESIGNER

To run the example:

In TIBCO Designer, click Tools>Show Adapter Tester. The Adapter Tester dialog box is displayed.

Select FAWriter.

(49)

Click Apply.

Click Start. The FAWriter starts.

Click the Tester tab. Click the Start testing viewed process button or press F9. The Select Processes to Load dialog box is displayed.

Select ConnectFAReaderFAWriter and click Start Selected. The TIBCO BusinessWorks process is started.

In the Adapter Tester dialog box, select the FAReader. Click Browse to specify a Working directory.

Click Apply.

Click Start. The FAReader starts.

11.3 RUNNING THE EXAMPLE USING TIBCO ADMINISTRATOR

To deploy and run the example using TIBCO Administrator, create an Enterprise Archive File (EAR) in TIBCO Designer, and use TIBCO Administrator Enterprise Edition to deploy the EAR file.

In TIBCO Administrator, make sure all software components needed by the adapter instance is installed on one or more machines that are part of the TIBCO Administration Domain and that the software is registered in the domain.

Use the TIBCO Domain Utility to add a machine to a TIBCO Administration Domain.

In TIBCO Administrator, use the Resource

Management>Machines console to register software. These topics are explained in the TIBCO Administrator documentation set.

Perform the following tasks to deploy and run the example.

11.4 Task A Generate the EAR File

(50)

To start TIBCO BusinessWorks, click

Start>Programs>TIBCO>TIBCO Designer 5.1>Designer 5.1 and click Open New Project.

Click Project > Import Full Project. The Import Project dialog is displayed.

Click the Local Repository tab and browse to Teak_TafRepoDefault.dat.

Click OK to import the file. The Import Options dialog is displayed. Select Overwrite on name conflict and click Apply. Click the FABW icon in the project panel. The FABW

Configuration panel is displayed.

Click Browse in the File Location field to specify the folder in which you want to save the EAR file, or use the default file location.

Click the Build Archive button. A message informing you that the enterprise archive file is built correctly is displayed.

11.5 Task B Deploy the Example in TIBCO Administrator:

Go to Application Management. Click New Application. Upload the EAR file created in the previous section and click OK. On the following screen, clear the Quick Configure check box and then click Save.

Click on the top level application name in the Configuration page.

Go to the Advanced tab and provide the values for User Name and Password if it is not already provided.

Click Save. The Configuration screen reappears.

Click the adapter archive (Adapter Archive.aar) and click Add To Additional Machines.

(51)

Select the machine and click OK. In the following screen, click Save. In the Configuration screen click Deploy. Click OK.

Once the deployment is complete, click Service Instances under the application. The adapter and TIBCO BusinessWorks are listed. Select both and click Start Selected, if it is not running. The adapter service and the TIBCO BusinessWorks processes are started.

11.6 UNDERSTANDING THE CONFIGURATION

For configuration details, see Understanding the Configuration.

11.7 RESULTS

Records in the input file are separated by commas. Records in the output file have been formatted to use tabs and semicolons as separators. Item lines in the input file were positioned ahead of the Customer lines. In the output file, the Customer line is positioned ahead of the Item lines.

(52)

12. INSTALLATION OF ADMINISTRATOR 5.6.0

12.1 Double click on application TIB_TIBCOadmin-epe-simple_5.6.0_win_x86_32.exe

12.2 Select “Next”

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(53)

12.3 Select “I accept the terms of the License Agreements”

12.4 Select “Next”

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(54)

12.5 Select directory for TIBCO installation (e.g. c:\TIBCO)

12.6 Select “Typical” Install

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(55)

12.7 Select “Next “

12.8 Select “Next”

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(56)

12.9 Select “Master”

12.10 Type “admin” in administrator domain and untick domain

information stored in database

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(57)

12.11 Select “Next”

12.12 Provide username as “admin” and password “admin” and

Select “Next”

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(58)

12.13 Select “Next” 12.14 Select “Exit”

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

Source: Screens hot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(59)

12.15 Verification of installation

Please do validation on installation by browsing through the locations specified in the above screen shots for the products specified above.

e.g.: TIBCO Administrator 5.6 is installed in

D:\TIBCO\administrator\5.6\bin. Screenshot of verification is given below

(60)

13. NAVIGATING THROUGH ADMINISTRATOR GUI

13.1 Connect to the Administrator from

start -> Programs -> TIBCO ->TIBCO Administrator 5.6 -> TIBCO Administrator

(OR)

In your web browser enter http://localhost:8080

1. Provide username “admin” and password “admin” 13.2 Provide username “admin” and password “admin”

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(61)

Snapshot administrator GUI is shown below:

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(62)

14. TIBCO ADMINSTRATOR: USER MANAGEMENT

14.1 Create user trainee

i. Expand User Management and click on users

ii. Click on New user and provide new user name as “Trainee” and Select “OK”

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(63)

iii. Click on “set” in password field

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(64)

iv. And provide password as “trainee”

v. Select “Apply”

14.2 Create role “appsupp”

i. Expand Roles Management and click on users

ii. Expand the hierarchy and select the check box to the left of the role that you want to use as the parent role for the new role (either Authenticated Users or another role previously created).

Do not click the role itself for this task

iii. Select New Role.

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(65)

i. Select “Apply”

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(66)

14.3 Grant Read and Write permissions to the Role i. Select role “Appsup” and click permission tab

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(67)

ii. Select Read and write check boxes

iii. Select “Apply changes”

14.4 Assign the “Appsup” Role to the User “trainee”

i. Select User Management > Users in the left panel

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(68)

ii. Select user “trainee” and click on Role membership

iii. Select “Add Roles”

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(69)

iv. Select “Appsup” and click “Add”

Source: Screenshot taken from TIBCO Administrator 5.6.0, Copyright © TIBCO Software Inc. All rights reserved

(70)

15. CREATE ENTERPRISE ARCHIVE AND DEPLOY IT IN ADMINISTRATOR

15.1 Creating the Enterprise Archive File

i. Already ear file is created with hands on session with designer.

15.2 Deploying the Application in TIBCO Administrator TIBCO

Administrator to import an enterprise archive file and create a corresponding application. Follow these steps:

i. Start TIBCO Administrator and log into the administration domain in which you wish to deploy the application.

ii. Click the Application Management module, and then click the New Folder button.

iii. In Name, type Timer Application. iv. Click Save.

v. Double-click the Timer Application folder, and then click the New Application button.

vi. Click the Browse button to select the enterprise archive file you created in Creating the Enterprise Archive File. vii. In the dialog that appears, select the Deploy on Save

(71)

16. INSTALLATION OF TIBCO HAWK 4.8

16.1 Double click on application TIB_hawk-suite_4.8.1_win_x86_32.exe

16.2 Select “Next”

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc. All rights reserved

(72)

16.3 Select “I accept the terms of the License Agreements”

16.4 Select “Next”

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc. All rights reserved

(73)

16.5 Select “Typical Install”

16.6 Select directory for TIBCO installation (e.g. c:\TIBCO)

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc. All rights reserved

(74)

16.7 Select “Next “

16.8 Select “Next”

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc . All rights reserved

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc. All rights reserved

(75)

16.9 Select “Next”

16.10 Select “Defaults” and Select “OK”

Check if the following services have been started:  TIBCO Hawk agent

 TIBCO Hawk HMA

If they have not started, start them Installation completes with this step.

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc. All rights reserved

(76)

16.11 Verification of installation

Please do validation on installation by browsing through the locations specified in the above screen shots for the products specified above.

e.g.: TIBCO hawk 4.8 is installed in D:\TIBCO\hawk\bin Screenshot of verification is given below

(77)

17. HAWK HANDS-ON

17.1 Starting of Hawk GUI

i. Go to programs-> TIBCO->TIBCO hawk 4.8 ->Hawk display

17.2 Create rule base to monitor a file for string “ERROR” and raise ALERT

i. Create a file by name test.txt in d:\

ii. Select your machine name in hawk display under discovered ones and right click and select get configuration

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc. All rights reserved

(78)

iii. Select rulebases

iv. Select icon and rule base name as Filepoller

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc. All rights reserved

(79)

v. Select on icon under rules

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc. All rights reserved

(80)

vi. Select “Edit” under data source and select Logfile -> onNewline, provide file details and Select “OK”

vii. Click icon under tests and select edit under if condition, select next line -> contains “ERROR” and Select “OK”

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc. All rights reserved

(81)

viii. Click icon under then provide alert message as “******This is hawk test alert for ESA *****”

ix. Press advance and select always in perform action

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc. All rights reserved

(82)

x. Press apply changes

xi. Open File test.txt and add string “ERROR”

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc. All rights reserved

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc. All rights reserved

(83)

xii. Description of error message

Source: Screenshot taken from TIBCO HAWK 4.8.1, Copyright © TIBCO Software Inc. All rights reserved

References

Related documents

• In the Lync main window, select the gear Option icon • Select Video Device. • Select Camera Settings to adjust settings •

TIBCO, The Power of Now, TIBCO Hawk, TIBCO Rendezvous, TIBCO Runtime Agent, TIBCO ActiveMatrix BusinessWorks, TIBCO Administrator, TIBCO Designer, TIBCO BusinessConnect, and

To use an open-source R engine with TIBCO Spotfire ® Statistics Services, rather than the engines provided with the installation (that is, the default TIBCO ® Enterprise Runtime for

To use an open-source R engine with TIBCO Spotfire® Statistics Services, rather than the engines provided with the installation (that is, the default TIBCO® Enterprise Runtime for

TIBCO, Two-Second Advantage, TIBCO ActiveMatrix BusinessWorks, TIBCO Business Studio, TIBCO Enterprise Administrator, TIBCO Rendezvous, TIBCO Runtime Agent, and TIBCO Hawk are

Given its negative influence on ethical attitudes, it is likely to envisage that social cynicism mitigate the positive relationship between intrinsic religiosity

This model is of interest in that it renders the safety question algorithmically decidable - for a set of operations that has yet to be determined – by means of graph-based

The problem is that these new data types do not fit the existing massively parallel processing model that was designed for structured data in most data warehouses.. The cost to