Copyright © Cloud Software Group, Inc. All Rights Reserved

Configuring an Endpoint Operation for TIBCO API Exchange Gateway

Refer to the following high level steps to configure a service operation on the TIBCO API Exchange Gateway platform:

•	Create a New Configuration

•	Configure Partner Group

•	Configure Partner Data

•	Configure a Facade Operation

•	Configure a Target Operation

•	Configure an Authorization Configuration

•	Configure Routing Configuration

•	Test the Gateway configuration

Create a New Configuration

1.	Launch the GUI. See Starting GUI for details.

2.	Expand the Projects node.

3.	Click the Add New Project Configuration icon. A new configuration with a default configuration name, ASG_Config_uniqueNumId, is created under Projects node.

4.	Move the mouse pointer over the new project configuration, select the icon to rename the configuration name as ASG_Get_Start and press Enter.

Configure Partner Group

1.	Click the ASG_Get_Start configuration.

2.	Click the Partner Groups tab.

3.	Click the Add property (+) icon on the top menu bar.

4.	Type the values for the fields as shown in the following table:

 

Table 3 Partner Group Configuration

Parameter	Value
Group Name	supportASG
Email	support@tibco.com
Phone	0019202331999

Configure Partner Data

1.	Select the ASG_Get_Start configuration.

2.	Click the PARTNER tab on the upper right tab.

3.	Click the Partners tab on the top menu bar.

4.	Click the Add property icon on the upper right to create a new partner.

5.	Type the values for the fields as shown in the following table:

 

Table 4 Partner Data Configuration

Parameter	Value
Partner Name	tibcoASG
Partner Email	support@tibco.com
Partner Phone	0019202331999
Partner Group	supportASG (select from the drop-down list)

Configure a Facade Operation

1.	Select the ASG_Get_Start configuration.

2.	Click the ROUTING tab on the upper right tab.

3.	Click the Facade Operations tab on the top menu bar.

4.	Click the Add property icon on the upper right to create a new facade operation.

5.	Type the values for the fields as shown in the following table:

Table 5 Facade Operation Configuration

Parameter	Value
Operation Name	queryBookByAuthorBW
SOAP Action	"/GetBooksByAuthorEndpoint"
Operation URI	/ServerProcesses/GetBooksByAuthorEndpoint
Operation Service Name	MWC

Configure a Target Operation

1.	Select the ASG_Get_Start configuration.

2.	Click the ROUTING tab on the upper right tab.

3.	Click the Target Operations tab on the top menu bar.

4.	Click the Add property icon on the upper right to create a new target operation.

5.	Type the values for the fields as shown in the following table:

 

Table 6 Target Operation Configuration

Parameter	Value
Operation Name	http.GetBooksByAuthor
Type	HTTP (select from the drop-down list.)
Timeout	30000
SOAP Action	"/GetBooksByAuthorEndpoint"
URI	/ServerProcesses/GetBooksByAuthorEndpoint
Host	127.0.0.1
Port	9696

Configure an Authorization Configuration

1.	Select the ASG_Get_Start configuration.

2.	Click the PARTNER tab on the upper right tab.

3.	Click the Facade Access tab on the top menu bar.

4.	Click the Add property icon on the upper right to create a new partner operation.

5.	Type in the following values:

 

Table 7 Partner Authorization Configuration:

Parameter	Value
Partner	tibcoASG (select from the drop-down list.)
facade Operation	queryBookByAuthorBW (select from the drop-down list.)
Partner Timeout	5000

Configure Routing Configuration

1.	Select the ASG_Get_Start configuration.

2.	Click the ROUTING tab on the upper right tab.

3.	Click the Routing tab on the top menu bar.

4.	Click the Add property icon on the upper right to create a new routing configuration.

5.	Type in the following values:

 

Table 8 Routing Configuration

Parameter	Value
Operation Name	queryBookByAuthorBW (select from the drop-down list.)
Routing Type	Target Operation (select from the drop-down list.)
Routing Key	default
Target Operation	http.GetBooksByAuthor (select from the drop-down list.)

Save the Gateway Configuration

On the menu bar, click the Save Configuration icon to save the ASG_Get_Start configuration.

Test the Gateway configuration

Run Apache HTTP Server, if not running

See Running the Apache HTTP Server for details.

Run Core Engine

1.	Navigate to the TIBCO API Exchange Gateway installation as follows:

   cd ASG_HOME/bin

2.	Start the Core Engine for the ASG_Get_Start configuration as follows:

On the Windows platform, type the following command:

   asg-engine -u asg-caching-core -a ASG_Get_Start

On the UNIX platform, type the following command:

   ./asg-engine -u asg-caching-core -a ASG_Get_Start

3.	Verify that the Core Engine starts successfully without any errors.

4.	In the Core Engine log file, verify that the configuration for operation, services and partner are loaded correctly. By default, the Core Engine log file is asg-caching-core.log which is located under ASG_CONFIG_HOME\logs directory.

Test the Configured Operation and Target Operation

1.	Launch TIBCO Designer.

2.	Open the following project:

ASG_HOME/examples/BookQuery/BookQuery

3.	Run the following server process:

BooksInterface-service1

4.	Run the following client process:

QueryByAuthorClient

5.	Verify that the process runs successfully without any errors.

Copyright © Cloud Software Group, Inc. All Rights Reserved