Csoftadm
Denne miniguiden er skrevet for de av våre kunder som ser med skrekk og
gru på det å lese manualer. Inkludert er eksempler på grunnleggende
kommandoer for å sette opp e-post aliaser, lage postbokser og CVS kontoer,
konfigurere domenenavn, lage databaser og endre kontoinnstillinger ved
hjelp av csoftadm's shell grensesnitt.
Csoftadm's kommando-linje grensesnitt
Det er ikke nødvendig å huske kommandoenes fulle syntaks når man
bruker csoftadm interaktivt. Hvis et parameter er utelatt, vil
csoftadm be om dette (med standardverdi i klammer).
Gjennom denne guiden vil kursiv betegne tekst skrevet inn av
brukeren.
Siden csoftadm implementerer kontekstsensitiv kommando-linje
fullførelse, vil den forsøke å fullføre kommandoen du har begynt å
skrive om du trykker <TAB> (hvis det er flere mulige fullførelser
vil disse bli listet opp).
csoftadm> kommando
spørsmål? standardverdi bruker input
Oppstart av programmet
Logg inn på din tildelte csoft.net konto (dette er forklart i
dokumentasjonen),
skriv så "csoftadm" i shellet.
$ csoftadm
For å lese onlinehjelpen, bruk "help" kommandoen, som kan etterfølges av
navnet på en kommando.
csoftadm> help
csoftadm> help dns
csoftadm> help mail
csoftadm> help mail alias
csoftadm> help mail mbox
csoftadm> help db
csoftadm> help conf
E-post Aliaser
Mail alias kommandoene tillater å koble én eller flere
mottakere til en e-post adresse. Mulige mottakere kan være
en postboks, en ekstern e-post adresse,
en fil på serveren, et program (f.eks. et filter) som kjøres på serveren,
eller "ruleset".
|
1.1.
Tilføyning av ny e-post adresse |
|
Videresend all post som er adressert til bruker@mitt-domene
til bruker@hans-domene:
csoftadm> mail alias add
E-mail address? bruker@mitt-domene
New recipient #1? [done] bruker@hans-domene
Added recipient `bruker@hans-domene' to alias `bruker@mitt-domene'.
Videresend post fra ola@mitt-domene til en tidligere opprettet
ola postboks -
csoftadm> mail mbox add ola
csoftadm> mail alias add ola@mitt-domene ola
Anta at du vil ha e-post til arkiv@mitt-domene omdirigert
til en fil kalt ./Mail/mitt-arkiv i roten av ditt hjemmeområde -
csoftadm> mail alias add arkiv@mitt-domene ./Mail/mitt-arkiv
Hvis du vil omdirigere e-post til sitat@mitt-domene til et
program kalt sitat i bin-mappen under hjemmeområdet -
csoftadm> mail alias add sitat@mitt-domene |./bin/sitat
Note:
Bruk denne funksjonaliteten med forsiktighet; tenk på mulige
oversvømmelser av meldinger som kan forårsakes av spam eller
bevisste angrep for å overbelaste serveren.
If you want to process a large amount of mail, please
contact us about setting up a persistent LMTP server for this purpose.
We can combine the previous examples with conditionals to perform
classification of messages based on specific criteria.
In the following example, we use the "spam" conditional which allows us
to take decisions based on the results of a
SpamAssassin
test.
Groups of such instructions are referred to
as "rulesets". For convenience, rulesets can be configured independently
of e-mail addresses.
csoftadm> mail rule add user@my-domain spam<=5.0 ./Mail/Mailbox.non-spam
csoftadm> mail rule add user@my-domain spam>=5.0 ./Mail/Mailbox.spam
csoftadm> mail rule add &myruleset spam<=5.0 ./Mail/Mailbox.non-spam
csoftadm> mail rule add &myruleset spam>=5.0 ./Mail/Mailbox.spam
csoftadm> mail rule add foo@my-domain &myruleset
csoftadm> mail rule add bar@my-domain &myruleset
|
|
1.2.
Sletting av e-post adresser |
For å slette gammelbruker@mitt-domene aliaset:
csoftadm> mail alias del
Alias to delete? done gammelbruker@mitt-domene
Removed `gammelbruker@mitt-domene' alias.
|
|
1.3.
Vis aliaser |
|
Se listen over aktive aliser -
csoftadm> mail alias list
|
Postboks administrasjon
Denne kommandoen brukes for å opprette ekstra kontoer som er begrenset
til POP-3 og IMAP tjenestene. Etter at en postboks er opprettet er det
viktig å koble den til en e-post
adresse.
|
2.1.
Tilføyning av postbokser |
|
Use mail mbox add to create a new mailbox:
csoftadm> mail mbox add
Name of new mailbox? minpostboks
initial password? passordet
format? (pop3|imap) pop3
Opprett `minpostboks' postboks.
|
|
2.2.
Endring av postboks passord |
|
Endre postbokser passord med mail mbox pass:
csoftadm> mail mbox pass
name of mailbox? minpostboks
new password? passordet
Changed password on «minpostboks» mailbox.
|
|
2.3.
Sletting av postbokser |
|
Slett postboksen ved hjelp av mail mbox del kommandoen:
csoftadm> mail mbox del minpostboks
Vis en liste over alle postboksene som hører til kontoen din med
mail mbox list:
csoftadm> mail mbox list
|
Domener og underdomener
Privilegiet å kunne modifisere DNS data er forbeholdt kunder som har
kjøpt en hosting pakke med en
unik IP adresse
(fra Budget v-host).
Hensikten med DNS funksjonene er å aktivere og konfigurere domener
og underdomener. For at domenene skal kunne aktiveres må du ha
kjøpt dem hos en registrar og satt dem opp til å bruke de riktige
(ns*.csoft.net) DNS serverne.
Endringene gjort i DNS dataene blir ikke synlige med en gang.
Fordi disse endringene spres utover Internet forholdsvis sakte vil det
i de fleste tilfeller ta ca. 4-8 timer før de nye domenedataene
blir tilgjengelig på de fleste DNS servere.
|
3.1.
Tilføyning av domener |
|
Bruk dns add for å sette opp et nytt domene som er eid av deg
og hvor riktige DNS servere er blitt delegert.
For å aktivere sekhmet.net og lage et www underdomene,
bruker du -
csoftadm> dns add
domain/subdomain name? sekhmet.net
destination? 1.2.3.4 (enter))
Created `sekhmet.net' host.
csoftadm> dns add www.sekhmet.net @
Created `www.sekhmet.net' host.
Å godta standardverdien vil la domenet peke til din vhost IP
(i dette eksempelet 1.2.3.4).
Derfor ville sekhmet.net peke til ~/www/sekhmet.net
mappen. og en symbolsk lenke ~/www/www.sekhmet.net
ville være et alias for denne mappen.
Alternativt kan en eksplisitt IP adresse spesifiseres som domenets
destinasjon. I dette tilfellet vil trektothecave.com bli satt
til å peke på en IP som ligger utenfor csoft.net, med et www
underdomene som et alias -
csoftadm> dns add trektothecave.com 10.0.0.1
csoftadm> dns add www.trektothecave.com @
Underdomener blir konfigurert på en lignende måte; de kan ta en IP
adresse som destinasjon, eller tegnet @ (som betyr
forelderdomenet).
Hvis destinasjonen er en adresse lokal til serveren (eller det er "@"
og forelderdomenet er lokalt til serveren) blir det laget en mappe
i ~/www (bortsett fra "www" underdomener som i stedet får en
symbolsk lenke).
Det er også mulig å fjerne og lage symbolske lenker og mapper
i ~/www manuelt ved hjelp av
ln(1) og
mkdir(1)
i shellet.
Aktiver et underdomene, nakht.sekhmet.net, ved hjelp av
dns add. Hvis sekhmet.net peker til en (for serveren)
lokal adresse, blir en mappe laget i ~/www/nakht.sekhmet.net.
csoftadm> dns add nakht.sekhmet.net @
Lag et nytt underdomene kalt nebt.sekhmet.net og sett det til å
peke mot IP adressen 10.0.0.2 -
csoftadm> dns add nebt.sekhmet.net 10.0.0.2
|
|
3.2.
Sletting av domener |
|
Fjern sekhmet.net fra DNS ved hjelp av dns del -
csoftadm> dns del sekhmet.net
Removed `sekhmet.net' host.
|
|
3.3.
Administrasjon av e-post servere (MX) |
|
DNS dataene for et domene kan justeres for å bruke en annen e-post
server enn den domenet først blir tildelt. Hver MX oppføring har
en prioritet. Den som har lavest prioritet blir prøvd først når
e-post skal leveres. Nye MX servere legges til med dns mx add.
For å sette mail.nekhbet.com som e-post server for
sekhmet.com, bruk kommandoen dns mx add -
csoftadm> dns mx add
Domain/subdomain name? sekhmet.net
Mail server hostname? mail23.csoft.net mail.nekhbet.com
Added MX `mail.nekhbet.com' to host `sekhmet.net'.
Sletting av MX oppføringen -
csoftadm> dns mx del sekhmet.net mail.nekhbet.com
|
|
3.4.
Administrasjon av navnetjenere (NS) |
|
DNS oppføringene for et domene kan justeres for å bruke andre navnetjenere
enn de som først ble tildelt domenet.
I utgangspunktet er minst to NS oppføringer tildelt per domene
(primær og sekundær DNS for serveren).
I motsetning til MX har ikke NS oppføringer prioritet.
For å tildele sekhmet.com en NS oppføring for
ns.kheperw.com, bruk kommandoen dns ns add -
csoftadm> dns ns add sekhmet.com ns.kheperw.com
Fjern NS oppføringen med dns ns del -
csoftadm> dns ns del sekhmet.net ns.kheperw.com
|
|
3.5.
Administrasjon av SOA (Start Of Authority) |
|
E-post adressen gitt i en SOA oppføring for domenet kan endres
med kommandoen dns soa -
csoftadm> dns soa sekhmet.net admin@sekmnet.net
|
|
3.6.
Opplisting av domenenavn |
|
List opp alle domenenavn (untatt underdomener) som er konfigurert,
med dns list. For å liste underdomener, SOA, MX og NS oppføringer
i tillegg, bruk dns zone -
csoftadm> dns list
trektothecave.com
vedge.org
* IPv4 address: 1.2.3.4
* IPv4 reverse DNS: vedge.org
csoftadm> dns zone trek
trektothecave.com {
@ soa ns261.csoft.net. vedge.trektothecave.com.
@ ns ns261.csoft.net.
@ ns ns128.csoft.net.
@ a 1.2.3.4
@ mx 10 mail231.csoft.net.
www cname @
}
* IPv4 address: 1.2.3.4
* IPv4 reverse DNS: vedge.org
Note that most csoftadm "list" commands accept one or more arguments
that correspond to search strings (exact vs substring matching is
configurable with pref set exact-match).
csoftadm> dns list pattern1 pattern2
csoftadm> dns zone mydomain
|
Database administrasjon
Denne seksjonen av csoftadm brukes for å lage databaser,
tildele dem én eller flere brukere, gi/oppheve rettigheter og
tilbakestille passordene deres.
|
4.1.
Opprettelse av MySQL databaser |
|
Kommandoen db mysql add brukes for å lage en MySQL database.
It does not create MySQL users by default, so you will have to grant
privileges to one or more users later on with db mysql grant.
csoftadm> db mysql add
databasenavn? minedatabase
Opprett database `minedatabaser'.
|
|
4.2.
Sletting av databaser |
|
Slett databaser med kommandoen db mysql del.
csoftadm> db mysql del mydatabase
|
|
4.3.
Opplisting av databaser |
|
Vis en liste over alle aktive databaser tilhørende din konto,
inkludert deres brukere, med db mysql list.
Alternatively, you can get a listing of your MySQL users and their
privileges with db mysql userlist.
csoftadm> db mysql list
0. mydatabase {
alice@localhost(SELECT,INSERT,UPDATE)
bob@foo.domain.ext(SELECT)
}
1. myotherdatabase {
alice@localhost(SELECT,INSERT,LOCK_TABLES,CREATE_VIEW)
bob@foo.domain.ext(SELECT,SHOW_VIEW)
}
csoftadm> db mysql userlist
0. alice@localhost {
mydatabase: SELECT,INSERT,UPDATE
myotherdatabase: SELECT,INSERT,LOCK_TABLES,CREATE_VIEW
}
1. bob@foo.domain.ext {
mydatabase: SELECT
myotherdatabase: SELECT,SHOW_VIEW
}
|
|
4.4.
Managing MySQL users |
|
New MySQL users are created with the db mysql useradd command,
and they are removed with db mysql userdel. When adding a user,
you are asked for a hostname argument which limits connections from
the given host (it is usually set to the default value of "localhost"
unless direct remote access is needed).
csoftadm> db mysql useradd
database user name? myuser
allow access from host? localhost (enter)
password for myuser? secret
password for myuser? (again) secret
Created database user myuser@localhost.
csoftadm> db mysql userdel myuser
Deleted database user myuser.
|
|
4.5.
Assigning privileges to MySQL users |
|
Gi en MySQL-bruker minebruker tilgang til minedatabase
databasen fra med rettighetene SELECT og INSERT, ved
hjelp av kommandoen
db mysql grant.
To see all available MySQL privileges on
your server, issue db mysql userprivs.
csoftadm> db mysql grant
database? minedatabase
database user? mineuser
rights to grant? SELECT,INSERT,UPDATE,CREATE,... INSERT,SELECT
Granted INSERT,SELECT rights to myuser user.
|
|
4.6.
Endring av passord for database brukere |
|
Endre passordet for MySQL brukeren med db mysql pass.
csoftadm> db mysql pass mydatabase
nyy passord? passord
Endret passord for bruker mydatabase.
|
Konfigurasjon av server-siden
Med denne delen av csoftadm kan du manipulere forskjellige
innstillinger for kontoen din.
|
5.1.
Visning av konfigurasjonsinnstillinger |
|
Finn ut nøyaktig hvor mye du kan kontrollere ved å studere utskriften
fra conf list kommandoen -
csoftadm> conf list
0. ssl ( no ) Enable SSL with custom certificate.
1. logs ( yes ) Apache access log enabled.
2. errlog ( yes ) Apache error log enabled.
(...)
|
|
5.2.
Endring av konfigurasjonsinnstillinger |
|
Hvilke verdier som godtas avhenger av hvilken innstilling det er
man endrer.
|
|
5.3.
Administrasjon av SSL sertifikater |
|
Inklusjon av sertifikater i SSL httpd (web serveren med kryptering)
styres av ssl innstillingen.
Hvis sertifikat, nøkkel eller passord
filene i ~/ssl er ugyldige vil ikke sertifikatet bli inkludert.
Hvis sertifikatets CN domenenavn ikke passer med ditt hoved-domene,
vil du måtte sette name innstillingen til ditt sertifikats CN.
Se SSL miniguiden.
-
Plasser sertifikatet ditt i ~/ssl/cert.
-
Plasser nøkkelen din i ~/ssl/key.
-
Skriv en passord-frase i ~/ssl/pp (hvis ønskelig).
-
Sett ssl innstillingen til yes.
|
Konfigurasjon av klient-siden
Noen klient-side csoftadm innstillinger kan settes opp i
~/.csoftadmrc.
|
6.1.
Vis klient-side innstillinger |
|
Kommandoen pref show viser klient-side innstillingene.
csoftadm> pref show
conf-descriptions = true
db-default-host = "localhost"
db-default-rights = "SELECT,INSERT,UPDATE,DELETE"
dns-default-mx = "mail23.csoft.net"
dns-default-ns = "ns73.csoft.net"
(...)
|
|
6.2.
Endring av klient-side innstillinger |
|
Kommandoen pref set tar en nøkkel og en verdi som kommando-linje
csoftadm parametere.
# Sette standard domene adresse.
pref set dns-default-a 10.0.0.1
# Program used to display tables.
pref set pager less
|
Administrasjon av CVS kontoer
cvs kommandoene brukes for å administrere en gruppe underkontoer
som er begrenset til cvs(1) tilgang
og må koble til med "ssh" metoden.
|
7.1.
Opprett CVS konto |
|
Bruk cvs add kommandoen for å opprette en CVS konto kalt
mycvsuser -
csoftadm> cvs add
name of new cvs user? mycvsuser
initial password? Vn4561
Created `mycvsuser' cvs user.
|
|
7.2.
Slett CVS konto |
|
Bruk cvs del for å slette mycvsuser -
csoftadm> cvs del mycvsuser
|
|
7.3.
Vis aktive CVS kontoer |
|
Uten parametere viser cvs list alle aktive cvs kontoer -
csoftadm> cvs list
1. anoncvs
2. yvonne
3. mycvsuser
|
|
7.4.
Endring av passord for CVS brukere |
|
Bruk cvs pass kommandoen for å endre passordet på en CVS konto -
csoftadm> cvs pass mycvsuser
new password? Wasabi23
Changed password for the `mycvsuser' cvs user.
|
Administrasjon av offentlige SSH nøkler for CVS brukere
cvs pubkey kommandoene brukes for å administrere et sett offentlige
ssh
nøkler tilhørende CVS kontoer, for å tillate passordløs DSA/RSA
autentisering av CVS brukere.
|
7.5.1.
Opplasting av offentlige SSH nøkler |
|
Klipp og lim innholdet av din offentlige SSH nøkkelfil
(som f.eks. ~/.ssh/id_dsa.pub) til cvs pubkey add -
csoftadm> cvs pubkey add mycvsuser
public key to add? ssh-dss AAAAB3NzaC1kc3MAAACBALhnPcOFZK ...
Successfully added public key for `mycvsuser' user.
|
|
7.5.2.
Vis offentlige SSH nøkler som hører til en CVS bruker |
|
Bruk kommandoen cvs pubkey list for å vise de offentlige nøklene
brukt av mycvsuser -
csoftadm> cvs pubkey list mycvsuser
1. ssh-dss AAAAB3NzaC1kc3MAAACBALhnPcO9aFZKvrtXN/+cE+m ...
1/32 public keys uploaded today.
|
|
7.5.3.
Sletting av offentlige nøkler |
|
For å fjerne en av mycvsuser's offentlige nøkler, bruk -
csoftadm> cvs pubkey del mycvsuser
public key to remove? ssh-dss AAAAB3NzaC1kc3MAAACBALhnPcO9aFZKtXN ...
Successfully removed public key from `mycvsuser' user.
|
Administrasjon av Subversion kontoer
svn kommandoene brukes for å administrere en gruppe underkontoer
som er begrenset til Subversion tilgang
og må koble til med "ssh+svn" metoden.
|
8.1.
Opprett Subversion konto |
|
Bruk svn add kommandoen for å opprette en Subversion konto kalt
mysvnuser -
csoftadm> svn add mysvnuser
initial password? passordet
Created `mysvnuser' svn user.
|
|
8.2.
Slett Subversion konto |
|
Bruk svn del for å slette mysvnuser -
csoftadm> svn del mysvnuser
|
|
8.3.
Vis aktive Subversion kontoer |
|
Uten parametere viser svn list alle aktive Subversion kontoer -
csoftadm> svn list
1. yvonne
2. mysvnuser
|
|
8.4.
Endring av passord for Subversion brukere |
|
Bruk svn pass kommandoen for å endre passordet på en Subversion
konto -
csoftadm> svn pass mysvnuser
new password? mypassword
Changed password for the `mysvnuser' svn user.
|
Administrasjon av offentlige SSH nøkler for Subversion brukere
svn pubkey kommandoene brukes for å administrere et sett offentlige
ssh
nøkler tilhørende Subversion kontoer, for å tillate passordløs DSA/RSA
autentisering av Subversion brukere.
|
8.5.1.
Opplasting av offentlige SSH nøkler |
|
Klipp og lim innholdet av din offentlige SSH nøkkelfil
(som f.eks. ~/.ssh/id_dsa.pub) til svn pubkey add -
csoftadm> svn pubkey add mysvnuser
public key to add? ssh-dss AAAAB3NzaC1kc3MAAACBALhnPcOFZK ...
Successfully added public key for `mysvnuser' user.
|
|
8.5.2.
Vis offentlige SSH nøkler som hører til en Subversion bruker |
|
Bruk kommandoen svn pubkey list for å vise de offentlige nøklene
brukt av mysvnuser -
csoftadm> svn pubkey list mysvnuser
1. ssh-dss AAAAB3NzaC1kc3MAAACBALhnPcO9aFZKvrtXN/+cE+m ...
1/32 public keys uploaded today.
|
|
8.5.3.
Sletting av offentlige nøkler |
|
For å fjerne en av mysvnuser's offentlige nøkler, bruk -
csoftadm> svn pubkey del mysvnuser
public key to remove? ssh-dss AAAAB3NzaC1kc3MAAACBALhnPcO9aFZKtXN ...
Successfully removed public key from `mysvnuser' user.
|
Billing Information
|
9.2.
Display current billing information |
csoftadm> billing info
|
|
9.3.
Displaying the current status |
|
The billing status command displays the current status and service
level of your account.
csoftadm> billing status
Account status: ACTIVE
Service level: standard-vhost
|
|