After installation, you're going to get an environment with the following applications:
- Red Hat CloudForms
- Red Hat Ansible Tower
- Locust
- Red Hat Business Central
- Gogs
- Jenkins
- Nexus
- Several Microservices written in Java, .NET, PHP
- Red Hat Mobile Application Platform (aka RHMAP)
Note: A installer called here it's a Ansible Playbook with a set of instructions based on a inventory file (hosts).
-
You need a OpenShift Container Platform (latest version possible) available at your disposal with minimum of 6 Nodes, with a user created named 'demo'. (if you do want to use a different user, please look at step 9).
-
It's important that inside of yours OpenShift Container Platform installation be able to resolve "cloudapps" domain.
# nslookup testing.cloudapps.example.com Server: 8.8.8.8 Address: 8.8.8.8#53 Non-authoritative answer: Name: terra.com.br Address: 208.84.244.112If that doesn't work, RHMAP will definitely fail.
-
You need an active Red Hat Subscription (ideally an Employee SKU) applied to all hosts which allows you to download all the necessary products.
-
You need to be OpenShift System Administrator in order to run this installer.
# oc login --username=system:admin Logged into "https://master.example.com:8443" as "system:admin" using existing credentials.The installer needs Administratives privileges in order to create and setup all the necessary permissions for each application.
-
You need some Persistence Volume (or PV) available at yours OpenShift's Cluster:
# oc get pv NAME CAPACITY ACCESSMODES RECLAIMPOLICY STATUS CLAIM REASON AGE local1-1g-tiny 1Gi RWO,RWX Recycle Available 2d local10-5g-small 5Gi RWO,RWX Recycle Bound rhmap-core/mysql 2d local11-10g-regular 10Gi RWO,RWX Recycle Available 2d local12-10g-regular 10Gi RWO,RWX Recycle Available 2d local13-10g-regular 10Gi RWO,RWX Recycle Available 2d ... .. .In case you don't have Persisent Volumes available at your OpenShift's Cluster, we're providing another playbook that it will create some Persistent Volumes at your OpenShift's Master using NFS. Again, you need root access at your host in order to be able to run this Ansible's playbook. Just type:
# ./create_persistentvolumes.yaml PLAY [Setup a Persistence Volume (PV) on Server: 192.168.0.100 at /var/storage/local] *** TASK [setup] ******************************************************************* ok: [localhost] TASK [Create directory for NFS Exports] **************************************** changed: [localhost] => (item={u'type': u'tiny', u'pv_size': 1, u'pv_index': 1}) changed: [localhost] => (item={u'type': u'tiny', u'pv_size': 1, u'pv_index': 2}) changed: [localhost] => (item={u'type': u'tiny', u'pv_size': 1, u'pv_index': 3}) changed: [localhost] => (item={u'type': u'tiny', u'pv_size': 1, u'pv_index': 4}) ... .. . -
You need to download an Ansible Tower license and leave it at the same directory as the installer: /2016-forum
The file should look like: license_b4451138a1234212ac8476cc756a08e9.txt -
You need to download 3 jar files needed by Business Central and copy then into the folder:
/2016-forum/templates/rhcs-bc/installs/File jboss-eap-6.4.0-installer.jar
https://access.redhat.com/jbossnetwork/restricted/softwareDownload.html?softwareId=37383File jboss-eap-6.4.7-patch.zip
https://access.redhat.com/jbossnetwork/restricted/softwareDownload.html?softwareId=43071File jboss-brms-6.3.0.GA-installer.jar
https://access.redhat.com/jbossnetwork/restricted/softwareDownload.html?softwareId=43631 -
Check the file /2016-forum/hosts and it should match all your hosts of your cluster. In this example, there is a OpenShift's Cluster with 8 hosts named: master.example.com, infra.example.com, node1.example.com, node2.example.com, node3.example.com, node4.example.com, node5.example.com and node6.example.com.
# cat hosts [openshift-hosts] master.example.com infra.example.com node[1:6].example.comAdjust this file accordingly.
-
Check the file /2016-forum/group_vars/all which contains most of the variables necessary to setup all applications. Modfied any information to suit your needs. For example, all applications will be installed for user 'demo'. If you want to be installed on a different user, change the property "username" on this file.
You're ready to run the installer by typing:
```
# ./install.yaml
PLAY [Check if all OpenShift's Hosts is registered using Red Hat's Subscription Manager] ***
TASK [setup] *******************************************************************
ok: [master.example.com]
ok: [infra.example.com]
ok: [node2.example.com]
...
..
.
```
REMEMBER: This installation provisions all the applications, creates all necessary projects inside OpenShift Container Platform and setup all the data in each application. Hence, it might take approximately 50 minutes to get it done.
There is a chance that some installation might fail. In that case, you might want to rerun the whole installer again, or you can always install each application individually. For example, let's suppose that I want to install just CloudForms and Ansible Tower:
```
# ./install.yaml --tags cloudforms,tower
PLAY [Check if all OpenShift's Hosts is registered using Red Hat's Subscription Manager] ***
TASK [setup] *******************************************************************
ok: [master.example.com]
ok: [infra.example.com]
ok: [node2.example.com]
...
..
.
```
... and the equivalent to run the whole installer is:
```
# ./install.yaml --tags cloudforms,tower,locust,tooling,business_central,microservices,rhmap
PLAY [Check if all OpenShift's Hosts is registered using Red Hat's Subscription Manager] ***
TASK [setup] *******************************************************************
ok: [master.example.com]
ok: [infra.example.com]
ok: [node2.example.com]
...
..
.
```