Copyright © Cloud Software Group, Inc. All Rights Reserved
Copyright © Cloud Software Group, Inc. All Rights Reserved


Chapter 5 Tutorial : Procedure
Procedure
The following sections provide details about how the details how to develop and deploy a project:
1.
Importing the TIBCO Designer Project
2.
Importing the TIBCO SOA Project
3.
Reviewing the Composite Configuration
4.
Reviewing the JDBC-Based Storage Settings
5.
Creating a Distributed Application Archive (DAA)
6.
Setting Up the Environment for TIBCO ActiveMatrix
7.
Adding an HTTP Connector Resource Instance
8.
Deploying the DAA
Importing the TIBCO Designer Project
The example project is a predefined designer project. This section shows how to import the predefined BWSE Designer project to TIBCO Business Studio and change the configuration as necessary.
Complete the following steps to import an existing Designer project:
1.
Start TIBCO Business Studio.
2.
Select File > New > Project from the Menu to open the New Project window.
3.
Select TIBCO Designer > TIBCO Designer Project in the Select A Wizard page, and then click the Next button.
* 
Before you create a new TIBCO Designer project, you need to install TIBCO ActiveMatrix BusinessWorks SmartMapper Plug-in or TIBCO ActiveMatrix BusinessWorks SmartMapper Enterprise Server.
4.
Select the Create Project Using Existing Designer Project radio button, and then click the Browse button to specify the project location.
The directory for the BWSE Designer project is TIBCO_HOME\bwse\plugins\smartmapper\samples.
5.
Click the Finish button.
The BWSE Designer project appears in the Project Explorer panel.
Importing the TIBCO SOA Project
Complete the following steps to import the existing SmartMapperReference SOA project:
1.
Select File > Import from the Menu in TIBCO Business Studio.
2.
Select General > Existing Projects Into Workspace, and then click the Next button in the Import dialog.
3.
Select the root directory of the SOA project.
The directory for the SmartMapperReference SOA project is TIBCO_HOME\bwse\plugins\smartmapper\samples.
4.
Check the Copy Projects Into Workspace checkbox, and then click the Finish button.
The SmartMapperReference SOA project appears in the Project Explorer panel.
* 
To create a new TIBCO SOA project, refer to Creating a TIBCO SOA Project for details.
Reviewing the Composite Configuration
Complete the following steps to review the composite configuration:
1.
Expand the Composites folder of the SmartMapperReference project in the Project Explorer panel.
2.
Double-click the predefined SmartMapperReference.composite composite to launch the Composite Editor.
Figure 7 Composite
3.
Select the component on the canvas and view its configuration from the Properties tab.
4.
Select the promoted service named invokeOperationTP and view the binding configuration from the Properties tab.
Figure 8 Promoted Service Binding
5.
Select the component or composite property to view the property configuration from the Properties view.
* 
Make sure that the path in the Value field points to the BWSE BusinessWorks project.
Figure 9 Composite Property
6.
Save the configuration if any changes have been made.
Reviewing the JDBC-Based Storage Settings
Before creating the DAA file, make sure that the information of JDBC-Based SmartMapper Service in the TIBCO BusinessWorks project (BWSE project) is correct.
Figure 10 shows a sample screen of the JDBC Settings panel.
Figure 10 JDBC Settings
The following steps show how to review and update the JDBC settings:
1.
Double-click the SmartMapper ER Model.smartmappermodel file in the Project Explorer panel.
2.
Double-click the Storage folder.
3.
Select JDBC-Based SmartMapper Service, then click the JDBC Settings tab.
4.
Configure the information in the JDBC Settings tab, such as, JDBC URL String, username, and password.
5.
Click the Synch ER Model W/ DB button to synchronize the Entity Relationship (ER) Model.
Refer to TIBCO ActiveMatrix BusinessWorks SmartMapper User’s Guide (Chapter 7 SmartMapper ER Model Resources) for details about JDBC-Based SmartMapper Service.
6.
Test the connection:
a.
Add the MYSQL JAR into the environment.
−
Copy and paste the JAR you want to use in the TIBCO_HOME\bw\plugin\lib directory.
−
Close Business Studio.
−
Run the generateManifest.exe generate manifest tool. It is available under TIBCO_HOME\dabs\version_number\tools\generateManifest.
−
Start TIBCO Business Studio. Open the command window, change to the TIBCO_HOME\studio\version_number\eclipse directory, then type TIBCOBusinessStudio - clean.
−
Click the Test Connection button.
Creating a Distributed Application Archive (DAA)
Projects developed during design time need to be packaged into a DAA file before you can deploy them in the TIBCO ActiveMatrix environment.
To create a DAA using Business Studio, complete the following steps:
1.
Expand the Composite folder in the Project Explorer panel, right-click the composite, and select Create DAA.
2.
Select the Deployment Artifacts folder in the Select Archive Location page.
Enter a new filename or accept the default name in the File Name field. Then click the Next button.
3.
Select the Do Not Use A Distribution File radio button in the Select Distribution page, then click the Next button.
4.
Check the Save DAA Spec checkbox in the DAA Specification page, and then click the Finish button.
The SmartMapperReference DAA file is created successfully and stored in the SmartMapperReference\Deployment Artifacts folder in your workspace.
Setting Up the Environment for TIBCO ActiveMatrix
Complete the following steps to set up the environment for TIBCO ActiveMatrix:
1.
Start TIBCO Enterprise Message Service (EMS) Server.
Right-click the My Computer icon on your desktop, select Mange > Sevices and Applications > Services, and then select and start the TIBCO EMS Server service.
2.
Start the predefined TIBCO host.
Run the executable named tibcohost.exe located in the configuration directory of TIBCO ActiveMatrix, for example: TIBCO_configuration_Folder\tibcohost\TibcohostInstance_name\host\bin.
* 
If you shut down the EMS server and the TIBCO host (for example, if you reboot your computer) before using TIBCO ActiveMatrix Administrator, you need to restart TIBCO EMS Server and the TIBCO host.
3.
Start TIBCO ActiveMatrix Administrator.
If TIBCO ActiveMatrix Administrator has been created:
a.
Launch a web browser and enter the Administrator URL, for example, http://host_name:8120/amxadministrator/loginForm.jsp, in the address bar to start the TIBCO ActiveMatrix Administrator Server.
b.
Enter the username and password to log in. The default username is root, and the password is t.
If TIBCO ActiveMatrix Administrator has not been created, see TIBCO ActiveMatrix BusinessWorks Service Engine Plug-in for SmartMapper Installation for instructions about how to create it.
Adding an HTTP Connector Resource Instance
The following steps describe how to add an HTTP Connector resource instance using TIBCO ActiveMatrix Administrator:
1.
Open TIBCO ActiveMatrix Administrator.
2.
Select Shared Objects > Resource Templates.
3.
Click the New button in the Resource Templates page. The Add Resource Template dialog appears.
4.
In the Add Resource Template dialog:
−
Enter httpConnectorSMLookup in the Name field.
−
Select HTTP Connector from the Type drop-down list.
* 
The name of the HTTP Connector resource must be the same as the binding connector name of the invokeOperationTP promoted service, as shown in Figure 8.
Also make sure that the values in the Machine Name and the Port fields are consitent with the Host and the Port fields when creating the concrete WSDL to run the example project, see Running the Example.
−
Click the Save button.
5.
Select the newly created HTTP Connector resource, then click the New Resource Instances button in the Resource Templates page.
The New Resource Instances dialog appears.
6.
In the New Resource Instances dialog:
−
Select the SystemHost host (the default host).
−
Select the DevNode node in the Available Nodes column, then click the button to move the DevNode node to the Selected Nodes column.
−
Click the Save And Install button.
Figure 11 New Resource Instances
The HTTP Connector resource instance is created successfully, as shown in Figure 12.
Figure 12 HTTP Connector Resource Instance
Deploying the DAA
The following steps describe how to deploy the DAA using TIBCO ActiveMatrix Administrator:
1.
Open TIBCO ActiveMatrix Administrator.
2.
Select the Applications tab and click the New button.
3.
Configure the application in the New Application dialog.
a.
Enter a name in the Application Name field, for example, SmartMapperReference.
b.
Select the Upload A DAA File radio button.
c.
Click the Next button.
4.
Click the Browse button and select the DAA file created previously in Creating a Distributed Application Archive (DAA).
5.
Click the Next button.
6.
Review the application setup information and click the Done With Application Setup button.
* 
You can click the Save and Exit button instead, and then configure and deploy the application in a different way, as shown in step 4 of Setting Up the BWSE Plug-in for SmartMapper Application.
Refer to the TIBCO ActiveMatrix Administration documentation for more details. You can access the online help by clicking the Help button on the top-right corner of the Administrator page.
7.
Accept the defaults and click the Next button.
8.
Select the host on which you want to distribute the application.
9.
Click the Next button until you see the Customize Your Node Selection page.
10.
Select the DevNode node from the drop-down list in the Node Name column, then click the Save And Exit button.
11.
Add the Third-Party driver to the DevNode node.
* 
This exmple uses the MySQL database. Refer to TIBCO ActiveMatrix BusinessWorks Service Engine Plug-in for SmartMapper Installation for more information about how to add a Third-Party driver to the node manually.
12.
Click the Deploy button.
The application is deployed successfully and appears in the Applications table’s Runtime State column as Running, as shown below in Figure 13.
Figure 13 Deploy and Run the Service
Copyright © Cloud Software Group, Inc. All Rights Reserved
Copyright © Cloud Software Group, Inc. All Rights Reserved