############################################################################################# # # # WLjvm - Version 1.0 - READ ME !! # # # ############################################################################################# # # # Author : Gavin Satur (GS) - gavin.satur@mrkips.com - http://software.mrkips.com # # Date : 18th May 2009 # # # ############################################################################################# ---------------- (I) BACKGROUND: ---------------- WebLogic server processes are JVM processes running WebLogic Server classes. At times, it's required to know a few details about the WebLogic Server JVMs, like their versions and start-up options. Well, you could use "ps" on Linux or "/usr/ucb/ps" or "pargs" on Solaris to give you this information. However, these UNIX utilities display information in a format which isn't too pleasing to the eye (although "pargs" displays well-formatted details, you still need to use "ps" to determine the PID to use "pargs"). ----------------- (II) WHY WLjvm?: ----------------- WLjvm will display details comprising the version, build and startup options for a running JVM in which a specified WebLogic Server has been launched. The displayed details are well-formatted and easy to read. The only parameter that needs to be passed to WLjvm is the name of the WebLogic Server whose JVM details you wish to obtain. --------------------------- (III) SYSTEM REQUIREMENTS: --------------------------- --> Solaris/Linux --> Korn shell - /bin/ksh ---------------- (IV) TESTED ON: ---------------- WLjvm has been successfully tested on the following environments: --> WLS 10.0 MP1 + JRockit R27.5.0 (64-bit) + RHEL 5.1 + Intel Xeon x64 --> WLS 8.1 SP4 + Hotspot 1.4.2_05 (32-bit)+ Solaris 9 + Sparc ----------------------- (V) KNOWN LIMITATIONS: ----------------------- --> On some Operating Systems like SuSE Linux, the "ps" command displays threads within the JVM as processes and WLjvm does not cater to this scenario. --> Solaris 10 has introduced more security wherein a yser cannot use /usr/ucb/ps to view the entire process listing of a process owned by another user. So, if you're using WLjvm on Solaris 10, ensure you use the same user to execute WLjvm as that used to launch the WebLogic Servers. ----------------------- (VI) HOW TO USE WLjvm: ----------------------- The WLjvm software is available as a compressed tar archive, WLjvm_1.0.tar.gz, which consists of only 2 files - WLjvm.ksh and this ReadMe.txt. Get started by following the steps below: (1) Choose a directory for installation of WLjvm and upload the WLjvm_1.0.tar.gz file into that location. (2) Uncompress and untar WLjvm_1.0.tar.gz (Example commands: gunzip WLjvm_1.0.tar.gz; tar xvf WLjvm.tar) (3) Test the WLjvm.ksh script. Read sections below for details. SYNTAX: ksh WLjvm.ksh where, ==> name of the WebLogic Server whose JVM details you wish to obtain. EXAMPLE OUTPUT: ksh WLjvm.ksh managed1 ************************************************************************************************** JVM DETAILS FOR WEBLOGIC SERVER managed1 (PID = 16535) ************************************************************************************************** VERSION & BUILD =============== java version "1.5.0_14" Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_14-b03) BEA JRockit(R) (build R27.5.0-110_o-99226-1.5.0_14-20080528-1505-linux-x86_64, compiled mode) OPTIONS ======= -da -Dbt.weblogic.RootDirectory=/software/bea/domain1 -Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0 -Dlog4j.configuration=file:/software/bea/domain1/apacheLog4jCfg.xml -Dplatform.home=/software/bea/weblogic/wlserver_10.0 -Dweblogic.ext.dirs=/software/bea/weblogic/patch_wss110/profiles/default/sysext_manifest_classpath:/software/bea/weblogic/patch_wlw1020/profiles/default/sysext_manifest_classpath:/software/bea/weblogic/patch_wls1001/profiles/default/sysext_manifest_classpath:/software/bea/weblogic/patch_wlp1020/profiles/default/sysext_manifest_classpath:/software/bea/weblogic/patch_wli1020/profiles/default/sysext_manifest_classpath:/software/bea/weblogic/patch_cie640/profiles/default/sysext_manifest_classpath -Dweblogic.home=/software/bea/weblogic/wlserver_10.0/server -Dweblogic.management.discover=false -Dweblogic.management.server=http://myadmin:7101 -Dweblogic.Name=managed1 -Dweblogic.ProductionModeEnabled=true -Dweblogic.system.BootIdentityFile=/software/bea/domain1/security/boot.properties -Dwli.home=/software/bea/weblogic/wlserver_10.0/../wli_10.2 -Dwls.home=/software/bea/weblogic/wlserver_10.0/server -jrockit -Xgc:gencon -Xms:1g -Xmx:1g -Xverbose:gcreport -Xverboselog:/software/bea/domain1/logs/bea/managed1_jrockit_20090515121812.log -Xverbosetimestamp ************************************************************************************************** # ##################################### THE END ###########################################