# Instalar Devkron 2.0 en Linux Esta guía instala la distribución autónoma de Devkron 2.0 LTS en un servidor o equipo Linux de 64 bits, comprueba que funciona y deja listo el comando `dkl`. Después podrá ejecutar programas de consola y levantar el servidor FastCGI. ## Requisitos - Linux de 64 bits (x64): Ubuntu, Debian, RHEL, Rocky, Alma y derivados actuales. - **No necesita instalar .NET ni ningún otro runtime**: la distribución es autónoma. - Bibliotecas del sistema que cualquier distribución de servidor ya trae: `libicu` (culturas y formatos) y OpenSSL 3 (`libssl` 3, para TLS hacia las bases de datos). **Ya no se necesita `libssl1.1`**, que Devkron 1.x pedía en Debian 12 y posteriores. - `unzip` para descomprimir la distribución. - Para servir sitios web, nginx (vea [nginx con FastCGI](/es/devkron/2.0/instalacion/nginx.md)). - Permisos de administrador (`sudo`) para instalar en `/opt`. ## 1. Descargue y verifique la distribución Descargue `Devkron-2.0-Linux-x64.zip` y `SHA256SUMS` de la carpeta de la versión en el repositorio de versiones publicadas (vea [Descargas](/es/devkron/2.0/instalacion/descargas.md)). Con los dos archivos en la misma carpeta, compruebe que el zip llegó íntegro: ```bash sha256sum -c SHA256SUMS --ignore-missing ``` ```text Devkron-2.0-Linux-x64.zip: OK ``` Si dice `FAILED`, descárguelo otra vez. ## 2. Descomprima en la carpeta de instalación La carpeta recomendada es `/opt/devkron`; si su organización usa otra (por ejemplo `/usr/devkron`), ajuste las rutas de esta guía. No hay instalador: se descomprime y se configura. El zip trae la instalación dentro de una carpeta con el nombre de la distribución: ```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/devkron sudo chmod +x /opt/devkron/dkl sudo find /opt/devkron/tools -type f ! -name '*.*' -exec chmod +x {} + ``` Los dos últimos comandos solo hacen falta si la herramienta con que descomprimió no conservó el permiso de ejecución de `dkl` y de las herramientas de `tools/`. Todas las configuraciones vienen como ejemplo (`*.example`) y nada viene activado. Copie la del servidor FastCGI sin la extensión; las demás, cuando las necesite: ```bash sudo cp /opt/devkron/fastcgi.json.example /opt/devkron/fastcgi.json ``` Si ya tiene Devkron 1.x en el servidor, **no lo sobrescriba**: instale 2.0 en otra carpeta (por ejemplo `/opt/devkron2`) y siga [Migrar de 1.x a 2.0](/es/devkron/2.0/migracion/). ## 3. Compruebe que funciona ```bash /opt/devkron/dkl ``` ```text Devkron ----------- Debe indicar al menos un argumento en la línea de comando. Por ejemplo: - Para ejecutar un programa dkl programa.dkl [-opciones del intérprete] - Para iniciar el servicio de FastCGI con la configuración predeterminada dkl -fastcgi - Para iniciar el servicio de FastCGI con un archivo de configuración dkl -fastcgi archivo_configuracion.json - Para consultar la licencia del servidor dkl -license ``` Y un programa real. Guarde `/tmp/hola.dkl`: ```dkl #include "dkli.dkh" #! program "hola" { #include "functions.dkh" do print("Hola mundo") } ``` ```bash /opt/devkron/dkl /tmp/hola.dkl -hide-log ``` ```text Hola mundo ``` ## 4. Ponga `dkl` en el PATH (opcional) Para escribir solo `dkl` desde cualquier carpeta, cree un enlace en `/usr/local/bin`: ```bash sudo ln -s /opt/devkron/dkl /usr/local/bin/dkl dkl /tmp/hola.dkl -hide-log ``` El enlace funciona porque `dkl` busca sus bibliotecas y cabeceras junto al archivo real, no junto al enlace. ## Estructura de la instalación ```text dkl ejecutable: consola y servidor FastCGI dkl.r2r.dll código nativo precompilado (en la distribución ReadyToRun composite, la predeterminada) Devkron*.dll, DevkronFastCGI.dll, Devkron.DBR.dll, induxsoft*.dll motor y bibliotecas propias MySqlAdapter.dll, SQLSvrAdapter.dll, PostgreAdapter.dll, FirebirdSqlAdapter.dll adaptadores de datos MySqlConnector.dll, Microsoft.Data.SqlClient.dll, Npgsql.dll, FirebirdSql.Data.FirebirdClient.dll drivers System.*.dll, Microsoft.*.dll, lib*.so runtime incluido en la distribución (incluye System.Net.dll, System.Web.HttpUtility.dll, System.IO.Compression.ZipFile.dll, System.Text.RegularExpressions.dll... que las aplicaciones cargan con _import_library) dkli.dkh, functions.dkh, serialize.dkh, dbr.dkh, webcl.dkh cabeceras DKL del motor http.dkh, fs.dkh, log.dkh, hash.dkh... bibliotecas estándar, con sus Devkron.Ext.*.dll crudl/, fso/, _templates/, webauth.dkl, cookies.dkl, createsite.dkl... marcos de trabajo (dkl-web) fastcgi.json.example ejemplo de configuración del servidor FastCGI (cópielo como fastcgi.json) fastcgi/ controlador HTTP en DKL (http.dkl, routing.dkl, alias.dkl, auth.dkl, mime.dkl, render.dkl, 404.dkl, 500.dkl) web/ sitios: web// o web/ para el sitio predeterminado (trae páginas de ejemplo) adapters.xml adaptadores de datos registrados (los cuatro) connections.xml.example ejemplo del repositorio de conexiones LEEME.md, NOTICE.txt, manifest.json resumen, avisos de terceros y versión de cada componente mysql_connections_repo.sqldic consultas del repositorio de conexiones en MySQL license.txt licencia de uso del software tools/ herramientas: dklwebsvr, w3se y httptn, cada una en su subcarpeta ``` Archivos que agrega usted: `fastcgi.json` (a partir del ejemplo), `connections.xml` ([Conexiones](/es/devkron/2.0/instalacion/conexiones.md)), `devkron.license` ([Licencia](/es/devkron/2.0/instalacion/licencia.md)), las DLL de extensiones de sus aplicaciones ([Extensiones .NET](/es/devkron/2.0/instalacion/extensiones-net.md)), las bibliotecas de terceros ([Bibliotecas y marcos](/es/devkron/2.0/instalacion/bibliotecas-y-marcos.md)) y sus sitios en `web/`. Qué hace cada herramienta de `tools/` está en [Descargas](/es/devkron/2.0/instalacion/descargas.md). Lo que Devkron crea al funcionar, en el `HOME` del usuario que lo ejecuta: la llave de integridad de la caché de compilados (`~/.config/devkron/native.key`) y una carpeta `.dotnet` (la usa el runtime). Si se usa la compilación nativa, también la caché de compilados (`native-cache/`). Vea [Servicio en Linux](/es/devkron/2.0/instalacion/servicio-linux.md) para fijarlas en carpetas del servicio. **Borre o reemplace las páginas de ejemplo de `web/`** antes de exponer el servidor: `web/upload.dkl` guarda archivos subidos y muestra el contenido completo de la petición; solo sirve para pruebas. ## Dónde busca Devkron sus archivos | Archivo | Dónde lo busca | |---|---| | `fastcgi.json` | el que se indique en `dkl -fastcgi archivo.json`; si no existe, `fastcgi.json` del directorio de trabajo; si tampoco, valores por omisión | | `adapters.xml`, `connections.xml` | primero en el **directorio de trabajo** (como en 1.x); si no están ahí, **junto a `dkl`** (nuevo en 2.0) | | `devkron.license` | directorio de trabajo | | controlador (`"controller"`) y sitios (`web/`) | relativos al directorio de trabajo | | `#include` de cabeceras (`dkli.dkh`…) | carpeta del programa, rutas de `#path` y carpeta de `dkl` | | `_import_library("X.dll")` sin ruta | carpeta de `dkl` | Por eso el servidor FastCGI y `dkl -license` se ejecutan con el **directorio de trabajo en la carpeta de la instalación**. ## Siguientes pasos 1. [Ejecutar programas de consola](/es/devkron/2.0/instalacion/consola.md). 2. [Servidor FastCGI](/es/devkron/2.0/instalacion/fastcgi.md) y [Servicio en Linux (systemd)](/es/devkron/2.0/instalacion/servicio-linux.md). 3. [nginx con FastCGI](/es/devkron/2.0/instalacion/nginx.md) o, sin nginx, [dklwebsvr](/es/devkron/2.0/instalacion/dklwebsvr.md). 4. [Licencia](/es/devkron/2.0/instalacion/licencia.md) y [Conexiones a bases de datos](/es/devkron/2.0/instalacion/conexiones.md). ## Errores típicos | Síntoma | Causa | Solución | |---|---|---| | `unzip: command not found` | el sistema no tiene `unzip` | `sudo apt install unzip` o `sudo dnf install unzip` | | `Permission denied` al ejecutar `./dkl` | el archivo perdió el permiso de ejecución | `sudo chmod +x /opt/devkron/dkl` | | `No usable version of libssl was found` | es el mensaje de Devkron **1.x**; 2.0 no lo necesita | compruebe que ejecuta el `dkl` de la carpeta de 2.0 | | error de ICU al arrancar (`Couldn't find a valid ICU package`) | el sistema no tiene `libicu` | instale el paquete de ICU de su distribución (por ejemplo `libicu74` en Ubuntu 24.04, `libicu72` en Debian 12 o `libicu` en RHEL) | | `No se pudo encontrar el archivo: programa.dkl` | ruta del programa incorrecta | indique la ruta completa o ejecute desde su carpeta | | `dkl -license` muestra `Invalid or Demo License` aunque instaló la licencia | `devkron.license` se lee del **directorio actual** | `cd /opt/devkron && ./dkl -license` con un usuario que pueda leer el archivo |