Entorno de desarrollo personal

El entorno de desarrollo personal de OpenKM se distribuye como una imagen de máquina virtual (OVA).

El entorno de desarrollo personal incluye todo lo necesario para empezar a trabajar rápidamente:

• Sistema operativo Linux Mint.
• Aplicación OpenKM instalada.
• Base de datos MariaDB.
• Eclipse
  • Ejemplos de código.
  • Ejemplos de workflow.
• IReport
  • Ejemplos SQL.
  • Ejemplos de scripting.

Requisitos

La máquina virtual usa 2 núcleos y 4 GB de RAM; la máquina anfitriona debería tener al menos 4 núcleos y 8 GB de RAM.

Precaución

Sugerimos detener casi todas las aplicaciones mientras se ejecuta la máquina virtual.

Sugerimos instalarla en un equipo de sobremesa en lugar de un portátil. Puede funcionar en un portátil con buen hardware.

Sugerimos usar un SSD para obtener un rendimiento extra en la máquina virtual.

En algunos usuarios hemos observado que ejecutar la máquina virtual desde un disco secundario proporciona un rendimiento extra; parece que algunas placas base no gestionan bien el sistema operativo y la virtualización en el mismo disco duro.

Cómo obtener el entorno de desarrollo personal

Puede descargar el fichero de la máquina virtual desde el centro de descargas de OpenKM.

• Vaya a https://download.openkm.com
• Haga clic en el botón “OpenKM Professional Download Center”.
• Inicie sesión con sus credenciales de cliente.
• En el menú superior, elija Tools.
• En Tools, asegúrese de haber elegido la versión 8.1.x de OpenKM.
• Haga clic en el fichero Open KM-PorDev.ova.

Precaución

El enlace de descarga se envía por correo electrónico.

El enlace solo puede usarse una vez.

Tiene 24 horas desde el envío del correo electrónico para usar el enlace; pasado este tiempo, el enlace caduca.

Cómo instalar

El entorno de desarrollo personal de OpenKM puede instalarse en la mayoría de software de máquinas virtuales, como VirtualBox, VMware y Hyper-V.

Precaución

Dado que OVA (Open Virtual Appliance) no es 100% compatible con todo el software de virtualización, los usuarios de VMware normalmente necesitan realizar algunas modificaciones en el fichero o extraer el mkv para importar la máquina virtual.

Si busca un despliegue rápido, le animamos a usar VirtualBox.

Si decide usar VirtualBox, siga los pasos descritos en el siguiente vídeo https://www.youtube.com/watch?v=9ugBYf5ggu8&feature=emb_logo

Activación de la licencia

Peligro

El entorno de desarrollo personal debe tener conexión a Internet para registrar la licencia.

Finalmente, debe activarse la licencia de su entorno de desarrollo personal; para ello, siga estos pasos:

1- Abra un terminal (la contraseña del usuario openkm es openkm).

2- Ejecute el siguiente comando

$> pdl-reset

3- Inicie el servicio de OpenKM.

$> sudo service openkm start

4- Abra un ticket en el sitio web de soporte al cliente de OpenKM. Comparta el ID de aplicación disponible en la página de inicio de administración.

Cómo actualizar el entorno de desarrollo

Precaución

Dado que la máquina virtual incluye OpenKM, jbpm-console y bibliotecas de compilación, el proceso de actualización tiene al menos tres pasos:

• Actualizar OpenKM
• Actualizar las bibliotecas de compilación de OpenKM
• Actualizar jbpm-console

Paso 1 - Actualización de OpenKM

• Cierre Eclipse.
• Inicie OpenKM como servicio.

$> sudo su
$> service openkm start

• Actualice la herramienta OpenKM como lo haría en cualquier instalación estándar de OpenKM. El proceso de actualización del entorno de desarrollo es exactamente el mismo que el de la actualización de la edición profesional estándar de OpenKM. Más información en Updater utility.

$> cd /home/openkm/Development/tomcat
$> wget http://download.openkm.com/okm/OKMUpdater.jar
$> java -jar OKMUpdater.jar

Nota

El último entorno de desarrollo de OpenKM incluye el script update.sh.

$> cd /home/openkm/Development/tomcat
$> ./update.sh

Paso 2 - Actualización de las bibliotecas de compilación de OpenKM

• Cierre Eclipse.
• Edite el script download.sh y establezca las últimas versiones de OpenKM y jbpm-console en la cabecera.

$> cd /home/openkm/Development/portable/lib
$> nano download.sh

Nota

Script de ejemplo para la versión 7.1.22 (recuerde establecer la versión correcta de JBPM según la tabla de compatibilidad en la sección de documentación de JBPM Console):

#!/bin/bash
OKM_VERSION="7.1.22"
JBPM_VERSION="1.8"

# Download OpenKM libraries
wget http://download.openkm.com/okm/portable/jar/openkm-${OKM_VERSION}-client.jar -O openkm-client.jar
wget http://download.openkm.com/okm/portable/jar/openkm-${OKM_VERSION}-jar-with-dependencies.jar -O openkm-jar-with-dependencies.jar

# Download jBPM libraries
wget http://download.openkm.com/okm/pro/workflow/jbpm-${JBPM_VERSION}-client.jar -O jbpm-client.jar
wget http://download.openkm.com/okm/pro/workflow/jbpm-${JBPM_VERSION}-jar-with-dependencies.jar -O jbpm-jar-with-dependencies.jar

• Ejecute el script download.sh.

$> ./download.sh

• Edite el script register.sh y establezca las últimas versiones de OpenKM en la cabecera.

$> nano register.sh

Nota

Script de ejemplo para la versión 7.1.22 (recuerde establecer la versión correcta de JBPM según la tabla de compatibilidad en la sección de documentación de JBPM Console):

#!/bin/bash
VERSION="7.1.22"
JBPM_VERSION="1.8"

# Register OpenKM libraries
mvn install:install-file -DgroupId=com.openkm -DartifactId=openkm -Dversion=${VERSION} -Dclassifier=client -Dpackaging=jar -Dfile=openkm-client.jar
mvn install:install-file -DgroupId=com.openkm -DartifactId=openkm -Dversion=${VERSION} -Dclassifier=jar-with-dependencies -Dpackaging=jar -Dfile=openkm-jar-with-dependencies.jar

# Register Jbpm libraries
mvn install:install-file -DgroupId=com.openkm -DartifactId=jbpm-console -Dversion=${JBPM_VERSION} -Dpackaging=jar -Dfile=jbpm-client.jar

• Ejecute el script register.sh.

$> ./register.sh

Paso 3 - Actualización de Jbpm-console

• Primero, compruebe la versión correcta de jbpm-console según la tabla de compatibilidad en la sección de documentación de JBPM Console.
• Siga los pasos descritos en la guía de migración.

Solución de problemas

Importar el fichero OVA en una máquina virtual distinta de VirtualBox

Si tiene problemas al importar el fichero OVA proporcionado en una plataforma de máquina virtual distinta de VirtualBox, probablemente se deba a diferencias en los formatos de virtualización. Dado que la mayoría de proveedores de VM no siguen un formato estandarizado, las importaciones directas de OVA entre distintas plataformas a menudo no son compatibles.

Para resolver este problema, siga estos pasos:

• Renombre la extensión del fichero OVA de .ova a .tar.
• Extraiga el contenido del archivo .tar usando su herramienta de extracción preferida.
• Dentro de los ficheros extraídos, localice la imagen de disco virtual, normalmente con extensión .vmdk.
• Cree una nueva máquina virtual manualmente en la plataforma de virtualización elegida.
• Cuando se le solicite una imagen de disco, adjunte el fichero .vmdk extraído como el disco virtual.

Este proceso recrea efectivamente la máquina virtual original usando la imagen de disco extraída, haciéndola compatible con entornos distintos de VirtualBox.