Installation Guide

This package comes with pre-built binaries and example properties located in the dist directory. Those distribution files are:

Jour contains multiple parts that need to be installed
1) Instrumentation - required for production servers.
2) Data analyses Monitoring agent - No need to install it on production servers.
3) WebLogic server console extension - optional.

1) Copy the context of the distribution directory to D:\jour

2) Copy: libJourNative.dll to C:\WebLogic\wlserver6.1\bin
   This file is required to get more accurate time stamps.

3) Change applicationClassPATH.bat set CLASSPATH=
   To the value taken from registry for existing running server.

4) Modify file jour.xml to include API you are going to monitor.

5) run D:\jour\runJourPreprocessesExecute.bat
   This would created directory D:\jour\iclasses
   And zips the context to new file:
   D:\jour\iclasses.jar

   Copy the file D:\jour\iclasses.jar to D:\jour\tr\iclasses.jar

6) Install new server or modify existing WL Windows Server

The only change is to add new values to the beginning of class path:
CLASSPATH=D:\jour\rt\;D:\jour\rt\iclasses.jar;D:\jour\rt\jour_rt.jar;_OLD_CLASSPATH_...

Directory: D:\jour\rt\
Should contain two important files log4j.properties and jour.rt.properties used at runtime.
"rt" stands for runtime.

jour.rt.properties - Is used to modify the runtime settings:

autoreload=true
elog.ON=true
BulkEventFileWriter.dest_folder=D:/jour/rt/trace

If the value of autoreload is true the Jour will detect changes in the file.
Important value is elog.ON=true or elog.ON=false
elog.ON=false completely disables collection and output of monitoring information.

 If file jour.rt.properties not found by application then monitoring would be disabled.

 File log4j.properties is used to configure error and warning output from jour library.
 The output file is D:/jour/rt/jour_rt.logs
 If file log4j.properties does not exist no error output would be written.
 Once Server started and first call to instrumented classes is made you should see the INFO in file jour_rt.logs

Complete listing of files:
Runtime enviroment:
D:\jour\rt\
    iclasses.jar
    jour_rt.jar
    jour.rt.properties
    log4j.properties
D:\jour\logs\
    Create empty folder for logs.
D:\jour\rt\trace\
    This folder would be created automatically by running application.

C:\WebLogic\wlserver6.1\bin
    libJourNative.dll

Instrumentation environment to create file iclasses.jar:
D:/jour/
    APLILink.all.txt
    applicationClassList.txt
    applicationCLASSPATH.bat
    jour.xml
    jour_rt.jar
    log4jJour.preprocesses.xml
    runJourPreprocessesExecute.bat
    setJourLibs.bat
D:/jour/libs
    Additional xml libraries used by Jour.

runJourPreprocessesExecute.bat will create
     iclasses.jar  and jourInstrumentationMap.txt used by Runtime environment.

Analyses environment to read and analyze trace files.
D:/jour/
    jour_rt.jar
    jour_view.xml
    log4jJour.monitor.xml
    runJourMonitor.bat
    setJourLibs.bat
D:/jour/libs
    Additional xml libraries used by Jour.

1) Create the file iclasses.jar using Jour Preprocessesor

2) Create the directory structure and file:
D:\jour\rt\
    iclasses.jar
    jour_rt.jar
    jour.rt.properties
    log4j.properties
D:\jour\logs\
    Create empty folder for logs.
D:\jour\rt\trace\
    This folder would be created automaticaly by running application.

2) copy libJourNative.dll  To: C:\WebLogic\wlserver6.1\bin

3) Add: D:\jour\rt\;D:\jour\rt\iclasses.jar;D:\jour\rt\jour_rt.jar to WebLogic CLASSPATH

   Install new server as a copy of existing WL Windows Server.
   The only change is to add new values to the beginning of class path:
   CLASSPATH=D:\jour\rt\;D:\jour\rt\iclasses.jar;D:\jour\rt\jour_rt.jar;_OLD_CLASSPATH_...

4)
  When server started verify the file is created and has no errors: D:/jour/logs/jour-info_rt.log