சிக்கல் தீர்வு

உங்கள் அறிகுறியைக் கண்டுபிடித்து, காரணத்தைப் படித்து, தீர்வைப் பின்பற்றவும். எடுத்துக்காட்டுகள் holyarrs என்ற container பெயரைப் பயன்படுத்துகின்றன. உங்களுடையது வேறாக இருந்தால் அதைப் பயன்படுத்தவும்.

முதல் 3 சோதனைகள்

1. Log-ஐப் பார்க்கவும்: docker logs -f holyarrs. ரகசியங்கள் மறைக்கப்பட்டிருக்கும். பின்தொடர்வதை நிறுத்த Ctrl+C அழுத்தவும். container தொடர்ந்து இயங்கும்.
2. Doctor-ஐ இயக்கவும்: docker exec holyarrs /holyarrs doctor. ஒவ்வொரு வரியும் OK, WARN அல்லது FAIL என்று சொல்லும். ஒவ்வொரு WARN அல்லது FAIL-உம் எப்படிச் சரிசெய்வது என்றும் சொல்லும்.
3. இன்னும் சிக்கலா? ஆதரவுத் தொகுப்பைப் பதிவிறக்கி உதவி கேட்கவும். ஆதரவைப் பெறுதல் பக்கத்தைப் பார்க்கவும்.

Web பக்கத்தை அடைய முடியவில்லை

அறிகுறி: Browser http://your-server:6262-உடன் இணைய முடியவில்லை.

காரணம்: container நின்றுவிட்டது, port பொருத்தப்படவில்லை, அல்லது நடுவில் ஒரு proxy இருக்கிறது.

தீர்வு:

1. docker ps இயக்கவும். 0.0.0.0:6262->6262 உடன் holyarrs தெரிய வேண்டும்.
2. அது திரும்பத் திரும்ப மறுதொடக்கம் ஆகிக்கொண்டிருந்தால், காரணத்துக்காக docker logs holyarrs படிக்கவும்.
3. /holyarrs போன்ற பாதையைப் பயன்படுத்தினால், Reverse proxy மற்றும் URL base பக்கத்தைப் பார்க்கவும்.

அனுமதி மறுக்கப்பட்டது

அறிகுறி: ஓர் அடைவு எழுதத்தக்கதல்ல என்று doctor சொல்கிறது, அல்லது இறக்குமதிகள் அனுமதிப் பிழையுடன் தோல்வியடைகின்றன.

காரணம்: host-இல் அடைவின் உரிமையாளர் PUID, PGID ஆகியவற்றுடன் பொருந்தவில்லை.

தீர்வு: doctor பரிந்துரைக்கும் 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. Doctor-ஐ இயக்கி, பதிவிறக்க அல்லது நூலக அடைவுகளில் உள்ள எந்த FAIL-ஐயும் சரிசெய்யவும்.
3. பதிவிறக்கப் பட்டியலில் Needs a decision (முடிவு தேவை) எனக் குறிக்கப்பட்ட உருப்படிகள் உள்ளனவா என்று பார்த்து, திட்டத்தை ஏற்கவும் அல்லது தள்ளுபடி செய்யவும்.

இறக்குமதிகள் நகல்களாக உள்ளன, hardlink-ஆக இல்லை

அறிகுறி: hardlink-கள் வேலை செய்யவில்லை என்று doctor சொல்கிறது, அல்லது இறக்குமதிகளுக்குப் பிறகு வட்டுப் பயன்பாடு இரட்டிப்பாகிறது.

காரணம்: பதிவிறக்க அடைவுகளும் நூலக அடைவுகளும் வெவ்வேறு வட்டுகளில் அல்லது mount-களில் உள்ளன, அல்லது அந்த வட்டு hardlink (கடின இணைப்பு) செய்ய முடியாது (DrivePool, பல NAS மற்றும் SMB பகிர்வுகள், Windows-இல் Docker Desktop). ஒவ்வொரு கோப்பும் இன்னும் ஒரே முறைதான் எழுதப்படுகிறது. முடிந்த Usenet பதிவிறக்கங்கள் நூலகத்துடன் ஒரே வட்டில் இருந்தால் நகர்த்தப்படும்.

தீர்வு: தனித்தனி அடைவுகளுக்குப் பதிலாக, ஒரு பொதுவான மேல் அடைவை container-இல் mount செய்யவும். அடைவுகள் பக்கத்தைப் பார்க்கவும்.

HolyArrs தொடங்கவில்லை

அறிகுறி: container நின்றுவிடுகிறது அல்லது உடனே மறுதொடக்கம் ஆகிறது.

காரணம்: log அதன் பெயரைச் சொல்லும். பொதுவானவை: பிணையப் பகிர்வு அல்லது FUSE பாதையில் உள்ள /config, அல்லது உடைந்த ஒரு பகுதி.

தீர்வு:

1. Log அப்படிச் சொன்னால் /config-ஐ ஒரு உள்ளூர் வட்டுக்கு மாற்றவும். HolyArrs தன் தரவுத்தளத்தை ஒரு பகிர்வில் இயக்காது.
2. இல்லையென்றால், பாதுகாப்பு முறையில் தொடங்கி, Settings (அமைப்புகள்) திரையிலிருந்து சரிசெய்து, பிறகு வழக்கம்போல் மறுதொடக்கம் செய்யவும்.

ஒரு வசதி காணவில்லை

அறிகுறி: நீங்கள் படித்த ஒரு வசதி பயன்பாட்டில் இல்லை.

காரணம்: இந்தப் பதிப்பில் அது நிறுத்திவைக்கப்பட்டிருக்கலாம்.

தீர்வு: நிறுத்திவைக்கப்பட்ட வசதிகள் பக்கத்தைப் பார்க்கவும்.

பக்கங்களில் பெயர்கள் அல்லது படங்கள் இல்லை

அறிகுறி: தலைப்புகள் posters அல்லது விவரங்கள் இல்லாமல் தெரிகின்றன.

காரணம்: metadata server-ஐ அணுக முடியவில்லை.

தீர்வு: உங்கள் DNS-ஐயும் firewall-ஐயும் சரிபார்க்கவும். Server பதிலளிக்கிறதா என்பதை doctor-இன் Network பகுதி காட்டும்.

நிபுணர்களுக்கு

Doctor சோதனைகளும் விருப்பங்களும்

Doctor, HolyArrs இயங்கும் அதே பயனராக container-க்குள் இயங்குகிறது. அதனால் HolyArrs எதைச் சந்திக்கிறதோ அதையே அதுவும் சந்திக்கிறது.

பகுதி	காட்டுவது
App	பதிப்பு, பயனர் மற்றும் குழு, umask, அது container-இல் இயங்குகிறதா என்பது.
Config folder	உரிமையாளர், அனுமதிகள், காலி இடம், அது உள்ளூர் வட்டில் உள்ளதா என்பது.
Library and download folders	இருக்கிறதா, உரிமையாளர், எழுதத்தக்கதா, காலி இடம், பதிவிறக்க மற்றும் நூலக அடைவுகளுக்கு இடையே hardlink-கள்.
Network	Metadata server-இன் பெயர் தீர்க்கப்படுகிறதா, அது பதிலளிக்கிறதா என்பது.
Clock	நேரம், நேர மண்டலம் (TZ), கடிகாரம் தெளிவாகத் தவறாக இருந்தால் எச்சரிக்கை.

விருப்பம்	என்ன செய்கிறது
-config <folder>	/config-ஐத் தவிர வேறொரு HolyArrs config அடைவைச் சோதிக்கிறது.
-json	அறிக்கையை JSON-ஆக அச்சிடுகிறது.

Exit code 0 என்றால் எதுவும் தோல்வியடையவில்லை. 1 என்றால் ஒரு வரி FAIL என்கிறது. அறிக்கை விசைகள், கடவுச்சொற்கள் அல்லது token-களை ஒருபோதும் காட்டாது. அது எழுதி நீக்கும் ஒரு சிறிய சோதனைக் கோப்பைத் தவிர, படிக்க மட்டுமே செய்கிறது. root-ஆகத் தொடங்கினால், வழக்கமான தொடக்கத்தைப் போலவே config அடைவை PUID:PGID-க்கு ஒப்படைக்கவும் செய்கிறது.

HolyArrs திரும்பத் திரும்ப மறுதொடக்கம் ஆகிக்கொண்டிருந்தால், docker exec தோல்வியடையும். அதே அடைவுகளுடன் ஒரு புதிய container-இல் doctor-ஐ இயக்கவும்:

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 போன்ற ஒரு சுருக்க வரியை log செய்கிறது. பிறகு சிக்கல் உள்ள ஒவ்வொரு அடைவுக்கும் தீர்வுடன் ஒரு வரி வரும். தொடக்கம் ஒருபோதும் தொங்கிவிடாதபடி சோதனை 3 விநாடிகளுக்குப் பிறகு நின்றுவிடும். பதிலளிக்க மிகவும் மெதுவாக இருக்கும் அடைவு சோதிக்கப்படாததாகக் கணக்கில் வரும். இது பெரும்பாலும் உறக்கத்திலிருந்து எழும் வட்டு அல்லது மெதுவான பிணையப் பகிர்வு. Doctor நேர வரம்பு இல்லாமல் சோதிக்கிறது. Log-களும் சேமிப்பும் பக்கத்தைப் பார்க்கவும்.

Image-இல் shell இல்லை

Image-இல் 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

Doctor-இன் App பகுதியும் இதையே காட்டுகிறது.

தொடர்புடையவை

• ஆதரவைப் பெறுதல்
• Log-களும் சேமிப்பும்
• நலச் சோதனைகள்