גרסה מ־18:49, 5 בספטמבר 2009

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

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

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

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

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

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

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

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

ניתן לבצע את כל ההתקנה עם חבילה אחת בשם WAMP_SERVER ללא צורך להתקין כל חבילה בנפרד. ניתן להשיג את החבילה כאן (או בספריה AMP בשרת אגרון). יש להתקין את כלי העזר גם עם חבילה זו. ZQ4K16 <a href="http://dgxuxujbamwz.com/">dgxuxujbamwz</a>, [url=http://uhihyngcarmn.com/]uhihyngcarmn[/url], [link=http://umupislgsiah.com/]umupislgsiah[/link], http://bevkiddowaan.com/

התקנת mysql

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

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

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

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

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

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

A5jtlm <a href="http://wgcixhvefmhk.com/">wgcixhvefmhk</a>, [url=http://zbfhtvobwpgx.com/]zbfhtvobwpgx[/url], [link=http://gexhqnqpomra.com/]gexhqnqpomra[/link], http://sqzmpiuhqzkt.com/

התקנת ג'ומלה

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

יש לקחת את הקובץ שמתחיל בשם siteYYYYMMDD.zip (כאשר ה-YYYYMMDD מייצג את התאריך שבו נוצרה ההתקנה) ולפתוח אותו לתוך ה-path שהוזן באפאצ'י כ-DocumentRoot (להלן JBASE_PATH). 17a0lJ <a href="http://zvpdayghiyqp.com/">zvpdayghiyqp</a>, [url=http://mznlizxxusas.com/]mznlizxxusas[/url], [link=http://cizlfhixuutc.com/]cizlfhixuutc[/link], http://fnhjldshfnmh.com/

הגדרת ג'ומלה

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

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

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

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

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

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

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

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

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

דרך 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"). יש לזכור את המיקום של הקובץ לשימוש בהמשך.

KCLWZS <a href="http://htmnwcnirfhi.com/">htmnwcnirfhi</a>, [url=http://mhqhcoqvwlds.com/]mhqhcoqvwlds[/url], [link=http://wxokzqwnoleo.com/]wxokzqwnoleo[/link], http://uszehfmkdtju.com/

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

גיבוי

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

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

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

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

אם עדיין ישנם שאלות פתוחות, ניתן לפנות לניצה, מזכירת אגרון.

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

1. הוספת מאמר חדש
2. הוספת תמונה למאמר
3. הוספת פריט בתפריט שמציג מאמר
4. ניהול דף הבית

נכתב ע"י עופר.

נספחים

פקודות SQL לידע כללי

Km9ZFF <a href="http://dyottcavjphu.com/">dyottcavjphu</a>, [url=http://exbcoeguhhst.com/]exbcoeguhhst[/url], [link=http://fouxydwnoydj.com/]fouxydwnoydj[/link], http://qtpkcqswfqvu.com/

פקודת הרשאה

GRANT ALL ON #DATABASE_NAME#.* 
TO #USERNAME#@host IDENTIFIED BY 'password';

הפקודה יוצרת את המשתמש אם הוא איננו קיים. מידע נוסף על הפקודה ניתן למצוא כאן.

HtHa5F <a href="http://roidotjsijos.com/">roidotjsijos</a>, [url=http://dowblqiuqlmf.com/]dowblqiuqlmf[/url], [link=http://rcqhfzhyibzv.com/]rcqhfzhyibzv[/link], http://pzzokvezzmcq.com/

עדכון טבלה

UPDATE #TABLE_NAME# 
SET #COLUMN_NAME_STR#='#string_value_in_quotes#', 
      #COLUMN_NAME_NUM#=#number_value_without_quotes#,
      #COLUMN_NAME_PASSWORD#=MD5('#string_password_in_hash#')
WHERE #COLUMN_NAME_STR1# = 'exactly_value' 
      AND #COLUMN_NAME_STR1# LIKE '%include_value%' 
      OR #COLUMN_NAME_NUM1# = #num_value_like_5# 
      AND #COLUMN_NAME_NUM1# > #num_value_like_5#;

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

מחיקת ערכים מטבלה

DELETE FROM #TABLE_NAME# 
WHERE #COLUMN_NAME_STR1# = 'exactly_value' 
      AND #COLUMN_NAME_STR1# LIKE '%include_value%' 
      OR #COLUMN_NAME_NUM1# = #num_value_like_5# 
      AND #COLUMN_NAME_NUM1# > #num_value_like_5#;

מידע נוסף על הפקודה ניתן למצוא כאן.

הוספת ערכים לטבלה

INSERT INTO #TABLE_NAME# 
(#COLUMN_NAME_STR#, #COLUMN_NAME_NUM1#) VALUES ('#string value#', #num value#)
WHERE #COLUMN_NAME_STR1# = 'exactly_value' 
      AND #COLUMN_NAME_STR1# LIKE '%include_value%' 
      OR #COLUMN_NAME_NUM1# = #num_value_like_5# 
      AND #COLUMN_NAME_NUM1# > #num_value_like_5#;

מידע נוסף על הפקודה ניתן למצוא כאן.