PIM Resource Parameters Description
Resource Parameters Description
The CPU-related resource management is based on the following parameters:
Parameter
Description
cpuunits
This is a positive integer number that determines the minimal guaranteed share of the CPU time your Container will receive.
cpulimit
This is a positive number indicating the CPU time in percent the corresponding Container is not allowed to exceed.
Linux burst_cpulimit
The CPU power limit, in percent, the Container cannot exceed. The limitations set in this parameter are applied to the Container when it exceeds the limit specified in the burst_cpu_avg_usage parameter.
Linux burst_cpu_avg_usage
The CPU usage limit, in percent, set for the Container. This limit is calculated as the ratio of the current Container CPU usage to the CPU limit (i.e to the value of the CPULIMIT parameter) set for the Container. If the limit is not specified, the full CPU power of the Hardware Node is considered as the CPU limit. Upon exceeding the burst_cpu_avg_usage limit, the burst_cpulimit limit is applied to the Container.
Windows cpuguarantee
This is a positive integer number indicating the CPU time, in percent, the corresponding Container is guaranteed to receive. If both the cpuguarantee and cpuunits parameters are set, the cpuguarantee parameter is first taken into account when distributing processor(s) time among the Containers existing on the Node; the remaining CPU time, if any, is given to the Containers in accordance with the value of the cpuunits parameter.
cpus
The number of CPUs set to handle all the processes inside the given Container. By default, any Container is allowed to consume the CPU time of all processors on the Node.
The disk-related resource management is based on the following parameters:
Parameter
Description
diskspace
Total size of disk space consumed by the Container.
Linux When the space used by the Container hits the soft limit, the Container can allocate additional disk space up to the hard limit during the grace period indicated by the quotatime parameter value.
Linux diskinodes
Total number of disk inodes (files, directories, and symbolic links) allocated by the Container. When the number of inodes used by the Container hits the soft limit, the Container can create additional inodes up to the hard limit during the grace period indicated by the quotatime parameter value.
Linux quotaugidlimit
Number of user/group IDs allowed for the Container internal disk quota. If set to 0, UID/GID quota will not be enabled.
Linux quotatime
The grace period for the disk quota overusage defined in seconds. The Container is allowed to temporarily exceed its quota soft limits for no more than the QUOTATIME period.
Linux ioprio
The Container priority for disk I/O operations. The allowed range of values is 0-7. The greater the priority, the more time the Container has for writing to and reading from the disk. The default Container priority is 4.
The memory-related resource management parameters are divided into 4 groups: memory parameters, primary system parameters, secondary system parameters, and auxiliary system parameters.
Windows Windows-based Containers use only the primary system parameters.
Linux For Linux-based Containers, this screen displays the memory-based, or the system-based, or both memory- and system-based Container resources data, depending on your settings:
* If the memory management mode is enabled for the Container, it can be allocated memory in much the same way as a certain amount of physical memory is installed on a physical computer. This is the recommended mode for managing Containers for most administrators.
* If the system management mode is enabled, the Container’s performance depends on the values of quite a number of fine-grained parameters. The primary parameters are the starting point for defining the relative power of a Container. The secondary parameters are dependent on the primary ones and are calculated from them according to a set of constraints. The auxiliary parameters help improve fault isolation among applications in a Container and the way applications handle errors and consume resources.
* If both resource management modes are used, the more restrictive value is taken into account each time the system makes the decision whether to allocate this or that resource to the Container.
Linux Memory parameters
Parameter
Description
slmmemorylimit
An approximation of the size of the physical memory allocated to the Container. In other words, the Container performance is similar to the performance of a physical computer with as much physical memory installed as is indicated in this parameter.
Primary system parameters
Parameter
Description
numproc
The maximal number of processes the Container may create.
Windows numsessions
The number of simultaneous terminal sessions that can be opened to the Container.
Windows vprvmem
The size of private (or potentially private) memory allocated by the Container. The memory that is always shared among different applications is not included in this resource parameter.
Linux numtcpsock
The number of TCP sockets (PF_INET family, SOCK_STREAM type). This parameter limits the number of TCP connections and, thus, the number of clients the server application can handle in parallel.
Linux numothersock
The number of sockets other than TCP ones. Local (UNIX-domain) sockets are used for communications inside the system. UDP sockets are used, for example, for Domain Name Service (DNS) queries. UDP and other sockets may also be used in some very specialized applications (SNMP agents and others).
Linux vmguarpages
The memory allocation guarantee, in pages. Container applications are guaranteed to be able to allocate additional memory so long as the amount of memory accounted as privvmpages (see the auxiliary parameters) does not exceed the configured barrier of the vmguarpages parameter. Above the barrier, additional memory allocation is not guaranteed and may fail in case of overall memory shortage.
Linux avnumproc
The average number of processes and threads.
Linux Secondary system parameters
Parameter
Description
kmemsize
The size of unswappable kernel memory allocated for the internal kernel structures for the processes of a particular Container.
Note: For the Virtuozzo Containers 64-bit version for IA-64 processors, it takes 4 (four) times more the size of the kernel memory than that for the Virtuozzo Containers 32-bit version to handle one and the same process.
tcpsndbuf
The total size of send buffers for TCP sockets, i.e. the amount of kernel memory allocated for the data sent from an application to a TCP socket, but not acknowledged by the remote side yet.
tcprcvbuf
The total size of receive buffers for TCP sockets, i.e. the amount of kernel memory allocated for the data received from the remote side, but not read by the local application yet.
othersockbuf
The total size of UNIX-domain socket buffers, UDP, and other datagram protocol send buffers.
dgramrcvbuf
The total size of receive buffers of UDP and other datagram protocols.
oomguarpages
The out-of-memory guarantee, in pages. Any Container process will not be killed even in case of heavy memory shortage if the current memory consumption (including both physical memory and swap) does not reach the oomguarpages barrier.
privvmpages
The size of private (or potentially private) memory allocated by an application. The memory that is always shared among different applications is not included in this resource parameter.
Linux Auxiliary system parameters
Parameter
Description
lockedpages
The memory not allowed to be swapped out (locked with the mlock() system call), in pages.
shmpages
The total size of shared memory (including IPC, shared anonymous mappings and tmpfs objects) allocated by the processes of a particular Container, in pages.
numfile
The number of files opened by all Container processes.
numflock
The number of file locks created by all Container processes.
numpty
The number of pseudo-terminals, such as an ssh session, screen or xterm applications, etc.
numsiginfo
The number of siginfo structures (essentially, this parameter limits the size of the signal delivery queue).
dcachesize
The total size of dentry and inode structures locked in the memory.
numiptent
The number of IP packet filtering entries.
Source : PIM DOCS
