#126183-07: Windows: Common Agent Container 2.1 Runtime Monitoring Webserver

Windows: Common Agent Container 2.1 Runtime Monitoring Webserver

Status: RELEASED

Patch Id: 126183-07

***********************************************************************
READ THE TERMS OF THE AGREEMENT ("AGREEMENT") IN THE LEGAL_LICENSE.TXT
FILE CAREFULLY BEFORE USING THIS SOFTWARE. BY USING THE SOFTWARE, YOU
AGREE TO THE TERMS OF THIS AGREEMENT. IF YOU DO NOT AGREE TO ALL OF THE
TERMS, PROMPTLY DESTROY THE UNUSED SOFTWARE.
***********************************************************************

Summary: Windows: Common Agent Container 2.1 Runtime Monitoring Webserver

Date:  Jan/14/2008

Installation Requirements:

Additional instructions may be listed below

Solaris Release: Note: Microsoft Windows

Sun OS Release: Note: Windows_2000, Windows_XP, Windows_2003

Unbundled Product: Cacao Common Agent Container

Unbundled Release: 2.1

Xref: This patch available for SunOS 5.9 5.10 in patch 123893-04, and for SunOS 5.9_x86 5.10_x86 in patch 123896-04, and for RHEL 3.0 4.0 in patch 123899-03

Topic:

Windows: Common Agent Container 2.1 Runtime Monitoring Webserver

Relevant Architecture: i386

BugId's fixed with this patch:

6449916 6458478 6467798 6468730 6470689 6471146 6472345 6474052 6474071 6474077 6474080 6474098 6474253 6474572 6476125 6476160 6476176 6476286 6478172 6478186 6480223 6481616 6483851 6486644 6488486 6490345 6492344 6497068 6498998 6528331 6542519 6548556 6549535 6567461 6570247 6576935 6585045 6629017 6633438

Changes incorporated in this version:


6576935 6629017 6633438

Patches accumulated and obsoleted by this patch:

Patches which conflict with this patch:

Required Patches:

126910-02 (or greater)

Obsoleted by:

Files Included in this Patch:

Note:
share/cacao_2/bin/cacaoadm.bat
share/cacao_2/configure.pl
share/cacao_2/RELEASE_NOTES.txt
share/cacao_2/configure.bat
share/cacao_2/README.txt
share/cacao_2/lib/cacao_admin.jar
share/cacao_2/lib/cacao_cacao.dll
share/cacao_2/lib/cacao_cacao.jar
share/cacao_2/lib/cacao_commandstream.jar
share/cacao_2/lib/cacao_efd.jar
share/cacao_2/lib/cacao_invoker.jar
share/cacao_2/lib/cacao_mib2simple.jar
share/cacao_2/lib/cacao_noentrypoint.jar
share/cacao_2/lib/cacao_rmi.jar
share/cacao_2/lib/cacao_snmpv3_adaptor.jar
share/cacao_2/lib/cacao_j5core.jar
share/cacao_2/lib/tools/template/config/private/cacao.properties
share/cacao_2/ext/instrum/README.txt
share/cacao_2/ext/instrum_jesmf/README
share/cacao_2/ext/webserver/README.txt
share/cacao_2/ext/instrum/lib/cacao_instrum.jar
share/cacao_2/ext/instrum_jesmf/config/com.sun.cacao.cmm.xml
share/cacao_2/ext/instrum_jesmf/config/com.sun.cacao.instrum.jesmf.xml
share/cacao_2/ext/instrum_jesmf/lib/cacao_instrum_jesmf.jar
share/cacao_2/lib/tools/cacaocsc.exe
share/cacao_2/lib/tools/cacaocsc_internal.exe
share/cacao_2/lib/tools/cacaosvc.exe
share/cacao_2/lib/tools/cacaosvc_ctrl.exe
share/cacao_2/lib/tools/launch.exe
share/cacao_2/lib/tools/sec_layout.exe
share/cacao_2/lib/tools/suexec.exe
share/cacao_2/lib/tools/cacaomsg.exe
share/cacao_2/lib/tools/ownFile.exe
share/cacao_2/lib/tools/scripts/CacaoAdm/Actions.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/Admin.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/CommandsCatalog.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/CommonVars.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/ContainerActions.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/Dependencies.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/Errno.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/FileHelper.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/globals.pl
share/cacao_2/lib/tools/scripts/CacaoAdm/Globals.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/InstanceActions.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/InstanceDefinitions.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/Instances.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/Keygen.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/LaunchStarter.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/Messages.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/OptionParser.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/ParamCatalog.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/ParamDescription.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/PlatformDependencies.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/PlatformFileHelper.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/PlatformGlobals.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/PlatformHelper.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/PlatformMessage.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/PlatformRelocation.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/PlatformStarter.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/Properties.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/Relocation.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/RuntimeHelper.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/UsageModule.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/Utils.pm
share/cacao_2/lib/tools/scripts/CacaoAdm/Helper.pm
share/cacao_2/lib/tools/template/modules/com.sun.cacao.command_stream_adaptor.xml
share/cacao_2/lib/tools/template/modules/com.sun.cacao.efd.xml
share/cacao_2/lib/tools/template/modules/com.sun.cacao.invoker.xml
share/cacao_2/lib/tools/template/modules/com.sun.cacao.logging_manager.xml
share/cacao_2/lib/tools/template/modules/com.sun.cacao.mib2simple.xml
share/cacao_2/lib/tools/template/modules/com.sun.cacao.rmi.xml
share/cacao_2/lib/tools/template/modules/com.sun.cacao.snmpv3_adaptor.xml
share/cacao_2/lib/tools/template/modules/com.sun.cacao.instrum.xml
share/cacao_2/lib/tools/template/modules/com.sun.cacao.webserver.2.1.xml
share/cacao_2/lib/tools/template/startup/cacao
share/cacao_2/lib/tools/scripts/cacaoadm.pl
share/cacao_2/ext/webserver/lib/cacao_webserver.jar
share/cacao_2/ext/webserver/lib/cacao_webserver_private.jar

Problem Description:

6576935 Cacao Windows (JES5 / DS 6.0), cacaoadm enable on Windows but cacao is not started after reboot
 
6629017 patch 126183-06 :after install&config, InstalledLocation value in com.sun.cacao.cmm.xml is incorrect
 
6633438 windows 2.1: cannot authenticate a user different from administrator for connecting to one instance
 
 
(from 126183-06)
 
6497068 Cacao configure fails in Windows installation in some locales (de, ...)
 
 
(from 126183-05)
 
6585045 [JESMF CONFORM] upport JESMF conformance (defect 6537698) into trunk
 
 
(from 126183-04)
 
6449916 cacao windows : suexec may prevent sub processes to inherit its handles
 
6458478 cacao windows : fails to delete an embedded instance : perl script error
 
6467798 cacao windows: spawning sub-processes can cause terminal window creation + loss of stdout/stderr
 
6468730 cacao windows: check on password file for proper windows security and for valid ACLs is not done
 
6470689 cacao windows: "Cacao launcher" should close its stdout/stderr handles
 
6471146 cacao windows : add-trusted-cert does not work on w2000/2003 in B7
 
6472345 cacao-rmi use of rmi registry is insecure for windows
 
6474052 cacao windows : add-trusted-cert, cannot specify a certificate pathname which contains space
 
6474071 cacao windows : create-keys fail if the output directory contains space
 
6474077 cacao windows : default path to locate jdmk is based on drive C, should be system drive
 
6474080 cacao windows : enable command fail if password file path contain space
 
6474098 cacao windows : when JDMK's not present  on the host, unnecessary error message is displayed
 
6474253 cacao windows : default jdmk install path used to resolve jdmk jars is wrong
 
6474572 cacao windows: suexec fails to authenticate if username is provided as domain\username
 
6476125 cacao windows JES : the configuration script does not update the JES registry key
 
6476160 cacao windows: cacao windows service display name format not adhering to arc case
 
6476176 cacao windows: prepare-uninstall is not deleting windows services for all instances
 
6476286 cacao windows : suexec does not transmit the process environement in case of user mode
 
6478172 cacao windows : container's subject created during start does not contain NT domain information
 
6478186 cacao windows : JNI code involve in UserPrincipal.getUid() is wrong :  NT domain is ignored
 
6480223 cacao windows: cacaoadm register-module corrupts core module xml files
 
6481616 cacao windows: "Cacao launcher" should close its stdin handle to daemonize
 
6483851 cacao windows : load of user name property is faulty : '\' is lost
 
6486644 cacao windows : JesMF instrumentation modules not configured
 
6488486 cacao windows : deploy cannot handle the relative path filename with space in the path
 
6490345 Windows: InvokeCommand lost first character of input buffer
 
6492344 jes5-b13: Not able to see common agent container for windows2003SE in MC.
 
6498998 need code refactoring on launch and suexec
 
6528331 Missing zone parameters in pkginfo of patchdefs
 
6542519 user name containing space are not well parse by the admin class
 
6548556 Cacao 2.1 windows upgrade patch doesn't update the configuration
 
6549535 cacao 2.1 windows upgrade patch readme and RN must be re-worked
 
6567461 Should display more message in case of error with the layout change for cohabitation of 1.1 with 2.2
 
6570247 container jni library send trace to the debug pipe

Revision History:

126183-05 126183-04 126183-06

Patch Installation Instructions:

-------------------------------- 
 
Please, refer to the special install instructions hereafter.

Special Install Instructions:

-----------------------------
 
The common agent container is usually installed on windows by JES5 installer.
Its default installation directory is then:
    <JavaES5InstallDir>\share\cacao_2
where <JavaES5InstallDir> is by default:
    <disk>:\Program Files\Sun\JavaES5
The configure.bat script for initial configuration is located right under the
installation directory. Default JES5 path:
    <JavaES5InstallDir>\share\cacao_2\configure.bat
The administrative command line cacaoadm is located under the bin sub-directory.
    <JavaES5InstallDir>\share\cacao_2\bin\cacaoadm.exe
 
After installation, refer to README.txt and RELEASE_NOTES.txt for further
instructions on configuration and specific information. These files are
located under the cacao_2 sub-directory of the installation directory.
 
Installation steps:
------------------
 
1. As JavaES 5 must have already been installed on your windows system,
   the common agent container version 2.0 or 2.1.x is probably already installed, 
   so that you must stop its daemon and unconfigure it by running the command:
        cacaoadm prepare-uninstall
   Open the Component Services console (Programs: Administrative Tools) and
   check that the Common Agent Container service has been removed.
 
2. Extract the zip file
        126183-07.zip
   under your windows system where JavaES 5 is already installed.
   It contains the 3 files:
        126183-07.exe
        README.126183-07
        Uninstall_126183-07.bat
 
3. Install the patch by running:
        126183-07.exe
   Note that patch 126910-02 is required.
   Note that you can list the installed JavaEs patches by running the command:
        <JavaES5InstallDir>\utils\patch\ListJavaESPatches
   Save Uninstall_126183-07.bat as this is the patch uninstaller.
 
4. Configure the common agent container by running the 2 commands:
        configure.bat
        cacaoadm rebuild-dependencies
   Note that the common agent container dependencies are java, jdmk and nss.
   The location of Java is automatically retrieved from the registry.
   The location of jdmk is set to a default installation value. To modify it,
   run the command:
        cacaoadm set-param jdmk-home=<path-to-jdmk-home>
   where <path-to-jdmk-home>\lib is the location of the jdmk libraries like
   jdmkrt.jar. In case of JavaES, <path-to-jdmk-home> is:
        <JavaES5InstallDir>\share
   The location of nss is not set. If the commandstream feature of the common
   agent container is needed, then nss is mandatory and the user must provide
   the paths to the nss tools and libraries by running:
        cacaoadm set-param nss-lib-home=<path-to-nss-lib-home>
        cacaoadm set-param nss-tools-home=<path-to-nss-tools-home>
   In case of JavaES, <path-to-nss-lib-home> is:
        <JavaES5InstallDir>\share\lib
   and <path-to-nss-tools-home> is:
        <JavaES5InstallDir>\share\bin
 
5. Verify the version. The command hereafter must display 2.1.3:
	cacaoadm -V
   Verify the configuration. The command hereafter must not display any error message:
	cacaoadm verify-configuration
   Restart the common agent container and check its status:
        cacaoadm start
	cacaoadm status
 
6. Configure the Common Agent Container service. 
   From the Component Services console, check that the Common Agent Container
   service has been added.
   Enable the automatic startup of the service by running the command:
        cacaoadm enable -f <password file>
   where <password file> contains the password of the user running the service.
   IMPORTANT STEP:
       Because of defect 6581430, you must enter again the password manually
       from the Component Services console: open the Properties window for the
       Common Agent Container service, go to the index "Log On", enter the
       password of the user running the service and push the Apply button.
       Note that you may have a message popping up: "The account <user name>
       has been granted the Log On As A Service right." if the user didn't
       already have this setting.
   IMPORTANT NOTICE:
       You must not start or stop the service from the console. By doing so,
       you may interfer with the cacaoadm start/stop command, putting the
       service into an unstable state. In such case, the system must be
       rebooted in order to restore the service into a stable state.
 
7. Restart the system and check that the service is running after reboot:
	cacaoadm status
 
 
Uninstallation steps:
--------------------
 
1. Stop and unconfigure the common agent container by running the command:
        cacaoadm prepare-uninstall
   Open the Component Services console (Programs: Administrative Tools) and
   check that the Common Agent Container service has been removed.
 
2. Make sure that
        <JavaES5InstallDir>\share\lib
        <JavaES5InstallDir>\share\bin
   are present in the System PATH environment variable.
   Then uninstall the patch by running the script:
        Uninstall_126183-07.bat
 
   The uninstall operation restores the version of the common agent container
   upon which the patch has been applied:
   - version 2.0 (from JavaES 5)
   - version 2.1.x (from JavaES 5 Update 1)
 
   In case of version 2.0, you need to configure it again by doing the
   installation steps 4 and 5 described above.
   Note that, because of defect:
        6516449 cacao 2.1 patch upgrade removal doesn't fully restore the 2.0
                configuration
   the command
       cacaoadm --version
   still shows the version 2.1, and the command
       cacaoadm list-modules
   still shows 2.1 modules. This doesn't prevent the common agent container
   from running as expected.
 
   In case of version 2.1.x, you need to uninstall also this version 2.1.x
   and go back to version 2.0 because of defect:
       6613431 backout common agent container windows 2.1.1 to 2.1.0 doesn't work

README -- Last modified date:  Monday, January 14, 2008

Login Required

Login Required