From 6e8ad323599fc1ce0d3c1861d558415350b4048a Mon Sep 17 00:00:00 2001 From: vcerenu Date: Fri, 28 Jul 2023 15:09:44 -0300 Subject: [PATCH 1/3] add vbox notes and change so base --- .../virtual-machine/virtual-machine.rst | 22 +++++++++++++------ 1 file changed, 15 insertions(+), 7 deletions(-) diff --git a/source/deployment-options/virtual-machine/virtual-machine.rst b/source/deployment-options/virtual-machine/virtual-machine.rst index d3dc970d3a..db0f066bad 100644 --- a/source/deployment-options/virtual-machine/virtual-machine.rst +++ b/source/deployment-options/virtual-machine/virtual-machine.rst @@ -13,7 +13,7 @@ Wazuh provides a pre-built virtual machine image in Open Virtual Appliance (OVA) Download the `virtual appliance (OVA) `_, which contains the following components: - - CentOS 7 + - Amazon Linux 2 - Wazuh manager |WAZUH_CURRENT_OVA| - Wazuh indexer |WAZUH_CURRENT_OVA| - Filebeat-OSS |FILEBEAT_LATEST_OVA| @@ -22,13 +22,13 @@ Download the `virtual appliance (OVA) `__ (`sha512 `__) +.. |VM_AL2_64_OVA| replace:: `wazuh-|WAZUH_CURRENT_OVA|.ova `__ (`sha512 `__) -+--------------+--------------+--------------+---------+--------------------------------------+ -| Distribution | Architecture | VM Format | Version | Package | ++----------------+--------------+--------------+---------+--------------------------------------+ +| Distribution | Architecture | VM Format | Version | Package | +==============+==============+==============+=========+======================================+ -| CentOS 7 | 64bits | OVA | |WAZUH_CURRENT_OVA| | |VM_CentOS7_64_OVA| | -+--------------+--------------+--------------+---------+--------------------------------------+ +| Amazon Linux 2 | 64bits | OVA | |WAZUH_CURRENT_OVA| | |VM_AL2_64_OVA| | ++----------------+--------------+--------------+---------+--------------------------------------+ Hardware requirements --------------------- @@ -51,6 +51,14 @@ Out of the box, the Wazuh VM is configured with the following specifications: However, this hardware configuration can be modified depending on the number of protected endpoints and indexed alert data. More information about requirements can be found :doc:`here `. +VirtualBox graphic card configuration +------------------------------------- + +In case of deploying Wazuh through OVA with VirtualBox it is necessary to modify the graphic controller of the VM. +After importing the OVA file you must select the imported VM, go to ``options`` - -> ``display`` --> ``graphic controller`` and change the ``XBoxVGA`` option to ``VMSVGA``. + +If you do not make this change, you will notice that the VM window will freeze, but the VM will continue to function normally. + Import and access the virtual machine ------------------------------------- @@ -108,7 +116,7 @@ VirtualBox time configuration In case of using VirtualBox, once the virtual machine is imported it may run into issues caused by time skew when VirtualBox synchronizes the time of the guest machine. To avoid this situation, enable the ``Hardware Clock in UTC Time`` option in the ``System`` tab of the virtual machine configuration. .. note:: - By default, the network interface type is set to Bridged Adapter. The VM will attempt to obtain an IP address from the network DHCP server. Alternatively, a static IP address can be set by configuring the appropriate network files in the CentOS operating system on which the VM is based. + By default, the network interface type is set to Bridged Adapter. The VM will attempt to obtain an IP address from the network DHCP server. Alternatively, a static IP address can be set by configuring the appropriate network files in the Amazon Linux operating system on which the VM is based. Once the virtual machine is imported and running, the next step is to :doc:`deploy the Wazuh agents ` on the systems to be monitored. From 5a64e4807e4a1c8ce055ce2c6dd52afa3452495e Mon Sep 17 00:00:00 2001 From: vcerenu Date: Fri, 28 Jul 2023 15:28:55 -0300 Subject: [PATCH 2/3] fix package list table --- .../deployment-options/virtual-machine/virtual-machine.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/deployment-options/virtual-machine/virtual-machine.rst b/source/deployment-options/virtual-machine/virtual-machine.rst index db0f066bad..a3af11df5c 100644 --- a/source/deployment-options/virtual-machine/virtual-machine.rst +++ b/source/deployment-options/virtual-machine/virtual-machine.rst @@ -25,9 +25,9 @@ Packages list .. |VM_AL2_64_OVA| replace:: `wazuh-|WAZUH_CURRENT_OVA|.ova `__ (`sha512 `__) +----------------+--------------+--------------+---------+--------------------------------------+ -| Distribution | Architecture | VM Format | Version | Package | -+==============+==============+==============+=========+======================================+ -| Amazon Linux 2 | 64bits | OVA | |WAZUH_CURRENT_OVA| | |VM_AL2_64_OVA| | +| Distribution | Architecture | VM Format | Version | Package | ++================+==============+==============+=========+======================================+ +| Amazon Linux 2 | 64bits | OVA | |WAZUH_CURRENT_OVA| | |VM_AL2_64_OVA| | +----------------+--------------+--------------+---------+--------------------------------------+ Hardware requirements From 7bbdf0d2d52193edf244af745f544edafdb62481 Mon Sep 17 00:00:00 2001 From: Javier Medeot Date: Mon, 31 Jul 2023 12:08:39 -0300 Subject: [PATCH 3/3] Add review changes --- .../virtual-machine/virtual-machine.rst | 33 +++++++++---------- 1 file changed, 16 insertions(+), 17 deletions(-) diff --git a/source/deployment-options/virtual-machine/virtual-machine.rst b/source/deployment-options/virtual-machine/virtual-machine.rst index a3af11df5c..c6da22c3fb 100644 --- a/source/deployment-options/virtual-machine/virtual-machine.rst +++ b/source/deployment-options/virtual-machine/virtual-machine.rst @@ -23,12 +23,13 @@ Packages list ------------- .. |VM_AL2_64_OVA| replace:: `wazuh-|WAZUH_CURRENT_OVA|.ova `__ (`sha512 `__) +.. |WAZUH_OVA_VERSION| replace:: |WAZUH_CURRENT_OVA| -+----------------+--------------+--------------+---------+--------------------------------------+ -| Distribution | Architecture | VM Format | Version | Package | -+================+==============+==============+=========+======================================+ -| Amazon Linux 2 | 64bits | OVA | |WAZUH_CURRENT_OVA| | |VM_AL2_64_OVA| | -+----------------+--------------+--------------+---------+--------------------------------------+ ++----------------+--------------+--------------+----------------------+------------------+ +| Distribution | Architecture | VM Format | Version | Package | ++================+==============+==============+======================+==================+ +| Amazon Linux 2 | 64-bit | OVA | |WAZUH_OVA_VERSION| | |VM_AL2_64_OVA| | ++----------------+--------------+--------------+----------------------+------------------+ Hardware requirements --------------------- @@ -51,28 +52,26 @@ Out of the box, the Wazuh VM is configured with the following specifications: However, this hardware configuration can be modified depending on the number of protected endpoints and indexed alert data. More information about requirements can be found :doc:`here `. -VirtualBox graphic card configuration +Import and access the virtual machine ------------------------------------- -In case of deploying Wazuh through OVA with VirtualBox it is necessary to modify the graphic controller of the VM. -After importing the OVA file you must select the imported VM, go to ``options`` - -> ``display`` --> ``graphic controller`` and change the ``XBoxVGA`` option to ``VMSVGA``. - -If you do not make this change, you will notice that the VM window will freeze, but the VM will continue to function normally. - +#. Import the OVA to the virtualization platform. -Import and access the virtual machine -------------------------------------- +#. If you're using VirtualBox, set the ``VMSVGA`` graphic controller. Setting another graphic controller freezes the VM window. -First, import the OVA to the virtualization platform and start the machine. + #. Select the imported VM. + #. Click **Settings** > **Display** + #. In **Graphic controller**, select the ``VMSVGA`` option. -Use the following user and password to access the virtual machine. You can use the virtualization platform or access it via SSH. +#. Start the machine. +#. Access the virtual machine using the following user and password. You can use the virtualization platform or access it via SSH. - .. code-block:: none + .. code-block:: none user: wazuh-user password: wazuh -The password for ``root`` user is ``wazuh``. However, accessing the virtual machine via SSH is only possible using the system user. SSH login with the root user is disabled. + The password for ``root`` user is ``wazuh``. However, accessing the virtual machine via SSH is only possible using the system user. SSH login with the root user is disabled. Access the Wazuh dashboard --------------------------