Documentación
OrangeHRM
Actualización de OrangeHRM
Sumas y limitaciones
OrangeHRM y TurnKey base OS
Este doc cubre explícitamente la actualización de OrangeHRM v4.x (TurnKey v17.x) y/o OrangeHRM v5.x (TurnKey v18.x) a la última versión estable de OrangeHRM (v5.7 en el momento de escribir). Lo hace NOT cubrir actualizar el sistema operativo TurnKey/Debian subyacente a la última versión.
TurnKey v17.x se basa en Debian 11/Bullseye. Bullseye está actualmente en "LTS" (apoyo a largo plazo) y recibirá actualizaciones de seguridad al menos hasta 31 de agosto de 2026TurnKey v18.x se basa en Debian 12/Reserva. El bóker de libros se apoyará hasta que al menos 30 de junio de 2028.
Este doc también asume:
- TKLBAM está habilitado (o lo habilitas) - nota que esto no es necesario, pero es altamente recomendable.
- Su servidor tiene suficiente espacio libre para la actualización - 2GB se recomienda pero más siempre es mejor.
Este doc utiliza comandos terminales para la mayor parte del proceso. Muchos pasos pueden ser posibles a través de Webmin pero los comandos terminales son concisos y pueden ser copiados/pasados por lo que son bastante fáciles de seguir. Cualquier paso donde sepas cómo lograr los mismos resultados a través de Webmin, no dudes en usar eso en su lugar.
Se recomienda el acceso a CLI del servidor TurnKey a través de “SSH” (concha segura). Windows 11 versiones recientes, Mac OSX y todos los sabores de escritorio Linux todo el barco con OpenSSH cliente pre-instalado pero hay un número de clientes alternativos SSH que también funcionan bien.
Alternativamente en TurnKey v17.x puede utilizar el servidor "Webshell" a través de su navegador; https en el puerto 12320. En TurnKey v18.x puede utilizar el módulo de terminal interactivo Webmin “proper” (v18.x no incluye WebShell).
DO NOT utiliza el terminal TurnKey v17.x Webmin! No es un verdadero terminal interactivo y causará problemas.
Generalmente un cliente local SSH le dará una mejor experiencia de usuario (por ejemplo. copy/paste debe trabajar de forma fiable) pero el módulo terminal interactivo de v17.x o V18.x Webmin debe funcionar bien.
Para iniciar una sesión SSH:
ssh root@DOMAIN_OR_PUBLIC_IP
Si está usando claves de autenticación en lugar de una contraseña, es posible que necesite incluir explícitamente el camino a la clave privada en su sistema local:
# Linux/OSX ssh -i ~/path/to/my_private_key root@DOMAIN_OR_PUBLIC_IP # Windows C:\Users\ME\path\to\my_private_key root@DOMAIN_OR_PUBLIC_IP
Nota para usuarios de AWS Marketplace
AWS Los casos de mercado tienen la cuenta de ‘root’ deshabilitada por defecto. habilitar la raíz o iniciar sesión como ‘admin’ y luego convertirse en raíz como esta:
sudo su -
Primer paso - preparación
Antes de comenzar la actualización OrangeHRM, asegúrese de que tiene una copia de seguridad actual y suficiente espacio libre. También recomiendo que actualice todos los paquetes del sistema y reinicie el sistema antes de comenzar la actualización.
Retroceso
Recomendo crear tanto una “snapshot” como una copia de seguridad “proper”. Una instantánea no es técnicamente una copia de seguridad, pero cargar una instantánea es una manera rápida y fácil de volver a exactamente donde usted está ahora mismo si es necesario.
Si su servidor se ejecuta a través de la TurnKey Hub, puede activar una instantánea a través de la central página “servadores”. Tenga en cuenta que puede tomar algún tiempo para completar. Otras plataformas de virtualización/cloud también deben tener esta funcionalidad - consultar los documentos pertinentes si no está seguro de cómo. Los servidores de metal de la barra pueden utilizar una herramienta como Clonezilla.
Suponiendo que esté usando TKLBAM, active manualmente una copia de seguridad completa de TKLBAM de su servidor. Puede hacerlo a través de Webmin o a través de un terminal:
tklbam-backup --full-backup now
Compruebe el espacio libre y la limpieza si es necesario
Para comprobar el espacio libre:
df -h /
Producto de ejemplo (Servidor de vacío con volumen raíz de 10 GB):
Filesystem Size Used Avail Use% Mounted on /dev/xvda 10.0G 2.1G 8.0G 21% /
Mira la columna “Avail” (8.0G en el ejemplo anterior). Recojo al menos 1GB espacio mínimo libre, preferiblemente al menos 2 GB. Si no tienes suficiente, primero haz una limpieza como abajo. Por favor, DO NOT simplemente ingrese ciegamente "y" en el segundo (autoremove) comando:
apt clean apt autoremove
El comando 'autoremove' sólo debe enumerar algunos paquetes, probablemente incluyendo los kernels antiguos (paquetes que comienzan con 'linux-image'). Si enumera un gran número de paquetes o lista cualquier paquete básico, por favor, asegúrese de comprobar su función y si algún aumento de preocupaciones puede eliminar manualmente los que aparecen seguro para eliminar usando 'apt eliminar PKG1 PKG2 ...'. Si usted tiene preocupaciones y tiene suficiente espacio libre, simplemente saltar este paso por ahora.
Actualizar software OS (opcional)
Para actualizar el software del sistema a las últimas versiones envasadas:
apt update apt upgrade
Si usted ejecuta este paso, también recomiendo re-correr los comandos de limpieza de apt anteriores, reiniciar su servidor y doble chequear espacio libre.
Soporte local manual (opcional)
Con una instantánea y una copia de seguridad TKLBAM, haciendo otro copias de seguridad pueden parecer exageradas. Sin embargo, yo diría que múltiples capas de redundancia siempre son deseables. Entonces si algo va mal, usted tiene múltiples opciones de recuperación y caminos para restaurar la funcionalidad. Sin embargo, este paso es puramente opcional y una instantánea y una copia de seguridad completa de TKLBAM proporcionan suficientes opciones de recuperación.
Depósito manual de la DB
mysqldump orangehrm > orangehrm_db.sql.orig
Actualizar OrangeHRM v4.x a v4.10.1
La última versión de OrangeHRM en el momento de escribir es v5.7. Pero debe ejecutar v4.10.1 (la última versión v4.x) para actualizar a v5.x. Si ya está ejecutando v4.10.1 o posterior, por favor, omita este paso.
OrangeHRM proporcionar documentación de actualización pero le proporcionaré un paso a paso más detallado y TurnKey específico.
Descargar v4.10.1
wget https://sourceforge.net/projects/orangehrm/files/stable/4.10.1/orangehrm-4.10.1.zip
Mover la instalación existente
mv /var/www/orangehrm /var/www/orangehrm.orig
Desempaquetar nueva versión
unzip orangehrm-4.10.1.zip mv orangehrm-4.10.1 /var/www/orangehrm
Dar acceso a los archivos OrangeHRM necesarios para el servidor web:
chown -R www-data:www-data /var/www/orangehrm/lib/{confs,logs}
chown -R www-data:www-data /var/www/orangehrm/symfony/{config,apps/orangehrm,cache,log}
Consiga la contraseña de usuario existente de DB ‘orangehrm’ (del archivo de configuración antiguo):
grep -m 1 password /var/www/orangehrm.orig/symfony/config/databases.yml
Instala y activa la extensión de la cremallera de php:
apt install --yes php-zip systemctl restart apache2
Cargar página de actualización en su navegador web
Abra en su navegador web y navegar por la página de “aceleración” de su sitio de OrangeHRM:
https://DOMAIN_OR_PUBLIC_IP/upgrader/web
E.g.:
https://orangehrm.domain.com/upgrader/web
A menos que desee hacer un “limpio” instalar DO NOT sólo cargar su dominio sin el ‘/upgrader/web’ URL. De lo contrario, sobreescribirá sus datos existentes.
Introduzca los detalles del DB
Host*: 127.0.0.1 Port: 3306 Username* orangehrm Password <password from the above 'grep' command> Database Name: orangehrm
Luego haga clic en el botón "Proceded".
Verificación de sistema
Todo debe estar bien, pero comprobar doblemente que cada línea tiene un “OK” verde en la página de verificación del sistema.
Asumiendo que todo está bien, haga clic en el botón "Proceder".
Seleccione la versión actual de OrangeHRM
Desde el desplegable, seleccione la versión actual/antigua OrangeHRM. A menos que ya haya actualizado, TurnKey v17.1 debe tener la versión OrangeHRM '4.9'. Independientemente, puede confirmar la versión actual/antiguo con este comando:
grep -m 1 'OrangeHRM ver' /var/www/orangehrm.orig/CHANGELOG.TXT
Por defecto debe devolver:
New & Changed Features for OrangeHRM ver 4.9
Seleccione la versión relevante y haga clic en el botón “Proceder”.
Aplicar cambios manuales - si es necesario
La siguiente página mostrará los pasos/cambios manuales que necesite realizar. Durante mi prueba, el único paso manual adicional indicado se aplica a la cifrado de datos.
Si ha habilitado el cifrado de datos, copie las claves criptográficas de su antiguo directorio OrangeHRM.
cp /var/www/orangehrm.orig/lib/confs/cryptokeys/key.ohrm /var/www/orangehrm/lib/confs/cryptokeys/
Una vez que haya realizado cualquier paso manual adicional, haga clic en el botón "Proceder".
Base de datos actualizada
La siguiente página realmente realizará la actualización de la base de datos. Como se ha señalado, la actualización puede tardar un poco y es VERY importante que no cierre o vuelva a cargar esa página hasta que el progreso alcance el 100% y el botón "Iniciar" cambie a un botón “Procedido”.
Haga clic en el botón "Iniciar" y una vez que haya completado, haga clic en el botón "Proceder".
Crear nuevos archivos de configuración
La siguiente página generará los nuevos archivos de configuración. Este paso no debe tardar mucho, pero según la página de actualización de bases de datos anterior, DO NOT cerrar o volver a cargar esa página.
Haga clic en el botón "Iniciar" y una vez que haya completado, haga clic en el botón "Proceder".
Finalizar la actualización
Usted debe ser recibido con una página titulada “¡Felicitaciones!”, señalando que usted está ejecutando ahora OrangeHRM v4.10.1.
Como se señala en esa página, asegúrese de que cualquier paso manual esté completo (debería haber sido manejado dentro del paso anterior “Aplicar cambios manuales” pero puede comprobarlos de forma doble desde el paso anterior archivo marcado dentro de su directorio OrangeHRM:
cat /var/www/orangehrm/upgrader/log/notes.log
Haga clic en el botón "Proceder".
Valida tus datos actualizados de OrangeHRM
Después del paso anterior se redireccionará de nuevo a la página de inicio de sesión. Inicie sesión utilizando su usuario y contraseña ‘admin’.
Como se señaló en la página final “¡Felicitaciones!”: √≥ [...] hacer una completa ronda de verificación de datos para ver si los datos de la versión anterior √≥n han sido importados correctamente.
En particular, compruebe que estas páginas están disponibles e incluya sus datos: - Admin - PIM - Leave
Actualizar OrangeHRM v4.10.1 a v5.7
Una serie de pasos para actualizar a v5.7 son muy similares a la actualización anterior.Estos pasos probablemente también se aplicarán a actualizaciones posteriores v5.x. Sin embargo, OrangeHRM v5.x incluye un instalador/extremo CLI que estas instrucciones cubrirán.
Según la actualización v4.10.1, OrangeHRM proporciona documentación de actualización pero eso sólo cubre la actualización webUI. Estas instrucciones proporcionarán notas específicas TurnKey usando la herramienta CLI.
Preparación
Doble check free space y crear una nueva copia de seguridad del sistema operativo & instantánea según la actualización inicial OrangeHRM v4.
También crear una base de datos manual de respaldo local:
mysqldump orangehrm > orangehrm_v4.10.1_db.sql
Descargar v5.7
wget https://sourceforge.net/projects/orangehrm/files/stable/5.7/orangehrm-5.7.zip
Mover la instalación existente
mv /var/www/orangehrm /var/www/orangehrm-4.10.1
Desempaquetar nueva versión
unzip -o orangehrm-5.7.zip mv orangehrm-5.7 /var/www/orangehrm
Instalación de actualización mediante CLI
La actualización CLI es mucho más rápida y fácil IMO.
Asegúrese de que tiene su contraseña de base de datos existente:
grep -m 1 password /var/www/orangehrm.*/symfony/config/databases.yml
Luego cambia al nuevo directorio OrangeHRM (que descargaste y desembolsaste arriba) y ejecuta la herramienta CLI. Tenga en cuenta que necesitarás reemplazar ‘
cd /var/www/orangehrm
php installer/console upgrade:run \
--dbHost=127.0.0.1 \
--dbPort=3306 \
--dbName=orangehrm \
--dbUser=orangehrm \
--dbUserPassword=<db password> \
--currentVersion=4.10.1
Verificar el medio ambiente
El comando anterior producirá un poco de texto justo. Gran parte de él puede ser ignorado de forma segura, pero por favor, compruebe la sección "Comprobación de sistema". Todos los valores deben ser verdes (o amarillos si no se usan).
Si alguno de los controles del sistema son rojos, necesitará responder “n” y resolverlos primero antes de rehacer el comando de actualización arriba.
Asumiendo que todos los controles del sistema están bien, pulsa Enter (“sí” es el predeterminado).
La actualización puede tardar un poco, pero eventualmente se completará y saldrá sin ningún mensaje de error.
Valida tus datos actualizados de OrangeHRM
Una vez que el script de actualización se complete, inicie sesión en su instancia OrangeHRM a través de su navegador web y valide que todos sus datos están allí y todo está funcionando como debe.
Suponiendo que así sea, felicitaciones - ahora estás ejecutando el último OrangeHRM! :)