Knowledge:Migration from 6.4.1 to 6.4.2

OpenKM 6.4.2 is currently under development.

• See changelog at Mantis

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

• Make a backup!!!

• All OKM_NODETYPE* tables should be deleted
• All OKM_TASK_MANAGER* tables should be deleted

• Migration of automation step 1

SELECT AAC_ID, AAC_TYPE, 'UPDATE OKM_AUTO_ACTION set AAC_CLASS_NAME=''' || (SELECT AMD_CLASS_NAME FROM OKM_AUTO_METADATA WHERE AMD_ID=AAC_TYPE) || ''' where AAC_ID=' || AAC_ID || ';'  FROM OKM_AUTO_ACTION;
SELECT AVL_ID, AVL_TYPE, 'UPDATE OKM_AUTO_VALIDATION set AVL_CLASS_NAME=''' || (SELECT AMD_CLASS_NAME FROM OKM_AUTO_METADATA WHERE AMD_ID=AVL_TYPE) || ''' where AVL_ID=' || AVL_ID || ';' FROM OKM_AUTO_VALIDATION;

• Stop Tomcat

• Run from your preferred SQL client these queries:

-- Configuration
UPDATE OKM_CONFIG SET CFG_KEY='text.banner' WHERE CFG_KEY='logo.banner';
UPDATE OKM_CONFIG SET CFG_KEY='text.welcome' WHERE CFG_KEY='logo.welcome';

-- Workflow
UPDATE OKM_PROFILE SET PRF_DB_WORKFLOW_VIS='F';
UPDATE OKM_PROFILE SET PRF_MN_FI_START_WORKFLOW_VIS='F';
UPDATE OKM_PROFILE SET PRF_TB_START_WORKFLOW_VIS='F';

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

• Replace the OpenKM.war

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

• Start Tomcat again

• Migration of automation step 2

Go to database query and execute sql output from automation step 1. Finally execute the sql queries to drop non used columns.

ALTER TABLE OKM_AUTO_ACTION DROP COLUMN AAC_TYPE;
ALTER TABLE OKM_AUTO_VALIDATION DROP COLUMN AVL_TYPE ;
DROP TABLE OKM_AUTO_METADATA;

• Check for database errors:

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

• Set installation customer at License Manager.

• Enjoy OpenKM 6.4.2!

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