This guide is designed for beginners to quickly start a FS trip.

Who uses Fusionspy?

Say you are maintaining some IT systems built up with Oracle middlewares such as Tuxedo, WebLogic Server etc, then you would like to use Fusionspy!

Why use Fusionspy?

Fusionspy can help you collect desired runtime data from WebLogic and Tuxedo and store them in an embedded database.

What does Fusionspy comprise?

Fusionspy product includes three modules:

l A desktop client used to manage monitor sites and collected data.

l An agent application to sample runtime data from Tuxedo domain.

l An agent application to sample runtime data from WebLogic domain.

How to use Fusionspy?

We provide a very common and simple scenario to help you quickly make Fusionspy running.

Assume that in our network environment, machines described as below exist:

l Machine A: will be used to host client application

n Windows XP installed

l Machine B: will be used to host agent application for weblogic monitoring

n Linux OS installed

n IP address is 192.168.1.10

n WebLogic Server 8.1 product installed under /home/bea/weblogic81

n JDK 1.4 installed under /opt/java14

n An admin server instance is listening on 7001 at this machine

n One of domain’s admin account is like: weblogic/weblogic

l Machine C: will be used to host agent application for tuxedo monitoring

n AIX OS installed

n IP address is 192.168.1.12

n Tuxedo 8.1 product installed under /home/bea/tuxedo8.1

n Application’s TUXCONFIG is set to /home/bea/tuxedo8.1/app/tuxconfig

And then complete following steps:

1. upload archived agent application to Machine B. (e.g. /home/fusionspy)

2. explode the archive by inputting: tar –xvf wlsagent.tar

3. edit ./wlsagent/startAgent.sh by setting:

l WL_HOME = /home/bea/weblogic81

l FS_HOME = /home/fusionspy/wlsagent

l JAVA_HOME = /opt/java14

l AGENT_NAME = wlsAgent001

l PORT_NUM = 9001

4. launch the agent application by executing startAgent.sh:

./startAgent.sh

5. download the client installation file to machine A and execute it, just follow guide pane and make installation done, assume you installed the client application under D:\Program Files\FusionSpy

6. double-click FusionSpy.exe

7. click ‘File > Connect’, a pane named ‘Monitor Sites List’ pop out

8. Click Add button, and fill the blank fields as:

l Name: wlsSite-192.168.1.10

l choose ‘WebLogic’ from the right select object

l Agent IP: 192.168.1.10

l Port: 9001

l WebLogicServer Version: 8.X

l WebLogic Console Port: 7001

l WebLogic Console User: weblogic

l WebLogic Console Pwd: weblogic

9. click OK button

10. select the site you just created, and click Connect button

11. WebLogic Monitor pane will appear then

12. check Record to Database box

13. fill in the filed Interval(S) with a value, here you can use default value as 30’’

14. click the Start button

15. after all the internal initial logic is done, you can now see some result data on the pane gained from the weblogic agent you deployed just now

16. in machine A’s client directory (D:\Program Files\FusionSpy), you can also see a db-suffixed file, all the collected data will be stored into this

17. to browse the history data, please use the tool named ‘Sqlite’, Sqlite is a kind of db client tool which can drill in the history data

18.  if you want to stop the agent, do like below: 1) stop the fusionspy desktop by click Stop button. 2) stop the agent by execute the  stopAgent.sh(WebLogicAgent) or sh AgentStop(TuxAgent). that’s ok.

You want to try to monitor tuxedo runtime? Ok, just replace the steps 1/2/3/4/8 above with following steps:

1. upload archived agent application to Machine B. (e.g. /home/fusionspy)

2. explode the archive by inputting: tar –xvf tuxagent.tar, there maybe create a new directory, named tuxagent.

3. cd tuxagent and edit ./TuxAgent.env by setting:

l APPDIR = /home/fusionspy/tuxagent

l TUXCONFIG = /home/bea/tuxedo8.1/app/tuxconfig

l TUXDIR = /home/bea/tuxedo8.1;

and keep others setting as they are. then save this file.

edit the AgentStart file bye setting the port, or keep the default as 7898:

./TuxAgent 7898

then save this file.

4. launch the agent application by executing AgentStart:

./startAgent or sh ./AgentStart.

8. at fusionspy desktop , Click Add button, and fill the blank fields as:

l Name: tuxSite-192.168.1.12

l choose ‘Tuxedo’ from the right select object

l Agent IP: 192.168.1.12

l Port: 7898