Chapter 8. Installing Ignite on OpenShift Container Platform

This topic provides information and instructions for installing Ignite on OpenShift Container Platform (OCP) on premise. The main steps are:

  1. Ensure that you meet the prerequisites.
  2. Decide how you want to install Ignite with regard to the OpenShift project to install into, the OpenShift route for Ignite, and the level of accessibility of OpenShift logs.
  3. Download the installation script.
  4. Invoke the installation script with the command that implements your decisions.
  5. Confirm that Ignite is running.

Prerequisites

You must be running OCP on premise.

You must be connected to the OCP cluster in which you want to install Ignite.

Decisions

To correctly specify the installation command, you need to decide on the answers to these questions:

  • Into which OpenShift project do you want to install Ignite?

    The default is that the installation script installs Ignite into the current project.

    If the project into which you want to install Ignite

    • Exists

      The installation script will prompt you to confirm that it is okay to delete the project’s content before installing Ignite. You must confirm deletion of the project’s content for the installation script to continue.

    • Does not exist

      You can create it now so that it is the current project. Alternatively, when you run the installation script, you can specify a project name and the script will create the project.

  • Do you want to install Ignite into the current OpenShift project or do you want to specify the project into which you want to install Ignite in the command that you invoke to do the installation?
  • Do you want the installation script to calculate the OpenShift route by which Ignite can be reached or do you want to specify the OpenShift route in the installation command?

    The default is that the installation script calculates the route.

  • Do you want to be able to access OpenShift log information for Ignite integrations by clicking a link in the Ignite user interface?

    While you can always access OpenShift logs manually, you might want to enable direct access by means of a link in the Ignite user interface.

    The default is that the installation script does not enable this link.

Download

Download the Ignite installation script to the current local directory by invoking the following command:

$ wget https://raw.githubusercontent.com/syndesisio/fuse-ignite-install/1.3/install_ocp.sh

Installation

To install Ignite into the current project, under the OpenShift route chosen by the installation script, without enabling the link from Ignite to OpenShift logs, invoke the following commands:

  1. Ensure that the current project is the project into which you want to install Ignite:

    $ oc project

  2. In the directory in which you downloaded the installation script, invoke the installation script as follows:

    $ bash install_ocp.sh

To install Ignite into a project that you specify, under an OpenShift route that you specify, and also enable the link from Ignite to OpenShift logs, invoke a command such as the following:

$ bash install_ocp.sh \
    --project ignite \
    --route ignite.6a63.fuse-ignite.openshiftapps.com \
    --console https://console.fuse-ignite.openshift.com/console

According to how you want to install Ignite, you can specify

  • All three options
  • Any two options
  • Any one of the options
  • No options

The installation script uses the default for an option that you do not specify.

Confirm installation

To confirm that installation was successful:

  1. Display the OpenShift OAuth proxy log-in page at https://openshift-route

    If you specified the --route option when you ran the installation script, replace openshift-route with the route name that you specified. If you chose to let the installation script calculate the OpenShift route, then the the script displays the calculated route near the end of its execution. Replace openshift-route with the value that the script provided.

  2. If you are not already logged in to the OpenShift console, its log-in page appears. Enter your OpenShift user name and password to log in.

The Ignite home page appears either immediately or after you log in to the OpenShift console.

Deleting your Ignite project

If you want to delete your Ignite project, invoke the delete project command. For example, to delete a project whose name is ignite, enter the following command:

$ oc delete project ignite