diff --git a/doc/rst/database.rst b/doc/rst/database.rst index d272cdc6..957d262f 100644 --- a/doc/rst/database.rst +++ b/doc/rst/database.rst @@ -2,6 +2,64 @@ Database ======== +.. index:: remote_db (remote_db) + +.. _remote_database: + +Remote Databases +---------------- + +XCA supports connections to network databases. Tested engines are: + + - MariaDB / mySQL + - PostgreSQL + - Microsoft SQLserver + +Table prefix +'''''''''''' + +The table prefix can be used to store more than one XCA database in the same +remote database. + +Database Drivers +'''''''''''''''' + +The SQL backend drivers provided by the manufacturer of the database must be +installed additionally to the Database support in XCA. + +Linux +..... + +The backend drivers are provided by your distribution: + + - **Debian**: *libqt6sql6-psql*, *libqt6sql6-mysql* or *libqt6sql6-odbc*. + - **RPM**: *libqt6-database-plugin-pgsql*, *libqt6-database-plugin-mysql*, + *libqt6-database-plugin-odbc* + +They should pull in all necessary dependencies. + +Apple macos +........... + + - **PostgreSQL**: Install the https://postgresapp.com/ + - **ODBC**: It requires the /usr/local/opt/libiodbc/lib/libiodbc.2.dylib. + When installing unixodbc via brew the library must be symlinked from + /opt/homebrew/Cellar/libiodbc/3.52.16/lib/libiodbc.2.dylib + - **MariaDB**: Probably via ODBC ? + +Windows +....... + + - **PostgreSQL**: https://www.enterprisedb.com/downloads/postgres-postgresql-downloads + (Commandline tools are sufficient). Add the bin directory of the Postgres + installation directory to your PATH (C:\\Program Files\\PostgreSQL\\16) + - **ODBC**: Use the *ODBC Datasources 64bit* app to configure the SQL Server + If the data source is configured completel, only the matching DSN + - **MariaDB (MySQL)**: Install the Plugin from here: + https://github.com/thecodemonkey86/qt_mysql_driver. Select the MinGW variant + and install it as documented. + + .. _extracting-items: Extracting items diff --git a/misc/dynamic.wxs.in b/misc/dynamic.wxs.in index 11f48261..956ca42d 100644 --- a/misc/dynamic.wxs.in +++ b/misc/dynamic.wxs.in @@ -33,23 +33,20 @@ - + + Description="Access to ODBC databases sources like Microsoft SQL Server. This driver requires no additional DLL from Microsoft."> + Description="Additional PostgreSQL Commandline Tools required from: https://www.enterprisedb.com/downloads/postgres-postgresql-downloads"> + + - - - - - - diff --git a/misc/xca.wxs b/misc/xca.wxs index f3330b2f..3e37de18 100644 --- a/misc/xca.wxs +++ b/misc/xca.wxs @@ -124,6 +124,9 @@ + + + diff --git a/widgets/OpenDb.cpp b/widgets/OpenDb.cpp index 72ab81a3..f94c8d8d 100644 --- a/widgets/OpenDb.cpp +++ b/widgets/OpenDb.cpp @@ -12,6 +12,7 @@ #include "MainWindow.h" #include "OpenDb.h" +#include "Help.h" #include "XcaWarning.h" #include "lib/base.h" #include "lib/dbhistory.h" @@ -110,6 +111,8 @@ OpenDb::OpenDb(QWidget *parent, const QString &db) driver_selected(); connect(dbType, SIGNAL(currentIndexChanged(int)), this, SLOT(driver_selected())); + + mainwin->helpdlg->register_ctxhelp_button(this, "remote_db"); } QString OpenDb::getDbType() const