RSuite is a registered trademark and the RSuite CMS logo is a trademark of Orbis Technologies, Inc.
This is a confidential document only to be shared with current RSuite® customers and others designated by Orbis Technologies, Inc.
Copyright © 2008–2018 Orbis Technologies, Inc. All rights reserved.
For more information on RSuite or Orbis Technologies, visit these Web sites:
The PDF version of this document is created with the RenderX XEP FO engine integrated with the DITA Open Toolkit. See www.renderx.com for product details.
RSuite® CMS is a robust content management application, especially suited to loading, storing, managing, transforming, and exporting XML documents within the context of a publishing enterprise.
This book contains reference information for configuring and administering the RSuite CMS server and the MarkLogic database.
These properties define tokens for authenticating RSuite users. Property names are case-sensitive.
rsuite.auth.ldap_username=rsuite-server rsuite.auth.ldap_username=jsmith rsuite.auth.ldap_username=rsuite
rsuite.auth.ldap.password=plain:simplepassword rsuite.auth.ldap.password=encrypteddrowssap
rsuite.auth.ldap.protocol=ldap rsuite.auth.ldap.protocol=ldaps
rsuite.auth.ldap.host=192.168.1.14 rsuite.auth.ldap.host=yourhostname.yourdomain.com rsuite.auth.ldap.host=localhost rsuite.auth.ldap.host=127.0.0.1
rsuite.auth.ldap.port=389 rsuite.auth.ldap.port=636
rsuite.auth.ldap.root-dn=dc=rsidomain,dc=rsi,dc=com rsuite.auth.ldap.root-dn=dc=YOURCOMPANY,dc=com
rsuite.auth.ldap.keystore=c:\\keystores\\rsuitekeystore.jks rsuite.auth.ldap.keystore=/opt/keystores/rsuitekeystore.jks
rsuite.auth.ldap.keystorepass=key5t0reOpen
rsuite.auth.providers=ldap,activedirectory
rsuite.server.logininfo.expiration.days=90
These properties define how RSuite deals with content. Property names are case-sensitive.
rsuite-home/integration/DITA-OT1.8.5.
dita-ot.default.path=C:\RSuite_5\integration\DITA-OT1.8.5
rsuite.api.maxuploadsize.mb=75
rsuite.nonxml.textextract.filesize.max=75
These properties define the location of system directories and alternate properties files used by RSuite. Property names are case-sensitive.
rsuite.nonxml.dir=C:\RSuite-data\nonxml rsuite.nonxml.dir=/opt/RSuite-data/nonxml
rsuite.nonxml.dir=C:\temp rsuite.nonxml.dir=/tmp
rsuite.var.dir=C:\rsuite\var rsuite.var.dir=/opt/rsuite/var
rsuite.plugins.dir=/opt/RSuite-plugins rsuite.plugins.dir=c:\temp\rsuite-plugins
rsuite.workflow.baseworkfolder=c:\tempload rsuite.workflow.baseworkfolder=/opt/RSuite-data/
rsuite.report.generated.base.dir=c:\tempgenerated-reports rsuite.report.generated.base.dir=/opt/RSuite-data/logs/reports
rsuite.conf.alternate.dir=/opt/rsuite-data/yourcompany/local_conf rsuite.conf.alternate.dir=c:\temp\local_conf
rsuite.conf.auxiliary.file.list=more-rsuite.properties,even_more-rsuite.properties ,../../special-users/editors/editing-rsuite.properties
These properties configure the various built-in text editors.
rsuite.edit.admin.userid=userid
These properties set logging levels for the various kinds of logs used by RSuite; the server log and individual workflow logs are the most used. Logs can also be created and maintained by custom plug-ins. Property names are case-sensitive.
rsuite.logs.dir=C:\RSuite-logs rsuite.logs.dir=/opt/RSuite-logs/
rsuite.workflow.logs.base.dir=c:tempworkflow-logs rsuite.workflow.logs.base.dir=/opt/RSuite-data/logs/workflow
These properties define settings for the e-mail server used by RSuite. Property names are case-sensitive.
rsuite.mail.host=localhost
and
rsuite.mail.host=127.0.0.1
rsuite.mail.host=smtp.gmail.com rsuite.mail.host=smtp.mail.yahoo.com
The default port number is 25.
rsuite.mail.protocol=smtp rsuite.mail.protocol=smtps
rsuite.mail.user=companyname.rsicms@gmail.com rsuite.mail.user=jsmith
These properties define tokens for connecting to and managing the MySQL database that RSuite uses to store workflow data and reporting data. Property names are case-sensitive.
rsuite.commands.mysql=/usr/local/mysql/bin/mysql
rsuite.commands.mysql-dump=/usr/local/mysql/bin/mysqldump
hibernate.connection.url=jdbc:mysql://127.0.0.1:3306/rsuite
hibernate.connection.username=rsuite_server
hibernate.connection.password=plain:c0ffeeMug
These RSuite properties configure searches. Property names are case-sensitive.
These properties define server identification settings used by RSuite. Property names are case-sensitive.
rsuite.server.host=foo.domain.com rsuite.server.host=555.867.530.900
Use rsuite.server.port, in conjunction with rsuite.server.host, to specify the port at which the server listens.
rsuite.server.session.timeout.secs=10800
These properties define user interface settings used by RSuite. Property names are case-sensitive.
rsuite.cms.icons.download.disabled=true
rsuite.image.auto.thumbnail.height=210
rsuite.image.auto.thumbnail.width.max=300
Use rsuite.inspect.icons.enabled to suppress the display and function of these buttons on the Inspect panel: Added to, Aliases, Contextual Metadata, and Permissions.
rsuite.integration.imagemagick.home=C:\Program Files\ImageMagick-7.0.4-6-Q16-x64 rsuite.integration.imagemagick.home=usr/local/imagemagick/bin
Language | Token | |
---|---|---|
English | en | |
German/Deutsch | de | |
Spanish/Espanol | es |
rsuite.locale.enabled=en,de
rsuite.semantics.enabled=true
In addition to these properties, the directory, log, and MySQL properties affect workflows. Property names are case-sensitive.
rsuite.graphviz.dot.executable.path=usr/local/graphicviz/bin
Use rsuite.workflow.execution.locktimemillis to increase LockTimeInMillis to give long-running tasks time to finish.
LockTimeInMillis can also be reset by setting up a lifecycle listener and executing
rsuiteWorkflowEngine.getProcessEngineConfiguration().getJobExecutor() .setLockTimeInMillis(maxDuration)
rsuite.workflow.execution.locktimemillis=15000
rsuite.workflow.execution.pool.load.maxactive=10 rsuite.workflow.execution.pool.publish.maxactive=3 rsuite.workflow.execution.pool.default.maxactive=1
<extensionProvider id="rsuite.Workflow"> <workflowExecutionAdvisor id="acme:workflowExecutionAdvisor" label="Acme Workflow Execution Advisor" handler="com.acme.rsuiteplugin.advisors.AcmeWorkflowExecutionAdvisor"> <description>Sort incoming workflow jobs to the appropriate workflow pool</description> </workflowExecutionAdvisor> ... </extensionProvider>
rsuite.workflow.execution.pools=load,publish,default
rsuite.workflow.required.memory.available.percent=25
The first example limits the displayed filters to "My Overdue Tasks" and "My Critical Tasks".
rsuite.workflow.search.default.filters="My Overdue Tasks, My Critical Tasks" rsuite.workflow.search.default.filters=none rsuite.workflow.search.default.filters="NONE"
These properties define the XML repository (MarkLogic) settings used by RSuite. Property names are case-sensitive.
rsuite.repository.server=127.0.0.1 rsuite.repository.server=foo.domain.com
rsuite.repository.port=9000
rsuite.repository.user=jsmith
rsuite.repository.password=plain:admin rsuite.repository.password=fafd09ufdsa3099dvnj3ckjdfHHE
rsuite.repository.impl=com.reallysi.rsuite.system.repository.MarkLogic rsuite.repository.impl=MarkLogic
These are miscellaneous settings. Property names are case-sensitive.
COMPANY.NAME=XYZ-test LICENSE.KEY=PxkK8ZoEWVoQSS3SGoCbtQ==
COMPANY.NAME=XYZ-test
LICENSE.FILE=rsuite-home/conf/rsuite.license
COMPANY.NAME=XYZ-test LICENSE.KEY=PxkK8ZoEWVoQSS3SGoCbtQ==
Configure element range indexes to take advantage of MarkLogic's universal index in RSuite to speed faster searches.
Element range indexes speed the return of results from:
Another advantage of element range indexes is iyou can ncorporate enhanced sorting in search results. On the other hand, indexing slows document loading and requires additional memory and storage. See the MarkLogic documentation for information about a procedure and query for evaluating the memory and storage costs of index configurations.
For example. element range indexes are useful:
Defining a element range index for inherent metadata (the customer's XML data model) requires the namespace URIs, local names, and scalar type. An element-attribute range index may be best.
MarkLogic requires that in inherent metadata all the values within a qualified name be of the same scalar type. If the values in the index cannot be cast to a single scalar type, clean up the data or denormalize it in a new element or attribute.
When data sets use the same qualified name, as a workaround create unique qualified names by modifying the existing markup or denormalizing in new elements or attributes.
Use the following information to create the element range indexes for inequality comparisons with RSuite XPath Search (RXS).
Inequality constraints can be performed without element range indexes. This requires that MarkLogic pull candidate fragments from disk before performing the comparison. Range indexes speed this operation as it is performed in memory. See the MarkLogic documentation for a procedure and query to compare the memory and storage cost of two index configurations.
Different predicates should be used depending on the element range index configuration. If an element range index for the specified piece of metadata is not available, use this technique. It will not use element range indexes, even if there is one.
value1 operator value2
For example:
/book[rmd:get-lmd-value(., 'subscription-ends') <=xs:gYearMonth('2011-10-05:00')]
When element range indexes are available, use this technique. An error occurs if this technique is used and the element range index is not available.
cts:contains(., cts:element-range-query(qname, operator, value))
For example
/book[cts:contains(., cts:element-range-query(xs:QName( 'mv-lmd:subscription-ends'), '<=', xs:gYearMonth( '2011-10-05:00')))]
RSuite XPath Search (RXS) expressions usually use RXS functions to search for layered, system, and variant metadata without knowing the RSuite markup for this information. However, there may be instances where you use these namespace prefixes instead.
The default namespace prefixes that are typically used include:
These namespace prefixes can be used to refer to an element range index.
For more information about creating element range indexes, see Element range indexes.
You can use the following element range indexes to define system metadata using the MarkLogic Admin Console. Define the subset of indexes that will be used by inequality constraints. These indexes can also be created in support of other functions requiring indexes, such as cts:element-values().
All system metadata elements are in the materialized view namespace, URI: http://www.rsuitecms.com/rsuite/ns/materialized-view.
Description | Local Name | Scalar Type | RXS Function |
---|---|---|---|
Date object was created. Well-suited for inequality constraints. The index may be used to select assets created before, after, or within two dates. | date-created | dateTime | rmd:get-date-created |
Date object was last modified. Well-suited for inequality constraints. The index may be used to select assets modified before, after, or within two dates. | last-modified | dateTime | rmd:get-date-modified |
Display name of object. Does not apply to XML managed objects. | display-name | string | rmd:get-display-name |
MIME type of object. | mime-type | string | rmd:get-mime-type |
Target ID of a container or managed object reference. | target-id | string | rmd:get-target-id |
You can use element range indexes to define variant metadata using the MarkLogic Admin Console. Variant metadata is applicable only to binary managed objects. Define the subset of indexes that are used by inequality constraints. These indexes can also be created in support of other functions requiring indexes, such as cts:element-values().
All variant metadata elements are in the variant metadata namespace, URI: http://www.rsuitecms.com/rsuite/ns/materialized-view/variant-metadata.
Description | Local Name | Scalar Type | RXS Function |
---|---|---|---|
Date variant was created. Well-suited for inequality constraints. The index is used to select variants created before, after, or within two dates. | date-created | dateTime | rmd:get-vmd-dates-created |
Date variant was last modified. Well-suited for inequality constraints. The index is used to select variants modified before, after, or within two dates. | last-modified | dateTime | rmd:get-vmd-dates-modified |
MIME type of variant. | mime-type | string | rmd:get-vmd-mime-types |
File name of variant. | filename | string | rmd:get-vmd-filenames |
File extension of variant. | file-ext | string | rmd:get-vmd-file-extensions |
File size. Well-suited for inequality constraints. The index isused to select variants with sizes greater than, less than, or between two specified sizes. | size | int | rmd:get-vmd-file-sizes |
You can create element range indexes to define layered metadata. Unlike system and variant metadata, layered metadata is not predefined. When introducing layered metadata to the system that you want to index, ensure each instance of that metadata is cast to the scalar type defined for the index. Otherwise, an XDMP-CAST exception might be thrown when attempting to access the index.
All layered metadata elements are in the layered metadata namespace, URI: http://www.rsuitecms.com/rsuite/ns/materialized-view/layered-metadata. The local name must match the layered data name. The same local name can be submitted to rmd:get-lmd-value* functions within the context of RXS search.
Refer to the MarkLogic help for further details about the impact of these settings.