Difference between revisions of "Knowledge:Migration from 6.2.8 to 6.2.9"

From OpenKM Documentation
Jump to: navigation, search
m
 
(16 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
* See [http://issues.openkm.com/changelog_page.php?version_id=66 changelog at Mantis]
 
* See [http://issues.openkm.com/changelog_page.php?version_id=66 changelog at Mantis]
  
−
* Download update from http://openkm.com/download/okm/OpenKM-6.2.9.zip (password eMpg8eIjY5)
+
* Download update from http://openkm.com/download/okm/OpenKM-6.2.9.zip (eMpg8eIjY5)
  
 
* Make a backup!!!
 
* Make a backup!!!
Line 10: Line 10:
  
 
* Run from your preferred SQL client these queries:
 
* Run from your preferred SQL client these queries:
 +
'''HSQL'''
 +
<source lang="sql">
 +
-- First check if there are pending tasks
 +
select * from OKM_PENDING_TASK;
 +
 +
-- Rename table field
 +
alter table OKM_PENDING_TASK alter column PTK_PARAM rename to PTK_PARAMS;
 +
alter table OKM_PENDING_TASK change PTK_PARAM PTK_PARAMS varchar(512);
 +
</source>
  
 
'''MySQL'''
 
'''MySQL'''
 
<source lang="sql">
 
<source lang="sql">
−
-- Check if there are pending tasks
+
-- First check if there are pending tasks
 
select * from OKM_PENDING_TASK;
 
select * from OKM_PENDING_TASK;
  
 
-- Rename table field
 
-- Rename table field
 
alter table OKM_PENDING_TASK change PTK_PARAM PTK_PARAMS varchar(512);
 
alter table OKM_PENDING_TASK change PTK_PARAM PTK_PARAMS varchar(512);
 +
</source>
 +
 +
'''PostgreSQL'''
 +
<source lang="sql">
 +
-- First check if there are pending tasks
 +
select * from OKM_PENDING_TASK;
 +
 +
-- Rename table field
 +
-- Also see http://sniptools.com/databases/resize-a-column-in-a-postgresql-table-without-changing-data
 +
alter table OKM_PENDING_TASK rename column PTK_PARAM to PTK_PARAMS;
 +
alter table OKM_PENDING_TASK alter column PTK_PARAMS type varchar(512);
 +
</source>
 +
 +
'''Oracle'''
 +
<source lang="sql">
 +
-- First check if there are pending tasks
 +
select * from OKM_PENDING_TASK;
 +
 +
-- Rename table field
 +
alter table OKM_PENDING_TASK rename column PTK_PARAM to PTK_PARAMS;
 +
alter table OKM_PENDING_TASK modify (PTK_PARAMS varchar2(512));
 
</source>
 
</source>
  
Line 23: Line 53:
  
 
* Replace the OpenKM.war
 
* Replace the OpenKM.war
 +
 +
* Review file descriptor limit and, eventually, [http://okm07.openkmcloud.com/OpenKM/index.jsp?docPath=%2Fokm%3Aroot%2FKnowledge+Base%2FSet+ulimit+in+Ubuntu.html increase it].
  
 
* Start Tomcat again
 
* Start Tomcat again
  
−
* Ensure HTML Editor configuration parameters values are correct '''okm_checkin, okm_cancelcheckout, okm_searchDocument, okm_searchFolder, newdocument, codehighlighting,''' |, bold etc...
+
* Check for database errors:
 +
 
 +
<source lang="bash">
 +
$ grep "ERROR .*hbm2ddl" $TOMCAT_HOME/logs/catalina.log
 +
</source>
 +
 
 +
* Set installation customer at [http://update.openkm.com/admin/license_list.php License Manager].
 +
 
 +
* Ensure HTML Editor configuration parameters values ('''tinymce.theme.buttons1''') are correct: '''okm_checkin, okm_cancelcheckout, okm_searchDocument, okm_searchFolder, newdocument, codehighlighting,''' |, bold etc...
  
 
* Enjoy OpenKM 6.2.9!
 
* Enjoy OpenKM 6.2.9!

Latest revision as of 08:03, 27 September 2013

  • Make a backup!!!
  • Before upgrade to version 6.2.9 ensure you do not have any profile with web skin set to test.
  • Stop Tomcat
  • Run from your preferred SQL client these queries:

HSQL 

-- First check if there are pending tasks
select * from OKM_PENDING_TASK;

-- Rename table field
alter table OKM_PENDING_TASK alter column PTK_PARAM rename to PTK_PARAMS;
alter table OKM_PENDING_TASK change PTK_PARAM PTK_PARAMS varchar(512);

MySQL 

-- First check if there are pending tasks
select * from OKM_PENDING_TASK;

-- Rename table field
alter table OKM_PENDING_TASK change PTK_PARAM PTK_PARAMS varchar(512);

PostgreSQL 

-- First check if there are pending tasks
select * from OKM_PENDING_TASK;

-- Rename table field
-- Also see http://sniptools.com/databases/resize-a-column-in-a-postgresql-table-without-changing-data
alter table OKM_PENDING_TASK rename column PTK_PARAM to PTK_PARAMS;
alter table OKM_PENDING_TASK alter column PTK_PARAMS type varchar(512);

Oracle 

-- First check if there are pending tasks
select * from OKM_PENDING_TASK;

-- Rename table field
alter table OKM_PENDING_TASK rename column PTK_PARAM to PTK_PARAMS;
alter table OKM_PENDING_TASK modify (PTK_PARAMS varchar2(512));
  • 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
  • Ensure HTML Editor configuration parameters values (tinymce.theme.buttons1) are correct: okm_checkin, okm_cancelcheckout, okm_searchDocument, okm_searchFolder, newdocument, codehighlighting, |, bold etc...
  • Enjoy OpenKM 6.2.9!

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.2.8_to_6.2.9&oldid=10671"