In the properties given below, some properties take a different form when using
CoreMedia Multi-Master Management. In that case, an index number is used
to indicate the publication target that is configured using this property value. The index numbers are consecutive
integers starting with 1 and running up to the number of publication targets.
The protocol used for the connection to the Master Live Server can be either
CORBA (default) or gRPC. Set property repository.use-grpc
on the Content Management Server
for gRPC connection to the Master Live Server
(see Section 3.12.1, “Unified API Spring Boot Client Properties”).
publisher.autoextend.latest-approved-version
Type
Boolean
Default
true
Description
This property affects the automatic extension of publication sets. The
default behavior ("true") is as follows: If the referenced
content item is not published yet, publish its latest (= newest)
approved version. If the referenced content item is already published,
do nothing If set to "false", not the latest but the
earliest approved version is published.
publisher.autoextend.max-failures
Type
Integer
Default
0
Description
The maximum number of implicitly added content items and folders whose
publication may fail before no further content items and folders may
be added implicitly. If set to 0 (the default), the publisher never
stops adding content items and folders.
publisher.autoextend.update-linked-documents
Type
Boolean
Default
false
Description
This property affects the automatic extension of publication sets. By
default, ("false") only direct linked and approved content
items are added to the publication set. If set to "true",
all linked content items are recursively added to the publication set.
The recursion stops when a version is already published and may lead
to surprisingly large publication sets. Setting updateLinkedDocuments
implicitly also sets latestApprovedVersion to "true".
publisher.connection-timeout-seconds
Type
Duration
Default
5m
Description
The timeout duration for the connection to the Master Live Server ior.
publisher.destroy-intermediate-versions
Type
String
Default
strict
Description
Whether intermediate content item versions between two publications
will be destroyed or not on the Content Management Server.
Example for dumb mode: Version 1 of content item A was published. In
the meantime, the versions 2, 3, 4 and 5 have been created. When you
now publish version 5, the versions 2, 3, 4 are destroyed and only
version 1 and 5 remain on the Content Server. Old flags true and false
are supported, too. false maps to off while true maps to strict.
Available Modes
off
Turns destruction of intermediate versions off.
dumb
Simply destroys all versions between the currently published one
and the previously published one; if you run into performance
issues on publication or you do not use a multi-site set up this
should be chosen. Mind that for multi-site set up this setting
might break translation states.
strict
Destroys all versions between the currently published one and the
previously published one, but only if the versions are not
referenced by master/masterVersion properties. This ensures that
for a multi-site set up your translation state will be valid. This
setting is recommended for multi-site set ups.
publisher.destroy-older-versions-on-live-servers
Type
Boolean
Default
true
Description
Whether older published versions should be destroyed
("true") on the Master Live Server. That is, only two
published versions (the current and the one before) of each content
item remain on the Master Live Server. Only change if you have a valid
reason.
publisher.enable-bypass-previews
Type
Boolean
Default
true
Description
Whether publication previews bypass ("true") or not
("false") the publication queue for faster response times.
publisher.local.domain
Type
String
Description
The domain for logging in locally to the Content Management Server.
publisher.local.password
Type
String
Default
publisher
Description
The password for logging in locally to the Content Management Server.
publisher.local.user
Type
String
Default
publisher
Description
The user name for logging in locally to the Content Management Server.
publisher.priority
Type
Map<String,Integer>
Description
Priorities of publications requested through:
guiEditor: 60
uapi: 40
generator: 40
jpython: 20
utility: 20
unknown: 20
publisher.send-session-token-in-url
Type
Boolean
Default
true
Description
If true, the session token for connection to Master
Live Server servlets (for blob up/download and CPU usage) will be sent
as a URL query parameter. Otherwise, it will be sent as a request
field. While sending the token as a query parameter is inherently
insecure, it is the default to keep backward compatibility. Unless
connection to an older server is required, it is recommended to set
this property to false.
The property is active for all publication
targets.
publisher.status-interval
Type
Duration
Default
5m
Description
The duration in between statistics log entries. (Default unit is
seconds)
target is a list-valued property. You configure it with
publisher.target[0].name, for example. Values other than "0"
are only required for the multi-master feature, that is publication to
different Master Live Servers. Target has the following properties:
name
Value: java.lang.String
Default:
Description: The permanent and
unique name of the publication target. Once set, it should never
be changed, as this name is used for target identification in the
APIs and in JMX.
displayName
Value: java.lang.String
Default:
Description: The display name
is shown to users when no localized information about a
publication target is available; display names, too, should be
unique, but they may well change to better illustrate the current
uses of a publication target.
user
Value: java.lang.String
Default: publisher
Description: The user name for
logging in to the Master Live Server.
password
Value: java.lang.String
Default: publisher
Description: The password for
logging in to the Master Live Server.
domain
Value: java.lang.String
Default:
Description: The domain for
logging in to the Master Live Server.
iorUrl (deprecated since 2506.0.0.
Use endpointUrl instead.)
Value: java.lang.String
Default:
Description: The URL where the
publisher can obtain the IOR of the Master Live Server. Only
effective if CORBA is used, i.e., "repository.use-grpc"
is unset or "false".
endpointUrl
Value: java.lang.String
Default:
Description: The URL where the
Publisher can establish communication with the Master Live Server.
Only effective if CORBA is used, i.e.,
"repository.use-grpc" is unset or "false".
grpcEndpoint
Value: java.lang.String
Default:
Description: gRPC address by
which the Publisher can establish communication with the Master
Live Server. Only effective if gRPC is used, i.e.,
"repository.use-grpc=true".
grpcNegotiationType
Value: java.lang.String
Default: plaintext
Description: gRPC negotiation
type to use for communication with the Master Live Server. Only
effective if gRPC is used, i.e.,
"repository.use-grpc=true". Requires additional
configuration when changed.
httpBaseUri
Value: java.lang.String
Default:
Description: HTTP base URI for
blob servlet of Master Live Server. Only required if gRPC is used,
i.e., "repository.use-grpc=true".
folders
Value: java.lang.String
Default:
Description: The base folders
that are assigned to a publication target. This property typically
references exactly one top-level folder, either by name or by its
numerical ID. If more than one site is generated from a single
Live Server, multiple top-level folders may be given, separated by
commas. When indicating a folder by name, that name is blocked for
rename operations on the top-level folder. Once you have assigned
a folder to a publication target, it must not be reassigned to
another target. Doing so would result in inconsistencies between
Content Management Server and Master Live Server.
