The administration framework supports application deployment either through the bwadmin command line utility or the Admin UI. The provided scripts can be used to set up runtime entities that are useful for testing purposes. This tutorial walks you through running scripts and navigating runtime entities in the Admin UI.
The administration framework contains:

● The Admin UI hosted on TIBCO Enterprise Administrator (TEA)

● A powerful back-end bwagent designed to scale across large numbers of actual or virtual machines to manage large scale deployment.

● A simple, flexible, and easy-to-use bwadmin command line utility. This section of the Getting Started guide shows how to:

1. Create runtime entities (Domains, AppSpaces, and AppNodes) and upload and deploy archive files using scripts.
2. Start and stop applications using the Admin UI.
3. Navigate runtime entities using the Admin UI.

For more information on runtime entities, refer to the Administration Concepts section in the Concepts guide.

For more information on the commands used in this sample, refer to the Getting Started section in the Administration guide.

Running Admin Sample Scripts

This tutorial walks you through running the Bookstore and Acme administration scripts.

Prerequisites

If you want to run scripts, the installation directory cannot contain one or more spaces. For example, on Windows TIBCO ActiveMatrix BusinessWorks’ Enterprise should not be installed to the Program Files folder.

1. Optional. Install TIBCO Enterprise Message Service™ 8.x or higher if you want to run the Acme.com applications.

2. Optional. Install PostgreSQL 9.3.x if you want to run the Bookstore sample.Refer to Installing PostgreSQL for details.

3. On Windows, you must install the latest Cygwin 64-bit version from http://www.cygwin.com/. Scripts must be executed with Cygwin. Install the Utils and Net package which contains the diff.exe and ssh.exe executables.

a) Select the Utils and Net packages and change the option from Default to Install. Refer to the following images that show the Utils and Net packages.

Utils Package

Net Package

Procedure

1. Install TIBCO ActiveMatrix BusinessWorks . For example,
a) On Unix, install TIBCO ActiveMatrix BusinessWorks into /opt/tibco/bw-6.2 as
a. TIBCO_HOME.
b) On Windows, install TIBCO ActiveMatrix BusinessWorks into c:/tibco/bw-6.2 as
a. TIBCO_HOME.

2. From here onwards, the following instructions will use the directory path mentioned above to refer to certain installed files. Replace this path with the install directory of your choice.

Important: On Windows OS, avoid installing TIBCO ActiveMatrix BusinessWorks in a directory with space. The product binary supports it, however, the scripts in ${BW_HOME}/scripts/admin and ${BW_HOME}/samples/core/admin are bash scripts and work best with directory paths without space.

3. Install TIBCO Enterprise Administrator 2.0 or compatible version, in the same TIBCO_HOME. When TIBCO Enterprise Administrator installer prompts for JAVA_HOME path, point to /opt/ tibco/bw-6.2/tibcojre64/1.7.0 on UNIX. On Windows, point to c:/tibco/bw-6.2/ tibcojre64/1.7.0.

You can install TIBCO Enterprise Administrator in a separate TIBCO_HOME. If you choose to do that, refer to Step 4.

4. Install TIBCO Enterprise Message Service 8.1, or compatible version, in the same TIBCO_HOME. You can install TIBCO Enterprise Message Service in a separate TIBCO_HOME. If you have installed TIBCO Enterprise Message Service in a separate TIBCO_HOME, refer to Step 4.

5. On UNIX: If you have installed TIBCO Enterprise Administrator and/or TIBCO Enterprise Message Service in a separate TIBCO_HOME than TIBCO ActiveMatrix BusinessWorks , open /opt/tibco/bw-6.2/bw/6.2/scripts/bashrc.sh in a text editor and adjust TEA_HOME and EMS_HOME to point to where you have installed them.

6. This step is applicable only to Windows OS. From a proper text editor (Do not use Notepad.exe), open and edit c:/tibco/bw-6.2/bw/6.2/scripts/bashrc.sh. Search and replace all occurrences of C:/ (or whatever letter drive you have installed TIBCO ActiveMatrix BusinessWorks ) with / cygdrive/c/ (or /cygdrive/<drive-letter-where-you-installed-bw6>).

Adjust TEA_HOME and EMS_HOME to point to the location, where you have installed them.

Source the bashrc.sh script from your ~/.bashrc or ~/.profile files.

7. On UNIX: Locate your ~/.bashrc or ~/.profile file and add the following line at the end:

source/opt/tibco/bw-6.2/bw/6.2/scripts/bashrc.sh

On Windows: Edit the .bashrc file located at CYGWIN_HOME/home/<UserName> to add the following line at the end:
sourcec:/tibco/bw-6.2/bw/6.2/scripts/bashrc.sh

8. Open a new command line window and verify whether the following environment variables are configured correctly. The following commands shows output consistent with the example path mentioned in Step 1.

1. % echo $TIBCO_HOME
i. On UNIX: /opt/tibco/bw-6.2
ii. On Windows: /cygdrive/c/tibco/bw-6.2
2. % echo $BW_HOME
i. On UNIX: /opt/tibco/bw-6.2/bw/6.2
ii. On Windows: /cygdrive/c/tibco/bw-6.2/bw/6.2
3. % echo $TEA_HOME
i. On UNIX: /opt/tibco/bw-6.2/tea/2.0
ii. On Windows: /cygdrive/c/tibco/bw-6.2/tea/2.0
4. % echo $EMS_HOME
i. On UNIX: /opt/tibco/bw-6.2/ems/8.1
ii. On Windows: /cygdrive/c/tibco/bw-6.2/ems/8.1
5. % echo $JAVA_HOME
i. On UNIX: /opt/tibco/bw-6.2/tibcojre64/1.7.0
ii. On Windows: /cygdrive/c/tibco/bw-6.2/tibcojre64/1.7.0
6. % which bwadmin.sh
i. On UNIX: /opt/tibco/bw-6.2/bw/6.2/scripts/admin/bwadmin.sh
ii. ON Windows: /cygdrive/c/tibco/bw-6.2/bw/6.2/scripts/admin/bwadmin.sh
7. Change to the admin folder by typing: admin
8. Issue the following command to create the BookStore sample, create the domains for the Acme sample, create the Samples-Domain, and deploy all sample archive files:
runAll.sh
9. Running the runAll.sh script automatically updates the Admin “local” mode to “enterprise” mode.

You can use -clean option which cleans TEA Server Data Store and BW Domain Data Store.

This script may take up to 10 or 15 minutes to complete. To see how long it takes to run the sample, issue the time runAll.sh command to measure the time the script takes to complete.

If you don’t want to run all the samples at the same time, then run the following commands:

bootstrap.sh -clean

Caution: Running the bootstrap.sh with the -clean option wipes clean the TEA server and the ActiveMatrix BusinessWorks domain datastore. Use the –clean option only if you want to clear the TEA server and ActiveMatrix BusinessWorks domain datastore.

runBookStore.sh – to run REST BookStore sample , or

runSamples.sh to run other samples

10. Open a web browser and go to the Admin UI at the following URL: http://localhost:8777/tea
11. Log in using the credentials of Username: admin and Password: admin
12. Click BusinessWorks in the Products list to see the following domains in the Domain Management screen.

• Acme-QA-Domain
• Acme-UAT-Domain
• BookStore-Domain
• Samples-Domain

Drill down into any of the domains to see the created runtime entities, such as AppSpaces, AppNodes, application archives, and applications.

Testing the Deployed RESTful BookStore Application from Admin Web UI

The runAll script creates four domains, with multiple AppSpaces and AppNodes. The instructions in this topic show how to navigate the Admin UI to view the runtime entities.

Procedure

1. In the TIBCO Enterprise Administrator browser window, click TIBCO Enterprise Administrator at the top of the page to open the home page.

2. Click the BusinessWorks icon in the Products list to display the Domains page. The Domains Management page displayed.

3. Click BookStore-Domain to drill down into domain details, then click Monitor to see a dashboard.

4. Click an entity in the side bar, such as AppNodes, to pivot views.

5. To view the BookStore application deployed earlier, select Applications on the left. A single application archive is displayed.

6. Go to Applications to view the deployed applications

7. In the Application view, click the REST Doc URL.

8. Test the deployed application in the Google Chrome browser using Swagger UI. Open localhost: 8777/tibco.bw.sample.binding.rest.BookStore.application.

9. To execute the REST operations exposed by the BookStore application, click the GET/books icon and then click Try it Out!.

This displays a list of all books. Locate and copy an ISBN.

10. Click the GET/books{ISBN} icon to get a book by its ISBN.
11. Enter the ISBN and then click Try it Out!.
You can see the book details in the Response Body.

Defining and Deploying Multiple AppSpaces and AppNodes

The runAll script defines multiple AppSpaces and AppNodes and deploys multiple applications to these AppNodes. This topic shows how to navigate the Admin UI to locate these runtime entities.

Procedure

1. Navigate to the Domain Management page by clicking the TIBCO Enterprise Administrator icon and choosing BusinessWorks in the Products area.
2. Choose the Acme-QA-Domain to see the Monitor page that shows the status of AppSpaces, AppNodes, and applications.
3. Click AppSpaces in the side bar to display the AppSpaces page. (You can also click the AppSpace icon on the Monitor page.) Change the view of the page by clicking the icons in the upper right of the screen.

4. Now, view the AppNodes. Click AppNodes in the side bar.

5. View the application archives by clicking Application Archives in the side bar.

6. Execute the killall.sh command to shut down all running components.

7. Run the bwclean.sh command to clean up.

Core Admin Sample Scripts

• The sample scripts provide a simple and faster way to run the core Admin samples. These are bash scripts. On Windows, install Cygwin64.

• Admin scripts are located in the following folders: BW_HOME/samples/core/admin and BW_HOME/ scripts/admin

• For information on running the sample scripts, refer to “Running Admin Sample Scripts” in the Getting Started guide.

• This sets the TIBCO_HOME, BW_HOME, TEA_HOME, EMS_HOME, and JAVA_HOME environment variables necessary to run the admin scripts.

• All scripts support the -h | -help command-line argument with full documentation of what each script does.

Notable Changes

The admin scripts in $BW_HOME/samples/core/admin have now been split into two sets:

1. The sample scripts are located in $BW_HOME/samples/core/admin
2. The scripts that are generic for Activematrix BusinessWorks 6 are located in $BW_HOME/scripts/ admin

Because of this split, the scripts are updated to rely on PATH setting to find those in #2. To make this easier to configure, after installation you can * auto-generate * $BW_HOME/scripts/bashrc.sh that can be sourced from your ~/.bashrc

You are *strongly recommended* to source BW_HOME/scripts/bashrc.sh to setup the following environment variables required to run the scripts mentioned in the table below:

1. TIBCO_HOME
Required
2. BW_HOME
Required
3. TEA_HOME
Optional but required if TIBCO Enterprise Administrator is to run on this machine.
4. EMS_HOME
Optional but required if TIBCO Enterprise Message Service is to run on this machine.
5. PATH
This variable is auto-populated based on the values of above variables.

So, this brings us to the end of blog. This Tecklearn ‘TIBCO BW Administration’ blog helps you with commonly asked questions if you are looking out for a job in TIBCO Business Works. If you wish to learn TIBCO Business Works and build a career in Business Intelligence domain, then check out our interactive, TIBCO Business Works Training, that comes with 24*7 support to guide you throughout your learning period. Please find the link for course details:

TIBCO Business Works

TIBCO Business Works Training

About the course

Tecklearn’s TIBCO Business Works training provides in-depth knowledge on all the key fundamentals of Business Works and also develops skills to design, test, deploy, and administer the TIBCO ActiveMatrix Business Works applications. By the end of the training, you will gain confidence to clear the TIBCO Business Works certification exam.

Why should you take TIBCO Business Works?

• The average annual pay for a TIBCO BW Professional is $136,500 per annum. -Neuvoo.ca.
• TIBCO BW global market share is 2%.
• With TIBCO BusinessWorks software, integration specialists can easily implement integration strategies using traditional enterprise integration patterns to modern cloud-based API-led approaches built with microservices and containers.

What you will Learn in this Course?

Overview of Integration and TIBCO BW5 Environment

• Enterprise Integration
• Enterprise application integration (EAI)
• EAI Concepts
• Overview of TIBCO platform
• TIBCO components

Installation

• TIBCO Installation
• Why ESB

TIBCO File, Data and General Activities

• Read and Write a File
• Parsing a File data
• Polling for specific files and copy specific data to another directory

TIBCO Database Activities

• Create project using JDBC palette activities via JDBC query and JDBC update
• Advance JDBC, Process in Subsets and Batch update
• TIBCO SQL Direct and Call Procedure Implementation
• Transactions and Checkpoint

Processing data efficiently

• Data Transformation Patterns
• Structural Mapping
• Disjoint Structure Mapping
• Merging, Aggregation
• Segregation
• Common XSLT and best practices

Overview of Service Oriented Architecture

• Basic Web Services Understanding
• XML overview – XSD, DTD, XSLT, XPath
• SOA Introduction, SOA Principles and Service Orientation, SOA Pattern
• Understanding WSDL, SOAP and UDDI concepts, W3C, SDO

SOAP Service Implementation

• Create SOAP demo project in TIBCO BW
• Creation of standard HTTP soap service
• Project Creation to expose security context for a web service which is implemented using service resource
• SOAP message is signed and encrypted using X.509 token

ESB (Enterprise Service bus)

• How Messaging Works
• Messaging Features and JMS
• Overview of TIBCO EMS
• Messaging Models
• Client Service Delivery Modes
• JMS Message Format
• Acknowledgement Modes
• Development of EMS Client using TIBCO BW5
• Implementing Failover, Load Balancing using JMS Activities
• Destination Bridging to avoid writing huge code

Introduction to TIBCO Adapter Services

• Explore TIBCO ADB Adapter Explore
• Configure ADB Publication and subscription services

Advance Service Design

• Using Variables Using Sub processes, using Null Activities
• Inter Process Communication
• Extending the mapper
• Java Custom Function

Introduction to REST

• Installing active matrix business work plug-in for REST and JSON 2.0
• Fundamentals of REST and REST Architectural Elements
• RESTful Service and REST Operation Details
• REST Clients: Postman, Advance Rest Client and SOAP UI
• Creation of REST service
• Conversion of business logic into REST service
• Binding, input binding, output binding, mapping activity
• SOAP Demo

Extending Business Works

• Java activities, Custom Palettes Engine Command, Error Handling, Plugins and add-ons
• SOAP Project with two endpoints, one for HTTP and one for JMS
• Securing Web Services

TIBCO Administration

• TIBCO BW Run time Architecture
• Communication and Domain creation
• Management and Configuration of Robust Domain
• Managing and Monitoring Deployments
• Fault tolerance and load balancing
• Domain, process archive and shared archive
• HAWK agent
• Performance Tuning
• BW Engine
• Deployment and Management
• Loading using AppManage

Introduction to Tools like Ant, Eclipse, Maven, Jenkins

917