# Actualizar un servidor de 1.x a 2.0 Esta guía lleva un servidor con Devkron 1.x a 2.0 LTS sin interrumpir la operación más de lo necesario y con un camino de regreso en minutos. La actualización **no toca bases de datos ni archivos de las aplicaciones**: 2.0 se instala en otra carpeta, se prueba en paralelo y se cambia el `upstream` de nginx. Antes de empezar: - pida a Induxsoft la **licencia de 2.0** para el servidor: la de 1.x no sirve ([Licencia](/es/devkron/2.0/instalacion/licencia.md)); - lea [Diferencias con 1.x](/es/devkron/2.0/migracion/diferencias.md) y [Cultura](/es/devkron/2.0/migracion/cultura.md). ## 1. Revise la compatibilidad de sus aplicaciones Lo que más importa: - código que **formatea números o fechas y luego los vuelve a leer**, si el servidor no es es-MX ([Cultura](/es/devkron/2.0/migracion/cultura.md)); - uso de **plantillas GT** (`dklgt/main-template`, `#include … with/build`), que se retiraron; - scripts o `cron` que dependían de que `dkl` siempre terminara con código 0; - código JavaScript que esperaba recibir con estado 200 las páginas de error ([Errores HTTP 500](/es/devkron/2.0/migracion/errores-http.md)); - **funciones declaradas dentro de otra función** en programas web ([Aislamiento por petición](/es/devkron/2.0/migracion/aislamiento.md)). Una búsqueda rápida: ```bash grep -rnE 'parse\.num\(format\(|val\(format\(|dklgt/main-template|#include .* (with|build) ' /opt/devkron/web ``` ## 2. Instale 2.0 en una carpeta nueva ```bash unzip -q Devkron-2.0-Linux-x64.zip -d /tmp/devkron-2.0 sudo mv /tmp/devkron-2.0/Devkron-2.0-Linux-x64 /opt/devkron2 sudo chmod +x /opt/devkron2/dkl ``` En Windows, `C:\devkron2`. La distribución se descarga como se indica en [Descargas](/es/devkron/2.0/instalacion/descargas.md). No toque la carpeta de 1.x. Vea [Instalar en Linux](/es/devkron/2.0/instalacion/linux.md) o [en Windows](/es/devkron/2.0/instalacion/windows.md). ## 3. Copie de 1.x lo que no es del motor | Copiar de 1.x | Notas | |---|---| | sitios (`web/`), aplicaciones y paquetes | tal cual | | el controlador `fastcgi/` | solo si lo modificó; si no, use el de 2.0 | | `fastcgi.json` | y agregue lo nuevo (paso 4) | | `adapters.xml` | el de 2.0 ya trae los cuatro adaptadores; copie el suyo solo si lo personalizó | | `connections.xml` | el formato no cambió; las conexiones cifradas siguen funcionando | | DLL de **extensiones** | funcionan sin recompilar ([Extensiones .NET](/es/devkron/2.0/instalacion/extensiones-net.md)) | | marcos de `dkl-web` (`crudl/`, `fso/`, `webauth.dkl`…) | si los usa ([Bibliotecas y marcos](/es/devkron/2.0/instalacion/bibliotecas-y-marcos.md)) | **No copie** `devkron.license` de 1.x (no sirve: instale la de 2.0) ni sobrescriba ningún archivo de la distribución 2.0 (`Devkron*.dll`, `System.*.dll`, `Microsoft.*.dll`, drivers, `*.dkh`, `dkl`). Para ver qué DLL son extensiones: ```bash comm -23 <(cd /opt/devkron && ls *.dll | sort) <(cd /opt/devkron2 && ls *.dll | sort) ``` Las DLL del sistema que se copiaban junto a `dkl` en 1.x (`System.Net.dll`, `System.Web.HttpUtility.dll`, `System.IO.Compression.ZipFile.dll`…) ya vienen en 2.0: no las copie. Si escribe en volúmenes SMB o NFS montados, no necesita bibliotecas adicionales ([Escribir en volúmenes de red](/es/devkron/2.0/migracion/linuxfixes.md)). ## 4. Ajuste `fastcgi.json` Agregue lo nuevo que convenga ([Servidor FastCGI](/es/devkron/2.0/instalacion/fastcgi.md)): - `"culture": "es-MX"` (o la cultura de su país): fija cómo se muestran números y fechas; - `unix_socket` y `unix_socket_mode` en lugar del puerto TCP; - `max_body_size` para limitar las subidas; - `native_cache_dir` y `native_key_file`, si va a encender la compilación nativa (viene apagada). Para la prueba en paralelo use **otro socket o puerto** que el de 1.x. ## 5. Pruebe en paralelo Levante 2.0 a mano con la copia de los sitios (o con los mismos, si sus pruebas no escriben datos) y un `server` de nginx de prueba que apunte a él: ```bash cd /opt/devkron2 sudo -u devkron ./dkl -fastcgi fastcgi.json ``` ```nginx server { listen 8080; server_name erp.ejemplo.com; location / { include fastcgi_params; fastcgi_pass unix:/run/devkron2-prueba/devkron.sock; } } ``` Recorra los flujos principales y compare con 1.x: inicio de sesión, altas y consultas, reportes, subidas de archivos, servicios JSON. Las tareas de consola se prueban con `/opt/devkron2/dkl tarea.dkl`. Durante la prueba el servidor estará en modo demo si todavía no instaló la licencia de 2.0: solo atiende `*.localhost` y `127.0.0.1`. Use un nombre como `erp.localhost` en el `server_name` de prueba, o instale la licencia antes. ## 6. Cambie Instale la unidad systemd de 2.0 ([Servicio en Linux](/es/devkron/2.0/instalacion/servicio-linux.md)) con `WorkingDirectory=/opt/devkron2`, detenga 1.x, arranque 2.0 y apunte el `upstream` de nginx al nuevo socket o puerto: ```bash sudo systemctl stop devkron1 && sudo systemctl disable devkron1 sudo systemctl enable --now devkron sudo nginx -t && sudo systemctl reload nginx ``` (`devkron1` es el nombre de la unidad de 1.x en el ejemplo; use el de la suya.) Quite la línea `fastcgi_param HTTP_COOKIE $http_cookie;` de nginx si quiere: ya no hace falta y no estorba. Revise también las tareas de `cron` o del Programador de tareas: cámbielas a `/opt/devkron2/dkl` y agregue `DEVKRON_CULTURE=es-MX` si formatean números o fechas. ## 7. Vigile Las primeras horas, revise: - el journal del servicio: `journalctl -u devkron -f`; - el `error.log` de nginx (502, 504); - los 500 en el `access.log` de nginx: en 2.0 los errores no manejados llegan con estado 500 (en 1.x llegaban con 200), así que es normal ver 500 que antes estaban ocultos; - la memoria del proceso. La compilación nativa viene apagada; si la enciende, la primera petición de cada programa se interpreta y se compila en segundo plano, y es normal ver más CPU y memoria al principio. ## Regresar a 1.x ```bash sudo systemctl stop devkron && sudo systemctl disable devkron sudo systemctl enable --now devkron1 # la unidad de 1.x # devolver el upstream de nginx al socket o puerto de 1.x sudo nginx -t && sudo systemctl reload nginx ``` - 2.0 no cambia el esquema ni el formato de los datos: lo que escribió lo lee 1.x. Al regresar rigen otra vez las reglas de 1.x: `dbr.login` de 2.0 acepta más combinaciones de columnas de contraseña y `dbr.lock` es reentrante ([Diferencias](/es/devkron/2.0/migracion/diferencias.md)). - Programas escritos con **sintaxis nueva** (`$$`, `->`, `$x`, funciones `list.*` nuevas, bibliotecas estándar nuevas) **no** corren en 1.x. - La caché de compilados y la llave se pueden borrar; 1.x no las usa. - Devkron 1.x en Linux necesita `libssl1.1`; no la desinstale mientras conserve 1.x. ## Desde Windows con IWA Si el servidor de 1.x se instaló con IWA e IIS: 1. Instale 2.0 en `C:\devkron` ([Instalar en Windows](/es/devkron/2.0/instalacion/windows.md)). 2. Copie los sitios y las extensiones de la instalación de IWA (`%ProgramData%\induxsoft\machine\winShell\v10\`, o la carpeta donde estén) como en el paso 3, y el repositorio de conexiones que usaba como `C:\devkron\connections.xml`. La variante para Windows de 1.x guardaba sus conexiones bajo `%ProgramData%\induxsoft\machine\`; si no lo localiza, vuelva a dar de alta las conexiones ([Conexiones](/es/devkron/2.0/instalacion/conexiones.md)). 3. Levante el servidor FastCGI ([Servicio en Windows](/es/devkron/2.0/instalacion/servicio-windows.md)) y configure IIS con [iis2dkl](/es/devkron/2.0/instalacion/iis.md), o cambie a nginx para Windows. 4. La ventana de administración de conexiones ya no existe: administre `connections.xml` a mano o con las funciones `dba.*` ([Conexiones](/es/devkron/2.0/instalacion/conexiones.md)).