このコンテンツは選択した言語では利用できません。
Chapter 9. Installing Fuse Online on OpenShift Container Platform
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:
A user with cluster administration permissions:
- Registers a custom resource definition (CRD) at the cluster level.
- Grants permission for a user to install Fuse Online in their projects.
A user who is granted permission to install Fuse Online:
- Ensures that all prerequisites are met.
- 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.
- Downloads the installation script.
- Invokes the installation script with the command that implements decisions.
- 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
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.shTo verify that you are properly connected and can list custom resource definitions, invoke the following command:
$ oc get crdTo register the custom resource definition at the cluster level, invoke the following command:
$ bash install_ocp.sh --setupGrant 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 todeveloperto install Fuse Online into any project that thedeveloperaccount can access on the currently connected cluster:$ bash install_ocp.sh --grant developer --clusterRepeat 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:
Log in with an account that has permission to install Fuse Online. For example:
$ oc login developerEnsure that the current project is the project into which you want to install Fuse Online:
$ oc projectIn 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
--projectoption. The argument is the name of the project in which you want to install Fuse Online. -
Specify the
--routeoption. 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
--consoleargument 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/consoleAccording 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.
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:
Display the OpenShift OAuth proxy log-in page at
https://openshift-routeIf you specified the
--routeoption when you ran the installation script, replaceopenshift-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. Replaceopenshift-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 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.
