Stages Documentation

Sharepoint Configuration

Global CMS Properties

These configuration properties affect the behavior of every integrated SharePoint server. The configuration of them needs to be done in the cms section of Config.xml.

Stages.server.url (required)

  • Default Value: N/A
  • Description: The URL under which Stages is accessible.

http.authentication.hostname (required for NTLM authentication)

  • Default Value: N/A
  • Description: The host name of the server that runs Stages and is allowed to authenticate via NTLM against the SharePoint server.

upload.service

  • Default Value: Copy service
  • Description: Either CopyService or RPC. Defines the interface that is used for uploads to SharePoint. CopyService is the default setting, the only drawback is that it might create an additional version for the initial checkin depending of the SharePoint setting Checkout required

initial.checkin.fix

  • Default Value: true
  • Description: If CopyService is used for uploads, causes Stages to repeat the initial checkin in case the comment or version are not created correctly in SharePoint.

http.ssl.allow.all

  • Default Value: false
  • Description: When set to true, disables any verification checks for certificates in case of SSL-secured HTTPS connections. It is recommended to only use this in test environments where no valid certificates exist (e.g. self-signed certificates).

validatePath

  • Default Value: ^([^~“#%&*:<>?/\\{|}.]|[^~”#%&*:<>?/\\{|}.][^~“#%&*:<>?/\\{|}]*[^~”#%&*:<>?/\\{|}.])?([\\/]([^~“#%&*:<>?/\\{|}.]|[^~”#%&*:<>?/\\{|}.][^~“#%&*:<>?/\\{|}]*[^~”#%&*:<>?/\\{|}.]))*[\\/]?$
  • Description: A regular expression pattern that should match the allowed strings for paths of SharePoint documents. Deviating paths are denied.

validateFilename

  • Default Value: ^[^~“#%&*:<>?/\\{|}]+$
  • Description: A regular expression pattern that should match the allowed strings for file names of SharePoint documents. Deviating file names are denied.

http.max.connections

  • Default Value: 100
  • Description: The maximum number of simultaneous HTTP connections between Stages and SharePoint.

http.connection.timeout

  • Default Value: 10000
  • Description: The timeout in milliseconds until a connection to the server has to be established.

http.socket.timeout

  • Default Value: 90000
  • Description: The maximum time of inactivity (in milliseconds) until a server connection is considered dead and will be closed forcefully. This value should be higher than http.connection.pool.max.idle.

http.connection.pool.max.idle

  • Default Value: 60000
  • Description: The maximum period of inactivity (in milliseconds) until a server connection will be closed automatically. For technical reasons the sum of http.connection.pool.max.idle and http.connection.resource.check.interval has to be lower than the keep-alive timeout of SharePoint's IIS site (default: 120s).

http.connection.context.timeout

  • Default Value: 60000
  • Description: The maximum period of inactivity (in milliseconds) before an authentication context is considered obsolete and will be removed by the resource monitor.

http.connection.resource.check.interval

  • Default Value: 10000
  • Description: The interval (in milliseconds) between two consecutive resource monitor runs which check for idle or expired connections and obsolete authentication contexts.