Skip to content

Commit

Permalink
Merge pull request #20 from jbossdemocentral/dm78-upgrade
Browse files Browse the repository at this point in the history
Upgrade to RHDM 7.8 with link to OCP 4.5 installation on CRC.
  • Loading branch information
kmacedovarela authored Sep 28, 2020
2 parents 00d4566 + 9be4582 commit 1bf20b8
Show file tree
Hide file tree
Showing 17 changed files with 410 additions and 657 deletions.
107 changes: 22 additions & 85 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,113 +2,50 @@ Red Hat Decision Manager 7 Install Demo
=======================================
Project to automate the installation of this product without preconfiguration beyond a single admin user.

There are three options available to you for using this demo: local, OpenShift and Docker.
You can install this project on your own machine or on an OpenShift Container Platform.

Software
--------
The following software is required to run this demo:
- [JBoss EAP 7.2 zip archive](https://developers.redhat.com/download-manager/file/jboss-eap-7.2.0.zip)
- [Red Hat Decision Manager: Decision Central 7.7.0 deployable for EAP7](https://developers.redhat.com/download-manager/file/rhdm-7.7.0-decision-central-eap7-deployable.zip)
- [Red Hat Decision Manager: KIE-Server 7.7.0 deployable for EE8](https://developers.redhat.com/download-manager/file/rhdm-7.7.0-kie-server-ee8.zip)
- [7-Zip](http://www.7-zip.org/download.html) (Windows only): to overcome the Windows 260 character path length limit, we need 7-Zip to unzip the Decision Manager deployable.

Installing on local machine
---------------------------
1. [Download and unzip](https://github.com/jbossdemocentral/rhdm7-install-demo/archive/master.zip)
or [clone this repo](https://github.com/jbossdemocentral/rhdm7-install-demo.git).

Option 1 - Install on your machine
----------------------------------
1. [Download and unzip](https://github.com/jbossdemocentral/rhdm7-install-demo/archive/master.zip) or [clone this repo](https://github.com/jbossdemocentral/rhdm7-install-demo.git).
2. Add products to installs directory, see installs/README for details and links.

2. Add the EAP zip archive and Decision Manager deployables to the installs directory.
3. Run 'init.sh' or 'init.bat' file. 'init.bat' must be run with Administrative privileges

3. Run `init.sh` (Linux/macOS) or `init.ps1` (Windows) file.
Follow install output instructions and log in to http://localhost:8080/decision-central (u:dmAdmin / p:redhatdm1!)

4. Start the runtime: `./target/jboss-eap-7.1/bin/standalone.sh'` (Linux/macOS) or `.\target\jboss-eap-7.1\bin\standalone.ps1` (Windows)
Kie Servier access configured (u: kieserver / p:kieserver1!)

5. Login to Decision Central at: http://localhost:8080/decision-central (u:dmAdmin / p:redhatdm1!)
Enjoy installed and configured Red Hat Decision Manager.

6. Enjoy the installed and configured Red Hat Decision Manager 7.

Installing on OpenShift Container Platform (CodeReady Containers)
----------------------------------------------------------------
Install this demo on your local machine using an OpenShift Container Platform development cluster can be
done using CodeReady Continers. It's fully automated and delivers a fully functioning container-native
development experience:

Option 2 - Run on OpenShift
-----------------------------------------
This demo can be installed on Red Hat OpenShift in various ways. We'll explain the different options provided.
[CodeReady Containers Red Hat Decision Manager Easy Install Demo](https://gitlab.com/redhatdemocentral/rhcs-rhdm-install-demo)

All installation options require an `oc` client installation that is connected to a running OpenShift instance. More information on OpenShift and how to setup a local OpenShift development environment based on the Red Hat Container Development Kit can be found [here](https://developers.redhat.com/products/cdk/overview/).

---
**NOTE**

The Red Hat Decision Manager 7 - Decision Central image requires a [Persistent Volume](https://docs.openshift.com/container-platform/3.7/architecture/additional_concepts/storage.html) which has both `ReadWriteOnce` (RWO) *and* `ReadWriteMany` (RWX) Access Types. If no PVs matching this description are available, deployment of that image will fail until a PV of that type is available.

---

### Automated installation
This installation option will install the Decision Manager 7 and Decision Service in OpenShift using a single script, after which the demo project needs to be manually imported.

1. [Download and unzip](https://github.com/jbossdemocentral/rhdm7-install-demo/archive/master.zip) or [clone this repo](https://github.com/jbossdemocentral/rhdm7-install-demo.git).

2. Run the `init-openshift.sh` (Linux/macOS) or `init-openshift.ps1` (Windows) file. This will create a new project and application in OpenShift.

3. Login to your OpenShift console. For a local OpenShift installation this is usually: https://{host}:8443/console

4. Open the project "RHDM7 Install Demo". Open the "Overview" screen. Wait until the 2 pods, "rhdm7-install-rhdmcentr" and "rhdm7-install-kieserver" have been deployed.

5. Open the "Applications -> Routes" screen. Click on the "Hostname" value next to "rhdm7-install-rhdmcentr". This opens the Decision Central console.

6. Login to Decision Central (u:dmAdmin, p:redhatdm1!)

7. Enjoy the installed and configured Red Hat Decision Manager 7.


### Scripted installation
This installation option will install the Decision Manager 7 and Decision Service in OpenShift using the provided `provision.sh` (Linux/macOS) or `provision.ps1` (Windows) script, which gives the user a bit more control how to provision to OpenShift.

1. [Download and unzip.](https://github.com/jbossdemocentral/rhdm7-install-demo/archive/master.zip) or [clone this repo](https://github.com/jbossdemocentral/rhdm7-install-demo.git).

2. In the demo directory, go to `./support/openshift`. In that directory you will find the `provision.sh` (Linux/macOS) and `provision.ps1` (Windows) script.

3. Run `./provision.sh -h` (Linux/macOS) or `./provision.ps1 -h` (Windows) to inspect the installation options.

4. To provision the demo, with the OpenShift ImageStreams in the project's namespace, run `./provision.sh setup rhdm7-install --with-imagestreams` (Linux/macOS) or `./provision.sh -command setup -demo rhdm7-install -with-imagestreams` (Windows)

---
**NOTE**

The `with-imagestreams` parameter installs the Decision Manager 7 image streams and templates into the project namespace instead of the `openshift` namespace (for which you need admin rights). If you already have the required image-streams and templates installed in your OpenShift environment in the `openshift` namespace, you can omit the `with-imagestreams` from the setup command.

---

5. A second useful option is the `--pv-capacity` (Linux/macOS)/ `-pv-capacity` (Windows) option, which allows you to set the capacity of the _Persistent Volume_ used by the Decision Central component. This is for example required when installing this demo in OpenShift Online, as the _Persistent Volume Claim_ needs to be set to `1Gi` instead of the default `512Mi`. So, to install this demo in OpenShift Online, you can use the following command: `./provision.sh setup rhdm7-install --pv-capacity 1Gi --with-imagestreams` (Linux/macOS) or `./provision.ps1 -command setup -demo rhdm7-install -pv-capacity 1Gi -with-imagestreams` (Windows).

6. After provisioning, follow the instructions from above "Option 2 - Automated installation, manual project import", starting at step 3.

7. To delete an already provisioned demo, run `./provision.sh delete rhdm7-install` (Linux/macOS) or `./provision.ps1 -command delete -demo rhdm7-install` (Windows).


Option 3 - Run in Docker
-----------------------------------------
The following steps can be used to configure and run the demo in a container

1. [Download and unzip](https://github.com/jbossdemocentral/rhdm7-install-demo/archive/master.zip) or [clone this repo](https://github.com/jbossdemocentral/rhdm7-install-demo.git).

2. Add the EAP zip archive and Decision Manager deployables to the installs directory.

3. Run the `init-docker.sh` (Linux/macOS) or `init-docker.ps1` (Windows) file.

4. Start the container: `docker run -it -p 8080:8080 -p 9990:9990 jbossdemocentral/rhdm7-install-demo`

5. Login to Decision Central at: http://<CONTAINER_HOST>:8080/decision-central (u:dmAdmin / p:redhatdm1!)

7. Enjoy the installed and configured Red Hat Decision Manager 7.
Installing on any OpenShift Container Platform (generic)
-------------------------------------------------------
This demo can be installed on your own version of OpenShift Container Platform. Options and guidance can
be found in the [openshift support directory README](support/openshift/README.md)


Supporting Articles
-------------------
- [Getting Started with Red Hat Decision Manager 7](https://developers.redhat.com/blog/2018/03/19/red-hat-decision-manager-7/)


Released versions
-----------------
See the tagged releases for the following versions of the product:

- v1.6 - Red Hat Decision Manager 7.8.0 GA
- v1.5 - Red Hat Decision Manager 7.7.0 GA
- v1.4 - Red Hat Decision Manager 7.5.0.GA
- v1.3 - Red Hat Decision Manager 7.3.0.GA
Expand Down
Binary file modified docs/demo-images/rhdm7.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
91 changes: 0 additions & 91 deletions init-docker.ps1

This file was deleted.

102 changes: 0 additions & 102 deletions init-docker.sh

This file was deleted.

23 changes: 0 additions & 23 deletions init-properties.ps1

This file was deleted.

21 changes: 0 additions & 21 deletions init-properties.sh

This file was deleted.

Loading

0 comments on commit 1bf20b8

Please sign in to comment.