9.5. Migrating the Reports Service to a Separate Machine

Procedure 9.8. Step 1: Configuring the New Reports Machine

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

   # subscription-manager register

   Copy to Clipboard Toggle word wrap
2. Find the Red Hat Enterprise Linux Server and Red Hat Enterprise Virtualization subscription pools and note down the pool IDs.

   # subscription-manager list --available

   Copy to Clipboard Toggle word wrap
3. Use the pool IDs located in the previous step to attach the entitlements to the system:

   # subscription-manager attach --pool=pool_id

   Copy to Clipboard Toggle word wrap
4. Disable all existing repositories:

   # subscription-manager repos --disable=*

   Copy to Clipboard Toggle word wrap
5. Enable the required channels:

   # subscription-manager repos --enable=rhel-6-server-rpms
   # subscription-manager repos --enable=rhel-6-server-supplementary-rpms
   # subscription-manager repos --enable=rhel-6-server-rhevm-3.6-rpms
   # subscription-manager repos --enable=jb-eap-6-for-rhel-6-server-rpms

   Copy to Clipboard Toggle word wrap
6. Ensure that all packages currently installed are up to date:

   # yum update

   Copy to Clipboard Toggle word wrap
7. Install the rhevm-reports-setup package:

   # yum install rhevm-reports-setup

   Copy to Clipboard Toggle word wrap
8. Run the engine-setup command to begin configuration of Reports on the machine:

   # engine-setup

   Copy to Clipboard Toggle word wrap
9. Press Enter to configure Reports:

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

   Copy to Clipboard Toggle word wrap
10. 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]:

    Copy to Clipboard Toggle word wrap
    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.
11. Press Enter to accept the automatically detected hostname, or enter an alternative hostname and press Enter:

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

    Copy to Clipboard Toggle word wrap
12. Enter the fully qualified domain name of the Manager machine, and then press Enter:

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

    Copy to Clipboard Toggle word wrap
13. Answer the following questions about the ovirt_engine_reports database. Press Enter to allow setup to create and configure a local database:

    Where is the Reports database located? (Local, Remote) [Local]:
    Setup can configure the local postgresql server automatically for the Reports to run. This may conflict with existing applications.
    Would you like Setup to automatically configure postgresql and create Reports database, or prefer to perform that manually? (Automatic, Manual) [Automatic]:
    

    Copy to Clipboard Toggle word wrap
14. Enter the fully qualified domain name and password for your ovirt_engine_history database host. Press Enter to accept the default values in each other field:

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

    Copy to Clipboard Toggle word wrap
15. Press Enter to allow setup to sign the Reports certificate and Apache 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]:

    Copy to Clipboard Toggle word wrap
16. 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]:

    Copy to Clipboard Toggle word wrap
17. Enter the root password for the Manager machine:

    root password on remote engine server manager-fqdn.com:

    Copy to Clipboard Toggle word wrap
18. Press Enter to allow automatic configuration of SSL on Apache:

    Setup can configure apache to use SSL using a certificate issued from the internal CA.
    Do you wish Setup to configure that, or prefer to perform that manually? (Automatic, Manual) [Automatic]:
    

    Copy to Clipboard Toggle word wrap
19. Set a password for the Reports administrative users (admin and superuser). Note that the reports system maintains its own set of credentials that are separate to those used for the Manager:

    Reports power users password:

    Copy to Clipboard Toggle word wrap
    You are prompted to enter the password a second time to confirm it.
20. Confirm your installation settings:

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

    Copy to Clipboard Toggle word wrap

Procedure 9.9. Step 2: Migrating Saved Reports to the New Reports Machine

1. On the Manager machine, run the ovirt-engine-reports-tool command:

   # ovirt-engine-reports-tool
   

   Copy to Clipboard Toggle word wrap
2. Enter the number that corresponds to the export option, and press Enter:

   (2) Export Jasperreports saved reports to a zip file
   (1, 2, 3) []: 2
   

   Copy to Clipboard Toggle word wrap
3. Enter the absolute path for the zip file to export saved reports to, and press Enter:

   Filename to export saved reports to: /tmp/saved-reports.zip

   Copy to Clipboard Toggle word wrap
4. Copy the zip file to the new Reports machine:

   # scp /tmp/saved-reports.zip reports-machine-fqdn:/tmp/

   Copy to Clipboard Toggle word wrap
5. On the new Reports machine, run the ovirt-engine-reports-tool command:

   # ovirt-engine-reports-tool
   

   Copy to Clipboard Toggle word wrap
6. Enter the number that corresponds to the import option, and press Enter:

   (3) Import a saved reports zip file to Jasperreports
   (1, 2, 3) []: 3

   Copy to Clipboard Toggle word wrap
7. Enter the absolute path of the zip file from which to import, and press Enter:

   Filename to import saved reports from: /tmp/saved-reports.zip

   Copy to Clipboard Toggle word wrap

Procedure 9.10. Step 3: Removing the Reports Service from the Manager Machine

1. Stop the Reports service:

   # service ovirt-engine-reportsd stop

   Copy to Clipboard Toggle word wrap
2. Remove the Reports package:

   # yum remove rhevm-reports

   Copy to Clipboard Toggle word wrap
3. Remove the Reports files:

   # rm -rf /etc/ovirt-engine-reports /var/lib/ovirt-engine-reports

   Copy to Clipboard Toggle word wrap
4. Remove the Reports database and user. The default name for both is ovirt_engine_reports:

   # su - postgres
   $ psql
   postgres=# drop database ovirt_engine_reports;
   postgres=# drop user ovirt_engine_reports;
   

   Copy to Clipboard Toggle word wrap