Manual:मीडियाविकि को स्थापित करना
इस पृष्ठ पर मीडियाविकि को स्थापित करने के आसान चरण बताए गए हैं, जिसके साथ कॉन्फ़िगरेशन के अतिरिक्त चरण Manual:System_administration#Configuration पर उपलब्ध हैं।
मीडियाविकि को स्थापित करने के लिए आपको कुछ हद तक एक वेब होस्ट से अनुकूल होना होगा। अगर आपके पास Apache (वेब सर्वर सॉफ़्टवेयर), PHP और MySQL/MariaDB (डेटाबेस) का अनुभव है तो स्थापना और आसान हो जाएगी। अतिरिक्त सहायता Project: Support desk पर उपलब्ध है।
नीचे के परिशिष्ट अनुभाग में मैन्युअल स्थापना के विकल्प बताए गए हैं।
For a quicker local server setup of MediaWiki, refer to the Local development quickstart.
स्थापना की आवश्यकताएँ देखें
जाँचें की आपका सिस्टम स्थापना की आवश्यकताओं को पूरा करता है कि नहीं।
मीडियाविकि का जो संस्करण आप स्थापित करना चाहते हैं उसका प्रकाशन की टिप्पणियाँ भी देखें।
मीडियाविकि सॉफ़्टवेयर डाउनलोड करें
आधिकारिक डाउनलोड पृष्ठ से मीडियाविकि का tar फ़ाइल डाउनलोड करें।
If you are using MediaWiki in a production environment, the release manager has issued a strong recommendation that only versions listed at Version lifecycle and their end-of-life as the current "stable version", "legacy version" or "long-term support version" should be used in a production environment. Older versions may contain critical security vulnerabilities and other major bugs, including the threat of possible data loss and/or corruption. आम तौर पर अगर आप एक उत्पादन पर्यावरण चला रहे होते हैं, आपको नवीनतम स्थिर प्रकाशन की ज़रूरत पड़ेगी, जो है MediaWiki 1.42.3।
मीडियाविकि सॉफ़्टवेयर को एक्सट्रैक्ट करें
डाउनलोड किए गए फ़ाइल .zip या फिर .tar.gz फ़ाइल प्रारूप में होगा।
आपको इस्तेमाल से पहले इस संरक्षण फ़ाइल को अनकंप्रेस करना होगा।
आप लोकल रूप से फ़ाइल को अनकंप्रेस कर सकते हैं (और फिर FTP की मदद से सर्वर पर अपलोड कर सकते हैं) या फिर सीधे अपने सर्वर पर भी कर सकते हैं।
Windows पर इस अनकंप्रेस करने का काम आम तौर पर 7-Zip (निः शुल्क), WinZip, WinRAR या IZArc (निः शुल्क) की मदद से किया जाता है।
लिनक्स और Mac OS X पर आप इस कमांड की मदद से फ़ाइल को अनकंप्रेस कर सकते हैं:
tar -xzvf mediawiki-*.tar.gz
chown -R <new_owner_user> <mediawiki_folder> अधिक जानकारी: Manual:Security#File_permissions
अपने वेब सर्वर पर फ़ाइलें अपलोड करें
अगर आपने पहले से फ़ाइलों को अपने वेब सर्वर पर अपलोड नहीं किया है (या फिर उनकी प्रतिलिपि नहीं बनाई है, अगर आपका सर्वर लोकल रूप से आपके localhost पर चलता है), अब ऐसा कर लें।
अपने वेब सर्वर के वेब डिरेक्ट्री में फ़ाइलों को अपलोड करने के लिए या तो:
- अनज़िप किए हुए फ़ोल्डर की प्रतिलिपि बनाएँ या फिर
- FileZilla (Windows, OSX और लिनक्स) या Cyberduck (Windows और OSX) जैसे किसी FTP क्लाइंट का इस्तेमाल करें, या
- अपने होस्टिंग सर्वर पर पहले से उपलब्ध 'cPanel File Manager' जैसे सॉफ़्टवेयर का इस्तेमाल करें।
अगर आपके अपलोड उपकरण में "फ़ाइल के नामों को लोअरकेस में बदलें" जैसा कोई विकल्प है, उसे अक्षम करें।
अगर आप Apache HTTPD वेब सर्वर का इस्तेमाल करते हैं, उचित डिरेक्ट्री DocumentRoot डिरेक्टिव के आपके httpd.conf फ़ाइल में निर्दिष्ट है।
डिफ़ॉल्ट से यह /var/www/ या <apache-folder>/htdocs होगा।
Apache के सर्वर सेटिंग्स और डिरेक्ट्री फ़ाइल httpd.conf का सटीक स्थान आपके ऑपरेटिंग सिस्टम पर निर्भर होगा।
Debian और Ubuntu पर Apache सर्वर सेटिंग्स और डिरेक्ट्रियों का फ़ाइल होता है /etc/apache2/apache2.conf।
Red Hat और Fedora पर फ़ाइल /etc/httpd/conf/httpd.conf में होता है।
अपलोड किए गए फ़ोल्डर का नाम उसमें बदलें जो आप URL में रखना चाहेंगे।
For example, if you rename the folder to wiki, the URL will reflect this as example.com/wiki.
अगर आपका वेब सर्वर उदाहरण के तौर पर http://localhost के रूप में चल रहा है, /w/ डिरेक्ट्री में नाम बदलने पर आप अपने विकि तक http://localhost/w/index.php पर पहुँच पाएँगे।
/wiki/ का इस्तेमाल न करें।
डेटाबेस सेटअप करें
मीडियाविकि का स्थापना स्क्रिप्ट आपसे डेटाबेस का एक नाम और डेटाबेस का एक सदस्यनाम माँगेगा, ताकि मीडियाविकि विकि की सामग्री को रख सके।
अगर आपके पास पहले से ही एक डेटाबेस सर्वर है और आपको "root" (admin) उपयोगकर्ता का पासवर्ड पता है, नीचे के #स्थापना स्क्रिप्ट चलाएँ अनुभाग पर जाएँ।
अगर आपको root सदस्य का पासवर्ड नहीं पता, मान लीजिए अगर आप किसी होस्ट किए गए सर्वर पर हैं, आपको अगले अनुभाग में मीडियाविकि स्थापना स्क्रिप्ट को चलाने से पहले एक नया डेटाबेस बनाना होगा।
MariaDB/MYSQL अनुशंसित डेटाबेस हैं। PostgreSQL और SQLite पर सीमित समर्थन है और आवश्यकता न पड़ने पर इनका इस्तेमाल नहीं किया जाना चाहिए। अगर आप निश्चित नहीं हैं कि किस डेटाबेस का इस्तेमाल करना चाहिए, MariaDB का इस्तेमाल करें।
डेटाबेस सेटअप ख़त्म करने के बाद नीचे #स्थापना स्क्रिप्ट चलाएँ के साथ आगे बढ़ें।
SQLite
अगर सिस्टम पर PHP के लिए pdo-sqlite मॉड्यूल स्थापित है, SQLite के लिए और कुछ करने की ज़रूरत नहीं।
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 प्रलेख की मदद से .mysql_history फ़ाइल को हटाकर अक्षम कर दें। |
PostgreSQL
अगर आप PostgreSQL का इस्तेमाल कर रहे हैं, आपको अपने लिए एक डेटाबेस और उपयोगकर्ता बनवाना पड़ेगा, या फिर कॉन्फ़िगरेशन फ़ॉर्म को "superuser" अनुमतियों वाले किसी PostgreSQL उपयोगकर्ता का नाम प्रदान करना पड़ेगा।
आम तौर पर इस डेटाबेस उपयोगकर्ता का नाम postgres होता है।
लिनक्स कमांड-पंक्ति पर postgres उपयोगकर्ता के रूप में निम्न कमांड्स wikiuser नामक एक डेटाबेस, और wikiuser नामक उपयोगकर्ता का my_wiki नामक डेटाबेस बना देंगे।
createuser -S -D -R -P -E wikiuser (फिर डेटाबेस का पासवर्ड दर्ज करें) createdb -O wikiuser my_wiki
या फिर superuser (डिफ़ॉल्ट से postgres) के रूप में डेटाबेस प्रॉम्प्ट पर निम्न कमांड्स चलाएँ:
CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'database_password';
CREATE DATABASE my_wiki WITH OWNER wikiuser;
PostgreSQL के साथ मीडियाविकि चलाते समय ज्ञात समस्याओं से सतर्क रहें।
स्थापना स्क्रिप्ट चलाएँ
फिर अपने वेब ब्राउज़र पर अपनी मीडियाविकि स्थापना के URL पर जाकर मीडियाविकि की स्थापना को पूरा करें: Manual:Config script के अनुदेशों का पालन करें।
अतिरिक्त कॉन्फ़िगरेशन
- Manual:System administration#Configuration - अतिरिक्त कॉन्फ़िगरेशन
- Manual:Administrators - विकि प्रबंधन
अद्यत रखें
स्थापित कर लेने के बाद प्रकाशनों के प्रति जागरूक रहें, और अपना सर्वर सुरक्षित रखें!
परिशिष्ट
मैन्युअल स्थापना के विकल्प
मैन्युअल स्थापना अक्सर वरीय साधन होती है क्योंकि इससे सदस्य को इस बात पर ज़्यादा नियंत्रण प्राप्त होता है कि उनके विकि को किस प्रकार स्थापित किया जाता है, जिससे समस्या-निवारण और अनुरक्षण आसान हो जाती हैं। स्वचालित प्रक्रियाएँ, पैकेजेस, बंडल्स, और सेवाएँ, सबकी अपनी-अपनी वरीयताएँ होती हैं।
मीडियाविकि को खुद स्थापित करने के बजाय वैकल्पिक साधन ज़्यादा आसान हो सकते हैं:
- पूर्व-एकीकृत सॉफ़्टवेयर उपकरण
- 1-क्लिक स्थापना वाली होस्टिंग सेवाएँ, या विकि फ़ार्म्स
- software bundles
- मीडियाविकि जैसे ऐप्लिकेशन्स के लिए स्वचालित स्थापना प्रदान करने वाली होस्टिंग सेवाओं पर कालग्रस्त संस्करण उपलब्ध होते हैं या फिर उनमें दूसरी समस्याएँ होती हैं। अगर आपको समस्याएँ आती हैं, इसका यह मतलब नहीं कि आप मीडियाविकि स्थापित नहीं कर सकते। इसका मतलब है कि आपको मीडियाविकि खुद स्थापित करना चाहिए।
comparison of distribution options भी देखें।
सिस्टम-विशिष्ट अनुदेश
Manual:OS specific help पर सूचीबद्ध पृष्ठों पर विशिष्ट सिस्टम्स की तरफ लक्षित, स्थापना के विस्तृत अनुदेश मौजूद हैं।
मगर इन सिस्टम-विशिष्ट प्रलेखों को अनुरक्षित नहीं किया जाता है और हो सकता है ये हमेशा अद्यत न हो। सिस्टम-विशिष्ट स्थापना के प्रलेख को पढ़ने से पहले मीडियाविकि को स्थापित करना (इस पृष्ठ) को एक बार पढ़ लें।
कई विकियाँ चलाना
Manual:अक्सर पूछे जाने वाले प्रश्न#स्थापना और कॉन्फ़िगरेशन पढ़ें।
मौजूदा विकि डेटाबेस आयात करना
Manual:अक्सर पूछे जाने वाले प्रश्न#स्थापना और कॉन्फ़िगरेशन पढ़ें।