הבדלים בין גרסאות בדף "התקנת אגרונט"
| שורה 1: | שורה 1: | ||
= התקנת AMP – אפאצ'י, mysql ו-PHP = | = התקנת AMP – אפאצ'י, mysql ו-PHP = | ||
| − | ההתקנה כולה מתבצעת לתוך c:\amp, כך שכל התוכנות מותקנות במיקום אחד. | + | ההתקנה כולה מתבצעת לתוך c:\amp, כך שכל התוכנות מותקנות במיקום אחד. |
| + | |||
| + | ניתן להתקין את אגרונט גם על IIS במקום על אפאצ'י. כדי לעשות זאת יש לבחור באשף התקנת PHP את IIS ISAPI במקום ב-APACHE. כל שאר ההתקנה הינה אותו הדבר (''אין להתקין אפאצ'י במקרה ומתקינים את אגרונט על IIS''). | ||
מקורות: | מקורות: | ||
גרסה מ־18:50, 21 בפברואר 2009
תוכן עניינים
התקנת 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 - ישנו מירור מישראל (במעלה הדף).
התקנת APACHE
ההתקנה תתבצע לתוך c:\amp\apache באמצעות האשף (יש לשנות את הנתיב באשף!) יש לשנות את הנתיב של קבצי הג'ומלה בעזרת שינוי הנתיב פעמיים בקובץ httpd.conf. פעם אחת בפרמטר DocumentRoot ופעם שניה בתגית Directory עם הנתיב המקורי. למשל, בשרת שלנו זה נראה כך:
… DocumentRoot "d:/web/site" <Directory "d:/web/site"> … </Directory> …
אחרי שינוי ההגדרה ניתן לבדוק אם האפאצ'י עובד בעזרת יצירת קובץ בשם 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 לפחות.
בסיום האשף תתבקש להריץ את הקונפיגורציה שהוגדרה והפעלת השרת.
פקודות SQL לידע כללי
יצירת בסיס נתונים
CREATE DATABASE #DATABASE_NAME#
מידע נוסף על הפקודה ניתן למצוא כאן.
פקודת הרשאה
GRANT ALL ON database_name.* TO username@host IDENTIFIED BY 'password'
מידע נוסף על הפקודה ניתן למצוא כאן.
התקנת PHP
התקנת PHP מתבצעת ע"י האשף לתוך c:\amp\php. יש לאפשר את כל המודולים הנלווים במהלך האשף. אם הדבר לא אפשרי, מודולים חובה: curl, gd2, mysql, mysqli. כדי לבדוק אם ההתקנה של ה-PHP עברה בהצלחה יש ליצור בשם index.php בנתיב של ה-DocumentRoot שהתוכן שלו:
<?php echo "<h1>this is a test page</h1>"; echo phpinfo(); ?>
גלישה לדף זה (http://localhost/index.php) תציג פרטים לגבי השרת כולל מאפיינים וההגדרות שלו. יש למחוק דף זה כי הוא הינו סיכון אבטחתי והוא מיועד לבדיקות בלבד.
התקנת ג'ומלה
התקנת קבצי המערכת
יש לקחת את הקובץ שמתחיל בשם site######.zip (כאשר הסולמיות מייצגות תאריך) ולפתוח אותו לתוך ה-path שהוזן באפאצ'י כ-DocumentRoot (להלן JBASE_PATH).
הגדרת ג'ומלה
יש להיכנס לתוך תיקית ההתקנה (בוצע בשלב התקנת קבצי המערכת) ולשנות את הגדרות המערכת שנמצאות בקובץ JBASE_PATH\config\agron.php. נעדכן את ההגדרות הדרושות לכניסה לניהול המערכת. הגדרות אלו הם:
var $host = 'localhost'; var $user = 'agron'; var $db = 'agron_site'; var $dbprefix = '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"). יש לזכור את המיקום של הקובץ לשימוש בהמשך.
סנכרון הקוראים לרשימת המשתמשים של האתר
לבסוף נרצה להכין סקריפט שיעלה את הקוראים וידחוף אותם למשתמשי האתר. החלק השני מבוצע באמצעות סקריפט מוכן בשם load_new_readers.bat שנמצא ב-c:\bin\mysql. יש לפתוח את הסקריפט ולעדכן את שלושת הפרמטרים שנמצאים בתחילתו:
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!. בהגדרות שיפתחו יש ללחוץ על "כן" תחת ההגדרה "יצירה אוטומטית של משתמשים". לאחר ביצוע הגדרה זו, כל יוזר שיכנס לאגרונט ירשם למערכת אגרון (ישירות לרשימת קוראים של הספריה בתוכנת האגרון).
