The Activation module publishes content from an author instance to a public instance.

Installing

Maven is the easiest way to install the module. Add the following dependency to your bundle:

Error rendering macro 'artifact-maven-dependencies-snippet-macro'

com.sun.jersey.api.client.ClientHandlerException: A message body reader for Java class info.magnolia.sys.confluence.plugin.artifactinfo.nexus.entities.SearchNGResponse, and Java type class info.magnolia.sys.confluence.plugin.artifactinfo.nexus.entities.SearchNGResponse, and MIME media type application/octet-stream was not found

Pre-built jars are also available for download. See Installing a module for help.

  • Error rendering macro 'artifact-resource-macro'

    com.sun.jersey.api.client.ClientHandlerException: A message body reader for Java class info.magnolia.sys.confluence.plugin.artifactinfo.nexus.entities.SearchNGResponse, and Java type class info.magnolia.sys.confluence.plugin.artifactinfo.nexus.entities.SearchNGResponse, and MIME media type application/octet-stream was not found

How activation works

On the author instance, a Syndicator collects the content that needs to be activated. It stores the content into an ActivationContent object. The default BaseSyndicatorImpl can activate content to any public instance that is configured as a subscriber. The configuration details of each subscriber are held in a Subscriber Java bean at runtime. When you trigger an activation command, the syndicator creates an ActivationContent object and sends it to each subscriber. There are two variations of ActivationContent: current content and versioned content. In this context, Content is defined by the filtering Rule used to collect all the child nodes that are still considered to be part of the content for any given activation.

On the public instance, the Activation filter receives the content. The filter acts on the incoming request and saves the data into the repository.

Magnolia supports two methods of activating content

  • Non-recursive activates only the selected node and its properties.
  • Recursive activates the selected node, its properties and its children.

Activation is authenticated using public-key cryptography. See Activation security for more information.

Configuration

The Activation module is configured in Configuration > /modules/activation.

Activate and deactivate commands

Users typically activate content by clicking Publish in the action bar. The click executes an activate command which pushes the content from the author instance to subscriber instances. Conversely, when users click Unpublish the system executes a deactivate command which deletes the content from public instances.

The activate and deactivate commands are configured in /modules/activation/commands. The default catalog contains commands which just publish the content without versioning. Magnolia also provides a versioned command catalog. It contains identically named activate and deactivate commands which first version the content and then delegate to the default commands.

Node nameValue

 
modules


 
activation


 
commands


 
default


 
activate


 
class

info.magnolia.module.activation.commands.ActivationCommand

 
deactivate


 
class

info.magnolia.module.activation.commands.DeactivationCommand

 
versioned


 
activate


 
version


 
class

info.magnolia.commands.impl.VersionCommand

 
enabled

true

 
activate


 
class

info.magnolia.commands.DelegateCommand

 
commandName

default-activate

 
deactivate


 
version


 
class

info.magnolia.commands.impl.VersionCommand

 
enabled

true

 
deactivate


 
class

info.magnolia.commands.DelegateCommand

 
commandName

default-deactivate

To use one of these commands, define the catalog and the command name in the action definition. See an example in Executing commands with actions.

Activation log storage

The activationLogStorage property defines where information about activations are logged. The default implementation MemoryActivationStorage keeps the information in memory.

Node nameValue

 
modules


 
activation


 
config


 
activationLogStorage


 
class

info.magnolia.module.activation.monitor.MemoryActivationStorage

Troubleshooting

#trackbackRdf ($trackbackUtils.getContentIdentifier($page) $page.title $trackbackUtils.getPingUrl($page))