Chapter 10. How to install or upgrade Fuse Online on OpenShift Container Platform

1. A user with cluster administration permissions:

   1. Downloads the installation script.
   2. Registers a custom resource definition (CRD) at the cluster level.
   3. 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.

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.5/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.

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.5/install_ocp.sh

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

   $ oc login -u developer -p developer

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

   $ oc project

4. In the directory in which you downloaded the installation script, invoke the installation script:

   • To perform the default installation, invoke:

     $ bash install_ocp.sh

   • To specify installation options, you might invoke something like the following command, which specifies three options:

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

     • --project specifies the name of the OpenShift project in which you want to install Fuse Online. You need to specify this option only when you want to install Fuse Online into an OpenShift project other than the current OpenShift project.

     • --route specifies the URL that your Fuse Online environment will have. This URL will be where you access your Fuse Online environment. This URL specifies the project in which you are installing Fuse Online followed by the domain that is specific to your OpenShift cluster.

       In other words, specify the project name followed by the hostname that is associated with the OpenShift route that is used to access Fuse Online. The DNS resolution of the specified hostname must point to the OpenShift Router.

     • --console specifies the full URL for your OpenShift console.

   To learn more about the installation script options, invoke the $ bash install_ocp.sh --help command.

5. 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 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.

Procedure

1. Log in to the OpenShift console.
2. Open the project in which you installed Fuse Online.
3. In the left pane of the OpenShift console, select Applications > Routes.
4. Click the syndesis-prometheus Hostname URL to open the Prometheus dashboard in a new browser tab or window.

Procedure

1. Download the latest Fuse Online release to the current local directory by invoking the following command:

   $ wget https://github.com/syndesisio/fuse-online-install/archive/1.5.tar.gz

2. Uncompress the downloaded file.

3. Change to the directory that contains the extracted archive. For example:

   $ cd fuse-online-install-1.5

4. Log in to OpenShift with an account that has permission to upgrade Fuse Online. For example:

   $ oc login -u developer

5. Invoke the following command, which returns the name of the current project, to ensure that the current project is the project where Fuse Online is installed:

   $ oc project

   If you need to switch to the project where Fuse Online is installed then invoke the following command with the name of the OpenShift project that contains Fuse Online:

   $ oc project project-name

6. To check which version you are about to upgrade to, run the update script with the --version option, as follows:

   $ bash update_ocp.sh --version

7. Invoke the update script as follows:

   $ bash update_ocp.sh

   To learn more about the script, invoke $ bash update_ocp.sh --help.

   During and after an infrastructure upgrade, existing integrations continue to run with the older versions of Fuse Online libraries and dependencies.

8. Upgrade Fuse Online integrations that are running as follows:

   1. In Fuse Online, select the integration that you want to upgrade.
   2. Select Edit.
   3. Select Publish to republish the integration.

   Republishing the integration forces a rebuild that uses the latest Fuse Online dependencies.