Instalación

Instalación local

Aprenderás a instalar Gigantics como una aplicación en tu máquina local o como una instancia de Docker.

Requisitos

Gigantics puede ser instalado en Linux y Windows. Es necesario tener una base de datos MongoDB (v4.0 o superior) instalada en un servidor.

Recomendamos un servidor con 8GB de RAM. En caso de tener en el mismo servidor Gigantics y MongoDB, nuestra recomendación es un servidor con 16GB de RAM.

Instalación en Linux / Mac

Para la instalación, descarga el archivo gigantics-linux.tar.gz desde la web y descomprímelo. Desde la terminal ejecuta ./gig start.

Una vez iniciado, ve a localhost:5000 a través del navegador y configura la instancia.

Instalación en Windows

Para instalar Gigantics en Windows, descarga el archivo desde la web y descomprímelo. Abre la consola (cmd.exe) y ejecuta el archivo gig.exe.

Para iniciar el servidor, ejecuta el archivo gig.exe junto con el parámetro start.

cd <path_to_gigantics>
gig.exe start

Una vez iniciado, ve a localhost:5000 a través del navegador y configura la instancia.

🚧 Instalación en Docker 🚧 (próximamente)

Docker es una de las alternativas de instalación para instalar Gigantics en un entorno virtual. Para realizar esta instalación es necesario tener Docker instalado en tu computadora o servidor y que esté funcionando para ejecutar los comandos necesarios.

Tenemos una imagen de Docker que puedes encontrar en Docker Hub con todo lo que necesitas para comenzar a usar Gigantics.

docker pull gigantics/gigantics

Puedes verificar la versión instalada actualmente

docker run gigantics/gigantics --version

Parámetros Adicionales

Puedes inicializar tu instancia de Gigantics utilizando un entorno diferente. Para hacerlo, puedes usar el parámetro -c para especificar el archivo de configuración que se utilizará.

./gig start -c path/to/json

Ejecutando como Daemon

Simplemente agrega el parámetro -d para ejecutar Gigantics como un daemon en el sistema

./gig start -d

Workers

Inicia el servidor en modo clúster utilizando el parámetro -w:

• -1 = deshabilitar clúster
• 0 = bifurcar a todos los CPUs disponibles

./gig start -w=-1

Ayuda

Consulta más comandos ejecutando la ayuda

./gig -h

Ejecutando Gigantics por primera vez

Ve a localhost:5000 para iniciar la configuración del servidor

Configuración de drivers

Para algunas de las bases de datos soportadas es necesario instalar los drivers manualmente. Aquí están los pasos para proceder con la instalación.

Oracle

Para instalar los drivers de Oracle es necesario tener instalado el paquete instantclient de Oracle:

Instalación de Oracle

Mac OS / Linux

Finalmente, para que Gigantics pueda usar el driver, debe estar en la ruta /opt/instantclient_19_8/.

De lo contrario, puedes establecer la ruta del cliente instantáneo iniciando la instancia de Gigantics utilizando LD_LIBRARY_PATH:

> LD_LIBRARY_PATH=C:/instantclient_19_8 ./gig.exe start

> LD_LIBRARY_PATH=/opt/instantclient_19_17:$LD_LIBRARY_PATH ./gig start

Windows

Los archivos del cliente instantáneo para Microsoft Windows se pueden descargar desde aquí:

Oracle Instant Client

Sigue la documentación sobre cómo instalar los paquetes de Node.js y node-oracledb en Microsoft Windows:

Installing Node.js and node-oracledb on Microsoft Windows

A continuación, abre el Panel de control y busca la opción Configuración avanzada del sistema, haz clic en Variables de entorno y establece las variables de sistema LD_LIBRARY_PATH y DEBASER_ORACLE_CLIENT a C:\gigantics-bin\instantclient_19_8\ o la ruta donde colocaste la carpeta del cliente instantáneo.