Page History

Anchor
top
top

Note
Some of the default values for settings configurable on the General tab should not be changed. If you are unsure what the value for a specific setting should be, contact your GX Software consultant. In a multi-channel configuration, each channel has its own configuration set with the name <configuration_set_name> (name) where "name" is the ID of the channel.

In This Topic

Table of Contents

maxLevel	2
minLevel	2

application_settings

Property Description

add_csrf_token_header_to_external_responses

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R33.

When enabled, an X-CSRF-Token header is included in the response to GET requests from external domains, which must be used in a subsequent POST or PUT request. The exposed_headers and allowed_http_headers settings in the corsfilter section (below) must also be set to "X-CSRF-Token". See Security Guidelines for Developers for more information.

channels_using_fallback Specifies the channel(s) that use the default design configuration when no custom JSP can be found for it.

clusternode_eventlistener_heartbeat_ms

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version 10.22.1.

Specifies how often, in milliseconds, the cluster event service listens for events on other servers in the cluster.

clusternode_registration_heartbeat_ms

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version 10.22.1.

Specifies how often, in milliseconds, the cluster event service checks for multiple active sessions for the same XperienCentral user. See Active Sessions for more information,

contentindex_index_readonly_nodes

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R37.

If the Search & Retrieve API is used on a clustered environment, this setting should be enabled, otherwise the API will not return any results. When this setting is enabled, the content index must be rebuilt.

content_item_lock_poll_interval A content locking poll thread that checks whether a content item lock is expired. If so, the lock is removed. The value is in milliseconds.

content_item_lock_timeout Specifies the number of milliseconds that have to elapse after a lock on a content item has been claimed before the lock is closed.

contentindex_location The directory where the content index and its configuration are stored.

contentindex_optimize_schedule The Crontab schedule that dictates when the content index is optimized. This should be set to happen at least once a day, preferably at the time that website activity is at its lowest (typically at night).The Crontab schedule used is a variant of the standard UNIX Crontab scheduler with a "seconds" field prefixed to the beginning. For complete information on scheduling jobs in XperienCentral, see Scheduling Jobs.

contentindex_queue_database_entries_schedule The Crontab schedule that dictates when to put database entities in the queue for the search indexing. The Crontab schedule used is a variant of the standard UNIX Crontab scheduler with a "seconds" field prefixed to the beginning. For complete information on scheduling jobs in XperienCentral, see Scheduling Jobs.

contentindex_queue_empty_reindex Specifies whether to disable the regeneration of the full background index when the queue is empty. Because a full index regeneration is performed regularly according to the contentindex_queue_reindex_schedule, you might want to block a full index generation at other times for performance reasons.

contentindex_queue_iteration_limit The maximum batch size for each poller iteration. The default is 100. The larger the number, the greater the impact is on performance.

contentindex_queue_janitor_schedule The Crontab schedule that dictates when the index journal is cleaned up. The Crontab schedule used is a variant of the standard UNIX Crontab scheduler with a "seconds" field prefixed to the beginning. For complete information on scheduling jobs in XperienCentral, see Scheduling Jobs.

contentindex_queue_poller_schedule The Crontab schedule that dictates when the index journal is polled for changes. The more frequently this is performed, the more up to date the index will be. Note that each cycle must be able to finish before the next begins. The Crontab schedule used is a variant of the standard UNIX Crontab scheduler with a "seconds" field prefixed to the beginning. For complete information on scheduling jobs in XperienCentral, see Scheduling Jobs.

contentindex_queue_reindex_schedule The Crontab schedule that dictates the triggering of a full background index. This should happen no more then once a day, preferably at the time that website activity is at its lowest (typically at night). The Crontab schedule used is a variant of the standard UNIX Crontab scheduler with a "seconds" field prefixed to the beginning. For complete information on scheduling jobs in XperienCentral, see Scheduling Jobs.

context_static

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was removed from XperienCentral in version R36. Use the setting application_settings.static_files_url instead.

The root URL of the static web application. In XperienCentral versions R36 and higher, use the setting static_files_url instead.

Anchor

	create_content_revisions
	create_content_revisions

create_content_revisions

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R29.

Specifies whether XperienCentral automatically creates revisions of content items. See Reverting a Content Item for more information. See also the settings max_age and schedule.

csrf_ignore_url_paths_regex

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R33.1.

Specifies the URL paths that are not checked for CSRF vulnerabilities. Define the excluded URLs using a Regular Expressions that matches the URL path, excluding the context path. For example, to disable the protection for all requests to "myservlet" (https://mydomain.com/web/myservlet/foo/bar?q=xxx), add an expression like the following:

/myservlet(/.*)?

Warning
Exempting URLs from the CSRF checks weakens the security of your channel(s), therefore you should exercise caution with this setting.

current_rollover_detector_schedule The Crontab schedule that dictates when the rollover detector service runs. The detector service detects changes in the outcome of ContentItem.getCurrent(Language) and if any is detected, it updates the caching timestamps and friendly URLs. The Crontab schedule used is a variant of the standard UNIX Crontab scheduler with a "seconds" field prefixed to the beginning. For complete information on scheduling jobs in XperienCentral, see Scheduling Jobs.

date_format The format in which dates are represented (for example, dd-MM-yyyy).

default_timezone

Specify the default time zone for the XperienCentral installation. The time zone you specify is the absolute time upon which all timestamps in XperienCentral are based (creation date, publication date, expiration date, etc.). When users select their own time zone in My Settings, the time zone they select is calculated as an offset based on the default XperienCentral time zone. The following are the most commonly used time zones. For the full list of acceptable time zones, see http://en.wikipedia.org/wiki/List_of_tz_database_time_zones.

Time Zone	Value
Amsterdam	Europe/Amsterdam
Berlin	Europe/Berlin
Istanbul	Europe/Istanbul
London	Europe/London
Lisbon	Europe/Lisbon
Moscow	Europe/Moscow
Atlantic time	Canada/Atlantic
Eastern time	America/New_York
Central time	America/Chicago
Mountain time	America/Edmonton
Pacific time	America/Los_Angeles
Alaska time	America/Anchorage
Hawaiian time	America/Hawaii
India	Asia/Calcutta
China	Asia/Shanghai
Japan	Japan
Western Standard time	Australia/Perth
Central Standard time	Australia/North
Lord Howe Standard time	Australia/LHI

enable_non_jndi_database_configuration Select this option if you are using a non-JNDI database for your XperienCentral project.

form_handler_base Specifies the URL where the definitions for Interactive Forms are located.

google_sitemap_automatic_upload

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R33.

Specifies whether XperienCentral automatically uploads generated sitemaps to Google. When enabled, if a Google sitemap is generated, it is automatically uploaded according to the schedule configured in the setting google_sitemap_generator_schedule. When disabled, the latest generated sitemap is not uploaded.

google_sitemap_generator_schedule The Crontab schedule that dictates when the Google sitemap will be generated. The Crontab schedule used is a variant of the standard UNIX Crontab scheduler with a "seconds" field prefixed to the beginning. For complete information on scheduling jobs in XperienCentral, see Scheduling Jobs.

http_non_proxy_hosts

Specifies the hosts that should be directly contacted for requests via HTTP and HTTPS (not through the proxy server). You can enter multiple host names separated by the pipe character (|) and also use wildcards. For example:

*.wm.com|localhost

Note

title	Notes

This setting also applies to HTTPS requests even though the name of the setting suggests that it only applies to HTTP requests. This has to do with how Java itself is structured. See Networking Properties (Oracle documentation).
If you use a proxy, GX Software recommends that you always add the host names of the XperienCentral front-end and backend servers to this list.

http_proxy_host The name of the HTTP proxy host server to use to send requests to the XperienCentral server.

http_proxy_password The password to use to log in to the proxy host via HTTP. If no password is required, leave this field blank.

http_proxy_port The port number to connect to on the HTTP proxy host.

http_proxy_username The username to use on the HTTP proxy host.

http_use_proxy

Specifies whether to use one or more proxy servers to log in to the XperienCentral server.

Note
Beginning in XperienCentral R26, proxy system properties set outside of XperienCentral are no longer overwritten when this setting is clear (false).

https_proxy_host

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R26.

The name of the HTTPS proxy host server to use to send requests to the XperienCentral server.

https_proxy_password

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R26.

The password to use to log in to the proxy host via HTTPS. If no password is required, leave this field blank.

https_proxy_port

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R26.

The port number to connect to on the HTTPS proxy host.

https_proxy_username

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R26.

The username to use on the HTTPS proxy host.

https_use_http_page_links

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R26.

When this setting is enabled, a visitor will use HTTP to link to a page even if the Use HTTPS setting for that page is enabled.

https_use_proxy

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R26.

Specifies whether to use one or more proxy servers to log in to the XperienCentral server. Proxy system properties set outside of XperienCentral are not overwritten when this setting is clear (false).

internal_backend_address For use with IBM WebSphere. Contact your GX Software consultant for more information.

internal_frontend_address For use with IBM WebSphere. Contact your GX Software consultant for more information.

internal_http_authentication_password The password to use in conjunction with the username (below) for connections XperienCentral makes with itself through the front- or backend.

internal_http_authentication_username The username to use for connections XperienCentral makes with itself through the front or backend.

internal_http_use_authentication Specifies whether to use a username/password combination for authenticating connections that XperienCentral makes with itself through the front or backend.

internal_http_use_form_authentication Specifies whether internal HTTP connections use HTTP form

jcr_datastore_cleaner_schedule

The Crontab schedule that dictates when the JCR datastore cleaner runs. The Crontab schedule used is a variant of the standard UNIX Crontab scheduler with a "seconds" field prefixed to the beginning. For complete information on scheduling jobs in XperienCentral, see Scheduling Jobs.

Info
Beginning in version R28, XperienCentral no longer uses the Apache Jackrabbit JCR indexing solution by default. This setting is only relevant to users of XperienCentral versions R27 and lower. See the XperienCentral upgrades notes for version R28 for more information.

limboelement_cleanup_schedule The Crontab schedule that dictates when limbo elements are cleaned up. The Crontab schedule used is a variant of the standard UNIX Crontab scheduler with a "seconds" field prefixed to the beginning. For complete information on scheduling jobs in XperienCentral, see Scheduling Jobs.

limboelement_expiration_interval The Crontab schedule that dictates when limbo elements expire and are deleted. The Crontab schedule used is a variant of the standard UNIX Crontab scheduler with a "seconds" field prefixed to the beginning. For complete information on scheduling jobs in XperienCentral, see Scheduling Jobs.

password_banned_words Specifies the string(s) that may not be used as passwords. To add a new value, enter the string in the text field and click [Add value].

password_min_distance Password minimum distance. Specifies the extent to which a string to be used as a password must differ from any of the banned passwords. Take the following example: the string "Administrator" is banned as a password. If the minimum distance is 2, then the allowed strings to be used as a password must differ in at least two ways from "Administrator". The password "Administrat0r" (using a zero "0" instead of an "o") is unacceptable because it differs in only one way from "Administrator".

password_min_entropy Specifies how complicated a password must be. The allowed values are between 50 and 100, 100 being the most strict setting.

render_threads Specifies the number of parallel threads to use when rendering content on the website front-end. If the content on your website does not change at a high rate, it is recommended that you do not set this value too high.

render_threads_incontext Specifies the number of parallel threads to use when rendering content on the website backend. Using multiple threads can significantly increase the performance of rendering content in the Editor.

reserved_context_path

Anchor

	reserved_context_path
	reserved_context_path

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R36.

Specifies one or more context paths that are reserved in XperienceCentral. Reserving a context path is necessary if a website's friendly URLs have no extension and one or more external applications are running on the same host as XperienCentral and you want to avoid a friendly URL being created that matches the internal path of an external application. Enter a context path (without slashes) in the field and click [Add value]. If you run XperienCentral without friendly URL extensions, add the following values:

web
static
upload
upload_mm
cfg
info
wm

secret_key The key used to sign configuration.

secure_rest_against_csrf

Specifies whether XperienCentral protects against CSRF attacks on its REST API.

Note
This setting should always be on (selected).

session_tracking_cookie_name The name of the cookie used for tracking XperienCentral user sessions.

smtp_host The host name of the SMTP-server.

stale_cluster_lock_retry_time The amount of time, in seconds, that indicates that a lock that a server in a clustered environment has for a particular item is no longer valid.

static_files_url The URL where static files from plugins are stored. In XperienCentral versions R36 and higher, this setting is used instead of the old setting application_settings.context_static. The value can be either a relative or an absolute path. This is especially useful to configure a CDN URL to serve the statics from.

statistics_cycle_duration

Specifies the number of milliseconds into the past that the XperienCentral performance statistics are saved. The minimum value is 10000. The default is 7200000 (2 hours). GX Software advises that you do not set the cycle duration to a value lower than the default value.

Note
Setting this property to a high value, such as 6 hours or more, will naturally have an effect on how long the page takes to load. The statistics can be viewed by navigating to the Statistics Administrative Page.

streaming_file_directory The folder where streaming files are stored.

strict_servlet_api Specifies whether to use the content-type header set by the first included JSP for the entire request.

url_cache_clean Specifies the age (in milliseconds) that items can become before they are deleted from the cache.

url_cache_timeout Specifies the amount of time (in milliseconds) between cache cleanups.

url_encoding The encoding to use for encoding URLs, "UTF-8" for example.

urlsign_key The key used to sign URLs.

weblogging_logfile_location The location of the web logging log file.

xss_allowlist_siteworks_expressions

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R29.3.

See XperienCentral XSS Filters (login required).

xss_allowlist_siteworks_qs_parameters

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R29.3.

See XperienCentral XSS Filters (login required).

Back to top

backend_system_settings

Property Description

frontendxssfilter_class_parameters

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R29.3.

Specifies the parameter(s) that cause a request to be blocked if they do not conform to a valid Java class name. See also XperienCentral XSS Filters (login required).

frontendxssfilter_integer_parameters

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R29.3.

Specifies the parameter(s) that cause a request to be blocked if they do not contain a valid integer. See also XperienCentral XSS Filters (login required).

frontendxssfilter_uuid_parameters

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R29.3.

Specifies the parameter(s) that cause a request to be blocked if they do not contain a valid UUID. See also XperienCentral XSS Filters (login required).

ignore_backend_cookies Specifies whether to ignore cookies relayed by a front-end proxy to the backend server.

max_char Specifies the code of the highest ASCII character that XperienCentral will output. The default is "127" (all standard ASCII characters).

max_includes_depth Specifies the maximum number of includes allowed in a config.

max_includes_per_request Specifies the maximum number of includes that are allowed during a single request.

max_recursion_depth Specifies the maximum depth of includes recursion.

ntlm_auth_domain_controller Specifies the IP address of the NTLM authentication server.

ntlm_auth_enabled Enables/disables NTLM authorization.

ntlm_auth_ignore_hosts Specifies the names of the hosts from which requests will be ignored. Separate multiple host names using a comma (,).

ntlm_auth_ignore_user_agents Specifies the user agents that will be ignored.

package_image_url Specifies the location where XperienCentral menu-related images are stored.

presentation_jsps_url The relative URL of the XperienCentral design config JSPs.

replicate_uploads_on_readonly Specifies whether to replicate uploaded files on read-only servers in a cluster.

static_files_location Specifies the directory where static files are stored (relative to the XperienCentral installation).

user_profiles_export_max Specifies the maximum number of user profiles that can be exported in one export file.

xssfilter_get_ignore_parameters

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R29.3.

Specifies the parameters that are checked for forbidden characters in GET requests. Add the parameters to check in a comma-separated list. The forbidden characters are <, >, ' and ". The list of forbidden characters cannot be extended. See also XperienCentral XSS Filters (login required).

xssfilter_post_check_urls_for_parameters

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R29.3.

Specifies the URL expressions to block. See also XperienCentral XSS Filters (login required).

xssfilter_post_ignore_urls_for_parameters

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R29.3.

Specifies the URLs that are ignored in POST requests. The default ignored URLs (for Layout editing and Persona editing) are:

<context>/wcb/nl.gx.product.wmpgui/panel.html?panelIdentifier=wmppersona.personaManagementPanel
<context>/wcb/nl.gx.product.wmpgui/panel.html?panelIdentifier=wmplayout.layoutManagementPanel

See also XperienCentral XSS Filters (login required).

xssfilter_url_check_ignore

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R29.3.

Specifies the trusted URLs. This filter blocks a request if the request URI (the URL path) contains the characters < or > or a UTF-8 encoded version of these characters The list of forbidden characters cannot be extended. Add trusted URLs using a regular expression. See also XperienCentral XSS Filters (login required).

Back to top

connector

Property	Description
`ajaxrefreshrate`	Specifies, in milliseconds, how often to refresh the Ajax progress bar. Setting this to a lower setting may cause lock contention in the JCR and thereby reduce performance for jobs that write intensively to the JCR.
`log_retention_days`	Specifies the number of days that logs will be retained.
`logdir`	Specifies the local directory where the log history files are written.
`maxlogentries`	Specifies the maximum number of log entries to keep. Once the limit is reached, the first log entries will be overwritten and eventually all entries will be overwritten in looping fashion.
`retentionjob_crontabschedule`	The Crontab schedule that dictates when the retained logs will be deleted. All logs older than the number of days specified by `log_retention_days` (above) will deleted according to the defined schedule. For complete information on scheduling jobs in XperienCentral, see Scheduling Jobs.
`username`	Select the system user account from the list that will execute the job(s). For more information, see System User.

Back to top

corsfilter

Property Description

allowed_http_headers

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R33.

A list of response headers that are allowed to be sent in a cross-origin request. When "X-CSRF-Token" is added to it and to the exposed_headers setting and the setting add_csrf_token_header_to_external_responses is enabled in the application_settings section (above), forms submitted to XperienCentral from other domains can be received and read.

ajaxrefreshrate Specifies, in milliseconds, how often to refresh the Ajax progress bar. Setting this to a lower setting may cause lock contention in the JCR and thereby reduce performance for jobs that write intensively to the JCR.

log_retention_days Specifies the number of days that logs will be retained.

logdir Specifies the local directory where the log history files are written.

maxlogentries Specifies the maximum number of log entries to keep. Once the limit is reached, the first log entries will be overwritten and eventually all entries will be overwritten in looping fashion.

retentionjob_crontabschedule The Crontab schedule that dictates when the retained logs will be deleted. All logs older than the number of days specified by log_retention_days (above) will deleted according to the defined schedule. For complete information on scheduling jobs in XperienCentral, see Scheduling Jobs.

exposed_headers

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R33.

A list of response headers that will be made available to scripts running in the browser, in response to a cross-origin request. When "X-CSRF-Token" is added to it and to the allowed_http_headers setting, and the setting add_csrf_token_header_to_external_responses is enabled in the application_settings section (above), forms submitted to XperienCentral from other domains can be received and read.

username Select the system user account from the list that will execute the job(s). For more information, see System User.

Back to top

development_settings

Property	Description
`enable_debug_messages`	Specifies whether to log debug information.
`enable_view_resolve_cache`	Specifies whether to cache the views of the Workspace. Caching the views improves performance.

Back to top

file_distribution_settings

Property	Description
`max_file_size_mb`	Specifies the maximum allowed size of a static file, in megabytes for files added to an XperienCentral deployment (Download element, etc.).

Back to top

forms_config_set

Property	Description
`forms_exportimport_dir`	Specifies the directory used by the Interactive Forms component to store temporary import and export files.

Back to top

formsengine_config_set

formsengine_autotrim_values Specifies whether to strip any leading or trailing white space from values entered in forms.

formsengine_check_referrer Specifies whether forms can be submitted from unrecognized servers. GX Software recommends that this option be selected as an extra safeguard against CSRF attacks.

formsengine_clear_errors_on_back

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version 10.22.0.

Specifies whether to clear error messages from a form session if the visitor clicks the [Back] button. For example, consider the following scenario:

A visitor fills in the fields in step 1 of a form and submits it.
On step 2, the visitor does not fill in a required field and submits the step. An error message appears informing the visitor that a required field has not been filled in and they do not proceed to step 3.
The visitor clicks the [Back] button and returns to step 1.
The visitor resubmits step 1 and proceeds to step 2.

With this option enabled, the visitor will not see an error message on step 2. With this option disabled, the visitor will see the error message upon returning to step 2.

formsengine_prehandling_cachetimeout To ensure good performance for interactive forms, a cache is maintained that defines where they are located. This setting defines the number of seconds that the interactive forms cache lasts.

formsengine_prehandling_check_blocks Specifies whether to prehandle forms on page sections. Because the creation of the prehandling cache can have a negative effect on performance, GX Software recommends that this setting be switched off unless you need to prehandle forms on page sections.

formsengine_prehandling_check_mediaitems Specifies whether to prehandle Content Repository items on page sections. Because the creation of the prehandling cache can have a negative effect on performance, GX Software recommends that this setting be switched off unless you need to prehandle Content Repository items on page sections.

formsengine_prehandling_check_pages Specifies whether to prehandle forms on pages. Because the creation of the prehandling cache can have a negative effect on performance, GX Software recommends that this setting be switched off unless you need to prehandle forms on pages.

formsengine_session_cleaner_schedule Specifies the number of seconds between which a check will be done to see whether there are any timed out form sessions. This setting is tied to the following setting (forms_session_timeout).

formsengine_session_timeout Specifies the amount of time, in minutes, after which an Interactive Forms session will time out if a website visitor remains idle. For example, if a website visitor starts filling out a form and proceeds through one or more steps and then does nothing, the session will time out after the specified number of minutes. The visitor will be redirected to a "session expired" page when he or she attempts to proceed further after a timeout has occurred.

formsengine_uploaddir Specifies the temporary directory where uploads in Interactive Forms are stored.

Back to top

frontend_system_settings
Anchor
frontend_system_settings
frontend_system_settings

Property Description

allow_cache Enables/disables caching in the XperienCentral front-end.

cache_cacheable_response_codes A comma-separated list of cacheable response codes. The default is "200" (successful response from the server). Only codes that denote an immediate successful response should be entered.

cache_directory The folder where the files containing cached content is stored.

cache_directory_depth The maximum depth that the folder tree used for caching can reach. The recommended value is 3.

cache_max_stale_time The number of seconds that the front-end will serve an old version of a page from the cache while the page is being regenerated by the backend. The recommended value is 0.

cache_number_of_directories The maximum number of subfolders that will be created for the caching directory structure. The recommended value is 30.

cache_statement_timeout Specifies the number of seconds between queries from the front-end to ensure the validity of cached content.

cache_timestamp_expire The maximum number of seconds that a query to the Timestamp database is allowed to take. If there is no response from the database within this time period, the cached version of the page is returned. The recommended value is 2.

crawler_useragent Contact your GX Software consultant for information on setting this property.

definition_url_base The base URL of the forms definitions.

form_upload_directory The folder where uploads are temporarily stored.

friendly_url_datasource The datasource to use for friendly URLs.

friendly_url_extension

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was removed from XperienCentral in version R36.

Specifies the extension to use for friendly URLs (".htm" or ".html").

ignore_user_agent Indicates whether the user agent should be ignored.

log_event_type_factory For internal use only. Do not change the default value.

log_file_charset Specifies the character set used to encode log files (UTF-8 for example).

max_upload_size The maximum allowed file size, in bytes, for uploads. The default is 10 MB.

proxy_cached_read_timeout The number of milliseconds that the proxy waits for a response from the backend. If the backend doesn't respond within the specified time, the cached version of the page is returned. The recommended value is 10000.

proxy_connect_timeout The number of milliseconds that the proxy waits for a successful connection to the backend. If the connection cannot be made within the specified time, the cached version of the page will be returned. The recommended value is 30000.

proxy_ip_number For internal use only. Do not change the default value.

proxy_max_concurrent_requests The maximum allowable number concurrent requests to the proxy server.

proxy_number_of_threads This property is not used.

proxy_read_timeout The number of milliseconds the proxy waits for an HTTP response. The recommended value is 120000.

proxy_retry_timeout Determines the number of milliseconds that the proxy will wait after retrying a page request. The recommended value is 10000.

redirect_disallowed Specifies whether to allow redirects.

redirect_encoding The encoding to use for redirects (UTF-8, for example).

registration_forwardbase The base URI for registration forms.

timestampfetcher_classname Specifies the name of the alternative class to use to fetch timestamps.

Back to top

Anchor
jcr_index
jcr_index
jcrindex

Panel

borderColor	#0081C0
titleColor	#0081C0

The option to run XperienCentral front-end nodes without a JCR index was introduced in R28.

XperienCentral versions R27 and lower use the Apache Jackrabbit implementation of the JCR index to perform queries for locating resources. In R28, GX switched to an XperienCentral-optimized solution that uses a database in order to speed up the addition of front-end nodes in cloud deployments. In R29, XperienCentral no longer runs Apache Jackrabbit parallel with its own search index implementation. To enable and use Apache Jackrabbit, see The XperienCentral JCR Index.

Property Description

autorepair Specifies whether corruptions in the index are automatically detected and repaired. "True" enables this feature and "false" disables it. GX recommends that you set this setting to "true".

mode

Specifies the mode in which XperienCentral performs queries. The options are:

prod (default) — Performs queries without additional overhead. This is the recommended setting for production environments.
test — Compares the results and speed of running queries using the new database JCR queries to the old built-in way and logs any issues. GX recommends running development environments in this mode to see whether there any issues with your channels.
off — Performs queries using the previously used default JCR index.

wmidcachethreshold Specifies the number of internal UUIDs to cache in order to improve performance. The default is 1000. Contact your GX consultant before modifying this value.

Back to top

search_settings

Property	Description
`date_format_parameter`	Specifies the format to use for dates (dd-MM-yyyy, for example).
`from_parameter`	Specifies the "from" parameter to use when results are shown (for example, "From x to y").
`max`	Specifies the maximum number of results to show.
`order_by_parameter`	Specifies how results are ordered.
`query_parameter`	Specifies the name of the query to use for searches.
`scope`	Specifies the location where the XperienCentral internal search engine temporarily stores search results. The valid values are "session" and "request". "Session" means that the search results are stored for the duration of the user's XperienCentral session or until the results have been overwritten by a subsequent search. "Request" means that the search results are only stored for the duration of the current request. For best performance results, you should use "Session" for search results that return multiple pages for a limited number of sessions. If the server handles multiple requests over time, "Request" should be used.
`search_service`	The RMI URL for the Search Service.
`to_parameter`	Specifies the "to" parameter to use when results are shown (for example "From x to y".

Back to top

startup_settings

Property	Description
`base_directory`	Specifies the base folder for application data.
`config_filename`	Specifies the location of the XperienCentral configuration file that determines which license components you have purchased.
`context`	Specifies the context path. This is the path that appears directly after the base URL of the home page of the website, `/web` for example.
`seo_path`	Specifies the path that appears in a friendly URL after the context path. For example, if the context path is "/web" and the SEO path is "seo", then the friendly URLs will all follow the pattern `<hostname>/web/seo/<content item name>`.
`use_distributed_siteworks`	Specifies whether to use distributed Siteworks.
`wcb_directory`	Specifies the folder to use for deploying plugins.

Back to top

system_constants

Property	Description
`cleansite_location`	Specifies the location of the "clean" website that is initially imported when XperienCentral is first run.
`config_filename`	Specifies the location of the `configuration.xml` file that contains XperienCentral settings.
`discussion_handler_uri`	***
`element_controller_uri`	For internal use only. Do not change the default value.
`file_controller_uri`	Specifies the URI of the file controller.
`form_handler_uri`	Specifies the URI of the form handler.
`gettext_uri`	Specifies the URI of the gettext servlet.
`login_redirect_uri`	Specifies the URI of the login redirect.
`mediaitem_controller_uri`	Specifies the URI of the mediaitem controller.
`page_controller_uri`	Specifies the URI of the page controller.
`panel_controller_uri`	Specifies the URI of the panel controller.
`redirect_servlet_uri`	Specifies the URI of the redirect servlet.
`registration_code_servlet_uri`	Specifies the URI of the registration code servlet.
`search_filter_uri`	Specifies the URI of the search filter.
`show_servlet_uri`	Specifies the URI of the show servlet.
`showobject_servlet_uri`	Specifies the URI of the showobject servlet.
`showobject_servlet_uri_closed_area`	Specifies the URI of the showobject servlet for closed area. *** wat in godsnaam is dit?
`sphtml_servlet_uri`	Specifies the URI of the SPHTMLservlet.
`spring_mvc_controller_uri`	Specifies the URI of the Spring MVC controller.

Back to top

webmanager_revision_bundle

Panel

borderColor	#0081C0
titleColor	#0081C0

The settings in this section were introduced in XperienCentral version R29.

Property Description

Anchor

	max_age
	max_age

max_age

Specifies the maximum age, in hours, that a revision will be kept. All revisions older than the specified age will be deleted according to the cleanup schedule (see the following setting).

Anchor

	revision_schedule
	revision_schedule

schedule

The Crontab schedule that dictates when revisions older than that specified by max_age (above) will be deleted. The default is every morning at 00:00. For complete information on scheduling jobs in XperienCentral, see Scheduling Jobs.

See Reverting a Content Item for complete information on using the revisions functionality. See also create_content_revisions.

Back to top

website_settings

Property Description

application_filter_definition_url_base Specifies the URL where the configuration for external application integration is located.

backend_base_url Specifies the base URL for the backend system.

backend_hostname Specifies the hostname for the backend system.

backend_server_alias The name of the server alias used to reach the XperienCentral back-end.

default_contenttype Specifies the default content type.

default_encoding Specifies the default encoding, for example, UTF-8.

default_language Specifies the default language.

default_mail_sender Specifies the default e-mail sender.

default_mail_subject Specifies the default e-mail subject.

Anchor

	enable_backend_container_filter
	enable_backend_container_filter

enable_backend_container_filter

Specifies whether to allow an application server backend container to authenticate users who want to log in to XperienCentral. See also Backend Container-based Authentication.

enable_dynamic_user_creation Specifies whether to create new users in XperienCentral who log in from an application server backend container who don't already exist in XperienCentral. See also Backend Container-based Authentication.

enable_email_two_factor_authentication

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R24.2.

Specifies whether XperienCentral's two factor authentication is enabled.

enable_external_role_synchronization Specifies whether to synchronize the roles assigned to a user in an application server backend container with their role(s) in XperienCentral. See also Backend Container-based Authentication.

export_directory Specifies the folder to use for exports.

file_backup_directory Specifies the folder to use for backups.

file_browser_directories

Specifies the directories that you can browse through using the File Browser tab (Configuration > System Utilities). To add a directory, follow these steps:

Add the fully qualified path to the directory in the text field next to [Add value].
Click [Add value]. The new directory is added.
Click [Save Changes] to save the change.
To delete a directory, select the "Delete" checkbox to the right of the directory and then click [Save Changes].

file_download_valid_mime_types Lists the allowed MIME types for the different types of download files which can be uploaded in the Edit environment. This setting is also used for other uploads in the Edit environment. This setting is not used for uploaded images. Note that these MIME types are not configurable.

 Anchor
file_upload_directory
file_upload_directory
file_upload_directory

Specifies the folder to use for uploads.

file_upload_mm_directory Specifies the folder to use for uploaded multimedia items.

file_upload_mm_url Specifies the URI of the file upload multimedia folder.

file_upload_url Specifies the URI of the file upload folder.

Anchor

	file_upload_valid_directories
	file_upload_valid_directories

file_upload_valid_directories

Specifies the local directories where files uploaded by the Interactive Forms Upload form element may be stored. To add a directory, follow these steps:

Add the fully qualified path to the directory in the text field next to [Add value].
Click [Add value]. The new directory is added.
Click [Save Changes] to save the change.

To delete a directory, select the "Delete" checkbox to the right of the directory and then click [Save Changes].

friendly_url_cache_clear Specifies the number of milliseconds that transpire before the friendly URL cache is cleared.

friendly_url_extension Specifies the extension to use for friendly URLs (".htm" or ".html"). In XperienCentral versions R36 and higher, you can also leave this field blank which results in friendly URLs that have no extension. See SEO for complete information about search engine optimization in XperienCentral. See also Running XperienCentral without a Friendly URL Extension.

friendly_url_google_news_id Specifies whether to assign a Google News ID to the friendly URL of Content Repository articles.

friendly_url_lowercase Specifies whether uppercase characters are allowed in friendly URLs. When this setting is selected, all friendly URLs are converted to lowercase.

friendly_url_prefix Specifies the prefix to use for friendly URLs. See SEO for complete information about search engine optimization in XperienCentral.

friendly_url_separator Specifies the separator to use for friendly URLs. The allowed values are dash (-), underscore (_) or empty. If you configure an invalid character it will be converted to a dash (-). See SEO for complete information about search engine optimization in XperienCentral.

friendly_url_setting Specifies which of the three possible titles that a page/content item can have that will be looked at first and used in the friendly URL "urltitle", "navigationtitle", or "title". The default is "navigationtitle".

frontend_hostname Specifies the host name of the front-end.

frontend_https_portnr Specifies the HTTPS port number for the front-end.

frontend_portnr Specifies the HTTP port number for the front-end.

frontend_server_alias Specifies the aliases to use for the front-end host name.

frontend_use_https

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R29.

Enables the HTTPS protocol for front-end servers. This setting is especially useful for the preview functionality introduced in XperienCentral R29.

generate_https_sitemap_urls Specifies whether to generate HTTPS URLs for the website's sitemap.

handler_url_base For internal use only. Do not change the default value.

identifier Specifies the identifier for this website.

max_image_upload_size

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral version R29.

Specifies the maximum allowable size for uploaded images (backend).

oEmbed_enabled Specifies whether the features of oEmbed that XperienCentral supports are enabled.

presentation_jsps_url

Specifies the URL to the design config JSPs for this website. You can add multiple paths to this setting.

Note
If you add more than one path, the order from top to bottom as they appear in the list is important. The first matching ID that is found beginning at the top of the list is the one that is used.

Anchor

	previewtoken_expire_minutes
	previewtoken_expire_minutes

previewtoken_expire_minutes

Panel

borderColor	#0081C0
titleColor	#0081C0

This setting was introduced in XperienCentral R29.

Specifies the amount of time, in minutes, that the preview URL for an unpublished content item remains valid. See also Previewing a Content Item.

productcatalog_name Specifies the name of the catalog used by the Product Maintenance component.

projectid For internal use only. Do not change the default value.

redirect_base_url Only to be used for backward comparability with older versions of XperienCentral. Contact your GX Software consultant for more information.

redirect_basedirectory Specifies the redirect base folder.

render_form_name_and_id Specifies whether the name as well as the attribute ID for <form/> tags is rendered. This property is used for web guideline compliance.

render_personalization_markers

Anchor

	render_personalization_markers
	render_personalization_markers

Panel

borderColor	#0081C0
titleColor	#0081C0

Personalization markers were introduced in XperienCentral version 10.15.0.

Enables XperienCentral to send visitor statistics related to personalizations to Google Analytics. This functionality requires the XperienCentral Insights Platform. When enabled, this setting adds hidden <div> tags which contain data personalization attributes needed by Google Analytics to personalized content. The only information sent to Google Analytics is the name of the personalization.

search_redirect_base Specifies whether the name as well as the attirbute-ID for <form/>> tags is rendered. This property is used for web guideline compliance.

searchresult_replacement This property is not used.

sitestat_url Specifies the URL for Sitestat.

start_object_id Specifies the identifier of the homepage for this website.

static_files_url Specifies the URI to the static files for this website.

use_absolute_urls Specifies whether to use absolute URLs.

use_inline_environment Specifies whether to use the inline environment. *** wat in godsnaam betekent dit?

valid_link_schemes

Specifies the link prefixes that are allowed in hyperlinks in content in XperienCentral. The default prefixes are "http", "https" and "mailto". If your website uses other URL prefixes, you can add them to the allowed link schemes. A link scheme is everything that comes before the colon (:) in a URL (https://www.gxsoftware.com, for example). To add a link scheme, follow these steps:

Enter the link scheme in the text field next to the [Add value] button.
Click [Add value]. The link scheme is added.

To delete a link scheme, follow these steps:

Select the "Delete" check box to the right of the link scheme.
Scroll to the bottom of the "General" tab and click [Save Changes]. The link scheme is deleted.

When you add or delete a link scheme, the change is effective immediately. No restart of XperienCentral or refresh of a browser is necessary.

Note
System Administrators and Application Managers: In general, it is a good idea to communicate to your users of XperienCentral which link schemes are acceptable.

www_root_directory Specifies the www root directory.

Back to top

Anchor
wmasolrsearch
wmasolrsearch
wmasolrsearch

Property	Description
`clearrest`	Specifies whether to clear all "remaining URLs" from the search index. This means that all results not indexed in the current run will be removed. Use this option only if `fullindex` is also enabled.
`config_directory`	Specifies the name of the directory where the Solr search directories are located. Note: You can override the default XperienCentral Solr configuration. Perform the following steps in order for the modifications to the Solr configuration files to be applied and saved: Start XperienCentral. Create a new directory for the Solr configuration files. Copy the directory `<xperiencentral-root>/work/searchengine/conf/core0/conf` to the directory you created in the previous step. Modify the configuration file(s) as desired in the new directory. Add the Solr directory that you created above to the property "config_directory" in the "wmasolrsearch" section (above). Click [Save Changes] in the Setup Tool. In the XperienCentral Workspace, navigate to the Plugins dialog (Configuration > Plugins). Stop and restart the plugin "wmasolrsearch". If after performing the steps above you modify the override configuration files in the directory set as `config_directory`, you must perform the following steps for them to take effect: Modify the configuration file(s) as desired in the `config_directory`. In the XperienCentral Workspace, navigate to the Plugins dialog (Configuration > Plugins). Stop and restart the plugin "wmasolrsearch".
`crontabschedule`	The Crontab schedule that dictates when the search index will be generated. The Crontab schedule used is a variant of the standard UNIX Crontab scheduler with a "seconds" field prefixed to the beginning.For complete information on scheduling jobs in XperienCentral, see Scheduling Jobs.
`fullindex`	Specifies whether to generate the entire index instead of just the pages that have been added/changed. If `clearrest` is enabled, enable this option as well.

Back to top

Page tree

Versions Compared

Old Version 75

New Version 76

Key

Anchor
top
top

In This Topic

application_settings

backend_system_settings

connector

corsfilter

development_settings

file_distribution_settings

forms_config_set

formsengine_config_set

frontend_system_settings
Anchor
frontend_system_settings
frontend_system_settings

Anchor
jcr_index
jcr_index
jcrindex

search_settings

startup_settings

system_constants

webmanager_revision_bundle

website_settings

Anchor
wmasolrsearch
wmasolrsearch
wmasolrsearch

Page tree

Page History

Versions Compared

Old Version 75

New Version 76

Key

Anchortoptop

In This Topic

application_settings

backend_system_settings

connector

corsfilter

development_settings

file_distribution_settings

forms_config_set

formsengine_config_set

frontend_system_settings Anchorfrontend_system_settingsfrontend_system_settings

Anchorjcr_indexjcr_indexjcrindex

search_settings

startup_settings

system_constants

webmanager_revision_bundle

website_settings

Anchorwmasolrsearchwmasolrsearchwmasolrsearch

Anchor
top
top

frontend_system_settings
Anchor
frontend_system_settings
frontend_system_settings

Anchor
jcr_index
jcr_index
jcrindex

Anchor
wmasolrsearch
wmasolrsearch
wmasolrsearch