Important

You are browsing the documentation for version 3.1 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Configure Jobs in the Back-Office

A job is additional information about the message processing task added to the Oro application DB. It allows to view the information about the task (job) in the admin UI and to manage the job (view the status and cancel it) in the UI.

You can view the statuses and statistics for the jobs by navigating to System > Jobs in the main menu in the back-office of all Oro applications.

Asynchronous Jobs Processing

Some tasks need to be executed in the background and/or paralleled, and Oro Message Queue is used for this.

Message queues provide an asynchronous communications protocol, meaning that the sender and the receiver of the message do not need to interact with the message queue at the same time. Messages placed onto the queue are stored until the recipient retrieves them. A message does not have information about the previous and the next messages.

Messages are processed by one or more consumers that work in the background. Consumer(s) are run by the following command:

    $ bin/console oro:message-queue:consume --env prod

A message processor can create a job in the database during processing. Jobs allow to monitor processing status, progress, a user can interrupt a job. Also, a job can create a set of sub-jobs to split a big task to a set of sub-tasks to run them in parallel.

Documentation on Message Queue implementation, including information on messages, jobs, consumers, etc., can be found in OroMessageQueueComponent and OroMessageQueueBundle.