MAS DevOps Ansible Collection Ansible CLI
Edit on GitHub Home Ansible Automation Platform OCP Install Cloud Pak For Data Install Core Add AIBroker Add IoT Add Manage Add Monitor Add Optimizer Add Predict Add Visual Inspection Update Upgrade Uninstall Core Backup & Restore ocp_cluster_monitoring ocp_config ocp_deprovision ocp_efs ocp_github_oauth ocp_login ocp_node_config ocp_provision ocp_roks_upgrade_registry_storage ocp_upgrade ocp_verify appconnect aws_bucket_access_point aws_documentdb_user aws_policy aws_route53 aws_user_creation aws_vpc cert_manager cis common-services configure_manage_eventstreams cos cos_bucket cp4d_admin_pwd_update cp4d cp4d_service db2 dro eck grafana ibm_catalogs kafka nvidia_gpu mongodb ocs sls turbonomic uds mirror_case_prepare mirror_extras_prepare mirror_images mirror_ocp ocp_idms ocp_simulate_disconnected_network registry suite_app_config suite_app_install suite_app_uninstall suite_app_upgrade suite_app_rollback suite_app_backup_restore suite_certs suite_config suite_db2_setup_for_manage suite_dns suite_install suite_manage_attachments_config suite_manage_birt_report_config suite_manage_bim_config suite_manage_customer_files_config suite_manage_imagestitching_config suite_manage_import_certs_config suite_manage_load_dbc_scripts suite_manage_logging_config suite_manage_pvc_config suite_uninstall suite_upgrade suite_rollback suite_verify suite_backup_restore ansible_version_check entitlement_key_rotation gencfg_jdbc gencfg_watsonstudio gencfg_workspace gencfg_mongo
Home Roles: Dependency Mgmt appconnect Role Variables - Installation Role Variables - Configuration Role Variables - MAS Configuration Example Playbooks License

appconnect¤

Installs IBM AppConnect and generates configuration that can be directly applied to IBM Maximo Application Suite.

This dependency is required by the Health and Predict Utilities application:

HP Utilities AppConnect License Dashboard Versions
v8.4 v4.1 - v5.2 L-APEH-C9NCK6 12.0.4.0-r1, 12.0.4.0-r2
v8.3 v3.0 - v4.2 L-KSBM-C87FU2 12.0.2.0-r2
v8.2 v1.5 - v3.1 L-KSBM-C37J2R 12.0.1.0-r1, 12.0.1.0-r2

For more information review the licensing reference for IBM App Connect Operator.

Important

All defaults in this role are currently set for compatability with HP Utilities version 8.4. If you are installing App Connect for use with older release of HP Utilities then you must set the appconnect_channel and appconnect_license_id variables (and it would be sensible to customize appconnect_dashboard_name as well).

Role Variables - Installation¤

ibm_entitlement_key¤

Provide your IBM entitlement key.

appconnect_entitlement_username¤

An IBM entitlement key specific for AppConnect installation, primarily used to override ibm_entitlement_key in development.

appconnect_namespace¤

Defines the targetted cluster namespace/project where AppConnect will be installed. If not provided, default AppConnect namespace will be ibm-app-connect.

appconnect_channel¤

Subscription channel, this must align with the version of HP Utilities (see table above).

Role Variables - Configuration¤

appconnect_storage_class¤

Storage class where AppConnect will be installed - for IBM Cloud clusters, ibmc-file-gold-gid must be used as per documentation.

appconnect_dashboard_name¤

AppConnect dashboard instance name. Defaults to dashboard-12040r2 as a reference to AppConnect Dashboard version 12.0.4.0-r2 that is compatible with the default subscription channel and license ID.

appconnect_dashboard_version¤

AppConnect dashboard version, this must align with the License ID used.

appconnect_license_id¤

AppConnect license ID.

Role Variables - MAS Configuration¤

mas_instance_id¤

The instance ID of Maximo Application Suite that the AppConnect configuration will target. If this or mas_config_dir are not set then the role will not generate an AppConnect template.

mas_config_dir¤

Local directory to save the generated AppConnect resource definition. This can be used to manually configure a MAS instance to connect to AppConnect instance, or used as an input to the suite_config role. If this or mas_instance_id are not set then the role will not generate an AppConnect template.

custom_labels¤

List of comma separated key=value pairs for setting custom labels on instance specific resources.

Example Playbooks¤

Install IBM App Connect for the latest release of HP Utilties (v8.4)¤

- hosts: localhost
  any_errors_fatal: true
  vars:
    ibm_entitlement_key: xxx
  roles:
    - ibm.mas_devops.ibm_catalogs
    - ibm.mas_devops.appconnect

Install IBM App Connect for HP Utilties v8.3¤

- hosts: localhost
  any_errors_fatal: true
  vars:
    ibm_entitlement_key: xxx
    appconnect_channel: v4.2
    appconnect_license_id: L-KSBM-C87FU2
    appconnect_dashboard_name: dashboard-12020r2
  roles:
    - ibm.mas_devops.ibm_catalogs
    - ibm.mas_devops.appconnect

License¤

EPL-2.0