Message archive service

Magento2 uses message archive service to save incoming and outgoing JSON messages.

All the connectors send messages to queue. Message archive service fetches the message from the queue and saves to the disk at the following location. 
fileStoragePath/companyId/connectorName/dayOfMonth/fileName.extension
You can mount this folder to docstore.

Installing the connector

Proceed as follows to install the connector:

  1. Browse to the $TOP_CONNECTOR/connectors folder.
  2. Locate and extract the ipm12_connectors_12.0.0.X_YYYYDDMMZZZ.tar.gz base file.
  3. Set the $TOP_CONNECTOR environment variable to point to the extracted folder:
    export $TOP_CONNECTOR=/opt/connectors/mdmce-connectors
  4. Enable the connector in the $TOP_CONNECTOR/conf/connector_settings.ini file.
  5. Run the installer script.
    cd $TOP_CONNECTOR
cd bin ./install.sh
  6. Update the application.properties file located in the following folder:

    $TOP_CONNECTOR/connectors/mdmce-message-archive-service/conf

    For more information, see Updating properties file.
  7. Start the connector from the $TOP_CONNECTOR/connectors/bin folder:
    ./start_connectors.sh message-archive-service
    ./start_connectors.sh -all
    Stop the connector through the following command:
    ./stop_connectors.sh -all or ./stop_connectors.sh message-archive-service
  8. Check status of the connector through the following command:
    ./status_connectors.sh -all or ./status_connectors.sh message-archive-service

Updating properties file

You need to update the following parameters in the application.properties file.
Hazelcast client configuration
hazelcast.groupName=mdmce-hazelcast-instance
hazelcast.networkIpAddress=<hazelcasthostaddress>:5702
hazelcast.itemQueueUri=hazelcast-seda:message_archive_app_queue?pollTimeout=1000&concurrentConsumers=5&transferExchange=false&transacted=false&hazelcastInstance=hazelcastInstance
File storage path on disk
app.fileStoragePath=