1.2. Installing and Configuring Data Warehouse on a Separate Machine

This section describes installing and configuring the Data Warehouse service on a separate machine from the Red Hat Virtualization Manager. Installing Data Warehouse on a separate machine helps to reduce the load on the Manager machine.

Note

Red Hat only supports installing the Data Warehouse database, the Data Warehouse service and Grafana all on the same machine as each other, even though you can install each of these components on separate machines from each other.

Prerequisites

  • The Red Hat Virtualization Manager is installed on a separate machine.
  • A physical server or virtual machine running Red Hat Enterprise Linux 8.
  • The Manager database password.
  • Access from the Data Warehouse machine to the Manager database machine’s TCP port 5432.

  • If you choose to install the Data Warehouse database separately from the Data Warehouse service, you must set up the database first. To install a remote Data Warehouse database manually, see Preparing a Remote PostgreSQL Database. You must have the following information about the database machine:

    • The FQDN
    • The port through which the database can be reached (5432 by default)
    • The database name
    • The database user
    • The database password

    • You must manually grant access by editing the postgresql.conf file. Edit the /var/lib/pgsql/data/postgresql.conf file and modify the listen_addresses line so that it matches the following: 

      listen_addresses = '*'

      If the line does not exist or has been commented out, add it manually.

Enabling the Red Hat Virtualization Manager Repositories

You need to log in and register the Data Warehouse machine with Red Hat Subscription Manager, attach the Red Hat Virtualization Manager subscription, and enable the Manager repositories.

Procedure

  1. Register your system with the Content Delivery Network, entering your Customer Portal user name and password when prompted: 

    # subscription-manager register
    Note

    If you are using an IPv6 network, use an IPv6 transition mechanism to access the Content Delivery Network and subscription manager.

  2. Find the Red Hat Virtualization Manager subscription pool and record the pool ID: 

    # subscription-manager list --available

  3. Use the pool ID to attach the subscription to the system: 

    # subscription-manager attach --pool=pool_id
    Note

    To view currently attached subscriptions: 

    # subscription-manager list --consumed

    To list all enabled repositories: 

    # dnf repolist

  4. Configure the repositories: 

    # subscription-manager repos \
    --disable='*' \
    --enable=rhel-8-for-x86_64-baseos-eus-rpms \
    --enable=rhel-8-for-x86_64-appstream-eus-rpms \
    --enable=rhv-4.4-manager-for-rhel-8-x86_64-rpms \
    --enable=fast-datapath-for-rhel-8-x86_64-rpms \
    --enable=jb-eap-7.4-for-rhel-8-x86_64-rpms \
    --enable=openstack-16.2-cinderlib-for-rhel-8-x86_64-rpms \
    --enable=rhceph-4-tools-for-rhel-8-x86_64-rpms \
    --enable=rhel-8-for-x86_64-appstream-tus-rpms \
    --enable=rhel-8-for-x86_64-baseos-tus-rpms

  5. Set the RHEL version to 8.6: 

    # subscription-manager release --set=8.6

  6. Enable the pki-deps module. 

    # dnf module -y enable pki-deps

  7. Enable version 12 of the postgresql module. 

    # dnf module -y enable postgresql:12

  8. Enable version 14 of the nodejs module: 

    # dnf module -y enable nodejs:14

  9. Synchronize installed packages to update them to the latest available versions. 

    # dnf distro-sync --nobest

Additional resources

For information on modules and module streams, see the following sections in Installing, managing, and removing user-space components

Installing Data Warehouse on a Separate Machine

Procedure

  1. Log in to the machine where you want to install the database.

  2. Ensure that all packages are up to date: 

    # dnf upgrade --nobest

  3. Install the ovirt-engine-dwh-setup package: 

    # dnf install ovirt-engine-dwh-setup

  4. Run the engine-setup command to begin the installation: 

    # engine-setup

  5. Answer Yes to install Data Warehouse on this machine: 

    Configure Data Warehouse on this host (Yes, No) [Yes]:

  6. Answer Yes to install Grafana on this machine: 

    Configure Grafana on this host (Yes, No) [Yes]:

  7. Press Enter to accept the automatically-detected host name, or enter an alternative host name and press Enter: 

    Host fully qualified DNS name of this server [autodetected hostname]:

  8. Press Enter to automatically configure the firewall, or type No and press Enter to maintain existing settings: 

    Setup can automatically configure the firewall on this system.
Note: automatic configuration of the firewall may overwrite current settings.
Do you want Setup to configure the firewall? (Yes, No) [Yes]:

    If you choose to automatically configure the firewall, and no firewall managers are active, you are prompted to select your chosen firewall manager from a list of supported options. Type the name of the firewall manager and press Enter. This applies even in cases where only one option is listed.

  9. Enter the fully qualified domain name of the Manager machine, and then press Enter: 

    Host fully qualified DNS name of the engine server []:

  10. Press Enter to allow setup to sign the certificate on the Manager via SSH: 

    Setup will need to do some actions on the remote engine server. Either automatically, using ssh as root to access it, or you will be prompted to manually perform each such action.
Please choose one of the following:
1 - Access remote engine server using ssh as root
2 - Perform each action manually, use files to copy content around
(1, 2) [1]:

  11. Press Enter to accept the default SSH port, or enter an alternative port number and then press Enter: 

    ssh port on remote engine server [22]:

  12. Enter the root password for the Manager machine: 

    root password on remote engine server manager.example.com:

  13. Specify whether to host the Data Warehouse database on this machine (Local), or on another machine (Remote).:

    Note

    Red Hat only supports installing the Data Warehouse database, the Data Warehouse service and Grafana all on the same machine as each other, even though you can install each of these components on separate machines from each other. 

    Where is the DWH database located? (Local, Remote) [Local]:

    • If you select Local, the engine-setup script can configure your database automatically (including adding a user and a database), or it can connect to a preconfigured local database: 

      Setup can configure the local postgresql server automatically for the DWH to run. This may conflict with existing applications.
Would you like Setup to automatically configure postgresql and create DWH database, or prefer to perform that manually? (Automatic, Manual) [Automatic]:
      • If you select Automatic by pressing Enter, no further action is required here.

      • If you select Manual, input the following values for the manually-configured local database: 

        DWH database secured connection (Yes, No) [No]:
DWH database name [ovirt_engine_history]:
DWH database user [ovirt_engine_history]:
DWH database password:

  14. Enter the fully qualified domain name and password for the Manager database machine. If you are installing the Data Warehouse database on the same machine where the Manager database is installed, use the same FQDN. Press Enter to accept the default values in each other field: 

    Engine database host []: engine-db-fqdn
Engine database port [5432]:
Engine database secured connection (Yes, No) [No]:
Engine database name [engine]:
Engine database user [engine]:
Engine database password: password

  15. Choose how long Data Warehouse will retain collected data: 

    Please choose Data Warehouse sampling scale:
(1) Basic
(2) Full
(1, 2)[1]:

    Full uses the default values for the data storage settings listed in Application Settings for the Data Warehouse service in ovirt-engine-dwhd.conf (recommended when Data Warehouse is installed on a remote host).

    Basic reduces the values of DWH_TABLES_KEEP_HOURLY to 720 and DWH_TABLES_KEEP_DAILY to 0, easing the load on the Manager machine. Use Basic when the Manager and Data Warehouse are installed on the same machine.

  16. Confirm your installation settings: 

    Please confirm installation settings (OK, Cancel) [OK]:

  17. After the Data Warehouse configuration is complete, on the Red Hat Virtualization Manager, restart the ovirt-engine service: 

    # systemctl restart ovirt-engine
  18. Optionally, set up SSL to secure database connections.