Requirements
An installation where content item staging is enabled has a few additional requirements:
-
Presentation hosts must use a separate
solr
engine from editorial hosts. This is already the recommended configuration for production installations, but if content item staging is enabled then it is an absolute requirement. The Content Engine provides two indexer web services for logging updates to content items: one of them (index
) logs all changes and the other (presentation-index
) excludes changes made to staged content items. Onesolr
engine must be set up to use theindex
web service in order to generate an internal index for use by Content Studio, while the other must be set up to usepresentation-index
and generate an index for use by the presentation layer. For further information, see Search Engine Configuration and Management. -
If your application includes any event listeners, you will probably need to extend them to accept events for staged content items. A new marker interface,
neo.xredsys.api.StagedEventListener
, has been added for this purpose. For detailed instructions, see Handling Staged Content Item Events. -
If your application includes any transaction filters then you will probably need to modify them. The
TransactionFilter
interface has a new method calleddoStagedUpdate()
. The abstract classneo.xredsys.api.services.TransactionFilterService
has also been updated with a "do nothing" implementation of this method. This means that if your transaction filter is based onTransactionFilterService
, it will ignore updates to staged content items unless you add an implementation ofdoStagedUpdate()
to it. If your transaction filter is not based onTransactionFilterService
then failure to add adoStagedUpdate()
implementation will result in manyNoSuchMethod
exceptions. For further information see Transaction Filters. -
If your application includes any post-transaction filters, then they will probably need the same kinds of modifications as transaction filters.