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