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 flujos de trabajo
• iReport
  • Ejemplos de SQL
  • Ejemplos de scripting

Requisitos

La máquina virtual utiliza 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

Le sugerimos cerrar la mayoría de las aplicaciones mientras ejecuta la máquina virtual.

Le sugerimos instalarla en un ordenador de sobremesa en lugar de un portátil. Aunque puede funcionar en un portátil, se requiere un buen hardware.

Le sugerimos utilizar un SSD para obtener un mayor rendimiento en la máquina virtual.

Para algunos usuarios, ejecutar la máquina virtual en un disco secundario proporciona un rendimiento adicional; 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, seleccione Tools.
• En Tools, asegúrese de haber seleccionado la versión 7.1.x de OpenKM
• Haga clic en el fichero OpenKM-PorDev.ova.

Precaución

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

El enlace solo puede utilizarse una vez.

Dispone de 24 horas desde el envío del correo electrónico para utilizar el enlace; transcurrido este período, el enlace caduca.

Cómo instalarlo

El entorno de desarrollo personal de OpenKM puede instalarse en la mayoría de las plataformas de virtualización, como VirtualBox, VMware y Hyper-V.

Precaución

Como OVA (Open Virtual Appliance) no es 100 % compatible entre los distintos programas de virtualización, los usuarios de VMware suelen necesitar realizar algunas modificaciones en el fichero o extraer el VMDK para importar la máquina virtual.

Si busca un despliegue rápido, le recomendamos utilizar VirtualBox.

Si elige 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.

Por último, debe activar 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 una incidencia en el sitio web de soporte al cliente de OpenKM. Comparta el ID de la aplicación disponible en la página de inicio de administración.

Cómo actualizar el entorno de desarrollo

Precaución

Como la máquina virtual incluye OpenKM, jbpm-console y las librerías de compilación, el proceso de actualización tiene al menos 3 pasos:

• Actualizar OpenKM
• Actualizar las librerías 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 en cualquier instalación estándar de OpenKM. El proceso de actualización del entorno de desarrollo es exactamente el mismo que el de actualización de la edición OpenKM Professional estándar. Encontrará más información en Utilidad de actualización.

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

Nota

El entorno de desarrollo de OpenKM más reciente incluye un script update.sh.

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

Paso 2 - Actualización de las librerías de compilación de OpenKM

• Cierre Eclipse
• Edite el script download.sh con 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 de 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 con 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 de 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

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

Resolución de problemas

Importación del fichero OVA en una máquina virtual que no sea VirtualBox

Si encuentra problemas al importar el fichero OVA proporcionado en una plataforma de máquinas virtuales distinta de VirtualBox, probablemente se deba a diferencias en los formatos de virtualización. Dado que la mayoría de los fabricantes de máquinas virtuales no siguen un formato estandarizado, a menudo no se admite la importación directa de OVA entre distintas plataformas.

Para resolver este problema, siga estos pasos:

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

Este proceso recrea de forma efectiva la máquina virtual original a partir de la imagen de disco extraída, lo que la hace compatible con entornos distintos de VirtualBox.