Back to support

Installing on Microsoft Azure

The IBM Event Automation offering on Azure Marketplace provides an automated process for installing Event Automation capabilities onto a Red Hat OpenShift cluster. The process installs all the catalog sources and operators that are required to create instances of all the Event Automation capabilities, which include Event Streams, Event Endpoint Management, and Event Processing.

Before you begin

Ensure you meet the following requirements for the Azure Marketplace installation:

  • You must have an entitlement key from the IBM Container software library.
  • If you are installing IBM Event Automation (BYOL), you must have an existing Red Hat OpenShift cluster on Azure or a self-managed cluster from another provider.

Selecting a plan

The plans that are available for you to select depend on whether you have an IBM Event Automation license or not.

If you have a license for Event Automation, complete the following steps:

  1. Log in to Azure Marketplace IBM Event Automation (BYOL).
  2. Click Get It Now.
  3. Select your plan.
  4. Click Continue > Create.
  5. Choose your subscription to start the installation setup.

If you don’t have a license for Event Automation, complete the following steps:

  1. Log in to Azure Marketplace IBM Event Automation.
  2. Click Get it Now.
  3. Subscribe to the IBM Event Automation plan.
  4. Choose your subscription to start the installation setup.

Installing the operators

Install all the Event Automation catalog sources and operators as follows.

  1. In the Basics dialog, complete the following steps:
    • Select your Subscription and the Resource group in which your Azure Red Hat OpenShift cluster exists.
    • In the Instance details section, select your Region.
    • Select the Azure resource prefix. This value is the resource group where your cluster is installed.
    • (Optional) If you’re using an ARO plan, select an ARO cluster resource group and ARO cluster.
  2. Click Next.
  3. In the OpenShift Cluster dialog, complete the following fields:
    • Cluster API URL.
    • Openshift Credential Type. This value is either Password or Token.
    • Cluster administrator username.
    • Cluster administrator password.
    • Confirm administrator password.
  4. Click Next.
  5. In the IBM Event Automation dialog, complete the following fields:
    • Click Include IBM Entitlement Key Secret.
    • Add the Entitlement key and confirm it in the following field.
    • In the Operator Scope field, select whether you want to use a Single Namespace or All Namespaces.
    • In the Namespace for the operators field, select the namespace that you want to use.
  6. Click Next.
  7. In the Deployment VM dialog, complete the following steps:
    • In the Authentication type field, set a Password or submit an SSH Public Key.
    • Leave all the other fields with their default values.
  8. Click Next.
  9. Review your installation details, then click Submit to begin the installation.

The installation starts and a message is displayed with the status of the installation.

When the installation completes successfully, the status changes to Your deployment is complete. You can now use the operators to install the IBM Event Automation capabilities: Event Streams, Event Endpoint Management, and Event Processing.

Tip: You can also check the status of your deployments in your Azure portal later by going to Home > <resource_group> | Deployments in the navigation menu (where <resource_group> is the Resource group value that you selected during installation).

See the following sections for links to information about installing each capability. You can install any capability you require independently of each other.

Installing the capabilities

Using the operators, you can install the required Event Automation capabilities as summarized in the following sections.

Installing Event Streams

To install the Event Streams capability, follow the instructions in installing an Event Streams instance.

Installing Event Endpoint Management

To install the Event Endpoint Management capability, complete the following steps:

  1. Ensure that you have a valid certificate manager.
  2. Install an Event Manager instance.
  3. Install an Event Gateway instance.

Installing Event Processing

To install the Event Processing capability, complete the following steps:

  1. Ensure that you have a valid certificate manager.
  2. Install a Flink instance.
  3. Install an Event Processing instance.