Knowledge:Migration from 6.4.0 to 6.4.1

OpenKM 6.4.1 is currently under development.

• See changelog at Mantis

• Download update from http://openkm.com/download/okm/OpenKM-6.4.1.zip (eMpg8eIjY5)

• Make a backup!!!

• Stop Tomcat

• Run from your preferred SQL client these queries:

MySQL

-- Describe table
describe OKM_NODE_DOCUMENT_VERSION;

-- Expand column
alter table OKM_NODE_DOCUMENT_VERSION modify NDV_CHECKSUM varchar(128);

-- Set default tenant
update OKM_REG_PROPERTY_GROUP set RPG_TENANT=1;

PostgreSQL

-- Describe table
select column_name, udt_name, character_maximum_length from INFORMATION_SCHEMA.COLUMNS where table_name = 'okm_node_document_version';

-- Expand column
alter table OKM_NODE_DOCUMENT_VERSION alter column NDV_CHECKSUM type varchar(128);

-- Set default tenant
update OKM_REG_PROPERTY_GROUP set RPG_TENANT=1;

Oracle

-- Describe table
select * from user_tab_columns where table_name = 'OKM_NODE_DOCUMENT_VERSION' order by column_id;

-- Expand column
alter table OKM_NODE_DOCUMENT_VERSION modify (NDV_CHECKSUM varchar2(128));

• Edit OpenKM.cfg and set hibernate.hbm2ddl to update

• Replace the OpenKM.war

• Review file descriptor limit and, eventually, increase it.

• Start Tomcat again

• Check for database errors:

$ grep "ERROR .*hbm2ddl" $TOMCAT_HOME/logs/catalina.log

• Go to Administration > Configuration and replace these extractors:

org.apache.jackrabbit.extractor.PlainTextExtractor
org.apache.jackrabbit.extractor.MsWordTextExtractor
org.apache.jackrabbit.extractor.MsExcelTextExtractor
org.apache.jackrabbit.extractor.MsPowerPointTextExtractor
org.apache.jackrabbit.extractor.OpenOfficeTextExtractor
org.apache.jackrabbit.extractor.RTFTextExtractor
org.apache.jackrabbit.extractor.HTMLTextExtractor
org.apache.jackrabbit.extractor.XMLTextExtractor
org.apache.jackrabbit.extractor.PngTextExtractor
org.apache.jackrabbit.extractor.MsOutlookTextExtractor

By these others:

com.openkm.extractor.PlainTextExtractor
com.openkm.extractor.MsWordTextExtractor
com.openkm.extractor.MsExcelTextExtractor
com.openkm.extractor.MsPowerPointTextExtractor
com.openkm.extractor.OpenOfficeTextExtractor
com.openkm.extractor.RTFTextExtractor
com.openkm.extractor.HTMLTextExtractor
com.openkm.extractor.XMLTextExtractor
com.openkm.extractor.PngTextExtractor
com.openkm.extractor.MsOutlookTextExtractor

• Set installation customer at License Manager.

• Enjoy OpenKM 6.4.1!

If you have any weird problem try to stop Tomcat, delete these folders:

• $TOMCAT_HOME/webapps/OpenKM
• $TOMCAT_HOME/work/Catalina/localhost

And start Tomcat again.

Recommended to clear browser cache and Java Plugin cache