Manual:Installing MediaWiki/he
דף זה מתאר את השלבים הנדרשים להתקנה ידנית של מדיה-ויקי. לאחר ההתקנה, ניתן למצוא פרטי תצורה נוספים במדריך:ניהול המערכת#תצורה.
כדי להתקין את מדיה-ויקי, נדרשת הבנה בסיסית של אחסון אתרים. ניסיון עם Apache, PHP ו-MySQL/MariaDB יקל על התהליך. לכל שאלה בנוגע להתקנות מדיה-ויקי, פנו ל-Project: Support desk או עיינו במקומות אחרים המופיעים בדרכי תקשורת.
הסעיף נספחים למטה מציע חלופות להתקנה ידנית, יחד עם הערות התקנה ספציפיות עבור תצורות מערכת שונות.
להגדרה מהירה יותר של שרת מקומי במדיה-ויקי, עיינו ב-התחלה מהירה לפיתוח מקומי.
דרישות התקנה
ודא שהמערכת שלך עומדת בדרישות ההתקנה.
ודא שאתה בודק גם את ה-Release notes של גרסת מדיה-ויקי שאתה מתכנן להתקין.
הורדת תוכנת מדיה-ויקי
הורד את קובץ ה-tar של מדיה-ויקי מדף ההורדה הרשמי.
אם אתם משתמשים במדיה-ויקי בסביבת ייצור, מנהל הגרסאות פרסם המלצה חזקה שרק גרסאות המפורטות במחזור חיי הגרסה וסוף חייהן כ"גרסה יציבה", "מהדורה מדור קודם" או "מהדורת תמיכה ארוכת טווח" אשר ישמשו בסביבת ייצור. גרסאות ישנות יותר עשויות להכיל פגיעויות אבטחה קריטיות ובאגים משמעותיים אחרים, כולל איום של אובדן נתונים אפשרי ו/או שיבוש. הגרסה היציבה הנוכחית היא MediaWiki 1.44.0.
חילוץ תוכנת מדיה-ויקי
הקובץ שהורד הוא בפורמט .zip או .tar.gz.
יש לשחרר אותו מהדחיסה לפני השימוש.
ניתן לשחרר את דחיסת הקובץ באופן מקומי (ולאחר מכן להעלות אותו דרך FTP לשרת) או ישירות לשרת שלכם.
ב-Windows (ווינדוס), ביטול דחיסה מתבצע בדרך כלל באמצעות תוכנות כגון 7-Zip (חינמית), WinZip, WinRAR או IZArc (חינמית).
ב-Linux (לינוקס) וב-macOS (מק או-אס), ניתן לבטל דחיסה של הקובץ באמצעות הפקודה:
tar -xzvf mediawiki-*.tar.gz
chown -R <new_owner_user> <mediawiki_folder> למידע נוסף על אבטחת הרשאות קבצים, עיינו במדריך:אבטחה#הרשאות קבצים.
העלת קבצים לשרת האינטרנט שלך
אם עדיין לא העלית את הקבצים לשרת האינטרנט שלך (או העתקת, אם תוכנת שרת האינטרנט שלך פועלת באופן מקומי על ה-localhost שלך), עשה זאת כעת.
העלה את הקבצים לתיקיית האינטרנט של שרת האינטרנט שלך באמצעות:
- העתקה ישירה של התיקייה הלא דחוסה או
- באמצעות לקוח FTP כגון FileZilla (Windows, macOS ו-Linux) או Cyberduck (Windows ו-macOS).
- באמצעות תוכנה שכבר מסופקת על ידי שירות האירוח שלך, כגון מנהל הקבצים cPanel.
אם כלי ההעלאה שלך כולל אפשרות "שינוי שמות קבצים לאותיות קטנות", עליך להשבית אפשרות זו כדי למנוע שינויים לא מכוונים בשמות קבצים במהלך תהליך ההעלאה.
אם אתם משתמשים בשרת האינטרנט Apache HTTPD, הספרייה הנכונה מצוינת בקובץ httpd.conf שלכם בהוראת DocumentRoot.
כברירת מחדל, זהו /var/www/ או <apache-folder>/htdocs.
המיקום המדויק של קובץ ההגדרות והתיקיות של שרת האפאצ'י httpd.conf תלוי במערכת ההפעלה שלך.
ב-Debian (דביאן) וב-Ubuntu (אובונטו), הקובץ עבור הגדרות שרת ותיקיות Apache (אפאצ'י) הוא /etc/apache2/apache2.conf.
ב-Red Hat (רד האט) וב-Fedora (פדורה), הקובץ הוא /etc/httpd/conf/httpd.conf.
שנה את שם התיקייה שהועלתה לשם הרצוי, שכן זה יקבע כיצד היא תופיע בכתובת ה-URL.
לדוגמה, אם תשנה את שם התיקייה ל-wiki, כתובת האתר תשקף זאת כ-example.com/wiki.
אם שרת האינטרנט שלך פועל כ-http://localhost לדוגמה, שינוי שם הספרייה ל-/w/ פירושו שתיגש לויקי שלך ב-http://localhost/w/index.php.
הגדרת מסד הנתונים
סקריפט התצורה הראשוני של מדיה-ויקי דורש שם מסד נתונים ושם משתמש של מסד נתונים כדי לאחסן את תוכן הויקי.
אם כבר יש לך שרת מסד נתונים ואתה יודע את הסיסמה עבור משתמש ה-root (מנהל), תוכל לדלג ישירות לסעיף הפעלת סקריפט ההתקנה.
אם אינך יודע את סיסמת משתמש ה-root, לדוגמה אם אתה משתמש בשרת מתארח, תצטרך ליצור מסד נתונים חדש לפני שתמשיך לסקריפט ההתקנה של מדיה-ויקי.
MariaDB/MySQL הם מסדי הנתונים המומלצים. אמנם PostgreSQL ו-SQLite נתמכים, אך הם מציעים תאימות מוגבלת ויש להשתמש בהם רק במידת הצורך. אם אינך בטוח באיזה מסד נתונים לבחור, השתמש ב- MariaDB.
לאחר השלמת הגדרת מסד הנתונים, המשך להפעלת סקריפט ההתקנה למטה.
SQLite
אין צורך בהתקנה נוספת עבור SQLite אם מודול pdo-sqlite עבור PHP מותקן במערכת.
בדף ההתקנה של SQLite, בחר שם מסד נתונים (כל שם קביל) וספריית מסד נתונים של SQLite. המתקין ינסה להשתמש בספרייה מחוץ לשורש המסמך וליצור אותה במידת הצורך. אם ספרייה זו ניתנת לקריאה באינטרנט או אינה מאובטחת, יש לשנותה ידנית כדי למנוע גישה בלתי מורשית.
MariaDB/MySQL
כדי ליצור את מסד הנתונים והמשתמש עבור MariaDB/MySQL, ניתן להשתמש באחת מהשיטות הבאות:
- לוח בקרה המסופק על ידי שירות האירוח שלך, כגון phpMyAdmin.
- גישת SSH לשרת שלך, שם תוכל להזין את הפקודות שלהלן לתוך שורת MySQL. עיין בתיעוד של ספק האירוח שלך. לחלופין, תוכל לבקש מספק האירוח שלך ליצור עבורך את מסד הנתונים והמשתמש.
הפקודות הבאות ייצרו מסד נתונים בשם my_wiki, משתמש בשם wikiuser, ויקצו הרשאות למשתמש במסד נתונים זה.
CREATE DATABASE my_wiki;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'database_password';
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;
רק אם מסד הנתונים שלך אינו פועל באותו שרת כמו שרת האינטרנט שלך, עליך לציין את שם המארח המתאים של שרת האינטרנט (mediawiki.example.com בדוגמה למטה):
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'database_password';
 אזהרה: | MySQL/MariaDB רושם את כל השאילתות בקובץ היסטוריה. הוא יכלול את סיסמת מסד הנתונים עבור חשבון המשתמש. אם זה נוגע לך, מחק והשבת את קובץ ה-.mysql_history לאחר הפעלת שאילתות אלו על ידי ביצוע ההוראות בתיעוד MySQL. |
PostgreSQL
אם אתם משתמשים ב-PostgreSQL, תצטרכו ליצור עבורכם מסד נתונים ומשתמש, או לספק את שם משתמש PostgreSQL עם הרשאות "משתמש-על" לטופס התצורה.
לעתים קרובות, זהו משתמש מסד הנתונים בשם postgres.
הפקודות הבאות בשורת פקודה של לינוקס, כמשתמש postgres, יוצרות משתמש מסד נתונים בשם wikiuser, ומסד נתונים בשם my_wiki בבעלות המשתמש בשם wikiuser.
createuser -S -D -R -P -E wikiuser (לאחר מכן הזינו את סיסמת מסד הנתונים) createdb -O wikiuser my_wiki
או כמשתמש-על (postgres כברירת מחדל) לבצע את הפקודות הבאות בשורת מסד הנתונים:
CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'database_password';
CREATE DATABASE my_wiki WITH OWNER wikiuser;
היזהרו מרשימת הבעיות הידועות בעת הפעלת MediaWiki עם PostgreSQL.
הפעלת סקריפט ההתקנה
לאחר מכן, השלם את התקנת MediaWiki על ידי מעבר לכתובת ה-URL של התקנת MediaWiki שלך בדפדפן האינטרנט שלך: פעל לפי ההוראות ב-מדריך:סקריפט תצורה.
תצורה נוספת
- מדריך:ניהול המערכת - קונפיגורציה נוספת
- Manual:Administrators - הנהלת ויקי
הישארו מעודכנים!
לאחר ההתקנה, ודאו שאתם מעודכנים בגרסאות, ושמרו על אבטחת השרת שלכם!
נספחים
חלופות להתקנה ידנית
התקנה ידנית היא לרוב השיטה המועדפת משום שהיא מעניקה למשתמש שליטה ותובנות רבות יותר לגבי אופן התקנת הויקי שלו, מה שמקל על פתרון בעיות ותחזוקה. תהליכים אוטומטיים, חבילות, צרורות ושירותים מגיעים עם הייחודיות שלהם.
במקום להתקין את MediaWiki באופן ידני, אפשרויות חלופיות עשויות להיות קלות יותר:
- שירותי אירוח המספקים התקנה אוטומטית של יישומים כגון MediaWiki עשויים להציע גרסאות מיושנות או להיתקל בבעיות אחרות. אם אתם נתקלים בבעיות, זה לא אומר שאינכם יכולים להתקין את MediaWiki. זה אומר שעליכם להתקין את MediaWiki באופן ידני.
ראו גם את comparison of distribution options.
הוראות התקנה למערכות הפעלה
הדפים המפורטים ב-Manual:OS specific help מספקים הוראות התקנה מפורטות יותר המכוונות למערכות ספציפיות.
עם זאת, בדרך כלל, מסמכים אלה לכל מערכת מתוחזקים פחות וייתכן שלא תמיד מעודכנים. ראשית, עיין בהתקנת מדיה-ויקי (דף זה) לפני עיון בתיעוד ההתקנה של כל מערכת.
הפעלת מספר אתרי ויקי
עיינו במדריך:שאלות נפוצות#התקנה ותצורה.
ייבוא מסד נתונים קיים של ויקי
עיינו במדריך:שאלות נפוצות#התקנה ותצורה.