TIBCO Hawk Database Adapter Installation and Configuration

Dhananjay Kumar

Revision History:

Version Date Notes1.0 09-Nov-2012 Initial version

1

Table of ContentsIntroduction.............................................................................................................................................3

Required Tools.........................................................................................................................................3

Prerequisites............................................................................................................................................3

Install Hawk Database Adapter................................................................................................................3

Configuration...........................................................................................................................................4

Running the service.................................................................................................................................5

Troubleshooting......................................................................................................................................5

2

IntroductionThis document will guide you through the pre-requisites and configuration of Hawk Database Adapter with MS SQL Server 2008 R2.

Required Tools TIB_hawkdbhma-simple_4.6.0_w32 Microsoft SQL Jar Files <MS SQL Jar>

- The JDBC JAR files contains three jar files msbase.jar, msutil.jar, mssqlserver.jar

- It can be downloaded from Microsoft site or easier way is to get this file from your colleagues who have already done the configuration.

Prerequisites

AMX BPM server should be setup using the tct configuration. TIBCO HWAK should be installed. Copy the MS SQL Jar Files into local folder <MS SQL Jar>

Install Hawk Database Adapter Double-click on the file TIB_hawkdbhma-simple_4.6.0_w32.exe from the installation. If prompted for JRE_HOME , give the path <TIBCO_HOME>\tibcojre64\1.6.0 In the JDBC CLASSPATH, select MS SQL and give the location of the jar files.

<MS SQL Jar>\msbase.jar; <MS SQL Jar>\mssqlserver.jar; <MS SQL Jar>\msutil.jar

3

Configuration Copy <hawk_cfgmgmt>/bin/tibhawkagent.exe and paste in the same location and rename it to

tibhawkdbhma.exe. Copy <hawk_cfgmgmt>/bin/tibhawkagent.tra and paste in the same location and rename it to

tibhawkdbhma.tra. Copy sql configuration file : Copy the sqlserverDBHma.xml file

FROM < tibcoHome >/ hawk/4.9/adapters/dbhma/sqlserver/samples/TO <hawk_cfgmgmt>/bin

Edit tibhawkdbhma.trao Add

'<tibcoHome>/hawk/4.9/adapters/dbhma/java;<tibcoHome>/hawk/4.9/adapters/dbhma security/TIBCrypt.jar;<MS SQL jar file> ' to the end of tibco.class.path.extended.

o Change property java.start.class :

OLD java.start.class COM.TIBCO.hawk.agent.HawkAgent

NEW java.start.class COM.TIBCO.hawk.dbhma.DBHma

o Change the property application.args:Replace the whole line starting with application.args with application.args -xml_file <hawk_cfgmgmt>/bin/ sqlserverDBHma.xml.

o Change the property ntservice.name:

OLD TIBHawkAgent

NEW TIBHawkDBHMA

o Change the property ntservice.display:

OLD TIBCO Hawk Agent

NEW TIBCO Hawk MS SQL Database Agent

o Change the property ntservice.binary.path.absolute:

OLD C:\\ProgramData\\amxbpm_1.3.1\\tibco\\cfgmgmt\\hawk\\\\bin\\\\tibhawkagent.exe

NE C:\\ProgramData\\amxbpm_1.3.1\\tibco\\cfgmgmt\\hawk\\\\bin\\\\

4

W tibhawkdbhma.exe

Edit sqlserverDBHma.xml:

o Change the following property values in the sqlserverDBHma.xml file.

PROPERTY OLD NEWdbURL jdbc:microsoft:sqlserver://

serverhost:1433jdbc:microsoft:sqlserver://localhosthost:1433

dbUser sa sadbPassword <specify the password you set for the

sql server>

o Specify the location for the traceFile

FIND ${hawk.hawk_root}REPLACE <tibcoHome>/hawk/4.9

Running the service Open cmd prompt , navigate <hawk_cfgmgmt >\bin and hit the following command:

The above script will start the Hawk database adapter services. You can now monitor the database using the Hawk Display.

Troubleshooting

If the microagents for the database are not available in the Hawk Display, check the log file in the directory specified in the traceFile.

CHECK Yes/NoMS SQL Server is up?You are able to login to database: sa / <password>

5

tibcohawkdbhma.exe

The three sql jdbc jar files exist in the location < MS SQL Jar >

6