Knowledge:Migration from 6.2.15 to 6.2.16

OpenKM 6.2.16 is currently under development.

• See changelog at Mantis

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

• Make a backup!!!

• Stop Tomcat

• Run from your preferred SQL client these queries:

MySQL

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

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;

• 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 > Database Query, and remove obsolete configuration properties:

• Set installation customer at License Manager.

• Enjoy OpenKM 6.2.16!

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