Search
SupportConsoleDevelopersStart a trialContact

Chapter 9. Installing Fuse Online on OpenShift Container Platform

download PDF

You can install Fuse Online on OpenShift Container Platform (OCP) on premise. See the following topics for details:

9.1. Overview of steps for installing Fuse Online on OCP

To install Fuse Online on OCP on premise, the main steps are:

  1. A user with cluster administration permissions:

    1. Registers a custom resource definition (CRD) at the cluster level.
    2. Grants permission for a user to install Fuse Online in their projects.

  2. A user who is granted permission to install Fuse Online:

    1. Ensures that all prerequisites are met.
    2. Decides how to install Fuse Online with regard to the OpenShift project to install into, the OpenShift route for Fuse Online, and the level of accessibility of OpenShift logs.
    3. Downloads the installation script.
    4. Invokes the installation script with the command that implements decisions.
    5. Confirms that Fuse Online is running.

9.2. Register a custom resource definition

To enable installation of Fuse Online, a cluster administrator registers a custom resource definition. The administrator needs to do this only once for the OpenShift cluster. The administrator also grants permission for installing Fuse Online to the appropriate users. Each user can then install Fuse Online in their projects.

Prerequisites

  • You must have cluster administration permissions.
  • You must be connected to the OCP cluster into which Fuse Online will be installed.

Procedure

  1. Download the Fuse Online installation script to the current local directory by invoking the following command:

    $ wget https://raw.githubusercontent.com/syndesisio/fuse-online-install/1.4/install_ocp.sh

  2. To verify that you are properly connected and can list custom resource definitions, invoke the following command:

    $ oc get crd

  3. To register the custom resource definition at the cluster level, invoke the following command:

    $ bash install_ocp.sh --setup

  4. Grant installation permission to each user who needs to install Fuse Online. For example, suppose you want to grant permission to an account with the user name developer. The following command grants permission to developer to install Fuse Online into any project that the developer account can access on the currently connected cluster:

    $ bash install_ocp.sh --grant developer --cluster

    Repeat this command for each user account that needs permission to install Fuse Online.

9.3. Procedure for installing or upgrading Fuse Online on OCP

To install Fuse Online on OCP on premise, you need to make some decisions about how you want to install Fuse Online. You then download the installation script, run it, and confirm that Fuse Online is installed.

Prerequisites

  • You must be running OCP on premise.
  • You must be connected to the OCP cluster in which you want to install Fuse Online.
  • A user with cluster administration permissions must have given you permission to install Fuse Online in any project that you have permission to access in the cluster.

Decisions

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

  • Do you want to install Fuse Online into the current OpenShift project or do you want to specify the project into which you want to install Fuse Online in the command that you invoke to do the installation?

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

    You can install Fuse Online into a project that you specify. If this project does not yet exist, then the script creates it. If this project exists then the installation script prompts you to confirm that it is okay to delete the project’s content. To continue, you must confirm. The installation script then deletes the project and re-creates it.

  • Do you want the installation script to calculate the OpenShift route by which Fuse Online 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 Fuse Online integrations by clicking a link in the Fuse Online user interface?

    While you can always access OpenShift logs manually, you might want to enable direct access by means of a link in the Fuse Online user interface. The default is that the installation script does not enable this link. To enable this link, you specify the URL for your OpenShift console when you invoke the installation script.

Download

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

$ wget https://raw.githubusercontent.com/syndesisio/fuse-online-install/1.4/install_ocp.sh

Installation

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

  1. Log in with an account that has permission to install Fuse Online. For example:

    $ oc login developer

  2. Ensure that the current project is the project into which you want to install Fuse Online:

    $ oc project

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

    $ bash install_ocp.sh

To install Fuse Online into a project that you specify, under an OpenShift route that you specify, and also enable the link from Fuse Online to OpenShift logs, invoke a command in which you:

  • Specify the --project option. The argument is the name of the project in which you want to install Fuse Online.
  • Specify the --route option. The argument is the URL that your Fuse Online environment will have. This URL will be where you access your installation of Fuse Online. This URL specifies the project in which you are installing Fuse Online followed by the domain that is specific to your OpenShift cluster.
  • Replace the --console argument with the URL for your OpenShift console.

For example: 

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

According to how you want to install Fuse Online, 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.

Upgrading

If Fuse Online is installed on your OpenShift cluster, you can upgrade it to the new version by using the same procedure as for installing Fuse Online. During installation, the Fuse Online installer automatically scans the namespace for Fuse Online installations. If the installer finds an older version then it triggers an infrastructure upgrade.

Any existing integrations continue to run both during and after the upgrade. The existing integrations continue to run with the older versions of Fuse Online libraries and dependencies. After the infrastructure upgrade, you can upgrade an integration by republishing it. In Fuse Online, select the integration that you want to upgrade, select Edit, and publish it again. This step forces a rebuild that uses the latest Fuse Online dependencies.

Upgrading Fuse Online images

From time to time, fresh docker-formatted images are released for Fuse Online, in order to incorporate patches and security fixes. You will be notified of these updates through Red Hat’s errata update channel. To upgrade the Fuse Online images, download the latest install_ocp.sh script, as follows: 

$ wget https://raw.githubusercontent.com/syndesisio/fuse-online-install/1.4/install_ocp.sh

And follow the instructions for upgrading.

Note

The install_ocp.sh script on the 1.4 branch is updated at the time of the images release, so when you run the latest install_ocp.sh script, it updates the Fuse Online images to use the latest available images.

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 Fuse Online home page appears either immediately or after you log in to the OpenShift console.

Deleting your Fuse Online project

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

$ oc delete project fuseonline

Uninstalling Fuse Online

To uninstall Fuse Online without deleting its project nor anything else in that project, invoke the following command:

$ oc delete syndesis app

This command deletes the Fuse Online infrastructure but it does not delete running integrations. Integrations that are running continue to run and execute as implemented.

Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.