MAS DevOps Ansible Collection Ansible CLI
Home Roles: Suite Mgmt suite_manage_birt_report_config Role Variables Example Playbook Run Role Playbook License

suite_manage_birt_report_config¤

This role extends support for configuring Birt Report in Manage application as a separate and dedicated report bundle server workload.

The following Manage properties will be added to every and each Manage server bundle:

  • mxe.report.birt.viewerurl= https://{{ mas_workspace_id }}-{{ manage_report_bundle_server_name }}.manage.{{ mas_domain }}
  • mxe.report.birt.disablequeuemanager= 0 (if bundle type = report) or 1 (if bundle type != report)

The goal for this role is to setup the specific Manage Report route to be the endpoint for the generated reports in Manage (which will forward the report workload to the dedicated report type bundle pod).

Role Variables¤

mas_instance_id¤

The instance ID of Maximo Application Suite. This will be used to lookup for Manage application resources.

  • Required
  • Environment Variable: MAS_INSTANCE_ID
  • Default: None

mas_workspace_id¤

The workspace ID of Maximo Application Suite. This will be used to lookup for Manage application resources.

  • Required
  • Environment Variable: MAS_WORKSPACE_ID
  • Default: None

manage_workspace_cr_name¤

Name of the ManageWorkspace Custom Resource that will be targeted to configure the new PVC definitions.

  • Optional
  • Environment Variable: MANAGE_WORKSPACE_CR_NAME
  • Default: $MAS_INSTANCE_ID-$MAS_WORKSPACE_ID

manage_report_bundle_server_name¤

Name of the Manage report bundle server. It will be used to configure the Manage's report bundle server and its corresponding route. Not needed if the report bundle server is already configured.

  • Optional
  • Environment Variable: MANAGE_REPORT_BUNDLE_SERVER_NAME
  • Default: rpt

Example Playbook¤

The following sample can be used to configure BIRT report for an existing Manage application instance.

- hosts: localhost
  any_errors_fatal: true
  vars:
    mas_instance_id: masinst1
    mas_workspace_id: main
  roles:
    - ibm.mas_devops.suite_manage_birt_report_config

Run Role Playbook¤

After installing the Ansible Collection you can easily run the role standalone using the run_role playbook provided.

export MAS_INSTANCE_ID=masinst1
export MAS_WORKSPACE_ID=main
export MANAGE_REPORT_BUNDLE_SERVER_NAME=report
ROLE_NAME='suite_manage_birt_report_config' ansible-playbook playbooks/run_role.yml

License¤

EPL-2.0