Installing Red Hat Edge Manager on Red Hat OpenShift Container Platform

Procedure

1. Log into the Red Hat OpenShift Container Platform web console.

2. In your terminal, run the following command to create a project for the Red Hat Edge Manager application services:

   $ oc new-project <project_name>

   Copy to Clipboard Toggle word wrap
3. In the Red Hat OpenShift Container Platform web console, navigate to Ecosystem → Software Catalog.

4. Select your project from the Project dropdown menu.

   Note

   If the project does not appear in the dropdown, refresh your browser.

5. Search for "Red Hat Edge Manager" and select the Red Hat Edge Manager tile.
6. In the Red Hat Edge Manager side panel, click Create.
7. In the Release name field, enter the name of your project.
8. Select the desired version from the Chart version dropdown menu.

9. Before finishing the installation, you must configure the ingress certificates. In your terminal, run the following commands to extract the cluster’s Certificate Authority (CA) bundle:

   $ oc get configmap default-ingress-cert \
       -n openshift-config-managed \
       -o jsonpath='{.data.ca-bundle\.crt}' > /tmp/ingress-ca.crt
   
   $ cat /tmp/ingress-ca.crt

   Copy to Clipboard Toggle word wrap

10. Under the Configure via section, select the YAML view radio button, locate the global.auth.caCert field and paste the contents of /tmp/ingress-ca.crt as shown below:

    Example YAML configuration

    global:
      auth:
        caCert: |
          -----BEGIN CERTIFICATE-----
          MIIDWzCCAkOgAwIBAgIIUUg1fwtYuLYwDQYJKoZIhvcNAQELBQAwJjEkMCIGA1UE
          ...
          [Full certificate content]
          ...
          -----END CERTIFICATE-----
        insecureSkipTlsVerify: false

    Copy to Clipboard Toggle word wrap

    Warning

    Verify the global.auth.caCert field is included. If it is missing, you must add it manually to allow edge devices to verify the API. Ensure global.auth.caCert is correctly indented. If this field is missing or malformed, managed edge devices will be unable to verify the API identity and will fail to connect.

    Note

    If Advanced Cluster Management (ACM) is present in your environment but you are using Red Hat Edge Manager as a standalone feature, set the global.enableMulticlusterExtensions parameter to "false".

11. Click Create to deploy Red Hat Edge Manager.

1. In your terminal, run the following command to retrieve the host address:

   $ oc get route flightctl-ui -n <project_name> -o jsonpath='{.spec.host}'

   Copy to Clipboard Toggle word wrap
2. Copy the returned URL and paste it into a web browser.
3. Log in using your administrator credentials.

Procedure

1. In the Red Hat OpenShift Container Platform web console, navigate to Helm → Releases and record the Helm release name. This value is required for labeling the namespace and configuring user access.

2. In your terminal, run the following command to label the namespace:

   $ oc label namespace <namespace> io.flightctl/instance=<helm_release_name>

   Copy to Clipboard Toggle word wrap
   Important

   The label value must match the Helm release name, not the namespace name.

3. To verify which namespaces are associated with the Helm release name, run the following command:

   $ oc get namespaces -l io.flightctl/instance=<helm_release_name>

   Copy to Clipboard Toggle word wrap

Procedure

1. In the OpenShift console, locate the navigation menu on the left side of the screen.
2. Go to the Helm section and select Releases.
3. Find your release in the list.
4. Click the Kebab menu (three vertical dots) on the far right of the row and select Upgrade.

5. Configure your upgrade in the Upgrade Helm Release page:

   1. To change the version: Select a new version from the Chart Version dropdown menu if an update is available.
   2. To change settings: Manually edit the configuration in the YAML editor (Values) to update specific parameters.
6. Click Upgrade to finalize and deploy your changes.