Updater utility
“Updater utility” de OpenKM es una herramienta administrativa en Java que ayuda a realizar actualizaciones de forma automática. Puede descargarla desde https://download.openkm.com/okm/OKMUpdater.jar.
Parámetros de línea de comandos:
| Parameter | Description |
|---|---|
| -h | Muestra información de ayuda. |
| -d | Actualiza a la versión de desarrollo (solo debería usarse bajo supervisión técnica de OpenKM). |
| -f | Fuerza la actualización. |
| -l | Elimina los logs de Tomcat. |
| -m | Aplica las acciones manualmente. |
| -n | Modo monocromo. |
| -o | Deshabilita las acciones posteriores a la actualización. |
| -r | Deshabilita las acciones previas a la actualización. |
| -u | Sobrescribe la URL de Tomcat detectada. |
| -v | Muestra la versión. |
Etapas de la actualización
Sección titulada «Etapas de la actualización»- Comprueba si está ubicado en la carpeta $TOMCAT_HOME; en caso contrario, mostrará un mensaje de error.
- Solicita al administrador cierta información.
- URL de OpenKM (normalmente algo accesible desde el servidor como http://localhost:8080/openkm).
- Si la aplicación está configurada como un servicio [Y/N].
- El usuario ROLE_ADMIN válido de OpenKM (okmAdmin).
- La contraseña del usuario administrador.
- Comprueba la configuración del servicio, la conexión del usuario y la versión de OpenKM.
- Si la utilidad supera estas comprobaciones, requerirá confirmación del usuario para continuar con la actualización [Y/N].
- Descarga el nuevo fichero openkm.war (versión actual + 1).
- Al finalizar la descarga, ejecutará las acciones previas a la actualización.
- Detiene OpenKM.
- Reemplaza el fichero OpenKM.war antiguo por el recién descargado.
- Modifica el parámetro hibernate.hbm2ddl a update en el fichero $TOMCAT_HOME/openkm.properties.
- Inicia OpenKM de nuevo.
- Comprueba si OpenKM está disponible y, a continuación, ejecuta las acciones posteriores a la actualización.
Modo manual
Sección titulada «Modo manual»Si invoca la utilidad OKMUpdater con el parámetro -m, no se ejecutará ninguna de las acciones, por lo que deberá ejecutarlas manualmente. Según el tipo de acción, deberá usar distintas utilidades ubicadas en Administration > Utility.
Tipos de acciones:
- SQL: Vaya a Administration > Utilities > Database query (elija SQL en la selección)
- HQL: Vaya a Administration > Utilities > Database query (elija HQL en la selección)
- Script: Vaya a Administration > Utilities > Scripting.
Tenga en cuenta que algunas acciones deben ejecutarse antes de la actualización y otras después. Este es el proceso de actualización en resumen:
- Ejecutar acciones PRE
- Detener OpenKM
- Reemplazar openkm.war
- Iniciar OpenKM
- Ejecutar acciones POST