System Properties Reference

System properties configure application-wide settings. Some of the settings correspond to configuration elements in the admin console user interface.

To make changes to system properties, in the admin console go to System > Management > System Properties. Keep in mind that both property names and values are case-sensitive.

Note: Changing system property values can have a dramatic effect on how the application works. Some settings and values can even severely debilitate the application. You should only make changes to system settings under the guidance of Jive's support or professional services teams.

Default System Properties

The following is a list of system properties that are set by default when you install Jive SBS.

Property Description
checkmail.host Email server name used for verifying mail settings provided in the System - Settings - Email Server screen in the admin console.
checkmail.port Email server port used for verifying mail settings provided in the System - Settings - Email Server screen in the admin console (default: 110)
checkmail.protocol Email protocol used for verifying mail settings provided in the System - Settings - Email Server screen in the admin console (default: pop3)
documentmanager.correctdeletedusers.completed Determines if the CorrectDeletedUsersTask should run, which finds all the documents in the system and check to make sure that the original author of the document hasn't been deleted. If the author has been deleted, then this task sets the author to "guest" (id: -1)
feeds.protected Determines whether or not feeds are protected by Basic Authentication.
GroupManager.className Qualified class name for the default GroupManager implementation. Modify this property to identify a custom GroupManager implementation to associate users with various groups on the system.
i18n.allowedLanguages not currently used
i18n.defaultLanguage not currently used
jive.auth.disallowGuest Determines whether or not non-authenticated users are not allowed. When this property is set to true, any non-authenticated user will be redirected to the login page for all requests.
jive.bodyConversionTask.completed Determines if the BodyConversionTask should run, which goes through all messages, documents, blog posts, comments, announcements and private messages and converts their bodies to the new xml storage format, backing up the previous content if any changes were made.
jive.sync.profile.ldap.login Determines whether LDAP-provided user profile fields should be refreshed when users log in. Set to false for external communities where LDAP is not commonly used (default: true)
jive.sync.relationships.ldap true to use LDAP to build the organizational chart and specify reporting relationships.
jive.user.lastname.firstname.enabled Determines whether user names are stored as two values -- one each for first and last names. If the value is false, then user names are stored as a single value combining first and last names. This is set during application setup.
jive.xmpp.enabled Determines whether the XMPP service is enabled.
jiveInstanceId The universally unique instance of the application cluster, used to distinguish each server node in a clustered server configuration.
jiveURL The base URL of the installation. This must be set in order for the application to work correctly.
ldap.adminPassword.key The private key used to decrypt the LDAP password in the database.
ldap.searchFilter no longer used
log4j.threshold The level at which logging messages will be recorded (default: ERROR)
mail.smtp.host Mail server used for sending notifications and messages to users
mail.smtp.port Mail server port used for mail notifications
opensearch.key Unique ID used for external search engine integration
search.indexCreated Tracks the last time the search index was created (set by the system)
search.indexVersion The version of the currently used user index.
skin.default.displayFullNames Set to true to display the full names of users, or false to use their username.
skin.default.newAccountCreationEnabled Determines whether users are allowed to register to create a new account (default: true)
system.adminuser.email The default email address that the system will use when sending email notifications
system.adminuser.fromName The default "From" name that the system will use when sending email notifications
update.lastCheck Tracks the last time the system checked for updates to plugins or the server (set by the system). New versions of plugins can be downloaded and installed. However, new server releases should be manually installed.
ur.graph.hier.default.ID The ID of the default (hierarchical) org chart graph.
ur.graph.mesh.default.ID The ID of the default (mesh) friends/connections graph.
user.allowEmailVisibilityToggle true to allow the user to choose email address visiblity.
user.allowNameVisibilityToggle true to allow the user to choose name visiblity.
user.default.displayEmailAddress Determines whether or not to display a user's email address.
webservices.rest.enabled Determines whether or not REST-style web services are enabled.
webservices.soap.accessType The access type for SOAP web services. Possible values include all (for all users), registered (for registered users only), specificUsers (for specifically named users only), and specificGroups (for specifically named groups only).

Other Available System Properties

Property Description
blog.searchComments.enabled true to enable return of comments on search; false to disable it (default: true).
browse.main.docs.show.space.browser true to have the Documents page use the original space browsing UI.
browse.main.threads.show.space.browser true to have the Discussions page use the original space browsing UI.
document.searchComments.enabled true to enable return of comments on search; false to disable it (default: true).
jive.container.category.tagcloudmax The maximum number of tags shown in a tag cloud when filtering content by categories and tags. This is an integer that defaults to 30. A very high number might impair performance or cause UI problems.
jive.devMode Set to true to ensure that images, attachments, and binary documents are not cached. Also turns off page compression when set to false in conjunction with the jive.compressionFilter.enabled property being set to false.
jive.digest.enabled false to disable the email digest feature. The feature is designed to send email to users with a summary of their activity in the community.
jive.featuredcontent.enabled false to disable the featured content feature. The feature is enabled by default.
jive.featuredcontent.objecttype.<typevalue> false to disable featuring for the specified kind of content. Append the objecttype value of the content you want to disable. For example, to disable documents set it this way: jive.featuredcontent.objecttype.102 = false. All types are enabled by default.
jive.freemarker.templateUpdateDelay Set to 1 to tell the application to look for changes to theme files. When you're editing theme FTL files outside of the admin console, use this property and value to ensure that your changes are picked up as you make them. (Because it can slow performance, be sure to remove this property for your production instance.)
jive.pageCached.enabled Freemarker pages are cached by default in versions 2.0 and greater (default = true even if not set in the admin console). Set this property to false to turn off caching for development purposes, which will allow theme changes to be reflected immediately in the UI without restarting the server. Page caching should be enabled for production instances however, to increase performance.
jive.pdf.paper.size Specifies the default paper size for PDF files generated from content. The following values are supported: ANSI_A, ANSI_B, ANSI_C, ANSI_D, ANSI_E, ISO_A0, ISO_A1, ISO_A2, ISO_A3, ISO_A4, ISO_A5, ISO_A6, ISO_A7, ISO_A8, ISO_A9, ISO_A10, ISO_B0, ISO_B1, ISO_B2, ISO_B3, ISO_B4, ISO_B5, ISO_B6, ISO_B7, ISO_B8, ISO_B9, ISO_B10, ISO_C0, ISO_C1, ISO_C2, ISO_C3, ISO_C4, ISO_C5, ISO_C6, ISO_C7, ISO_C8, ISO_C9, ISO_C10, JIS_0, JIS_1, JIS_2, JIS_3, JIS_4, JIS_5, JIS_6, JIS_7, JIS_8, JIS_9, JIS_10, JIS_11, JIS_12
jive.usercontainer.document.enabled false to turn off the "Your Documents" feature.
jive.usercontainer.thread.enabled false to turn off the private discussions feature.
macros.unproxyobjects true to render the link -- rather than an error message -- even when the user might not have permission to view the linked content. This is false by default in order to prevent potentially sensitive content (such as the linked document's title) from being seen by those who don't have permission to view the content.
people.search.pagesize The number of results per page in people search
polls.enabled Turns on polls, and displays the "Create a poll" link in the Actions sidebar if the user has been given permissions to create polls.
privateMessages.notification.enabled If private messaging has been enabled, then this property determines whether the system will send email notifications when users receive a private message (default: true)
questions.markThreadAsQuestionByDefault Set to true to mark discussions as questions by default (display the "Mark thread as question" checkbox in new discussions as checked), or set to false to leave it unchecked by default. Often users do not even notice that the checkbox is there, and turning it on by default allows users to give points to other users when they provide a correct or helpful answer.
skin.default.changePasswordEnabled Determines whether users can change their password. Values(true,false).
skin.default.headerHTML Replaces the header logo for the entire application with the html entered in this system property.
skin.default.newAccountCreationEnabled Determines whether users can register their own user accounts. Values(true,false).
skin.default.recentHistoryEnabled Set to false to hide the History menu on the userbar (defaults to true)
system.console.custom.title The value that should be used in the page title for the admin console. Typically, this matches the title of your community, such as "Acme Community Admin Console".
webservices.soap.enabled Whether or not SOAP webservices are enabled (default: false)
webservices.xmlrpc.enabled Whether or not XML-RPC webservices are enabled (default: false)
webservices.soap.accessType Sets how users can access webservices possible values are
  • all - Any users.

  • registeredUsers - Disallow anonymous access.

  • specificUsers - Only allow specific users (Use the webservices.soap.allowedUsers property to set).

  • specificGroups - Only allow specific groups (Use the webservices.soap.allowedGroups property to set).

(default: all)

webservices.soap.allowedUsers Comma seperated list of allowed users by username (see property: webservices.soap.accessType)
webservices.soap.allowedGroups Comma seperated list of allowed groups by group name (see property: webservices.soap.accessType)
webservices.soap.forceSSL If this property is set requests that are not over SSL will fail. (default: false)
webservices.soap.permissionHandler.className Override this property to customize the inbound Handler for XFire. (default:com.jivesoftware.community.webservices.server.xfire.PermissionHandler)