FAQ

आकार और उपलब्धता

मैं सबसे बड़ी कौन-सी फ़ाइल सहेज सकता हूँ?

10,000 GiB (10 737 418 240 000 बाइट)। एक अपलोड में अधिकतम 10,000 भाग होते हैं, हर एक अधिकतम 1 GiB का। व्यवस्थापक ARKVORY_MAX_OBJECT_BYTES से कम सीमा सेट कर सकता है। इससे बड़ा घोषित आकार 400 के साथ अस्वीकार कर दिया जाता है। व्यवहार में, खाली डिस्क स्थान, रिपॉज़िटरी का कोटा और 1 GiB का खाली-स्थान रिज़र्व आपको पहले रोकते हैं: वे 507 उत्तर देते हैं। अवधारणाएँ और एनवायरनमेंट वेरिएबल देखें।

एक सर्वर में कितना रखा जा सकता है?

Arkvory डिफ़ॉल्ट रूप से 10 TiB तक सामग्री आरक्षित करता है (ARKVORY_CAPACITY_BYTES), जिसमें प्रकाशित फ़ाइलें, अधूरे अपलोड और क्लीनअप की प्रतीक्षा करती सामग्री गिनी जाती हैं। यह एक काउंटर है, डिस्क जाँच नहीं। डिस्क और रिज़र्व ही असली सीमा हैं। किसी रिपॉज़िटरी का अपना कोटा हो सकता है। स्टोरेज देखें।

क्या Arkvory उच्च उपलब्धता वाला है?

नहीं। एक इंस्टॉलेशन एक सर्वर है, जिसमें एक PostgreSQL डेटाबेस और एक स्थानीय कंटेंट डायरेक्टरी होती है। सर्वर रुक जाए तो क्लाइंट प्रतीक्षा करते हैं और फिर अपने ट्रांसफ़र जारी रखते हैं; क्रैश या हैंग के बाद सेवाएँ स्वयं फिर से शुरू हो जाती हैं। सर्वर के खोने से बचाव के लिए बैकअप इस्तेमाल करें। दूसरी साइट से पढ़ने के लिए मिरर इस्तेमाल करें; मिरर पर स्विच करना एक मैन्युअल चरण है, और जो बदलाव मिरर को नहीं मिले थे वे खो जाते हैं।

क्या यह ऑफ़लाइन काम करता है?

सर्वर इंटरनेट एक्सेस के बिना काम करता है। Windows इंस्टॉलर में Node.js और PostgreSQL शामिल हैं और यह ऑफ़लाइन इंस्टॉल होता है। Linux पैकेजों में Node.js शामिल है, और पैकेज प्रबंधक PostgreSQL इंस्टॉल करता है। स्क्रिप्ट इंस्टॉलर और Docker फ़ाइलें डाउनलोड करते हैं। अपडेट किसी रिलीज़ की स्थानीय प्रति से इंस्टॉल किए जा सकते हैं। यदि अपडेट हब तक न पहुँचा जा सके, तो अपडेट जाँच विफल होती है और कंसोल में दिखाई जाती है; और कुछ प्रभावित नहीं होता। इंस्टॉलेशन चुनें और अपडेट देखें।

स्टोरेज और डेटाबेस

यह कौन-सा डेटाबेस इस्तेमाल करता है?

PostgreSQL, हर इंस्टॉलेशन के लिए एक डेटाबेस। Windows इंस्टॉलर में PostgreSQL 18.4 शामिल है। Linux पैकेज आपके डिस्ट्रिब्यूशन के PostgreSQL 16 से 19 सर्वर का एक समर्पित क्लस्टर इस्तेमाल करते हैं। Docker Compose स्टैक कंटेनर में PostgreSQL 18.4 चलाता है। स्क्रिप्ट इंस्टॉलर आपका अपना सर्वर इस्तेमाल करते हैं। कभी दो इंस्टॉलेशन एक डेटाबेस से न जोड़ें। फ़ाइल की सामग्री डेटाबेस में नहीं होती: वह डेटा डायरेक्टरी में होती है।

क्या मैं S3 या कोई दूसरा ऑब्जेक्ट स्टोर इस्तेमाल कर सकता हूँ?

नहीं। फ़ाइल की सामग्री एक स्थानीय डायरेक्टरी में सहेजी जाती है, जो हार्ड लिंक समर्थित स्थानीय फ़ाइल सिस्टम पर होनी चाहिए, नेटवर्क शेयर पर नहीं। Arkvory सामग्री को S3 में नहीं सहेजता और S3 इंटरफ़ेस नहीं देता। बैकअप स्टोरेज (vault) किसी दूसरी डिस्क या माउंट किए गए नेटवर्क शेयर पर एक फ़ोल्डर है (Windows पर, कोई स्थानीय या iSCSI वॉल्यूम)।

क्या मैं अपनी कंपनी का सिंगल साइन-ऑन इस्तेमाल कर सकता हूँ?

नहीं। खाते, समूह और पासवर्ड Arkvory के हैं। ऑटोमेशन सेवा कुंजियों से साइन इन करता है। प्रमाणीकरण देखें।

सर्वर चलाना

मैं कैसे देखूँ कि कौन-सा संस्करण इंस्टॉल है?

कंसोल में अपडेट खोलें: इंस्टॉल किया गया संस्करण इसे दिखाता है। सर्वर पर arkvory status --root <installation root> चलाएँ और current पढ़ें; Windows पर ग्राफ़िकल इंस्टॉलर के साथ, elevated PowerShell में & 'C:\Program Files\ProAnima\Arkvory\arkvory.ps1' status --root 'C:\ProgramData\ProAnima\Arkvory' चलाएँ। व्यवस्थापक GET /api/v1/system/updates भी कॉल कर सकता है, जो currentVersion लौटाता है। arkvoryctl --version कमांड क्लाइंट का संस्करण दिखाता है, सर्वर का नहीं।

मैं स्वचालित अपडेट कैसे चालू करूँ?

कंसोल में अपडेट खोलें, संगत स्थिर रिलीज़ अपने-आप इंस्टॉल करें चुनें, रखरखाव का घंटा (UTC) चुनें और सेटिंग्स सहेजें चुनें। सर्वर पर arkvory configure --root <installation root> --enable-updates चलाएँ; --disable-updates उन्हें बंद कर देता है। इंस्टॉलर उन्हें बंद ही छोड़ते हैं, जब तक आप --automatic न दें।

स्वचालित इंस्टॉलेशन बंद होने पर भी सर्वर हर 6 घंटे में रिलीज़ जाँचता है। उसके चालू होने पर, एक स्थिर रिलीज़ रखरखाव के घंटे में (डिफ़ॉल्ट रूप से 03:00 UTC) दिन में एक बार इंस्टॉल होती है, जब तक संस्करण पिन न हो। डेटाबेस स्कीमा बदलने वाली रिलीज़ केवल तब इंस्टॉल होती है जब सर्वर ने ताज़ा बैकअप बना और सत्यापित कर लिया हो। अपडेट देखें।

Arkvory, ProAnimaStudio को क्या भेजता है?

आपकी फ़ाइलें और डेटा आपके सर्वर पर ही रहते हैं। सर्वर तीन चीज़ों के लिए ProAnimaStudio हब (hub.proanima.net) से संपर्क करता है, और हब तक न पहुँच पाने पर GitHub से:

• अपडेट जाँच। अनुरोध में प्रोजेक्ट का नाम, ऑपरेटिंग सिस्टम, प्रोसेसर आर्किटेक्चर, इंस्टॉल किया गया संस्करण और अपडेट चैनल होते हैं। सांख्यिकी चालू होने पर इसमें एक यादृच्छिक इंस्टॉलेशन ID भी होती है।
• अनाम सांख्यिकी। हर इंस्टॉल किए गए अपडेट के बाद एक इवेंट, जिसमें इंस्टॉलेशन ID, संस्करण, सिस्टम, आर्किटेक्चर और चैनल होते हैं। कोई नाम, पता, सामग्री या IP पता संग्रहीत नहीं होता। सांख्यिकी डिफ़ॉल्ट रूप से चालू हैं; उन्हें अपडेट में ProAnimaStudio को अनाम आँकड़े भेजें से या arkvory configure --statistics off से बंद करें। सांख्यिकी के बिना, नया संस्करण आपके पास केवल तब पहुँचता है जब वह सबके लिए रोल आउट हो गया हो।
• फ़ीडबैक। केवल जब कोई साइन-इन व्यक्ति इसे फ़ीडबैक से भेजे। इसमें संदेश, एक वैकल्पिक ईमेल पता, 6 तक स्क्रीनशॉट और कंसोल लॉग होते हैं। व्यवस्थापक बिना सीक्रेट वाले सर्वर लॉग और संस्करणों तथा अवस्थाओं का सारांश जोड़ सकता है। संलग्न सामग्री दिखाएँ ठीक वही दिखाता है जो भेजा जाएगा।

arkvory configure --hub-off हब से संपर्क करना बंद कर देता है: तब रिलीज़ केवल GitHub से आती हैं, और सेवाएँ रीस्टार्ट होने के बाद फ़ीडबैक बंद हो जाता है। खाली ARKVORY_HUB_URL केवल फ़ीडबैक बंद करता है। लाइसेंस, अनुच्छेद 7 देखें।

क्या बैकअप अपने-आप चलते हैं?

जब तक आप उन्हें सेट न करें, नहीं। arkvory configure --backup-vault <folder> --vault-key-file <file> से बैकअप स्टोरेज (vault) जोड़ें, फिर बैकअप में शेड्यूल और प्रतिधारण से दैनिक शेड्यूल चालू करें। योजना 02:00 UTC पर शुरू होती है और 7 दैनिक, 4 साप्ताहिक और 6 मासिक पुनर्स्थापना बिंदु रखती है। जब तक शेड्यूल चालू न हो, कंसोल चेतावनी दिखाता है कि दैनिक शेड्यूल बंद है। बैकअप देखें।

मैं दूसरे सर्वर पर कैसे जाऊँ?

1. नए सर्वर पर वही या नया संस्करण इंस्टॉल करें।
2. arkvory-backup restore कमांड से बैकअप स्टोरेज (vault) से सबसे नया पुनर्स्थापना बिंदु खाली डेटाबेस और खाली स्टोरेज डायरेक्टरी में पुनर्स्थापित करें। यह हर फ़ाइल को SHA-256 से जाँचता है। बैकअप देखें।
3. config/runtime.json में ARKVORY_DATABASE_URL और ARKVORY_DATA_DIR को पुनर्स्थापित डेटाबेस और डायरेक्टरी पर इंगित करें, सेवाएँ रीस्टार्ट करें, और कंसोल, एक डाउनलोड तथा एक अपलोड जाँचें।
4. पता (DNS या CI सेटिंग्स) नए सर्वर पर ले जाएँ।

उपयोगकर्ता, समूह और पासवर्ड वापस आ जाते हैं। सत्र स्थानांतरित नहीं होते, व्यक्तिगत टोकन और सेवा कुंजियाँ निरस्त कर दी जाती हैं, इसलिए फिर से साइन इन करें और नई कुंजियाँ जारी करें। प्रतिधारण और क्लीनअप नीतियाँ बंद होकर वापस आती हैं; उन्हें जान-बूझकर चालू करें। जो अपलोड पूरे नहीं हुए वे रद्द कर दिए जाते हैं। ऐसी रिपॉज़िटरी के लिए जिसे आप पुराने सर्वर के चलते रहते हुए स्थानांतरित करना चाहते हैं, आप नए सर्वर को उसे मिरर के रूप में अनुसरण करने दे सकते हैं और स्विच करते समय उसे अलग कर सकते हैं; मिरर फ़ाइलें, पैकेज और इमेज ले जाता है, लेकिन खाते, कुंजियाँ, अटैचमेंट या नीतियाँ नहीं।

सर्वर रीस्टार्ट होने पर ट्रांसफ़र का क्या होता है?

क्लाइंट जारी रखता है। अपलोड सत्र 7 दिन रहता है और जो भाग आ चुके हैं उन्हें रखता है; कमांड-लाइन क्लाइंट और SDK सर्वर से पूछते हैं कि उसके पास क्या है और बाकी भेज देते हैं। डाउनलोड Range अनुरोध के साथ जारी रहता है। एकल PUT अनुरोध, जैसे रॉ फ़ाइल या Docker लेयर, पहले बाइट से फिर शुरू होता है। रुके हुए ट्रांसफ़र जारी रखें देखें।

कुछ विफल होने पर मैं कहाँ देखूँ?

हर त्रुटि में एक अनुरोध ID होता है, requestId फ़ील्ड और X-Request-Id हेडर में। उसे सर्वर के एक्सेस लॉग में खोजें। सेवाएँ अपने लॉग Windows पर logs फ़ोल्डर में और Linux पर journal (journalctl -u arkvory-api) में लिखती हैं। लॉग शामिल करने के लिए फ़ीडबैक से रिपोर्ट भेजें। समस्या निवारण और मॉनिटरिंग देखें।

एक्सेस

मैं स्वामी का पासवर्ड कैसे रीसेट करूँ?

कोई दूसरा व्यवस्थापक उपयोगकर्ता और एक्सेस में पासवर्ड रीसेट करें इस्तेमाल कर सकता है। यदि कोई साइन इन नहीं कर सकता, तो config/bootstrap-token.txt से पुनर्प्राप्ति कुंजी इस्तेमाल करें: GET /api/v1/users से खाते की ID खोजें और {"password": "…"} के साथ PATCH /api/v1/users/<id> भेजें। नया पासवर्ड 12 से 128 अक्षरों का होता है। रीसेट उस खाते के सभी सत्र और व्यक्तिगत टोकन समाप्त कर देता है। प्रमाणीकरण देखें।

पुनर्प्राप्ति कुंजी क्या है, और अगर वह खो जाए तो क्या हो?

यह इंस्टॉलेशन रूट में config/bootstrap-token.txt में एक सीक्रेट है, जिसे केवल सिस्टम व्यवस्थापक पढ़ सकता है। यह पहला स्वामी बनाती है और सेवा खातों का प्रबंधन करती है। इंस्टॉलेशन टूल फ़ाइल पढ़ते हैं, इसलिए उसे हटाएँ नहीं। यदि फ़ाइल खो गई है लेकिन आपके पास अभी भी व्यवस्थापक खाता है, तो आप उस खाते से काम जारी रख सकते हैं; नई पुनर्प्राप्ति कुंजी बनाने के लिए कॉन्फ़िगरेशन का पालन करें। अवधारणाएँ देखें।

मेरा CI कौन-सी कुंजी इस्तेमाल करे?

ऐसे सेवा खाते की सेवा कुंजी जिसकी नीति में केवल जॉब के लिए ज़रूरी कार्रवाइयाँ हों, उदाहरण के लिए प्रकाशित करने के लिए upload.create, upload.write, upload.complete, upload.read और job.read। कंसोल प्रीसेट पढ़ने का प्रीसेट और प्रकाशन का प्रीसेट सामान्य समूह भरते हैं। CI में पुनर्प्राप्ति कुंजी या किसी व्यक्ति का टोकन इस्तेमाल न करें। कुंजियाँ डिफ़ॉल्ट रूप से 90 दिन चलती हैं और 365 तक सीमित हैं, इसलिए रोटेशन की योजना बनाएँ। प्रमाणीकरण देखें।

व्यवस्थापक आर्टिफ़ैक्ट क्यों नहीं हटा सकता या स्टोरेज नीति क्यों नहीं बदल सकता?

कार्रवाइयाँ artifact.delete, storage.read, storage.manage और diagnostics.read केवल सेवा कुंजियों के लिए हैं। समूह अनुदान, व्यक्तिगत टोकन, सत्र और पुनर्प्राप्ति कुंजी उन्हें कभी नहीं ले जाते। एक सेवा खाता बनाएँ जिसके पास रिपॉज़िटरी पर ये कार्रवाइयाँ हों, एक कुंजी जारी करें, और उस कुंजी का उपयोग कॉल के लिए करें (API, arkvoryctl, या कंसोल में सेवा या ऑटोमेशन कुंजी से कनेक्ट करें)। त्रुटि 403 और कारण permission_missing होती है। प्रमाणीकरण देखें।

क्या Docker, Git LFS और Unity इसके साथ काम करते हैं?

हाँ। Arkvory /v2/ पर कंटेनर रजिस्ट्री, /lfs/<repository> पर Git LFS सर्वर और /npm/<repository>/ पर npm रजिस्ट्री परोसता है, जिसे Unity Package Manager इस्तेमाल कर सकता है। वे पासवर्ड के रूप में Arkvory कुंजी स्वीकार करते हैं। क्लाइंट और प्रोटोकॉल देखें।

लाइसेंस

क्या Arkvory ओपन सोर्स है?

नहीं। Arkvory निःशुल्क है, और उसका सोर्स कोड पढ़ने के लिए खुला है, लेकिन यह ओपन सोर्स नहीं है। यह Ian Panaev के ProAnima Arkvory License 1.0 के अंतर्गत है, जो फ़ोर्क या प्रतियाँ वितरित करने की अनुमति नहीं देता। कृपया इसे "open source" न कहें। पूरा पाठ LICENSE.md में है; दोनों में अंतर होने पर रूसी पाठ मान्य होगा।

मैं इसके साथ क्या कर सकता हूँ?

आप किसी भी उद्देश्य के लिए कितनी भी प्रतियाँ इंस्टॉल और उपयोग कर सकते हैं, कंपनी में भी; सोर्स पढ़ और अध्ययन कर सकते हैं; उसे बदल सकते हैं; और अपना बदला हुआ संस्करण अपने संगठन के भीतर इस्तेमाल कर सकते हैं। आप इसके माध्यम से अपने आर्टिफ़ैक्ट सहेज और वितरित कर सकते हैं, अपने ग्राहकों को भी।

क्या अनुमत नहीं है?

आप सॉफ़्टवेयर या बदले हुए संस्करण अपने संगठन के बाहर किसी को वितरित नहीं कर सकते, उसके कोड वाले फ़ोर्क, बिल्ड, कंटेनर इमेज या पैच प्रकाशित नहीं कर सकते, उसे या उसकी पहुँच को बेच, किराए पर या उधार नहीं दे सकते, उसके लिए शुल्क नहीं ले सकते, या तीसरे पक्ष को होस्टेड या प्रबंधित सेवा के रूप में नहीं दे सकते। आप कॉपीराइट सूचनाएँ, लाइसेंस या ProAnima Arkvory तथा ProAnimaStudio नाम हटा नहीं सकते, और बदले हुए संस्करण को मूल के रूप में प्रस्तुत नहीं कर सकते। जब आप सार्वजनिक रूप से Arkvory पर बने सिस्टम का वर्णन करें, तो स्रोत बताएँ: "ProAnima Arkvory by ProAnimaStudio (Ian Panaev), https://github.com/ProAnima/Arkvory"। प्रतियाँ केवल आधिकारिक स्रोतों से लें। अन्य अनुमतियों के लिए info@proanima.net पर लिखें।

मैं किसी समस्या या भेद्यता की रिपोर्ट कहाँ करूँ?

अपने इंस्टॉलेशन में किसी समस्या के लिए, कंसोल में फ़ीडबैक इस्तेमाल करें। सुरक्षा समस्या के लिए, रिपॉज़िटरी में SECURITY.md का पालन करें और उसे सार्वजनिक रूप से न डालें।