diff options
Diffstat (limited to 'docs/installation/virtual')
| -rw-r--r-- | docs/installation/virtual/gns3.rst | 6 | ||||
| -rw-r--r-- | docs/installation/virtual/vmware.rst | 33 | 
2 files changed, 27 insertions, 12 deletions
| diff --git a/docs/installation/virtual/gns3.rst b/docs/installation/virtual/gns3.rst index 45e2633c..b601a49f 100644 --- a/docs/installation/virtual/gns3.rst +++ b/docs/installation/virtual/gns3.rst @@ -1,3 +1,5 @@ +:lastproofread: 2021-07-24 +  .. _vyos-on-gns3:  VyOS on GNS3 @@ -29,7 +31,7 @@ VM setup  First, a virtual machine (VM) for the VyOS installation must be created  in GNS3. -Go to the GNS3 **File** menu, click **New template** and choose select +Go to the GNS3 **File** menu, click **New template** and select  **Manually create a new Template**.  .. figure:: /_static/images/gns3-01.png @@ -101,7 +103,7 @@ you want to install.  .. figure:: /_static/images/gns3-14.png -.. note:: You probably will want to accept to copy the .iso file to your +.. note:: You will probably want to accept, to copy the .iso file to your     default image directory when you are asked.  In the **Network** tab,  set **0** as the number of adapters, set the diff --git a/docs/installation/virtual/vmware.rst b/docs/installation/virtual/vmware.rst index 6feb95ba..8f201920 100644 --- a/docs/installation/virtual/vmware.rst +++ b/docs/installation/virtual/vmware.rst @@ -1,3 +1,5 @@ +:lastproofread: 2021-07-24
 +
  .. _vyosonvmware:
  Running on VMWare ESXi
 @@ -6,20 +8,31 @@ 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`.
 +.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.
 +.. 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.
 +When the underlying ESXi host is approaching ~92% memory utilisation it will 
 +start the balloon process in 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.
 | 
