Uploaded image for project: 'OpenNMS'
  1. OpenNMS
  2. NMS-13425

Docs: Add configuration example in tuning activemq

    XMLWordPrintable

    Details

    • HB Backlog Status:
      Doc Backlog

      Description

       

      In the "Multi-tenancy with Horizon and ActiveMQ" section, there's a caution that tells users to update the authorizationPlugin section in the broker's configuration to reflect the updated prefix. It will be clearer if there's an explicit example. There are examples in other configuration so why not this one?

      For instance,

       

      <authorizationPlugin>
        <map>
          <authorizationMap>
            <authorizationEntries>
              <!-- Users in the admin role can read/write/create any queue/topic -->
              <authorizationEntry queue=">" read="admin" write="admin" admin="admin" />
              <authorizationEntry topic=">" read="admin" write="admin" admin="admin"/>
              <!-- Users in the minion role can write/create queues that are not keyed by location -->
              <authorizationEntry queue="<YOUR INSTANCE ID>.*.*" write="minion" admin="minion" />
              <!-- Users in the minion role can read/create from queues that are keyed by location -->
              <authorizationEntry queue="<YOUR INSTANCE ID>.*.*.*" read="minion" admin="minion" />
              <!-- Users in the minion role can read/write/create advisory topics -->
              <authorizationEntry topic="ActiveMQ.Advisory.>" read="minion" write="minion" admin="minion"/>
            </authorizationEntries>
            <!-- Allow all users to read/write/create temporary destinations (by omitting a <tempDestinationAuthorizationEntry>) -->
          </authorizationMap>
        </map>
      </authorizationPlugin>
      

       

       

      Speaking of Multi-tenancy with Horizon and ActiveMQ, it's worth mentioning that minions registered to the respective Horizon must have matching instance id in order for them to work. This is not mentioned in the docs anywhere. For minions, the instance id property would be

       

      CentOS/RHEL

      echo 'org.opennms.instance.id=MyNMS' > "/opt/minion/etc/custom.system.properties"

       

      Debian/Ubuntu

      echo 'org.opennms.instance.id=MyNMS' > "/etc/minion/custom.system.properties"

       

       

        Attachments

          Activity

            People

            Assignee:
            Unassigned Unassigned
            Reporter:
            jylee JianYet
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Dates

              Created:
              Updated:
              Resolved:

                Git Integration