Listeadministrasjon med sympaadmin

Sympaadmin er et verktøy for avansert administrasjon av Sympa-e-postlister. De fleste vanlige oppgaver kan gjøres på https://sympa.uio.no.

Om du har innspill eller tilbakemeldinger relatert til sympaadmin

Om Sympaadmin

Sympaadmin er et terminalbasert verktøy, skrevet i Perl og tilgjengelig på Linux-maskiner ved UiO, for eksempel login.uio.no. Det lar deg:

  • liste opp dine listemedlemskap og listeeierskap
  • moderere meldinger
  • modere abonnementsønsker
  • legge til medlemmer i lister du eier
  • fjerne medlemmer fra lister du eier

Sympaadmin har tre brukermodi:

  • hvis den startes med argumenter, så utfører den det argumentene tilsier og avslutter.
  • hvis den får input pipet fra kommandolinja, så gjør den dette og avslutter.
  • hvis den startes uten argumenter starter den en kommandoløkke.

Konfigurasjon: .sympaadmin.ini

Sympaadmin trenger en konfigurasjonsfil. Den skal kun inneholde brukeradresse (den du er assosiert med på Sympa-lister) og soapserver.

Syntaks på filen:

soapuser = adresse
soapserver = soapserver1
soapserver = soapserver2

soapuser = adresse
soapserver = soapserver3

...

Soapserverne på UiO har navn på formen https://sympa.uio.no/domene-soapserver. Så Ola Nordmann kan ha en slik konfigurasjonsfil:

soapuser = ola.nordmann@example.uio.no
soapserver = https://sympa.uio.no/uio.no-sympasoap

Sympaadmin spør så sympa.uio.no hvilke lister du har rettigheter til.

NB! Du må legge inn den eksakte adressen du er meldt på med, dvs. i de fleste tilfeller din primæradresse. Som en konsekvens må .sympaadmin.ini oppdateres dersom du endrer primæradresse.

Eksempel på konfigurasjonsfil som lar deg administrere alle lister til 2 brukere, benteaa og bca:

soapuser =  benteaa@ifi.uio.no
soapserver = https://sympa.uio.no/uio.no-sympasoap

soapuser =  b.c.aasgaard@usit.uio.no
soapserver = https://sympa.uio.no/uio.no-sympasoap

Bruk

Hjelp:

% sympaadmin -h
Usage:
    sympaadmin [-f CONFIGFILE] [-d] [--help] [--version] [cmd] ...

Options:
    -d, --debug
        Enable debug mode. More verbose output.

    -v, --version
        Print version and exit.

    -h, --help
        Print help text and exit, use -h -h to get the full manpage.

    -f CONFIGFILE, --config CONFIGFILE
        Specify config file to be used. Defaults to $HOME/.sympaadmin.ini.
        See the "FILES" section in the manpage for more info on what this
        file should contain.

Arguments:
    help
        Show full help.

    add ADDRESS LISTADDRESS
    add (ADDRESS+) LISTADDRESS
    add ADDRESS (LISTADDRESS+)
    add (ADDRESS+) (LISTADDRESS+)
        Add the e-mail address ADDRESS to the sympa list LISTADDRESS.
        Multiple addresses and lists can be specified if the list is either
        enclosed in "( )" and sparated with " ", or just separated with ",".

    remove ADDRESS LISTADDRESS
    remove (ADDRESS+) LISTADDRESS
    remove ADDRESS (LISTADDRESS+)
    remove (ADDRESS+) (LISTADDRESS+)
        Remove the e-mail address ADDRESS from the sympa list LISTADDRESS.
        Multiple addresses and lists can be specified if the list is either
        enclosed in "( )" and sparated with " ", or just separated with ",".

    list all
        List all the sympa list you are associated with.

    list admin
        List all the lists you have administrator rights to.

    list memberships
        List all the lists you are a member of.

    list members LISTADDRESS
        List all members of the sympa list LISTADDRESS.

    moderate
        Starts interactive moderation of all the lists you have
        administrator rights to.

Se `man sympaadmin` for mer utfyllende info.
 

Se medlemskap og eierrettigheter

Med argumenter

% sympaadmin list all

Pipe-input

Sympaadmin-shell
sympaadmin >list all

Modere meldinger

Med argumenter

$ sympaadmin moderate

Pipe-input

Sympaadmin-shell

Modere abonnementsønsker

Med argumenter

$ sympaadmin moderate

Pipe-input

Sympaadmin-shell

Legge til medlemmer

Med argumenter

$ sympaadmin add <ny medlemsadresse> <listeadresse>

Pipe-input

Sympaadmin-shell

Fjerne medlemmer

Med argumenter

$ sympaadmin remove <ny medlemsadresse> <listeadresse>

Pipe-input

Sympaadmin-shell

Installasjon

Sympaadmin er tilgjengelig på linuxmaskiner via pakkebrønnen (repository) uio-extras. På RHEL5-maskiner kjører man som root kommandoen:

$ yum install sympaadmin


Sympaadmin benytter seg av /usr/bin/perl og trenger følgende perl-moduler, alle tilgjengelig via RHN/EPEL:

  • SOAP::Lite
  • HTTP::Cookies
  • Data::Dumper
  • Getopt::Long
  • Term::ReadKey
  • Term::ReadLine
  • Text::Abbrev
  • Term::ReadLine::Gnu
  • Pod::Usage

Disse skal normalt bli installert automatisk, om ikke sjekk at yum er satt opp til å bruke RHN/EPEL.

UiO-Windowsmaskin

Login.uio.no har allerede Sympaadmin-programmet installert, men før du bruker Sympaadmin første gang må du opprette en konfigurasjonsfil. Det kan f.eks. gjøres ved å skrive inn kommandoen under:

        cat > .sympaadmin.ini << EOF

Trykk enter/linjeskift til slutt og legg merke til at det er et punktum før "sympaadmin".

Deretter skriver du inn innholdet du vil ha i konfigurasjonsfilen. Husk å sette inn din egen e-postadresse og trykk enter/linjeskift på slutten av hver linje:

        soapuser = fornavn.etternavn@domene.uio.no
        soapserver = https://sympa.uio.no/uio.no-sympasoap

Skriv f.eks. "sympaadmin" og trykk enter for å starte programmet.

Mangler i Sympaadmin

  • Sympaadmin er ikke skrevet slik at du kan lagre passordet ditt i konfigurasjonsfilen. Siden de aller aller fleste vil benytte sitt UiO-brukernavn og tilhørende passord for innlogging så er det svært uheldig om denne lagres i klartekst.
  • Du kan ikke sette opp default moderasjonshandling basert på moderasjonsgrunn.
    Sympas soapserver kan ikke hente ut moderasjonsgrunnen.

 

Publisert 2. mai 2010 03:34 - Sist endret 25. nov. 2021 09:03
Del på e-post