Differences

This shows you the differences between two versions of the page.

--- configuration:ils:examples:kohailsdi_driver [2023/03/20 17:10] – created demiankatz
+++ configuration:ils:examples:kohailsdi_driver [2024/02/28 18:46] (current) – [Configuring VuFind® for single instance in ILSDI] demiankatz
@@ Line 1: / Line 1: @@
-====== Configuring the KohaRest ILS Driver ======
+====== Configuring the KohaILSDI ILS Driver ======
+// Thanks to Mariyapillai Jayakananthan and Mohan Pradhan for developing this documentation. //
+=====Configuring VuFind® for single instance in ILSDI=====
+Copy the KohaILSDI.ini default configuration file from **$VUFIND_HOME/config/vufind** into the **$VUFIND_LOCAL_DIR/config/vufind** directory. For example:
+<code bash>
+cp $VUFIND_HOME/config/vufind/KohaILSDI.ini $VUFIND_LOCAL_DIR/config/vufind
+</code>
+Edit the file **KohaILSDI.ini** and input the following information under the **[Catalog]** section:
+<code bash>
+host = IP address or hostname of Koha server (you can use "localhost" if VuFind® and Koha are installed on the same server)
+port = 3306
+username = User created in MariaDB or MySQL server
+password = Password given while creating user in MariaDB/MySQL server
+database = Name of database used by Koha
+</code>
+Example:
+ {{ :configuration:ils:examples:koha_ilsdi.png |}}
+The IP/hostname, username, password and database will likely be different in your case.
+See the [[configuration:ils:examples:koha_ilsdi_database|Configure Koha's database to allow access for VuFind®]] page for details on establishing MariaDB/MySQL database credentials.
+==== Troubleshooting Database Connectivity ====
+We are using port 3306 in our example. If your connection does not work, it can be helpful to troubleshoot whether the port is accessible. You can perform this test on your VuFind® server by running this command:
+<code bash>
+telnet KohaServerIP 3306
+</code>
+If it is successful, you will see something like this:
+{{ :configuration:ils:examples:telnet_example.png |}}
+Note: In the example above, the IP address is 10.100.30.217. Your IP will be different. The indicator of success is the message "Connected to 10.100.30.217."
+If it is unsuccessful (e.g. the telnet session times out or has its connection refused), you will have to enable remote access to your Mariadb/MySQL database. The procedure is given in this article: [[https://webdock.io/en/docs/how-guides/database-guides/how-enable-remote-access-your-mariadbmysql-database|How to enable Remote access to your MariaDB/MySQL database]].
-:!: Details coming soon.
 ---- struct data ----
 properties.Page Owner :
 ----