אגרונט לייב באינטרנט

האגרונט החדש מסוגל לעבוד מול בסיס הנתונים של הלקוח וכך לאפשר לקוראים להאריך השאלות ולבצע הזמנות כותרים ישירות מול הספריה.

התקנת mysql

כדי לעבוד בצורה זאת, כך שה-db של הלקוח יעבוד עם שרת האגרונט יש לבצע מספר פעולות ליצירת השיתוף. נצטרך ליצור אצל הלקוח mysql שניתן להורידו מאתר mysql. צריך להתקין את ה-mysql אצל הלקוח במחשב שעובד 24/7.

ניכנס ל-mysql שהתקנו באמצעות שורת הפקודה: <highlightSyntax language="bash">mysql -u root -p</highlightSyntax> ניצור database שישמש גם את הלקוח וגם את האגרונט: <highlightSyntax language="mysql">CREATE DATABASE lib_data;</highlightSyntax> לאחר מכן, כדי להתחבר משרת האגרונט ללקוח צריך לאפשר זאת ב-mysql של הלקוח: <highlightSyntax language="mysql">GRANT ALL ON lib_data.* TO lib_data_user@library.org.il IDENTIFIED BY 'PASSWORD';</highlightSyntax>

שימו לב: יש לאפשר חיבור מהאגרונט (www.library.org.il) לשרת ה-mysql אצל הלקוח. לכן, יש לפתוח את פורט 3306 שמשמש את ה-mysql

לאחר מכן, נבדוק אם הגדרנו זאת כהלכה. נריץ את הפקודה הבאה משרת האגרונט: <highlightSyntax language="bash">mysql -h remote_host -u lib_data_user -Ap lib_data</highlightSyntax>

יצירת טבלאות

לאחר מכן נצטרך ליצור את שלושת הטבלאות שדרושים לשיטה זו: <highlightSyntax language="mysql">CREATE TABLE `Loans` (

 `ID` int(11) NOT NULL AUTO_INCREMENT,
 `card_no` int(11) DEFAULT NULL,
 `copy_no` int(11) DEFAULT NULL,
 `date_borrowed` datetime NOT NULL,
 `date_returned` datetime DEFAULT NULL,
 `date_promise` datetime DEFAULT NULL,
 `ismanuy` tinyint(4) DEFAULT '0',

`LoanType` int(11) DEFAULT NULL,

 PRIMARY KEY (`ID`),
 UNIQUE KEY `card_no_2` (`card_no`,`copy_no`,`date_borrowed`),
 KEY `card_no` (`card_no`),
 KEY `copy_no` (`copy_no`),
 KEY `date_borrowed` (`date_borrowed`)

) ENGINE=InnoDB DEFAULT CHARSET=utf8;

CREATE TABLE `LoansHistory` (

 `ID` int(11) NOT NULL  AUTO_INCREMENT,
 `card_no` int(11) DEFAULT NULL,
 `copy_no` int(11) DEFAULT NULL,
 `date_borrowed` datetime NOT NULL,
 `date_returned` datetime DEFAULT NULL,
 `date_promise` datetime DEFAULT NULL,
 `ismanuy` int(11) DEFAULT NULL,

`LoanType` int(11) DEFAULT NULL,

 PRIMARY KEY (`ID`),
 UNIQUE KEY `card_no_2` (`card_no`,`copy_no`,`date_borrowed`),
 KEY `card_no` (`card_no`),
 KEY `copy_no` (`copy_no`),
 KEY `date_borrowed` (`date_borrowed`)

) ENGINE=InnoDB DEFAULT CHARSET=utf8;

CREATE TABLE `Reservations` (

 `res_no` int(11) NOT NULL AUTO_INCREMENT,
 `reader_no` int(11) NOT NULL,
 `title_no` int(11) NOT NULL,
 `By_copy` int(11) DEFAULT NULL,
 `reserve_date` datetime DEFAULT NULL,
 `DeadLineDate` datetime DEFAULT NULL,
 `ExpireDate` datetime DEFAULT NULL,
 `SendEmail` tinyint(4) DEFAULT NULL,

`SendLetter` tinyint(4) DEFAULT NULL, `SendSMS` tinyint(4) DEFAULT NULL, `SendSMS2` tinyint(4) DEFAULT NULL, `DateSend` datetime DEFAULT NULL, `DateReceived` datetime DEFAULT NULL, `IsReader` tinyint(4) DEFAULT NULL,

 PRIMARY KEY (`res_no`),
 UNIQUE KEY `reader_no_2` (`reader_no`,`title_no`,`By_copy`,`reserve_date`),
 KEY `title_no` (`title_no`),
 KEY `reader_no` (`reader_no`),
 KEY `reserve_date` (`reserve_date`)

) ENGINE=InnoDB DEFAULT CHARSET=utf8;</highlightSyntax>

שימו לב: ניתן להריץ את הפקודות גם מהלקוח וגם משרת האגרונט. האחרון בגלל ההרשאה שנתנו בהתחלה.

שימו לב: {{{1}}}

העברת המידע מהאקסס ל-mysql

עכשיו תוכל להעביר את ה-data אל הטבלאות מה-lib_data.mdb של הלקוח לטבלאות הנ"ל (מומלץ לעשות זאת אצל הלקוח). ניתן לעשות זאת באמצעות MS Access to MySQL. הכלי הינו gui וקל לתפעול.

אזהרה: יש להעביר את המידע מהטבלאות ולא את מבנה הטבלאות! את מבנה הטבלאות יצרנו כבר בשלב הקודם.

עדכון התוכנה אצל הלקוחות

עדכון התוכנה מתחלק ל-2 שלבים: עדכון ה-lib_data ועדכון ה-lib_appml.

אזהרה: יש לבצע גיבוי גם ל-lib_data וגם ל-lib_appml לפני שנמשיך.

lib_data

1. כדי ליצור קישור מה-lib_data ל-mysql נצטרך להתקין MySQL ODBC. הורידו והתקינו את התוסף בשרת.
2. ניצור DSN ל-mysql כדי שאקסס יוכל להתקשר ל-mysql. ניכנס ל-control panel ושם ל-administrative tools. נבחר ב-data sources (odbc). ניצור בכרטיסיית system DSN קישור לבסיס נתונים שיצרנו ב-mysql לעיל.
3. נחזור ל-lib_data ונסיר את כל הקשרי גומלין של שלושת הטבלאות: loans, loans_history ו-reservations.
4. נמחק את שלושת הטבלאות הנ"ל.
5. נוסיף את שלושת הטבלאות של ה-mysql שיצרנו קודם ל-lib_data באמצעות הקישור של ה-odbc.
6. ניצור מחדש את קשרי הגומלין של הטבלאות החדשות: הטבלה loans אמור להיות מקושרת ל-readers ו-copies; הטבלה reservations אמורה להיות מקושרת ל-readers ו-titles.

אזהרה: הטבלה loans_history אינה מקושרת לשום טבלה.

lib_appml

1. נוסיף את קשרי הגומלין כפי שעשינו בחלק הקודם לשלושת הטבלאות החדשות.
2. נסיר את שלושת הטבלאות הישנות.

שימו לב: שמות הטבלאות החדשות אמורות להיות באותו שם של הטבלאות הישנות.

יצירת טריגרים

ניצור טריגרים שיעזרו לנו ליצור database "חי" באגרונט. בשביל הטריגרים נצטרך לייבא את הטבלה copies מה-lib_data (רק לייבא) בעזרת ה-tool שהוזכר קודם (MS Access to MySQL). יצירת הטריגרים מתבצעת כדלקמן: <highlightSyntax language="mysql">CREATE TRIGGER update_loan_copy_status_on_insert AFTER INSERT ON Loans FOR EACH ROW UPDATE copies SET copies.status = 2 WHERE copies.copy_no = NEW.copy_no;

CREATE TRIGGER update_loan_copy_status_on_delete AFTER DELETE ON Loans FOR EACH ROW UPDATE copies SET copies.status = 1 WHERE copies.copy_no = OLD.copy_no;

DELIMITER |

CREATE TRIGGER update_reservation_time_on_insert BEFORE INSERT ON Reservations FOR EACH ROW IF (NEW.reserve_date IS NULL) THEN SET NEW.reserve_date = NOW(); END IF;|

DELIMITER ;</highlightSyntax>

שימו לב: לטריגר האחרון נצטרך לשנות את ה-delimeter (כפי שניתן לראות בפקודות).

הגדרת אגרונט

יש לבצע הגדרות במשתני הניהול של הספריה בתוך פאנל הניהול. יש להגדיר את המשתנים הבאים:

• live_driver
• live_database
• live_user
• live_password
• live_prefix
• אם יש שימוש בגירסת אגרון 10 יש להוסיף את המשתנה agron10 למשתני הניהול.

שימו לב: את הערכים יש לקחת לפי ההגדרות שביצענו קודם.

יצירת סקריפט יבוא

כרטיס הקורא מתבסס על ה-data של ה-mysql המרוחק (כלל הטבלאות שב-lib_data), לכן נצטרך להריץ סקריפט אוטומטי שייבא באופן אוטומטי פעם ביום את הטבלאות מה-lib_data של הספריה אל ה-mysql. מבצעים זאת בעזרת MS Access to MySQL. בעזרת הכלי הנ"ל נבצע את זה פעם אחת ולפני שנריץ נשמור את הגדרות היבוא (יש לחצן במסך האחרון לפני ההרצה) כדי ליצור סקריפט מהגדרות אלו.

נגדיר סקריפט בשרת שירוץ פעם ביום ויריץ את הפקודה הבאה:

"PATH_OF_MSACCESS_TO_MYSQL\EXECUTE.exe" SETTINGS="move_lib_data.ini", AUTORUN, HIDE

כאשר PATH_OF_MSACCESS_TO_MYSQL\EXECUTE.exe זה הנתיב לקובץ ההרצה של הכלי MS Access to MySQL (מוגדר בהתקנה של הכלי; בד"כ זה ימצא ב-c:\program files).

שימו לב: מגדירים אוטומציה של סקריפטים בחלונות במשימות מתוזמנות (Scheduled tasks) תחת לוח הבקרה.

עדכון גיבוי ושרת מרכזי

יש לעדכן בשרת library.org.il מספר דברים ע"מ שהטבלאות יעברו גם לשרת המרכזי ויגובו בהתאם. לשם כך יש לבצע את הפעולות הבאות.

עדכון hosts

יש לעדכן את קובץ hosts בשרת library.org.il ולהוסיף לו את ה-host של הספריה שבה נמצא ה-mysql המרוחק: <highlightSyntax language="bash">x.x.x.x library_name-server </highlightSyntax> כאשר library_name אמור להיות ה-sub-domain של הספרייה ו-x.x.x.x אמור להיות ה-IP.

עדכון סקריפט גיבוי

יש לעדכן את סקריפט הגיבוי ע"י עדכון הקובץ /usr/local/bin/backup_remote_mysql.sh. יש להוסיף את השורה הבאה: <highlightSyntax language="bash">/usr/local/bin/backup_remote_mysql_server.sh library_name-server library_name </highlightSyntax> כמו בשלב הקודם יש להחליף את library_name עם ה-sub-domain של הספריה.

ראה גם

• SQL