Troubleshooting Guide¶

Feilsøking og løsninger for vanlige problemer ved Google Workspace-migrering

1. GAM-relaterte problemer¶

Problem: "Command not found" eller GAM kjører ikke¶

Symptom:

gam: command not found

Løsning:

# Windows - Sjekk PATH-variabel
$env:Path -split ';' | Select-String "gam"

# Legg til GAM i PATH (midlertidig)
$env:Path += ";C:\Dev\Gam7"

# Legg til GAM i PATH (permanent)
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Dev\Gam7", "User")

Alternativ: Bruk full sti: C:\Dev\Gam7\gam.exe version

Problem: "ERROR: OAuth2 token not found"¶

Symptom:

ERROR: OAuth2 token not found

Løsning:

# Opprett OAuth2-token på nytt
gam oauth create

# Følg instruksjonene:
# 1. Åpne URL i nettleser
# 2. Logg inn med admin-konto
# 3. Godta tilganger
# 4. Kopier kode tilbake til terminal

Resultat: Ny oauth2.txt opprettes i GAM config-mappe.

Problem: "ERROR: Invalid argument"¶

Symptom:

ERROR: Invalid argument

Løsning: 1. Sjekk syntaks i GAM Wiki 2. Verifiser at alle argumenter er korrekte 3. Bruk gam help <kommando> for syntakshjelp

Eksempel:

# Feil
gam update group styret@skigk.no alias styret-full@skigk.no

# Riktig
gam create alias styret-full@skigk.no group styret@skigk.no

Problem: "ERROR: Group does not exist"¶

Symptom:

Group: GRUPPE@DOMENE.no, Does not exist

Løsning:

# Verifiser at gruppen finnes
gam print groups | Select-String "GRUPPE"

# Opprett gruppen hvis den mangler
gam create group GRUPPE@DOMENE.no name "Visningsnavn" description "Beskrivelse"

2. Tilgangsproblemer¶

Problem: Brukere ser ikke Shared Drives¶

Symptom: Brukere rapporterer at de ikke ser delte disker i Google Drive.

Løsning:

# 1. Verifiser at brukeren/gruppen har tilgang
gam show drivefileacl <DRIVE_ID>

# 2. Legg til tilgang hvis manglende
gam add drivefileacl <DRIVE_ID> anyone reader emailaddress BRUKER@DOMENE.no

# 3. Be brukeren refreshe Google Drive
# - Gå til drive.google.com
# - Venstre meny → "Delte disker"
# - Trykk F5 (refresh)

Tidsforskyvning: Det kan ta opptil 5-10 minutter før endringer vises.

Problem: Bruker har feil tilgangsnivå¶

Symptom: Bruker kan ikke redigere filer, selv om de skal ha skrivetilgang.

Løsning:

# 1. Sjekk nåværende rolle
gam show drivefileacl <DRIVE_ID> | Select-String "BRUKER@DOMENE.no"

# 2. Fjern gammel rolle
gam remove drivefileacl <DRIVE_ID> BRUKER@DOMENE.no

# 3. Legg til med riktig rolle
gam add drivefileacl <DRIVE_ID> anyone writer emailaddress BRUKER@DOMENE.no

Roller: - reader → Kun lese - commenter → Kan kommentere - writer → Kan redigere - fileOrganizer → Kan administrere innhold - organizer → Full kontroll

Problem: Gruppe får ikke e-post¶

Symptom: E-post sendt til gruppe@DOMENE.no kommer ikke frem.

Løsning:

# 1. Verifiser at gruppen finnes
gam info group gruppe@DOMENE.no

# 2. Sjekk gruppeinnstillinger i Admin Console
# - Gå til admin.google.com
# - Grupper → Finn gruppen
# - Sjekk "E-postinnstillinger"
# - Aktiver "Motta eksterne e-poster" hvis nødvendig

# 3. Sjekk medlemskap
gam print group-members group gruppe@DOMENE.no

3. Aliaser og delegering¶

Problem: Alias fungerer ikke¶

Symptom: E-post sendt til alias@DOMENE.no kommer ikke frem.

Løsning:

# 1. Verifiser at aliased eksisterer
gam info group GRUPPE@DOMENE.no | Select-String "aliases"

# 2. Opprett alias hvis manglende
gam create alias alias@DOMENE.no group GRUPPE@DOMENE.no

# 3. Vent 5-10 minutter og test på nytt

Merk: Det kan ta tid før aliaser propageres i Google-systemet.

Problem: Kan ikke delegere e-post¶

Symptom: Delegering av innboks feiler eller vises ikke.

Løsning:

# Bruk Gmail-innstillinger i stedet for GAM for delegering
# 1. Gå til mail.google.com (som bruker A)
# 2. Innstillinger (tannhjul) → "Se alle innstillinger"
# 3. Fanen "Kontoer" → "Gi tilgang til kontoen din"
# 4. Legg til bruker B sin e-postadresse

GAM-metode (avansert):

# Krever spesiell oppsett og kan ikke alltid brukes
gam user BRUKER_A@DOMENE.no delegate to BRUKER_B@DOMENE.no

4. Import og migreringsv problemer¶

Problem: CSV-fil ikke funnet¶

Symptom:

ERROR: File not found: members.csv

Løsning:

# Bruk full sti
gam csv "C:\Dev\SkiGK-SetupWS\members.csv" gam update group...

# Eller naviger til riktig mappe først
cd C:\Dev\SkiGK-SetupWS
gam csv members.csv gam update group...

Problem: CSV-import feiler for noen rader¶

Symptom: Noen brukere legges ikke til selv om CSV ser riktig ut.

Løsning:

# 1. Sjekk CSV-format
# - Må være UTF-8
# - Første linje må være kolonnenavn
# - Ingen tomme rader

# 2. Åpne i Notepad++ eller VS Code (IKKE Excel)
# 3. Lagre som UTF-8 (uten BOM)

# 4. Kjør batch-import med error logging
gam csv members.csv gam update group GRUPPE@DOMENE.no add member ~email 2> errors.log

5. Ytelse og timeout¶

Problem: GAM-kommando tar veldig lang tid¶

Symptom: Kommando henger eller tar mange minutter.

Løsning:

# 1. Kjør med batch-modus for store datasett
gam batch

# 2. Bruk færre resultater ved testing
gam print users maxresults 10

# 3. Sjekk nettverksforbindelse
ping google.com

Problem: "Quota exceeded" eller "Rate limit"¶

Symptom:

ERROR: Quota exceeded for quota metric...

Løsning:

# 1. Vent 1-5 minutter og prøv igjen

# 2. Bruk batch-modus med forsinkelse
gam config batch_size 10 inter_batch_wait 5

# 3. Sjekk API-kvoter i Google Cloud Console
# - cloud.google.com
# - APIs & Services → Dashboard

6. Dokumentasjonssvikt¶

Problem: Kan ikke finne drive-ID¶

Symptom: Vet ikke hvilken ID som tilhører hvilken delt disk.

Løsning:

# 1. Eksporter alle delte disker
gam print teamdrives > shared_drives.csv

# 2. Åpne CSV i Excel/Notepad
# 3. Finn riktig disk basert på navn

# Alternativt: Bruk navn i stedet for ID
gam info teamdrive "Diskens navn"

Problem: Mangler dokumentasjon for endring¶

Symptom: Usikker på hva som ble gjort tidligere.

Løsning:

# 1. Sjekk CHANGELOG.md
# 2. Sjekk task lists i docs/
# 3. Sjekk Git-historikk

git log --oneline --all
git show <commit-hash>

Beste praksis: - Alltid dokumenter endringer i CHANGELOG.md - Oppdater task lists fortløpende - Commit ofte til Git med beskrivende meldinger

7. Onboarding-problemer¶

Problem: Brukere forstår ikke systemet¶

Symptom: Mange support-henvendelser om grunnleggende ting.

Løsning: 1. Forbedre onboarding-materiell: - Lag video-tutorial (5-10 min) - Lag quick-start guide (PDF, 1-2 sider) - Lag FAQ-dokument

Kjør flere opplæringssesj oner:
Første uke: Daglig drop-in support
Første måned: Ukentlig Q&A-sesjon
Sett opp support-kanal:
Dedikert e-post: hjelp@DOMENE.no
Slack/Teams-kanal for rask support

Problem: Brukere finner ikke sine filer¶

Symptom: Brukere lurer på hvor gamle filer er.

Løsning:

# 1. Verifiser at filer er migrert
# 2. Send ut oversikt over ny mappestruktur
# 3. Lag "Hvor finner jeg..."-guide

# Eksempel-guide:
# - Styredokumenter: Delt disk "Styret" → 2025 → Dokumenter
# - Økonomi: Delt disk "Økonomi" → 2025 → Regnskap

8. Sikkerhet og compliance¶

Problem: Sensitve data er feil tilgjengelig¶

Symptom: Brukere har tilgang til data de ikke skal se.

Løsning:

# 1. Identifiser hvilke brukere/grupper har tilgang
gam show drivefileacl <DRIVE_ID>

# 2. Fjern alle unødvendige tilganger
gam remove drivefileacl <DRIVE_ID> BRUKER@DOMENE.no

# 3. Legg kun til de som skal ha tilgang
gam add drivefileacl <DRIVE_ID> anyone reader emailaddress SIKKER_GRUPPE@DOMENE.no

# 4. Dokumenter endringen i CHANGELOG.md

Beste praksis: - Bruk sikkerhetsgruppper (f.eks. styret-sec@) for sensitive data - Gjennomgå tilganger månedlig - Aldri gi "organizer" til flere enn nødvendig

9. Backup og gjenoppretting¶

Problem: Fil slettet ved uhell¶

Symptom: Viktig fil er borte fra delt disk.

Løsning:

# Google Workspace har papirkurv for Shared Drives
# 1. Åpne den delte disken i Google Drive
# 2. Høyreklikk på disk-navn → "Se elementer i papirkurv"
# 3. Høyreklikk på fil → "Gjenopprett"

# Hvis fil er slettet permanent (> 30 dager):
# Kontakt Google Workspace support (admin.google.com → Support)

Problem: Gruppe slettet ved uhell¶

Symptom: Gruppe finnes ikke lenger.

Løsning:

# Grupper kan gjenopprettes innen 5 dager
# 1. Gå til admin.google.com
# 2. Grupper → Slettede grupper
# 3. Velg gruppe → Gjenopprett

# Hvis mer enn 5 dager:
# Må opprette gruppen på nytt manuelt
gam create group GRUPPE@DOMENE.no name "Visningsnavn" description "Beskrivelse"

10. Kontakt og eskalering¶

Når skal du kontakte support?¶

Intern support (IT-ansvarlig): - Tilgangsproblemer - Opplæring og veiledning - Tekniske spørsmål

Google Workspace Support: - API-problemer - Faktureringsspørsmål - Gjenoppretting av slettede data (> 30 dager) - Compliance og juridiske spørsmål

Kontaktinfo: - Google Support: admin.google.com → Support - GAM GitHub Issues: github.com/GAM-team/GAM/issues

Ressurser¶

Versjon: 1.0
Sist oppdatert: 1. desember 2025

Har du funnet en løsning som ikke er dokumentert her?
Legg til i denne guiden og commit til Git!