मैनुअल:विकी को स्थानांतरित करना

This page is a translated version of the page Manual:Moving a wiki and the translation is 90% complete.
Outdated translations are marked like this.
यदि आप केवल अपने विकी को स्थानांतरित करना चाहते हैं उदा। /var/www/html/ से /var/www/html/mywiki/ तक, निर्देश यहाँ हैं।

यह पृष्ठ बताता है कि कैसे एक विकि को दूसरे सर्वर पर ले जाना है। किसी भिन्न वेब सर्वर या डोमेन (या दोनों) पर जाते समय अक्सर इसकी आवश्यकता होती है।

इसे करने का सबसे सुरक्षित तरीका दोनों विकियों पर समान मीडियाविकि संस्करण का उपयोग करना है। हालांकि, नए सर्वर पर नए मीडियाविकि संस्करण को स्थापित करना और सीधे नए सर्वर पर अपग्रेड करना संभव है। वास्तव में, यह आपके लिए एकमात्र विकल्प हो सकता है यदि आप अपने विकी को एक नए संस्करण में अपग्रेड करना चाहते हैं जिसमें आपके पुराने सर्वर (जैसे PHP संस्करण) पर उपलब्ध आवश्यकताओं की तुलना में उच्च आवश्यकताएं हैं।

चरणों को मूल रूप से अन्य पृष्ठों में समझाया गया है:

  1. अपने विकी का बैकअप बनाएं
  2. पुराने सर्वर से बैकअप को नए में ट्रांसफर करें।
  3. नए सर्वर पर बैकअप पुनर्स्थापित करें
इससे पहले कि आप अपने विकी का बैकअप लेना शुरू करें, आप इसे "केवल-पढ़ने के लिए" मोड के तहत रखना चाह सकते हैं ताकि आपके द्वारा इसे स्थानांतरित करते समय कोई भी इसे संपादित न कर सके। यदि आप ऐसा नहीं करते हैं, तो आप माइग्रेशन प्रक्रिया के दौरान किए गए संपादन/अपलोड/लॉग आदि खो सकते हैं। ऐसा करने के लिए, LocalSettings.php में $wgReadOnly का उपयोग करें। उदाहरण के लिए:
$wgReadOnly = 'Down for maintenance: access will be restored shortly';

नए सर्वर का उन्नयन

यदि आप नए सर्वर पर नए मीडियाविकि संस्करण में अपग्रेड कर रहे हैं, पुराने MediaWiki निर्देशिका और एक्सटेंशन को नए सर्वर पर कॉपी करने के बजाय, आपको अपग्रेडिंग प्रक्रिया का पालन करना चाहिए। आप नए सर्वर पर एक नया मीडियाविकि संस्करण डाउनलोड करेंगे और आपके द्वारा उपयोग किए जाने वाले एक्सटेंशन के नए संस्करण, नए मीडियाविकि संस्करण से मेल खाते हुए। अपडेट स्क्रिप्ट चलाएँ याद रखें।

नोट्स

  • यदि URL बदल गया है (उदाहरण के लिए, एक नया डोमेन), तो इसके सभी संदर्भ LocalSettings.php में अपडेट करना सुनिश्चित करें। यदि VisualEditor का उपयोग कर रहे हैं, तो आपको Parsoid कॉन्फ़िगरेशन को भी अपडेट करना होगा।
    • कैश्ड पृष्ठों पर लिंक अभी भी पुराने डोमेन की ओर इशारा कर सकते हैं। उस समय से पहले संचित पृष्ठों को त्यागने के लिए आपको $wgCacheEpoch को टक्कर देनी पड़ सकती है।
  • जांचें कि अपलोड का उपयोग करते समय upload/ निर्देशिका में सही अनुमतियां सेट हैं; यह वेब सर्वर द्वारा लिखने योग्य होना चाहिए।
  • सुनिश्चित करें कि किसी भी एक्सटेंशन निर्देशिका में सही अनुमतियां भी हैं (उदाहरण के लिए, यदि linux: chmod -R o=rx extensions)
  • जब एक विकि को विंडोज़ प्लेटफॉर्म से लिनक्स प्लेटफॉर्म पर मैन्युअल रूप से स्थानांतरित किया जाता है, तो सबसे अच्छा तरीका यह है:
  1. मीडियाविकि को एक टार फ़ाइल से लिनक्स प्लेटफॉर्म पर मैन्युअल रूप से स्थापित करें जैसा कि यहां बताया गया है: विकी का मैनुअल इंस्टालेशन (यानी, स्वचालित पैकेज से इंस्टॉल का उपयोग न करने का प्रयास करें)
  2. अपने लिनक्स मशीन पर नए स्थापित मीडियाविकि फ़ोल्डर (जैसे, /var/www/mediawiki...) को अपनी विंडोज़ मशीन के मीडियाविकि आधार फ़ोल्डर से बदलें
  3. अपनी विंडोज़ मशीन के विकि डेटाबेस से अपने Linux मशीन के MySQL डेटाबेस (उदा. wikidb) को अपडेट करें (अर्थात, बैकअप का उपयोग करें और ऊपर बताए अनुसार mysql की सुविधाओं को पुनर्स्थापित करें)
  • विकी डेटाबेस आयात करने के बाद, भले ही डेटाबेस काम कर सकता है, कुछ छोटी समस्याएं उत्पन्न हो सकती हैं:
  1. आपको Searchindex को सुधारने की आवश्यकता हो सकती है: PhpMyAdmin में, खोज अनुक्रमणिका के पुनर्निर्माण के लिए "REPAIR TABLE wikidb.searchindex; " दर्ज करें। wikidb आपके डेटाबेस का नाम है।
  2. कुछ पंक्तियों का मिलान बदला जा सकता है। मूल डेटाबेस के साथ इसे क्रॉस-चेक करें।

टेस्ट

इस बिंदु पर, नए सर्वर पर विकि का उपयोग करने का प्रयास करें। एक sysop और एक नियमित उपयोगकर्ता के रूप में लॉग इन करें और जांचें कि पृष्ठ देखना, बनाना और संपादित करना और फ़ाइलें अपलोड करना अभी भी काम करता है। PHP या MediaWiki द्वारा रिपोर्ट की गई किसी भी समस्या का समाधान स्वयं करें।

पुराने विकी को केवल-पढ़ने के लिए मोड में डालने से पहले, आप यह परीक्षण करने के लिए पूरी प्रक्रिया कर सकते हैं कि क्या यह कदम बिना किसी समस्या के काम करेगा। एक बार जब आप जान जाते हैं कि नए सर्वर में आपका विकी अपेक्षित रूप से काम करता है, तो आप अपने पुराने विकी को केवल-पढ़ने के लिए मोड में रख सकते हैं और फिर से चाल चल सकते हैं।

बार-बार परेशानी

डोमेन बदलने के बाद दुर्गम फ़ाइलें

module_deps तालिका के कॉलम md_deps में पूर्ण फ़ाइल पथ हैं, जिनका उपयोग उन छवियों और LESS फ़ाइलों का पता लगाने के लिए किया जाता है जिन पर CSS निर्भर करता है। जब विकी होता है, उदाहरण के लिए, किसी अन्य फ़ोल्डर या किसी अन्य सर्वर पर ले जाया जाता है तो ये पथ टूट जाते हैं। आपके कदम के बाद, आप PHP चेतावनियों को देख सकते हैं कि कुछ फ़ाइलों तक पहुँचा नहीं जा सकता है। MediaWiki के वर्तमान संस्करणों में, इसे update.php चलाकर हल किया जा सकता है, इस प्रकार कैश को साफ़ किया जा सकता है।

MediaWiki 1.25 (जहाँ phabricator:T37472 लागू नहीं किया गया है) से पुराने संस्करणों में update.php तालिका की सामग्री को नहीं हटाता है। इन संस्करणों के लिए, समाधान module_deps तालिका में गलत प्रविष्टियों को मैन्युअल रूप से ठीक करना है:

-- Update entries in module_deps table
SET @old='wiki.old-domain.org';
SET @new='wiki.new-domain.org';

UPDATE `module_deps` SET `md_deps` = REPLACE( `md_deps`, @old, @new );

इसका उपयोग गलत पथ खंडों को अद्यतन करने और त्रुटि को ठीक करने के लिए किया जा सकता है।

इसी तरह की समस्या तब हो सकती है जब मीडियाविकि संसाधन लोडर संदेशों को पढ़ने का प्रयास करता है। इस मामले में समाधान तालिका के अनुसार छोटा करना है:

-- Truncate message related caches
TRUNCATE TABLE `msg_resource`;
TRUNCATE TABLE `msg_resource_links`;

यह भी देखें

बाहरी कड़ियाँ