com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_link3' is unknown.

Supporting Different Transports

Follow the steps mentioned below to add support for each transport type

MQTT Transport

  1. Download MQTT client library (mqtt-client-0.4.0.jar).
  2. Add the JAR to the <PRODUCT_HOME>/repository/components/lib/ directory.

Kafka Transport

  1. Download Apache Kafka server

    This guide uses Kafka  2.10-0.8.2.1  version.

  2. Copy the following client JAR files from <KAFKA_HOME>/libs/ directory  to <PRODUCT_HOME>/repository/components/lib/ directory.
    • kafka_2.10-0.8.2.1.jar
    • zkclient-0.3.jar
    • scala-library-2.10.4.jar
    • zookeeper-3.4.6.jar
    • metrics-core-2.2.0.jar
    • kafka-clients-0.8.2.1.jar  

The above jars are the client jars for Kafka 2.10-0.8.1. If you want to use the client jars for Kafka_2.10-0.9.0.1 or Kafka_2.11-0.9.0.1, the following needs to be done.

  1. Copy the following client JAR files from <KAFKA_HOME>/lib/ directory  to <PRODUCT_HOME>/repository/components/lib/ directory.
    • kafka_2.11-0.9.0.1.jar
    • kafka-clients-0.9.0.1.jar
    • metrics-core-2.2.0.jar
    • scala-library-2.11.7.jar
    • scala-parser-combinators_2.11-1.0.4.jar
    • zkclient-0.7.jar
    • zookeeper-3.4.6.jar
  2. Download the jass.conf file and save it in the <PRODUCT_HOME>/repository/conf/identity directory.

Kafka_2.10-0.9.0.1 is backward compatible. Therefore, you can use Kafka_2.10-0.8.2.1 client jars to connect with Kafka_2.10-0.9.0.1.

SMS Transport

  1. Download and copy following libraries to <PRODUCT_HOME>/repository/components/lib/ directory.

JMS Transport

Follow the steps to configure Apache ActiveMQ message broker

  1. Install  Apache ActiveMQ JMS

    This guide uses ActiveMQ versions 5.7.0 - 5.9.0. If you want to use a later version, for instructions on the necessary changes to the configuration steps, go to  Apache ActiveMQ Documentation .

  2. Add the following ActiveMQ JMS-specific JAR files to  the <PRODUCT_HOME>/repository/components/lib/ directory. 
    • <ACTIVEMQ_HOME>/ lib/geronimo-j2ee-management_1.1_spec-1.0.1.jar
    • <ACTIVEMQ_HOME>/lib/activemq-core-x.x.x.jar (for 5.7.0 and below)
    • <ACTIVEMQ_HOME>/ lib/hawtbuf-1.9.jar  (for 5.8.0 and above)
    • <ACTIVEMQ_HOME>/lib/activemq-client-x.x.x.jar (for 5.8.0 and above)

Follow the steps to configure Apache Qpid message broker

  1. Install JMS-Qpid Broker and JMS-Qpid Client.

    This guide uses Apache Qpid version 0.32. For more instructions on Apache Qpid go to Qpid documentation.

  2. Add the following Qpid JMS-specific JAR files to  <PRODUCT_HOME>/repository/components/lib/ directory.  
    • <QPID-CLIENT_HOME>/lib/geronimo-jms_1.1_spec-1.1.1.jar   
    • <QPID-CLIENT_HOME>/lib/qpid-client-0.32.jar
    • <QPID-CLIENT_HOME>/lib/qpid-common-0.32.jar

Follow the steps to configure WSO2 Message Broker (MB) 

  1. Download and install WSO2 Message Broker. For instructions on WSO2 MB, go to Message Broker documentation

    This guide uses WSO2 Message Broker (MB) version 3.1.0.

  2. Add the following JMS -specific JAR files to  <PRODUCT_HOME>/repository/components/lib/ directory. 

    • <MB_HOME>/client-lib/andes-client-3.1.1.jar   
    • <MB_HOME>/client-lib/log4j-1.2.13.jar
    • <MB_HOME>/client-lib/slf4j-1.5.10.wso2v1.jar
    • <MB_HOME>/client-lib/geronimo-jms_1.1_spec-1.1.0.wso2v1.jar

Follow the steps to configure TIBCO EMS Server

  1. Download and install TIBCO Enterprise Message Service. For more information on installing, go to TIBCO documentation.

    This guide uses TIBCO EMS Server version 8.2.0 V7

  2. Add the following JMS -specific JAR files to  <PRODUCT_HOME>/repository/components/lib/ directory. 
    • <TIBCO_EMS_HOME>/lib/jms-2.0.jar
    • <TIBCO_EMS_HOME>/lib/tibjms.jar

    You need to remove the line javax.jms in launch.ini file which is located in <CEP_HOME>/repository/conf/etc to avoid OSGI package path conflicts as below.

     

    org.osgi.framework.system.packages=javax.accessibility,\
    javax.activity,\
    ...

    javax.imageio.stream,\
    javax.management,\

    ...

com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_links2' is unknown.