Security Conscious,
High Availability Unix Hosting
Kommandoer-linje csoftadm

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.

  1. Plasser sertifikatet ditt i ~/ssl/cert.
  2. Plasser nøkkelen din i ~/ssl/key.
  3. Skriv en passord-frase i ~/ssl/pp (hvis ønskelig).
  4. 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

  End Software Patents!