vyos/vyos-documentation
1
0
Fork 0
mirror of https://github.com/vyos/vyos-documentation.git synced 2025-10-26 08:41:46 +01:00
Code Issues Packages Projects Releases Wiki Activity

Added vyos on vmware page and rudimentary structure. (#118)

Browse Source 
* feature: adding notes for running on vmware around contending memory and memory management in low memory situations
This commit is contained in:
SquirePug 2019-09-25 12:08:43 +10:00 committed by Daniil Baturin
parent 8ead816551
commit b6ffe89000
2 changed files with 33 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
docs/appendix/vyos-on-vmware.rst Normal file
View File

@ -0,0 +1,32 @@
.. _vyosonvmware:
Running on VMWare ESXi
######################
ESXi 5.5 or later
*****************
.ova files are available for supporting users, and a VyOS can also be stood up using a generic Linux instance, and attaching the bootable ISO file and installing from the ISO
using the normal process around `install image`.
.. NOTE:: There have been previous documented issues with GRE/IPSEC tunneling using the E1000 adapter on the VyOS guest, and use of the VMXNET3 has been advised.
Memory Contention Considerations
--------------------------------
When the underlying ESXi host is approaching ~92% memory utilisation it will start the balloon process in s a 'soft' state to start reclaiming memory from guest operating systems.
This causes an artifical pressure using the vmmemctl driver on memory usage on the virtual guest. As VyOS by default does not have a swap file, this vmmemctl pressure is unable to
force processes to move in memory data to the paging file, and blindly consumes memory forcing the virtual guest into a low memory state with no way to escape. The balloon can expand to 65% of
guest allocated memory, so a VyOS guest running >35% of memory usage, can encounter an out of memory situation, and trigger the kernel oom_kill process. At this point a weighted
lottery favouring memory hungry processes will be run with the unlucky winner being terminated by the kernel.
It is advised that VyOS routers are configured in a resource group with adequate memory reservations so that ballooning is not inflicted on virtual VyOS guests.
References
----------
https://muralidba.blogspot.com/2018/03/how-does-linux-out-of-memory-oom-killer.html

1
docs/index.rst
View File

@ -43,6 +43,7 @@ as a router and firewall platform for cloud deployments.
appendix/troubleshooting.rst
appendix/examples/index.rst
appendix/commandtree/index.rst
appendix/vyos-on-vmware.rst
appendix/vyos-on-baremetal.rst
appendix/migrate-from-vyatta.rst