IBM 6.1.X manual BS P HE R E P O R T AL V 6 T U N I N G G U I D E

Page 64

admit-thresholdproperties do not apply to all cache implementations. In general, only caches that are not shared will use these properties. There are other properties that should not be modified unless specifically instructed to do so by IBM WebSphere Portal support.

enabled: The enabled property determines whether a cache is used or not. If a cache is not enabled, the property has a value of false, then no values are held by the cache and every cache lookup will return a null value. This property should only be modified for testing purposes, never in a production environment. The supported values are true and false and the global default value is true.

lifetime: The lifetime property determines the number of seconds an entry will exist in a cache. A cache no longer returns an entry once the entry has existed longer than the lifetime property. Cache entries can also be invalidated prior to reaching their lifetime due to explicit invalidation of the entry or Least Recently Used (LRU) eviction from the cache.

A value of -1indicates an infinite lifetime. This value should be used with caution since cache entries will only be invalidated programmatically. Infinite lifetimes are particularly discouraged with access control caches because:

￿In a cluster there can be rare occurrences when not all cache invalidation messages are processed on every node due to race conditions in the application server’s dynacache code. While the probability of this occurring is low, it can not be completely avoided with the current code base. Finite lifetimes allow these entries to be invalidated.

￿Finite lifetimes allow modifications made to roles, which have been externalized to an External Security Manager, to be reflected in role caches.

If updates to production environments are restricted to a well-defined staging process using XML Access, it is usually safe to use infinite lifetimes.

size: The maximum number of entries in a cache is limited by the size property. If this size limit is reached, entries are removed from the cache by an algorithm which usually includes 1) remove invalidated entries and entries which have exceeded their lifetime and 2) apply a LRU algorithm to the valid entries.

Any positive integer is allowed. Cache sizes have a direct impact on the memory requirements of your portal, specifically the demands on the Java heap. You should monitor and record the Java heap metrics and any performance impact when modifying the size of a cache.

shared: Cluster-aware caches are shared across the nodes of a cluster. These caches propagate invalidations of cache entries by using the WebSphere Application Server DistributedMap interface.

5 9

W E BS P HE R E P O R T AL V 6 . 1 T U N I N G G U I D E

Image 64
Contents IBM WebSphere Portal IBM WebSphere Portal software family Your world. Your wayContents Web Server Tuning Portlet Caching General Information Figures About this Document Performance Tuning Overview Environment Considerations Base Portal Tuning Application Server Tuning How to get to Admin ConsoleParameter Linux Solaris Windows2003 Initial 1792 2048POWER5 New Area Size Xmn320m Xmn256m Xmn768m Xmn1024m Parameter Value Additional InformationSession Minutes TimeoutWeb Container Thread pool Size Name Value PropagationHow to Set Context Pool Setting Default ValueWebSphere Portal Services Default Value Definition UsedG I S T R Y S E R V I C E Default Value Value Used Cache NameDatabase Tuning Database Database name Datasource name2 O N a I X S E T U P Db2 reorgchk update statistics on table all Db2 reorgchk current statistics on table all reorgchk.txt A C L E D a T a B a S E S E R V E R T U N I N G AIXTHREADSCOPE=S Parameter ValueExecute Directory Server Tuning Db2 update db config for idsldap using dbheapWeb Server Tuning Linux Windows Additional InformationMinSpareThreads MaxSpareThreads Operating System Tuning N U T W O R K T U N I N G How-to-Setndd -set /dev/tcpPARAMETER Value L a R I S C O N T a I N E R Required Fixes MaxthreadtasksWEB 2.0 Theme Tuning Navigator Service PropertiesParameter Setting Used JVM Initial and Maximum Heap SizeParameter Setting Used Additional Information Caching Proxy TuningInternet Explorer Support of Vary Header # uncommented these to enable statics to be cached # set cache-control public for various static contentPortlet Caching ExpiresActive OnDB2 Database Tuning Many Pages TuningRelease DB Parameter Cache Manager Service WEB Content Management Tuning WebSphere Portal Service Properties Cache NameWCM Object Cache WCM Configuration Service JCR Text SearchDB2 Tuning Authoring Environment DB2 BP4 Composite Applications Tuning Cache Manager Service PropertiesComposite Applications Best Practices BS P HE R E P O R T AL V 6 T U N I N G G U I D E Cluster Tuning Value trueHow-To Set ThreadLimit ServerLimit Session Persistence To Database Tuning Parameter Setting Additional DetailsVertical Cluster Tuning IBM Tivoli Directory Server Tuning Other Performance Tuning Options Improving Portal Startup PerformanceManaging the Retrieval of User Attributes BS P HE R E P O R T AL V 6 T U N I N G G U I D E Use of Dynamic Content Features Real-World Network Considerations BrowserMatch Mozilla/4 gzip-only-text/html Websphere Portal Caches General InformationBS P HE R E P O R T AL V 6 T U N I N G G U I D E BS P HE R E P O R T AL V 6 T U N I N G G U I D E Cache Usage Patterns Pattern invalidation checkingCache Instances Portal Access Control Cache Hierarchy Com.ibm.wps.ac.PermissionCollectionCacheCom.ibm.wps.ac.AccessControlUserContextCache Com.ibm.wps.ac.ProtectedResourceCacheCom.ibm.wps.ac.OwnedResourcesCache Com.ibm.wps.ac.RolesCacheCom.ibm.wps.ac.ExternalOIDCache Com.ibm.wps.ac.ApplicationRoleOIDCache Com.ibm.wps.ac.ChildResourcesCacheCom.ibm.wps.ac.ApplicationRoleDescriptorCache Com.ibm.wps.ac.ApplicationRolesForPrincipalCache Com.ibm.wps.ac.ContainedRolesCacheCom.ibm.wps.ac.ApplicationRoleChildrenCache Com.ibm.wps.puma.DNOIDCache / com.ibm.wps.puma.OIDDNCacheCom.ibm.wps.datastore.PortalIdCache.explicitLpidPerVP Com.ibm.wps.datastore.PortalIdCache.vpPerLpid.cacheCom.ibm.wps.datastore.pageinstance.OIDCache Com.ibm.wps.datastore.pageinstance.DerivationCache Com.ibm.wps.datastore.pageinstance.DynamicNodeCacheCom.ibm.wps.model.content.impl.ResourceCache Com.ibm.wps.model.factory.SimpleCacheKeyCom.ibm.wsp.mode.content.impl.TopologyCache Com.ibm.wps.model.factory.ContentModelCache.liveCom.ibm.wps.model.factory.ContentModelCache.isolated Com.ibm.wps.model.factory.URLMappingCache.liveCom.ibm.wps.model.content.impl.DynamicLoadCache Com.ibm.wps.model.factory.URLMappingCache.isolatedCom.ibm.wps.model.factory.MultiModelCache.live Com.ibm.wps.model.factory.MultiModelCache.isolatedCom.ibm.wps.services.vpmapping.VirtualPortalIDToRealmCache Com.ibm.wps.model.impl.RuntimeClientMap.userAgent2clientWps.mappingurl.ContextsCache Wps.mappingurl.LookupCacheCom.ibm.wps.services.vpmapping.URLToVirtualPortalIDCache Com.ibm.wps.services.vpmapping.VirtualPortalIDToURLCacheWsrp.cache.portletdescription Wsrp.cache.servicedescription Wsrp.cache.portlet.instanceWsrp.cache.producer.user Wsrp.cache.portlet.windowWsrp.producer.portletpool.pops Wsrp.producer.portletpool.ccpsProcessintegration.PendingTasksCache Wp.te.transformationAssociationCacheCom.ibm.wps.policy.services.PolicyCacheManager Com.ibm.wps.policy.services.UserPolicyNodeCacheManagerCom.lotus.cs.services.UserEnvironment Com.lotus.cs.services.directory.wmm.WMMDirectoryServiceCom.lotus.cs.services.domino.DominoService Com.ibm.wps.pe.portletentity Wp.xml.configitemsPortletMenuCache RegistryService Com.ibm.workplace.searchmenu.helper.SearchMenuCacheHelperExample Scenarios BS P HE R E P O R T AL V 6 T U N I N G G U I D E R T a L S W I T H L O N G S E S S I O N T I M E O U T S BS P HE R E P O R T AL V 6 T U N I N G G U I D E WEB Content Management Caches Services/cache/iwk/strategy WCM Item cachingServices/cache/iwk/objectsummary WCM Summary WCM Cache InstancesServices/cache/iwk/processing Advanced and Resour ces Services/cache/iwk/moduleServices/cache/iwk/session Session Services/cache/iwk/menu Menu Services/cache/iwk/nav NavigatorServices/cache/iwk/abspath Absolute path Services/cache/iwk/missed Missed ItemsServices/cache/iwk/draftSummary Draft Summary Services/cache/iwk/libparent Library ParentUser cache Appendix A. References Mark Alkins, Manager Lee Backstrom, Document CoordinatorBS P HE R E P O R T AL V 6 T U N I N G G U I D E