This repository contains a Tekton pipelines to deploy Maximo using mas-ansible.
An IBM Technology Zone deployer cluster is assumed to be configured with an appropriate Red Hat OpenShift version for the Maximo version you wish to deploy, with appropriate sizing. Refer to Maximo Product Documentation for more information.
A deployer cluster can be created by installing the Deployer Operator from TechZone
If deploying on TechZone the entitlement key is provided from the TechZone Secrets Repo. If deploying in a non-techzone cluster you will need to provide an entitlement key for the pipelinerun.
Documentation for obtaining an entitlement key here: https://www.ibm.com/docs/en/cloud-paks/1.0?topic=clusters-obtaining-your-entitlement-key
To activate Maximo you will need a valid license key which is a text file that contains software authorizations and entitlements. This pipeline in order to run automatically will need this file to be base64 encoded and saved in a kubernetes secret.
- save the license file to a file locally such as license.dat.
- Use a tool to base64 encode the file such as "
cat license.dat | base64 > license.dat.b64
- copy the output into an OpenShift secret in the default namespace
oc create secret generic maximolicense --from-file=licensefile=license.dat.b64 -n default
remember the name of the secret for the pipeline run. ( in the example above "maximolicense" is the name)
Maximo is deployed with a Tekton Pipeline that is defined in pipeline.yaml
the pipeline runs the MAS DevOps playbooks and can be modified or extended using other roles and playbooks.
Consult the documentation for MAS DevOps here
switch to version directory of choice and run these commands
oc apply -f pipeline.yaml
oc create -f pipeline-run.yaml
In testing we have seen the pipeline take from 2-6 hours to progress from installation of operators to active instances of the software. please be patient.
The pipeline is fully idempotent and can be restarted as needed.
the pipeline looks for a lets-encrypt cert previously generated by upstream automation and if found uses this cert for maximo public routes. This cert may not have all maximo paths enabled by default. If you encounter a non-trusted certificate you may have to open the path in a separate browser window and accept the cert.