Log in to the Administration Portal

After you run the engine-setup command to configure Oracle Linux Virtualization Manager, you can sign in to the Administration Portal.

We recommended that you use the latest version one of the following browsers to access the Administration Portal

  • Mozilla Firefox

  • Google Chrome

  • Microsoft Edge

If Oracle Linux Virtualization Manager was configured to use a self-signed SSL certificate, or an SSL certificate that's signed by a Certificate Authority (CA) that isn't trusted by the browser (for example an Intermediate CA), install the CA certificate in the browser. Consult the browser's instructions for how to import a CA certificate.

You can download the CA certificate by selecting Engine CA Certificate on the Welcome dashboard or by navigating directly to http://manager-fqdn/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA.

Usually you access the Administration Portal using the fully qualified domain name of the Manager host that you provided during installation. However, you can access the Administration Portal using an alternative host name(s). To do this, add a configuration file to the Manager as follows:

  1. Sign in to the Manager host as root.

  2. Create the file /etc/ovirt-engine/engine.conf.d/99-custom-sso-setup.conf with the following content:

    SSO_ALTERNATE_ENGINE_FQDNS="alias1.example.com alias2.example.com"

    The list of alternative host names must be separated by spaces.

  3. Restart Oracle Linux Virtualization Manager.

    systemctl restart ovirt-engine       

Log In and Log Out

Sign in to the Administration Portal using a web browser and the default admin@ovirt user.

  1. Go to https://manager-fqdn/ovirt-engine. The Welcome page displays.

  2. (Optional) Change the preferred language from the dropdown list on the Welcome page.

    You can view the Administration Portal in different languages. The default language is based on the locale of the web browser.

  3. Select Administration Portal. The Login page displays.

  4. Enter admin@ovirt for the Username and the password you specified when you configured the Manager.

    Note:

    If you use the REST API, the admin user is identified as admin@ovirt@internalsso when Keycloak SSO is enabled.

    If you disabled Keycloak integration and use the legacy internal domain (AAA), the default administrative user is admin@internal.

  5. If Keycloak SSO is disabled, from the Profile list select internal.

    Note:

    This step doesn't apply when Keycloak SSO is enabled, because there is no profile list.

  6. Select Log In.

Note:

From the Welcome dashboard, you also have the option of signing in to two other portals:

  • The VM Portal

  • The Monitoring Portal

For more information, see Access Portals in the Oracle Linux Virtualization Manager: Architecture and Planning Guide

To log out of the Administration Portal, select the person icon in the header bar and then select Sign Out. You're returned to the Login page.