Thank you for using McAfee Agent software version 4.0. This document contains important information about this release. We strongly recommend that you read the entire document.
Patch Release: March 10, 2009
Patch Package: 4.0.0.1421
This release was developed for use with:
Make sure you have installed the correct version(s) before using this release.
This section specifies the system requirements for McAfee Agent 4.0.
This release does not support Windows 95, Windows 98, Windows Millennium Edition or Windows NT.
The McAfee Security single tray icon does not appear on 64-bit systems.
This document supplements the McAfee Agent 4.0
Readme
file in the release package, and details fixes included
in McAfee Agent 4.0 Patch releases.
This Patch contains a variety of improvements. McAfee has spent a significant amount of time finding, fixing, and testing the fixes in this release. Please review the Known and Resolved Issues lists for additional information on the individual issues.
Refer to online KnowledgeBase article KB60681 at http://knowledge.mcafee.com for the most current information regarding this release.Known issues in this release of the software are described below:
Issues that are resolved in this release are listed below.
Resolution: UNC repositories can now be defined with or without specifying a subdirectory.
Resolution: The UNC Repository Updater process now continues to run under the System user’s credentials when a UNC repository cannot be reached during the ping time sorting process.
Resolution: The UNC Repository Updater process now allows UNC replication using the logged-on user’s credentials.
Resolution: The product deployment process has been updated to consistently detect and deploy updated products.
Resolution: The UNC Repository Updater process now runs on 64-bit operating systems when defined to use download credentials.
Resolution: The repository download process has been updated to retry the entire update from the next repository when any products fail to download.
Resolution: An embedded credential installation package is now available through McAfee Tier III Support. For information on obtaining this package, see KB article KB59954.
Resolution: The HTTP connection process has been updated to avoid creating this error message incorrectly.
Resolution: The script engine has been updated to properly detect and report unregistered services as an error rather than exiting.
Resolution: The DAT update process has been updated to ensure that non-English versions apply incremental updates correctly.
Resolution: The update process has been updated to record this error message only when the file download process detects a corrupt file.
Resolution: The DAT update process now deletes the DAT package after a successful update.
Resolution: The McAfee Agent upgrade process has been updated so that if it detects that the currently installed version cannot be stopped, it quits and leaves the currently running version of the McAfee Agent operational.
Resolution: The error log file now “rolls over” in the same manner as the Agent_<system name> log file.
Resolution: The update process now runs as expected, independent of these Internet Explorer settings.
Issues from the Patch 1 release of the software that are resolved in this release are listed below.
Resolution: Update dialog boxes now appear in the language running on the system.
Resolution: Now when using the “/forceinstall” switch and changing the data (/datadir=<new folder>) folder, the upgrade process removes the old data folder and uses the new folder.
Resolution: Now the upgrade process creates the AgentEvents folder when it is missing.
Resolution: Managed product installation routines now execute only when necessary.
Resolution: Now the installation and data folders can contain non-English characters.
Resolution: The VirusScan update process now honors the “/quiet” switch.
Resolution: The upgrade process no longer requires the “My Favorites” and “Fonts” folders to be present.
Resolution: Now the ePolicy Orchestrator server connection information (server IP, name and port, and incoming agent wake-up port) is recorded. This allows Host Intrusion Prevention to create specific rules that allow communication to and from the ePolicy Orchestrator server, even in the absence of Host IPS policies.
Resolution: The name of the ePO server the system last communicated with now appears immediately after the last server communication.
Resolution: Managed products are now deployed only to their supported platforms.
Resolution: The Mirror task now copies the sitestat.xml file to the duplicated repository.
Resolution: The managed product update process now honors the user's selected reboot response.
Resolution: All dates are now recorded correctly in the Agent_<system name>.xml log file.
Resolution: The McAfee Agent now supports build-to-build VirusScan engine updates.
Resolution: Now the installation and upgrade processes allow the data folder to be located in the “Windows” or “WinNT” folders with the exception of the system32 folder. The installation and upgrade processes prohibit the data folder from including the system32 folder.
Resolution: The upgrade process now re-registers the ole32.dll file when it detects it is missing.
Resolution: The installation and upgrade processes now allow the installation and data folders to contain double-byte characters.
Resolution: The upgrade process now displays meaningful install and uninstall error messages on a Japanese language system.
Resolution: The McAfee Agent now removes the Temp files created during the execution of an “Agent Update Task”.
Resolution: The McAfee Agent now detects failed Policy Enforcements and retries the policy compilation until it completes successfully.
Resolution: The DAT update process now terminates properly when it detects an error in an FTP transaction.
Resolution: The MA 4.0 Patch 1 package has been updated allowing the “/forceinstall” switch to work as expected.
Issues previously resolved in the policy (Extension) pages are listed below.
Resolution: A checkbox has been added to “Agent Policy on Repository Page” that allows new repositories to be excluded by default. Now when a repository is added and the new checkbox is checked, the new repository is added to the disable list for each of the existing repositories.
Resolution: The policy page now loads in a much more reasonable amount of time.
This section provides instructions for installing and upgrading McAfee Agent 4.0 for use with ePolicy Orchestrator versions 3.6.x and 4.0.
This section provides instructions for installing McAfee Agent 4.0 for use with ePolicy Orchestrator version 3.6.x on each of the supported operating systems.
You must have administrator rights to perform this task.
This section provides instructions for installing McAfee Agent 4.0 for use with ePolicy Orchestrator 4.0 on Windows using two different methods.
You must have administrator rights on the Windows system to perform this task. The agent extension must be installed on the ePolicy Orchestrator server before the agent is installed on any clients.
The agent extension must be installed on the ePolicy Orchestrator server before the agent is installed on any clients.
You must have administrator rights to perform this task.
This section describes using selected command-line and MSI parameters to specify installation and upgrading preferences. Use the list of tasks as a menu from which to select those that suit your circumstances and preferences.
Use this command to install the agent, site list and keys in their default locations. This command is the equivalent of double-clicking the program file in the installation package.
framepkg.exe
Use this command to install the agent in a folder other than the default. The example shown here specifies a folder for the installation files (instdir) and a folder for the data files (datadir). These can be the same or different folders.
framepkg.exe /install=agent /instdir=<target folder name> /datadir=<target folder name>
Use this command for installation and upgrade to include policies selected by the administrator rather than the default policies.
framepkg.exe /install=agent /agentpolicy=<full path of user-defined server.xml file>
The following steps illustrate how to create a server.xml file:
Use this command to install the agent in its default location and specify a log file other than the default log file as the record of the agent’s activities.
framepkg.exe /install=agent /logdir=<target folder name>
Use this command to install the agent and specify a site list file and security keys (srpubkey.bin and reqseckey.bin) other than the defaults. This command is useful when upgrading an agent using FramePkg_upd.exe. It specifies the server with which the agent communicates, irrespective of the site information embedded in the original installation package.
framepkg.exe /install=agent /siteinfo=<full path of sitelist.xml>
The security keys must be located in the same folder as the site list. Use ePolicy Orchestrator to export the files:
Use this command to delete the currently installed agent and force install a different agent only when:
framepkg.exe /install=agent /forceinstall
Use this command to allow all users access to agent files and registry, regardless of their user privileges.
framepkg.exe /install=agent /defaultpermissions
Use this command to install the agent without displaying information dialog boxes on the client.
framepkg.exe /install=agent /s or framepkg.exe /install=agent /silent
Use this command to install the agent and specify a language other than the target computer’s native language.
framepkg.exe /install=agent /uselanguage=<language code>
Language codes are:
|
Use either of these commands to upgrade the agent to a new version.
framepkg_upd.exe or framepkg.exe /upgrade
Using these commands is the equivalent of double-clicking FramePkg_upd.exe in the installation package.
If the sitelist.xml file is from ePolicy Orchestrator 4.0.0 or later, the security keys must be located in the same folder as the site list.
frminst.exe /install=agent /siteinfo=<full path of target server’s sitelist.xml file>
frminst.exe /remove=agent
The security keys must be located in the same folder as the site list.
frminst.exe /siteinfo=<full path of target server’s sitelist.xml file>
Laptop users of Windows can configure proxy settings for downloading McAfee VirusScan Enterprise updates while in the field. This requires making changes in the ePolicy Orchestrator console and in the VirusScan console. The ePolicy Orchestrator changes must be completed before making the VirusScan changes.
This product includes or may include:
Software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/). | Cryptographic software written by Eric A. Young and software written by Tim J. Hudson | Some software programs that are licensed (or sublicensed) to the user under the GNU General Public License (GPL) or other similar Free Software licenses which, among other rights, permit the user to copy, modify and redistribute certain programs, or portions thereof, and have access to the source code. The GPL requires that for any software covered under the GPL, which is distributed to someone in an executable binary format, that the source code also be made available to those users. For any such software covered under the GPL, the source code is made available on this CD. If any Free Software licenses require that McAfee provide rights to use, copy or modify a software program that are broader than the rights granted in this agreement, then such rights shall take precedence over the rights and restrictions herein. * Software originally written by Henry Spencer, Copyright 1992, 1993, 1994, 1997 Henry Spencer. | Software originally written by Robert Nordier, Copyright © 1996-7 Robert Nordier. | Software written by Douglas W. Sauder. | Software developed by the Apache Software Foundation (http://www.apache.org/). A copy of the license agreement for this software can be found at www.apache.org/licenses/LICENSE-2.0.txt. | International Components for Unicode (“ICU”) Copyright © 1995-2002 International Business Machines Corporation and others. | Software developed by CrystalClear Software, Inc., Copyright © 2000 CrystalClear Software, Inc. | FEAD® Optimizer® technology, Copyright Netopsystems AG, Berlin, Germany. | Outside In® Viewer Technology © 1992-2001 Stellent Chicago, Inc. and/or Outside In® HTML Export, © 2001 Stellent Chicago, Inc. | Software copyrighted by Thai Open Source Software Center Ltd. and Clark Cooper, © 1998, 1999, 2000. | Software copyrighted by Expat maintainers. | Software copyrighted by The Regents of the University of California, © 1996, 1989, 1998-2000. | Software copyrighted by Gunnar Ritter. | Software copyrighted by Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A., © 2003. | Software copyrighted by Gisle Aas. © 1995-2003. | Software copyrighted by Michael A. Chase, © 1999-2000. * Software copyrighted by Neil Winton, © 1995-1996. | Software copyrighted by RSA Data Security, Inc., © 1990-1992. | Software copyrighted by Sean M. Burke, © 1999, 2000. | Software copyrighted by Martijn Koster, © 1995. | Software copyrighted by Brad Appleton, © 1996-1999. | Software copyrighted by Michael G. Schwern, © 2001. | Software copyrighted by Graham Barr, © 1998. | Software copyrighted by Larry Wall and Clark Cooper, © 1998-2000. | Software copyrighted by Frodo Looijaard, © 1997. | Software copyrighted by the Python Software Foundation, Copyright © 2001, 2002, 2003. A copy of the license agreement for this software can be found at www.python.org. | Software copyrighted by Beman Dawes, © 1994-1999, 2002. | Software written by Andrew Lumsdaine, Lie-Quan Lee, Jeremy G. Siek © 1997-2000 University of Notre Dame. | Software copyrighted by Simone Bordet & Marco Cravero, © 2002. | Software copyrighted by Stephen Purcell, © 2001. | Software developed by the Indiana University Extreme! Lab (http://www.extreme.indiana.edu/). | Software copyrighted by International Business Machines Corporation and others, © 1995-2003. | Software developed by the University of California, Berkeley and its contributors. | Software developed by Ralf S. Engelschall <rse@engelschall.com> for use in the mod_ssl project (http:// www.modssl.org/). | Software copyrighted by Kevlin Henney, © 2000-2002. | Software copyrighted by Peter Dimov and Multi Media Ltd. © 2001, 2002. | Software copyrighted by David Abrahams, © 2001, 2002. See http://www.boost.org/libs/bind/bind.html for documentation. | Software copyrighted by Steve Cleary, Beman Dawes, Howard Hinnant & John Maddock, © 2000. | Software copyrighted by Boost.org, © 1999-2002. | Software copyrighted by Nicolai M. Josuttis, ©1999. | Software copyrighted by Jeremy Siek, © 1999-2001. | Software copyrighted by Daryle Walker, © 2001. | Software copyrighted by Chuck Allison and Jeremy Siek, © 2001, 2002. | Software copyrighted by Samuel Krempp, © 2001. See http://www.boost.org for updates, documentation, and revision history. | Software copyrighted by Doug Gregor (gregod@cs.rpi.edu), © 2001, 2002. | Software copyrighted by Cadenza New Zealand Ltd., © 2000. | Software copyrighted by Jens Maurer, © 2000, 2001. | Software copyrighted by Jaakko Järvi (jaakko.jarvi@cs.utu.fi), © 1999, 2000. | Software copyrighted by Ronald Garcia, © 2002. | Software copyrighted by David Abrahams, Jeremy Siek, and Daryle Walker, © 1999-2001. | Software copyrighted by Stephen Cleary (shammah@voyager.net), © 2000. | Software copyrighted by Housemarque Oy <http://www.housemarque.com>, © 2001. | Software copyrighted by Paul Moore, © 1999. | Software copyrighted by Dr. John Maddock, © 1998-2002. | Software copyrighted by Greg Colvin and Beman Dawes, © 1998, 1999. | Software copyrighted by Peter Dimov, © 2001, 2002. | Software copyrighted by Jeremy Siek and John R. Bandela, © 2001. | Software copyrighted by Joerg Walter and Mathias Koch, © 2000-2002. | Software copyrighted by Carnegie Mellon University © 1989, 1991, 1992. | Software copyrighted by Cambridge Broadband Ltd., © 2001-2003. | Software copyrighted by Sparta, Inc., © 2003-2004. | Software copyrighted by Cisco, Inc and Information Network Center of Beijing University of Posts and Telecommunications, © 2004. | Software copyrighted by Simon Josefsson, © 2003. | Software copyrighted by Thomas Jacob, © 2003-2004. | Software copyrighted by Advanced Software Engineering Limited, © 2004. | Software copyrighted by Todd C. Miller, © 1998. | Software copyrighted by The Regents of the University of California, © 1990, 1993, with code derived from software contributed to Berkeley by Chris Torek.
COPYRIGHT
Copyright © 2009 McAfee, Inc. All Rights Reserved.
No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language in any form or by any means without the written permission of McAfee, Inc., or its suppliers or affiliate companies.
TRADEMARK ATTRIBUTIONS
AVERT, EPO, EPOLICY ORCHESTRATOR, FOUNDSTONE, GROUPSHIELD, INTRUSHIELD, LINUXSHIELD, MAX (MCAFEE SECURITYALLIANCE EXCHANGE), MCAFEE, NETSHIELD, PORTALSHIELD, PREVENTSYS, SECURITYALLIANCE, SITEADVISOR, TOTAL PROTECTION, VIRUSSCAN, WEBSHIELD are registered trademarks or trademarks of McAfee, Inc. and/or its affiliates in the US and/or other countries. McAfee Red in connection with security is distinctive of McAfee brand products. All other registered and unregistered trademarks herein are the sole property of their respective owners.
LICENSE INFORMATION
License Agreement
NOTICE TO ALL USERS: CAREFULLY READ THE APPROPRIATE LEGAL AGREEMENT CORRESPONDING TO THE LICENSE YOU PURCHASED, WHICH SETS FORTH THE GENERAL TERMS AND CONDITIONS FOR THE USE OF THE LICENSED SOFTWARE. IF YOU DO NOT KNOW WHICH TYPE OF LICENSE YOU HAVE ACQUIRED, PLEASE CONSULT THE SALES AND OTHER RELATED LICENSE GRANT OR PURCHASE ORDER DOCUMENTS THAT ACCOMPANY YOUR SOFTWARE PACKAGING OR THAT YOU HAVE RECEIVED SEPARATELY AS PART OF THE PURCHASE (AS A BOOKLET, A FILE ON THE PRODUCT CD, OR A FILE AVAILABLE ON THE WEB-SITE FROM WHICH YOU DOWNLOADED THE SOFTWARE PACKAGE). IF YOU DO NOT AGREE TO ALL OF THE TERMS SET FORTH IN THE AGREEMENT, DO NOT INSTALL THE SOFTWARE. IF APPLICABLE, YOU MAY RETURN THE PRODUCT TO MCAFEE OR THE PLACE OF PURCHASE FOR A FULL REFUND.