সমস্যার সমাধান

আপনার লক্ষণ খুঁজে নিন, কারণ পড়ুন, সমাধান মেনে চলুন। উদাহরণগুলোতে কন্টেইনারের নাম holyarrs ধরা হয়েছে; আপনার নাম আলাদা হলে সেটি ব্যবহার করুন।

শুরুর 3টি যাচাই

1. লগ দেখুন: docker logs -f holyarrs। গোপন তথ্য ঢাকা থাকে। লগ দেখা থামাতে Ctrl+C চাপুন; কন্টেইনার চলতেই থাকে।
2. ডক্টর চালান: docker exec holyarrs /holyarrs doctor। প্রতিটি লাইনে OK, WARN বা FAIL লেখা থাকে, আর প্রতিটি WARN বা FAIL বলে দেয় কীভাবে ঠিক করবেন।
3. তবু আটকে আছেন? একটি সাপোর্ট বান্ডেল ডাউনলোড করে সাহায্য চান। দেখুন সহায়তা নিন।

ওয়েব পেজে ঢোকা যাচ্ছে না

লক্ষণ: ব্রাউজার http://your-server:6262-এ সংযোগ করতে পারছে না।

কারণ: কন্টেইনার বন্ধ, পোর্ট ম্যাপ করা নেই, অথবা মাঝখানে একটি proxy আছে।

সমাধান:

1. docker ps চালান। আপনি 0.0.0.0:6262->6262-সহ holyarrs দেখতে পাবেন।
2. বারবার রিস্টার্ট হতে থাকলে কারণের জন্য docker logs holyarrs পড়ুন।
3. /holyarrs-এর মতো কোনো পাথ ব্যবহার করলে দেখুন Reverse proxy ও URL base।

পারমিশন নেই

লক্ষণ: ডক্টর বলছে একটি ফোল্ডারে লেখা যাচ্ছে না, অথবা ইমপোর্ট পারমিশনের ত্রুটি দিয়ে ব্যর্থ হচ্ছে।

কারণ: হোস্টে ফোল্ডারের মালিক PUID ও PGID-এর সঙ্গে মেলে না।

সমাধান: ডক্টর যে chown দিতে বলে সেটি চালান, অথবা PUID ও PGID ফোল্ডারের মালিকের মতো করে দিন। NAS-এ পারমিশনের স্ক্রিনে ওই ইউজারকে পড়া ও লেখার পারমিশন দিন। দেখুন NAS, Synology ও Unraid।

কিছুই ডাউনলোড হচ্ছে না

লক্ষণ: টাইটেলগুলো নেই অবস্থায় থেকে যাচ্ছে এবং আপনার ডাউনলোডারে কিছুই পৌঁছাচ্ছে না।

কারণ: কোনো সোর্স সাড়া দিচ্ছে না, ডাউনলোডার সংযুক্ত নেই, অথবা কোনো রিলিজ আপনার বাছাইয়ের নিয়ম পাস করছে না।

সমাধান:

1. Settings > Downloaders (সেটিংস > ডাউনলোডার) খুলুন এবং আপনার ডাউনলোডারে Test (টেস্ট) ক্লিক করুন। এটি পাস করার কথা।
2. Settings > Sources (সেটিংস > সোর্স) খুলুন এবং প্রতিটি সোর্সে Test ক্লিক করুন।
3. টাইটেলের পেজে Choose a release (রিলিজ বেছে নিন) খুলে প্রতিটি ফলাফল এবং সেটি কেন বাছা হয়নি তার কারণ দেখুন।

দেখুন ডাউনলোডার ও সোর্স।

ডাউনলোড হয়েছে কিন্তু ইমপোর্ট হয়নি

লক্ষণ: আপনার ডাউনলোডারে ডাউনলোড শেষ হয়েছে, কিন্তু টাইটেলটি আপনার লাইব্রেরিতে নেই।

কারণ: HolyArrs একই পাথে ফাইলটি দেখতে পাচ্ছে না, লাইব্রেরি ফোল্ডারে লিখতে পারছে না, অথবা ইমপোর্টে একটি সিদ্ধান্ত দরকার।

সমাধান:

1. HolyArrs ও ডাউনলোডারকে একই ডাউনলোড ফোল্ডার একই পাথে দিন, যেমন /downloads, অথবা ডাউনলোডারে Downloader’s path (ডাউনলোডারের পাথ) ও HolyArrs’ path (HolyArrs-এর পাথ) ঠিক করে দিন।
2. ডক্টর চালান এবং ডাউনলোড বা লাইব্রেরি ফোল্ডারের যেকোনো FAIL ঠিক করুন।
3. ডাউনলোডের তালিকায় Needs a decision (সিদ্ধান্ত দরকার) চিহ্নিত আইটেম আছে কি না দেখুন, এবং পরিকল্পনাটি অনুমোদন বা বাতিল করুন।

ইমপোর্ট কপি হচ্ছে, hardlink নয়

লক্ষণ: ডক্টর বলছে hardlink কাজ করছে না, অথবা ইমপোর্টের পর ডিস্কের ব্যবহার দ্বিগুণ হয়ে যাচ্ছে।

কারণ: ডাউনলোড ও লাইব্রেরি ফোল্ডার আলাদা ডিস্কে বা আলাদা মাউন্টে আছে, অথবা ডিস্কটি hardlink করতে পারে না (DrivePool, বেশিরভাগ NAS ও SMB শেয়ার, Windows-এ Docker Desktop)। তবু প্রতিটি ফাইল একবারই লেখা হয়। শেষ হওয়া Usenet ডাউনলোড লাইব্রেরির সঙ্গে একই ডিস্কে থাকলে সরানো হয়।

সমাধান: আলাদা আলাদা না দিয়ে একটি শেয়ার করা প্যারেন্ট ফোল্ডার কন্টেইনারে মাউন্ট করুন। দেখুন ফোল্ডার।

HolyArrs চালু হচ্ছে না

লক্ষণ: কন্টেইনার বন্ধ হয়ে যাচ্ছে অথবা সঙ্গে সঙ্গে রিস্টার্ট হচ্ছে।

কারণ: লগে কারণটি লেখা থাকে। সাধারণগুলো: নেটওয়ার্ক শেয়ার বা FUSE পাথে /config, অথবা একটি ভেঙে যাওয়া অংশ।

সমাধান:

1. লগে তেমন লেখা থাকলে /config একটি লোকাল ডিস্কে সরান। HolyArrs শেয়ারের ওপর তার ডেটাবেস চালায় না।
2. না হলে সেফ মোডে চালু করুন, Settings (সেটিংস) থেকে ঠিক করুন এবং স্বাভাবিকভাবে রিস্টার্ট করুন।

একটি ফিচার নেই

লক্ষণ: আপনি যে ফিচারের কথা পড়েছেন সেটি অ্যাপে নেই।

কারণ: এই ভার্সনে সেটি হয়তো আটকে রাখা হয়েছে।

সমাধান: দেখুন আটকে রাখা ফিচার।

পেজে নাম বা ছবি নেই

লক্ষণ: টাইটেলগুলো পোস্টার বা বিবরণ ছাড়া দেখাচ্ছে।

কারণ: মেটাডেটা সার্ভারে পৌঁছানো যাচ্ছে না।

সমাধান: আপনার DNS ও ফায়ারওয়াল দেখুন। ডক্টরের Network অংশ দেখায় সার্ভার সাড়া দিচ্ছে কি না।

বিশেষজ্ঞদের জন্য

ডক্টরের যাচাই ও অপশন

ডক্টর কন্টেইনারের ভেতরে ঠিক সেই ইউজারেই চলে যে ইউজারে HolyArrs চলে, তাই HolyArrs যে সমস্যায় পড়ে ডক্টরও তাতেই পড়ে।

অংশ	যা দেখায়
App	ভার্সন, ইউজার ও গ্রুপ, umask, এবং এটি কন্টেইনারে চলছে কি না।
Config folder	মালিক, পারমিশন, খালি জায়গা, এবং এটি লোকাল ডিস্কে আছে কি না।
Library and download folders	আছে কি না, মালিক, লেখা যায় কি না, খালি জায়গা, এবং ডাউনলোড ও লাইব্রেরি ফোল্ডারের মধ্যে hardlink।
Network	মেটাডেটা সার্ভারের নাম resolve হচ্ছে কি না এবং সে সাড়া দিচ্ছে কি না।
Clock	সময়, টাইম জোন (TZ), আর ঘড়ি স্পষ্টতই ভুল হলে একটি সতর্কতা।

অপশন	কী করে
-config <folder>	/config ছাড়া অন্য একটি HolyArrs কনফিগ ফোল্ডার যাচাই করে।
-json	রিপোর্টটি JSON হিসেবে ছাপে।

এক্সিট কোড 0 মানে কিছুই ব্যর্থ হয়নি; 1 মানে কোনো লাইনে FAIL আছে। রিপোর্টে কখনো কী, পাসওয়ার্ড বা token দেখানো হয় না। এটি শুধু পড়ে, তবে একটি ছোট টেস্ট ফাইল লিখে আবার মুছে ফেলে। root হিসেবে চালু হলে এটি স্বাভাবিক চালু করার মতোই কনফিগ ফোল্ডারের মালিকানা PUID:PGID-কে দিয়ে দেয়।

HolyArrs বারবার রিস্টার্ট হতে থাকলে docker exec ব্যর্থ হয়। একই ফোল্ডার দিয়ে একটি নতুন কন্টেইনারে ডক্টর চালান:

docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> -e TZ=<tz> holyarrs/holyarrs:<tag> doctor

Compose দিয়ে: docker compose run --rm holyarrs doctor।

চালু হওয়ার সময় ফোল্ডার যাচাই

চালু হওয়ার সময় HolyArrs নিজের ফোল্ডারগুলো যাচাই করে এবং folders: 4 ok, 1 not writable-এর মতো একটি সারসংক্ষেপ লাইন লগ করে, তারপর সমস্যাওয়ালা প্রতিটি ফোল্ডারের জন্য সমাধানসহ এক লাইন লগ করে। যাচাই 3 সেকেন্ড পরে থেমে যায়, যাতে চালু হওয়া কখনো আটকে না থাকে। যে ফোল্ডার সাড়া দিতে খুব ধীর, সেটি যাচাই করা হয়নি বলে ধরা হয়; প্রায়ই এর কারণ ঘুম থেকে জাগা ডিস্ক বা ধীর নেটওয়ার্ক শেয়ার। ডক্টর সময়ের সীমা ছাড়াই এটি যাচাই করে। দেখুন লগ।

ইমেজে কোনো shell নেই

ইমেজে শুধু HolyArrs প্রোগ্রামটি আছে, তাই এটি ছোট থাকে এবং আক্রমণকারীর জন্য কম জিনিস পড়ে থাকে। docker exec holyarrs sh ইচ্ছা করেই ব্যর্থ হয়। কাছ থেকে দেখতে চাইলে পাশে একটি সাময়িক সহায়ক চালু করুন:

docker run --rm -it --pid container:holyarrs --network container:holyarrs --volumes-from holyarrs busybox sh

এটি HolyArrs-এর প্রসেস দেখতে পায়, তার নেটওয়ার্ক শেয়ার করে এবং একই পাথে একই ফোল্ডার পায়। এটি root হিসেবে চলে, তাই শুধু দেখুন, বদলাবেন না: root হিসেবে লেখা ফাইল HolyArrs পড়তে না-ও পারে। HolyArrs-এর ইউজার হিসেবে পরীক্ষা করতে --user <PUID>:<PGID> যোগ করুন।

ভার্সন খুঁজে বের করা

docker inspect --format '{{ index .Config.Labels "org.opencontainers.image.version" }}' holyarrs

ডক্টরের App অংশও একই জিনিস দেখায়।

সংশ্লিষ্ট

• সহায়তা নিন
• লগ
• হেলথ চেক