Update guide

Caution

The Updater utility can be used from version 6.4.6 and upper. For older OpenKM version contact with your OpenKM support.

 Download the latest “Updater utility” named OKMUpdater.jar

Danger

• Please, make a backup before any update.

 Once downloaded, put at $TOMCAT_HOME directory and execute:

$ java -jar OKMUpdater.jar -l

Follow the wizard steps.

Note

More information at Updater utility.

Note

If you access the Internet using a proxy, just configure it when executing the application:

$ java -Dhttp.proxyHost=192.168.0.1 -Dhttp.proxyPort=3128 -jar OKMUpdater.jar -l

Caution

It is recommended to clear browser cache (prevents “The response could not be deserialized” errors) and Java Plugin cache.

Danger

In case you have a Cluster configuration be careful because all the OpenKM instances share the same database, so once you have updated a node the others should be updated without executing the actions so they can be reviewed and executed manually. Ask for support if unsure about which actions should be executed in slave nodes.

$ java -jar OKMUpdater.jar -l -m

Troubleshooting

In early OpenKM installations (v6.4.7) the upgrade process may need some previous steps. If you see an error like this one, you have this problem:

 

To be able to use the updater utility you have to follow these steps:

• Download the same version of your current OpenKM instance from http://download.openkm.com.
• Stop OpenKM.
• Replace the $TOMCAT_HOME/webapps/OpenKM.war file with the downloaded one.
• Delete the $TOMCAT_HOME/webapps/OpenKM directory.
• Start OpenKM.

Once OpenKM is running you can use the updater utility again.

If the problem persist, please open a support ticket and attach OKMUpdater.log and $TOMCAT_HOME/logs/catalina.log files.