Difference between revisions of "Knowledge:Migration from 6.4.0 to 6.4.1"

From OpenKM Documentation
Jump to: navigation, search
 
(15 intermediate revisions by 2 users not shown)
Line 4: Line 4:
  
 
* Make a backup!!!
 
* Make a backup!!!
 +
'''
 +
Take in consideration delete metadata and automation tables when it be possible do it.'''
 +
<source lang="sql">
 +
-- ocr template
 +
DROP TABLE OKM_OCR_TEMPLATE_FIELD;
 +
DROP TABLE OKM_OCR_TEMPLATE_METADATA;
 +
DROP TABLE OKM_OCR_TEMPLATE;
 +
 +
-- 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
 +
-- Possible null error -> needed to refresh cache !!!
 +
insert into OKM_PROPERTY_GROUP_DEF (PGD_DEFINITION,PGD_TENANT)  values ('',2);
 +
</source>
  
 
* Stop Tomcat
 
* Stop Tomcat
  
 
* Run from your preferred SQL client these queries:
 
* Run from your preferred SQL client these queries:
−
 
−
<source lang="sql">
 
−
update OKM_CONFIG set CFG_VALUE='<b>Message: </b>${notificationMessage}<br/><b>User: </b>${userId}<br/><#list documentList as doc><b>Document: </b><a href="${doc.url}">${doc.path}</a><br/></#list>' where CFG_KEY='notification.message.body';
 
−
update OKM_CONFIG set CFG_VALUE='OpenKM - NOTIFICATION' where CFG_KEY='notification.message.subject';
 
−
</source>
 
  
 
'''MySQL'''
 
'''MySQL'''
Line 21: Line 40:
 
-- Expand column
 
-- Expand column
 
alter table OKM_NODE_DOCUMENT_VERSION modify NDV_CHECKSUM varchar(128);
 
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, '');
 +
</source>
 +
 +
If there is no automation defined:
 +
 +
<source lang="sql">
 +
-- Show table constraints
 +
DROP TABLE OKM_AUTO_ACTION_PARAMS;
 +
</source>
 +
 +
If there is automation rules defined:
 +
 +
<source lang="sql">
 +
-- 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);
 
</source>
 
</source>
  
Line 26: Line 76:
 
<source lang="sql">
 
<source lang="sql">
 
-- Describe table
 
-- Describe table
−
select column_name, udt_name, character_maximum_length from INFORMATION_SCHEMA.COLUMNS where table_name = 'okm_pending_task';
+
select column_name, udt_name, character_maximum_length from INFORMATION_SCHEMA.COLUMNS where table_name = 'okm_node_document_version';
  
 
-- Expand column
 
-- Expand column
 
alter table OKM_NODE_DOCUMENT_VERSION alter column NDV_CHECKSUM type varchar(128);
 
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, '');
 +
</source>
 +
 +
If there is no automation defined:
 +
 +
<source lang="sql">
 +
-- Show table constraints
 +
DROP TABLE OKM_AUTO_ACTION_PARAMS;
 +
</source>
 +
 +
If there is automation rules defined:
 +
 +
<source lang="sql">
 +
-- NOT COMPLETED --
 +
 +
-- Rename table field
 +
ALTER TABLE OKM_AUTO_ACTION_PARAMS RENAME COLUMN AAP_VALIDATION TO AAP_ACTION;
 
</source>
 
</source>
  
Line 54: Line 126:
 
$ grep "ERROR .*hbm2ddl" $TOMCAT_HOME/logs/catalina.log
 
$ grep "ERROR .*hbm2ddl" $TOMCAT_HOME/logs/catalina.log
 
</source>
 
</source>
 +
 +
* 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 [http://update.openkm.com/admin/license_list.php License Manager].
 
* Set installation customer at [http://update.openkm.com/admin/license_list.php License Manager].

Latest revision as of 11:17, 3 July 2013

  • Make a backup!!!

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

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

-- 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
-- Possible null error -> needed to refresh cache !!!
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
  • 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.


Nota clasica.png Recommended to clear browser cache and Java Plugin cache

Retrieved from "https://www.openkm.com/wiki/index.php?title=Knowledge:Migration_from_6.4.0_to_6.4.1&oldid=9968"