Konfiguracja dostępu ODBC Macrologic

Wstęp

Dokument opisuje konfigurację dostępu przez system AMAGE do baz danych MacroLogic/MacroBase za pomocą interfejsu ODBC oraz sterowników jdbc.

Dane wejściowe

Aby poprawnie skonfigurować dostęp wymagane jest posiadane archiwum konfiguracyjnego dla systemów Linux (tutaj w przykładzie). Bazujemy w przykładzie na plikach udostępnionych w archiwum jterm_2014_r2032.

Konfiguracja ODBC

Należy na systemie operacyjnym zainstalować pakiety linuxodbc i umożliwić ich konfigurację w systemie. Dokument ten pomija listę pakietów wymaganych do instalacji, gdyż jest to zależne od wybranej dystrybucji oraz wersji pakietów.

Konfigurację zaczynamy od definicji sterownika MacroBase. Wprowadzamy te dane do pliku /etc/odbcinst.ini. Przykładowa konfiguracja.

[MacroBase]
Driver=/opt/xpertis/libmodbc.so
Driver64=/opt/xpertis/libmodbc64.so
Description=Sterownik ODBC dla MacroBASE
Threading=0
UsageCount=1

Zawartość katalogu ze sterownikami, bibliotekami. UWAGA. Plik wykonywalny MacroAppBASIC jest istotny do działania komunikacji !

libmodbc64.so  libmodbc.so  MacroAppBASIC  readme.txt

Następnie konfigurujemy plik /etc/odbc.ini, gdzie definiujemy źródło danych. W tym źródle danych podajemy adres serwera, grupę oraz inne dane uzyskane od wdrożeniowców/administratorów baz danych MacroBase.

Przykładowa konfiguracja.

[xpertis]
DRIVER=MacroBase
UID=
PWD=
LDAPLOGIN=0
AS=1
UTF8X3=
ASNAME=fiks
ASGROUP=firma
ASADDRESS=192.168.1.1
ASPORT=5582
ASCERTUSE=0
ASCERTPTH=
UTF8X3=

Połączenie można zweryfikować poprzez narzędzia komunikacji z bazami z pakietu linuxodbc. Po poprawnym połączeniu do bazy za pomocą użytkownika/hasła możemy przejść dalej. Jeśli na tym etapie nie możemy się połączyć do bazy danych, należy rozwiązać problem z komunikacją.

Należy szczególną uwagę zwrócić na biblioteki i pakiety. Wersja 64bit systemu wymaga 64bitowych bibliotek i programów pomocniczych !

Konfiguracja Apache Tomcat

Aby aplikacje (WebApps) uruchomione na kontenerze servletów Tomcat (lub innym) działały poprawnie należy udostępnić aplikacjom sterownik odbc wraz z niezbędnymi bibliotekami. Najprościej jest udostępnić ten sterownik jako bibliotekę dla wszystkich aplikacji uruchamianych na danym serwerze poprzez skopiowanie plików do katalogu bibliotek dzielonych /var/lib/tomcat9/lib

Zawartość takiego katalogu

ibconsnet.so
libm0odbcj.so
libm1odbcj.so
libmodbc64.so
libtermnet.so
macro.lng
mjdbclib.jar
libm0odbcj64.so
libm1odbcj64.so
libmodbc64_legacy.so
libmodbc.so
MacroAppBASIC
mjdbc.jar

Po uruchomieniu ponownym Tomcat’a aplikacja może się łączyć za pomocą standardowego połączenia JDBC.

Konfiguracja aplikacji natywnych java (konsolowe)

Aby uruchomić komunikację dla aplikacji konsolowych java należy w parametrach uruchomieniowych dodać biblioteki do załadowania (ClassPath).

Przykład parametrów dla aplikacji bazujących na NetBeans Platform

--cp:a /opt/assetsyncconf/libs/mjdbc/mjdbclib.jar --cp:a /opt/assetsyncconf/libs/mjdbc/mjdbc.jar

Po włączeniu do ścieżek ClassPath w/w bibliotek komunikacja standardowo za pomocą interfejsu JDBC.

Howto powstało na bazie wersji systemu 1.17.0.2 (03.2022) oraz przedstawia funkcje, które mogą nie być dostępne w Twoim systemie. Zapytaj AMAGE o udostępnienie tej funkcjonalności.
Ze względu na ciągły rozwój systemu niektóre ekrany lub pliki konfiguracji mogą wyglądać nieznacznie inaczej, ale zachowają nadal pełną funkcjonalność tutaj opisaną. Nie wpływa to na zasadnicze funkcje opisywane w tym dokumencie.