Differences

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

--- configuration:ils:examples:kohailsdi_driver [2023/04/24 16:58] – 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 KohaILSDI ILS Driver ======
-// Thanks to Mohan Pradhan for developing this documentation. //
+// Thanks to Mariyapillai Jayakananthan and Mohan Pradhan for developing this documentation. //
-=====Configuring VuFind for single instance in ILSDI=====
+=====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:
@@ Line 12: / Line 12: @@
 Edit the file **KohaILSDI.ini** and input the following information under the **[Catalog]** section:
 <code bash>
-host = ip or url
+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  server
+username = User created in MariaDB or MySQL server
-password = password given while creating user in MariaDB server
+password = Password given while creating user in MariaDB/MySQL server
-database = name of database of koha
+database = Name of database used by Koha
 </code>
@@ Line 23: / Line 24: @@
  {{ :configuration:ils:examples:koha_ilsdi.png |}}
-The ip, username, password, database and url will be different in your case.
+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:
-We are using port 3306 in our example. You can check your port number with the command:
 <code bash>
-telnet KohaSeverIP 3306
+telnet KohaServerIP 3306
 </code>
@@ Line 34: / Line 40: @@
 {{ :configuration:ils:examples:telnet_example.png |}}
-Note: In our example, the ip address is 10.100.30.217. Your ip will be different.
+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, you will have to enable remote access to your Mariadb/MySQL database. The procedure is given on  [[https://webdock.io/en/docs/how-guides/database-guides/how-enable-remote-access-your-mariadbmysql-database|this page]].
+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]].
 ---- struct data ----