גרסה אחרונה מ־15:33, 2 ביולי 2010

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

במקרה ומדובר בספריה חדשה שמתווספת לשרת אגרון ההתקנה מבוצעת ע"י סקריפט newsite.bat בשרת החלונות או newsite.sh בשרת הלינוקס (כל הפלטפורמה מותקנת כבר בשרת). יש להכניס פרמטר אחד ויחיד לסקריפט והוא שם הספריה באנגלית (ללא רווחים, מקפים או קווים תחתונים). שם זה יהיה התחילית של הדומיין שבו יהיה ניתן למצוא את הספריה ואת קובץ הנתונים יש להניח בספריה באותו שם בתוך השרת ב-d:\data\mdb.

במקרה ומדובר בהתקנה שלמה (אצל שרת לקוח) יש להתקין את הכלים שמריצים את שרת אינטרנט במקרה והוא לא מותקן. הכלים העיקריים שרצים הינה אפאצ'י, mysql ו-PHP, או בקיצור AMP. ניתן להתקין את האגרונט גם על שרת IIS.

התקנת AMP – אפאצ'י, mysql ו-PHP

ההתקנה כולה מתבצעת לתוך c:\amp, כך שכל התוכנות מותקנות במיקום אחד.

ניתן להתקין את אגרונט גם על IIS במקום על אפאצ'י. כדי לעשות זאת יש לבחור באשף התקנת PHP את IIS ISAPI במקום ב-APACHE. כל שאר ההתקנה הינה אותו הדבר (אין להתקין אפאצ'י במקרה ומתקינים את אגרונט על IIS).

מקורות: ניתן למצוא את ההתקנות ב-uploads של library.org.il תחת ספרית AMP. במידה והוא לא זמין ניתן למצוא את ההתקנות באינטרנט:

apache installer - יש לבחור את הגירסה האחרונה (עם תוספת openssl)
mysql installer - יש ללחוץ על "No thanks, just take me to the downloads!", כדי שהמירורים יופיעו. ישנו מירור מישראל.
php installer - ישנו מירור מישראל (במעלה הדף).

ניתן לבצע את כל ההתקנה עם חבילה אחת בשם WAMP_SERVER ללא צורך להתקין כל חבילה בנפרד. ניתן להשיג את החבילה כאן (או בספריה AMP בשרת אגרון). יש להתקין את כלי העזר גם עם חבילה זו.

התקנת APACHE

ההתקנה תתבצע לתוך c:\amp\apache באמצעות האשף (יש לשנות את הנתיב באשף!) יש לשנות את הנתיב של קבצי הג'ומלה בעזרת שינוי הנתיב פעמיים בקובץ httpd.conf. פעם אחת בפרמטר DocumentRoot ופעם שניה בתגית Directory עם הנתיב המקורי. למשל, בשרת שלנו זה נראה כך:

קובץ: httpd.conf

…
DocumentRoot "d:/web/site"
<Directory "d:/web/site">
…
</Directory>
…

שימו לב: יש לאפשר את המודול deflate (מאפשר כיווץ דפי אינטרנט) בהגדרות של האפאצ'י. חפש את הביטוי deflate בקובץ והורידו את הסימון של ההערה (סולמית) בתחילתו (אם קיימת).

אחרי שינוי ההגדרה ניתן לבדוק אם האפאצ'י עובד בעזרת יצירת קובץ בשם index.html בתוך הספריה שהוגדרה ב-httpd.conf עם התוכן הבא:

קובץ: index.html

<html>
<body>
This is a test
</body>
</html>

יש לגלוש ל-http://localhost/index.html ולבדוק אם רואים This is a test בדף. אם יש צורך בקישור לאקטיב דירקטורי יש לאפשר זאת באמצעות הורדת הסולמית בתחילת השורה ב-httpd.conf:

#LoadModule ldap_module modules/mod_ldap.so

התקנת mysql

mysql הינו שרת בסיס נתונים חזק המבוסס על קוד פתוח. היתרון שלו הוא גודלו הקטן אל מול יכולותיו (יותר מ-SQL SERVER של מיקרוסופט).

ההתקנה תתבצע לתוך c:\amp\mysql באמצעות האשף. יש לשים לב! אם רוצים לשנות את נתיב מיקום הנתונים (קבצי הטבלאות) יש לעשות זאת לא רק במהלך האשף אלא לעדכן גם את הקובץ my.ini שנמצא בספרית ההתקנה ולשנות את הפרמטר datadir ואת innodb_data_home_dir (האחרון נקבע באשף).

ישנם שני אשפים שיפתחו - אחד להתקנה ואחד לקינפוג (בסיום ההתקנה). בכל האפשרויות של אשף הקינפוג יש לבחור את הברירת מחדל חוץ מהבאים:

קידוד - יש לבחור multi-language תמיכה ביוניקוד (utf-8).
מספר משתמשים שמתחברים לשרת - יש לבחור 50 לפחות.

בסיום האשף תתבקש להריץ את הקונפיגורציה שהוגדרה והפעלת השרת.

במקרה וברצונך לדעת על פקודות mysql ראה בנספחים.

התקנת PHP

התקנת PHP מתבצעת ע"י האשף לתוך c:\amp\php. יש לאפשר את כל המודולים הנלווים במהלך האשף. אם הדבר לא אפשרי, מודולים חובה: curl, gd2, mysql, mysqli. כדי לבדוק אם ההתקנה של ה-PHP עברה בהצלחה יש ליצור בשם index.php בנתיב של ה-DocumentRoot שהתוכן שלו:

קובץ: index.php

<?php
echo "<h1>this is a test page</h1>";
echo phpinfo();
?>

גלישה לדף זה (http://localhost/index.php) תציג פרטים לגבי השרת כולל מאפיינים וההגדרות שלו. יש למחוק דף זה כי הוא הינו סיכון אבטחתי והוא מיועד לבדיקות בלבד.

התקנת כלי עזר

יש להתקין כלי עזר שונים כדי לקנפג את השרת. כלי העזר נמצאים בספריה AMP בתוך הקובץ bin.zip. כדי להתקין יש פשוט לחלץ את תוכן הקובץ בשרת תחת c:\bin.

בין יתר כלי העזר שישנם בתוך הקובץ ניתן למצוא עורך טקסט מתקדם (++notepad), שנמצא תחת התיקייה npp, כדי לערוך קבצי php וסקריפטים שונים לניהול האתר (כל אלה בשימוש בהמשך).

התקנת ג'ומלה

התקנת קבצי המערכת

יש לקחת את הקובץ שמתחיל בשם agronet_YYYYMMDD.zip (כאשר ה-YYYYMMDD מייצג את התאריך שבו נוצרה ההתקנה).

בקובץ ה-zip ישנם שתי תיקיות. הראשונה היא htdocs שהיא התיקייה שמוגדר באפאצ'י כ-DocumentRoot שאליה גולשים (להלן JBASE_PATH) ותיקיית sites שבה נמצא קובץ הקונפיגורציה (ותיקיית המטמון שתיווצר במהלך גלישה באתר).

האגרונט פועל בשיטת ה-sub-domains כברירת מחדל, על-כן בהתקנה שלו יש לכבות את האופציה הזו ע"י עריכת הקובץ includes/multisite.php. יש להוריד את הסלאשים הכפולים בשורת מס' 39:

קוד: includes/multisite.php

//$subdomain = $default_subdomain = 'test';

convert to:

$subdomain = $default_subdomain = 'test';

ה-sub-domain אמור להיות תואם לפרפיקס של ה-DB (ללא ה-_jos_) והתיקייה שקובץ הקונפיגורציה נמצא.

יש למחוק או לשים כהערה את שורות 13 עד השורה שתיקנו כרגע באותו הקובץ. את הקובץ נעתיק למיקום הבא: administrator/includes (פאנל הניהול עושה את אותו הטריק).

התקנת בסיס הנתונים של ג'ומלה

יש לקחת את הקובץ base_mysql_db_for_agron_site.zip (מתוך הספריה AMP ב-uploads של library.org.il) לחלץ אותו (יש בתוכו קובץ בשם export.sql) ולהריץ את הפקודות הבאות (מתוך השורת פקודה):

mysql -u root -p -e "CREATE DATABASE agron_site;"
mysql -u root -p -D agron_site < path_to_the_export.sql
mysql -u root -p -D agron_site -e "GRANT ALL ON agron_site.* TO agron@localhost IDENTIFIED BY 'somepass'"

שימו לב: הפרפיקס של ה-DB הינו test_jos_. אם ברצונכם לשנותו יש לעשות זאת באמצעות העורך notepad++. יש לפתוח את קובץ export.sql ולהחליף את כל test_jos_ בפרפיקס שברצונכם להשתמש. שימ לב שהפרפיקס אמור להיות תואם לספריית הקונפיגורציה. ראו הגדרות בהמשך.

הגדרת ג'ומלה

יש להיכנס לתוך תיקית ההתקנה (בוצע בשלב התקנת קבצי המערכת) ולשנות את הגדרות המערכת שנמצאות בקובץ JBASE_PATH\config\www.php כדי שיהיה ניתן להיכנס למערכת. נעדכן את ההגדרות הדרושות (בעזרת ++notepad):

קובץ: JBASE_PATH\..\sites\test\configuration.php (שני הנקודות הרציפות מייצגות רמה אחת למעלה במבנה התיקיות)

	var $host = 'localhost';
	var $user = 'agron';
	var $db = 'agron_site';
	var $dbprefix = 'test_jos_';
...
	var $password = 'somepass';

יש לעדכן את ההגדרות לפי ההתקנה שבוצעה.

שימו לב: הפרפיקס של ה-DB מותאם לתיקייה שבה נמצא קובץ הקונפגורציה בתיקייה sites. משמע שאם הפרפיקס הינו test_jos_ אזי שקובץ הקונפיגורציה (בשם configuration.php אמור להיות בתוך sites/test.

לאחר מכן יהיה ניתן להיכנס לניהול ושם לעדכן את ההגדרות בצורה ידידותית (עם הסברים מצורפים). כניסה לניהול באמצעות הדפדפן: http://server_ip_or_domain/administrator

יש להיכנס לניהול באמצעות יוזר וסיסמא שיינתנו ע"י מזכירת אגרון (ניצה). לאחר מכן יש להיכנס להגדרות הכלליות של האתר באמצעות התפריט "אתר"->"הגדרות כלליות". ישנם הרבה הגדרות לצרכים שונים אבל ההגדרות שחייבים לשנות הינם שם האתר, תיאור מטה-מידע כללי לאתר ומילות מטה-מפתח כלליות לאתר (כאשר השתיים האחרונים אקטואליים למנועי חיפוש באינטרנט).

כדי לשנות את פרטי הספריה, יש להיכנס בתפריט של הניהול לרכיבים->אנשי קשר. שם לבחור ספריה ולעדכן את הפרטים.

מזל טוב! ניתן לגלוש לאתר http://server_ip_or_domain כדי לבדוק את התוצאות עד עתה.

הגדרות שונות

agron_db_path

מיקום קובץ הנתונים של אגרון נדרש. ללא הגדרה זו האתר אינו יכול לתפקד (רובו נועד לחיפושים בקובץ הנתונים). יש להיכנס לרכיבים->com_agronsearch ושם לחפש עבור agron_db_path. לחיצה על השם ועריכת המיקום של הקובץ (יכול להיות על השרת או במכונה מרוחקת).

תמונות

יש ליצור תיקיית תמונות עבור ההתקנה באם אינה קיימת. שם התיקייה אמור להיות שם הפרפיקס של האתר (כמו של ה-DB). מיקום התיקייה אמור להיות ב-JBASE_PATH.images/sites.

חסימת אינטרנט אקספלורר 6 ו-7 בניהול

כדי להסיר את החסימה יש לערוך את הקובץ index.php שנמצא בתיקייה administrator ולמרקר בהערה באמצעות שני סלאשים (//) בתחילת השורה שמכילה את הביטוי block_ie.

העברת קוראים למשתמשי האתר

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

דרך 1: העברת ישירה

באמצעות הכלי msaccess to mysql (להלן msa2mys) נעביר את הקוראים ל-mysql ולאחר מכן נסנכרן את הקוראים לתוך משתמשי האתר. msa2mys צריך את ה-connector שנמצא בספרית ה-AMP בשם mysql-connector-odbc-5.1.5-win32.msi. יש להתקינו באמצעות אשף פשוט. לאחר מכן יש להתקין הכלי עצמו באמצעות msa2mys_3_0_0_108.exe. את שני ההתקנות יש לבצע באמצעות האשפים ולהשתמש בהגדרות ברירת מחדל.

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

לאחר מכן נתחיל להגדיר את העברת הקוראים. נוכל להיכנס ל-msa2mys (נמצא בתפריט ההתחל בתוכניות; יכול להיות שהוא תחת bullzip) ולפתוח הגדרות שמורות באמצעות הכפתור "load settings" במסך הפתיחה. הקובץ עם ההגדרות השמורות נמצא ב-c:\bin\mysql\movereaders.ini. נצטרך לשנות חלק מהגדרות הקובץ, כמו מיקום קובץ ה-lib_data בשרת ויוזר וסיסמא ל-mysql (מומלץ לא להשתמש ב-root אלא להשתמש ביוזר שנוצר עבור הג'ומלה ולתת לו הרשאה ל-DATABASE בשם temp). הטבלה היחידה שצריך להעביר ל-mysql הינה readers. לאחר סיום האשף ניתן להריץ אותו לשם בדיקה אך לפני כן נשמור את ההגדרות כדי להשתמש בהם לשם אוטומציה של התהליך (ישנו כפתור "save setting" במסך שמופיע הכפתור "run now"). יש לזכור את המיקום של הקובץ לשימוש בהמשך.

סנכרון הקוראים לרשימת המשתמשים של האתר

לבסוף נרצה להכין סקריפט שיעלה את הקוראים וידחוף אותם למשתמשי האתר. החלק השני מבוצע באמצעות סקריפט מוכן בשם load_new_readers.bat שנמצא ב-c:\bin\mysql. יש לפתוח את הסקריפט ולעדכן את שלושת הפרמטרים שנמצאים בתחילתו:

קובץ: load_new_readers.bat

SET LIB_PREFIX=%1 :: the prefix of the database. %1 mean that you can enter it from the command line as a parameter if you want so
SET USER=agron :: user to connect to the database
SET PASSWORD=somepass :: password to connect to the database

לבסוף ניצור סקריפט חדש שיעלה את הקוראים ויסנכרן אותם:

קובץ: סקריפט חדש

CALL c:\path\to\msa2mys\msa2mys.exe SETTINGS=full_path_to_the_ini_that_you_create, AUTORUN , HIDE
CALL c:\bin\mysql\load_new_readers.bat :: if you need to fill the db prefix, don't forget to add it as parameter

אם רוצים שהסקריפט ירוץ אחת לכמה זמן יש להכניסו למשימות המתוזמנות של השרת תחת לוח בקרה.

דרך 2: Active Directory ו-LDAP

במידה ומעוניינים להגדיר שיוזרים יכנסו אוטומטית דרך האקטיב דירקטורי יש להיכנס בניהול לתוספות->מנהל תוספים. שם לחפש עבור authentication - ldap. קודם כל, יש להדליק את המודול באמצעות הגדרת מאופשר (יש לשים לב כי בעברית ה-yes ו-No הפוכים משמע כי אם ברצוננו לאפשר יש לבחור No. כך גם לגבי שאר השדות בטופס זה). יש להזין את הפרמטרים הבאים:

Host=Active Directory IP
Port=389
LDAP V3=Yes
Negotiate TLS=No
Follow referrals=No
Authorization Method=Bind and search
Base DN=DC=BCLIBRARY,DC=LOCAL
Search String=sAMAccountName=[search]
Users DN=CN=[username],OU=SBSUsers,OU=Users,OU=MyBusiness,DC=BCLIBRARY,DC=LOCAL
Connect Username=username from the active directory (without the DN; only user name)
Connect Password=the password of the username
Map: Full Name=displayName
Map: E-mail=mail
Map: User ID=sAMAccountName

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

אם רוצים שיוזרים שנכנסים דרך האקטיב דירקטורי ירשמו אוטומטית למערכת (כולל לתוכנת אגרון) יש לאפשר זאת בתוך התפריט רכיבים->מנהל תוספים. שם לבחור User - Joomla!. בהגדרות שיפתחו יש ללחוץ על "כן" תחת ההגדרה "יצירה אוטומטית של משתמשים". לאחר ביצוע הגדרה זו, כל יוזר שיכנס לאגרונט ירשם למערכת אגרון (ישירות לרשימת קוראים של הספריה בתוכנת האגרון).

גיבוי

כדי לגבות את האגרונט נדרש לגבות שני חלקים.

גיבוי קבצי המערכת שנמצאים בנתיב שבו הותקן האגרונט.
גיבוי mysql - ישנו סקריפט מוכן בשם mysql_backup שנמצא בכלי המערכת (c:\bin) תחת הספריה mysql. יש לשנות את הפרמטרים בתחילת הסקריפט להתאמה להגדרות של ה-mysql שהגדרנו.

שימוש וניהול אתר באגרונט

מידע לגבי ניהול האגרונט ניתן למצוא במדריך זה.

אם עדיין ישנם שאלות פתוחות, ניתן לפנות לאגרון.

ניתן גם למצוא מידע נוסף באנגלית כאן. מדריכים נוספים (באנגלית) להוספת תוכן:

ראה גם

SQL

הבדלים בין גרסאות בדף "התקנת אגרונט"