Chapter 1. Installation of Fuse Online on OCP

Procedure

1. Download the package that contains the Fuse Online installation scripts from the following location:

   https://github.com/syndesisio/fuse-online-install/releases/tag/1.7

   Unpack the downloaded archive at a convenient location on your file system. The fuse-online-install-1.7 directory contains the scripts and supporting files for installing Fuse Online.

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, go to the fuse-online-install-1.7 directory and 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. If you did not already download the package that contains the Fuse Online installation scripts, download it now from the following location:

   https://github.com/syndesisio/fuse-online-install/releases/tag/1.7

2. Unpack the downloaded archive at a convenient location on your file system. The fuse-online-install-1.7 directory contains the scripts and supporting files for installing Fuse Online.

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

   $ oc login -u developer -p developer

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

   $ oc project

   Alternatively, you can specify the installation project when you run the installation script.

5. 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 perform the default installation and also enable the data virtualization user interface, invoke:

     $ bash install_ocp.sh --datavirt

     Enable the data virtualization user interface in only development environments. Data virtualization lets a Fuse Online developer integrate data from multiple heterogeneous sources to create a virtual database image that is deployable on OpenShift. Applications can run SQL queries on the virtual database, including any non-SQL sources. For details, see the Red Hat Integration data virtualization documentation.

     Important

     Data virtualization is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process. For more information about the support scope of Red Hat Technology Preview features, see https://access.redhat.com/support/offerings/techpreview/.

   • To specify several installation options, you might invoke something like the following command:

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

     • --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. The format of the URL is the name of 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.
     • --datavirt enables the data virtualization user interface, a Technology Preview feature for use in development environments only.

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

6. 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 OpenShift with an account that has permission to install Fuse Online. For example:

   $ oc login -u developer -p developer

2. Ensure that the current project is the project in which Fuse Online is running. To view the current project:

   $ oc project

3. Scale the komodo-server deployment to 1 by invoking:

   oc scale dc komodo-server --replicas 1

   If you upgraded to 7.4 (you ran the update_ocp.sh script and not the install_ocp.sh script) then this is already done. You can skip this step, though invoking this command has no effect.

4. Enable the data virtualization endpoint in the Fuse Online user interface:

   oc edit cm syndesis-ui-config

5. Under datavirt, change enabled 0 to enabled 1, and save.

6. Trigger a new user interface deployment:

   oc rollout latest syndesis-ui

7. Confirm that enabling data virtualization was successful:

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

      Replace openshift-route with the URL for your Fuse Online environment.

   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.

   3. In the left panel, click Data.
   4. On the Data Virtualizations page, you should be able to add data views.