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:
- Ensure that you meet the prerequisites.
- 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.
- Download the installation script.
- Invoke the installation script with the command that implements your decisions.
- Confirm that Ignite is running.
You must be running OCP on premise.
You must be connected to the OCP cluster in which you want to install Ignite.
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
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 the Ignite installation script to the current local directory by invoking the following command:
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:
Ensure that the current project is the project into which you want to install Ignite:
$ oc project
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.
To confirm that installation was successful:
Display the OpenShift OAuth proxy log-in page at
If you specified the
--routeoption when you ran the installation script, replace
openshift-routewith 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-routewith the value that the script provided.
- 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