WLWatchman Manual :: Getting Started

First of all, get hold of it. Unpack it to a directory of your choosing (an empty one is normally a good choice) and have a look at what's there.

Aside from the usual AUTHORS, CHANGES, LICENSE, README and TODO files you'll see in most OSS projects, there are the following items:

• start scripts for WLWatchman, in Windows and Unix flavours;
• the WLWatchman.jar file;
• a lib directory, containing third party jars, on which WLWatchman depends;
• a docs directory, containing the documentation you're currently reading;
• a samples directory, containing configuration file fragments. (These are documented here.)

Before you can use WLWatchman, you need to edit startWLWatchman.sh if you're on a unix-like system, or startWLWatchman.cmd if you're using MS Windows. This only needs doing once for your system, unless you change the locations of the installed BEA software. (In what follows, it is assumed that a unix system is being used, the corresponding changes and commands for Windows users are left as an exercise for the reader.)

First of all, put in the correct value for your BEA_HOME, JAVA_HOME and the server version you will be running against; WLWatchman requires a 1.4.2 JVM or later to run the console but any 1.3.1 or later JVM should be sufficient to run the command-line version, you're not obliged to use JRockit^TM, the JVM that comes with WebLogic:

BEA_HOME=/bea
SERVER_VERSION=8.1
JAVA_HOME=/usr/java/jdk131_08
	  

This allows WLWatchman to use the right version of the WebLogic JMX extensions and RMI classes.

Next, ensure that the location for WEBLOGIC_HOME is correct - it defaults to, for example, ${BEA_HOME}/weblogic81 for WebLogic Platform 8.1 but you are free to modify this at install time and many people do. Put the correct path(s) in here:

8.1)
# WLS 8.1
WEBLOGIC_HOME=${BEA_HOME}/weblogic81
SERVER_HOME=${WEBLOGIC_HOME}/server
WLSENVFILE=${SERVER_HOME}/bin/setWLSEnv.sh
 . ${WLSENVFILE} 2>/dev/null 1>&2
;;

7.0)
# WLS 7.0
WEBLOGIC_HOME=${BEA_HOME}/weblogic70
SERVER_HOME=${WEBLOGIC_HOME}/server
WLSENVFILE=${SERVER_HOME}/bin/setWLSEnv.sh
 . ${WLSENVFILE} 2>/dev/null 1>&2
;;

6.1)
# WLS 6.1
WEBLOGIC_HOME=${BEA_HOME}/wlserver6.1
SERVER_HOME=${WEBLOGIC_HOME}
CLASSPATH=${SERVER_HOME}/lib/weblogic.jar
;;
	  

To start the server, change directory to where you unpacked the download and type:

./startWLWatchman.sh

to start up the console.