Bwmonitor 6.0.0 Quick Start Guide

BWMonitor 6.0.0 Quick Start Guide

Prerequisites:

The BW Monitor requires

1. Java 1.6.22 or later

2. Application server (e.g., Tomcat 6.0 +)

e.g.CATALINA_HOME=

C:\Program Files\Apache Software Foundation\Tomcat_6.0.24

3. BusinessWorks 5.7.2 + or 5.6 or earlier.

4. Adobe® Flash Player 9.0 or greater

5. TIBCO EMS, TIBCO RV, TIBCO HAWK 4.7+

The following environment variables should be set manually;

JAVA_HOME = main install directory of Java

Ex:JAVA_HOME=C:\Program Files\Java\jdk1.6.0_31

CATALINA_HOME =install directory of Tomcat

CATALINA_HOME=

C:\Program Files\Apache Software Foundation\Tomcat_6.0.24

TIBJMS_ROOT= main install directory of Tibco EMS.

TIBJMS_ROOT=C:\tibco\ems\6.1

RV_ROOT= main install directory of Tibco RV.

RV_ROOT=C:\tibco\tibrv\8.3

HAWK_ROOT= main install directory of Tibco HAWK.

HAWK_ROOT= C:\tibco\hawk\4.9

CLASSPATH= C:\tibco\tibrv\8.3\tibrvnative.jar; C:\tibco\tibrv\8.3\lib

PATH=%PATH%:%JAVA_HOME%\bin;%RV_ROOT%/bin;%HAWK_ROOT%/bin

LD_LIBRARY_PATH= C:\tibco\tibrv\8.3\lib (Unix/Linux only)

Install BWAgent plug-in microagent for each domain

1. copy BWAgentPlugin.hma and BWAgentPlugin.jar from rtvapm/bwmon/lib/ to

TRA plugins directory

(C:\tibco\tra\domain\my_domain\plugin)

for the BW domain.

2. restart the HAWK agent for BW domain

Download Instructions:

Download BWMonitor_6.0.0.0.zip.

BWMonitor 6.0.0 Quick Start Guide for UNIX

Quick Start Instructions:

1. Copy zip files to your UNIX platform

2. In a ssh window, extract zips

unzip BWMonitor_6.0.0.0.zip

3. In a ssh window

cd BWMonitor_6.0.0.0/rtvapm

4. Run the script (assuming bsh)

. ./fixperms.sh

5. Run

. ./rtvapm_init.sh

to set envvars RTVAPM_HOME and install license.

Note: Run script every time BWMonitor is restarted.

6. cd $RTVAPM_HOME/bwmon/projects directory.

7. cp –r sample myproject

8. cd myproject directory to modify thertview.properties

fileusing a text editor such as vi to include the

BW Servers to be monitored.

Example 1: Hawk agents unixagent1, unixagent2, and unixagent3, are part of the hawk connection_name "prod_domain", using the rvd transport.

The syntax for the hawk communication entry:

sl.rtview.hawk.hawkconsoleconnection_name<transportdomain_name<service<network<daemon>

sl.rtview.hawk.hawkconsoleprod_domainrvd prod_domain7474 ; tcp:7474

sl.rtview.hawk.agentGroup UNIX_AGENTS unixagent1(prod_domain) unixagent2(prod_domain) unixagent3(prod_domain)

Example 2: Hawk agents winagent1, and winagent2 are part of the hawk connection_name "prod_domain" using the ems transport.

sl.rtview.hawk.hawkconsoleprod_domainemsprod_domaintcp://localhost:7222 username passwd

sl.rtview.hawk.agentGroup WIN_AGENTS winagent1(prod_domain) winagent2(prod_domain)

9. Copy bwmon.war from$RTVAPM_HOME/bwmon/webapps to ‘webapps’ directory of your application server (e.g., Tomcat).

10. Start Tomcat by running the script startup.sh located in the

‘bin’(\apache-tomcat-6.0.18-sl\bin)directory

11. cd $RTVAPM_HOME/emsmon/projects/myproject

12. To start all the BW Monitor applications:

start_rtv default

13. To start each BW Monitor application individually use the following commands:

start_rtv default database Starts the default database.

start_rtv defaultdataserverStarts the Data Server.

start_rtv default historian Starts the Historian.

start_rtv defaultdisplayserverStarts the Display Server.

14. Bring up a browser from your desktop and go to the following URL to view the

BWmonitor.

15. Check the logs in $RTVAPM_HOME/bwmon/projects/myproject/logs

forerrors.

BWMonitor 6.0.0 Quick Start Guide for Windows

Quick Start Instructions:

1. Copy zip files to your Windows platform

2. In a command window, extract zips

unzip BWMonitor_6.0.0.0.zip

3. In a command window,

cd BWMonitor_6.0.0.0/rtvapm

4. Type

rtvapm_init.bat

to set envvars RTVAPM_HOME and install license.

Note: Run script every time BWMonitor is restarted.

5. cd %RTVAPM_HOME%/bwmon/projects

6. Create a copy of sample directory and name it myproject

copy –r sample myproject

7. cd myproject directory to modify the rtview.properties

file using a text editor such as notepad to include the

BW Servers to be monitored.

Example 1: Hawk agents unixagent1, unixagent2, and unixagent3, are part of the hawk connection_name "prod_domain", using the rvd transport.

The syntax for the hawk communication entry:

sl.rtview.hawk.hawkconsoleconnection_name> <transport> domain_name> <service> <network> <daemon>

sl.rtview.hawk.hawkconsoleprod_domainrvd prod_domain7474 ; tcp:7474

sl.rtview.hawk.agentGroup UNIX_AGENT unixagent1(prod_domain) unixagent2(prod_domain) unixagent3(prod_domain)

Example 2: Hawk agents winagent1, and winagent2 are part of the hawk connection_name"prod_domain" using the ems transport.

sl.rtview.hawk.hawkconsoleprod_domainemsprod_domaintcp://localhost:7222 username passwd

sl.rtview.hawk.agentGroup WIN_AGENTS winagent1(prod_domain) winagent2(prod_domain)

8. Copy bwmon.war from%RTVAPM_HOME%/bwmon/webapps to ‘webapps’ directory of your application server (e.g., Tomcat).

9. Start Tomcat by running the script startup.batlocated in the

‘bin’(\apache-tomcat-6.0.18-sl\bin)directory

10.cd %RTVAPM_HOME%/emsmon/projects/myproject

11. To start all the BW Monitor applications: