Guía paso a paso para importar una base de datos en Syspanel
Introducción: ¿Por qué necesitas importar una base de datos en Syspanel?
Si estás migrando tu sitio web de WordPress, PrestaShop o cualquier aplicación PHP a un nuevo servidor, uno de los pasos más críticos es importar la base de datos. Sin una base de datos funcional, tu web se mostrará en blanco o con errores de conexión. En Syspanel, el panel de control que utilizamos (similar a HestiaCP, pero accesible por el puerto 2106), este proceso es sencillo si sigues la secuencia correcta.
Esta guía está pensada para usuarios sin experiencia técnica. Aquí te explicaremos, paso a paso, cómo importar un archivo SQL en Syspanel, ya sea desde una copia de seguridad, una migración manual o una exportación de herramientas como phpMyAdmin. Al final, tendrás tu base de datos funcionando y tu sitio web en línea.
Requisitos previos antes de importar
Antes de comenzar, asegúrate de tener lo siguiente:
- Acceso a Syspanel: Ve a
https://tudominio.com:2106e inicia sesión con tu usuario y contraseña. - Archivo SQL: Un archivo con extensión
.sql(por ejemplo,basededatos.sql). Normalmente lo obtienes desde tu hosting anterior o desde una exportación de phpMyAdmin. - Nombre de la base de datos: Debes saber cómo se llama la base de datos en Syspanel (puedes crearla si no existe).
- Usuario de la base de datos: El usuario asociado a esa base de datos (debe tener permisos de lectura y escritura).
[TIP] Si aún no tienes una base de datos creada, en Syspanel ve a "Bases de datos" y haz clic en "Agregar base de datos". El sistema creará automáticamente el nombre y el usuario.
Paso 1: Acceder a Syspanel y localizar la base de datos
- Abre tu navegador y escribe la dirección de Syspanel:
https://tudominio.com:2106. - Ingresa tu usuario y contraseña (los mismos que usas para gestionar tu hosting).
- Una vez dentro, busca en el menú lateral la sección "Bases de datos" o "Base de datos" (depende de la versión). Haz clic ahí.
- Verás una lista con todas las bases de datos de tu cuenta. Identifica la que vas a usar. Si no aparece, créala con el botón "Agregar base de datos".
[INFO] Syspanel asigna nombres como
usuario_basededatos. Por ejemplo, si tu usuario esjuany creas una base llamadamiweb, el nombre final serájuan_miweb.
Paso 2: Preparar tu archivo SQL para la importación
Tu archivo .sql debe ser válido y no estar corrupto. Si lo exportaste desde otro servidor, verifica que:
- No contenga líneas de creación de base de datos (
CREATE DATABASE) porque la base ya existe en Syspanel. - No tenga errores de sintaxis (por ejemplo, caracteres extraños).
- Tenga el tamaño adecuado (si es muy grande, más de 50 MB, puede dar problemas; en ese caso, comprímelo en
.gzo divide el archivo).
[WARNING] Si tu archivo SQL incluye
CREATE DATABASE IF NOT EXISTS, elimina esa línea antes de importar. Syspanel ya tiene la base creada y esa instrucción puede causar conflictos.
Paso 3: Importar la base de datos usando phpMyAdmin (recomendado)
Syspanel incluye phpMyAdmin, una herramienta gráfica que facilita la importación. Sigue estos pasos:
- En la sección "Bases de datos" de Syspanel, busca la base de datos que quieres importar.
- Haz clic en el icono de "phpMyAdmin" (suele ser un símbolo de base de datos o un enlace que dice "Abrir phpMyAdmin").
- Se abrirá una nueva pestaña con phpMyAdmin. Inicia sesión con el usuario y contraseña de la base de datos (los mismos que usaste al crearla en Syspanel).
- En el panel izquierdo, selecciona el nombre de tu base de datos (asegúrate de que esté en negrita, indicando que está activa).
- Ve a la pestaña "Importar" en el menú superior.
- En "Archivo a importar", haz clic en "Seleccionar archivo" y busca tu archivo
.sqlen tu computadora. - Deja las opciones por defecto (formato SQL, juego de caracteres utf-8, etc.).
- Haz clic en "Continuar" o "Ejecutar" en la parte inferior.
El proceso puede tardar unos segundos o minutos, dependiendo del tamaño. Verás un mensaje de éxito como "La consulta se ha ejecutado correctamente".
[TIP] Si el archivo es muy grande (más de 50 MB), phpMyAdmin puede fallar. En ese caso, usa el método alternativo con línea de comandos (Paso 4).
Paso 4: Importar la base de datos usando la terminal (para archivos grandes)
Si tu archivo SQL es pesado o phpMyAdmin te da error, puedes usar el terminal de Syspanel. Este método es más rápido y confiable.
-
En Syspanel, ve a "Avanzado" o "Terminal" (busca un icono de consola o acceso SSH).
-
Se abrirá una ventana de terminal. Si no ves esta opción, puedes conectarte por SSH con un cliente como PuTTY (necesitarás tu IP y contraseña de Syspanel).
-
Una vez en la terminal, escribe el siguiente comando para importar:
mysql -u usuario_basededatos -p nombre_base < /ruta/completa/al/archivo.sql- usuario_basededatos: El usuario de la base de datos (ej.
juan_miweb). - nombre_base: El nombre exacto de la base (ej.
juan_miweb). - /ruta/completa/al/archivo.sql: La ubicación del archivo en el servidor. Si lo subiste antes por FTP, pon la ruta (ej.
/home/juan/web/tudominio/public_html/backup.sql).
- usuario_basededatos: El usuario de la base de datos (ej.
-
Presiona Enter. Te pedirá la contraseña del usuario de la base de datos. Escríbela (no se ve mientras escribes) y presiona Enter.
-
Si todo sale bien, no verás ningún mensaje de error. Puedes verificar con:
mysql -u usuario_basededatos -p nombre_base -e "SHOW TABLES;"Esto listará las tablas importadas.
[WARNING] Asegúrate de que el archivo SQL esté en el servidor. Puedes subirlo por FTP a la carpeta
public_htmlo usar el gestor de archivos de Syspanel.
Paso 5: Verificar que la importación fue exitosa
Después de importar, es importante confirmar que los datos están correctos:
- Vuelve a phpMyAdmin (desde Syspanel).
- Selecciona tu base de datos en el panel izquierdo.
- Deberías ver una lista de tablas (como
wp_posts,wp_usersen WordPress, ops_producten PrestaShop). - Haz clic en cualquier tabla y luego en "Examinar" para ver si los datos están presentes (por ejemplo, entradas, productos, usuarios).
Si ves datos, ¡la importación fue un éxito!
[TIP] Si tu sitio es WordPress, después de importar la base de datos, recuerda actualizar el archivo
wp-config.phpcon los nuevos datos de conexión (nombre de base, usuario, contraseña y servidor, que suele serlocalhost).
Solución de problemas comunes (FAQ)
1. "Error de conexión a la base de datos" después de importar
- Causa: El archivo
wp-config.php(WordPress) oparameters.php(PrestaShop) tiene credenciales antiguas. - Solución: Edita el archivo de configuración y cambia el nombre de la base, usuario y contraseña por los de Syspanel.
2. "El archivo SQL es demasiado grande para phpMyAdmin"
- Causa: Límite de tamaño en phpMyAdmin (normalmente 50 MB).
- Solución: Usa el método de terminal (Paso 4) o comprime el archivo en
.gzy luego impórtalo congunzip < archivo.sql.gz | mysql -u usuario -p nombre_base.
3. "No encuentro la base de datos en Syspanel"
- Causa: No la has creado aún.
- Solución: Ve a "Bases de datos" > "Agregar base de datos", pon un nombre y crea el usuario. Luego importa.
4. "La importación falla con error 'Table already exists'"
- Causa: La base de datos ya tiene tablas con el mismo nombre.
- Solución: Antes de importar, vacía la base de datos (en phpMyAdmin, selecciona todas las tablas y elige "Vaciar") o elimínala y créala de nuevo.
5. "No puedo acceder a phpMyAdmin"
- Causa: El puerto 2106 puede estar bloqueado por tu firewall o red.
- Solución: Prueba desde otra red (como datos móviles) o usa el terminal directamente.
Consejos finales para una migración exitosa
- Haz siempre una copia de seguridad de tu base de datos original antes de importar en Syspanel.
- Si migras WordPress, además de la base de datos, deberás copiar los archivos del sitio (imágenes, plugins, temas) por FTP a la carpeta
public_html. - En PrestaShop, después de importar, ve al backoffice y verifica que los productos, categorías y clientes estén intactos.
- Si tienes dudas, el soporte técnico de Syspanel puede ayudarte. Solo menciona que necesitas ayuda con la importación de SQL.
[INFO] Recuerda que Syspanel usa el puerto 2106 para acceso web. Si tu conexión es lenta, prueba con una red más estable.
Conclusión
Importar una base de datos en Syspanel no es complicado si sigues estos pasos. Ya sea usando phpMyAdmin para archivos pequeños o la terminal para los grandes, el proceso es rápido y seguro. Ahora que tienes tu base de datos funcionando, tu sitio web (WordPress, PrestaShop u otro) estará listo para operar en su nuevo hogar.
Si encuentras algún error, revisa esta guía nuevamente o consulta la sección de preguntas frecuentes. ¡Buena suerte con tu migración!
