OpenKM.cfg
From OpenKM Documentation
You can modify some OpenKM default behavior.
Contents
General
- repository.config: Specify the repository configuration file. This is an XML which describe the repository configuration. Here you can alter the FileSystem and PersistenceManage for Workspace and Versioning. By default set to "repository.xml". See Repository configuration for more info.
- repository.home: This is the folder name where the repository data is stored, but this information depends on the configuration defined in "repository.xml" because the repository contents can be stored in disk or in a database. By default set to "repository".
- principal.adapter: OpenKM use JAAS (Java Authentication and Authorization Service) to manage authentication. can handle user access using the JBoss org.jboss.security.auth.spi.DatabaseServerLoginModule login module by default. OpenKM needs an available method for reading users and roles. The class com.openkm.principal.DatabasePrincipalAdapter does this job. For more info, read http://jboss.org/community/docs/DOC-10760.
- max.file.size: Defines the maximum size for a document. If the document size exceed this quantity, the application throws an FileSizeExceededException and the document won't be added to the repository. The size is measured in MB, so if you set this property to 25, the maximum document size will be 25 MB. By default set to 25.
- restrict.file.mime: If you set this property to "on", only files with a registered MIME type are allowed to be added to the repository. If the file don't match any registered MIME type an UnsupportedMimeTypeException is thrown. The list of registered MIME type is defined in the file $JBOSS_HOME/server/default/deploy/OpenKM.war/WEB-INF/classes/com/openkm/core/mime.types. The changes in the file won't take effect until you restart the JBoss server. If you add a new MIME type, don't forget to add the corresponding icon at $JBOSS_HOME/server/default/deploy/OpenKM.war/com.openkm.frontend.Main/img/icon/mime. By default set to "off".
- restrict.file.extension: This configuration parameter limit the files added using the WebDAV connector. The reason to add this configuration property is that many application create temporal or backup files while you edit a document using the WebDAV connector, and you don't want to add these "phantom" files to the repository. By default set to “*~,*.bak”.
- max.search.results: To prevent heavy system load due to large search results, you can configure the maximum search results returned by a query. By default set to 25.
- application.url: In subscriptions and notification messages an URL with the related document is included. Here you have to configure the URL used to access OpenKM from others computers. Notifications and subscriptions won't be available until this parameter is configured. This is a sample configuration: http://your-domain.com:8080/OpenKM/com.openkm.frontend.Main/index.jsp. By default set to http://localhost:8080/OpenKM/com.openkm.frontend.Main/index.jsp.
- notify.message.subject: Can be used to set the notification mail message subject. See Notification and subscription messages for more info.
- notify.message.body: Can be used to set the notification mail message body. See Notification and subscription messages for more info.
- subscription.message.subject: Can be used to set the subscription mail message subject. See Notification and subscription messages for more info.
- subscription.message.body: Can be used to set the subscription mail message body. See Notification and subscription messages for more info.
- system.ocr: If you want to use an OCR you should put here the path to the application executable. Actually only works with Tesseract. See OCR for more info. By default set to "".
- system.antivir: OpenKM can be configured to check an uploaded document for viruses. Here you can specify the path of the executable antivir. Actually only works with ClamAV. See Antivirus for more info. By default set to "".
- system.readonly: To configure a read-only OpenKM instance. See Repository mirroring for more info. By default is set to "off".
- system.openoffice: This parameter is used to enable / disable the integration with OpenOffice.org application. Should be set to "on" to enable the document to PDF conversion feature. See Third-party software integration: OpenOffice.org for more info. By default set to "off". Since OpenKM 5.0, you don't have to run OpenOffice.org as a service because is handle by OpenKM itself. You should configure the OpenOffice.org installation directory (is Ubuntu Linux is /usr/lib/openoffice).
- system.webdav: Here you can enable or disable the WebDAV interface to the OpenKM repository. Byt default set to "off".
- default.lang: Used to set the default OpenKM web interface language. By default set to english.
Schedule
- schedule.repository.info: Seconds between each refresh of repository info. (defaults to 1440 minutes = 24 hours). From OpenKM 4.1.
- schedule.mail.importer: Seconds between each mail import process (defaults to 0 minutes = disabled). In OpenKM 4.1 the default was 60 minutes and could not be disabled.
Hibernate
- hibernate.dialect: Define the database dialect to be used by Hibernate. Refer to Hibernate documentation for more info.
- hibernate.hbm2ddl: May be 'create', 'update' or 'none'. Refer to Hibernate documentation for more info.
- hibernate.show_sql: Log SQL query. By default set to "false". Refer to Hibernate documentation for more info.
Logo icons
- logo.login: Define a custom logo in the login page. By default set to OpenKM logo.
- logo.mobi: Define a custom logo in the mobile login page. By default set to OpenKM mobile logo.
- logo.report: Define a custom logo in the reports. By default set to OpenKM report logo.
- logo.text: Define a text message in the login page. By default set to " ".
See also Application configuration.