Instalación¶
Requisitos¶
Se requiere el siguiente software para construir y ejecutar SynchDB. Las versiones listadas son las versiones probadas durante el desarrollo. Las versiones anteriores pueden seguir funcionando. * Java Development Kit 22. Descargar aquí * Apache Maven 3.9.8. Descargar aquí * PostgreSQL 16.3 Source. Clonar Git aquí. Consulte esta wiki para los requisitos de compilación de PostgreSQL * Docker compose 2.28.1 (para pruebas). Consultar aquí * Sistema operativo basado en Unix como Ubuntu 22.04 o MacOS
Preparar Fuente¶
Clone el código fuente de PostgreSQL y cambie a la etiqueta de la versión 16.3
1 2 3 |
|
Clone el código fuente de SynchDB desde dentro de la carpeta de extensiones Nota: La rama (synchdb-devel)[https://github.com/Hornetlabs/synchdb/tree/synchdb-devel] se usa para desarrollo hasta ahora.
1 2 |
|
Preparar Herramientas¶
Instalar Maven¶
Si está trabajando en Ubuntu 22.04.4 LTS, instale Maven como se muestra a continuación:
sudo apt install maven
Si está usando MacOS, puede usar el comando brew para instalar maven (consulte (aquí)[https://brew.sh/] para saber cómo instalar Homebrew) sin ninguna otra configuración:
brew install maven
Instalar Java SDK (OpenJDK)¶
Si está trabajando en Ubuntu 22.04.4 LTS, instale OpenJDK como se muestra a continuación:
sudo apt install openjdk-21-jdk
Si está trabajando en MacOS, instale JDK con el comando brew:
brew install openjdk@22
Compilar e Instalar PostgreSQL¶
Siga la documentación oficial de PostgreSQL aquí para compilar e instalar PostgreSQL desde el código fuente. Generalmente, el procedimiento consiste en:
1 2 3 4 |
|
También debe compilar e instalar las extensiones predeterminadas:
1 2 3 |
|
Compilar e Instalar el Motor Debezium Runner¶
Con Java y Maven configurados, estamos listos para compilar el Motor Debezium Runner. Esto instala el archivo jar de Debezium Runner Engine en la carpeta lib de PostgreSQL.
1 2 3 |
|
Compilar e Instalar la Extensión PostgreSQL de SynchDB¶
Con la lib
y el include
de Java instalados en su sistema, SynchDB puede compilarse mediante:
1 2 3 |
|
Configurar su Enlazador (Ubuntu)¶
Por último, también necesitamos indicarle al enlazador de su sistema dónde se encuentra la biblioteca Java recién agregada. El siguiente procedimiento está basado en Ubuntu 22.04.
1 2 3 4 5 6 7 8 9 10 |
|
1 2 |
|
Ejecute ldconfig para recargar:
sudo ldconfig
Verificar Instalación¶
Asegúrese de que la extensión synchdb.so pueda enlazarse con la biblioteca Java libjvm en su sistema:
ldd synchdb.so
linux-vdso.so.1 (0x00007ffeae35a000)
libjvm.so => /usr/lib/jdk-22.0.1/lib/server/libjvm.so (0x00007fc1276c1000)
libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007fc127498000)
libdl.so.2 => /lib/x86_64-linux-gnu/libdl.so.2 (0x00007fc127493000)
libpthread.so.0 => /lib/x86_64-linux-gnu/libpthread.so.0 (0x00007fc12748e000)
librt.so.1 => /lib/x86_64-linux-gnu/librt.so.1 (0x00007fc127489000)
libm.so.6 => /lib/x86_64-linux-gnu/libm.so.6 (0x00007fc1273a0000)
/lib64/ld-linux-x86-64.so.2 (0x00007fc128b81000)