Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Modify base operating system for OVA #6287

Merged
merged 3 commits into from
Aug 2, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 20 additions & 13 deletions source/deployment-options/virtual-machine/virtual-machine.rst
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Wazuh provides a pre-built virtual machine image in Open Virtual Appliance (OVA)

Download the `virtual appliance (OVA) <https://packages.wazuh.com/|WAZUH_CURRENT_MAJOR_OVA|/vm/wazuh-|WAZUH_CURRENT_OVA|.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|
Expand All @@ -22,13 +22,14 @@ Download the `virtual appliance (OVA) <https://packages.wazuh.com/|WAZUH_CURRENT
Packages list
-------------

.. |VM_CentOS7_64_OVA| replace:: `wazuh-|WAZUH_CURRENT_OVA|.ova <https://packages.wazuh.com/|WAZUH_CURRENT_MAJOR_OVA|/vm/wazuh-|WAZUH_CURRENT_OVA|.ova>`__ (`sha512 <https://packages.wazuh.com/|WAZUH_CURRENT_MAJOR_OVA|/checksums/wazuh/|WAZUH_CURRENT_OVA|/wazuh-|WAZUH_CURRENT_OVA|.ova.sha512>`__)
.. |VM_AL2_64_OVA| replace:: `wazuh-|WAZUH_CURRENT_OVA|.ova <https://packages.wazuh.com/|WAZUH_CURRENT_MAJOR_OVA|/vm/wazuh-|WAZUH_CURRENT_OVA|.ova>`__ (`sha512 <https://packages.wazuh.com/|WAZUH_CURRENT_MAJOR_OVA|/checksums/wazuh/|WAZUH_CURRENT_OVA|/wazuh-|WAZUH_CURRENT_OVA|.ova.sha512>`__)
.. |WAZUH_OVA_VERSION| replace:: |WAZUH_CURRENT_OVA|

+--------------+--------------+--------------+---------+--------------------------------------+
| Distribution | Architecture | VM Format | Version | Package |
+==============+==============+==============+=========+======================================+
| CentOS 7 | 64bits | OVA | |WAZUH_CURRENT_OVA| | |VM_CentOS7_64_OVA| |
+--------------+--------------+--------------+---------+--------------------------------------+
+----------------+--------------+--------------+----------------------+------------------+
| Distribution | Architecture | VM Format | Version | Package |
+================+==============+==============+======================+==================+
| Amazon Linux 2 | 64-bit | OVA | |WAZUH_OVA_VERSION| | |VM_AL2_64_OVA| |
+----------------+--------------+--------------+----------------------+------------------+

Hardware requirements
---------------------
Expand All @@ -51,20 +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 </quickstart>`.


Import and access the virtual machine
-------------------------------------

First, import the OVA to the virtualization platform and start the machine.
#. Import the OVA to the virtualization platform.

#. If you're using VirtualBox, set the ``VMSVGA`` graphic controller. Setting another graphic controller freezes the VM window.

Use the following user and password to access the virtual machine. You can use the virtualization platform or access it via SSH.
#. Select the imported VM.
#. Click **Settings** > **Display**
#. In **Graphic controller**, select the ``VMSVGA`` option.

#. 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
--------------------------
Expand Down Expand Up @@ -108,7 +115,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 </installation-guide/wazuh-agent/index>` on the systems to be monitored.
Expand Down