Felsökning
Börja med symptomet, inte databasen.
De flesta JFA-problem kan ringas in utan att arkivdata redigeras manuellt. Kontrollera miljön först, spara användbar felinformation och gör en ändring i taget.
Börja med grunderna
Innan du ändrar konfigurationen eller installerar om något bör du kontrollera att WordPress och JFA fungerar normalt och notera exakt vad som inte fungerar.
- Laddas WordPress normalt?
- Är JFA aktivt?
- Rapporterar JFA en fungerande släktforskningsprovider?
- Har den privata lagringen skrivbehörighet?
- Rapporteras skyddet för privata medier som fungerande?
- Började problemet efter en uppdatering, import eller serverändring?
Spara det första användbara felmeddelandet.
Det första specifika felet är vanligtvis mer användbart än följdvarningar som visas efter att något redan har misslyckats. Spara meddelandet innan du försöker om flera gånger eller ändrar flera inställningar samtidigt.
Installationsproblem
WordPress vägrar installera ZIP-filen
Kontrollera att du laddade ner installationsfilen för WordPress och inte ett källkodsarkiv eller någon annan export från kodarkivet.
Kontrollera också att servern tillåter uppladdning av tillägg i den storleken och att kontot du använder får installera tillägg.
Aktiveringen misslyckas
Kontrollera att installationen uppfyller minimikraven för WordPress och PHP. Om WordPress rapporterar ett PHP-fel bör du spara det exakta felmeddelandet innan tillägget inaktiveras eller installeras om.
Guiden för första konfigurationen visas inte
Introduktionsflödet är avsett för helt nya JFA-installationer. Ett befintligt arkiv eller en installation som redan har initierats ska inte bete sig som en helt ny installation.
Problem med privat lagring
Statusen för privata medier är särskilt viktig eftersom ett konfigurationsproblem kan påverka både filernas tillgänglighet och integritetsskyddet.
Saknar skrivbehörighet
JFA kan inte lagra filer
WordPress-processen har inte tillräcklig åtkomst till filsystemet på den konfigurerade privata lagringsplatsen.
Exponerad
Direkt HTTP-åtkomst fungerar
Ladda inte upp känsligt material så länge JFA rapporterar att det privata området kan nås direkt från webben.
Okänd
Skyddet kunde inte verifieras
Undersök varför HTTP- eller lagringskontrollen inte kunde slutföras i stället för att behandla ett okänt resultat som skyddat.
Lös inte ett behörighetsproblem med onödigt omfattande behörigheter.
Målet är att ge WordPress-processen den åtkomst den behöver, inte att göra privata arkivkataloger skrivbara för alla på servern.
Ett fotografi eller dokument går inte att öppna
Ta först reda på om problemet påverkar en enda fil eller alla privata medier.
EN FIL
Kontrollera det enskilda objektet
Uppladdningen kan ha misslyckats, den lagrade filen kan saknas eller arkivposten kan peka på material som inte längre är tillgängligt.
ALLA FILER
Kontrollera lagring och åtkomst
Om alla privata filer misslyckas bör du undersöka lagringsprovidern, filsystemets behörigheter, den skyddade medievägen och den aktuella användarens åtkomst innan enskilda arkivposter redigeras.
Problem med GEDCOM-import
Genomför inte en import när förhandsgranskningen innehåller stora oförklarade skillnader, identitetsvarningar eller tolkningsfel.
1
Behåll GEDCOM-filen
Ersätt eller redigera inte den enda kopian av filen som återskapade problemet.
2
Notera källan
Notera vilket släktforskningsprogram och vilken exportprocess som skapade filen.
3
Spara informationen från förhandsgranskningen
Spara relevanta antal, varningar och fel innan du lämnar importsidan.
4
Genomför inte en misstänkt import upprepade gånger
Undersök orsaken först i stället för att hoppas att samma åtgärd ska ge rätt resultat om den upprepas.
En ovanlig GEDCOM-fil från verklig användning kan vara mycket värdefull.
Om en ovanlig export på ett reproducerbart sätt avslöjar ett importfel i JFA kan ett sådant exempel vara mer värdefullt för utvecklingen än en vag rapport om att ”importen inte fungerar”.
En återimport verkar skapa dubbletter av personer
Avbryt innan du genomför fler importer och kontrollera att du uppdaterar samma logiska släktforskningskälla i stället för att skapa en ny importkälla.
Kontrollera också om exportprogrammet har ändrat eller tagit bort beständiga källidentiteter. Vanliga GEDCOM XREF-nummer ska inte antas vara stabila mellan exporter.
En avsiktligt borttagen person kommer tillbaka
Om en person avsiktligt har tagits bort från JFA men fortfarande finns i den externa släktforskningskällan ska en senare återimport respektera motsvarande importundantag.
Om det inte sker bör du behålla källfilen och importinformationen och behandla det som ett problem i importens livscykel i stället för att ta bort personen efter varje import.
Problem med inloggning eller åtkomst
Lösenordet godkänns inte
Kontrollera först det exakta användarnamnet. Användarnamn och visningsnamn behöver inte vara samma sak. Använd vid behov WordPress vanliga flöde för lösenordsåterställning eller kontohantering i stället för att ändra användarposter direkt i databasen.
Kontot kan logga in men kommer inte åt JFA
Kontrollera kontots roll och JFA-åtkomst i stället för att ge fullständig administratörsbehörighet i WordPress enbart för att få felet att försvinna.
Endast en webbläsarsession beter sig märkligt
Prova ett privat webbläsarfönster eller logga ut och in igen innan du antar att själva kontot är skadat. Cachelagrade sessioner och cookies kan få ett åtkomstproblem att verka inkonsekvent.
Sidor ger 404-fel
Om JFA-sidor eller vanliga WordPress-sidor plötsligt ger ”Sidan hittades inte” samtidigt som webbplatsen i övrigt fungerar bör du kontrollera WordPress permalänksinställningar innan arkivdata byggs om.
Att öppna Inställningar → Permalänkar och spara den avsedda permalänkstrukturen kan uppdatera WordPress regler för permalänkar efter en migrering eller konfigurationsändring.
Arkivet ser fel ut efter ett temabyte
Kom ihåg att JFA och det omgivande WordPress-temat är separata lager. Ett nytt WordPress-tema kan ändra webbplatsens sidhuvud, typografi, avstånd och annan yttre presentation utan att ändra underliggande JFA-arkivdata.
Testa arkivets besökarvy efter ett temabyte och kontrollera mer än en sidtyp innan du drar slutsatsen att JFA självt fungerar felaktigt.
Innan du installerar om eller återställer en säkerhetskopia
- Dokumentera det exakta symptomet och felmeddelandena.
- Ta en ny säkerhetskopia om det aktuella arkivet fortfarande är åtkomligt.
- Ta reda på om problemet påverkar WordPress generellt eller bara JFA.
- Kontrollera systemstatus och statusen för privat lagring.
- Behåll GEDCOM-filer eller uppladdade filer som på ett reproducerbart sätt återskapar problemet.
- Undvik att manuellt radera JFA:s databastabeller som en genväg vid felsökning.
En säkerhetskopia är ingen felsökningsstrategi.
Att återställa ett äldre arkiv kan få symptomet att försvinna men samtidigt radera den information som behövs för att förstå varför problemet uppstod. Dokumentera problemet först.
Rapportera ett användbart fel
Du behöver inte diagnostisera källkoden innan du rapporterar ett problem. En exakt beskrivning av vad som hände och hur problemet kan återskapas räcker för att göra rapporten värdefull.
Användbar felrapport
- JFA-version: den exakta installerade versionen
- WordPress-version: den version som kör webbplatsen
- PHP-version: om den är känd
- Vad du gjorde: åtgärden omedelbart innan problemet uppstod
- Vad du förväntade dig: resultatet du trodde skulle inträffa
- Vad som faktiskt hände: det observerade resultatet
- Felmeddelanden: kopierade exakt där det är möjligt
- Kan återskapas: om problemet inträffar varje gång
- Relevant fil: ett okänsligt exempel eller en reproducerbar GEDCOM-fil när det är lämpligt
Kontrollera en databasdump, GEDCOM-fil, skärmbild eller arkivfil efter uppgifter om levande släktingar eller annat privat material innan den delas offentligt.
Var problem rapporteras
Använd Family Archives offentliga kodarkiv för reproducerbara programfel och utvecklingsrelaterade ärenden.
Versionsinformation →
Se vilken JFA-version som är aktuell och vad som har förändrats mellan versionerna.