node13.html | searchcode

/web/pages/nfs-ganesha-adminguide/node13.html

https://bitbucket.org/toponado/nfs-proxy
HTML | 266 lines | 227 code | 30 blank | 9 comment | 0 complexity | f6e55e099ae357a5183f6128e7a03f91 MD5 | raw file

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">

<!--Converted with LaTeX2HTML 2002-2-1 (1.71)
original version by:  Nikos Drakos, CBLU, University of Leeds
* revised and updated by:  Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>The 'CacheInode_Client' block</TITLE>
<META NAME="description" CONTENT="The 'CacheInode_Client' block">
<META NAME="keywords" CONTENT="nfs-ganesha-adminguide">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">

<META NAME="Generator" CONTENT="LaTeX2HTML v2002-2-1">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">

<LINK REL="STYLESHEET" HREF="index.php?page=nfs-ganesha-adminguide/nfs-ganesha-adminguide.css">

<LINK REL="next" HREF="index.php?page=nfs-ganesha-adminguide/node14">
<LINK REL="previous" HREF="index.php?page=nfs-ganesha-adminguide/node12">
<LINK REL="up" HREF="index.php?page=nfs-ganesha-adminguide/node4">
<LINK REL="next" HREF="index.php?page=nfs-ganesha-adminguide/node14">
</HEAD>

<BODY >
<!--Navigation Panel-->
<A NAME="tex2html254"
  HREF="index.php?page=nfs-ganesha-adminguide/node14">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
 SRC="../../images/next.png"></A> 
<A NAME="tex2html250"
  HREF="index.php?page=nfs-ganesha-adminguide/node4">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
 SRC="../../images/up.png"></A> 
<A NAME="tex2html244"
  HREF="index.php?page=nfs-ganesha-adminguide/node12">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
 SRC="../../images/prev.png"></A> 
<A NAME="tex2html252"
  HREF="index.php?page=nfs-ganesha-adminguide/node1">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents"
 SRC="../../images/contents.png"></A>  
<BR>
<B> Next:</B> <A NAME="tex2html255"
  HREF="index.php?page=nfs-ganesha-adminguide/node14">The 'CacheInode_GC_Policy' block</A>
<B> Up:</B> <A NAME="tex2html251"
  HREF="index.php?page=nfs-ganesha-adminguide/node4">What to put in</A>
<B> Previous:</B> <A NAME="tex2html245"
  HREF="index.php?page=nfs-ganesha-adminguide/node12">The 'CacheInode_Hash' block</A>
 &nbsp; <B>  <A NAME="tex2html253"
  HREF="index.php?page=nfs-ganesha-adminguide/node1">Contents</A></B> 
<BR>
<BR>
<!--End of Navigation Panel-->

<H2><A NAME="SECTION00229000000000000000">
The 'CacheInode_Client' block</A>
</H2>

<P>
This block defines the behavior of the metadata cache.
	It consists of the following key/value peers:

<P>

<UL>
<LI>LogFile:
		The file where the metadata cache events are logged.

<P>
</LI>
<LI>DebugLevel:
		The verbosity level for the metadata cache log.
		The values can be:
        
<UL>
<LI>NIV_NULL (no logging)
</LI>
<LI>NIV_MAJ  (log only major events)
</LI>
<LI>NIV_CRIT (log only erroneous events)
</LI>
<LI>NIV_EVENT (log only important events)
</LI>
<LI>NIV_DEBUG (log all events)
</LI>
<LI>NIV_FULL_DEBUG (log all internal processing)
        
</LI>
</UL>

<P>
</LI>
<LI>LRU_Nb_Call_Gc_invalid:
		Each worker maintains a LRU list of the last entries it handled.
		When a worker handles an entry, it sets it invalid in other
		threads' LRU's, in order to make them garbaging it.
		This parameter so defines the periodicity for garbaging invalid
		entries in this list. Thus, a worker will garbage its own list
		after processing this amount of NFS requests.

<P>
</LI>
<LI>LRU_Prealloc_PoolSize:
		This parameter sets the number of LRU entries that
		are preallocated for each worker thread.
		Given that the total amount of theses entries equals
		the number of cache entries + a certain working set
		(number of working threads * LRU_Nb_Call_Gc_invalid),
		this parameter must be close to the forecasted number
		of metadata entries divided by the number of worker threads,
		+ the value of LRU_Nb_Call_Gc_invalid.

<P>
</LI>
<LI>Entry_Prealloc_PoolSize:
		This parameter is the number of preallocated cache entries
		for each worker thread. It must be close to the forecasted number
		of metadata entries divided by the number of worker threads. 

<P>
</LI>
<LI>DirData_Prealloc_PoolSize:
		This parameter is the number of preallocated directory cache entries
		for each worker thread. It must be close to the number of directories
		in the exported filesystem divided by the number of worker threads.

<P>
</LI>
<LI>ParentData_Prealloc_PoolSize:
		This parameter is the number (for each thread) of preallocated
		entries' references to their parents (for example, a hard linked
		object can have several parents).
<BR>
It must be close to the forecasted number of metadata entries
		divided by the number of worker threads, except if the filesystem
		contains a huge amount of hard links (you should then multiply
		this value by the average number of hard links on each object).

<P>
</LI>
<LI>State_v4_Prealloc_PoolSize:
                This parameter is the number (for each thread) of preallocated
                state to be used by each worker for NFSv4 State management.
<BR>
It is used only if NFSv4 is used.

<P>
</LI>
<LI>Attr_Expiration_Time:
		The expiration delay (in seconds) for cached attributes.
		A value of "0" disables attributes cache expiration.

<P>
</LI>
<LI>Symlink_Expiration_Time:
		The expiration delay (in seconds) for symbolic link content.
		A value of "0" disables symlink cache expiration.

<P>
</LI>
<LI>Directory_Expiration_Time:
		The expiration delay (in seconds) for directory content.
		A value of "0" disables directory cache expiration.

<P>
</LI>
<LI>Use_Getattr_Directory_Invalidation:  
		This boolean indicates if a cached directory content is invalidated
		when its mtime has changed on the underlying filesystem.
		Setting this parameter to TRUE will result in an extra "getattr" operation
		on the filesystem for each NFS "readdir" call, so it could strongly impact
		the readdir performances.
<BR>
However, it must be set if your filesystem tree is continuously modified
		by an external actor (another NFS server, ...)
		and if you need a good re-synchronisation of GANESHA's NFS server cache.

<P>
</LI>
<LI>Use_Test_Access:
		If set to TRUE (strongly recommended), NFS "access" calls will be
		performed according to the cached attributes (mode, group, owner,...).
<BR>
Else, each NFS "access" operation will result in an "access" call
		to the underlying filesystem.

<P>
</LI>
<LI>Use_OpenClose_cache:
		If this boolean is set to TRUE, files will not be opened and closed
		at each read/write NFS call: GANESHA will cache a certain amount of
		opened file descriptors for better I/O performances (recommended).

<P>
</LI>
<LI>Max_Fd:
		When datacaching is disabled and 'Use_OpenClose_cache' is enabled,
		this parameter indicates the maximum number of files that can be kept
		openned for each thread.
<BR>
NB: when datacaching is enabled, use the FileContent_Client::Max_fd parameter instead

<P>
</LI>
<LI>OpenFile_Retention:
		When datacaching is disabled and 'Use_OpenClose_cache' is enabled,
		this parameter indicates the minimum time (in seconds) a file must
		be kept opened.
<BR>
If the 'max_fd' limit is reached and all files have been opened
		more recently than the 'OpenFile_Retention' time, no more file descriptors
		are cached until the previous ones are older than this value.

<P>
</LI>
<LI>Async_Op_Prealloc_Poolsize (write back cache only):
                The number of structure representing an asynchronous operation
                to be preallocated.

<P>
</LI>
<LI>Nb_Synclet (write back cache only):
                The number of synclet to be started.

<P>
</LI>
</UL>

<P>
<HR>
<!--Navigation Panel-->
<A NAME="tex2html254"
  HREF="index.php?page=nfs-ganesha-adminguide/node14">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
 SRC="../../images/next.png"></A> 
<A NAME="tex2html250"
  HREF="index.php?page=nfs-ganesha-adminguide/node4">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
 SRC="../../images/up.png"></A> 
<A NAME="tex2html244"
  HREF="index.php?page=nfs-ganesha-adminguide/node12">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
 SRC="../../images/prev.png"></A> 
<A NAME="tex2html252"
  HREF="index.php?page=nfs-ganesha-adminguide/node1">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents"
 SRC="../../images/contents.png"></A>  
<BR>
<B> Next:</B> <A NAME="tex2html255"
  HREF="index.php?page=nfs-ganesha-adminguide/node14">The 'CacheInode_GC_Policy' block</A>
<B> Up:</B> <A NAME="tex2html251"
  HREF="index.php?page=nfs-ganesha-adminguide/node4">What to put in</A>
<B> Previous:</B> <A NAME="tex2html245"
  HREF="index.php?page=nfs-ganesha-adminguide/node12">The 'CacheInode_Hash' block</A>
 &nbsp; <B>  <A NAME="tex2html253"
  HREF="index.php?page=nfs-ganesha-adminguide/node1">Contents</A></B> 
<!--End of Navigation Panel-->
<ADDRESS>
root
2008-08-01
</ADDRESS>
</BODY>
</HTML>