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!!!

Take in consideration delete metadata and automation tables when it be possible do it.

-- ocr template
DROP TABLE OKM_OCR_TEMPLATE;
DROP TABLE OKM_OCR_TEMPLATE_FIELD;
DROP TABLE OKM_OCR_TEMPLATE_METADATA;

-- drop metadata tables
drop table OKM_REG_PROPERTY;
drop table OKM_REG_PROPERTY_GROUP;
drop table OKM_PROPERTY_GROUP_DEF;

-- drop automation tables
drop table OKM_AUTO_ACTION_PARAMS;
drop table OKM_AUTO_ACTION;
drop table OKM_AUTO_VALIDATION_PARAMS;
drop table OKM_AUTO_VALIDATION;
drop table OKM_AUTO_RULE;

-- in case you got several tennat is necessary add property group definition
insert into OKM_PROPERTY_GROUP_DEF (PGD_DEFINITION,PGD_TENANT)  values ('',2);

• 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;

-- Add default property group definition tenat
insert into OKM_PROPERTY_GROUP_DEF (PGD_ID, PGD_TENANT, PGD_DEFINITION) values (1, 1, '');

If there is no automation defined:

-- Show table constraints
DROP TABLE OKM_AUTO_ACTION_PARAMS;

If there is automation rules defined:

-- Show table constraints
SHOW CREATE TABLE OKM_AUTO_ACTION_PARAMS;

-- Remove primary key
ALTER TABLE OKM_AUTO_ACTION_PARAMS DROP PRIMARY KEY;
ALTER TABLE OKM_AUTO_ACTION_PARAMS DROP INDEX FK1F747E2D5E55CCFF; -- Use from create table
ALTER TABLE OKM_AUTO_ACTION_PARAMS DROP FOREIGN KEY FK1F747E2D5E55CCFF; -- Use from create table

-- Rename table field
ALTER TABLE OKM_AUTO_ACTION_PARAMS CHANGE AAP_VALIDATION AAP_ACTION bigint(20);

-- Create primary key
ALTER TABLE OKM_AUTO_ACTION_PARAMS ADD PRIMARY KEY (AAP_ACTION, AAP_ORDER);

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;

-- Add default property group definition tenat
insert into OKM_PROPERTY_GROUP_DEF (PGD_ID, PGD_TENANT, PGD_DEFINITION) values (1, 1, '');

If there is no automation defined:

-- Show table constraints
DROP TABLE OKM_AUTO_ACTION_PARAMS;

If there is automation rules defined:

-- NOT COMPLETED --

-- Rename table field
ALTER TABLE OKM_AUTO_ACTION_PARAMS RENAME COLUMN AAP_VALIDATION TO AAP_ACTION;

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