Programvareverkstedet - User contributions [en]

Drift/Intro

2021-11-18T05:22:31Z

Knuta:

{| cellspacing="5" cellpadding="0" style="margin: 0em 0em 1em 0em; border: 1px solid #1DA0E7; background: #B3DDF4; width: 100%"
| '''''Denne siden er trolig litt utdatert'''''
|}

Å være drifter er i praksis det samme som [[Drift/RootpassordReglement|å kjenne rotpassordet]] på PVV. Man slutter å være drifter når man har glemt passordet og ikke gidder å oppsøke noen for å lære det på nytt. Mer er det ikke å si om den saken!

= Å bli drifter =

For å få tilgang til rotpassordet må du skrive under på et passordskjema og bli godkjent av driftskoordinator. Dette er en ganske løs prosess, og krever hovedsaklig bare at du ikke er helt ny og at du ikke har gjort noe veldig dumt i det siste.

Når du så har fått passordet er det første du vil gjøre å legge deg selv til i driftslisten. Det er ingen skikkelig gruppe for drift, men det er et alias som sørger for at folk får mail adressert til drift. Hvis du er heldig har "headhunteren" din lagt deg til, hvis ikke gjør du det selv. co/edit/diff/ci-stegene i eksempelet under er kjernen i RCS-bruk, så hvis du ikke er vant til det fra før vil du bli det fort.

<pre><nowiki>
root@microbel:~$ cd /etc
... altså på microbel, som root
root@microbel:/etc$ <editor> /etc/aliases
... legg til deg selv i listen for drift
root@microbel:/etc$ git diff /etc/aliases
... sjekk at endringene stemmer
root@microbel:/etc$ git add /etc/aliases
root@microbel:/etc$ git commit
... ferdig
</nowiki></pre>

Da er du på driftlisten (drift@pvv) og får kose deg med spennende epost om alt mellom himmel og jord. Det er et par andre lister som du bør vite om: os-drift (alt mulig rart av automatiske rapporter fra maskinene), mail-drift (samlepunkt for postmaster og andre standardadresserer), pvv (styret) og cert (som heller ikke er drift). De to første har du sannsynligvis ikke lyst til å være på, og de to siste skal man velges til.

= Kjekt å vite =

Drifting er mye det samme om man har sin egen maskin eller om man drifter maskiner for andre, bortsett fra at det siste tilfellet gjerne tryller frem flere problemer og større konsekvenser.

For øyeblikket er PVV inne i en debian/ubuntu-fase. De fleste nye maskinene kjører en av disse, deriblant microbel (nfs og mail), tvilling (også www) og horisont (login og *sql). Mye av den underliggende infrastrukturen kjører på gamle maskiner, og disse har gjerne BSD eller Solaris. Der finner vi dvask (dns), brutus (dns, dhcp), malina (yp) og brutus (yp) med flere. Det er godt mulig det har skjedd endringer siden dette ble skrevet, så sjekk siden [[Maskiner]] for litt mer pålitelig informasjon.
* Generelt brukes RCS for å versjonere og sikre konfigurasjonsfiler av alle typer.
* Ting som skal kopieres til mange (eller alle) maskiner håndteres for øyeblikket av rdist, men her er det planlagt endringer.
* Vi har både yp og kerberos, men kdcen er ennå ikke tatt særlig i bruk.
* Til printing brukes cups
* Mail håndteres av exim og dovecot

Hvis du leter etter konfigurasjonsfiler, se i /etc/. Hvis du vil ha logger, sjekk /var/log/, og husk på at de fleste loggene krever at du er logget inn som root.

Skal du oppdatere noe i DNS må du inn på dvask. dvask er en veldig gammel og skrøpelig maskin. Det går an å logge inn via ssh, men da må du belage deg på et par minutter ventetid. Det er også mulig å logge inn via seriellkonsoll på octopus. Noe raskere, men har sine egne problemer.

Hvis microbel får problemer går det meste av PVV ned (microbel er diskserver). Dette fører gjerne til at folk sender mail til drift om at ting ikke virker. microbel er også mailserver, så mailen kommer typisk ikke fram før problemet er løst.

Serverrommet har lås på døra. Det er eget skjema for folk som vil ha nøkkel, men på dagtid er det som regel lett å få tak i noen med nøkkel hvis rommet ikke allerede er åpent.

PVV har som oftest mye ledig hardware. Det meste er arvet fra NTNU eller lokale firmaer. Ikke det siste og beste, men duger bra til vår bruk. Hvis du har lyst til å sette opp en ny boks er det stort sett snakk om å gjøre det. Hvis du setter opp en sært OS er det fare for at ingen andre vil ta i det, så da bør du belage deg på å håndtere oppdateringer og sikkerthet på egenhånd. Nye tjenester kan noen ganger settes opp på bokser som allerede er i bruk, hvis du ikke føler for å sette opp en ny fra bunnen av.

Sist men ikke minst, ikke vær redd for å spørre. Det er mange som ikke lenger har tid til å være fysisk på PVV, men som følger med på epost, IRC eller news og kan svare på spørsmål og gi råd om nye prosjekter.

__NOTOC__

Drift/Intro

2021-11-18T05:21:29Z

Knuta:

{| cellspacing="5" cellpadding="0" style="margin: 0em 0em 1em 0em; border: 1px solid #1DA0E7; background: #B3DDF4; width: 100%"
| '''''Denne siden er trolig litt utdatert'''''
|}

Å være drifter er i praksis det samme som [[Drift/RootpassordReglement|å kjenne rotpassordet]] på PVV. Man slutter å være drifter når man har glemt passordet og ikke gidder å oppsøke noen for å lære det på nytt. Mer er det ikke å si om den saken!

= Å bli drifter =

For å få tilgang til rotpassordet må du skrive under på et passordskjema og bli godkjent av driftskoordinator. Dette er en ganske løs prosess, og krever hovedsaklig bare at du ikke er helt ny og at du ikke har gjort noe veldig dumt i det siste.

Når du så har fått passordet er det første du vil gjøre å legge deg selv til i driftslisten. Det er ingen skikkelig gruppe for drift, men det er et alias som sørger for at folk får mail adressert til drift. Hvis du er heldig har "headhunteren" din lagt deg til, hvis ikke gjør du det selv. co/edit/diff/ci-stegene i eksempelet under er kjernen i RCS-bruk, så hvis du ikke er vant til det fra før vil du bli det fort.

<pre><nowiki>{
root@microbel:~$ cd /etc
... altså på microbel, som root
root@microbel:~$ <editor> /etc/aliases
... legg til deg selv i listen for drift
root@microbel:~$ git diff /etc/aliases
... sjekk at endringene stemmer
root@microbel:~$ git add /etc/aliases
root@microbel:~$ git commit
... ferdig
</nowiki></pre>}

Da er du på driftlisten (drift@pvv) og får kose deg med spennende epost om alt mellom himmel og jord. Det er et par andre lister som du bør vite om: os-drift (alt mulig rart av automatiske rapporter fra maskinene), mail-drift (samlepunkt for postmaster og andre standardadresserer), pvv (styret) og cert (som heller ikke er drift). De to første har du sannsynligvis ikke lyst til å være på, og de to siste skal man velges til.

= Kjekt å vite =

Drifting er mye det samme om man har sin egen maskin eller om man drifter maskiner for andre, bortsett fra at det siste tilfellet gjerne tryller frem flere problemer og større konsekvenser.

For øyeblikket er PVV inne i en debian/ubuntu-fase. De fleste nye maskinene kjører en av disse, deriblant microbel (nfs og mail), tvilling (også www) og horisont (login og *sql). Mye av den underliggende infrastrukturen kjører på gamle maskiner, og disse har gjerne BSD eller Solaris. Der finner vi dvask (dns), brutus (dns, dhcp), malina (yp) og brutus (yp) med flere. Det er godt mulig det har skjedd endringer siden dette ble skrevet, så sjekk siden [[Maskiner]] for litt mer pålitelig informasjon.
* Generelt brukes RCS for å versjonere og sikre konfigurasjonsfiler av alle typer.
* Ting som skal kopieres til mange (eller alle) maskiner håndteres for øyeblikket av rdist, men her er det planlagt endringer.
* Vi har både yp og kerberos, men kdcen er ennå ikke tatt særlig i bruk.
* Til printing brukes cups
* Mail håndteres av exim og dovecot

Hvis du leter etter konfigurasjonsfiler, se i /etc/. Hvis du vil ha logger, sjekk /var/log/, og husk på at de fleste loggene krever at du er logget inn som root.

Skal du oppdatere noe i DNS må du inn på dvask. dvask er en veldig gammel og skrøpelig maskin. Det går an å logge inn via ssh, men da må du belage deg på et par minutter ventetid. Det er også mulig å logge inn via seriellkonsoll på octopus. Noe raskere, men har sine egne problemer.

Hvis microbel får problemer går det meste av PVV ned (microbel er diskserver). Dette fører gjerne til at folk sender mail til drift om at ting ikke virker. microbel er også mailserver, så mailen kommer typisk ikke fram før problemet er løst.

Serverrommet har lås på døra. Det er eget skjema for folk som vil ha nøkkel, men på dagtid er det som regel lett å få tak i noen med nøkkel hvis rommet ikke allerede er åpent.

PVV har som oftest mye ledig hardware. Det meste er arvet fra NTNU eller lokale firmaer. Ikke det siste og beste, men duger bra til vår bruk. Hvis du har lyst til å sette opp en ny boks er det stort sett snakk om å gjøre det. Hvis du setter opp en sært OS er det fare for at ingen andre vil ta i det, så da bør du belage deg på å håndtere oppdateringer og sikkerthet på egenhånd. Nye tjenester kan noen ganger settes opp på bokser som allerede er i bruk, hvis du ikke føler for å sette opp en ny fra bunnen av.

Sist men ikke minst, ikke vær redd for å spørre. Det er mange som ikke lenger har tid til å være fysisk på PVV, men som følger med på epost, IRC eller news og kan svare på spørsmål og gi råd om nye prosjekter.

__NOTOC__

Tjenester/Databaser

2020-07-06T05:53:53Z

Knuta: /* MySQL */

[[Databases|English]]

PVV har for tiden to database-tjenester, MySQL og PostgreSQL.

== MySQL ==

Følg instruksjonen på https://innsida.ntnu.no/wiki/-/wiki/Norsk/Bruke+MySQL+ved+NTNU - bare bytt ut "mysql.stud.ntnu.no" med "mysql.pvv.ntnu.no".

Linkene endrer seg ofte, se [https://web.archive.org/web/20090505174858/http://infoweb.ntnu.no/utvikling+og+programmering/database/mysql.html http://infoweb.ntnu.no/utvikling+og+programmering/database/mysql.html] om ovennevnte link ikke virker.

== PostgreSQL ==

Du finner PostgreSQL-serveren på postgres.pvv.ntnu.no. Se [[PostgreSQL]]-siden for mer informasjon.

= Databases =

PVV at the moment has two database services, MySQL and PostgreSQL

== MySQL ==

Follow the instructions at http://infoweb.ntnu.no/utvikling+og+programmering/database/mysql.html - just swap "mysql.stud.ntnu.no" with "mysql.pvv.ntnu.no".

The link above seems to be dead. Equivalent information can be found here: http://itgk.idi.ntnu.no/notater/mysqlopprettebruker.php and here: http://itgk.idi.ntnu.no/notater/mysqltutorial.php

== PostgreSQL ==

The PostgreSQL server can be found at postgres.pvv.ntnu.no. See the [[PostgreSQL]] page for more information.

__NOTOC__

Tjenester/Databaser

2020-07-05T07:32:25Z

Knuta: /* MySQL */

[[Databases|English]]

PVV har for tiden to database-tjenester, MySQL og PostgreSQL.

== MySQL ==

Følg instruksjonen på [https://web.archive.org/web/20090505174858/http://infoweb.ntnu.no/utvikling+og+programmering/database/mysql.html http://infoweb.ntnu.no/utvikling+og+programmering/database/mysql.html] - bare bytt ut "mysql.stud.ntnu.no" med "mysql.pvv.ntnu.no".

== PostgreSQL ==

Du finner PostgreSQL-serveren på postgres.pvv.ntnu.no. Se [[PostgreSQL]]-siden for mer informasjon.

= Databases =

PVV at the moment has two database services, MySQL and PostgreSQL

== MySQL ==

Follow the instructions at http://infoweb.ntnu.no/utvikling+og+programmering/database/mysql.html - just swap "mysql.stud.ntnu.no" with "mysql.pvv.ntnu.no".

The link above seems to be dead. Equivalent information can be found here: http://itgk.idi.ntnu.no/notater/mysqlopprettebruker.php and here: http://itgk.idi.ntnu.no/notater/mysqltutorial.php

== PostgreSQL ==

The PostgreSQL server can be found at postgres.pvv.ntnu.no. See the [[PostgreSQL]] page for more information.

__NOTOC__

Drift/Kerberos

2020-06-07T07:52:39Z

Knuta: /* Installasjon av KDC (Kerberos-server) */

== Feilsøking ==

Om kerberos slutter å virke på en maskin, prøv å logge inn på den med SSH-nøkler og kjøre kinit. kinit vil muligens gi en feilmelding som går an å forstå. Eksempel:

<pre>
knuta@skrott:~$ kinit
knuta@PVV.NTNU.NO's Password:
kinit: krb5_get_init_creds: Too large time skew
</pre>

== Nye kerberos-klienter ==

Logg inn på maskinen.

installer heimdal:
<pre><nowiki>
berners-lee:~# apt install heimdal-clients libpam-krb5
</nowiki></pre>

Last ned keytab (den blir generert automatisk)
<pre><nowiki>
berners-lee:~# ktutil get -p knuta/admin host/berners-lee.pvv.ntnu.no
</nowiki></pre>

'''Som regel er du ferdig når du har kommet hit. Nyere Debian og Ubuntu setter selv om pam om du installerer libpam-krb5. I så fall trenger du ikke tenke på det nedenfor.'''

Konfigurer pam. Oppsettet kan for eksempel se slik ut på en debian-maskin:
/etc/pam.d/common-account:<pre><nowiki>
account required pam_krb5.so minimum_uid=1000
account required pam_unix.so
</nowiki></pre>

/etc/pam.d/common-auth:<pre><nowiki>
auth sufficient pam_krb5.so minimum_uid=1000
auth required pam_unix.so nullok_secure
</nowiki></pre>

/etc/pam.d/common-password:<pre><nowiki>
password sufficient pam_krb5.so minimum_uid=1000
password required pam_unix.so nullok obscure md5
</nowiki></pre>

/etc/pam.d/common-session:<pre><nowiki>
session optional pam_krb5.so minimum_uid=1000
session required pam_unix.so
</nowiki></pre>

== Installasjon av KDC (Kerberos-server) ==

'''MERK: En KDC er en Kerberos-server. Dette kapittelet har altså ikke noe med de øvrige maskinene å gjøre'''

Rediger /etc/hosts så public-ipen (f.eks. 129.241.210.168) peker på hostnavnet til kdc, ellers virker det ikke.

Installer heimdal-clients og heimdal-kdc
<pre><nowiki>
aptitude install heimdal-clients heimdal-kdc
</nowiki></pre>

Lag symlink (på grunn av en bug i heimdal-kdc): <pre><nowiki>
ln -s /etc/heimdal-kdc/kadmind.acl /var/lib/heimdal-kdc/
</nowiki></pre>

Rediger /etc/heimdal-kdc/kdc.conf og sett følgende opsjoner: <pre><nowiki>
[password_quality]
min_length = 8

[kadmin]
default_keys = aes256-cts-hmac-sha1-96:pw-salt aes128-cts-hmac-sha1-96:pw-salt des3-cbc-sha1:pw-salt arcfour-hmac-md5:pw-salt
</nowiki></pre>

Logg inn lokalt (siden det ikke finnes noen adminbrukere enda)
<pre><nowiki>
asgard:~# kadmin -l
kadmin> init PVV.NTNU.NO
Realm max ticket life [unlimited]:
Realm max renewable ticket life [unlimited]:
</nowiki></pre>

Juster default-innstillingene litt
<pre><nowiki>
kadmin> modify -a -disallow-all-tix,requires-pre-auth default
kadmin> get default
Principal: default@PVV.NTNU.NO
Principal expires: never
Password expires: never
Last password change: 2009-06-16 18:16:07 UTC
Max ticket life: 1 day
Max renewable life: 1 week
Kvno: 1
Mkvno: 0
Last successful login: never
Last failed login: never
Failed login count: 0
Last modified: 2009-06-16 18:18:43 UTC
Modifier: kadmin/admin@PVV.NTNU.NO
Attributes: requires-pre-auth
Keytypes: aes256-cts-hmac-sha1-96(pw-salt), aes128-cts-hmac-sha1-96(pw-salt), des3-cbc-sha1(pw-salt), arcfour-hmac-md5(pw-salt)
PK-INIT ACL:
Aliases:
</nowiki></pre>

Lag deg en admin-principal (se eget kapittel)

==Lage admin-principal==

Logg inn som root på asgard (via SSH fra lommel).

<pre><nowiki>
asgard:~# kadmin -l
kadmin> add knuta/admin
Max ticket life [1 day]:
Max renewable life [1 week]:
Principal expiration time [never]:
Password expiration time [never]:
Attributes [requires-pre-auth]:
knuta/admin@PVV.NTNU.NO's Password:
Verifying - knuta/admin@PVV.NTNU.NO's Password:
</nowiki></pre>

Rediger /etc/heimdal-kdc/kadmind.acl og legg til følgende:<pre><nowiki>
knuta/admin all
</nowiki></pre>

Maskiner/Microbel

2018-01-27T23:19:39Z

Knuta: /* Remote-konsoll */

== Historikk ==

Det ligger en backup av decibel (den gamle filserveren) i /var/backups/decibel/. Den inkluderer naturlig nok ikke /home. Denne backupen kan brukes til å gjenfinne gammel konfig eller sjekke gamle logger.

== Disksystem ==

=== Kontroller ===

Maskinen har to kontrolleren, en SAS-kontroller og en SATA-kontroller. Diskene står i SAS-kontrolleren, basert på antakelsen om at den sikkert er bedre. Den er flashet med en alternativ firmware som gjør at den kan bootes fra uten å kjøre software-raid-varianten til kontrolleren (den alternative firmwaren er lastet ned fra supermicro).

Det er mulig å koble et bakplan på SAS-kontrolleren om man skaffer en overgang. Vi har hverken overgang eller bakplan, så det har ikke vi gjort. Skal man koble mer enn 8 disker på kontrolleren noen gang kan man sikkert gjerne skaffe noe sånt.

=== Partisjonering ===

Siden diskene er hårfint over 2GB bestemte partman seg for å bruke GPT i steden for DOS-partisjonering. Jeg aner ikke hvordan man endrer på sånt etter installasjon.

For at grub2 skal virke sammen med GPT må hver disk ha en magisk grub-partisjon i starten, siden det ikke er plass ved MBR når man bruker GPT. Denne er på 10MB, noe som trolig er overkill.

Ellers er topologien omtrent slik:

# 10MB grub-ting
# 490MB /boot i raid1
# ca. 2TB lvm-volum (vg0) i raid5:
## 10 GB / (vg0-root)
## 30 GB /var (vg0-var)
## 6.8 TB /export/home/pvv (vg0-homepvv)
## ca. 200GB ubrukt, kan brukes til å korrigere eventuell blingsing
# ca. 48GB swap i raid1

== Remote-konsoll ==

=== Koble til ===
For å koble til remote-konsoll (krever Java Web Start), gjør følgende:

Først sørger du for at du er på 192.168.215.0/24-nettet. Om du ikke er på en PVV-maskin med rett IP kan du bruke sshuttle for å lage fattigmanns-VPN:

sshuttle -r lommel.pvv.ntnu.no 192.168.215.0/24

Hvis du er på en maskin på 192.168.215.0/24-nettet:

* Åpne https://microbel-mgmt.pvv.ntnu.no/

Brukernavn er root, passord er rootpassordet. Husk å la være å lagre passordet i browseren.

==== Hvis du ikke er på en maskin på 192.168.215.0/24-nettet og ikke kan bruke sshuttle ====

* SSH til lommel eller en annen maskin på det nettet, og forward alle de relevante portene (krever root)
** ssh -L localhost:5900:microbel-mgmt:5900 -L localhost:5901:microbel-mgmt:5901 -L localhost:443:microbel-mgmt:443 -L localhost:80:microbel-mgmt:80 root@cthulhu.pvv.ntnu.no
* Åpne https://localhost/

=== Bytte passordet ===
Det er fort gjort å glemme å bytte passordet. Det er mulig å bytte passordet fra lokalt på microbel ved hjelp av ipmitool.

Sørg for at ipmi-modulene er lastet

modprobe ipmi_devintf
modprobe ipmi_si

List brukerene:

microbel ~ # ipmitool user list 1
ID Name Callin Link Auth IPMI Msg Channel Priv Limit
2 ADMIN false false true ADMINISTRATOR
3 root true true true ADMINISTRATOR

Bytt passordet (passordprompten kommer to ganger):

microbel ~ # ipmitool user set password 3
Password for user 3:
Password for user 3:

=== Bruke Java-konsollet ===

IPMIView (verktøyet til Supermicro) ser ikke ut til å fungere lenger, så vi er prisgitt java-greia i webinterfacet. Denne fungerer heller dårlig med openjdk 8 på grunn av det selvsignerte sertifikaet. Det letteste er å installere oracle-java7. Deretter kan du åpne .jnlp-filen konsollknappen gir deg med javaws, og du får et flott konsoll. Du kan finne rett versjon av java7 ved å google etter jdk-7u80-linux-x64.tar.gz (pass på å velge en kredibel kilde å laste ned fra, oracle lar ikke meningmann laste ned så gammel java lenger).

Maskiner/Microbel

2018-01-27T08:15:14Z

Knuta: /* Remote-konsoll */

Drift/Salt

2016-08-06T17:57:44Z

Knuta: /* Tekniske ting */

Salt er et system for å distribuere filer og sørge for at maskiner har samme oppsett. Etter at vi satte opp versjonskontroll via git lokalt på lommel er det nødvenidg å gå gjennom oppsettet beskrevet i [[Drift/Salt#Gjøre endringer|Gjøre endringer]]-avsnittet før man kan bidra til å endre salt-oppsettet til PVV.

== Sette opp ny salt minion ==

=== Installasjon ===
<pre>
ny-minion# wget -O - https://www.pvv.ntnu.no/salt/salt-setup.sh | bash
ny-minion# rediger /etc/salt/grains og legg til gruppene maskinen er i, se dokumentasjonen for [[Drift/Salt#Grains|grains (grupper)]]
ny-minion# service salt-minion restart
ny-minion$# ssh root@salt.pvv.ntnu.no
salt-master$ sudo salt-key -L
salt-master$ sudo salt-key -a ny-minion.pvv.ntnu.no
ny-minion# salt-call saltutil.sync_grains
ny-minion# salt-call state.highstate saltenv=base pillarenv=base
</pre>

Hvis alt har har gått bra, vil pingtesten gi true for maskinen din nå. Hvis ikke, kjør <code><nowiki>service salt-minion status</nowiki></code> som root på din nye minion for å få hint om hva som er galt. Konfigurasjonsfilen til salt ligger i <code><nowiki>/etc/salt/minion</nowiki></code>.

I tilfellet man endrer hostname på en minion, gjør følgende for å få det oppdatert i salt: Stop salt-minion på den berørte maskinen. Slett nøkkelen til maskinen fra salt-master ved å kjøre <code><nowiki>salt-key -d minion_id</nowiki></code> på salt-masteren. Slett <code><nowiki>/etc/salt/minion/minion_id</nowiki></code>. Start salt-minion service-en. Autoriser den nye nøkkelen med det nye navnet i salt-master.

Husk å legge nyoppsatte maskiner til i riktige [[Drift/Salt#Grains|grains (grupper)]].

== Gjøre endringer ==

Endringer gjøres på salt-masteren (salt.pvv.ntnu.no, som for tiden peker på lommel.pvv.ntnu.no). Alle endringer gjøres som din personlige bruker.

=== Opprette bruker på salt-masteren ===
Om du ikke har en bruker, logg inn som root på serveren og lag en. Adduser vil spørre deg om «Current Kerberos password», men du kan bare trykke enter og si nei til å prøve igjen, så fungerer det fint. Legg også brukeren til i sudo-gruppen.

<pre>
lommel ~ # adduser johndoe && adduser johndoe sudo
Adding user `johndoe' ...
Adding new group `johndoe' (1000) ...
Adding new user `johndoe' (1000) with group `johndoe' ...
Current Kerberos password:
Current Kerberos password:
passwd: Authentication token manipulation error
passwd: password unchanged
Try again? [y/N] n
Changing the user information for johndoe
Enter the new value, or press ENTER for the default
Full Name []: John Doe
Room Number []:
Work Phone []:
Home Phone []:
Other []:
Is the information correct? [Y/n]
</pre>

Passordet du bruker vil være det samme som admin-principalen din i Kerberos har, altså johndoe/admin i eksempelet over. Om du ikke har en admin-principal, se [[Drift/Kerberos#Lage_admin-principal]].

=== Gjøre endringer ===

Når du logger inn første gang vil du automatisk få sjekket ut salt-treet i ~/salt. Gjør endringene dine der inne, og push master til origin for å aktivere endringene.

Det kan være lurt å teste med en maskin først, ved å logge inn på den og gjøre en dry-run (du kan kjøre kommandoer rett fra salt-masteren også, men det er uansett en fordel å ha et skall på maskinen i tilfelle noe går galt):

<pre>
salt-call state.highstate test=True
</pre>

==== Teste endringer før commit ====

PVV har et lite triks som oppretter et salt-environment [https://docs.saltstack.com/en/latest/ref/states/top.html#multiple-environments] for hver bruker. Dette gjør at du kan teste koden din på en minion uten å committe. Det gjør du slik:

<pre>
salt-call state.highstate saltenv="$LOGNAME" test=True
</pre>

== Grains ==
Salt kan bruke grains for å gjøre noe på en gruppe med maskiner. <code><nowiki>salt 'hostname*' grains.items</nowiki></code> viser alle grains hostname er med i. For eksempel kan man si <code><nowiki>salt -G 'os_familt:Debian' test.ping</nowiki></code> for å pinge maskiner som er basert på Debian.

For å legge en minion til en gruppe gjør følgende på minion-en:

=== Konfigurasjon ===
<pre>$ vim /etc/salt/grains

roles:
- standard
- desktop
</pre>

I skrivende stund har vi følgende roller:

{|
|standard
|Alle maskiner med standard-oppsett (det vil si at brukere kan logge inn der)
|-
|desktop
|Desktopmaskiner
|-
|file-server
|Filservere, som f.eks. microbel.
|-
|mysql-server
|MySQL-serveren
|-
|postgresql-server
|PostGreSQL-serveren
|-
|web-frontend
|Web-frontend (ikke den som hoster brukerenes hjemmesider)
|-
|web-homes
|Web-backend for brukeres hjemmesider
|-
|fwlogin
|Maskinen lytter på SSH på port 80 og 443
|-
|salt-master
|salt-masteren (skal ikke ha standardoppsett)
|}

Når minions har blitt lagt til i roller er det viktig å huske på å synkronisere disse med masteren. Den letteste måten å gjøre det på er å kjøre <code><nowiki>salt '*' saltutil.sync_grains</nowiki></code> fra salt-masteren.

For å nå maskiner gjennom egendefinerte grains bruk <code><nowiki>salt -G 'attributt:verdi' kommando</nowiki></code>. Et eksempel er <code><nowiki>salt -G 'roles:workstation' test.ping</nowiki></code>.

== Tekniske ting ==

Litt nyttig info om hvordan ting fungerer under panseret

=== Templates ===

For å distribuere en template og fylle inn verdier kan du gjøre noe ala dette:

<pre><nowiki>
/etc/ssh/sshd_config:
file.managed:
- source: salt://{{ tpldir }}/sshd_config.jinja
- template: jinja
- context:
{% if 'fwlogin' in grains['roles'] %}
ports: [22, 80, 443]
{% else %}
ports: [22]
{% endif %}
</nowiki></pre>

"template: jinja" betyr at filen skal tolkes som en jinja-template, context inneholder alle variablene.

=== Restart av tjenester ===

Etter at en fil er endret eller en pakke er installert kan det være kjekt å automatisk reloade tjenester som påvirkes av det. Tjenester kan ha ulike navn på ulike arkitekturer, men det kan man ta høyde for.

<pre><nowiki>
{% set sshd_service = {
'Debian': 'ssh',
'FreeBSD': 'sshd',
}.get(grains.os_family) %}

sshd-service:
service.running:
- name: {{ sshd_service }}
- watch:
- file: /etc/ssh/sshd_config
</nowiki></pre>

Her er et annet eksempel, som sørger for at en pakke er installert i samme slengen (her antas det at både pakken og servicen heter salt-master alle arkitekturer)
<pre><nowiki>
salt-master:
pkg.installed: []
service.running:
- watch:
- file: /etc/salt/master.d/pvv.conf
- require:
- pkg: salt-master
</nowiki></pre>

=== Distribuere mapper ===

Lag en overordnet mappe som inneholder både mappen du ønsker å distribuere og en sls-fil i salt-mappen: <code><nowiki>/srv/salt/overordnet_mappe</nowiki></code>. Der legger du mappen du ønsker å distribuere, og lager en fil du kaller for <code><nowiki>init.sls</nowiki></code>. Den formateres slik:

<pre><nowiki>
/path/til/der/du/vil/at/mappen/skal/ende/opp/på/minions
file.recurse:
- source: salt://overornet_mappe/mappen_du_vil_distribuere
#optional felter:
- include_empty: True #sørger for at tomme undermapper kommer med
- dir_mode: 777 #må bruke dir_mode når man dister mapper, bruk mode: hvis du dister filer
- user: brukernavn #hilken bruker skal mappen, undermapper og filer tilhøre
- group: eall_s #default-gruppen er root. Skal mappen tilhøre noen andre bruk eall_s eksplisitt
</nowiki></pre>

For å så få distribuert mappen kjør følgende kommando: <code><nowiki>salt '*' state.sls overordnet_mappe</nowiki></code>

=== States og håndheving ===

Salt oppererer med SLS filer (SaLt State) for å holde orden på reglene for distribusjon og hvordan disse skal håndheves. Legg SLS filene i <code><nowiki>/srv/salt/</nowiki></code>. En av de viktigste SLS filene er <code><nowiki>/srv/salt/top.sls</nowiki></code> da den spesifiserer hvilke SLS filer som skal anvendes på hvilke minions. (Alle sls-filene er på salt-master.)

For eksempel hvis vi har SLS filene:
<pre>
/srv/salt/top.sls
/srv/salt/common/init.sls
/srv/salt/common/packages.sls
/srv/salt/sl_eksempel.sls
</pre>

La så filene se slik ut:
<pre>
#top.sls:
base:
'*':
- common
'roles:desktop':
- match: grain
- sl_eksempel
</pre>
<pre>
#common/init.sls:
include:
- common.packages
</pre>
<pre>
#common/packages.sls:
vim:
pkg:
- installed
grep:
pkg:
- installed
</pre>
<pre>
#sl_eksempel.sls:
sl:
pkg:
- installed
</pre>

Hva filene sier:
* <code><nowiki>top.sls</nowiki></code> sier at at alle maskiner skal få staten som er spesifisert i 'common'. Siden 'common' er en mappe og ikke en SLS fil vil det implisitt bety at staten som er gitt i <code><nowiki>common/init.sls</nowiki></code> brukes istedenfor.
** Den sier også at alle maskiner som matcher grainen <code><nowiki>roles:desktop</nowiki></code> skal ha staten spesifisert i <code><nowiki>sl_eksempel.sls</nowiki></code>
* <code><nowiki>common/init.sls</nowiki></code> starter med å ved includen si at alt som er i <code><nowiki>/srv/salt/common/packages</nowiki></code> også skal kjøres i tillegg til innholdet den har (som for dette eksempelet er ikke noe mer)
* <code><nowiki>packages.sls</nowiki></code> sier at to pakker, vim og grep, skal være installert på alle maskiner som hører til staten.
* <code><nowiki>sl_eksempel.sls</nowiki></code> sier at pakken sl skal være installert.

For at minionsene skal gå inn å sjekke hvilke states de skal ha, og anvende dem, kjør: 
<code><nowiki>salt '*' state.highstate</nowiki></code> 
på salt-master.

=== Sørg for at Salt-minion er kjørende og at den jevnlig poller om nye ting fra master ===

Lag en mappe <code><nowiki>/srv/salt/minion_configuration</nowiki></code> som inneholder en <code><nowiki>init.sls</nowiki></code> fil og en <code><nowiki>minion</nowiki></code> fil. La <code><nowiki>init.sls</nowiki></code> se slik ut:

<pre>
salt-minion: # sier at det er salt-minion servicen vi påvirker
service:
# sier at den skal være kjørende:
- running
- enable: True
# sier at servicen skal restartes om man merker en endring i den oppgitte filen:
- watch:
- file /etc/salt/minion
/etc/salt/minion: #sier at denne filen skal speile den oppgitte fra master
file.managed:
# filen som skal kopieres over til minionen
- source salt://minion_configuration/minion
# bruker, gruppe, og premissions for filen når den ender opp på minionen:
- user: root
- group: root
- mode: 644
# sier at filen er et jinjatemplate, og at variablene i templatet skal byttes ut
# med verdiene gitt for dem i context-seksjonen:
- template: jinja
- context:
saltmaster: lommel.pvv.ntnu.no
timer: 4
</pre>

Kopier så inn en minion-fil til <code><nowiki>/srv/salt/minion_configuration/minion</nowiki></code>, og legg til disse linjene:

<pre>
#sett inn under "#master: salt" eller istedenfor det som måtte stå på på linjen som begynner med "master:"
master: {{saltmaster}}

#sier at highstate skal schedules til å kjøre hver 'timer' time:
schedule:
highstate:
function: state.highstate
hours: {{ timer }}
</pre>

== Behandlig av errors og feilmeldinger som kan dukke opp ofte ==

=== No Top file or external nodes data matches found ===

Om salt sier dette:

<pre>
ID: states
Function: no.None
Result: False
Comment: No Top file or external nodes data matches found
Started:
Duration:
Changes:
</pre>

Betyr det sannsynligvis at du har glemt å sette noen roller i [[#Grains|/etc/salt/grains]]

=== UnicodeDecodeError ===

Hvis du får «UnicodeDecodeError: 'ascii' codec can't decode byte 0xc2 in position 99: ordinal not in range» eller lignende kommer dette av en kjent feil i Salt: https://github.com/saltstack/salt/issues/16139

Dette skjer mye oftere om du har gammel salt. Prøv dette:

<pre>
echo deb http://debian.saltstack.com/debian $(lsb_release -c | awk '{print $2}')-saltstack main > /etc/apt/sources.list.d/saltstack.list
aptitude update && aptitude dist-upgrade
</pre>

=== No matching sls found ===
Hvis du får feilen: 
<code><nowiki>No matching sls found for 'sls_file_or_folder_name' in env 'base'</nowiki></code> 
Så har du sannsynligvis skrevet <code><nowiki>filnavn.sls</nowiki></code> (må være uten <code><nowiki>.sls</nowiki></code>), eller mappenavnet feil.

== Nyttige kommandoer og syntax ==

Viktig om syntax:
* All indentering er med mellomrom da tabs ser ut til å krasje, to ser ut til å være standard

Hvordan kopiere enkeltfiler ad-hoc fra salt-master til minions: 
<code><nowiki>salt-cp "*" /path/to/file/on/salt/master /path/to/file/on/minions</nowiki></code>

Hvordan kjøre kode på minions: 
<code><nowiki>salt "*" cmd.run "ps -e | grep salt"</nowiki></code>

For å kjøre på enkeltmaskiner istedenfor alle eller grains skriv inn navnet istedenfor <code><nowiki>"*"</nowiki></code>. Eksempel: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no cmd.run "ps -e | grep salt"</nowiki></code>

For å sjekke om en pakke er installer og hvilken versjon den har: 
<code><nowiki>salt "*" pkg.version "grep"</nowiki></code>

For å installere eller oppgradere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.install sl</nowiki></code>

For å avinstallere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.remove sl</nowiki></code>

For å se salt-pkg kommandoer: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.</nowiki></code> og spam tab.

Drift/Databaser

2016-08-02T06:51:26Z

Knuta: Created page with " == Brukerverktøy == PVV har et par verkøy som lar brukere opprette mysql- og postgres-databaser selv. Disse finner du her: * MySQL: https://dev.pvv.ntnu.no/projects/mysq..."

== Brukerverktøy ==

PVV har et par verkøy som lar brukere opprette mysql- og postgres-databaser selv. Disse finner du her:

* MySQL: https://dev.pvv.ntnu.no/projects/mysql-admtools/
* PostgreSQL: https://dev.pvv.ntnu.no/projects/psql-admtools/

Drift

2016-08-02T06:46:54Z

Knuta: /* Bare nyttig for drift */

[[#Administration|English]]

Drift har ansvaret for å drive maskinene på PVV. Tidligere var drift organisert i egne grupper, først med ansvar for bestemte maskiner, deretter for bestemte tjenester, men har siden 2002 vært organisert i en stor driftsgruppe. I tillegg finnes en gruppe med ansvar for drift av e-postsystemet og en [[CERT|sikkerhetsgruppe]].

Dersom du har generelle spørsmål skal disse sendes drift(at)pvv.ntnu.no, ikke til enkelpersoner som er med i driftsgruppa. Driftskoordinator er p.t. `orjane`.

Husk at drift utelukkende består av frivillige. Ingen får betalt for å gjøre dette og ingen driver med dette 24 timer i døgnet, 365 dager i året. Vi vil likevel gjøre vårt beste for å gi god hjelp og service til våre brukere.

Driftsgruppen har ingen strenge krav til aktivitet eller erfaring for å bli medlem, så selv om du er ny i virket går det fint an å bare observere og absorbere i begynnelsen.

==== Det finnes også en slags [[/Intro|introduksjon]] for nye driftere. ====
----

= [[Dokumentasjon|Nyttig for både bruk og drift]] =
Se [[Dokumentasjon]]

= Bare nyttig for drift =
* [[/ToDo]] Ting som trenger gjøring
* [[/Scanner]] Scanner
* [[/Netboot]] Legge til linuxer i pxe-boot
* [[/DNS og dvask]] Legge til record på navnetjeneren vår, dvask
* [[/Kerberos]] Oppsett av kerberos
* [[/Mediawiki]] Oppsett av mediawiki
* [[/Seriellkonsoll]] Oppsett av seriellkonsoll
* [[/TRAC]] Trac på dev.pvv.ntnu.no
* [[/Databaser]] Databaseservere og relatert oppsett på PVV
* [[/Salt]] Dokumentasjon for SaltStack

= Handling drift ofte utfører =

* [[Legge til bruker]]: Hvordan legge til en ny bruker på PVV.
* [[Drift/Endre brukeres passord|Endre brukeres passord]] Endre brukeres passord
* [[Redigere kvote]]: Hvordan opprette/utvide diskplass for en bruker når han har betalt for utvidet kvote.
* [[Drift/Mail|Epost]]: Behandle epost.
* [[Planlagt nedetid]]: Prosedyre for varsling av planlagt nedetid.
* [[Systembrukere]]: Regler for systembrukere.
* [[Endre eller slette bruker]]: Hva som skal gjøres når man endrer eller sletter brukere
* [[Opprette nye prosjekt på dev]]: Ting og tang som må gjøres for å opprette et nytt prosjekt.
* [[Drift/Oppdatere SSL-sertifikater|Oppdatere SSL-sertifikater]]
* [[Starte etter strømbrudd]]: Hva må gjøres når strømmen har vært borte?

== Annet ==
* [[Drift/Backup|Backup]]
* [[Drift/Maskininstallasjon|Installasjon av OS]]
* [[Drift/Pakkeinstallasjon|Installasjon av programvare]]
* OS-Drift
** [[Drift/Partisjonering]]
** [[Drift/IRIX Install]]
** [[Drift/VAX Netboot]]
** [[Maskiner/Vrimmel|Virtualisering på vrimmel.pvv.ntnu.no]]
** [[Drift/SUSE]]
* [[Drift/OpenVPN|Hvordan sette opp, konfigurere, og vedlikeholde en OpenVPN server]]
* [[Drift/RootpassordReglement]]
* [http://www.pvv.ntnu.no/rootpassordskjema.ps Rootpassordskjema]

= Roteloftet =

Sider som egentlig ikke er relevante lenger.

* <del>[[Maskiner/Octopus|Octopus]]</del> (Ikke i bruk)
* [[Drift/Wiki|Den gamle wikien]]
* [[Drift/Bacula|Bacula, det forrige backupsystemet]]

= Administration =

The administration is responsible for maintaining the machines at PVV. Previously the administration was organized in separate groups, first with responsibility for certain machines, later for certain services, but has since 2002 been organized in a large administration group. In addition there exists a group that is responsible for the maintenance of the email system, and a [[CERT|security group]].

If you have general questions these should be directed to drift(at)pvv.ntnu.no, not to individual members of the administrative group. The coordinator of the administrative group at the moment is `orjane`.

Remember that the administration consists exclusively of volunteers. Nobody is paid to do this and nobody is working on it 24 hours a day, 365 days a year. Even so we will try our best to give good help and service to our users.

The administrative group has no strong requirements to activity or experience to become a member, so even if you are new to craft it's completely possible to just observer and absorb in the beginning.

==== There also exists a kind of [[/Intro|introduction]] for fresh administrators. ====
----

= [[Dokumentasjon|Usefull for both users and administrators]] =
See [[Dokumentasjon]]

= Only useful for administrators =
* [[/ToDo]] Things that need doing
* [[/Scanner]] Scanner
* [[/Netboot]] Add linuxes to pxe-boot
* [[/DNS og dvask|DNS and dvask]] Add records to our name-server, dvask
* [[/Kerberos]] Setup of kerberos
* [[/Mediawiki]] Setup of mediawiki
* [[/Seriellkonsoll|Serial console]] Setup of serial console
* [[/TRAC]] Trac on dev.pvv.ntnu.no
* [[/Puppet]] Documentation for Puppet

= Actions the administration often execute =
* [[Legge til bruker|Adding new users]]: How to add a new user on PVV.
* [[Drift/Endre brukeres passord|Change users password]] Change a users password
* [[Redigere kvote|Edit quota]]: How to create/extend disc space for a user when he's paid for an extended quota.
* [[Drift/Mail|Mail]]: Process email.
* [[Planlagt nedetid|Planed downtime]]: Procedure for notifying planed downtime.
* [[Systembrukere|System users]]: Rules for system users.
* [[Endre eller slette bruker|Modify or delete user]]: What should be changed when one modifies or deletes users.
* [[Opprette nye prosjekt på dev|Creating a new project on dev]]: Things that must be done to create a new project.
* [[Drift/Oppdatere SSL-sertifikater|Update SSL-certificates]]
* [[Starte etter strømbrudd|Restarting after power outage]]: What has to be done when the power has been gone?

== Other ==
* [[Drift/Backup|Backup]]
* [[Drift/Maskininstallasjon|Installation of OS]]
* [[Drift/Pakkeinstallasjon|Installation of software]]
* OS-Administration
** [[Drift/Partisjonering|Administration/Partitioning]]
** [[Drift/IRIX Install|Administration/IRIX Install]]
** [[Drift/VAX Netboot|Administration/VAX Netboot]]
** [[Maskiner/Vrimmel|Virtualization on vrimmel.pvv.ntnu.no]]
** [[Drift/SUSE|Administration/SUSE]]
* [[Drift/RootpassordReglement|Administration/Root password rules]]
* [http://www.pvv.ntnu.no/rootpassordskjema.ps Root password scheme]

= The Attic of Miscellaneous =

Pages that aren't strictly relevant anymore.

* <del>[[Maskiner/Octopus|Octopus]]</del> (Not in use)
* [[Drift/Wiki|The old wiki]]
* [[Drift/Bacula|Bacula, the previous backup system]]

__NOTOC__

Drift/Starte etter strømbrudd

2016-07-15T22:50:07Z

Knuta: /* Støvle dvask */

= Starte etter strømbrudd =

Ikke alt kommer opp automatisk etter strømbrudd.

Det er to KVM-er koblet i serie. Bruk PrtSc for å få opp meny i KVM-en nærmest konsollet. Den andre KVM-en henger på en av utgangene på den første. Bruk PrtSc PrtSc for å få opp menyen.

== Støvle decibel ==

Bryter i front. Lysene i front virker ikke, men du hører godt når den starter.

== Støvle tvilling ==

Uvisst hvilke brytere som virker. Prøv alle. :-) Lysene i front virker ikke, og du hører ikke om den starter. Sjekk konsoll.

== Støvle dvask ==

Dvask står på, men det må gjøres noe magi over seriellkonsoll. Se [[Maskiner/Dvask]].

== Powercycle switchen til stemor og tim ==

Kan slutte å skyfle pakker dersom du er uheldig. Står i samme rack som stemor og tim. Trekk ut strømmen og dytt den inn igjen.

Maskiner

2016-06-07T08:28:42Z

Knuta:

[[#Machines|English]]

= Tjenestealias =
{{:Maskiner/Tjenestealias}}

= Serverbokser =

Dette er maskiner som kjører brukerrettede tjenester og/eller fungerer bra som arbeidshester.

Unngå å kjøre alt mulig rart på microbel. Unntaket er ting som skaper massiv diskaktivitet.

{| border="1" cellpadding="2" cellspacing="0"
|<tablestyle="font-size:1.0em;">| Maskin
| OS
| CPU
| Minne
| Funksjon
| Formfaktor
|-
| [[/Dash8]]
| Debian Wheezy
| Intel Xeon 3.00/3.20 GHz (4x)
| 3 GB
| CUPS og bitlbee
| 1U
|-
| [[/Microbel]]
| Debian Wheezy
| Intel Xeon E5606 2.13GHz (4x)
| 24 GB
| disk og mail
| 3U
|-
| [[/Dverger]]
| Debian Lenny
| [[/SGI Altix]] 350, IA-64 (x16)
| 16 GB
| Tunge ting, slås på etter behov
|-
| [[/Stud]]
|colspan="3" |
| Laserprinter
|-
| [[/Horisont]]
| Debian Squeeze
| P3 600 MHz (2x)
| 1 GB
| eks-login
| 4U
|-
| [[/Hildring]]
| Debian
| VM
| 1 GB
| login
| 0U
|-
| [[/Knakelibrak]]
| Debian Squeeze
| [[/Dell 2650]], Xeon 2.4 GHz (2x)
| 2 GB
| Databaser, wiki
| 2U
|-
| [[/Monty]]
| Debian Squeeze
| [[/Dell 2650]], Xeon 2.0 GHz (2x)
| 2GB
| NMS
| 2U
|-
| [[/Skrotnisse]]
| Debian Wheezy
| [[/Dell 2650]], Xeon 2.4 GHz (2x) ?
| 2 GB ?
| dev, dhcp
| 2U
|-
| [[/Snehvit]]
| SLES 9
| [[/SGI Altix]] 350, IA-64 1400 MHz (16x)
| 16 GB
| Tunge ting, slås på etter behov
|-
| [[/Stemor]]
| Debian Lenny
| [[/SGI Altix]] 350, IA-64 1400 MHz (2x)
| 2 GB
| Speil
| 2U
|-
| [[/Tim]]
| Debian Squeeze
| [[/SGI Altix]] 350, IA-64 1400 MHz (2x)
| 2 GB
| www
| 2U
|-
| [[/Lommel]]
| Debian Wheezy
|
|
| config server, [[rdist]]/puppet
| 1U
|-
| [[/Mips]]
| Fedora 20
| Core2Quad Q9550 @ 2.83GHz
| 8 GB
|-
| [[/flags]]
| Fedora 20
| Core2Quad Q9550 @ 2.83GHz
| 8 GB
|-
| [[/Mips3]]
| Fedora 20
| Core2Quad Q9550 @ 2.83GHz
| 8 GB
|-
| [[/Mips4]]
| Fedora 20
| Core2Quad Q9550 @ 2.83GHz
| 8 GB
|-
| [[/Mips5]]
| Fedora 20
| Core2Quad Q9550 @ 2.83GHz
| 6 GB
|-
| [[/scrum]]
| CentOS
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| Virtual machine host
|-
| [[/innovation]]
| CentOS
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| minecraftserver
|-
| [[/scrum4]]
| CentOS
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| Virtual machine host
|-
| [[/scrum5]]
| CentOS
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| Virtual machine host
|}

= Arbeidsstasjoner =
{| border="1" cellpadding="2" cellspacing="0"
|<tablestyle="font-size:1.0em;">| Maskin
| OS Debian
| CPU
| Minne
| Funksjon
|-
| [[/Sprint]]
| Debian Squeeze
| AMD Athlon 64 X2 5000+
| 4GB
| utfaset, skal flyttes til nvg
|-
| [[/Kvikk]]
| OpenWRT
| Router stuff
| Ukjent
| Ruter, trådløs
|-
| [[/Osaka]]
| Windows 7 for spill og dill
| Intel Core2 Duo E8400
| 4GB
| Dobbeltstøvler Debian Squeeze/Sid
|-
| [[/Sanctuary]]
| Windows 10 for spill og dill på TVen
| Intel i7
| 8GB
|-
| [[/Glenda]]
| Plan 9
| AMD Duron 1.3 Ghz
| 512 MB
| Ingen
|-
| [[/Skrott]]
| Debian Lenny
| PowerPC 7450, 800MHz
| 768 MB
| Betalingssystem for [[PVVVV]], lampe
|-
| [[/Tallulah]]
| Debian Linux/Gnu versjon testes
| AMD A6 3500 APU (trekjerne med innebygget GPU)
| 4GB
| Multimediamaskin (koblet til og fjernsynsapparat)
|-
| [[/Pirat]]
| Arch (ikke PVV-oppsett ennå)
| Pentium D 3.0 GHz (2x)
| 2040MB
|-
| [[/Doktor]]
| Ubuntu Utopic Unicorn
| Intel Core(TM) i3-2100 3.10Ghz
| 8 GB
|-
| [[/venture]]
| FreeBSD
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| Terminal
|-
| [[/stakeholder]]
| Linux Mint
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| Terminal
|-
| [[/Bull]]
| Debian Sid
| Core2Quad Q9550 @ 2.83GHz
| 8GB
|-
| [[/Bulldozer]]
| Debian Jessie
| Intel Core 2 Quad CPU Q9550 @ 2.83GHz
| 8GB
| Terminal
|-
| [[/Misantropy]]
| Debian Jessie
| Intel Core i7 CPU 860 @ 2.80GHz
| 16GBGB
| Terminal
|-
| [[/Jerry]]
| OS X El Capitan
| Intel Core i5 @ 2.50GHz
| 16GB
| Terminal
|}

= Annet =

De følgende maskinene har en ganske spesialisert funksjon, og/eller er såpass skrøpelige at de ikke anbefales til vanlig bruk.

{| border="1" cellpadding="2" cellspacing="0"
|<tablestyle="font-size:1.0em;">| Maskin
| OS
| Hardware
| Minne
| Funksjon
| Formfaktor
|-
| [[/Dvask]]
| NetBSD
| MicroVAX II
|
| DNS
| stor
|-
| [[/Odroid-x]]
| Selvvalgt
| ARMv7 Processor 4 kjerne
| 1GB
| Leketøy
|-
| [[/Odroid-A]]
| Selvvalgt
| ARMv7 Dual core A9 exynos 4210
| 1GB
| Leketøy med touchskjerm
|-
| [[/Asgard]]
| Debian
| P3 800 Mhz (2x)
|
| Kerberos KDC
| 4U
|-
| [[/Midgard]]
| Debian
| P3 800 Mhz (2x)
|
| Kerberos KDC backup?
| 4U
|-
| [[/Nosferatu]]
| FreeBSD
| AMD64
|
| kommer om natten og suger ut data fra decibel
| 4U
|-
| <del>[[/Onyx]]</del>
| <del>FreeBSD</del>
| <del>[[/Dell 2650]]</del>
| Skrotet for knakelibrak
| <del>Loghost</del>
| <del>2U</del>
|-
| [[Kofi]]
| Fedora-basert Linux
| AMD Geode (XO-1)
|
| Tar bilder av [[Annan]]
|-
| [[/Vrimmel]]
| Debian Lenny
| [[/Dell 2650]], Xeon 2.4 GHz (2x)
|
| Vert for virtuelle maskiner (Xen)
| 2U + 3U diskbay
|-
| [[Annan]]
| Enkelt kretskort og knapper
| Varmeplate med variabel effekt
|
| Lager kaffe under overvåkning av [[Kofi]]
|-
| [[Lemming]]
| Grønn te
| Glasskanne, ca 1 liter minne
|
| Brukes for å lage varm drikke med lemensmak. Etterkommeren av Lemen.
|-
| [[Commodore]]
| Enkelt kretskort, knapper og kapselspak
| 19bar pumpe, 1 liter homeopatminne på baksiden og oppsamlingsrist
|
| Lager espresso av nespressokapsler og vann. MAGI!
| nespressomaskin
|-
| [[/Alice]]
| Debian Squeeze
| Intel Pentium 4 something (1x)
| 2 GB
| Speil og Torrents
|-
| [[Tardis]]
| Time and Relative Dimension in Space
| Treverk og maling
|
| Laget for å lokke Who-fans til PVV under immatrikulering. Står nå som pynt.
| usynlig
|-
| [[brzęczyszczykiewicz]]
| Unix-kompatibelt
| Dell
|
| rmgbmysiJH0
|}

= Utfasede maskiner =
* [[/Enron]] - brukerweb (det var hvertfall planen)
* [[/HB]] - FreeBSD6 på x86 - DVD
* India
* Mu - Noe på HPPA - har vondt i disken sin.
* Peridexion - Kaffebord (i slekt med storm)
* [[/Sapiens]] - Ubuntu GNU/Linux på x86
* [[/Storm]] - SGI Callenge L som kjører IRIX 6.5, lider av POKB-feil
* Voldsboks2
* ... - Altund hadde en boks frem til 2007(?)
* ... - Nabla hadde en boks frem til 2007

Servermaskiner:

{| border="1" cellpadding="2" cellspacing="0"
|<tablestyle="font-size:1.0em;">| Maskin
| OS
| CPU
| Minne
| Funksjon
|-
| [[/Berners-Lee]]
| Debian Lenny
| IA-64 733 MHz (2x)
| 2 GB
| www
|-
| [[/Baird]]
| Ubuntu Edgy
| AMD XP 1800+
| 512 MB
| Mediasenter (under TVen), ofte avslått
|-
| [[/Egg]]
| Debian Etch
| P3 600 MHz (2x)
| 1 GB
| Utvikling? For tiden vondt i disken.
|-
| [[/Inti]]
| FreeBSD 7.1
| UltraSPARC II (4x)
| 4 GB
| Dytter torrents
|-
| [[/Verden]]
| FreeBSD
| ?
| ?
| anonym FTP
|-
| [[/Bacchus]]
| FreeBSD
| x86
| DHCP, DNS, tftp, gammel og bitter
|-
| [[/Brutus]]
| Solaris 9
| Sun Sparcstation 20?
| YP-slave
|-
| [[/Malina]]
| Solaris 10
| Sun Enterprise 250
| YP-master
|-
| [[/Kvartett]]
| VMS
| [[AlhpaServer]] 4100
| Mystisk og uutgrunnelig
|-
| [[/Octopus]]
| NetBSD
| x86
| brukes som seriekonsollmaskin
|-
| [[/Rymden]]
| NetBSD
| x86
| krysskompilering til VAX
|-
| [[/Echelon]]
| Trustix
| x86
| Loghost
|-
| [[/Herakles]]
| Debian
| x86
| (veldig ensom) Kerberos KDC
|-
| [[/Decibel]]
| Ubuntu Hardy
| AMD Opteron 1800 MHz (2x)
| 4 GB
| Tidligere disk og mail
|-
| [[/Flode]]
| Debian Squeeze
| Xeon 2.8 GHz (2x)
| 6 GB
| Er død og ligger i hyllen på koserommet
|-
| [[/Hingst]]
|colspan="2" |
| 64 MB
| Laserprinter
|-
| [[/Tvilling]]
| Debian Squeeze
| P3 800 MHz (2x)
| 512 MB
| bitlbee, div. tjenester
|-
| [[/Cthulhu]]
| Debian Wheezy
| Pentium 3
| 1 GB
| config server, [[rdist]]/puppet
|-
|}

Arbeidsstasjoner:

{| border="1" cellpadding="2" cellspacing="0"
|<tablestyle="font-size:1.0em;">| Maskin
| OS
| CPU
| Minne
| Funksjon
|-
| [[/Amaterasu]]
| Solaris 10
| Ultrasparc II 400 MHz (2x)
| 2 GB
| Sun Enterprise 250, yp-slave
|-
| [[/Grubgrub]]
| Debian Lenny
| AMD 1 GHz
| 512 MB
|
|-
| [[/Kobben]]
| Gentoo
| AMD 1.8 GHz
| 512 MB
|
|-
| [[/Kremt]]
| Debian Lenny
| AMD XP 1700+
| 512 MB
|
|-
| [[/Spiralis]]
| Windows 7
| AMD Phenom(tm) II X4 955
| 4 GB
| låner 4GB ram til woody
|-
| [[/Olympic]]
| Debian Etch
| IA-64 733 MHz (2x)
| 2 GB
|
|-
| [[/Lysfontene]]
| Litt diverse: Debian, Mint og Ubuntu-studio
| Intel Core 2 duo E7300 ?
| 4 - 6 GiB
| arbeidsstasjon
|-
| [[/Nissen]]
| Ubuntu Karmic
| AMD XP 1800+
| 512 MB
|}

Maskiner som ikke ble drevet av PVV.
* Fire (aka mumegw) - MUD-ting
* [[/Vaffeljern]] - NTNUI Dans (Står ikke lenger på PVV)
* Voldsboks (aka grimne, mume) - MUD-ting
* Yuriko (aka poy.no) - alfborge, hosting av dansefilmer

= Machines =

= Service alias =
{{:Maskiner/Tjenestealias}}

= Server boxes =

These are machines that run user centered services and/or work well as workhorses.

Avoid running more than necessary on microbel. The exception is things that produce a lot of disc activity.

{| border="1" cellpadding="2" cellspacing="0"
|<tablestyle="font-size:1.0em;">| Machine
| OS
| CPU
| Memory
| Functions
|-
| [[/Dash8]]
| Debian Wheezy
| Intel Xeon 3.00/3.20 GHz (4x)
| 3 GB
| CUPS and bitlbee
|-
| [[/Microbel]]
| Debian Wheezy
| Intel Xeon E5606 2.13GHz (4x)
| 24 GB
| disc and mail
|-
| [[/Dverger]]
| Debian Lenny
| [[/SGI Altix]] 350, IA-64 (x16)
| 16 GB
| Heavy things, turned on when needed
|-
| [[/Stud]]
|colspan="3" |
| Laser printers
|-
| [[/Horisont]]
| Debian Squeeze
| P3 600 MHz (2x)
| 1 GB
| login
|-
| [[/Knakelibrak]]
| Debian Squeeze
| [[/Dell 2650]], Xeon 2.4 GHz (2x)
| 2 GB
| Databases, wiki
|-
| [[/Monty]]
| Debian Squeeze
| [[/Dell 2650]], Xeon 2.0 GHz (2x)
| 2GB
| NMS
|-
| [[/Skrotnisse]]
| Debian Wheezy
| [[/Dell 2650]], Xeon 2.4 GHz (2x) ?
| 2 GB ?
| dev, replacing tvillings tasks
|-
| [[/Snehvit]]
| SLES 9
| [[/SGI Altix]] 350, IA-64 1400 MHz (16x)
| 16 GB
| Heavy things, turned on when needed
|-
| [[/Stemor]]
| Debian Lenny
| [[/SGI Altix]] 350, IA-64 1400 MHz (2x)
| 2 GB
| Mirror
|-
| [[/Tim]]
| Debian Squeeze
| [[/SGI Altix]] 350, IA-64 1400 MHz (2x)
| 2 GB
| www
|-
| [[/Lommel]]
| Debian Wheezy
| Pentium 4 2.80GHz
| 1 GB
| config server, [[rdist]]/puppet
|-
| [[/Mips]]
| Fedora 20
| Core2Quad Q9550 @ 2.83GHz
| 8 GB
|-
| [[/flags]]
| Fedora 20
| Core2Quad Q9550 @ 2.83GHz
| 8 GB
|-
| [[/Mips3]]
| Fedora 20
| Core2Quad Q9550 @ 2.83GHz
| 8 GB
|-
| [[/Mips4]]
| Fedora 20
| Core2Quad Q9550 @ 2.83GHz
| 8 GB
|-
| [[/Mips5]]
| Fedora 20
| Core2Quad Q9550 @ 2.83GHz
| 6 GB
|-
| [[/scrum]]
| CentOS
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| Virtual machine host
|-
| [[/innovation]]
| CentOS
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| minecraftserver
|-
| [[/scrum4]]
| CentOS
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| Virtual machine host
|-
| [[/scrum5]]
| CentOS
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| Virtual machine host
|}

= Workstations =
{| border="1" cellpadding="2" cellspacing="0"
|<tablestyle="font-size:1.0em;">| Machine
| OS Debian
| CPU
| Memory
| Function
|-
| [[/Sprint]]
| Debian Squeeze
| AMD Athlon 64 X2 5000+
| 4GB
| phased out, to be moved to nvg
|-
| [[/Kvikk]]
| Debian Squeeze
| Intel Core2 Duo E7300
| 4GB
| phased out, to be moved to nvg
|-
| [[/Osaka]]
| Windows 7 for games and stuff
| Intel Core2 Duo E8400
| 4GB
|
|-
| [[/Sanctuary]]
| Windows 10 for games and stuff
| intel i7
| 8 GB
|
|-
| [[/Glenda]]
| Plan 9
| AMD Duron 1.3 Ghz
| 512 MB
| None
|-
| [[/Skrott]]
| Debian Lenny
| PowerPC 7450, 800MHz
| 768 MB
| Payment system for [[PVVVV]], lamp
|-
| [[/Tallulah]]
| Debian Linux/Gnu version being tested
| AMD A6 3500 APU (tricore with built in GPU)
| 4GB
| Multimedia machine (connected to television)
|-
| [[/Pirat]]
| Arch (not PVV-setup yet)
| Pentium D 3.0 GHz (2x)
| 2040MB
|
|-
| [[/Doktor]]
| Ubuntu
| Intel Core(TM) i3-2100 3.10Ghz
| 8 GB
|-
| [[/venture]]
| Debian Sid
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| Terminal
|-
| [[/stakeholder]]
| Fedora 20 (Heisenbug)
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| Terminal
|-
| [[/Bull]]
| Debian Sid
| Core2Quad Q9550 @ 2.83GHz
| 8GB
|}

= Other =

The following machines have rather specialized functions, and/or are so fragile that they are not recommended for ordinary use.

{| border="1" cellpadding="2" cellspacing="0"
|<tablestyle="font-size:1.0em;">| Machine
| OS
| Hardware
| Memory
| Function
|-
| [[/Dvask]]
| NetBSD
| MicroVAX II
|
| DNS
|-
| [[/Asgard]]
| Debian
| P3 800 Mhz (2x)
|
| Kerberos KDC
|-
| [[/Midgard]]
| Debian
| P3 800 Mhz (2x)
|
| Kerberos KDC backup?
|-
| [[/Nosferatu]]
| FreeBSD
| AMD64
|
| comes in the night and sucks data out of decibel
|-
| [[/Onyx]]
| FreeBSD
| [[/Dell 2650]]
|
| Loghost
|-
| [[Kofi]]
| Fedora-based Linux
| AMD Geode (XO-1)
|
| Takes images of [[Annan]]
|-
| [[/Vrimmel]]
| Debian Lenny
| [[/Dell 2650]], Xeon 2.4 GHz (2x)
|
| Host for virtual machines (Xen)
|-
| [[Annan]]
| Simple circuit board and buttons
| Boilerplate with variable effect
|
| Makes coffee under the supervision of [[Kofi]]
|-
| [[Lemming]]
| Green tea
| Glass flask, ca 1 liter memory
|
| Used to make hot drinks with lemming taste. Ascendant of Lemming.
|-
| [[Commodore]]
| Simple circuit board, buttons and capsule lever
| 19bar pump, 1 liter homeopathic memory on the backside and collection grate
|
| Makes espresso of nespresso capsules and water. MAGIC!
|-
| [[/Alice]]
| Debian Squeeze
| Intel Pentium 4 something (1x)
| 2 GB
| Mirror and torrents
|-
| [[Tardis]]
| Time and Relative Dimension in Space
| Wood and paint
|
| Made to lure Who-fans to PVV during the matriculation. Currently stands as decoration.
|}

= Phased out machines =
* [[/Enron]] - userweb (at least that was the plan)
* [[/HB]] - FreeBSD6 on x86 - DVD
* India
* Mu - Something on HPPA - has pains in its disc.
* Peridexion - Coffee table (related to storm)
* [[/Sapiens]] - Ubuntu GNU/Linux on x86
* [[/Storm]] - SGI Callenge L that runs IRIX 6.5, suffers from POKB-fault
* Voldsboks2
* ... - Altund had a box up to 2007(?)
* ... - Nabla had a box up to 2007

Server machines:

{| border="1" cellpadding="2" cellspacing="0"
|<tablestyle="font-size:1.0em;">| Machine
| OS
| CPU
| Memory
| Function
|-
| [[/Berners-Lee]]
| Debian Lenny
| IA-64 733 MHz (2x)
| 2 GB
| www
|-
| [[/Baird]]
| Ubuntu Edgy
| AMD XP 1800+
| 512 MB
| Media center (under the TV), often off
|-
| [[/Egg]]
| Debian Etch
| P3 600 MHz (2x)
| 1 GB
| Development? Currently has pains in its disc.
|-
| [[/Inti]]
| FreeBSD 7.1
| UltraSPARC II (4x)
| 4 GB
| Pushes torrents
|-
| [[/Verden]]
| FreeBSD
| ?
| ?
| anonymous FTP
|-
| [[/Bacchus]]
| FreeBSD
| x86
| DHCP, DNS, tftp, old and bitter
|-
| [[/Brutus]]
| Solaris 9
| Sun Sparcstation 20?
| YP-slave
|-
| [[/Malina]]
| Solaris 10
| Sun Enterprise 250
| YP-master
|-
| [[/Kvartett]]
| VMS
| [[AlhpaServer]] 4100
| Mysterious and unfathomable
|-
| [[/Octopus]]
| NetBSD
| x86
| used as a serial console machine
|-
| [[/Rymden]]
| NetBSD
| x86
| cross compilation to VAX
|-
| [[/Echelon]]
| Trustix
| x86
| Loghost
|-
| [[/Herakles]]
| Debian
| x86
| (very lonely) Kerberos KDC
|-
| [[/Decibel]]
| Ubuntu Hardy
| AMD Opteron 1800 MHz (2x)
| 4 GB
| Former disc and mail
|-
| [[/Flode]]
| Debian Squeeze
| Xeon 2.8 GHz (2x)
| 6 GB
| Is dead and lies on the shelf in the recreation room
|-
| [[/Hingst]]
|colspan="2" |
| 64 MB
| Laser printer
|-
| [[/Tvilling]]
| Debian Squeeze
| P3 800 MHz (2x)
| 512 MB
| bitlbee, misc. services
|-
|}

Workstations:

{| border="1" cellpadding="2" cellspacing="0"
|<tablestyle="font-size:1.0em;">| Machine
| OS
| CPU
| Memory
| Function
|-
| [[/Amaterasu]]
| Solaris 10
| Ultrasparc II 400 MHz (2x)
| 2 GB
| Sun Enterprise 250, yp-slave
|-
| [[/Grubgrub]]
| Debian Lenny
| AMD 1 GHz
| 512 MB
|
|-
| [[/Kobben]]
| Gentoo
| AMD 1.8 GHz
| 512 MB
|
|-
| [[/Kremt]]
| Debian Lenny
| AMD XP 1700+
| 512 MB
|
|-
| [[/Olympic]]
| Debian Etch
| IA-64 733 MHz (2x)
| 2 GB
|-
| [[/Spiralis]]
| Windows 7
| AMD Phenom(tm) II X4 955
| 4 GB
|-
| [[/Lysfontene]]
| Some misc: Debian, Mint and Ubuntu-studio
| Intel Core 2 duo E7300 ?
| 4 - 6 GiB
| workstation
|-
| [[/Nissen]]
| Ubuntu Karmic
| AMD XP 1800+
| 512 MB
|}

Machines that weren't maintained by PVV.
* Fire (aka mumegw) - MUD-thing
* [[/Vaffeljern|Waffle toaster]] - NTNUI Dans (No longer at PVV)
* Voldsboks (aka grimne, mume) - MUD-thing
* Yuriko (aka poy.no) - alfborge, hosting of dancing films

__NOTOC__

Maskiner

2016-06-07T08:28:21Z

Knuta: /* Serverbokser */

[[#Machines|English]]

= Tjenestealias =
{{:Maskiner/Tjenestealias}}

= Serverbokser =

Dette er maskiner som kjører brukerrettede tjenester og/eller fungerer bra som arbeidshester.

Unngå å kjøre alt mulig rart på microbel. Unntaket er ting som skaper massiv diskaktivitet.

{| border="1" cellpadding="2" cellspacing="0"
|<tablestyle="font-size:1.0em;">| Maskin
| OS
| CPU
| Minne
| Funksjon
| Formfaktor
|-
| [[/Dash8]]
| Debian Wheezy
| Intel Xeon 3.00/3.20 GHz (4x)
| 3 GB
| CUPS og bitlbee
| 1U
|-
| [[/Microbel]]
| Debian Wheezy
| Intel Xeon E5606 2.13GHz (4x)
| 24 GB
| disk og mail
| 3U
|-
| [[/Dverger]]
| Debian Lenny
| [[/SGI Altix]] 350, IA-64 (x16)
| 16 GB
| Tunge ting, slås på etter behov
|-
| [[/Stud]]
|colspan="3" |
| Laserprinter
|-
| [[/Horisont]]
| Debian Squeeze
| P3 600 MHz (2x)
| 1 GB
| eks-login
| 4U
|-
| [[/Horisont]]
| Debian
| VM
| 1 GB
| login
| 0U
|-
| [[/Knakelibrak]]
| Debian Squeeze
| [[/Dell 2650]], Xeon 2.4 GHz (2x)
| 2 GB
| Databaser, wiki
| 2U
|-
| [[/Monty]]
| Debian Squeeze
| [[/Dell 2650]], Xeon 2.0 GHz (2x)
| 2GB
| NMS
| 2U
|-
| [[/Skrotnisse]]
| Debian Wheezy
| [[/Dell 2650]], Xeon 2.4 GHz (2x) ?
| 2 GB ?
| dev, dhcp
| 2U
|-
| [[/Snehvit]]
| SLES 9
| [[/SGI Altix]] 350, IA-64 1400 MHz (16x)
| 16 GB
| Tunge ting, slås på etter behov
|-
| [[/Stemor]]
| Debian Lenny
| [[/SGI Altix]] 350, IA-64 1400 MHz (2x)
| 2 GB
| Speil
| 2U
|-
| [[/Tim]]
| Debian Squeeze
| [[/SGI Altix]] 350, IA-64 1400 MHz (2x)
| 2 GB
| www
| 2U
|-
| [[/Lommel]]
| Debian Wheezy
|
|
| config server, [[rdist]]/puppet
| 1U
|-
| [[/Mips]]
| Fedora 20
| Core2Quad Q9550 @ 2.83GHz
| 8 GB
|-
| [[/flags]]
| Fedora 20
| Core2Quad Q9550 @ 2.83GHz
| 8 GB
|-
| [[/Mips3]]
| Fedora 20
| Core2Quad Q9550 @ 2.83GHz
| 8 GB
|-
| [[/Mips4]]
| Fedora 20
| Core2Quad Q9550 @ 2.83GHz
| 8 GB
|-
| [[/Mips5]]
| Fedora 20
| Core2Quad Q9550 @ 2.83GHz
| 6 GB
|-
| [[/scrum]]
| CentOS
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| Virtual machine host
|-
| [[/innovation]]
| CentOS
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| minecraftserver
|-
| [[/scrum4]]
| CentOS
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| Virtual machine host
|-
| [[/scrum5]]
| CentOS
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| Virtual machine host
|}

= Arbeidsstasjoner =
{| border="1" cellpadding="2" cellspacing="0"
|<tablestyle="font-size:1.0em;">| Maskin
| OS Debian
| CPU
| Minne
| Funksjon
|-
| [[/Sprint]]
| Debian Squeeze
| AMD Athlon 64 X2 5000+
| 4GB
| utfaset, skal flyttes til nvg
|-
| [[/Kvikk]]
| OpenWRT
| Router stuff
| Ukjent
| Ruter, trådløs
|-
| [[/Osaka]]
| Windows 7 for spill og dill
| Intel Core2 Duo E8400
| 4GB
| Dobbeltstøvler Debian Squeeze/Sid
|-
| [[/Sanctuary]]
| Windows 10 for spill og dill på TVen
| Intel i7
| 8GB
|-
| [[/Glenda]]
| Plan 9
| AMD Duron 1.3 Ghz
| 512 MB
| Ingen
|-
| [[/Skrott]]
| Debian Lenny
| PowerPC 7450, 800MHz
| 768 MB
| Betalingssystem for [[PVVVV]], lampe
|-
| [[/Tallulah]]
| Debian Linux/Gnu versjon testes
| AMD A6 3500 APU (trekjerne med innebygget GPU)
| 4GB
| Multimediamaskin (koblet til og fjernsynsapparat)
|-
| [[/Pirat]]
| Arch (ikke PVV-oppsett ennå)
| Pentium D 3.0 GHz (2x)
| 2040MB
|-
| [[/Doktor]]
| Ubuntu Utopic Unicorn
| Intel Core(TM) i3-2100 3.10Ghz
| 8 GB
|-
| [[/venture]]
| FreeBSD
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| Terminal
|-
| [[/stakeholder]]
| Linux Mint
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| Terminal
|-
| [[/Bull]]
| Debian Sid
| Core2Quad Q9550 @ 2.83GHz
| 8GB
|-
| [[/Bulldozer]]
| Debian Jessie
| Intel Core 2 Quad CPU Q9550 @ 2.83GHz
| 8GB
| Terminal
|-
| [[/Misantropy]]
| Debian Jessie
| Intel Core i7 CPU 860 @ 2.80GHz
| 16GBGB
| Terminal
|-
| [[/Jerry]]
| OS X El Capitan
| Intel Core i5 @ 2.50GHz
| 16GB
| Terminal
|}

= Annet =

De følgende maskinene har en ganske spesialisert funksjon, og/eller er såpass skrøpelige at de ikke anbefales til vanlig bruk.

{| border="1" cellpadding="2" cellspacing="0"
|<tablestyle="font-size:1.0em;">| Maskin
| OS
| Hardware
| Minne
| Funksjon
| Formfaktor
|-
| [[/Dvask]]
| NetBSD
| MicroVAX II
|
| DNS
| stor
|-
| [[/Odroid-x]]
| Selvvalgt
| ARMv7 Processor 4 kjerne
| 1GB
| Leketøy
|-
| [[/Odroid-A]]
| Selvvalgt
| ARMv7 Dual core A9 exynos 4210
| 1GB
| Leketøy med touchskjerm
|-
| [[/Asgard]]
| Debian
| P3 800 Mhz (2x)
|
| Kerberos KDC
| 4U
|-
| [[/Midgard]]
| Debian
| P3 800 Mhz (2x)
|
| Kerberos KDC backup?
| 4U
|-
| [[/Nosferatu]]
| FreeBSD
| AMD64
|
| kommer om natten og suger ut data fra decibel
| 4U
|-
| <del>[[/Onyx]]</del>
| <del>FreeBSD</del>
| <del>[[/Dell 2650]]</del>
| Skrotet for knakelibrak
| <del>Loghost</del>
| <del>2U</del>
|-
| [[Kofi]]
| Fedora-basert Linux
| AMD Geode (XO-1)
|
| Tar bilder av [[Annan]]
|-
| [[/Vrimmel]]
| Debian Lenny
| [[/Dell 2650]], Xeon 2.4 GHz (2x)
|
| Vert for virtuelle maskiner (Xen)
| 2U + 3U diskbay
|-
| [[Annan]]
| Enkelt kretskort og knapper
| Varmeplate med variabel effekt
|
| Lager kaffe under overvåkning av [[Kofi]]
|-
| [[Lemming]]
| Grønn te
| Glasskanne, ca 1 liter minne
|
| Brukes for å lage varm drikke med lemensmak. Etterkommeren av Lemen.
|-
| [[Commodore]]
| Enkelt kretskort, knapper og kapselspak
| 19bar pumpe, 1 liter homeopatminne på baksiden og oppsamlingsrist
|
| Lager espresso av nespressokapsler og vann. MAGI!
| nespressomaskin
|-
| [[/Alice]]
| Debian Squeeze
| Intel Pentium 4 something (1x)
| 2 GB
| Speil og Torrents
|-
| [[Tardis]]
| Time and Relative Dimension in Space
| Treverk og maling
|
| Laget for å lokke Who-fans til PVV under immatrikulering. Står nå som pynt.
| usynlig
|-
| [[brzęczyszczykiewicz]]
| Unix-kompatibelt
| Dell
|
| rmgbmysiJH0
|}

= Utfasede maskiner =
* [[/Enron]] - brukerweb (det var hvertfall planen)
* [[/HB]] - FreeBSD6 på x86 - DVD
* India
* Mu - Noe på HPPA - har vondt i disken sin.
* Peridexion - Kaffebord (i slekt med storm)
* [[/Sapiens]] - Ubuntu GNU/Linux på x86
* [[/Storm]] - SGI Callenge L som kjører IRIX 6.5, lider av POKB-feil
* Voldsboks2
* ... - Altund hadde en boks frem til 2007(?)
* ... - Nabla hadde en boks frem til 2007

Servermaskiner:

{| border="1" cellpadding="2" cellspacing="0"
|<tablestyle="font-size:1.0em;">| Maskin
| OS
| CPU
| Minne
| Funksjon
|-
| [[/Berners-Lee]]
| Debian Lenny
| IA-64 733 MHz (2x)
| 2 GB
| www
|-
| [[/Baird]]
| Ubuntu Edgy
| AMD XP 1800+
| 512 MB
| Mediasenter (under TVen), ofte avslått
|-
| [[/Egg]]
| Debian Etch
| P3 600 MHz (2x)
| 1 GB
| Utvikling? For tiden vondt i disken.
|-
| [[/Inti]]
| FreeBSD 7.1
| UltraSPARC II (4x)
| 4 GB
| Dytter torrents
|-
| [[/Verden]]
| FreeBSD
| ?
| ?
| anonym FTP
|-
| [[/Bacchus]]
| FreeBSD
| x86
| DHCP, DNS, tftp, gammel og bitter
|-
| [[/Brutus]]
| Solaris 9
| Sun Sparcstation 20?
| YP-slave
|-
| [[/Malina]]
| Solaris 10
| Sun Enterprise 250
| YP-master
|-
| [[/Kvartett]]
| VMS
| [[AlhpaServer]] 4100
| Mystisk og uutgrunnelig
|-
| [[/Octopus]]
| NetBSD
| x86
| brukes som seriekonsollmaskin
|-
| [[/Rymden]]
| NetBSD
| x86
| krysskompilering til VAX
|-
| [[/Echelon]]
| Trustix
| x86
| Loghost
|-
| [[/Herakles]]
| Debian
| x86
| (veldig ensom) Kerberos KDC
|-
| [[/Decibel]]
| Ubuntu Hardy
| AMD Opteron 1800 MHz (2x)
| 4 GB
| Tidligere disk og mail
|-
| [[/Flode]]
| Debian Squeeze
| Xeon 2.8 GHz (2x)
| 6 GB
| Er død og ligger i hyllen på koserommet
|-
| [[/Hingst]]
|colspan="2" |
| 64 MB
| Laserprinter
|-
| [[/Tvilling]]
| Debian Squeeze
| P3 800 MHz (2x)
| 512 MB
| bitlbee, div. tjenester
|-
| [[/Cthulhu]]
| Debian Wheezy
| Pentium 3
| 1 GB
| config server, [[rdist]]/puppet
|-
|}

Arbeidsstasjoner:

{| border="1" cellpadding="2" cellspacing="0"
|<tablestyle="font-size:1.0em;">| Maskin
| OS
| CPU
| Minne
| Funksjon
|-
| [[/Amaterasu]]
| Solaris 10
| Ultrasparc II 400 MHz (2x)
| 2 GB
| Sun Enterprise 250, yp-slave
|-
| [[/Grubgrub]]
| Debian Lenny
| AMD 1 GHz
| 512 MB
|
|-
| [[/Kobben]]
| Gentoo
| AMD 1.8 GHz
| 512 MB
|
|-
| [[/Kremt]]
| Debian Lenny
| AMD XP 1700+
| 512 MB
|
|-
| [[/Spiralis]]
| Windows 7
| AMD Phenom(tm) II X4 955
| 4 GB
| låner 4GB ram til woody
|-
| [[/Olympic]]
| Debian Etch
| IA-64 733 MHz (2x)
| 2 GB
|
|-
| [[/Lysfontene]]
| Litt diverse: Debian, Mint og Ubuntu-studio
| Intel Core 2 duo E7300 ?
| 4 - 6 GiB
| arbeidsstasjon
|-
| [[/Nissen]]
| Ubuntu Karmic
| AMD XP 1800+
| 512 MB
|}

Maskiner som ikke ble drevet av PVV.
* Fire (aka mumegw) - MUD-ting
* [[/Vaffeljern]] - NTNUI Dans (Står ikke lenger på PVV)
* Voldsboks (aka grimne, mume) - MUD-ting
* Yuriko (aka poy.no) - alfborge, hosting av dansefilmer

= Machines =

= Service alias =
{{:Maskiner/Tjenestealias}}

= Server boxes =

These are machines that run user centered services and/or work well as workhorses.

Avoid running more than necessary on microbel. The exception is things that produce a lot of disc activity.

{| border="1" cellpadding="2" cellspacing="0"
|<tablestyle="font-size:1.0em;">| Machine
| OS
| CPU
| Memory
| Functions
|-
| [[/Dash8]]
| Debian Wheezy
| Intel Xeon 3.00/3.20 GHz (4x)
| 3 GB
| CUPS and bitlbee
|-
| [[/Microbel]]
| Debian Wheezy
| Intel Xeon E5606 2.13GHz (4x)
| 24 GB
| disc and mail
|-
| [[/Dverger]]
| Debian Lenny
| [[/SGI Altix]] 350, IA-64 (x16)
| 16 GB
| Heavy things, turned on when needed
|-
| [[/Stud]]
|colspan="3" |
| Laser printers
|-
| [[/Horisont]]
| Debian Squeeze
| P3 600 MHz (2x)
| 1 GB
| login
|-
| [[/Knakelibrak]]
| Debian Squeeze
| [[/Dell 2650]], Xeon 2.4 GHz (2x)
| 2 GB
| Databases, wiki
|-
| [[/Monty]]
| Debian Squeeze
| [[/Dell 2650]], Xeon 2.0 GHz (2x)
| 2GB
| NMS
|-
| [[/Skrotnisse]]
| Debian Wheezy
| [[/Dell 2650]], Xeon 2.4 GHz (2x) ?
| 2 GB ?
| dev, replacing tvillings tasks
|-
| [[/Snehvit]]
| SLES 9
| [[/SGI Altix]] 350, IA-64 1400 MHz (16x)
| 16 GB
| Heavy things, turned on when needed
|-
| [[/Stemor]]
| Debian Lenny
| [[/SGI Altix]] 350, IA-64 1400 MHz (2x)
| 2 GB
| Mirror
|-
| [[/Tim]]
| Debian Squeeze
| [[/SGI Altix]] 350, IA-64 1400 MHz (2x)
| 2 GB
| www
|-
| [[/Lommel]]
| Debian Wheezy
| Pentium 4 2.80GHz
| 1 GB
| config server, [[rdist]]/puppet
|-
| [[/Mips]]
| Fedora 20
| Core2Quad Q9550 @ 2.83GHz
| 8 GB
|-
| [[/flags]]
| Fedora 20
| Core2Quad Q9550 @ 2.83GHz
| 8 GB
|-
| [[/Mips3]]
| Fedora 20
| Core2Quad Q9550 @ 2.83GHz
| 8 GB
|-
| [[/Mips4]]
| Fedora 20
| Core2Quad Q9550 @ 2.83GHz
| 8 GB
|-
| [[/Mips5]]
| Fedora 20
| Core2Quad Q9550 @ 2.83GHz
| 6 GB
|-
| [[/scrum]]
| CentOS
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| Virtual machine host
|-
| [[/innovation]]
| CentOS
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| minecraftserver
|-
| [[/scrum4]]
| CentOS
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| Virtual machine host
|-
| [[/scrum5]]
| CentOS
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| Virtual machine host
|}

= Workstations =
{| border="1" cellpadding="2" cellspacing="0"
|<tablestyle="font-size:1.0em;">| Machine
| OS Debian
| CPU
| Memory
| Function
|-
| [[/Sprint]]
| Debian Squeeze
| AMD Athlon 64 X2 5000+
| 4GB
| phased out, to be moved to nvg
|-
| [[/Kvikk]]
| Debian Squeeze
| Intel Core2 Duo E7300
| 4GB
| phased out, to be moved to nvg
|-
| [[/Osaka]]
| Windows 7 for games and stuff
| Intel Core2 Duo E8400
| 4GB
|
|-
| [[/Sanctuary]]
| Windows 10 for games and stuff
| intel i7
| 8 GB
|
|-
| [[/Glenda]]
| Plan 9
| AMD Duron 1.3 Ghz
| 512 MB
| None
|-
| [[/Skrott]]
| Debian Lenny
| PowerPC 7450, 800MHz
| 768 MB
| Payment system for [[PVVVV]], lamp
|-
| [[/Tallulah]]
| Debian Linux/Gnu version being tested
| AMD A6 3500 APU (tricore with built in GPU)
| 4GB
| Multimedia machine (connected to television)
|-
| [[/Pirat]]
| Arch (not PVV-setup yet)
| Pentium D 3.0 GHz (2x)
| 2040MB
|
|-
| [[/Doktor]]
| Ubuntu
| Intel Core(TM) i3-2100 3.10Ghz
| 8 GB
|-
| [[/venture]]
| Debian Sid
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| Terminal
|-
| [[/stakeholder]]
| Fedora 20 (Heisenbug)
| Intel core i7-860 2.8 GHz
| 16 GB, 128 GB SSD
| Terminal
|-
| [[/Bull]]
| Debian Sid
| Core2Quad Q9550 @ 2.83GHz
| 8GB
|}

= Other =

The following machines have rather specialized functions, and/or are so fragile that they are not recommended for ordinary use.

{| border="1" cellpadding="2" cellspacing="0"
|<tablestyle="font-size:1.0em;">| Machine
| OS
| Hardware
| Memory
| Function
|-
| [[/Dvask]]
| NetBSD
| MicroVAX II
|
| DNS
|-
| [[/Asgard]]
| Debian
| P3 800 Mhz (2x)
|
| Kerberos KDC
|-
| [[/Midgard]]
| Debian
| P3 800 Mhz (2x)
|
| Kerberos KDC backup?
|-
| [[/Nosferatu]]
| FreeBSD
| AMD64
|
| comes in the night and sucks data out of decibel
|-
| [[/Onyx]]
| FreeBSD
| [[/Dell 2650]]
|
| Loghost
|-
| [[Kofi]]
| Fedora-based Linux
| AMD Geode (XO-1)
|
| Takes images of [[Annan]]
|-
| [[/Vrimmel]]
| Debian Lenny
| [[/Dell 2650]], Xeon 2.4 GHz (2x)
|
| Host for virtual machines (Xen)
|-
| [[Annan]]
| Simple circuit board and buttons
| Boilerplate with variable effect
|
| Makes coffee under the supervision of [[Kofi]]
|-
| [[Lemming]]
| Green tea
| Glass flask, ca 1 liter memory
|
| Used to make hot drinks with lemming taste. Ascendant of Lemming.
|-
| [[Commodore]]
| Simple circuit board, buttons and capsule lever
| 19bar pump, 1 liter homeopathic memory on the backside and collection grate
|
| Makes espresso of nespresso capsules and water. MAGIC!
|-
| [[/Alice]]
| Debian Squeeze
| Intel Pentium 4 something (1x)
| 2 GB
| Mirror and torrents
|-
| [[Tardis]]
| Time and Relative Dimension in Space
| Wood and paint
|
| Made to lure Who-fans to PVV during the matriculation. Currently stands as decoration.
|}

= Phased out machines =
* [[/Enron]] - userweb (at least that was the plan)
* [[/HB]] - FreeBSD6 on x86 - DVD
* India
* Mu - Something on HPPA - has pains in its disc.
* Peridexion - Coffee table (related to storm)
* [[/Sapiens]] - Ubuntu GNU/Linux on x86
* [[/Storm]] - SGI Callenge L that runs IRIX 6.5, suffers from POKB-fault
* Voldsboks2
* ... - Altund had a box up to 2007(?)
* ... - Nabla had a box up to 2007

Server machines:

{| border="1" cellpadding="2" cellspacing="0"
|<tablestyle="font-size:1.0em;">| Machine
| OS
| CPU
| Memory
| Function
|-
| [[/Berners-Lee]]
| Debian Lenny
| IA-64 733 MHz (2x)
| 2 GB
| www
|-
| [[/Baird]]
| Ubuntu Edgy
| AMD XP 1800+
| 512 MB
| Media center (under the TV), often off
|-
| [[/Egg]]
| Debian Etch
| P3 600 MHz (2x)
| 1 GB
| Development? Currently has pains in its disc.
|-
| [[/Inti]]
| FreeBSD 7.1
| UltraSPARC II (4x)
| 4 GB
| Pushes torrents
|-
| [[/Verden]]
| FreeBSD
| ?
| ?
| anonymous FTP
|-
| [[/Bacchus]]
| FreeBSD
| x86
| DHCP, DNS, tftp, old and bitter
|-
| [[/Brutus]]
| Solaris 9
| Sun Sparcstation 20?
| YP-slave
|-
| [[/Malina]]
| Solaris 10
| Sun Enterprise 250
| YP-master
|-
| [[/Kvartett]]
| VMS
| [[AlhpaServer]] 4100
| Mysterious and unfathomable
|-
| [[/Octopus]]
| NetBSD
| x86
| used as a serial console machine
|-
| [[/Rymden]]
| NetBSD
| x86
| cross compilation to VAX
|-
| [[/Echelon]]
| Trustix
| x86
| Loghost
|-
| [[/Herakles]]
| Debian
| x86
| (very lonely) Kerberos KDC
|-
| [[/Decibel]]
| Ubuntu Hardy
| AMD Opteron 1800 MHz (2x)
| 4 GB
| Former disc and mail
|-
| [[/Flode]]
| Debian Squeeze
| Xeon 2.8 GHz (2x)
| 6 GB
| Is dead and lies on the shelf in the recreation room
|-
| [[/Hingst]]
|colspan="2" |
| 64 MB
| Laser printer
|-
| [[/Tvilling]]
| Debian Squeeze
| P3 800 MHz (2x)
| 512 MB
| bitlbee, misc. services
|-
|}

Workstations:

{| border="1" cellpadding="2" cellspacing="0"
|<tablestyle="font-size:1.0em;">| Machine
| OS
| CPU
| Memory
| Function
|-
| [[/Amaterasu]]
| Solaris 10
| Ultrasparc II 400 MHz (2x)
| 2 GB
| Sun Enterprise 250, yp-slave
|-
| [[/Grubgrub]]
| Debian Lenny
| AMD 1 GHz
| 512 MB
|
|-
| [[/Kobben]]
| Gentoo
| AMD 1.8 GHz
| 512 MB
|
|-
| [[/Kremt]]
| Debian Lenny
| AMD XP 1700+
| 512 MB
|
|-
| [[/Olympic]]
| Debian Etch
| IA-64 733 MHz (2x)
| 2 GB
|-
| [[/Spiralis]]
| Windows 7
| AMD Phenom(tm) II X4 955
| 4 GB
|-
| [[/Lysfontene]]
| Some misc: Debian, Mint and Ubuntu-studio
| Intel Core 2 duo E7300 ?
| 4 - 6 GiB
| workstation
|-
| [[/Nissen]]
| Ubuntu Karmic
| AMD XP 1800+
| 512 MB
|}

Machines that weren't maintained by PVV.
* Fire (aka mumegw) - MUD-thing
* [[/Vaffeljern|Waffle toaster]] - NTNUI Dans (No longer at PVV)
* Voldsboks (aka grimne, mume) - MUD-thing
* Yuriko (aka poy.no) - alfborge, hosting of dancing films

__NOTOC__

Programvareverkstedet

2016-06-07T08:25:45Z

Knuta: /* Driftsmeldinger */

[[#English summary]]

[[#Programvareverkstedet|English]]

Velkommen til [[Programvareverkstedet]]s wiki. Programvareverkstedet (PVV) er en studentorganisasjon ved Norges Teknisk-Naturvitenskapelige Universitet (NTNU). PVVs formål er å skape et miljø for datainteresserte personer tilknyttet universitetet. Nåværende og tidligere studenter ved NTNU, samt ansatte ved NTNU og tilstøtende miljø, kan bli medlemmer.

__NOTOC__

== Kommende arrangementer ==
''Kursplanen kan endre seg i løpet av semesteret.'' [https://www.google.com/calendar/embed?src=320i50h1jg3as29imatatn1j4g%40group.calendar.google.com&ctz=Europe/Oslo Google Calendar] [https://www.google.com/calendar/ical/320i50h1jg3as29imatatn1j4g%40group.calendar.google.com/public/basic.ics Google .ics]

* 25. februar: [[Kurs/PostScript (2015)|PostScript Kurs]] av Anders Christensen (18:15 - F3)
* 9. mars: [https://kurs.pvv.ntnu.no/events/event/2 Raspberry Pi Kurs] av Finn I. Holme (18:15 - Drivhuset) - Påmelding nødvendig!
* 15. mars: [https://kurs.pvv.ntnu.no/events/event/3 Vulkan Presentation] av Andreas Danner Nilsen (18:15 - F6) ( [[https://www.pvv.ntnu.no/pvv/Kurs/Vulkan_(presentasjon)_(2015) Slides]] )
* 14. april: [https://kurs.pvv.ntnu.no/events/event/4 Kurs i C] av Torje Digernes (18:15 - F3)

<big><big>Lyst å holde kurs neste semester? Ta kontakt med styret@</big></big>

== Driftsmeldinger ==
{{LOCALMOTD}}

== Steder å starte ==
* [[Medlem|Medlemsfordeler]]: Fordeler med å være medlem i PVV.
* [[Medlemskontingent]]: Hvordan betale kontingent.
* [[Medlemssider]]: Hjemmesidene til medlemmer i PVV.
* [[Dokumentasjon]]: Oppskrifter på ting brukere kan gjøre på PVV.
* [[Drift]]: Dokumentasjon til (potensielle) driftere.
* [http://list.pvv.ntnu.no/ Epost-lister]
* [[Styrehandlinger]]: Styrets huskeliste for å gjøre enkelte handlinger.
* [[Historie]]: PVVs historie og historiske anekdoter fra NTNU, NTH, Gløshaugen, et cetera.
* [[Programvareutvikling]]: Hvordan utvikle (forhåpentlig god) programvare på en god måte.
* [[Bokhyllen]]: Bøker i PVVs bokhylle.
* [[Spill]]: Spill PVV har (brettspill, kortspill, rollespill...)
* [[Kurs]]: PVV arrangerer kurs i ny og ne, og i forbindelse med de fleste kursene legges det ut litt materiale på nett.
* [[Maskiner]]: Oversikt over PVVs maskinpark.
* [[Søsterorganisasjoner]]: PVV-ekvivalenter ved andre universiteter.
* [[Nerdepizza]]: Nerder samles på Peppes og spiser pizza fredager i partallsuker.
* [[PVVI]]: Idrettsforeningen.
* [[Mat]]: De fleste PVV-ere inntar dette jevnlig.

== Redigering av wikien ==
* [[WikiSandKasse]]: Eksperimenter selv med å redigere en wikiside

* [http://meta.wikimedia.org/wiki/Help:Editing SyntaxReference]: Bli vant med markeringsspråket


== English summary ==
Welcome to the wiki of Programvareversktedet (PVV). Programvareverkstedet (Literally The software workshop) is a student organization for students interested in computers at NTNU. Anyone who is or has been a student at NTNU, and people either working at or is associated with NTNU, can become a member.

Most of PVV's information is only available in Norwegian. This is natural, since most of our members speak Norwegian.
We however wish to emphasize that students and others who are not fluent in Norwegian are very welcome to join our club.
Hopefully, more information on this wiki will be translated into English in the future. If there is any one particular page you want translated into English, or a piece of information important to you which is only available in Norwegian, please contact user andreao.

=== Editing the wiki ===
* [[WikiSandKasse]]: Experiment with creating wiki pages here
* [http://meta.wikimedia.org/wiki/Help:Editing SyntaxReference]: Get used to the markup

= Programvareverkstedet =
Welcome to [[Programvareverkstedet]]'s wiki. Programvareverkstedet (PVV, The Software Workshop) is a student organization at the Norwegian University of Science and Technology (NUST/NTNU). PVV's purpose is to create an environment for people that take an interest in computers and are connected to the university. Current and former students at NUST, and employees at NUST and related environments, can be members.

== Messages from the administration ==
{{LOCALMOTD}}

== Places to start ==
* [[Medlem|Member benefits]]: Benefits of being a member of PVV.
* [[Medlemskontingent|Memersip fee]]: How to pay the membership fee.
* [[Medlemssider|Member's pages]]: Homepages of PVV's members.
* [[Dokumentasjon|Documentation]]: Recipes for things users can do at PVV.
* [[Drift|Administration]]: Documentation for (potential) administrators.
* [http://list.pvv.ntnu.no/ Mailing lists]
* [[Styrehandlinger|Board actions]]: The boards list for remembering to perform some simple actions.
* [[Historie|History]]: PVV's history and historical anecdotes from NUST, NTH, Gløshaugen, etc.
* [[Programvareutvikling|Software development]]: How to develop (hopefully good) software in a good way.
* [[Bokhyllen|The Bookshelf]]: Books in PVV's bookshelf.
* [[Spill|Games]]: Games PVV has (board games, card games, role playing games...)
* [[Kurs|Courses]]: PVV arranges courses from time to time, and in relation to most of them some material is published online.
* [[Maskiner|Machines]]: Overview of PVV's machine park.
* [[Søsterorganisasjoner|Sister organizations]]: PVV-equivalents at other universities.
* [[Nerdepizza|Nerd Pizza]]: Nerds gather at Peppes and eat pizza in even numbered weeks.
* [[PVVI]]: The sports association.
* [[Mat|Food]]: Most PVV-ers consume this regularly.

== Edditing the wiki ==
* [[WikiSandKasse|Wiki sand box]]: Experiment by editing a wiki page.

* [http://meta.wikimedia.org/wiki/Help:Editing SyntaxReference]: Get used to the markup language.

Programvareverkstedet

2016-06-07T08:25:33Z

Knuta: /* Driftsmeldinger */

[[#English summary]]

[[#Programvareverkstedet|English]]

Velkommen til [[Programvareverkstedet]]s wiki. Programvareverkstedet (PVV) er en studentorganisasjon ved Norges Teknisk-Naturvitenskapelige Universitet (NTNU). PVVs formål er å skape et miljø for datainteresserte personer tilknyttet universitetet. Nåværende og tidligere studenter ved NTNU, samt ansatte ved NTNU og tilstøtende miljø, kan bli medlemmer.

__NOTOC__

== Kommende arrangementer ==
''Kursplanen kan endre seg i løpet av semesteret.'' [https://www.google.com/calendar/embed?src=320i50h1jg3as29imatatn1j4g%40group.calendar.google.com&ctz=Europe/Oslo Google Calendar] [https://www.google.com/calendar/ical/320i50h1jg3as29imatatn1j4g%40group.calendar.google.com/public/basic.ics Google .ics]

* 25. februar: [[Kurs/PostScript (2015)|PostScript Kurs]] av Anders Christensen (18:15 - F3)
* 9. mars: [https://kurs.pvv.ntnu.no/events/event/2 Raspberry Pi Kurs] av Finn I. Holme (18:15 - Drivhuset) - Påmelding nødvendig!
* 15. mars: [https://kurs.pvv.ntnu.no/events/event/3 Vulkan Presentation] av Andreas Danner Nilsen (18:15 - F6) ( [[https://www.pvv.ntnu.no/pvv/Kurs/Vulkan_(presentasjon)_(2015) Slides]] )
* 14. april: [https://kurs.pvv.ntnu.no/events/event/4 Kurs i C] av Torje Digernes (18:15 - F3)

<big><big>Lyst å holde kurs neste semester? Ta kontakt med styret@</big></big>

== Driftsmeldinger ==
{{LOCALMOTD}}
x

== Steder å starte ==
* [[Medlem|Medlemsfordeler]]: Fordeler med å være medlem i PVV.
* [[Medlemskontingent]]: Hvordan betale kontingent.
* [[Medlemssider]]: Hjemmesidene til medlemmer i PVV.
* [[Dokumentasjon]]: Oppskrifter på ting brukere kan gjøre på PVV.
* [[Drift]]: Dokumentasjon til (potensielle) driftere.
* [http://list.pvv.ntnu.no/ Epost-lister]
* [[Styrehandlinger]]: Styrets huskeliste for å gjøre enkelte handlinger.
* [[Historie]]: PVVs historie og historiske anekdoter fra NTNU, NTH, Gløshaugen, et cetera.
* [[Programvareutvikling]]: Hvordan utvikle (forhåpentlig god) programvare på en god måte.
* [[Bokhyllen]]: Bøker i PVVs bokhylle.
* [[Spill]]: Spill PVV har (brettspill, kortspill, rollespill...)
* [[Kurs]]: PVV arrangerer kurs i ny og ne, og i forbindelse med de fleste kursene legges det ut litt materiale på nett.
* [[Maskiner]]: Oversikt over PVVs maskinpark.
* [[Søsterorganisasjoner]]: PVV-ekvivalenter ved andre universiteter.
* [[Nerdepizza]]: Nerder samles på Peppes og spiser pizza fredager i partallsuker.
* [[PVVI]]: Idrettsforeningen.
* [[Mat]]: De fleste PVV-ere inntar dette jevnlig.

== Redigering av wikien ==
* [[WikiSandKasse]]: Eksperimenter selv med å redigere en wikiside

* [http://meta.wikimedia.org/wiki/Help:Editing SyntaxReference]: Bli vant med markeringsspråket


== English summary ==
Welcome to the wiki of Programvareversktedet (PVV). Programvareverkstedet (Literally The software workshop) is a student organization for students interested in computers at NTNU. Anyone who is or has been a student at NTNU, and people either working at or is associated with NTNU, can become a member.

Most of PVV's information is only available in Norwegian. This is natural, since most of our members speak Norwegian.
We however wish to emphasize that students and others who are not fluent in Norwegian are very welcome to join our club.
Hopefully, more information on this wiki will be translated into English in the future. If there is any one particular page you want translated into English, or a piece of information important to you which is only available in Norwegian, please contact user andreao.

=== Editing the wiki ===
* [[WikiSandKasse]]: Experiment with creating wiki pages here
* [http://meta.wikimedia.org/wiki/Help:Editing SyntaxReference]: Get used to the markup

= Programvareverkstedet =
Welcome to [[Programvareverkstedet]]'s wiki. Programvareverkstedet (PVV, The Software Workshop) is a student organization at the Norwegian University of Science and Technology (NUST/NTNU). PVV's purpose is to create an environment for people that take an interest in computers and are connected to the university. Current and former students at NUST, and employees at NUST and related environments, can be members.

== Messages from the administration ==
{{LOCALMOTD}}

== Places to start ==
* [[Medlem|Member benefits]]: Benefits of being a member of PVV.
* [[Medlemskontingent|Memersip fee]]: How to pay the membership fee.
* [[Medlemssider|Member's pages]]: Homepages of PVV's members.
* [[Dokumentasjon|Documentation]]: Recipes for things users can do at PVV.
* [[Drift|Administration]]: Documentation for (potential) administrators.
* [http://list.pvv.ntnu.no/ Mailing lists]
* [[Styrehandlinger|Board actions]]: The boards list for remembering to perform some simple actions.
* [[Historie|History]]: PVV's history and historical anecdotes from NUST, NTH, Gløshaugen, etc.
* [[Programvareutvikling|Software development]]: How to develop (hopefully good) software in a good way.
* [[Bokhyllen|The Bookshelf]]: Books in PVV's bookshelf.
* [[Spill|Games]]: Games PVV has (board games, card games, role playing games...)
* [[Kurs|Courses]]: PVV arranges courses from time to time, and in relation to most of them some material is published online.
* [[Maskiner|Machines]]: Overview of PVV's machine park.
* [[Søsterorganisasjoner|Sister organizations]]: PVV-equivalents at other universities.
* [[Nerdepizza|Nerd Pizza]]: Nerds gather at Peppes and eat pizza in even numbered weeks.
* [[PVVI]]: The sports association.
* [[Mat|Food]]: Most PVV-ers consume this regularly.

== Edditing the wiki ==
* [[WikiSandKasse|Wiki sand box]]: Experiment by editing a wiki page.

* [http://meta.wikimedia.org/wiki/Help:Editing SyntaxReference]: Get used to the markup language.

Drift/Salt

2016-06-07T08:22:59Z

Knuta: /* Installasjon */

Salt er et system for å distribuere filer og sørge for at maskiner har samme oppsett. Etter at vi satte opp versjonskontroll via git lokalt på lommel er det nødvenidg å gå gjennom oppsettet beskrevet i [[Drift/Salt#Gjøre endringer|Gjøre endringer]]-avsnittet før man kan bidra til å endre salt-oppsettet til PVV.

== Sette opp ny salt minion ==

=== Installasjon ===
<pre>
ny-minion# wget -O - https://www.pvv.ntnu.no/salt/salt-setup.sh | bash
ny-minion# rediger /etc/salt/grains og legg til gruppene maskinen er i, se dokumentasjonen for [[Drift/Salt#Grains|grains (grupper)]]
ny-minion# service salt-minion restart
ny-minion$# ssh root@salt.pvv.ntnu.no
salt-master$ sudo salt-key -L
salt-master$ sudo salt-key -a ny-minion.pvv.ntnu.no
ny-minion# salt-call saltutil.sync_grains
ny-minion# salt-call state.highstate saltenv=base pillarenv=base
</pre>

Hvis alt har har gått bra, vil pingtesten gi true for maskinen din nå. Hvis ikke, kjør <code><nowiki>service salt-minion status</nowiki></code> som root på din nye minion for å få hint om hva som er galt. Konfigurasjonsfilen til salt ligger i <code><nowiki>/etc/salt/minion</nowiki></code>.

I tilfellet man endrer hostname på en minion, gjør følgende for å få det oppdatert i salt: Stop salt-minion på den berørte maskinen. Slett nøkkelen til maskinen fra salt-master ved å kjøre <code><nowiki>salt-key -d minion_id</nowiki></code> på salt-masteren. Slett <code><nowiki>/etc/salt/minion/minion_id</nowiki></code>. Start salt-minion service-en. Autoriser den nye nøkkelen med det nye navnet i salt-master.

Husk å legge nyoppsatte maskiner til i riktige [[Drift/Salt#Grains|grains (grupper)]].

== Gjøre endringer ==

Endringer gjøres på salt-masteren (salt.pvv.ntnu.no, som for tiden peker på lommel.pvv.ntnu.no). Alle endringer gjøres som din personlige bruker.

=== Opprette bruker på salt-masteren ===
Om du ikke har en bruker, logg inn som root på serveren og lag en. Adduser vil spørre deg om «Current Kerberos password», men du kan bare trykke enter og si nei til å prøve igjen, så fungerer det fint. Legg også brukeren til i sudo-gruppen.

<pre>
lommel ~ # adduser johndoe && adduser johndoe sudo
Adding user `johndoe' ...
Adding new group `johndoe' (1000) ...
Adding new user `johndoe' (1000) with group `johndoe' ...
Current Kerberos password:
Current Kerberos password:
passwd: Authentication token manipulation error
passwd: password unchanged
Try again? [y/N] n
Changing the user information for johndoe
Enter the new value, or press ENTER for the default
Full Name []: John Doe
Room Number []:
Work Phone []:
Home Phone []:
Other []:
Is the information correct? [Y/n]
</pre>

Passordet du bruker vil være det samme som admin-principalen din i Kerberos har, altså johndoe/admin i eksempelet over. Om du ikke har en admin-principal, se [[Drift/Kerberos#Lage_admin-principal]].

=== Gjøre endringer ===

Når du logger inn første gang vil du automatisk få sjekket ut salt-treet i ~/salt. Gjør endringene dine der inne, og push master til origin for å aktivere endringene.

Det kan være lurt å teste med en maskin først, ved å logge inn på den og gjøre en dry-run (du kan kjøre kommandoer rett fra salt-masteren også, men det er uansett en fordel å ha et skall på maskinen i tilfelle noe går galt):

<pre>
salt-call state.highstate test=True
</pre>

==== Teste endringer før commit ====

PVV har et lite triks som oppretter et salt-environment [https://docs.saltstack.com/en/latest/ref/states/top.html#multiple-environments] for hver bruker. Dette gjør at du kan teste koden din på en minion uten å committe. Det gjør du slik:

<pre>
salt-call state.highstate saltenv="$LOGNAME" test=True
</pre>

== Grains ==
Salt kan bruke grains for å gjøre noe på en gruppe med maskiner. <code><nowiki>salt 'hostname*' grains.items</nowiki></code> viser alle grains hostname er med i. For eksempel kan man si <code><nowiki>salt -G 'os_familt:Debian' test.ping</nowiki></code> for å pinge maskiner som er basert på Debian.

For å legge en minion til en gruppe gjør følgende på minion-en:

=== Konfigurasjon ===
<pre>$ vim /etc/salt/grains

roles:
- standard
- desktop
</pre>

I skrivende stund har vi følgende roller:

{|
|standard
|Alle maskiner med standard-oppsett (det vil si at brukere kan logge inn der)
|-
|desktop
|Desktopmaskiner
|-
|file-server
|Filservere, som f.eks. microbel.
|-
|mysql-server
|MySQL-serveren
|-
|postgresql-server
|PostGreSQL-serveren
|-
|web-frontend
|Web-frontend (ikke den som hoster brukerenes hjemmesider)
|-
|web-homes
|Web-backend for brukeres hjemmesider
|-
|fwlogin
|Maskinen lytter på SSH på port 80 og 443
|-
|salt-master
|salt-masteren (skal ikke ha standardoppsett)
|}

Når minions har blitt lagt til i roller er det viktig å huske på å synkronisere disse med masteren. Den letteste måten å gjøre det på er å kjøre <code><nowiki>salt '*' saltutil.sync_grains</nowiki></code> fra salt-masteren.

For å nå maskiner gjennom egendefinerte grains bruk <code><nowiki>salt -G 'attributt:verdi' kommando</nowiki></code>. Et eksempel er <code><nowiki>salt -G 'roles:workstation' test.ping</nowiki></code>.

== Tekniske ting ==

Litt nyttig info om hvordan ting fungerer under panseret

=== Distribuere mapper ===

Lag en overordnet mappe som inneholder både mappen du ønsker å distribuere og en sls-fil i salt-mappen: <code><nowiki>/srv/salt/overordnet_mappe</nowiki></code>. Der legger du mappen du ønsker å distribuere, og lager en fil du kaller for <code><nowiki>init.sls</nowiki></code>. Den formateres slik:

<pre><nowiki>
/path/til/der/du/vil/at/mappen/skal/ende/opp/på/minions
file.recurse:
- source: salt://overornet_mappe/mappen_du_vil_distribuere
#optional felter:
- include_empty: True #sørger for at tomme undermapper kommer med
- dir_mode: 777 #må bruke dir_mode når man dister mapper, bruk mode: hvis du dister filer
- user: brukernavn #hilken bruker skal mappen, undermapper og filer tilhøre
- group: eall_s #default-gruppen er root. Skal mappen tilhøre noen andre bruk eall_s eksplisitt
</nowiki></pre>

For å så få distribuert mappen kjør følgende kommando: <code><nowiki>salt '*' state.sls overordnet_mappe</nowiki></code>

=== States og håndheving ===

Salt oppererer med SLS filer (SaLt State) for å holde orden på reglene for distribusjon og hvordan disse skal håndheves. Legg SLS filene i <code><nowiki>/srv/salt/</nowiki></code>. En av de viktigste SLS filene er <code><nowiki>/srv/salt/top.sls</nowiki></code> da den spesifiserer hvilke SLS filer som skal anvendes på hvilke minions. (Alle sls-filene er på salt-master.)

For eksempel hvis vi har SLS filene:
<pre>
/srv/salt/top.sls
/srv/salt/common/init.sls
/srv/salt/common/packages.sls
/srv/salt/sl_eksempel.sls
</pre>

La så filene se slik ut:
<pre>
#top.sls:
base:
'*':
- common
'roles:desktop':
- match: grain
- sl_eksempel
</pre>
<pre>
#common/init.sls:
include:
- common.packages
</pre>
<pre>
#common/packages.sls:
vim:
pkg:
- installed
grep:
pkg:
- installed
</pre>
<pre>
#sl_eksempel.sls:
sl:
pkg:
- installed
</pre>

Hva filene sier:
* <code><nowiki>top.sls</nowiki></code> sier at at alle maskiner skal få staten som er spesifisert i 'common'. Siden 'common' er en mappe og ikke en SLS fil vil det implisitt bety at staten som er gitt i <code><nowiki>common/init.sls</nowiki></code> brukes istedenfor.
** Den sier også at alle maskiner som matcher grainen <code><nowiki>roles:desktop</nowiki></code> skal ha staten spesifisert i <code><nowiki>sl_eksempel.sls</nowiki></code>
* <code><nowiki>common/init.sls</nowiki></code> starter med å ved includen si at alt som er i <code><nowiki>/srv/salt/common/packages</nowiki></code> også skal kjøres i tillegg til innholdet den har (som for dette eksempelet er ikke noe mer)
* <code><nowiki>packages.sls</nowiki></code> sier at to pakker, vim og grep, skal være installert på alle maskiner som hører til staten.
* <code><nowiki>sl_eksempel.sls</nowiki></code> sier at pakken sl skal være installert.

For at minionsene skal gå inn å sjekke hvilke states de skal ha, og anvende dem, kjør: 
<code><nowiki>salt '*' state.highstate</nowiki></code> 
på salt-master.

=== Sørg for at Salt-minion er kjørende og at den jevnlig poller om nye ting fra master ===

Lag en mappe <code><nowiki>/srv/salt/minion_configuration</nowiki></code> som inneholder en <code><nowiki>init.sls</nowiki></code> fil og en <code><nowiki>minion</nowiki></code> fil. La <code><nowiki>init.sls</nowiki></code> se slik ut:

<pre>
salt-minion: # sier at det er salt-minion servicen vi påvirker
service:
# sier at den skal være kjørende:
- running
- enable: True
# sier at servicen skal restartes om man merker en endring i den oppgitte filen:
- watch:
- file /etc/salt/minion
/etc/salt/minion: #sier at denne filen skal speile den oppgitte fra master
file.managed:
# filen som skal kopieres over til minionen
- source salt://minion_configuration/minion
# bruker, gruppe, og premissions for filen når den ender opp på minionen:
- user: root
- group: root
- mode: 644
# sier at filen er et jinjatemplate, og at variablene i templatet skal byttes ut
# med verdiene gitt for dem i context-seksjonen:
- template: jinja
- context:
saltmaster: lommel.pvv.ntnu.no
timer: 4
</pre>

Kopier så inn en minion-fil til <code><nowiki>/srv/salt/minion_configuration/minion</nowiki></code>, og legg til disse linjene:

<pre>
#sett inn under "#master: salt" eller istedenfor det som måtte stå på på linjen som begynner med "master:"
master: {{saltmaster}}

#sier at highstate skal schedules til å kjøre hver 'timer' time:
schedule:
highstate:
function: state.highstate
hours: {{ timer }}
</pre>

== Behandlig av errors og feilmeldinger som kan dukke opp ofte ==

=== No Top file or external nodes data matches found ===

Om salt sier dette:

<pre>
ID: states
Function: no.None
Result: False
Comment: No Top file or external nodes data matches found
Started:
Duration:
Changes:
</pre>

Betyr det sannsynligvis at du har glemt å sette noen roller i [[#Grains|/etc/salt/grains]]

=== UnicodeDecodeError ===

Hvis du får «UnicodeDecodeError: 'ascii' codec can't decode byte 0xc2 in position 99: ordinal not in range» eller lignende kommer dette av en kjent feil i Salt: https://github.com/saltstack/salt/issues/16139

Dette skjer mye oftere om du har gammel salt. Prøv dette:

<pre>
echo deb http://debian.saltstack.com/debian $(lsb_release -c | awk '{print $2}')-saltstack main > /etc/apt/sources.list.d/saltstack.list
aptitude update && aptitude dist-upgrade
</pre>

=== No matching sls found ===
Hvis du får feilen: 
<code><nowiki>No matching sls found for 'sls_file_or_folder_name' in env 'base'</nowiki></code> 
Så har du sannsynligvis skrevet <code><nowiki>filnavn.sls</nowiki></code> (må være uten <code><nowiki>.sls</nowiki></code>), eller mappenavnet feil.

== Nyttige kommandoer og syntax ==

Viktig om syntax:
* All indentering er med mellomrom da tabs ser ut til å krasje, to ser ut til å være standard

Hvordan kopiere enkeltfiler ad-hoc fra salt-master til minions: 
<code><nowiki>salt-cp "*" /path/to/file/on/salt/master /path/to/file/on/minions</nowiki></code>

Hvordan kjøre kode på minions: 
<code><nowiki>salt "*" cmd.run "ps -e | grep salt"</nowiki></code>

For å kjøre på enkeltmaskiner istedenfor alle eller grains skriv inn navnet istedenfor <code><nowiki>"*"</nowiki></code>. Eksempel: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no cmd.run "ps -e | grep salt"</nowiki></code>

For å sjekke om en pakke er installer og hvilken versjon den har: 
<code><nowiki>salt "*" pkg.version "grep"</nowiki></code>

For å installere eller oppgradere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.install sl</nowiki></code>

For å avinstallere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.remove sl</nowiki></code>

For å se salt-pkg kommandoer: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.</nowiki></code> og spam tab.

Drift/Salt

2016-05-30T06:51:13Z

Knuta: /* Installasjon */

Salt er et system for å distribuere filer og sørge for at maskiner har samme oppsett. Etter at vi satte opp versjonskontroll via git lokalt på lommel er det nødvenidg å gå gjennom oppsettet beskrevet i [[Drift/Salt#Gjøre endringer|Gjøre endringer]]-avsnittet før man kan bidra til å endre salt-oppsettet til PVV.

== Sette opp ny salt minion ==

=== Installasjon ===
<pre>
ny-minion$ wget -O - https://www.pvv.ntnu.no/salt/salt-setup.sh | bash
ny-minion$ rediger /etc/salt/grains og legg til gruppene maskinen er i, se dokumentasjonen for [[Drift/Salt#Grains|grains (grupper)]]
ny-minion$ service salt-minion restart
ny-minion$ ssh root@salt.pvv.ntnu.no
salt-master# salt-key -L
salt-master# salt-key -a hostname.pvv.ntnu.no
salt-master# salt hostname.pvv.ntnu.no saltutil.sync_grains
salt-master# salt hostname.pvv.ntnu.no state.sls minion_configuration
ny-minion$ salt-call state.highstate saltenv=base pillarenv=base
</pre>

Hvis alt har har gått bra, vil pingtesten gi true for maskinen din nå. Hvis ikke, kjør <code><nowiki>service salt-minion status</nowiki></code> som root på din nye minion for å få hint om hva som er galt. Konfigurasjonsfilen til salt ligger i <code><nowiki>/etc/salt/minion</nowiki></code>.

I tilfellet man endrer hostname på en minion, gjør følgende for å få det oppdatert i salt: Stop salt-minion på den berørte maskinen. Slett nøkkelen til maskinen fra salt-master ved å kjøre <code><nowiki>salt-key -d minion_id</nowiki></code> på salt-masteren. Slett <code><nowiki>/etc/salt/minion/minion_id</nowiki></code>. Start salt-minion service-en. Autoriser den nye nøkkelen med det nye navnet i salt-master.

Husk å legge nyoppsatte maskiner til i riktige [[Drift/Salt#Grains|grains (grupper)]].

== Gjøre endringer ==

Endringer gjøres på salt-masteren (salt.pvv.ntnu.no, som for tiden peker på lommel.pvv.ntnu.no). Alle endringer gjøres som din personlige bruker.

=== Opprette bruker på salt-masteren ===
Om du ikke har en bruker, logg inn som root på serveren og lag en. Adduser vil spørre deg om «Current Kerberos password», men du kan bare trykke enter og si nei til å prøve igjen, så fungerer det fint. Legg også brukeren til i sudo-gruppen.

<pre>
lommel ~ # adduser johndoe && adduser johndoe sudo
Adding user `johndoe' ...
Adding new group `johndoe' (1000) ...
Adding new user `johndoe' (1000) with group `johndoe' ...
Current Kerberos password:
Current Kerberos password:
passwd: Authentication token manipulation error
passwd: password unchanged
Try again? [y/N] n
Changing the user information for johndoe
Enter the new value, or press ENTER for the default
Full Name []: John Doe
Room Number []:
Work Phone []:
Home Phone []:
Other []:
Is the information correct? [Y/n]
</pre>

Passordet du bruker vil være det samme som admin-principalen din i Kerberos har, altså johndoe/admin i eksempelet over. Om du ikke har en admin-principal, se [[Drift/Kerberos#Lage_admin-principal]].

=== Gjøre endringer ===

Når du logger inn første gang vil du automatisk få sjekket ut salt-treet i ~/salt. Gjør endringene dine der inne, og push master til origin for å aktivere endringene.

Det kan være lurt å teste med en maskin først, ved å logge inn på den og gjøre en dry-run (du kan kjøre kommandoer rett fra salt-masteren også, men det er uansett en fordel å ha et skall på maskinen i tilfelle noe går galt):

<pre>
salt-call state.highstate test=True
</pre>

==== Teste endringer før commit ====

PVV har et lite triks som oppretter et salt-environment [https://docs.saltstack.com/en/latest/ref/states/top.html#multiple-environments] for hver bruker. Dette gjør at du kan teste koden din på en minion uten å committe. Det gjør du slik:

<pre>
salt-call state.highstate saltenv="$LOGNAME" test=True
</pre>

== Grains ==
Salt kan bruke grains for å gjøre noe på en gruppe med maskiner. <code><nowiki>salt 'hostname*' grains.items</nowiki></code> viser alle grains hostname er med i. For eksempel kan man si <code><nowiki>salt -G 'os_familt:Debian' test.ping</nowiki></code> for å pinge maskiner som er basert på Debian.

For å legge en minion til en gruppe gjør følgende på minion-en:

=== Konfigurasjon ===
<pre>$ vim /etc/salt/grains

roles:
- standard
- desktop
</pre>

I skrivende stund har vi følgende roller:

{|
|standard
|Alle maskiner med standard-oppsett (det vil si at brukere kan logge inn der)
|-
|desktop
|Desktopmaskiner
|-
|file-server
|Filservere, som f.eks. microbel.
|-
|mysql-server
|MySQL-serveren
|-
|postgresql-server
|PostGreSQL-serveren
|-
|web-frontend
|Web-frontend (ikke den som hoster brukerenes hjemmesider)
|-
|web-homes
|Web-backend for brukeres hjemmesider
|-
|fwlogin
|Maskinen lytter på SSH på port 80 og 443
|-
|salt-master
|salt-masteren (skal ikke ha standardoppsett)
|}

Når minions har blitt lagt til i roller er det viktig å huske på å synkronisere disse med masteren. Den letteste måten å gjøre det på er å kjøre <code><nowiki>salt '*' saltutil.sync_grains</nowiki></code> fra salt-masteren.

For å nå maskiner gjennom egendefinerte grains bruk <code><nowiki>salt -G 'attributt:verdi' kommando</nowiki></code>. Et eksempel er <code><nowiki>salt -G 'roles:workstation' test.ping</nowiki></code>.

== Tekniske ting ==

Litt nyttig info om hvordan ting fungerer under panseret

=== Distribuere mapper ===

Lag en overordnet mappe som inneholder både mappen du ønsker å distribuere og en sls-fil i salt-mappen: <code><nowiki>/srv/salt/overordnet_mappe</nowiki></code>. Der legger du mappen du ønsker å distribuere, og lager en fil du kaller for <code><nowiki>init.sls</nowiki></code>. Den formateres slik:

<pre><nowiki>
/path/til/der/du/vil/at/mappen/skal/ende/opp/på/minions
file.recurse:
- source: salt://overornet_mappe/mappen_du_vil_distribuere
#optional felter:
- include_empty: True #sørger for at tomme undermapper kommer med
- dir_mode: 777 #må bruke dir_mode når man dister mapper, bruk mode: hvis du dister filer
- user: brukernavn #hilken bruker skal mappen, undermapper og filer tilhøre
- group: eall_s #default-gruppen er root. Skal mappen tilhøre noen andre bruk eall_s eksplisitt
</nowiki></pre>

For å så få distribuert mappen kjør følgende kommando: <code><nowiki>salt '*' state.sls overordnet_mappe</nowiki></code>

=== States og håndheving ===

Salt oppererer med SLS filer (SaLt State) for å holde orden på reglene for distribusjon og hvordan disse skal håndheves. Legg SLS filene i <code><nowiki>/srv/salt/</nowiki></code>. En av de viktigste SLS filene er <code><nowiki>/srv/salt/top.sls</nowiki></code> da den spesifiserer hvilke SLS filer som skal anvendes på hvilke minions. (Alle sls-filene er på salt-master.)

For eksempel hvis vi har SLS filene:
<pre>
/srv/salt/top.sls
/srv/salt/common/init.sls
/srv/salt/common/packages.sls
/srv/salt/sl_eksempel.sls
</pre>

La så filene se slik ut:
<pre>
#top.sls:
base:
'*':
- common
'roles:desktop':
- match: grain
- sl_eksempel
</pre>
<pre>
#common/init.sls:
include:
- common.packages
</pre>
<pre>
#common/packages.sls:
vim:
pkg:
- installed
grep:
pkg:
- installed
</pre>
<pre>
#sl_eksempel.sls:
sl:
pkg:
- installed
</pre>

Hva filene sier:
* <code><nowiki>top.sls</nowiki></code> sier at at alle maskiner skal få staten som er spesifisert i 'common'. Siden 'common' er en mappe og ikke en SLS fil vil det implisitt bety at staten som er gitt i <code><nowiki>common/init.sls</nowiki></code> brukes istedenfor.
** Den sier også at alle maskiner som matcher grainen <code><nowiki>roles:desktop</nowiki></code> skal ha staten spesifisert i <code><nowiki>sl_eksempel.sls</nowiki></code>
* <code><nowiki>common/init.sls</nowiki></code> starter med å ved includen si at alt som er i <code><nowiki>/srv/salt/common/packages</nowiki></code> også skal kjøres i tillegg til innholdet den har (som for dette eksempelet er ikke noe mer)
* <code><nowiki>packages.sls</nowiki></code> sier at to pakker, vim og grep, skal være installert på alle maskiner som hører til staten.
* <code><nowiki>sl_eksempel.sls</nowiki></code> sier at pakken sl skal være installert.

For at minionsene skal gå inn å sjekke hvilke states de skal ha, og anvende dem, kjør: 
<code><nowiki>salt '*' state.highstate</nowiki></code> 
på salt-master.

=== Sørg for at Salt-minion er kjørende og at den jevnlig poller om nye ting fra master ===

Lag en mappe <code><nowiki>/srv/salt/minion_configuration</nowiki></code> som inneholder en <code><nowiki>init.sls</nowiki></code> fil og en <code><nowiki>minion</nowiki></code> fil. La <code><nowiki>init.sls</nowiki></code> se slik ut:

<pre>
salt-minion: # sier at det er salt-minion servicen vi påvirker
service:
# sier at den skal være kjørende:
- running
- enable: True
# sier at servicen skal restartes om man merker en endring i den oppgitte filen:
- watch:
- file /etc/salt/minion
/etc/salt/minion: #sier at denne filen skal speile den oppgitte fra master
file.managed:
# filen som skal kopieres over til minionen
- source salt://minion_configuration/minion
# bruker, gruppe, og premissions for filen når den ender opp på minionen:
- user: root
- group: root
- mode: 644
# sier at filen er et jinjatemplate, og at variablene i templatet skal byttes ut
# med verdiene gitt for dem i context-seksjonen:
- template: jinja
- context:
saltmaster: lommel.pvv.ntnu.no
timer: 4
</pre>

Kopier så inn en minion-fil til <code><nowiki>/srv/salt/minion_configuration/minion</nowiki></code>, og legg til disse linjene:

<pre>
#sett inn under "#master: salt" eller istedenfor det som måtte stå på på linjen som begynner med "master:"
master: {{saltmaster}}

#sier at highstate skal schedules til å kjøre hver 'timer' time:
schedule:
highstate:
function: state.highstate
hours: {{ timer }}
</pre>

== Behandlig av errors og feilmeldinger som kan dukke opp ofte ==

=== No Top file or external nodes data matches found ===

Om salt sier dette:

<pre>
ID: states
Function: no.None
Result: False
Comment: No Top file or external nodes data matches found
Started:
Duration:
Changes:
</pre>

Betyr det sannsynligvis at du har glemt å sette noen roller i [[#Grains|/etc/salt/grains]]

=== UnicodeDecodeError ===

Hvis du får «UnicodeDecodeError: 'ascii' codec can't decode byte 0xc2 in position 99: ordinal not in range» eller lignende kommer dette av en kjent feil i Salt: https://github.com/saltstack/salt/issues/16139

Dette skjer mye oftere om du har gammel salt. Prøv dette:

<pre>
echo deb http://debian.saltstack.com/debian $(lsb_release -c | awk '{print $2}')-saltstack main > /etc/apt/sources.list.d/saltstack.list
aptitude update && aptitude dist-upgrade
</pre>

=== No matching sls found ===
Hvis du får feilen: 
<code><nowiki>No matching sls found for 'sls_file_or_folder_name' in env 'base'</nowiki></code> 
Så har du sannsynligvis skrevet <code><nowiki>filnavn.sls</nowiki></code> (må være uten <code><nowiki>.sls</nowiki></code>), eller mappenavnet feil.

== Nyttige kommandoer og syntax ==

Viktig om syntax:
* All indentering er med mellomrom da tabs ser ut til å krasje, to ser ut til å være standard

Hvordan kopiere enkeltfiler ad-hoc fra salt-master til minions: 
<code><nowiki>salt-cp "*" /path/to/file/on/salt/master /path/to/file/on/minions</nowiki></code>

Hvordan kjøre kode på minions: 
<code><nowiki>salt "*" cmd.run "ps -e | grep salt"</nowiki></code>

For å kjøre på enkeltmaskiner istedenfor alle eller grains skriv inn navnet istedenfor <code><nowiki>"*"</nowiki></code>. Eksempel: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no cmd.run "ps -e | grep salt"</nowiki></code>

For å sjekke om en pakke er installer og hvilken versjon den har: 
<code><nowiki>salt "*" pkg.version "grep"</nowiki></code>

For å installere eller oppgradere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.install sl</nowiki></code>

For å avinstallere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.remove sl</nowiki></code>

For å se salt-pkg kommandoer: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.</nowiki></code> og spam tab.

Drift/Salt

2016-05-30T06:39:39Z

Knuta: /* Installasjon */

Salt er et system for å distribuere filer og sørge for at maskiner har samme oppsett. Etter at vi satte opp versjonskontroll via git lokalt på lommel er det nødvenidg å gå gjennom oppsettet beskrevet i [[Drift/Salt#Gjøre endringer|Gjøre endringer]]-avsnittet før man kan bidra til å endre salt-oppsettet til PVV.

== Sette opp ny salt minion ==

=== Installasjon ===
<pre>
ny-minion$ wget -O - https://www.pvv.ntnu.no/salt/salt-setup.sh | bash
ny-minion$ rediger /etc/salt/grains og legg til gruppene maskinen er i, se dokumentasjonen for [[Drift/Salt#Grains|grains (grupper)]]
ny-minion$ service salt-minion restart
ny-minion$ ssh root@salt.pvv.ntnu.no
salt-master# salt-key -L
salt-master# salt-key -a hostname.pvv.ntnu.no
salt-master# salt hostname.pvv.ntnu.no saltutil.sync_grains
salt-master# salt hostname.pvv.ntnu.no state.sls minion_configuration
ny-minion$ salt-call state.highstate saltenv=base
</pre>

Hvis alt har har gått bra, vil pingtesten gi true for maskinen din nå. Hvis ikke, kjør <code><nowiki>service salt-minion status</nowiki></code> som root på din nye minion for å få hint om hva som er galt. Konfigurasjonsfilen til salt ligger i <code><nowiki>/etc/salt/minion</nowiki></code>.

I tilfellet man endrer hostname på en minion, gjør følgende for å få det oppdatert i salt: Stop salt-minion på den berørte maskinen. Slett nøkkelen til maskinen fra salt-master ved å kjøre <code><nowiki>salt-key -d minion_id</nowiki></code> på salt-masteren. Slett <code><nowiki>/etc/salt/minion/minion_id</nowiki></code>. Start salt-minion service-en. Autoriser den nye nøkkelen med det nye navnet i salt-master.

Husk å legge nyoppsatte maskiner til i riktige [[Drift/Salt#Grains|grains (grupper)]].

== Gjøre endringer ==

Endringer gjøres på salt-masteren (salt.pvv.ntnu.no, som for tiden peker på lommel.pvv.ntnu.no). Alle endringer gjøres som din personlige bruker.

=== Opprette bruker på salt-masteren ===
Om du ikke har en bruker, logg inn som root på serveren og lag en. Adduser vil spørre deg om «Current Kerberos password», men du kan bare trykke enter og si nei til å prøve igjen, så fungerer det fint. Legg også brukeren til i sudo-gruppen.

<pre>
lommel ~ # adduser johndoe && adduser johndoe sudo
Adding user `johndoe' ...
Adding new group `johndoe' (1000) ...
Adding new user `johndoe' (1000) with group `johndoe' ...
Current Kerberos password:
Current Kerberos password:
passwd: Authentication token manipulation error
passwd: password unchanged
Try again? [y/N] n
Changing the user information for johndoe
Enter the new value, or press ENTER for the default
Full Name []: John Doe
Room Number []:
Work Phone []:
Home Phone []:
Other []:
Is the information correct? [Y/n]
</pre>

Passordet du bruker vil være det samme som admin-principalen din i Kerberos har, altså johndoe/admin i eksempelet over. Om du ikke har en admin-principal, se [[Drift/Kerberos#Lage_admin-principal]].

=== Gjøre endringer ===

Når du logger inn første gang vil du automatisk få sjekket ut salt-treet i ~/salt. Gjør endringene dine der inne, og push master til origin for å aktivere endringene.

Det kan være lurt å teste med en maskin først, ved å logge inn på den og gjøre en dry-run (du kan kjøre kommandoer rett fra salt-masteren også, men det er uansett en fordel å ha et skall på maskinen i tilfelle noe går galt):

<pre>
salt-call state.highstate test=True
</pre>

==== Teste endringer før commit ====

PVV har et lite triks som oppretter et salt-environment [https://docs.saltstack.com/en/latest/ref/states/top.html#multiple-environments] for hver bruker. Dette gjør at du kan teste koden din på en minion uten å committe. Det gjør du slik:

<pre>
salt-call state.highstate saltenv="$LOGNAME" test=True
</pre>

== Grains ==
Salt kan bruke grains for å gjøre noe på en gruppe med maskiner. <code><nowiki>salt 'hostname*' grains.items</nowiki></code> viser alle grains hostname er med i. For eksempel kan man si <code><nowiki>salt -G 'os_familt:Debian' test.ping</nowiki></code> for å pinge maskiner som er basert på Debian.

For å legge en minion til en gruppe gjør følgende på minion-en:

=== Konfigurasjon ===
<pre>$ vim /etc/salt/grains

roles:
- standard
- desktop
</pre>

I skrivende stund har vi følgende roller:

{|
|standard
|Alle maskiner med standard-oppsett (det vil si at brukere kan logge inn der)
|-
|desktop
|Desktopmaskiner
|-
|file-server
|Filservere, som f.eks. microbel.
|-
|mysql-server
|MySQL-serveren
|-
|postgresql-server
|PostGreSQL-serveren
|-
|web-frontend
|Web-frontend (ikke den som hoster brukerenes hjemmesider)
|-
|web-homes
|Web-backend for brukeres hjemmesider
|-
|fwlogin
|Maskinen lytter på SSH på port 80 og 443
|-
|salt-master
|salt-masteren (skal ikke ha standardoppsett)
|}

Når minions har blitt lagt til i roller er det viktig å huske på å synkronisere disse med masteren. Den letteste måten å gjøre det på er å kjøre <code><nowiki>salt '*' saltutil.sync_grains</nowiki></code> fra salt-masteren.

For å nå maskiner gjennom egendefinerte grains bruk <code><nowiki>salt -G 'attributt:verdi' kommando</nowiki></code>. Et eksempel er <code><nowiki>salt -G 'roles:workstation' test.ping</nowiki></code>.

== Tekniske ting ==

Litt nyttig info om hvordan ting fungerer under panseret

=== Distribuere mapper ===

Lag en overordnet mappe som inneholder både mappen du ønsker å distribuere og en sls-fil i salt-mappen: <code><nowiki>/srv/salt/overordnet_mappe</nowiki></code>. Der legger du mappen du ønsker å distribuere, og lager en fil du kaller for <code><nowiki>init.sls</nowiki></code>. Den formateres slik:

<pre><nowiki>
/path/til/der/du/vil/at/mappen/skal/ende/opp/på/minions
file.recurse:
- source: salt://overornet_mappe/mappen_du_vil_distribuere
#optional felter:
- include_empty: True #sørger for at tomme undermapper kommer med
- dir_mode: 777 #må bruke dir_mode når man dister mapper, bruk mode: hvis du dister filer
- user: brukernavn #hilken bruker skal mappen, undermapper og filer tilhøre
- group: eall_s #default-gruppen er root. Skal mappen tilhøre noen andre bruk eall_s eksplisitt
</nowiki></pre>

For å så få distribuert mappen kjør følgende kommando: <code><nowiki>salt '*' state.sls overordnet_mappe</nowiki></code>

=== States og håndheving ===

Salt oppererer med SLS filer (SaLt State) for å holde orden på reglene for distribusjon og hvordan disse skal håndheves. Legg SLS filene i <code><nowiki>/srv/salt/</nowiki></code>. En av de viktigste SLS filene er <code><nowiki>/srv/salt/top.sls</nowiki></code> da den spesifiserer hvilke SLS filer som skal anvendes på hvilke minions. (Alle sls-filene er på salt-master.)

For eksempel hvis vi har SLS filene:
<pre>
/srv/salt/top.sls
/srv/salt/common/init.sls
/srv/salt/common/packages.sls
/srv/salt/sl_eksempel.sls
</pre>

La så filene se slik ut:
<pre>
#top.sls:
base:
'*':
- common
'roles:desktop':
- match: grain
- sl_eksempel
</pre>
<pre>
#common/init.sls:
include:
- common.packages
</pre>
<pre>
#common/packages.sls:
vim:
pkg:
- installed
grep:
pkg:
- installed
</pre>
<pre>
#sl_eksempel.sls:
sl:
pkg:
- installed
</pre>

Hva filene sier:
* <code><nowiki>top.sls</nowiki></code> sier at at alle maskiner skal få staten som er spesifisert i 'common'. Siden 'common' er en mappe og ikke en SLS fil vil det implisitt bety at staten som er gitt i <code><nowiki>common/init.sls</nowiki></code> brukes istedenfor.
** Den sier også at alle maskiner som matcher grainen <code><nowiki>roles:desktop</nowiki></code> skal ha staten spesifisert i <code><nowiki>sl_eksempel.sls</nowiki></code>
* <code><nowiki>common/init.sls</nowiki></code> starter med å ved includen si at alt som er i <code><nowiki>/srv/salt/common/packages</nowiki></code> også skal kjøres i tillegg til innholdet den har (som for dette eksempelet er ikke noe mer)
* <code><nowiki>packages.sls</nowiki></code> sier at to pakker, vim og grep, skal være installert på alle maskiner som hører til staten.
* <code><nowiki>sl_eksempel.sls</nowiki></code> sier at pakken sl skal være installert.

For at minionsene skal gå inn å sjekke hvilke states de skal ha, og anvende dem, kjør: 
<code><nowiki>salt '*' state.highstate</nowiki></code> 
på salt-master.

=== Sørg for at Salt-minion er kjørende og at den jevnlig poller om nye ting fra master ===

Lag en mappe <code><nowiki>/srv/salt/minion_configuration</nowiki></code> som inneholder en <code><nowiki>init.sls</nowiki></code> fil og en <code><nowiki>minion</nowiki></code> fil. La <code><nowiki>init.sls</nowiki></code> se slik ut:

<pre>
salt-minion: # sier at det er salt-minion servicen vi påvirker
service:
# sier at den skal være kjørende:
- running
- enable: True
# sier at servicen skal restartes om man merker en endring i den oppgitte filen:
- watch:
- file /etc/salt/minion
/etc/salt/minion: #sier at denne filen skal speile den oppgitte fra master
file.managed:
# filen som skal kopieres over til minionen
- source salt://minion_configuration/minion
# bruker, gruppe, og premissions for filen når den ender opp på minionen:
- user: root
- group: root
- mode: 644
# sier at filen er et jinjatemplate, og at variablene i templatet skal byttes ut
# med verdiene gitt for dem i context-seksjonen:
- template: jinja
- context:
saltmaster: lommel.pvv.ntnu.no
timer: 4
</pre>

Kopier så inn en minion-fil til <code><nowiki>/srv/salt/minion_configuration/minion</nowiki></code>, og legg til disse linjene:

<pre>
#sett inn under "#master: salt" eller istedenfor det som måtte stå på på linjen som begynner med "master:"
master: {{saltmaster}}

#sier at highstate skal schedules til å kjøre hver 'timer' time:
schedule:
highstate:
function: state.highstate
hours: {{ timer }}
</pre>

== Behandlig av errors og feilmeldinger som kan dukke opp ofte ==

=== No Top file or external nodes data matches found ===

Om salt sier dette:

<pre>
ID: states
Function: no.None
Result: False
Comment: No Top file or external nodes data matches found
Started:
Duration:
Changes:
</pre>

Betyr det sannsynligvis at du har glemt å sette noen roller i [[#Grains|/etc/salt/grains]]

=== UnicodeDecodeError ===

Hvis du får «UnicodeDecodeError: 'ascii' codec can't decode byte 0xc2 in position 99: ordinal not in range» eller lignende kommer dette av en kjent feil i Salt: https://github.com/saltstack/salt/issues/16139

Dette skjer mye oftere om du har gammel salt. Prøv dette:

<pre>
echo deb http://debian.saltstack.com/debian $(lsb_release -c | awk '{print $2}')-saltstack main > /etc/apt/sources.list.d/saltstack.list
aptitude update && aptitude dist-upgrade
</pre>

=== No matching sls found ===
Hvis du får feilen: 
<code><nowiki>No matching sls found for 'sls_file_or_folder_name' in env 'base'</nowiki></code> 
Så har du sannsynligvis skrevet <code><nowiki>filnavn.sls</nowiki></code> (må være uten <code><nowiki>.sls</nowiki></code>), eller mappenavnet feil.

== Nyttige kommandoer og syntax ==

Viktig om syntax:
* All indentering er med mellomrom da tabs ser ut til å krasje, to ser ut til å være standard

Hvordan kopiere enkeltfiler ad-hoc fra salt-master til minions: 
<code><nowiki>salt-cp "*" /path/to/file/on/salt/master /path/to/file/on/minions</nowiki></code>

Hvordan kjøre kode på minions: 
<code><nowiki>salt "*" cmd.run "ps -e | grep salt"</nowiki></code>

For å kjøre på enkeltmaskiner istedenfor alle eller grains skriv inn navnet istedenfor <code><nowiki>"*"</nowiki></code>. Eksempel: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no cmd.run "ps -e | grep salt"</nowiki></code>

For å sjekke om en pakke er installer og hvilken versjon den har: 
<code><nowiki>salt "*" pkg.version "grep"</nowiki></code>

For å installere eller oppgradere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.install sl</nowiki></code>

For å avinstallere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.remove sl</nowiki></code>

For å se salt-pkg kommandoer: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.</nowiki></code> og spam tab.

Programvareverkstedet

2016-04-13T01:43:48Z

Knuta:

Drift/Salt

2015-11-15T20:35:39Z

Knuta:

Salt er et system for å distribuere filer og sørge for at maskiner har samme oppsett. Etter at vi satte opp versjonskontroll via git lokalt på lommel er det nødvenidg å gå gjennom oppsettet beskrevet i [[Drift/Salt#Gjøre endringer|Gjøre endringer]]-avsnittet før man kan bidra til å endre salt-oppsettet til PVV.

== Sette opp ny salt minion ==

=== Installasjon ===
<pre>
ny-minion$ apt-get install salt-minion
ny-minion$ rediger /etc/salt/grains og legg til gruppene maskinen er i, se dokumentasjonen for [[Drift/Salt#Grains|grains (grupper)]]
ny-minion$ service salt-minion restart
ny-minion$ ssh root@salt.pvv.ntnu.no
salt-master# salt-key -L
salt-master# salt-key -a hostname.pvv.ntnu.no
salt-master# salt hostname.pvv.ntnu.no saltutil.sync_grains
salt-master# salt hostname.pvv.ntnu.no state.sls minion_configuration
ny-minion$ salt-call state.highstate saltenv=base
</pre>

Hvis alt har har gått bra, vil pingtesten gi true for maskinen din nå. Hvis ikke, kjør <code><nowiki>service salt-minion status</nowiki></code> som root på din nye minion for å få hint om hva som er galt. Konfigurasjonsfilen til salt ligger i <code><nowiki>/etc/salt/minion</nowiki></code>.

I tilfellet man endrer hostname på en minion, gjør følgende for å få det oppdatert i salt: Stop salt-minion på den berørte maskinen. Slett nøkkelen til maskinen fra salt-master ved å kjøre <code><nowiki>salt-key -d minion_id</nowiki></code> på salt-masteren. Slett <code><nowiki>/etc/salt/minion/minion_id</nowiki></code>. Start salt-minion service-en. Autoriser den nye nøkkelen med det nye navnet i salt-master.

Husk å legge nyoppsatte maskiner til i riktige [[Drift/Salt#Grains|grains (grupper)]].

== Gjøre endringer ==

Endringer gjøres på salt-masteren (salt.pvv.ntnu.no, som for tiden peker på lommel.pvv.ntnu.no). Alle endringer gjøres som din personlige bruker.

=== Opprette bruker på salt-masteren ===
Om du ikke har en bruker, logg inn som root på serveren og lag en. Adduser vil spørre deg om «Current Kerberos password», men du kan bare trykke enter og si nei til å prøve igjen, så fungerer det fint. Legg også brukeren til i sudo-gruppen.

<pre>
lommel ~ # adduser johndoe && adduser johndoe sudo
Adding user `johndoe' ...
Adding new group `johndoe' (1000) ...
Adding new user `johndoe' (1000) with group `johndoe' ...
Current Kerberos password:
Current Kerberos password:
passwd: Authentication token manipulation error
passwd: password unchanged
Try again? [y/N] n
Changing the user information for johndoe
Enter the new value, or press ENTER for the default
Full Name []: John Doe
Room Number []:
Work Phone []:
Home Phone []:
Other []:
Is the information correct? [Y/n]
</pre>

Passordet du bruker vil være det samme som admin-principalen din i Kerberos har, altså johndoe/admin i eksempelet over. Om du ikke har en admin-principal, se [[Drift/Kerberos#Lage_admin-principal]].

=== Gjøre endringer ===

Når du logger inn første gang vil du automatisk få sjekket ut salt-treet i ~/salt. Gjør endringene dine der inne, og push master til origin for å aktivere endringene.

Det kan være lurt å teste med en maskin først, ved å logge inn på den og gjøre en dry-run (du kan kjøre kommandoer rett fra salt-masteren også, men det er uansett en fordel å ha et skall på maskinen i tilfelle noe går galt):

<pre>
salt-call state.highstate test=True
</pre>

==== Teste endringer før commit ====

PVV har et lite triks som oppretter et salt-environment [https://docs.saltstack.com/en/latest/ref/states/top.html#multiple-environments] for hver bruker. Dette gjør at du kan teste koden din på en minion uten å committe. Det gjør du slik:

<pre>
salt-call state.highstate saltenv="$LOGNAME" test=True
</pre>

== Grains ==
Salt kan bruke grains for å gjøre noe på en gruppe med maskiner. <code><nowiki>salt 'hostname*' grains.items</nowiki></code> viser alle grains hostname er med i. For eksempel kan man si <code><nowiki>salt -G 'os_familt:Debian' test.ping</nowiki></code> for å pinge maskiner som er basert på Debian.

For å legge en minion til en gruppe gjør følgende på minion-en:

=== Konfigurasjon ===
<pre>$ vim /etc/salt/grains

roles:
- standard
- desktop
</pre>

I skrivende stund har vi følgende roller:

{|
|standard
|Alle maskiner med standard-oppsett (det vil si at brukere kan logge inn der)
|-
|desktop
|Desktopmaskiner
|-
|file-server
|Filservere, som f.eks. microbel.
|-
|mysql-server
|MySQL-serveren
|-
|postgresql-server
|PostGreSQL-serveren
|-
|web-frontend
|Web-frontend (ikke den som hoster brukerenes hjemmesider)
|-
|web-homes
|Web-backend for brukeres hjemmesider
|-
|fwlogin
|Maskinen lytter på SSH på port 80 og 443
|-
|salt-master
|salt-masteren (skal ikke ha standardoppsett)
|}

Når minions har blitt lagt til i roller er det viktig å huske på å synkronisere disse med masteren. Den letteste måten å gjøre det på er å kjøre <code><nowiki>salt '*' saltutil.sync_grains</nowiki></code> fra salt-masteren.

For å nå maskiner gjennom egendefinerte grains bruk <code><nowiki>salt -G 'attributt:verdi' kommando</nowiki></code>. Et eksempel er <code><nowiki>salt -G 'roles:workstation' test.ping</nowiki></code>.

== Tekniske ting ==

Litt nyttig info om hvordan ting fungerer under panseret

=== Distribuere mapper ===

Lag en overordnet mappe som inneholder både mappen du ønsker å distribuere og en sls-fil i salt-mappen: <code><nowiki>/srv/salt/overordnet_mappe</nowiki></code>. Der legger du mappen du ønsker å distribuere, og lager en fil du kaller for <code><nowiki>init.sls</nowiki></code>. Den formateres slik:

<pre><nowiki>
/path/til/der/du/vil/at/mappen/skal/ende/opp/på/minions
file.recurse:
- source: salt://overornet_mappe/mappen_du_vil_distribuere
#optional felter:
- include_empty: True #sørger for at tomme undermapper kommer med
- dir_mode: 777 #må bruke dir_mode når man dister mapper, bruk mode: hvis du dister filer
- user: brukernavn #hilken bruker skal mappen, undermapper og filer tilhøre
- group: eall_s #default-gruppen er root. Skal mappen tilhøre noen andre bruk eall_s eksplisitt
</nowiki></pre>

For å så få distribuert mappen kjør følgende kommando: <code><nowiki>salt '*' state.sls overordnet_mappe</nowiki></code>

=== States og håndheving ===

Salt oppererer med SLS filer (SaLt State) for å holde orden på reglene for distribusjon og hvordan disse skal håndheves. Legg SLS filene i <code><nowiki>/srv/salt/</nowiki></code>. En av de viktigste SLS filene er <code><nowiki>/srv/salt/top.sls</nowiki></code> da den spesifiserer hvilke SLS filer som skal anvendes på hvilke minions. (Alle sls-filene er på salt-master.)

For eksempel hvis vi har SLS filene:
<pre>
/srv/salt/top.sls
/srv/salt/common/init.sls
/srv/salt/common/packages.sls
/srv/salt/sl_eksempel.sls
</pre>

La så filene se slik ut:
<pre>
#top.sls:
base:
'*':
- common
'roles:desktop':
- match: grain
- sl_eksempel
</pre>
<pre>
#common/init.sls:
include:
- common.packages
</pre>
<pre>
#common/packages.sls:
vim:
pkg:
- installed
grep:
pkg:
- installed
</pre>
<pre>
#sl_eksempel.sls:
sl:
pkg:
- installed
</pre>

Hva filene sier:
* <code><nowiki>top.sls</nowiki></code> sier at at alle maskiner skal få staten som er spesifisert i 'common'. Siden 'common' er en mappe og ikke en SLS fil vil det implisitt bety at staten som er gitt i <code><nowiki>common/init.sls</nowiki></code> brukes istedenfor.
** Den sier også at alle maskiner som matcher grainen <code><nowiki>roles:desktop</nowiki></code> skal ha staten spesifisert i <code><nowiki>sl_eksempel.sls</nowiki></code>
* <code><nowiki>common/init.sls</nowiki></code> starter med å ved includen si at alt som er i <code><nowiki>/srv/salt/common/packages</nowiki></code> også skal kjøres i tillegg til innholdet den har (som for dette eksempelet er ikke noe mer)
* <code><nowiki>packages.sls</nowiki></code> sier at to pakker, vim og grep, skal være installert på alle maskiner som hører til staten.
* <code><nowiki>sl_eksempel.sls</nowiki></code> sier at pakken sl skal være installert.

For at minionsene skal gå inn å sjekke hvilke states de skal ha, og anvende dem, kjør: 
<code><nowiki>salt '*' state.highstate</nowiki></code> 
på salt-master.

=== Sørg for at Salt-minion er kjørende og at den jevnlig poller om nye ting fra master ===

Lag en mappe <code><nowiki>/srv/salt/minion_configuration</nowiki></code> som inneholder en <code><nowiki>init.sls</nowiki></code> fil og en <code><nowiki>minion</nowiki></code> fil. La <code><nowiki>init.sls</nowiki></code> se slik ut:

<pre>
salt-minion: # sier at det er salt-minion servicen vi påvirker
service:
# sier at den skal være kjørende:
- running
- enable: True
# sier at servicen skal restartes om man merker en endring i den oppgitte filen:
- watch:
- file /etc/salt/minion
/etc/salt/minion: #sier at denne filen skal speile den oppgitte fra master
file.managed:
# filen som skal kopieres over til minionen
- source salt://minion_configuration/minion
# bruker, gruppe, og premissions for filen når den ender opp på minionen:
- user: root
- group: root
- mode: 644
# sier at filen er et jinjatemplate, og at variablene i templatet skal byttes ut
# med verdiene gitt for dem i context-seksjonen:
- template: jinja
- context:
saltmaster: lommel.pvv.ntnu.no
timer: 4
</pre>

Kopier så inn en minion-fil til <code><nowiki>/srv/salt/minion_configuration/minion</nowiki></code>, og legg til disse linjene:

<pre>
#sett inn under "#master: salt" eller istedenfor det som måtte stå på på linjen som begynner med "master:"
master: {{saltmaster}}

#sier at highstate skal schedules til å kjøre hver 'timer' time:
schedule:
highstate:
function: state.highstate
hours: {{ timer }}
</pre>

== Behandlig av errors og feilmeldinger som kan dukke opp ofte ==

=== No Top file or external nodes data matches found ===

Om salt sier dette:

<pre>
ID: states
Function: no.None
Result: False
Comment: No Top file or external nodes data matches found
Started:
Duration:
Changes:
</pre>

Betyr det sannsynligvis at du har glemt å sette noen roller i [[#Grains|/etc/salt/grains]]

=== UnicodeDecodeError ===

Hvis du får «UnicodeDecodeError: 'ascii' codec can't decode byte 0xc2 in position 99: ordinal not in range» eller lignende kommer dette av en kjent feil i Salt: https://github.com/saltstack/salt/issues/16139

Dette skjer mye oftere om du har gammel salt. Prøv dette:

<pre>
echo deb http://debian.saltstack.com/debian $(lsb_release -c | awk '{print $2}')-saltstack main > /etc/apt/sources.list.d/saltstack.list
aptitude update && aptitude dist-upgrade
</pre>

=== No matching sls found ===
Hvis du får feilen: 
<code><nowiki>No matching sls found for 'sls_file_or_folder_name' in env 'base'</nowiki></code> 
Så har du sannsynligvis skrevet <code><nowiki>filnavn.sls</nowiki></code> (må være uten <code><nowiki>.sls</nowiki></code>), eller mappenavnet feil.

== Nyttige kommandoer og syntax ==

Viktig om syntax:
* All indentering er med mellomrom da tabs ser ut til å krasje, to ser ut til å være standard

Hvordan kopiere enkeltfiler ad-hoc fra salt-master til minions: 
<code><nowiki>salt-cp "*" /path/to/file/on/salt/master /path/to/file/on/minions</nowiki></code>

Hvordan kjøre kode på minions: 
<code><nowiki>salt "*" cmd.run "ps -e | grep salt"</nowiki></code>

For å kjøre på enkeltmaskiner istedenfor alle eller grains skriv inn navnet istedenfor <code><nowiki>"*"</nowiki></code>. Eksempel: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no cmd.run "ps -e | grep salt"</nowiki></code>

For å sjekke om en pakke er installer og hvilken versjon den har: 
<code><nowiki>salt "*" pkg.version "grep"</nowiki></code>

For å installere eller oppgradere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.install sl</nowiki></code>

For å avinstallere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.remove sl</nowiki></code>

For å se salt-pkg kommandoer: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.</nowiki></code> og spam tab.

Drift

2015-11-15T20:34:59Z

Knuta: /* Bare nyttig for drift */

[[#Administration|English]]

Drift har ansvaret for å drive maskinene på PVV. Tidligere var drift organisert i egne grupper, først med ansvar for bestemte maskiner, deretter for bestemte tjenester, men har siden 2002 vært organisert i en stor driftsgruppe. I tillegg finnes en gruppe med ansvar for drift av e-postsystemet og en [[CERT|sikkerhetsgruppe]].

Dersom du har generelle spørsmål skal disse sendes drift(at)pvv.ntnu.no, ikke til enkelpersoner som er med i driftsgruppa. Driftskoordinator er p.t. `orjane`.

Husk at drift utelukkende består av frivillige. Ingen får betalt for å gjøre dette og ingen driver med dette 24 timer i døgnet, 365 dager i året. Vi vil likevel gjøre vårt beste for å gi god hjelp og service til våre brukere.

Driftsgruppen har ingen strenge krav til aktivitet eller erfaring for å bli medlem, så selv om du er ny i virket går det fint an å bare observere og absorbere i begynnelsen.

==== Det finnes også en slags [[/Intro|introduksjon]] for nye driftere. ====
----

= [[Dokumentasjon|Nyttig for både bruk og drift]] =
Se [[Dokumentasjon]]

= Bare nyttig for drift =
* [[/ToDo]] Ting som trenger gjøring
* [[/Scanner]] Scanner
* [[/Netboot]] Legge til linuxer i pxe-boot
* [[/DNS og dvask]] Legge til record på navnetjeneren vår, dvask
* [[/Kerberos]] Oppsett av kerberos
* [[/Mediawiki]] Oppsett av mediawiki
* [[/Seriellkonsoll]] Oppsett av seriellkonsoll
* [[/TRAC]] Trac på dev.pvv.ntnu.no
* [[/Salt]] Dokumentasjon for SaltStack

= Handling drift ofte utfører =

* [[Legge til bruker]]: Hvordan legge til en ny bruker på PVV.
* [[Drift/Endre brukeres passord|Endre brukeres passord]] Endre brukeres passord
* [[Redigere kvote]]: Hvordan opprette/utvide diskplass for en bruker når han har betalt for utvidet kvote.
* [[Drift/Mail|Epost]]: Behandle epost.
* [[Planlagt nedetid]]: Prosedyre for varsling av planlagt nedetid.
* [[Systembrukere]]: Regler for systembrukere.
* [[Endre eller slette bruker]]: Hva som skal gjøres når man endrer eller sletter brukere
* [[Opprette nye prosjekt på dev]]: Ting og tang som må gjøres for å opprette et nytt prosjekt.
* [[Drift/Oppdatere SSL-sertifikater|Oppdatere SSL-sertifikater]]
* [[Starte etter strømbrudd]]: Hva må gjøres når strømmen har vært borte?

== Annet ==
* [[Drift/Backup|Backup]]
* [[Drift/Maskininstallasjon|Installasjon av OS]]
* [[Drift/Pakkeinstallasjon|Installasjon av programvare]]
* OS-Drift
** [[Drift/Partisjonering]]
** [[Drift/IRIX Install]]
** [[Drift/VAX Netboot]]
** [[Maskiner/Vrimmel|Virtualisering på vrimmel.pvv.ntnu.no]]
** [[Drift/SUSE]]
* [[Drift/OpenVPN|Hvordan sette opp, konfigurere, og vedlikeholde en OpenVPN server]]
* [[Drift/RootpassordReglement]]
* [http://www.pvv.ntnu.no/rootpassordskjema.ps Rootpassordskjema]

= Roteloftet =

Sider som egentlig ikke er relevante lenger.

* <del>[[Maskiner/Octopus|Octopus]]</del> (Ikke i bruk)
* [[Drift/Wiki|Den gamle wikien]]
* [[Drift/Bacula|Bacula, det forrige backupsystemet]]

= Administration =

The administration is responsible for maintaining the machines at PVV. Previously the administration was organized in separate groups, first with responsibility for certain machines, later for certain services, but has since 2002 been organized in a large administration group. In addition there exists a group that is responsible for the maintenance of the email system, and a [[CERT|security group]].

If you have general questions these should be directed to drift(at)pvv.ntnu.no, not to individual members of the administrative group. The coordinator of the administrative group at the moment is `orjane`.

Remember that the administration consists exclusively of volunteers. Nobody is paid to do this and nobody is working on it 24 hours a day, 365 days a year. Even so we will try our best to give good help and service to our users.

The administrative group has no strong requirements to activity or experience to become a member, so even if you are new to craft it's completely possible to just observer and absorb in the beginning.

==== There also exists a kind of [[/Intro|introduction]] for fresh administrators. ====
----

= [[Dokumentasjon|Usefull for both users and administrators]] =
See [[Dokumentasjon]]

= Only useful for administrators =
* [[/ToDo]] Things that need doing
* [[/Scanner]] Scanner
* [[/Netboot]] Add linuxes to pxe-boot
* [[/DNS og dvask|DNS and dvask]] Add records to our name-server, dvask
* [[/Kerberos]] Setup of kerberos
* [[/Mediawiki]] Setup of mediawiki
* [[/Seriellkonsoll|Serial console]] Setup of serial console
* [[/TRAC]] Trac on dev.pvv.ntnu.no
* [[/Puppet]] Documentation for Puppet

= Actions the administration often execute =
* [[Legge til bruker|Adding new users]]: How to add a new user on PVV.
* [[Drift/Endre brukeres passord|Change users password]] Change a users password
* [[Redigere kvote|Edit quota]]: How to create/extend disc space for a user when he's paid for an extended quota.
* [[Drift/Mail|Mail]]: Process email.
* [[Planlagt nedetid|Planed downtime]]: Procedure for notifying planed downtime.
* [[Systembrukere|System users]]: Rules for system users.
* [[Endre eller slette bruker|Modify or delete user]]: What should be changed when one modifies or deletes users.
* [[Opprette nye prosjekt på dev|Creating a new project on dev]]: Things that must be done to create a new project.
* [[Drift/Oppdatere SSL-sertifikater|Update SSL-certificates]]
* [[Starte etter strømbrudd|Restarting after power outage]]: What has to be done when the power has been gone?

== Other ==
* [[Drift/Backup|Backup]]
* [[Drift/Maskininstallasjon|Installation of OS]]
* [[Drift/Pakkeinstallasjon|Installation of software]]
* OS-Administration
** [[Drift/Partisjonering|Administration/Partitioning]]
** [[Drift/IRIX Install|Administration/IRIX Install]]
** [[Drift/VAX Netboot|Administration/VAX Netboot]]
** [[Maskiner/Vrimmel|Virtualization on vrimmel.pvv.ntnu.no]]
** [[Drift/SUSE|Administration/SUSE]]
* [[Drift/RootpassordReglement|Administration/Root password rules]]
* [http://www.pvv.ntnu.no/rootpassordskjema.ps Root password scheme]

= The Attic of Miscellaneous =

Pages that aren't strictly relevant anymore.

* <del>[[Maskiner/Octopus|Octopus]]</del> (Not in use)
* [[Drift/Wiki|The old wiki]]
* [[Drift/Bacula|Bacula, the previous backup system]]

__NOTOC__

Drift/Puppet

2015-11-15T20:34:40Z

Knuta: Replaced content with "PVV vurderte å erstatte rdist med Puppet, men landet til slutt på Saltstack. Se Drift/Salt for dokumentasjon."

PVV vurderte å erstatte rdist med Puppet, men landet til slutt på Saltstack. Se [[Drift/Salt]] for dokumentasjon.

Drift/Redigere kvote

2015-11-15T20:32:58Z

Knuta: Oppdater dokumentasjon til å gjelde salt

Logg inn som vanlig bruker på Salt-boksen (se [[Drift/Salt#Opprette_bruker_p.C3.A5_salt-masteren|Drift/Salt]] for hvordan du oppretter bruker)

<pre><nowiki>
cd ~/pillar/files/quota
git status (bør vise nada)
$EDITOR quota.txt
git add quota.txt
git commit -m "Beskriv det du gjorde"
git push
sudo salt microbel.pvv.ntnu.no state.highstate
</nowiki></pre>

__NOTOC__

Hvor "$EDITOR" er et valgfritt tekstredigeringsprogram, som for eksempel vim eller nano.

Tjenester/Epost/Innkommende mail

2015-10-26T06:56:48Z

Knuta: /* Kjøring av program */

= Om filen .forward =

Mail leveres i utgangspunktet til `$MAIL`, typisk filen `~/Mailbox`. Ved hjelp av filen `.forward` kan du styre hvor og hvordan posten leveres selv. Denne siden gir en enkel innføring i filformatet. For en detaljert beskrivelse, se [http://www.exim.org/exim-html-4.66/doc/html/spec_html/ch22.html exim-dokumentasjonen].

= Filformat =

Det er tre hovedtyper linjer som brukes i `.forward`. Disse er lokal og ekstern videresending, kjøring av program, og levering til en fil eller folder. Linjene kan kombineres fritt.

Viktig: Ved bruk av `.forward` leveres mail ikke til standard mailboks. Hvis du vil f.eks. videresende og samtidig ha normal levering må du spesifisere begge i filen.

Eksempel (noe overdrevet): <pre><nowiki>
johndoe@example.com
\johndoe
|/usr/bin/procmail
|/usr/bin/maildrop
/home/pvv/d/johndoe/mail/INBOX
/home/pvv/d/johndoe/Maildir/
</nowiki></pre>

== Videresending ==

Videresending gjøres ved å skrive en epostadresse (ekstern) eller en `\` (backslash) etterfulgt av et brukernavn (lokal).

Eksempler: <pre><nowiki>
johndoe@example.com
\johndoe
</nowiki></pre>

== Kjøring av program ==

Du kan sende mailen til et program ved å sette inn en `|` (pipe) og så kommandoen. Bruk full path til den kjørbare filen.

Eksempler: <pre><nowiki>
|/usr/bin/procmail
|/usr/bin/maildrop
</nowiki></pre>

Dette brukes vanligvis for å sende mail til et program som gjør [[Drift/Mail/Mailfiltrering|mailfiltrering]].

== Levering til fil eller folder ==

Du kan levere noe til en egendefinert mailboks ved å skrive full path og navn på en fil eller folder. Ting som `$HOME` og `~/` vil ikke fungere. For bruk av maildir uten avansert filtrering med program, er levering til ~/Maildir/ egnet.

Eksempler: <pre><nowiki>
/home/pvv/d/johndoe/mail/INBOX
/home/pvv/d/johndoe/Maildir/
</nowiki></pre>

Levering til fil er som regel best overlatt til systemet uten bruk av `.forward`, da standard mailboxnavn fungerer best med POP/IMAP.

__NOTOC__

Drift/Salt

2015-10-26T02:38:16Z

Knuta: /* Opprette bruker på salt-masteren */

Salt er, som [[Drift/Puppet]], et system for å distribuere filer og sørge for at maskiner har samme oppsett. Etter at vi satte opp versjonskontroll via git lokalt på lommel er det nødvenidg å gå gjennom oppsettet beskrevet i [[Drift/Salt#Gjøre endringer|Gjøre endringer]]-avsnittet før man kan bidra til å endre salt-oppsettet til PVV.

== Sette opp ny salt minion ==

=== Installasjon ===
<pre>
ny-minion$ apt-get install salt-minion
ny-minion$ rediger /etc/salt/grains og legg til gruppene maskinen er i, se dokumentasjonen for [[Drift/Salt#Grains|grains (grupper)]]
ny-minion$ service salt-minion restart
ny-minion$ ssh root@salt.pvv.ntnu.no
salt-master# salt-key -L
salt-master# salt-key -a hostname.pvv.ntnu.no
salt-master# salt hostname.pvv.ntnu.no saltutil.sync_grains
salt-master# salt hostname.pvv.ntnu.no state.sls minion_configuration
ny-minion$ salt-call state.highstate saltenv=base
</pre>

Hvis alt har har gått bra, vil pingtesten gi true for maskinen din nå. Hvis ikke, kjør <code><nowiki>service salt-minion status</nowiki></code> som root på din nye minion for å få hint om hva som er galt. Konfigurasjonsfilen til salt ligger i <code><nowiki>/etc/salt/minion</nowiki></code>.

I tilfellet man endrer hostname på en minion, gjør følgende for å få det oppdatert i salt: Stop salt-minion på den berørte maskinen. Slett nøkkelen til maskinen fra salt-master ved å kjøre <code><nowiki>salt-key -d minion_id</nowiki></code> på salt-masteren. Slett <code><nowiki>/etc/salt/minion/minion_id</nowiki></code>. Start salt-minion service-en. Autoriser den nye nøkkelen med det nye navnet i salt-master.

Husk å legge nyoppsatte maskiner til i riktige [[Drift/Salt#Grains|grains (grupper)]].

== Gjøre endringer ==

Endringer gjøres på salt-masteren (salt.pvv.ntnu.no, som for tiden peker på lommel.pvv.ntnu.no). Alle endringer gjøres som din personlige bruker.

=== Opprette bruker på salt-masteren ===
Om du ikke har en bruker, logg inn som root på serveren og lag en. Adduser vil spørre deg om «Current Kerberos password», men du kan bare trykke enter og si nei til å prøve igjen, så fungerer det fint. Legg også brukeren til i sudo-gruppen.

<pre>
lommel ~ # adduser johndoe && adduser johndoe sudo
Adding user `johndoe' ...
Adding new group `johndoe' (1000) ...
Adding new user `johndoe' (1000) with group `johndoe' ...
Current Kerberos password:
Current Kerberos password:
passwd: Authentication token manipulation error
passwd: password unchanged
Try again? [y/N] n
Changing the user information for johndoe
Enter the new value, or press ENTER for the default
Full Name []: John Doe
Room Number []:
Work Phone []:
Home Phone []:
Other []:
Is the information correct? [Y/n]
</pre>

Passordet du bruker vil være det samme som admin-principalen din i Kerberos har, altså johndoe/admin i eksempelet over. Om du ikke har en admin-principal, se [[Drift/Kerberos#Lage_admin-principal]].

=== Gjøre endringer ===

Når du logger inn første gang vil du automatisk få sjekket ut salt-treet i ~/salt. Gjør endringene dine der inne, og push master til origin for å aktivere endringene.

Det kan være lurt å teste med en maskin først, ved å logge inn på den og gjøre en dry-run (du kan kjøre kommandoer rett fra salt-masteren også, men det er uansett en fordel å ha et skall på maskinen i tilfelle noe går galt):

<pre>
salt-call state.highstate test=True
</pre>

==== Teste endringer før commit ====

PVV har et lite triks som oppretter et salt-environment [https://docs.saltstack.com/en/latest/ref/states/top.html#multiple-environments] for hver bruker. Dette gjør at du kan teste koden din på en minion uten å committe. Det gjør du slik:

<pre>
salt-call state.highstate saltenv="$LOGNAME" test=True
</pre>

== Grains ==
Salt kan bruke grains for å gjøre noe på en gruppe med maskiner. <code><nowiki>salt 'hostname*' grains.items</nowiki></code> viser alle grains hostname er med i. For eksempel kan man si <code><nowiki>salt -G 'os_familt:Debian' test.ping</nowiki></code> for å pinge maskiner som er basert på Debian.

For å legge en minion til en gruppe gjør følgende på minion-en:

=== Konfigurasjon ===
<pre>$ vim /etc/salt/grains

roles:
- standard
- desktop
</pre>

I skrivende stund har vi følgende roller:

{|
|standard
|Alle maskiner med standard-oppsett (det vil si at brukere kan logge inn der)
|-
|desktop
|Desktopmaskiner
|-
|file-server
|Filservere, som f.eks. microbel.
|-
|mysql-server
|MySQL-serveren
|-
|postgresql-server
|PostGreSQL-serveren
|-
|web-frontend
|Web-frontend (ikke den som hoster brukerenes hjemmesider)
|-
|web-homes
|Web-backend for brukeres hjemmesider
|-
|fwlogin
|Maskinen lytter på SSH på port 80 og 443
|-
|salt-master
|salt-masteren (skal ikke ha standardoppsett)
|}

Når minions har blitt lagt til i roller er det viktig å huske på å synkronisere disse med masteren. Den letteste måten å gjøre det på er å kjøre <code><nowiki>salt '*' saltutil.sync_grains</nowiki></code> fra salt-masteren.

For å nå maskiner gjennom egendefinerte grains bruk <code><nowiki>salt -G 'attributt:verdi' kommando</nowiki></code>. Et eksempel er <code><nowiki>salt -G 'roles:workstation' test.ping</nowiki></code>.

== Tekniske ting ==

Litt nyttig info om hvordan ting fungerer under panseret

=== Distribuere mapper ===

Lag en overordnet mappe som inneholder både mappen du ønsker å distribuere og en sls-fil i salt-mappen: <code><nowiki>/srv/salt/overordnet_mappe</nowiki></code>. Der legger du mappen du ønsker å distribuere, og lager en fil du kaller for <code><nowiki>init.sls</nowiki></code>. Den formateres slik:

<pre><nowiki>
/path/til/der/du/vil/at/mappen/skal/ende/opp/på/minions
file.recurse:
- source: salt://overornet_mappe/mappen_du_vil_distribuere
#optional felter:
- include_empty: True #sørger for at tomme undermapper kommer med
- dir_mode: 777 #må bruke dir_mode når man dister mapper, bruk mode: hvis du dister filer
- user: brukernavn #hilken bruker skal mappen, undermapper og filer tilhøre
- group: eall_s #default-gruppen er root. Skal mappen tilhøre noen andre bruk eall_s eksplisitt
</nowiki></pre>

For å så få distribuert mappen kjør følgende kommando: <code><nowiki>salt '*' state.sls overordnet_mappe</nowiki></code>

=== States og håndheving ===

Salt oppererer med SLS filer (SaLt State) for å holde orden på reglene for distribusjon og hvordan disse skal håndheves. Legg SLS filene i <code><nowiki>/srv/salt/</nowiki></code>. En av de viktigste SLS filene er <code><nowiki>/srv/salt/top.sls</nowiki></code> da den spesifiserer hvilke SLS filer som skal anvendes på hvilke minions. (Alle sls-filene er på salt-master.)

For eksempel hvis vi har SLS filene:
<pre>
/srv/salt/top.sls
/srv/salt/common/init.sls
/srv/salt/common/packages.sls
/srv/salt/sl_eksempel.sls
</pre>

La så filene se slik ut:
<pre>
#top.sls:
base:
'*':
- common
'roles:desktop':
- match: grain
- sl_eksempel
</pre>
<pre>
#common/init.sls:
include:
- common.packages
</pre>
<pre>
#common/packages.sls:
vim:
pkg:
- installed
grep:
pkg:
- installed
</pre>
<pre>
#sl_eksempel.sls:
sl:
pkg:
- installed
</pre>

Hva filene sier:
* <code><nowiki>top.sls</nowiki></code> sier at at alle maskiner skal få staten som er spesifisert i 'common'. Siden 'common' er en mappe og ikke en SLS fil vil det implisitt bety at staten som er gitt i <code><nowiki>common/init.sls</nowiki></code> brukes istedenfor.
** Den sier også at alle maskiner som matcher grainen <code><nowiki>roles:desktop</nowiki></code> skal ha staten spesifisert i <code><nowiki>sl_eksempel.sls</nowiki></code>
* <code><nowiki>common/init.sls</nowiki></code> starter med å ved includen si at alt som er i <code><nowiki>/srv/salt/common/packages</nowiki></code> også skal kjøres i tillegg til innholdet den har (som for dette eksempelet er ikke noe mer)
* <code><nowiki>packages.sls</nowiki></code> sier at to pakker, vim og grep, skal være installert på alle maskiner som hører til staten.
* <code><nowiki>sl_eksempel.sls</nowiki></code> sier at pakken sl skal være installert.

For at minionsene skal gå inn å sjekke hvilke states de skal ha, og anvende dem, kjør: 
<code><nowiki>salt '*' state.highstate</nowiki></code> 
på salt-master.

=== Sørg for at Salt-minion er kjørende og at den jevnlig poller om nye ting fra master ===

Lag en mappe <code><nowiki>/srv/salt/minion_configuration</nowiki></code> som inneholder en <code><nowiki>init.sls</nowiki></code> fil og en <code><nowiki>minion</nowiki></code> fil. La <code><nowiki>init.sls</nowiki></code> se slik ut:

<pre>
salt-minion: # sier at det er salt-minion servicen vi påvirker
service:
# sier at den skal være kjørende:
- running
- enable: True
# sier at servicen skal restartes om man merker en endring i den oppgitte filen:
- watch:
- file /etc/salt/minion
/etc/salt/minion: #sier at denne filen skal speile den oppgitte fra master
file.managed:
# filen som skal kopieres over til minionen
- source salt://minion_configuration/minion
# bruker, gruppe, og premissions for filen når den ender opp på minionen:
- user: root
- group: root
- mode: 644
# sier at filen er et jinjatemplate, og at variablene i templatet skal byttes ut
# med verdiene gitt for dem i context-seksjonen:
- template: jinja
- context:
saltmaster: lommel.pvv.ntnu.no
timer: 4
</pre>

Kopier så inn en minion-fil til <code><nowiki>/srv/salt/minion_configuration/minion</nowiki></code>, og legg til disse linjene:

<pre>
#sett inn under "#master: salt" eller istedenfor det som måtte stå på på linjen som begynner med "master:"
master: {{saltmaster}}

#sier at highstate skal schedules til å kjøre hver 'timer' time:
schedule:
highstate:
function: state.highstate
hours: {{ timer }}
</pre>

== Behandlig av errors og feilmeldinger som kan dukke opp ofte ==

=== No Top file or external nodes data matches found ===

Om salt sier dette:

<pre>
ID: states
Function: no.None
Result: False
Comment: No Top file or external nodes data matches found
Started:
Duration:
Changes:
</pre>

Betyr det sannsynligvis at du har glemt å sette noen roller i [[#Grains|/etc/salt/grains]]

=== UnicodeDecodeError ===

Hvis du får «UnicodeDecodeError: 'ascii' codec can't decode byte 0xc2 in position 99: ordinal not in range» eller lignende kommer dette av en kjent feil i Salt: https://github.com/saltstack/salt/issues/16139

Dette skjer mye oftere om du har gammel salt. Prøv dette:

<pre>
echo deb http://debian.saltstack.com/debian $(lsb_release -c | awk '{print $2}')-saltstack main > /etc/apt/sources.list.d/saltstack.list
aptitude update && aptitude dist-upgrade
</pre>

=== No matching sls found ===
Hvis du får feilen: 
<code><nowiki>No matching sls found for 'sls_file_or_folder_name' in env 'base'</nowiki></code> 
Så har du sannsynligvis skrevet <code><nowiki>filnavn.sls</nowiki></code> (må være uten <code><nowiki>.sls</nowiki></code>), eller mappenavnet feil.

== Nyttige kommandoer og syntax ==

Viktig om syntax:
* All indentering er med mellomrom da tabs ser ut til å krasje, to ser ut til å være standard

Hvordan kopiere enkeltfiler ad-hoc fra salt-master til minions: 
<code><nowiki>salt-cp "*" /path/to/file/on/salt/master /path/to/file/on/minions</nowiki></code>

Hvordan kjøre kode på minions: 
<code><nowiki>salt "*" cmd.run "ps -e | grep salt"</nowiki></code>

For å kjøre på enkeltmaskiner istedenfor alle eller grains skriv inn navnet istedenfor <code><nowiki>"*"</nowiki></code>. Eksempel: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no cmd.run "ps -e | grep salt"</nowiki></code>

For å sjekke om en pakke er installer og hvilken versjon den har: 
<code><nowiki>salt "*" pkg.version "grep"</nowiki></code>

For å installere eller oppgradere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.install sl</nowiki></code>

For å avinstallere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.remove sl</nowiki></code>

For å se salt-pkg kommandoer: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.</nowiki></code> og spam tab.

Drift/Salt

2015-10-25T19:20:56Z

Knuta: /* Konfigurasjon */

Salt er, som [[Drift/Puppet]], et system for å distribuere filer og sørge for at maskiner har samme oppsett. Etter at vi satte opp versjonskontroll via git lokalt på lommel er det nødvenidg å gå gjennom oppsettet beskrevet i [[Drift/Salt#Gjøre endringer|Gjøre endringer]]-avsnittet før man kan bidra til å endre salt-oppsettet til PVV.

== Sette opp ny salt minion ==

=== Installasjon ===
<pre>
ny-minion$ apt-get install salt-minion
ny-minion$ rediger /etc/salt/grains og legg til gruppene maskinen er i, se dokumentasjonen for [[Drift/Salt#Grains|grains (grupper)]]
ny-minion$ service salt-minion restart
ny-minion$ ssh root@salt.pvv.ntnu.no
salt-master# salt-key -L
salt-master# salt-key -a hostname.pvv.ntnu.no
salt-master# salt hostname.pvv.ntnu.no saltutil.sync_grains
salt-master# salt hostname.pvv.ntnu.no state.sls minion_configuration
ny-minion$ salt-call state.highstate saltenv=base
</pre>

Hvis alt har har gått bra, vil pingtesten gi true for maskinen din nå. Hvis ikke, kjør <code><nowiki>service salt-minion status</nowiki></code> som root på din nye minion for å få hint om hva som er galt. Konfigurasjonsfilen til salt ligger i <code><nowiki>/etc/salt/minion</nowiki></code>.

I tilfellet man endrer hostname på en minion, gjør følgende for å få det oppdatert i salt: Stop salt-minion på den berørte maskinen. Slett nøkkelen til maskinen fra salt-master ved å kjøre <code><nowiki>salt-key -d minion_id</nowiki></code> på salt-masteren. Slett <code><nowiki>/etc/salt/minion/minion_id</nowiki></code>. Start salt-minion service-en. Autoriser den nye nøkkelen med det nye navnet i salt-master.

Husk å legge nyoppsatte maskiner til i riktige [[Drift/Salt#Grains|grains (grupper)]].

== Gjøre endringer ==

Endringer gjøres på salt-masteren (salt.pvv.ntnu.no, som for tiden peker på lommel.pvv.ntnu.no). Alle endringer gjøres som din personlige bruker.

=== Opprette bruker på salt-masteren ===
Om du ikke har en bruker, logg inn som root på serveren og lag en. Adduser vil spørre deg om «Current Kerberos password», men du kan bare trykke enter og si nei til å prøve igjen, så fungerer det fint.

<pre>
lommel ~ # adduser johndoe
Adding user `johndoe' ...
Adding new group `johndoe' (1000) ...
Adding new user `johndoe' (1000) with group `johndoe' ...
Current Kerberos password:
Current Kerberos password:
passwd: Authentication token manipulation error
passwd: password unchanged
Try again? [y/N] n
Changing the user information for johndoe
Enter the new value, or press ENTER for the default
Full Name []: John Doe
Room Number []:
Work Phone []:
Home Phone []:
Other []:
Is the information correct? [Y/n]
</pre>

Passordet du bruker vil være det samme som admin-principalen din i Kerberos har, altså johndoe/admin i eksempelet over. Om du ikke har en admin-principal, se [[Drift/Kerberos#Lage_admin-principal]].

=== Gjøre endringer ===

Når du logger inn første gang vil du automatisk få sjekket ut salt-treet i ~/salt. Gjør endringene dine der inne, og push master til origin for å aktivere endringene.

Det kan være lurt å teste med en maskin først, ved å logge inn på den og gjøre en dry-run (du kan kjøre kommandoer rett fra salt-masteren også, men det er uansett en fordel å ha et skall på maskinen i tilfelle noe går galt):

<pre>
salt-call state.highstate test=True
</pre>

==== Teste endringer før commit ====

PVV har et lite triks som oppretter et salt-environment [https://docs.saltstack.com/en/latest/ref/states/top.html#multiple-environments] for hver bruker. Dette gjør at du kan teste koden din på en minion uten å committe. Det gjør du slik:

<pre>
salt-call state.highstate saltenv="$LOGNAME" test=True
</pre>

== Grains ==
Salt kan bruke grains for å gjøre noe på en gruppe med maskiner. <code><nowiki>salt 'hostname*' grains.items</nowiki></code> viser alle grains hostname er med i. For eksempel kan man si <code><nowiki>salt -G 'os_familt:Debian' test.ping</nowiki></code> for å pinge maskiner som er basert på Debian.

For å legge en minion til en gruppe gjør følgende på minion-en:

=== Konfigurasjon ===
<pre>$ vim /etc/salt/grains

roles:
- standard
- desktop
</pre>

I skrivende stund har vi følgende roller:

{|
|standard
|Alle maskiner med standard-oppsett (det vil si at brukere kan logge inn der)
|-
|desktop
|Desktopmaskiner
|-
|file-server
|Filservere, som f.eks. microbel.
|-
|mysql-server
|MySQL-serveren
|-
|postgresql-server
|PostGreSQL-serveren
|-
|web-frontend
|Web-frontend (ikke den som hoster brukerenes hjemmesider)
|-
|web-homes
|Web-backend for brukeres hjemmesider
|-
|fwlogin
|Maskinen lytter på SSH på port 80 og 443
|-
|salt-master
|salt-masteren (skal ikke ha standardoppsett)
|}

Når minions har blitt lagt til i roller er det viktig å huske på å synkronisere disse med masteren. Den letteste måten å gjøre det på er å kjøre <code><nowiki>salt '*' saltutil.sync_grains</nowiki></code> fra salt-masteren.

For å nå maskiner gjennom egendefinerte grains bruk <code><nowiki>salt -G 'attributt:verdi' kommando</nowiki></code>. Et eksempel er <code><nowiki>salt -G 'roles:workstation' test.ping</nowiki></code>.

== Tekniske ting ==

Litt nyttig info om hvordan ting fungerer under panseret

=== Distribuere mapper ===

Lag en overordnet mappe som inneholder både mappen du ønsker å distribuere og en sls-fil i salt-mappen: <code><nowiki>/srv/salt/overordnet_mappe</nowiki></code>. Der legger du mappen du ønsker å distribuere, og lager en fil du kaller for <code><nowiki>init.sls</nowiki></code>. Den formateres slik:

<pre><nowiki>
/path/til/der/du/vil/at/mappen/skal/ende/opp/på/minions
file.recurse:
- source: salt://overornet_mappe/mappen_du_vil_distribuere
#optional felter:
- include_empty: True #sørger for at tomme undermapper kommer med
- dir_mode: 777 #må bruke dir_mode når man dister mapper, bruk mode: hvis du dister filer
- user: brukernavn #hilken bruker skal mappen, undermapper og filer tilhøre
- group: eall_s #default-gruppen er root. Skal mappen tilhøre noen andre bruk eall_s eksplisitt
</nowiki></pre>

For å så få distribuert mappen kjør følgende kommando: <code><nowiki>salt '*' state.sls overordnet_mappe</nowiki></code>

=== States og håndheving ===

Salt oppererer med SLS filer (SaLt State) for å holde orden på reglene for distribusjon og hvordan disse skal håndheves. Legg SLS filene i <code><nowiki>/srv/salt/</nowiki></code>. En av de viktigste SLS filene er <code><nowiki>/srv/salt/top.sls</nowiki></code> da den spesifiserer hvilke SLS filer som skal anvendes på hvilke minions. (Alle sls-filene er på salt-master.)

For eksempel hvis vi har SLS filene:
<pre>
/srv/salt/top.sls
/srv/salt/common/init.sls
/srv/salt/common/packages.sls
/srv/salt/sl_eksempel.sls
</pre>

La så filene se slik ut:
<pre>
#top.sls:
base:
'*':
- common
'roles:desktop':
- match: grain
- sl_eksempel
</pre>
<pre>
#common/init.sls:
include:
- common.packages
</pre>
<pre>
#common/packages.sls:
vim:
pkg:
- installed
grep:
pkg:
- installed
</pre>
<pre>
#sl_eksempel.sls:
sl:
pkg:
- installed
</pre>

Hva filene sier:
* <code><nowiki>top.sls</nowiki></code> sier at at alle maskiner skal få staten som er spesifisert i 'common'. Siden 'common' er en mappe og ikke en SLS fil vil det implisitt bety at staten som er gitt i <code><nowiki>common/init.sls</nowiki></code> brukes istedenfor.
** Den sier også at alle maskiner som matcher grainen <code><nowiki>roles:desktop</nowiki></code> skal ha staten spesifisert i <code><nowiki>sl_eksempel.sls</nowiki></code>
* <code><nowiki>common/init.sls</nowiki></code> starter med å ved includen si at alt som er i <code><nowiki>/srv/salt/common/packages</nowiki></code> også skal kjøres i tillegg til innholdet den har (som for dette eksempelet er ikke noe mer)
* <code><nowiki>packages.sls</nowiki></code> sier at to pakker, vim og grep, skal være installert på alle maskiner som hører til staten.
* <code><nowiki>sl_eksempel.sls</nowiki></code> sier at pakken sl skal være installert.

For at minionsene skal gå inn å sjekke hvilke states de skal ha, og anvende dem, kjør: 
<code><nowiki>salt '*' state.highstate</nowiki></code> 
på salt-master.

=== Sørg for at Salt-minion er kjørende og at den jevnlig poller om nye ting fra master ===

Lag en mappe <code><nowiki>/srv/salt/minion_configuration</nowiki></code> som inneholder en <code><nowiki>init.sls</nowiki></code> fil og en <code><nowiki>minion</nowiki></code> fil. La <code><nowiki>init.sls</nowiki></code> se slik ut:

<pre>
salt-minion: # sier at det er salt-minion servicen vi påvirker
service:
# sier at den skal være kjørende:
- running
- enable: True
# sier at servicen skal restartes om man merker en endring i den oppgitte filen:
- watch:
- file /etc/salt/minion
/etc/salt/minion: #sier at denne filen skal speile den oppgitte fra master
file.managed:
# filen som skal kopieres over til minionen
- source salt://minion_configuration/minion
# bruker, gruppe, og premissions for filen når den ender opp på minionen:
- user: root
- group: root
- mode: 644
# sier at filen er et jinjatemplate, og at variablene i templatet skal byttes ut
# med verdiene gitt for dem i context-seksjonen:
- template: jinja
- context:
saltmaster: lommel.pvv.ntnu.no
timer: 4
</pre>

Kopier så inn en minion-fil til <code><nowiki>/srv/salt/minion_configuration/minion</nowiki></code>, og legg til disse linjene:

<pre>
#sett inn under "#master: salt" eller istedenfor det som måtte stå på på linjen som begynner med "master:"
master: {{saltmaster}}

#sier at highstate skal schedules til å kjøre hver 'timer' time:
schedule:
highstate:
function: state.highstate
hours: {{ timer }}
</pre>

== Behandlig av errors og feilmeldinger som kan dukke opp ofte ==

=== No Top file or external nodes data matches found ===

Om salt sier dette:

<pre>
ID: states
Function: no.None
Result: False
Comment: No Top file or external nodes data matches found
Started:
Duration:
Changes:
</pre>

Betyr det sannsynligvis at du har glemt å sette noen roller i [[#Grains|/etc/salt/grains]]

=== UnicodeDecodeError ===

Hvis du får «UnicodeDecodeError: 'ascii' codec can't decode byte 0xc2 in position 99: ordinal not in range» eller lignende kommer dette av en kjent feil i Salt: https://github.com/saltstack/salt/issues/16139

Dette skjer mye oftere om du har gammel salt. Prøv dette:

<pre>
echo deb http://debian.saltstack.com/debian $(lsb_release -c | awk '{print $2}')-saltstack main > /etc/apt/sources.list.d/saltstack.list
aptitude update && aptitude dist-upgrade
</pre>

=== No matching sls found ===
Hvis du får feilen: 
<code><nowiki>No matching sls found for 'sls_file_or_folder_name' in env 'base'</nowiki></code> 
Så har du sannsynligvis skrevet <code><nowiki>filnavn.sls</nowiki></code> (må være uten <code><nowiki>.sls</nowiki></code>), eller mappenavnet feil.

== Nyttige kommandoer og syntax ==

Viktig om syntax:
* All indentering er med mellomrom da tabs ser ut til å krasje, to ser ut til å være standard

Hvordan kopiere enkeltfiler ad-hoc fra salt-master til minions: 
<code><nowiki>salt-cp "*" /path/to/file/on/salt/master /path/to/file/on/minions</nowiki></code>

Hvordan kjøre kode på minions: 
<code><nowiki>salt "*" cmd.run "ps -e | grep salt"</nowiki></code>

For å kjøre på enkeltmaskiner istedenfor alle eller grains skriv inn navnet istedenfor <code><nowiki>"*"</nowiki></code>. Eksempel: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no cmd.run "ps -e | grep salt"</nowiki></code>

For å sjekke om en pakke er installer og hvilken versjon den har: 
<code><nowiki>salt "*" pkg.version "grep"</nowiki></code>

For å installere eller oppgradere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.install sl</nowiki></code>

For å avinstallere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.remove sl</nowiki></code>

For å se salt-pkg kommandoer: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.</nowiki></code> og spam tab.

Drift/Salt

2015-10-06T08:03:01Z

Knuta:

Salt er, som [[Drift/Puppet]], et system for å distribuere filer og sørge for at maskiner har samme oppsett.

== Sette opp ny salt minion ==

=== Installasjon ===
<pre>
ny-minion$ apt-get install salt-minion
ny-minion$ rediger /etc/salt/grains og legg til gruppene maskinen er i, se dokumentasjonen for [[Drift/Salt#Grains|grains (grupper)]]
ny-minion$ service salt-minion restart
ny-minion$ ssh root@salt.pvv.ntnu.no
salt-master# salt-key -L
salt-master# salt-key -a hostname.pvv.ntnu.no
salt-master# salt hostname.pvv.ntnu.no saltutil.sync_grains
salt-master# salt hostname.pvv.ntnu.no state.sls minion_configuration
ny-minion$ salt-call state.highstate saltenv=base
</pre>

Hvis alt har har gått bra, vil pingtesten gi true for maskinen din nå. Hvis ikke, kjør <code><nowiki>service salt-minion status</nowiki></code> som root på din nye minion for å få hint om hva som er galt. Konfigurasjonsfilen til salt ligger i <code><nowiki>/etc/salt/minion</nowiki></code>.

I tilfellet man endrer hostname på en minion, gjør følgende for å få det oppdatert i salt: Stop salt-minion på den berørte maskinen. Slett nøkkelen til maskinen fra salt-master ved å kjøre <code><nowiki>salt-key -d minion_id</nowiki></code> på salt-masteren. Slett <code><nowiki>/etc/salt/minion/minion_id</nowiki></code>. Start salt-minion service-en. Autoriser den nye nøkkelen med det nye navnet i salt-master.

Husk å legge nyoppsatte maskiner til i riktige [[Drift/Salt#Grains|grains (grupper)]].

== Gjøre endringer ==

Endringer gjøres på salt-masteren (salt.pvv.ntnu.no, som for tiden peker på lommel.pvv.ntnu.no). Alle endringer gjøres som din personlige bruker.

=== Opprette bruker på salt-masteren ===
Om du ikke har en bruker, logg inn som root på serveren og lag en. Adduser vil spørre deg om «Current Kerberos password», men du kan bare trykke enter og si nei til å prøve igjen, så fungerer det fint.

<pre>
lommel ~ # adduser johndoe
Adding user `johndoe' ...
Adding new group `johndoe' (1000) ...
Adding new user `johndoe' (1000) with group `johndoe' ...
Current Kerberos password:
Current Kerberos password:
passwd: Authentication token manipulation error
passwd: password unchanged
Try again? [y/N] n
Changing the user information for johndoe
Enter the new value, or press ENTER for the default
Full Name []: John Doe
Room Number []:
Work Phone []:
Home Phone []:
Other []:
Is the information correct? [Y/n]
</pre>

Passordet du bruker vil være det samme som admin-principalen din i Kerberos har, altså johndoe/admin i eksempelet over. Om du ikke har en admin-principal, se [[Drift/Kerberos#Lage_admin-principal]].

=== Gjøre endringer ===

Når du logger inn første gang vil du automatisk få sjekket ut salt-treet i ~/salt. Gjør endringene dine der inne, og push master til origin for å aktivere endringene.

Det kan være lurt å teste med en maskin først, ved å logge inn på den og gjøre en dry-run (du kan kjøre kommandoer rett fra salt-masteren også, men det er uansett en fordel å ha et skall på maskinen i tilfelle noe går galt):

<pre>
salt-call state.highstate test=True
</pre>

==== Teste endringer før commit ====

PVV har et lite triks som oppretter et salt-environment [https://docs.saltstack.com/en/latest/ref/states/top.html#multiple-environments] for hver bruker. Dette gjør at du kan teste koden din på en minion uten å committe. Det gjør du slik:

<pre>
salt-call state.highstate saltenv="$LOGNAME" test=True
</pre>

== Grains ==
Salt kan bruke grains for å gjøre noe på en gruppe med maskiner. <code><nowiki>salt 'hostname*' grains.items</nowiki></code> viser alle grains hostname er med i. For eksempel kan man si <code><nowiki>salt -G 'os_familt:Debian' test.ping</nowiki></code> for å pinge maskiner som er basert på Debian.

For å legge en minion til en gruppe gjør følgende på minion-en:

=== Konfigurasjon ===
<pre>$ vim /etc/salt/grains

roles:
- standard
- desktop
</pre>

I skrivende stund har vi følgende roller:

{|
|standard
|Alle maskiner med standard-oppsett (det vil si at brukere kan logge inn der)
|-
| desktop
| Desktopmaskiner
|-
|file-server
|Filservere, som f.eks. microbel.
|-
| mysql-server
| Mysql-serveren
|-
| web-frontend
| Web-frontend (ikke den som hoster brukerenes hjemmesider)
|-
| web-homes
| Web-backend for brukeres hjemmesider
|-
| wiki
| Mediawiki-serveren
|-
| pkgsync
| Maskinen bruker pkgsync for pakker
|-
| fwlogin
| Maskinen lytter på SSH på port 80 og 443
|-
|salt-master
|salt-masteren (skal ikke ha standardoppsett)
|}

Når minions har blitt lagt til i roller er det viktig å huske på å synkronisere disse med masteren. Den letteste måten å gjøre det på er å kjøre <code><nowiki>salt '*' saltutil.sync_grains</nowiki></code> fra salt-masteren.

For å nå maskiner gjennom egendefinerte grains bruk <code><nowiki>salt -G 'attributt:verdi' kommando</nowiki></code>. Et eksempel er <code><nowiki>salt -G 'roles:workstation' test.ping</nowiki></code>.

== Tekniske ting ==

Litt nyttig info om hvordan ting fungerer under panseret

=== Distribuere mapper ===

Lag en overordnet mappe som inneholder både mappen du ønsker å distribuere og en sls-fil i salt-mappen: <code><nowiki>/srv/salt/overordnet_mappe</nowiki></code>. Der legger du mappen du ønsker å distribuere, og lager en fil du kaller for <code><nowiki>init.sls</nowiki></code>. Den formateres slik:

<pre><nowiki>
/path/til/der/du/vil/at/mappen/skal/ende/opp/på/minions
file.recurse:
- source: salt://overornet_mappe/mappen_du_vil_distribuere
#optional felter:
- include_empty: True #sørger for at tomme undermapper kommer med
- dir_mode: 777 #må bruke dir_mode når man dister mapper, bruk mode: hvis du dister filer
- user: brukernavn #hilken bruker skal mappen, undermapper og filer tilhøre
- group: eall_s #default-gruppen er root. Skal mappen tilhøre noen andre bruk eall_s eksplisitt
</nowiki></pre>

For å så få distribuert mappen kjør følgende kommando: <code><nowiki>salt '*' state.sls overordnet_mappe</nowiki></code>

=== States og håndheving ===

Salt oppererer med SLS filer (SaLt State) for å holde orden på reglene for distribusjon og hvordan disse skal håndheves. Legg SLS filene i <code><nowiki>/srv/salt/</nowiki></code>. En av de viktigste SLS filene er <code><nowiki>/srv/salt/top.sls</nowiki></code> da den spesifiserer hvilke SLS filer som skal anvendes på hvilke minions. (Alle sls-filene er på salt-master.)

For eksempel hvis vi har SLS filene:
<pre>
/srv/salt/top.sls
/srv/salt/common/init.sls
/srv/salt/common/packages.sls
/srv/salt/sl_eksempel.sls
</pre>

La så filene se slik ut:
<pre>
#top.sls:
base:
'*':
- common
'roles:desktop':
- match: grain
- sl_eksempel
</pre>
<pre>
#common/init.sls:
include:
- common.packages
</pre>
<pre>
#common/packages.sls:
vim:
pkg:
- installed
grep:
pkg:
- installed
</pre>
<pre>
#sl_eksempel.sls:
sl:
pkg:
- installed
</pre>

Hva filene sier:
* <code><nowiki>top.sls</nowiki></code> sier at at alle maskiner skal få staten som er spesifisert i 'common'. Siden 'common' er en mappe og ikke en SLS fil vil det implisitt bety at staten som er gitt i <code><nowiki>common/init.sls</nowiki></code> brukes istedenfor.
** Den sier også at alle maskiner som matcher grainen <code><nowiki>roles:desktop</nowiki></code> skal ha staten spesifisert i <code><nowiki>sl_eksempel.sls</nowiki></code>
* <code><nowiki>common/init.sls</nowiki></code> starter med å ved includen si at alt som er i <code><nowiki>/srv/salt/common/packages</nowiki></code> også skal kjøres i tillegg til innholdet den har (som for dette eksempelet er ikke noe mer)
* <code><nowiki>packages.sls</nowiki></code> sier at to pakker, vim og grep, skal være installert på alle maskiner som hører til staten.
* <code><nowiki>sl_eksempel.sls</nowiki></code> sier at pakken sl skal være installert.

For at minionsene skal gå inn å sjekke hvilke states de skal ha, og anvende dem, kjør: 
<code><nowiki>salt '*' state.highstate</nowiki></code> 
på salt-master.

=== Sørg for at Salt-minion er kjørende og at den jevnlig poller om nye ting fra master ===

Lag en mappe <code><nowiki>/srv/salt/minion_configuration</nowiki></code> som inneholder en <code><nowiki>init.sls</nowiki></code> fil og en <code><nowiki>minion</nowiki></code> fil. La <code><nowiki>init.sls</nowiki></code> se slik ut:

<pre>
salt-minion: # sier at det er salt-minion servicen vi påvirker
service:
# sier at den skal være kjørende:
- running
- enable: True
# sier at servicen skal restartes om man merker en endring i den oppgitte filen:
- watch:
- file /etc/salt/minion
/etc/salt/minion: #sier at denne filen skal speile den oppgitte fra master
file.managed:
# filen som skal kopieres over til minionen
- source salt://minion_configuration/minion
# bruker, gruppe, og premissions for filen når den ender opp på minionen:
- user: root
- group: root
- mode: 644
# sier at filen er et jinjatemplate, og at variablene i templatet skal byttes ut
# med verdiene gitt for dem i context-seksjonen:
- template: jinja
- context:
saltmaster: lommel.pvv.ntnu.no
timer: 4
</pre>

Kopier så inn en minion-fil til <code><nowiki>/srv/salt/minion_configuration/minion</nowiki></code>, og legg til disse linjene:

<pre>
#sett inn under "#master: salt" eller istedenfor det som måtte stå på på linjen som begynner med "master:"
master: {{saltmaster}}

#sier at highstate skal schedules til å kjøre hver 'timer' time:
schedule:
highstate:
function: state.highstate
hours: {{ timer }}
</pre>

== Behandlig av errors og feilmeldinger som kan dukke opp ofte ==

=== No Top file or external nodes data matches found ===

Om salt sier dette:

<pre>
ID: states
Function: no.None
Result: False
Comment: No Top file or external nodes data matches found
Started:
Duration:
Changes:
</pre>

Betyr det sannsynligvis at du har glemt å sette noen roller i [[#Grains|/etc/salt/grains]]

=== UnicodeDecodeError ===

Hvis du får «UnicodeDecodeError: 'ascii' codec can't decode byte 0xc2 in position 99: ordinal not in range» eller lignende kommer dette av en kjent feil i Salt: https://github.com/saltstack/salt/issues/16139

Dette skjer mye oftere om du har gammel salt. Prøv dette:

<pre>
echo deb http://debian.saltstack.com/debian $(lsb_release -c | awk '{print $2}')-saltstack main > /etc/apt/sources.list.d/saltstack.list
aptitude update && aptitude dist-upgrade
</pre>

=== No matching sls found ===
Hvis du får feilen: 
<code><nowiki>No matching sls found for 'sls_file_or_folder_name' in env 'base'</nowiki></code> 
Så har du sannsynligvis skrevet <code><nowiki>filnavn.sls</nowiki></code> (må være uten <code><nowiki>.sls</nowiki></code>), eller mappenavnet feil.

== Nyttige kommandoer og syntax ==

Viktig om syntax:
* All indentering er med mellomrom da tabs ser ut til å krasje, to ser ut til å være standard

Hvordan kopiere enkeltfiler ad-hoc fra salt-master til minions: 
<code><nowiki>salt-cp "*" /path/to/file/on/salt/master /path/to/file/on/minions</nowiki></code>

Hvordan kjøre kode på minions: 
<code><nowiki>salt "*" cmd.run "ps -e | grep salt"</nowiki></code>

For å kjøre på enkeltmaskiner istedenfor alle eller grains skriv inn navnet istedenfor <code><nowiki>"*"</nowiki></code>. Eksempel: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no cmd.run "ps -e | grep salt"</nowiki></code>

For å sjekke om en pakke er installer og hvilken versjon den har: 
<code><nowiki>salt "*" pkg.version "grep"</nowiki></code>

For å installere eller oppgradere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.install sl</nowiki></code>

For å avinstallere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.remove sl</nowiki></code>

For å se salt-pkg kommandoer: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.</nowiki></code> og spam tab.

Drift/Salt

2015-10-06T07:15:30Z

Knuta: /* Teste endringer før commit */

Salt er, som [[Drift/Puppet]], et system for å distribuere filer og sørge for at maskiner har samme oppsett.

== Sette opp ny salt minion ==

=== Installasjon ===
<pre>
ny-minion$ apt-get install salt-minion
ny-minion$ rediger /etc/salt/grains og legg til gruppene maskinen er i, se dokumentasjonen for [[Drift/Salt#Grains|grains (grupper)]]
ny-minion$ service salt-minion restart
ny-minion$ ssh root@salt.pvv.ntnu.no
salt-master# salt-key -L
salt-master# salt-key -a hostname.pvv.ntnu.no
salt-master# salt hostname.pvv.ntnu.no saltutil.sync_grains
salt-master# salt hostname.pvv.ntnu.no state.sls minion_configuration
</pre>

Hvis alt har har gått bra, vil pingtesten gi true for maskinen din nå. Hvis ikke, kjør <code><nowiki>service salt-minion status</nowiki></code> som root på din nye minion for å få hint om hva som er galt. Konfigurasjonsfilen til salt ligger i <code><nowiki>/etc/salt/minion</nowiki></code>.

I tilfellet man endrer hostname på en minion, gjør følgende for å få det oppdatert i salt: Stop salt-minion på den berørte maskinen. Slett nøkkelen til maskinen fra salt-master ved å kjøre <code><nowiki>salt-key -d minion_id</nowiki></code> på salt-masteren. Slett <code><nowiki>/etc/salt/minion/minion_id</nowiki></code>. Start salt-minion service-en. Autoriser den nye nøkkelen med det nye navnet i salt-master.

Husk å legge nyoppsatte maskiner til i riktige [[Drift/Salt#Grains|grains (grupper)]].

== Gjøre endringer ==

Endringer gjøres på salt-masteren (salt.pvv.ntnu.no, som for tiden peker på lommel.pvv.ntnu.no). Alle endringer gjøres som din personlige bruker.

=== Opprette bruker på salt-masteren ===
Om du ikke har en bruker, logg inn som root på serveren og lag en. Adduser vil spørre deg om «Current Kerberos password», men du kan bare trykke enter og si nei til å prøve igjen, så fungerer det fint.

<pre>
lommel ~ # adduser johndoe
Adding user `johndoe' ...
Adding new group `johndoe' (1000) ...
Adding new user `johndoe' (1000) with group `johndoe' ...
Current Kerberos password:
Current Kerberos password:
passwd: Authentication token manipulation error
passwd: password unchanged
Try again? [y/N] n
Changing the user information for johndoe
Enter the new value, or press ENTER for the default
Full Name []: John Doe
Room Number []:
Work Phone []:
Home Phone []:
Other []:
Is the information correct? [Y/n]
</pre>

Passordet du bruker vil være det samme som admin-principalen din i Kerberos har, altså johndoe/admin i eksempelet over. Om du ikke har en admin-principal, se [[Drift/Kerberos#Lage_admin-principal]].

=== Gjøre endringer ===

Når du logger inn første gang vil du automatisk få sjekket ut salt-treet i ~/salt. Gjør endringene dine der inne, og push master til origin for å aktivere endringene.

Det kan være lurt å teste med en maskin først, ved å logge inn på den og gjøre en dry-run (du kan kjøre kommandoer rett fra salt-masteren også, men det er uansett en fordel å ha et skall på maskinen i tilfelle noe går galt):

<pre>
salt-call state.highstate test=True
</pre>

==== Teste endringer før commit ====

PVV har et lite triks som oppretter et salt-environment [https://docs.saltstack.com/en/latest/ref/states/top.html#multiple-environments] for hver bruker. Dette gjør at du kan teste koden din på en minion uten å committe. Det gjør du slik:

<pre>
salt-call state.highstate saltenv="$LOGNAME" test=True
</pre>

== Grains ==
Salt kan bruke grains for å gjøre noe på en gruppe med maskiner. <code><nowiki>salt 'hostname*' grains.items</nowiki></code> viser alle grains hostname er med i. For eksempel kan man si <code><nowiki>salt -G 'os_familt:Debian' test.ping</nowiki></code> for å pinge maskiner som er basert på Debian.

For å legge en minion til en gruppe gjør følgende på minion-en:

=== Konfigurasjon ===
<pre>$ vim /etc/salt/grains

roles:
- standard
- desktop
</pre>

I skrivende stund har vi følgende roller:

{|
|standard
|Alle maskiner med standard-oppsett (det vil si at brukere kan logge inn der)
|-
| desktop
| Desktopmaskiner
|-
|file-server
|Filservere, som f.eks. microbel.
|-
| mysql-server
| Mysql-serveren
|-
| web-frontend
| Web-frontend (ikke den som hoster brukerenes hjemmesider)
|-
| web-homes
| Web-backend for brukeres hjemmesider
|-
| wiki
| Mediawiki-serveren
|-
| pkgsync
| Maskinen bruker pkgsync for pakker
|-
| fwlogin
| Maskinen lytter på SSH på port 80 og 443
|-
|salt-master
|salt-masteren (skal ikke ha standardoppsett)
|}

Når minions har blitt lagt til i roller er det viktig å huske på å synkronisere disse med masteren. Den letteste måten å gjøre det på er å kjøre <code><nowiki>salt '*' saltutil.sync_grains</nowiki></code> fra salt-masteren.

For å nå maskiner gjennom egendefinerte grains bruk <code><nowiki>salt -G 'attributt:verdi' kommando</nowiki></code>. Et eksempel er <code><nowiki>salt -G 'roles:workstation' test.ping</nowiki></code>.

== Tekniske ting ==

Litt nyttig info om hvordan ting fungerer under panseret

=== Distribuere mapper ===

Lag en overordnet mappe som inneholder både mappen du ønsker å distribuere og en sls-fil i salt-mappen: <code><nowiki>/srv/salt/overordnet_mappe</nowiki></code>. Der legger du mappen du ønsker å distribuere, og lager en fil du kaller for <code><nowiki>init.sls</nowiki></code>. Den formateres slik:

<pre><nowiki>
/path/til/der/du/vil/at/mappen/skal/ende/opp/på/minions
file.recurse:
- source: salt://overornet_mappe/mappen_du_vil_distribuere
#optional felter:
- include_empty: True #sørger for at tomme undermapper kommer med
- dir_mode: 777 #må bruke dir_mode når man dister mapper, bruk mode: hvis du dister filer
- user: brukernavn #hilken bruker skal mappen, undermapper og filer tilhøre
- group: eall_s #default-gruppen er root. Skal mappen tilhøre noen andre bruk eall_s eksplisitt
</nowiki></pre>

For å så få distribuert mappen kjør følgende kommando: <code><nowiki>salt '*' state.sls overordnet_mappe</nowiki></code>

=== States og håndheving ===

Salt oppererer med SLS filer (SaLt State) for å holde orden på reglene for distribusjon og hvordan disse skal håndheves. Legg SLS filene i <code><nowiki>/srv/salt/</nowiki></code>. En av de viktigste SLS filene er <code><nowiki>/srv/salt/top.sls</nowiki></code> da den spesifiserer hvilke SLS filer som skal anvendes på hvilke minions. (Alle sls-filene er på salt-master.)

For eksempel hvis vi har SLS filene:
<pre>
/srv/salt/top.sls
/srv/salt/common/init.sls
/srv/salt/common/packages.sls
/srv/salt/sl_eksempel.sls
</pre>

La så filene se slik ut:
<pre>
#top.sls:
base:
'*':
- common
'roles:desktop':
- match: grain
- sl_eksempel
</pre>
<pre>
#common/init.sls:
include:
- common.packages
</pre>
<pre>
#common/packages.sls:
vim:
pkg:
- installed
grep:
pkg:
- installed
</pre>
<pre>
#sl_eksempel.sls:
sl:
pkg:
- installed
</pre>

Hva filene sier:
* <code><nowiki>top.sls</nowiki></code> sier at at alle maskiner skal få staten som er spesifisert i 'common'. Siden 'common' er en mappe og ikke en SLS fil vil det implisitt bety at staten som er gitt i <code><nowiki>common/init.sls</nowiki></code> brukes istedenfor.
** Den sier også at alle maskiner som matcher grainen <code><nowiki>roles:desktop</nowiki></code> skal ha staten spesifisert i <code><nowiki>sl_eksempel.sls</nowiki></code>
* <code><nowiki>common/init.sls</nowiki></code> starter med å ved includen si at alt som er i <code><nowiki>/srv/salt/common/packages</nowiki></code> også skal kjøres i tillegg til innholdet den har (som for dette eksempelet er ikke noe mer)
* <code><nowiki>packages.sls</nowiki></code> sier at to pakker, vim og grep, skal være installert på alle maskiner som hører til staten.
* <code><nowiki>sl_eksempel.sls</nowiki></code> sier at pakken sl skal være installert.

For at minionsene skal gå inn å sjekke hvilke states de skal ha, og anvende dem, kjør: 
<code><nowiki>salt '*' state.highstate</nowiki></code> 
på salt-master.

=== Sørg for at Salt-minion er kjørende og at den jevnlig poller om nye ting fra master ===

Lag en mappe <code><nowiki>/srv/salt/minion_configuration</nowiki></code> som inneholder en <code><nowiki>init.sls</nowiki></code> fil og en <code><nowiki>minion</nowiki></code> fil. La <code><nowiki>init.sls</nowiki></code> se slik ut:

<pre>
salt-minion: # sier at det er salt-minion servicen vi påvirker
service:
# sier at den skal være kjørende:
- running
- enable: True
# sier at servicen skal restartes om man merker en endring i den oppgitte filen:
- watch:
- file /etc/salt/minion
/etc/salt/minion: #sier at denne filen skal speile den oppgitte fra master
file.managed:
# filen som skal kopieres over til minionen
- source salt://minion_configuration/minion
# bruker, gruppe, og premissions for filen når den ender opp på minionen:
- user: root
- group: root
- mode: 644
# sier at filen er et jinjatemplate, og at variablene i templatet skal byttes ut
# med verdiene gitt for dem i context-seksjonen:
- template: jinja
- context:
saltmaster: lommel.pvv.ntnu.no
timer: 4
</pre>

Kopier så inn en minion-fil til <code><nowiki>/srv/salt/minion_configuration/minion</nowiki></code>, og legg til disse linjene:

<pre>
#sett inn under "#master: salt" eller istedenfor det som måtte stå på på linjen som begynner med "master:"
master: {{saltmaster}}

#sier at highstate skal schedules til å kjøre hver 'timer' time:
schedule:
highstate:
function: state.highstate
hours: {{ timer }}
</pre>

== Behandlig av errors og feilmeldinger som kan dukke opp ofte ==

=== No Top file or external nodes data matches found ===

Om salt sier dette:

<pre>
ID: states
Function: no.None
Result: False
Comment: No Top file or external nodes data matches found
Started:
Duration:
Changes:
</pre>

Betyr det sannsynligvis at du har glemt å sette noen roller i [[#Grains|/etc/salt/grains]]

=== UnicodeDecodeError ===

Hvis du får «UnicodeDecodeError: 'ascii' codec can't decode byte 0xc2 in position 99: ordinal not in range» eller lignende kommer dette av en kjent feil i Salt: https://github.com/saltstack/salt/issues/16139

Dette skjer mye oftere om du har gammel salt. Prøv dette:

<pre>
echo deb http://debian.saltstack.com/debian $(lsb_release -c | awk '{print $2}')-saltstack main > /etc/apt/sources.list.d/saltstack.list
aptitude update && aptitude dist-upgrade
</pre>

=== No matching sls found ===
Hvis du får feilen: 
<code><nowiki>No matching sls found for 'sls_file_or_folder_name' in env 'base'</nowiki></code> 
Så har du sannsynligvis skrevet <code><nowiki>filnavn.sls</nowiki></code> (må være uten <code><nowiki>.sls</nowiki></code>), eller mappenavnet feil.

== Nyttige kommandoer og syntax ==

Viktig om syntax:
* All indentering er med mellomrom da tabs ser ut til å krasje, to ser ut til å være standard

Hvordan kopiere enkeltfiler ad-hoc fra salt-master til minions: 
<code><nowiki>salt-cp "*" /path/to/file/on/salt/master /path/to/file/on/minions</nowiki></code>

Hvordan kjøre kode på minions: 
<code><nowiki>salt "*" cmd.run "ps -e | grep salt"</nowiki></code>

For å kjøre på enkeltmaskiner istedenfor alle eller grains skriv inn navnet istedenfor <code><nowiki>"*"</nowiki></code>. Eksempel: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no cmd.run "ps -e | grep salt"</nowiki></code>

For å sjekke om en pakke er installer og hvilken versjon den har: 
<code><nowiki>salt "*" pkg.version "grep"</nowiki></code>

For å installere eller oppgradere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.install sl</nowiki></code>

For å avinstallere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.remove sl</nowiki></code>

For å se salt-pkg kommandoer: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.</nowiki></code> og spam tab.

Drift/Salt

2015-10-06T06:43:00Z

Knuta: /* Gjøre endringer */

Salt er, som [[Drift/Puppet]], et system for å distribuere filer og sørge for at maskiner har samme oppsett.

== Sette opp ny salt minion ==

=== Installasjon ===
<pre>
ny-minion$ apt-get install salt-minion
ny-minion$ rediger /etc/salt/grains og legg til gruppene maskinen er i, se dokumentasjonen for [[Drift/Salt#Grains|grains (grupper)]]
ny-minion$ service salt-minion restart
ny-minion$ ssh root@salt.pvv.ntnu.no
salt-master# salt-key -L
salt-master# salt-key -a hostname.pvv.ntnu.no
salt-master# salt hostname.pvv.ntnu.no saltutil.sync_grains
salt-master# salt hostname.pvv.ntnu.no state.sls minion_configuration
</pre>

Hvis alt har har gått bra, vil pingtesten gi true for maskinen din nå. Hvis ikke, kjør <code><nowiki>service salt-minion status</nowiki></code> som root på din nye minion for å få hint om hva som er galt. Konfigurasjonsfilen til salt ligger i <code><nowiki>/etc/salt/minion</nowiki></code>.

I tilfellet man endrer hostname på en minion, gjør følgende for å få det oppdatert i salt: Stop salt-minion på den berørte maskinen. Slett nøkkelen til maskinen fra salt-master ved å kjøre <code><nowiki>salt-key -d minion_id</nowiki></code> på salt-masteren. Slett <code><nowiki>/etc/salt/minion/minion_id</nowiki></code>. Start salt-minion service-en. Autoriser den nye nøkkelen med det nye navnet i salt-master.

Husk å legge nyoppsatte maskiner til i riktige [[Drift/Salt#Grains|grains (grupper)]].

== Gjøre endringer ==

Endringer gjøres på salt-masteren (salt.pvv.ntnu.no, som for tiden peker på lommel.pvv.ntnu.no). Alle endringer gjøres som din personlige bruker.

=== Opprette bruker på salt-masteren ===
Om du ikke har en bruker, logg inn som root på serveren og lag en. Adduser vil spørre deg om «Current Kerberos password», men du kan bare trykke enter og si nei til å prøve igjen, så fungerer det fint.

<pre>
lommel ~ # adduser johndoe
Adding user `johndoe' ...
Adding new group `johndoe' (1000) ...
Adding new user `johndoe' (1000) with group `johndoe' ...
Current Kerberos password:
Current Kerberos password:
passwd: Authentication token manipulation error
passwd: password unchanged
Try again? [y/N] n
Changing the user information for johndoe
Enter the new value, or press ENTER for the default
Full Name []: John Doe
Room Number []:
Work Phone []:
Home Phone []:
Other []:
Is the information correct? [Y/n]
</pre>

Passordet du bruker vil være det samme som admin-principalen din i Kerberos har, altså johndoe/admin i eksempelet over. Om du ikke har en admin-principal, se [[Drift/Kerberos#Lage_admin-principal]].

=== Gjøre endringer ===

Når du logger inn første gang vil du automatisk få sjekket ut salt-treet i ~/salt. Gjør endringene dine der inne, og push master til origin for å aktivere endringene.

Det kan være lurt å teste med en maskin først, ved å logge inn på den og gjøre en dry-run (du kan kjøre kommandoer rett fra salt-masteren også, men det er uansett en fordel å ha et skall på maskinen i tilfelle noe går galt):

<pre>
salt-call state.highstate test=True
</pre>

==== Teste endringer før commit ====

PVV har et lite triks som oppretter et salt-environment [https://docs.saltstack.com/en/latest/ref/states/top.html#multiple-environments] for hver bruker. Dette gjør at du kan teste koden din på en minion uten å committe. Det er bare ett lite caveat, du må justere top.sls og erstatte "base:" øverst med ditt eget brukernavn:

<pre>
-base:
+johndoe:
</pre>

Når det er gjort kan du teste på en minion:

<pre>
salt-call state.highstate saltenv="$LOGNAME" test=True
</pre>

Husk å ikke commite en top.sls med ditt eget brukernavn! Vi har en git-hook som prøver å forhindre dette:

<pre>
knuta@lommel:~/salt$ git commit -a
Commit failed: Removing 'base:' from top.sls is not allowed
</pre>

== Grains ==
Salt kan bruke grains for å gjøre noe på en gruppe med maskiner. <code><nowiki>salt 'hostname*' grains.items</nowiki></code> viser alle grains hostname er med i. For eksempel kan man si <code><nowiki>salt -G 'os_familt:Debian' test.ping</nowiki></code> for å pinge maskiner som er basert på Debian.

For å legge en minion til en gruppe gjør følgende på minion-en:

=== Konfigurasjon ===
<pre>$ vim /etc/salt/grains

roles:
- standard
- desktop
</pre>

I skrivende stund har vi følgende roller:

{|
|standard
|Alle maskiner med standard-oppsett (det vil si at brukere kan logge inn der)
|-
| desktop
| Desktopmaskiner
|-
|file-server
|Filservere, som f.eks. microbel.
|-
| mysql-server
| Mysql-serveren
|-
| web-frontend
| Web-frontend (ikke den som hoster brukerenes hjemmesider)
|-
| web-homes
| Web-backend for brukeres hjemmesider
|-
| wiki
| Mediawiki-serveren
|-
| pkgsync
| Maskinen bruker pkgsync for pakker
|-
| fwlogin
| Maskinen lytter på SSH på port 80 og 443
|-
|salt-master
|salt-masteren (skal ikke ha standardoppsett)
|}

Når minions har blitt lagt til i roller er det viktig å huske på å synkronisere disse med masteren. Den letteste måten å gjøre det på er å kjøre <code><nowiki>salt '*' saltutil.sync_grains</nowiki></code> fra salt-masteren.

For å nå maskiner gjennom egendefinerte grains bruk <code><nowiki>salt -G 'attributt:verdi' kommando</nowiki></code>. Et eksempel er <code><nowiki>salt -G 'roles:workstation' test.ping</nowiki></code>.

== Tekniske ting ==

Litt nyttig info om hvordan ting fungerer under panseret

=== Distribuere mapper ===

Lag en overordnet mappe som inneholder både mappen du ønsker å distribuere og en sls-fil i salt-mappen: <code><nowiki>/srv/salt/overordnet_mappe</nowiki></code>. Der legger du mappen du ønsker å distribuere, og lager en fil du kaller for <code><nowiki>init.sls</nowiki></code>. Den formateres slik:

<pre><nowiki>
/path/til/der/du/vil/at/mappen/skal/ende/opp/på/minions
file.recurse:
- source: salt://overornet_mappe/mappen_du_vil_distribuere
#optional felter:
- include_empty: True #sørger for at tomme undermapper kommer med
- dir_mode: 777 #må bruke dir_mode når man dister mapper, bruk mode: hvis du dister filer
- user: brukernavn #hilken bruker skal mappen, undermapper og filer tilhøre
- group: eall_s #default-gruppen er root. Skal mappen tilhøre noen andre bruk eall_s eksplisitt
</nowiki></pre>

For å så få distribuert mappen kjør følgende kommando: <code><nowiki>salt '*' state.sls overordnet_mappe</nowiki></code>

=== States og håndheving ===

Salt oppererer med SLS filer (SaLt State) for å holde orden på reglene for distribusjon og hvordan disse skal håndheves. Legg SLS filene i <code><nowiki>/srv/salt/</nowiki></code>. En av de viktigste SLS filene er <code><nowiki>/srv/salt/top.sls</nowiki></code> da den spesifiserer hvilke SLS filer som skal anvendes på hvilke minions. (Alle sls-filene er på salt-master.)

For eksempel hvis vi har SLS filene:
<pre>
/srv/salt/top.sls
/srv/salt/common/init.sls
/srv/salt/common/packages.sls
/srv/salt/sl_eksempel.sls
</pre>

La så filene se slik ut:
<pre>
#top.sls:
base:
'*':
- common
'roles:desktop':
- match: grain
- sl_eksempel
</pre>
<pre>
#common/init.sls:
include:
- common.packages
</pre>
<pre>
#common/packages.sls:
vim:
pkg:
- installed
grep:
pkg:
- installed
</pre>
<pre>
#sl_eksempel.sls:
sl:
pkg:
- installed
</pre>

Hva filene sier:
* <code><nowiki>top.sls</nowiki></code> sier at at alle maskiner skal få staten som er spesifisert i 'common'. Siden 'common' er en mappe og ikke en SLS fil vil det implisitt bety at staten som er gitt i <code><nowiki>common/init.sls</nowiki></code> brukes istedenfor.
** Den sier også at alle maskiner som matcher grainen <code><nowiki>roles:desktop</nowiki></code> skal ha staten spesifisert i <code><nowiki>sl_eksempel.sls</nowiki></code>
* <code><nowiki>common/init.sls</nowiki></code> starter med å ved includen si at alt som er i <code><nowiki>/srv/salt/common/packages</nowiki></code> også skal kjøres i tillegg til innholdet den har (som for dette eksempelet er ikke noe mer)
* <code><nowiki>packages.sls</nowiki></code> sier at to pakker, vim og grep, skal være installert på alle maskiner som hører til staten.
* <code><nowiki>sl_eksempel.sls</nowiki></code> sier at pakken sl skal være installert.

For at minionsene skal gå inn å sjekke hvilke states de skal ha, og anvende dem, kjør: 
<code><nowiki>salt '*' state.highstate</nowiki></code> 
på salt-master.

=== Sørg for at Salt-minion er kjørende og at den jevnlig poller om nye ting fra master ===

Lag en mappe <code><nowiki>/srv/salt/minion_configuration</nowiki></code> som inneholder en <code><nowiki>init.sls</nowiki></code> fil og en <code><nowiki>minion</nowiki></code> fil. La <code><nowiki>init.sls</nowiki></code> se slik ut:

<pre>
salt-minion: # sier at det er salt-minion servicen vi påvirker
service:
# sier at den skal være kjørende:
- running
- enable: True
# sier at servicen skal restartes om man merker en endring i den oppgitte filen:
- watch:
- file /etc/salt/minion
/etc/salt/minion: #sier at denne filen skal speile den oppgitte fra master
file.managed:
# filen som skal kopieres over til minionen
- source salt://minion_configuration/minion
# bruker, gruppe, og premissions for filen når den ender opp på minionen:
- user: root
- group: root
- mode: 644
# sier at filen er et jinjatemplate, og at variablene i templatet skal byttes ut
# med verdiene gitt for dem i context-seksjonen:
- template: jinja
- context:
saltmaster: lommel.pvv.ntnu.no
timer: 4
</pre>

Kopier så inn en minion-fil til <code><nowiki>/srv/salt/minion_configuration/minion</nowiki></code>, og legg til disse linjene:

<pre>
#sett inn under "#master: salt" eller istedenfor det som måtte stå på på linjen som begynner med "master:"
master: {{saltmaster}}

#sier at highstate skal schedules til å kjøre hver 'timer' time:
schedule:
highstate:
function: state.highstate
hours: {{ timer }}
</pre>

== Behandlig av errors og feilmeldinger som kan dukke opp ofte ==

=== No Top file or external nodes data matches found ===

Om salt sier dette:

<pre>
ID: states
Function: no.None
Result: False
Comment: No Top file or external nodes data matches found
Started:
Duration:
Changes:
</pre>

Betyr det sannsynligvis at du har glemt å sette noen roller i [[#Grains|/etc/salt/grains]]

=== UnicodeDecodeError ===

Hvis du får «UnicodeDecodeError: 'ascii' codec can't decode byte 0xc2 in position 99: ordinal not in range» eller lignende kommer dette av en kjent feil i Salt: https://github.com/saltstack/salt/issues/16139

Dette skjer mye oftere om du har gammel salt. Prøv dette:

<pre>
echo deb http://debian.saltstack.com/debian $(lsb_release -c | awk '{print $2}')-saltstack main > /etc/apt/sources.list.d/saltstack.list
aptitude update && aptitude dist-upgrade
</pre>

=== No matching sls found ===
Hvis du får feilen: 
<code><nowiki>No matching sls found for 'sls_file_or_folder_name' in env 'base'</nowiki></code> 
Så har du sannsynligvis skrevet <code><nowiki>filnavn.sls</nowiki></code> (må være uten <code><nowiki>.sls</nowiki></code>), eller mappenavnet feil.

== Nyttige kommandoer og syntax ==

Viktig om syntax:
* All indentering er med mellomrom da tabs ser ut til å krasje, to ser ut til å være standard

Hvordan kopiere enkeltfiler ad-hoc fra salt-master til minions: 
<code><nowiki>salt-cp "*" /path/to/file/on/salt/master /path/to/file/on/minions</nowiki></code>

Hvordan kjøre kode på minions: 
<code><nowiki>salt "*" cmd.run "ps -e | grep salt"</nowiki></code>

For å kjøre på enkeltmaskiner istedenfor alle eller grains skriv inn navnet istedenfor <code><nowiki>"*"</nowiki></code>. Eksempel: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no cmd.run "ps -e | grep salt"</nowiki></code>

For å sjekke om en pakke er installer og hvilken versjon den har: 
<code><nowiki>salt "*" pkg.version "grep"</nowiki></code>

For å installere eller oppgradere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.install sl</nowiki></code>

For å avinstallere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.remove sl</nowiki></code>

For å se salt-pkg kommandoer: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.</nowiki></code> og spam tab.

Drift/Salt

2015-10-05T07:38:01Z

Knuta:

Salt er, som [[Drift/Puppet]], et system for å distribuere filer og sørge for at maskiner har samme oppsett.

== Sette opp ny salt minion ==

=== Installasjon ===
<pre>
ny-minion$ apt-get install salt-minion
ny-minion$ rediger /etc/salt/grains og legg til gruppene maskinen er i, se dokumentasjonen for [[Drift/Salt#Grains|grains (grupper)]]
ny-minion$ service salt-minion restart
ny-minion$ ssh root@salt.pvv.ntnu.no
salt-master# salt-key -L
salt-master# salt-key -a hostname.pvv.ntnu.no
salt-master# salt hostname.pvv.ntnu.no saltutil.sync_grains
salt-master# salt hostname.pvv.ntnu.no state.sls minion_configuration
</pre>

Hvis alt har har gått bra, vil pingtesten gi true for maskinen din nå. Hvis ikke, kjør <code><nowiki>service salt-minion status</nowiki></code> som root på din nye minion for å få hint om hva som er galt. Konfigurasjonsfilen til salt ligger i <code><nowiki>/etc/salt/minion</nowiki></code>.

I tilfellet man endrer hostname på en minion, gjør følgende for å få det oppdatert i salt: Stop salt-minion på den berørte maskinen. Slett nøkkelen til maskinen fra salt-master ved å kjøre <code><nowiki>salt-key -d minion_id</nowiki></code> på salt-masteren. Slett <code><nowiki>/etc/salt/minion/minion_id</nowiki></code>. Start salt-minion service-en. Autoriser den nye nøkkelen med det nye navnet i salt-master.

Husk å legge nyoppsatte maskiner til i riktige [[Drift/Salt#Grains|grains (grupper)]].

== Gjøre endringer ==

Endringer gjøres på salt-masteren (salt.pvv.ntnu.no, som for tiden peker på lommel.pvv.ntnu.no). Alle endringer gjøres som din personlige bruker.

=== Opprette bruker på salt-masteren ===
Om du ikke har en bruker, logg inn som root på serveren og lag en. Adduser vil spørre deg om «Current Kerberos password», men du kan bare trykke enter og si nei til å prøve igjen, så fungerer det fint.

<pre>
lommel ~ # adduser johndoe
Adding user `johndoe' ...
Adding new group `johndoe' (1000) ...
Adding new user `johndoe' (1000) with group `johndoe' ...
Current Kerberos password:
Current Kerberos password:
passwd: Authentication token manipulation error
passwd: password unchanged
Try again? [y/N] n
Changing the user information for johndoe
Enter the new value, or press ENTER for the default
Full Name []: John Doe
Room Number []:
Work Phone []:
Home Phone []:
Other []:
Is the information correct? [Y/n]
</pre>

Passordet du bruker vil være det samme som admin-principalen din i Kerberos har, altså johndoe/admin i eksempelet over. Om du ikke har en admin-principal, se [[Drift/Kerberos#Lage_admin-principal]].

=== Gjøre endringer ===

Når du logger inn første gang vil du automatisk få sjekket ut salt-treet i ~/salt. Gjør endringene dine der inne, og push master til origin for å aktivere endringene.

Det kan være lurt å teste med en maskin først, ved å logge inn på den og gjøre en dry-run (du kan kjøre kommandoer rett fra salt-masteren også, men det er uansett en fordel å ha et skall på maskinen i tilfelle noe går galt):

<pre>
salt-call state.highstate test=True
</pre>

== Grains ==
Salt kan bruke grains for å gjøre noe på en gruppe med maskiner. <code><nowiki>salt 'hostname*' grains.items</nowiki></code> viser alle grains hostname er med i. For eksempel kan man si <code><nowiki>salt -G 'os_familt:Debian' test.ping</nowiki></code> for å pinge maskiner som er basert på Debian.

For å legge en minion til en gruppe gjør følgende på minion-en:

=== Konfigurasjon ===
<pre>$ vim /etc/salt/grains

roles:
- standard
- desktop
</pre>

I skrivende stund har vi følgende roller:

{|
|standard
|Alle maskiner med standard-oppsett (det vil si at brukere kan logge inn der)
|-
| desktop
| Desktopmaskiner
|-
|file-server
|Filservere, som f.eks. microbel.
|-
| mysql-server
| Mysql-serveren
|-
| web-frontend
| Web-frontend (ikke den som hoster brukerenes hjemmesider)
|-
| web-homes
| Web-backend for brukeres hjemmesider
|-
| wiki
| Mediawiki-serveren
|-
| pkgsync
| Maskinen bruker pkgsync for pakker
|-
| fwlogin
| Maskinen lytter på SSH på port 80 og 443
|-
|salt-master
|salt-masteren (skal ikke ha standardoppsett)
|}

Når minions har blitt lagt til i roller er det viktig å huske på å synkronisere disse med masteren. Den letteste måten å gjøre det på er å kjøre <code><nowiki>salt '*' saltutil.sync_grains</nowiki></code> fra salt-masteren.

For å nå maskiner gjennom egendefinerte grains bruk <code><nowiki>salt -G 'attributt:verdi' kommando</nowiki></code>. Et eksempel er <code><nowiki>salt -G 'roles:workstation' test.ping</nowiki></code>.

== Tekniske ting ==

Litt nyttig info om hvordan ting fungerer under panseret

=== Distribuere mapper ===

Lag en overordnet mappe som inneholder både mappen du ønsker å distribuere og en sls-fil i salt-mappen: <code><nowiki>/srv/salt/overordnet_mappe</nowiki></code>. Der legger du mappen du ønsker å distribuere, og lager en fil du kaller for <code><nowiki>init.sls</nowiki></code>. Den formateres slik:

<pre><nowiki>
/path/til/der/du/vil/at/mappen/skal/ende/opp/på/minions
file.recurse:
- source: salt://overornet_mappe/mappen_du_vil_distribuere
#optional felter:
- include_empty: True #sørger for at tomme undermapper kommer med
- dir_mode: 777 #må bruke dir_mode når man dister mapper, bruk mode: hvis du dister filer
- user: brukernavn #hilken bruker skal mappen, undermapper og filer tilhøre
- group: eall_s #default-gruppen er root. Skal mappen tilhøre noen andre bruk eall_s eksplisitt
</nowiki></pre>

For å så få distribuert mappen kjør følgende kommando: <code><nowiki>salt '*' state.sls overordnet_mappe</nowiki></code>

=== States og håndheving ===

Salt oppererer med SLS filer (SaLt State) for å holde orden på reglene for distribusjon og hvordan disse skal håndheves. Legg SLS filene i <code><nowiki>/srv/salt/</nowiki></code>. En av de viktigste SLS filene er <code><nowiki>/srv/salt/top.sls</nowiki></code> da den spesifiserer hvilke SLS filer som skal anvendes på hvilke minions. (Alle sls-filene er på salt-master.)

For eksempel hvis vi har SLS filene:
<pre>
/srv/salt/top.sls
/srv/salt/common/init.sls
/srv/salt/common/packages.sls
/srv/salt/sl_eksempel.sls
</pre>

La så filene se slik ut:
<pre>
#top.sls:
base:
'*':
- common
'roles:desktop':
- match: grain
- sl_eksempel
</pre>
<pre>
#common/init.sls:
include:
- common.packages
</pre>
<pre>
#common/packages.sls:
vim:
pkg:
- installed
grep:
pkg:
- installed
</pre>
<pre>
#sl_eksempel.sls:
sl:
pkg:
- installed
</pre>

Hva filene sier:
* <code><nowiki>top.sls</nowiki></code> sier at at alle maskiner skal få staten som er spesifisert i 'common'. Siden 'common' er en mappe og ikke en SLS fil vil det implisitt bety at staten som er gitt i <code><nowiki>common/init.sls</nowiki></code> brukes istedenfor.
** Den sier også at alle maskiner som matcher grainen <code><nowiki>roles:desktop</nowiki></code> skal ha staten spesifisert i <code><nowiki>sl_eksempel.sls</nowiki></code>
* <code><nowiki>common/init.sls</nowiki></code> starter med å ved includen si at alt som er i <code><nowiki>/srv/salt/common/packages</nowiki></code> også skal kjøres i tillegg til innholdet den har (som for dette eksempelet er ikke noe mer)
* <code><nowiki>packages.sls</nowiki></code> sier at to pakker, vim og grep, skal være installert på alle maskiner som hører til staten.
* <code><nowiki>sl_eksempel.sls</nowiki></code> sier at pakken sl skal være installert.

For at minionsene skal gå inn å sjekke hvilke states de skal ha, og anvende dem, kjør: 
<code><nowiki>salt '*' state.highstate</nowiki></code> 
på salt-master.

=== Sørg for at Salt-minion er kjørende og at den jevnlig poller om nye ting fra master ===

Lag en mappe <code><nowiki>/srv/salt/minion_configuration</nowiki></code> som inneholder en <code><nowiki>init.sls</nowiki></code> fil og en <code><nowiki>minion</nowiki></code> fil. La <code><nowiki>init.sls</nowiki></code> se slik ut:

<pre>
salt-minion: # sier at det er salt-minion servicen vi påvirker
service:
# sier at den skal være kjørende:
- running
- enable: True
# sier at servicen skal restartes om man merker en endring i den oppgitte filen:
- watch:
- file /etc/salt/minion
/etc/salt/minion: #sier at denne filen skal speile den oppgitte fra master
file.managed:
# filen som skal kopieres over til minionen
- source salt://minion_configuration/minion
# bruker, gruppe, og premissions for filen når den ender opp på minionen:
- user: root
- group: root
- mode: 644
# sier at filen er et jinjatemplate, og at variablene i templatet skal byttes ut
# med verdiene gitt for dem i context-seksjonen:
- template: jinja
- context:
saltmaster: lommel.pvv.ntnu.no
timer: 4
</pre>

Kopier så inn en minion-fil til <code><nowiki>/srv/salt/minion_configuration/minion</nowiki></code>, og legg til disse linjene:

<pre>
#sett inn under "#master: salt" eller istedenfor det som måtte stå på på linjen som begynner med "master:"
master: {{saltmaster}}

#sier at highstate skal schedules til å kjøre hver 'timer' time:
schedule:
highstate:
function: state.highstate
hours: {{ timer }}
</pre>

== Behandlig av errors og feilmeldinger som kan dukke opp ofte ==

=== No Top file or external nodes data matches found ===

Om salt sier dette:

<pre>
ID: states
Function: no.None
Result: False
Comment: No Top file or external nodes data matches found
Started:
Duration:
Changes:
</pre>

Betyr det sannsynligvis at du har glemt å sette noen roller i [[#Grains|/etc/salt/grains]]

=== UnicodeDecodeError ===

Hvis du får «UnicodeDecodeError: 'ascii' codec can't decode byte 0xc2 in position 99: ordinal not in range» eller lignende kommer dette av en kjent feil i Salt: https://github.com/saltstack/salt/issues/16139

Dette skjer mye oftere om du har gammel salt. Prøv dette:

<pre>
echo deb http://debian.saltstack.com/debian $(lsb_release -c | awk '{print $2}')-saltstack main > /etc/apt/sources.list.d/saltstack.list
aptitude update && aptitude dist-upgrade
</pre>

=== No matching sls found ===
Hvis du får feilen: 
<code><nowiki>No matching sls found for 'sls_file_or_folder_name' in env 'base'</nowiki></code> 
Så har du sannsynligvis skrevet <code><nowiki>filnavn.sls</nowiki></code> (må være uten <code><nowiki>.sls</nowiki></code>), eller mappenavnet feil.

== Nyttige kommandoer og syntax ==

Viktig om syntax:
* All indentering er med mellomrom da tabs ser ut til å krasje, to ser ut til å være standard

Hvordan kopiere enkeltfiler ad-hoc fra salt-master til minions: 
<code><nowiki>salt-cp "*" /path/to/file/on/salt/master /path/to/file/on/minions</nowiki></code>

Hvordan kjøre kode på minions: 
<code><nowiki>salt "*" cmd.run "ps -e | grep salt"</nowiki></code>

For å kjøre på enkeltmaskiner istedenfor alle eller grains skriv inn navnet istedenfor <code><nowiki>"*"</nowiki></code>. Eksempel: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no cmd.run "ps -e | grep salt"</nowiki></code>

For å sjekke om en pakke er installer og hvilken versjon den har: 
<code><nowiki>salt "*" pkg.version "grep"</nowiki></code>

For å installere eller oppgradere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.install sl</nowiki></code>

For å avinstallere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.remove sl</nowiki></code>

For å se salt-pkg kommandoer: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.</nowiki></code> og spam tab.

Drift/Salt

2015-10-04T21:11:38Z

Knuta: /* Behandlig av errors og feilmeldinger som kan dukke opp ofte */

Salt er, som [[Drift/Puppet]], et system for å distribuere filer og sørge for at maskiner har samme oppsett.

== Sette opp ny salt minion ==

=== Installasjon ===
<pre>
ny-minion$ apt-get install salt-minion
ny-minion$ rediger /etc/salt/grains og legg til gruppene maskinen er i, se dokumentasjonen for [[Drift/Salt#Grains|grains (grupper)]]
ny-minion$ service salt-minion restart
ny-minion$ ssh root@salt.pvv.ntnu.no
salt-master# salt-key -L
salt-master# salt-key -a hostname.pvv.ntnu.no
salt-master# salt hostname.pvv.ntnu.no saltutil.sync_grains
salt-master# salt hostname.pvv.ntnu.no state.sls minion_configuration
</pre>

Hvis alt har har gått bra, vil pingtesten gi true for maskinen din nå. Hvis ikke, kjør <code><nowiki>service salt-minion status</nowiki></code> som root på din nye minion for å få hint om hva som er galt. Konfigurasjonsfilen til salt ligger i <code><nowiki>/etc/salt/minion</nowiki></code>.

I tilfellet man endrer hostname på en minion, gjør følgende for å få det oppdatert i salt: Stop salt-minion på den berørte maskinen. Slett nøkkelen til maskinen fra salt-master ved å kjøre <code><nowiki>salt-key -d minion_id</nowiki></code> på salt-masteren. Slett <code><nowiki>/etc/salt/minion/minion_id</nowiki></code>. Start salt-minion service-en. Autoriser den nye nøkkelen med det nye navnet i salt-master.

Husk å legge nyoppsatte maskiner til i riktige [[Drift/Salt#Grains|grains (grupper)]].

== Gjøre endringer ==

Endringer gjøres på salt-masteren (salt.pvv.ntnu.no, som for tiden peker på lommel.pvv.ntnu.no). Alle endringer gjøres som din personlige bruker.

=== Opprette bruker på salt-masteren ===
Om du ikke har en bruker, logg inn som root på serveren og lag en. Adduser vil spørre deg om «Current Kerberos password», men du kan bare trykke enter og si nei til å prøve igjen, så fungerer det fint.

<pre>
lommel ~ # adduser johndoe
Adding user `johndoe' ...
Adding new group `johndoe' (1000) ...
Adding new user `johndoe' (1000) with group `johndoe' ...
Current Kerberos password:
Current Kerberos password:
passwd: Authentication token manipulation error
passwd: password unchanged
Try again? [y/N] n
Changing the user information for johndoe
Enter the new value, or press ENTER for the default
Full Name []: John Doe
Room Number []:
Work Phone []:
Home Phone []:
Other []:
Is the information correct? [Y/n]
</pre>

Passordet du bruker vil være det samme som admin-principalen din i Kerberos har, altså johndoe/admin i eksempelet over. Om du ikke har en admin-principal, se [[Drift/Kerberos#Lage_admin-principal]].

=== Gjøre endringer ===

Når du logger inn første gang vil du automatisk få sjekket ut salt-treet i ~/salt. Gjør endringene dine der inne, og push master til origin for å aktivere endringene.

Det kan være lurt å teste med en maskin først, ved å logge inn på den og gjøre en dry-run (du kan kjøre kommandoer rett fra salt-masteren også, men det er uansett en fordel å ha et skall på maskinen i tilfelle noe går galt):

<pre>
salt-call state.highstate test=True
</pre>

== Grains ==
Salt kan bruke grains for å gjøre noe på en gruppe med maskiner. <code><nowiki>salt 'hostname*' grains.items</nowiki></code> viser alle grains hostname er med i. For eksempel kan man si <code><nowiki>salt -G 'os_familt:Debian' test.ping</nowiki></code> for å pinge maskiner som er basert på Debian.

For å legge en minion til en gruppe gjør følgende på minion-en:

=== Konfigurasjon ===
<pre>$ vim /etc/salt/grains

roles:
- standard
- desktop
</pre>

I skrivende stund har vi følgende roller:

{|
|standard
|Alle maskiner med standard-oppsett (det vil si at brukere kan logge inn der)
|-
| desktop
| Desktopmaskiner
|-
|file-server
|Filservere, som f.eks. microbel.
|-
| mysql-server
| Mysql-serveren
|-
| web-frontend
| Web-frontend (ikke den som hoster brukerenes hjemmesider)
|-
| web-homes
| Web-backend for brukeres hjemmesider
|-
| wiki
| Mediawiki-serveren
|-
| pkgsync
| Maskinen bruker pkgsync for pakker
|-
| fwlogin
| Maskinen lytter på SSH på port 80 og 443
|-
|salt-master
|salt-masteren (skal ikke ha standardoppsett)
|}

Når minions har blitt lagt til i roller er det viktig å huske på å synkronisere disse med masteren. Den letteste måten å gjøre det på er å kjøre <code><nowiki>salt '*' saltutil.sync_grains</nowiki></code> fra salt-masteren.

For å nå maskiner gjennom egendefinerte grains bruk <code><nowiki>salt -G 'attributt:verdi' kommando</nowiki></code>. Et eksempel er <code><nowiki>salt -G 'roles:workstation' test.ping</nowiki></code>.

== Tekniske ting ==

Litt nyttig info om hvordan ting fungerer under panseret

=== Distribuere mapper ===

Lag en overordnet mappe som inneholder både mappen du ønsker å distribuere og en sls-fil i salt-mappen: <code><nowiki>/srv/salt/overordnet_mappe</nowiki></code>. Der legger du mappen du ønsker å distribuere, og lager en fil du kaller for <code><nowiki>init.sls</nowiki></code>. Den formateres slik:

<pre><nowiki>
/path/til/der/du/vil/at/mappen/skal/ende/opp/på/minions
file.recurse:
- source: salt://overornet_mappe/mappen_du_vil_distribuere
#optional felter:
- include_empty: True #sørger for at tomme undermapper kommer med
- dir_mode: 777 #må bruke dir_mode når man dister mapper, bruk mode: hvis du dister filer
- user: brukernavn #hilken bruker skal mappen, undermapper og filer tilhøre
- group: eall_s #default-gruppen er root. Skal mappen tilhøre noen andre bruk eall_s eksplisitt
</nowiki></pre>

For å så få distribuert mappen kjør følgende kommando: <code><nowiki>salt '*' state.sls overordnet_mappe</nowiki></code>

=== States og håndheving ===

Salt oppererer med SLS filer (SaLt State) for å holde orden på reglene for distribusjon og hvordan disse skal håndheves. Legg SLS filene i <code><nowiki>/srv/salt/</nowiki></code>. En av de viktigste SLS filene er <code><nowiki>/srv/salt/top.sls</nowiki></code> da den spesifiserer hvilke SLS filer som skal anvendes på hvilke minions. (Alle sls-filene er på salt-master.)

For eksempel hvis vi har SLS filene:
<pre>
/srv/salt/top.sls
/srv/salt/common/init.sls
/srv/salt/common/packages.sls
/srv/salt/sl_eksempel.sls
</pre>

La så filene se slik ut:
<pre>
#top.sls:
base:
'*':
- common
'roles:desktop':
- match: grain
- sl_eksempel
</pre>
<pre>
#common/init.sls:
include:
- common.packages
</pre>
<pre>
#common/packages.sls:
vim:
pkg:
- installed
grep:
pkg:
- installed
</pre>
<pre>
#sl_eksempel.sls:
sl:
pkg:
- installed
</pre>

Hva filene sier:
* <code><nowiki>top.sls</nowiki></code> sier at at alle maskiner skal få staten som er spesifisert i 'common'. Siden 'common' er en mappe og ikke en SLS fil vil det implisitt bety at staten som er gitt i <code><nowiki>common/init.sls</nowiki></code> brukes istedenfor.
** Den sier også at alle maskiner som matcher grainen <code><nowiki>roles:desktop</nowiki></code> skal ha staten spesifisert i <code><nowiki>sl_eksempel.sls</nowiki></code>
* <code><nowiki>common/init.sls</nowiki></code> starter med å ved includen si at alt som er i <code><nowiki>/srv/salt/common/packages</nowiki></code> også skal kjøres i tillegg til innholdet den har (som for dette eksempelet er ikke noe mer)
* <code><nowiki>packages.sls</nowiki></code> sier at to pakker, vim og grep, skal være installert på alle maskiner som hører til staten.
* <code><nowiki>sl_eksempel.sls</nowiki></code> sier at pakken sl skal være installert.

For at minionsene skal gå inn å sjekke hvilke states de skal ha, og anvende dem, kjør: 
<code><nowiki>salt '*' state.highstate</nowiki></code> 
på salt-master.

=== Sørg for at Salt-minion er kjørende og at den jevnlig poller om nye ting fra master ===

Lag en mappe <code><nowiki>/srv/salt/minion_configuration</nowiki></code> som inneholder en <code><nowiki>init.sls</nowiki></code> fil og en <code><nowiki>minion</nowiki></code> fil. La <code><nowiki>init.sls</nowiki></code> se slik ut:

<pre>
salt-minion: # sier at det er salt-minion servicen vi påvirker
service:
# sier at den skal være kjørende:
- running
- enable: True
# sier at servicen skal restartes om man merker en endring i den oppgitte filen:
- watch:
- file /etc/salt/minion
/etc/salt/minion: #sier at denne filen skal speile den oppgitte fra master
file.managed:
# filen som skal kopieres over til minionen
- source salt://minion_configuration/minion
# bruker, gruppe, og premissions for filen når den ender opp på minionen:
- user: root
- group: root
- mode: 644
# sier at filen er et jinjatemplate, og at variablene i templatet skal byttes ut
# med verdiene gitt for dem i context-seksjonen:
- template: jinja
- context:
saltmaster: lommel.pvv.ntnu.no
timer: 4
</pre>

Kopier så inn en minion-fil til <code><nowiki>/srv/salt/minion_configuration/minion</nowiki></code>, og legg til disse linjene:

<pre>
#sett inn under "#master: salt" eller istedenfor det som måtte stå på på linjen som begynner med "master:"
master: {{saltmaster}}

#sier at highstate skal schedules til å kjøre hver 'timer' time:
schedule:
highstate:
function: state.highstate
hours: {{ timer }}
</pre>

== Behandlig av errors og feilmeldinger som kan dukke opp ofte ==

=== No Top file or external nodes data matches found ===

Om salt sier dette:

<pre>
ID: states
Function: no.None
Result: False
Comment: No Top file or external nodes data matches found
Started:
Duration:
Changes:
</pre>

Betyr det sannsynligvis at du har glemt å sette noen roller i [[#Grains|/etc/salt/grains]]

=== UnicodeDecodeError ===

Hvis du får «UnicodeDecodeError: 'ascii' codec can't decode byte 0xc2 in position 99: ordinal not in range» eller lignende kommer dette av en kjent feil i Salt: https://github.com/saltstack/salt/issues/16139

Dette skjer typisk om filen du prøver å diste inneholder norske tegn. Skriv den om til engelsk eller (om du er tøff) norsk som ikke inneholder æøå. Hvis dette ikke er et alternativ (fordi du endret MOTD kanskje?) er det din tur til å finne en ekte fiks. Gratulerer.

=== No matching sls found ===
Hvis du får feilen: 
<code><nowiki>No matching sls found for 'sls_file_or_folder_name' in env 'base'</nowiki></code> 
Så har du sannsynligvis skrevet <code><nowiki>filnavn.sls</nowiki></code> (må være uten <code><nowiki>.sls</nowiki></code>), eller mappenavnet feil.

== Nyttige kommandoer og syntax ==

Viktig om syntax:
* All indentering er med mellomrom da tabs ser ut til å krasje, to ser ut til å være standard

Hvordan kopiere enkeltfiler ad-hoc fra salt-master til minions: 
<code><nowiki>salt-cp "*" /path/to/file/on/salt/master /path/to/file/on/minions</nowiki></code>

Hvordan kjøre kode på minions: 
<code><nowiki>salt "*" cmd.run "ps -e | grep salt"</nowiki></code>

For å kjøre på enkeltmaskiner istedenfor alle eller grains skriv inn navnet istedenfor <code><nowiki>"*"</nowiki></code>. Eksempel: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no cmd.run "ps -e | grep salt"</nowiki></code>

For å sjekke om en pakke er installer og hvilken versjon den har: 
<code><nowiki>salt "*" pkg.version "grep"</nowiki></code>

For å installere eller oppgradere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.install sl</nowiki></code>

For å avinstallere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.remove sl</nowiki></code>

For å se salt-pkg kommandoer: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.</nowiki></code> og spam tab.

Drift/Salt

2015-10-04T20:53:37Z

Knuta: /* Konfigurasjon */

Salt er, som [[Drift/Puppet]], et system for å distribuere filer og sørge for at maskiner har samme oppsett.

== Sette opp ny salt minion ==

=== Installasjon ===
<pre>
ny-minion$ apt-get install salt-minion
ny-minion$ rediger /etc/salt/grains og legg til gruppene maskinen er i, se dokumentasjonen for [[Drift/Salt#Grains|grains (grupper)]]
ny-minion$ service salt-minion restart
ny-minion$ ssh root@salt.pvv.ntnu.no
salt-master# salt-key -L
salt-master# salt-key -a hostname.pvv.ntnu.no
salt-master# salt hostname.pvv.ntnu.no saltutil.sync_grains
salt-master# salt hostname.pvv.ntnu.no state.sls minion_configuration
</pre>

Hvis alt har har gått bra, vil pingtesten gi true for maskinen din nå. Hvis ikke, kjør <code><nowiki>service salt-minion status</nowiki></code> som root på din nye minion for å få hint om hva som er galt. Konfigurasjonsfilen til salt ligger i <code><nowiki>/etc/salt/minion</nowiki></code>.

I tilfellet man endrer hostname på en minion, gjør følgende for å få det oppdatert i salt: Stop salt-minion på den berørte maskinen. Slett nøkkelen til maskinen fra salt-master ved å kjøre <code><nowiki>salt-key -d minion_id</nowiki></code> på salt-masteren. Slett <code><nowiki>/etc/salt/minion/minion_id</nowiki></code>. Start salt-minion service-en. Autoriser den nye nøkkelen med det nye navnet i salt-master.

Husk å legge nyoppsatte maskiner til i riktige [[Drift/Salt#Grains|grains (grupper)]].

== Gjøre endringer ==

Endringer gjøres på salt-masteren (salt.pvv.ntnu.no, som for tiden peker på lommel.pvv.ntnu.no). Alle endringer gjøres som din personlige bruker.

=== Opprette bruker på salt-masteren ===
Om du ikke har en bruker, logg inn som root på serveren og lag en. Adduser vil spørre deg om «Current Kerberos password», men du kan bare trykke enter og si nei til å prøve igjen, så fungerer det fint.

<pre>
lommel ~ # adduser johndoe
Adding user `johndoe' ...
Adding new group `johndoe' (1000) ...
Adding new user `johndoe' (1000) with group `johndoe' ...
Current Kerberos password:
Current Kerberos password:
passwd: Authentication token manipulation error
passwd: password unchanged
Try again? [y/N] n
Changing the user information for johndoe
Enter the new value, or press ENTER for the default
Full Name []: John Doe
Room Number []:
Work Phone []:
Home Phone []:
Other []:
Is the information correct? [Y/n]
</pre>

Passordet du bruker vil være det samme som admin-principalen din i Kerberos har, altså johndoe/admin i eksempelet over. Om du ikke har en admin-principal, se [[Drift/Kerberos#Lage_admin-principal]].

=== Gjøre endringer ===

Når du logger inn første gang vil du automatisk få sjekket ut salt-treet i ~/salt. Gjør endringene dine der inne, og push master til origin for å aktivere endringene.

Det kan være lurt å teste med en maskin først, ved å logge inn på den og gjøre en dry-run (du kan kjøre kommandoer rett fra salt-masteren også, men det er uansett en fordel å ha et skall på maskinen i tilfelle noe går galt):

<pre>
salt-call state.highstate test=True
</pre>

== Grains ==
Salt kan bruke grains for å gjøre noe på en gruppe med maskiner. <code><nowiki>salt 'hostname*' grains.items</nowiki></code> viser alle grains hostname er med i. For eksempel kan man si <code><nowiki>salt -G 'os_familt:Debian' test.ping</nowiki></code> for å pinge maskiner som er basert på Debian.

For å legge en minion til en gruppe gjør følgende på minion-en:

=== Konfigurasjon ===
<pre>$ vim /etc/salt/grains

roles:
- standard
- desktop
</pre>

I skrivende stund har vi følgende roller:

{|
|standard
|Alle maskiner med standard-oppsett (det vil si at brukere kan logge inn der)
|-
| desktop
| Desktopmaskiner
|-
|file-server
|Filservere, som f.eks. microbel.
|-
| mysql-server
| Mysql-serveren
|-
| web-frontend
| Web-frontend (ikke den som hoster brukerenes hjemmesider)
|-
| web-homes
| Web-backend for brukeres hjemmesider
|-
| wiki
| Mediawiki-serveren
|-
| pkgsync
| Maskinen bruker pkgsync for pakker
|-
| fwlogin
| Maskinen lytter på SSH på port 80 og 443
|-
|salt-master
|salt-masteren (skal ikke ha standardoppsett)
|}

Når minions har blitt lagt til i roller er det viktig å huske på å synkronisere disse med masteren. Den letteste måten å gjøre det på er å kjøre <code><nowiki>salt '*' saltutil.sync_grains</nowiki></code> fra salt-masteren.

For å nå maskiner gjennom egendefinerte grains bruk <code><nowiki>salt -G 'attributt:verdi' kommando</nowiki></code>. Et eksempel er <code><nowiki>salt -G 'roles:workstation' test.ping</nowiki></code>.

== Tekniske ting ==

Litt nyttig info om hvordan ting fungerer under panseret

=== Distribuere mapper ===

Lag en overordnet mappe som inneholder både mappen du ønsker å distribuere og en sls-fil i salt-mappen: <code><nowiki>/srv/salt/overordnet_mappe</nowiki></code>. Der legger du mappen du ønsker å distribuere, og lager en fil du kaller for <code><nowiki>init.sls</nowiki></code>. Den formateres slik:

<pre><nowiki>
/path/til/der/du/vil/at/mappen/skal/ende/opp/på/minions
file.recurse:
- source: salt://overornet_mappe/mappen_du_vil_distribuere
#optional felter:
- include_empty: True #sørger for at tomme undermapper kommer med
- dir_mode: 777 #må bruke dir_mode når man dister mapper, bruk mode: hvis du dister filer
- user: brukernavn #hilken bruker skal mappen, undermapper og filer tilhøre
- group: eall_s #default-gruppen er root. Skal mappen tilhøre noen andre bruk eall_s eksplisitt
</nowiki></pre>

For å så få distribuert mappen kjør følgende kommando: <code><nowiki>salt '*' state.sls overordnet_mappe</nowiki></code>

=== States og håndheving ===

Salt oppererer med SLS filer (SaLt State) for å holde orden på reglene for distribusjon og hvordan disse skal håndheves. Legg SLS filene i <code><nowiki>/srv/salt/</nowiki></code>. En av de viktigste SLS filene er <code><nowiki>/srv/salt/top.sls</nowiki></code> da den spesifiserer hvilke SLS filer som skal anvendes på hvilke minions. (Alle sls-filene er på salt-master.)

For eksempel hvis vi har SLS filene:
<pre>
/srv/salt/top.sls
/srv/salt/common/init.sls
/srv/salt/common/packages.sls
/srv/salt/sl_eksempel.sls
</pre>

La så filene se slik ut:
<pre>
#top.sls:
base:
'*':
- common
'roles:desktop':
- match: grain
- sl_eksempel
</pre>
<pre>
#common/init.sls:
include:
- common.packages
</pre>
<pre>
#common/packages.sls:
vim:
pkg:
- installed
grep:
pkg:
- installed
</pre>
<pre>
#sl_eksempel.sls:
sl:
pkg:
- installed
</pre>

Hva filene sier:
* <code><nowiki>top.sls</nowiki></code> sier at at alle maskiner skal få staten som er spesifisert i 'common'. Siden 'common' er en mappe og ikke en SLS fil vil det implisitt bety at staten som er gitt i <code><nowiki>common/init.sls</nowiki></code> brukes istedenfor.
** Den sier også at alle maskiner som matcher grainen <code><nowiki>roles:desktop</nowiki></code> skal ha staten spesifisert i <code><nowiki>sl_eksempel.sls</nowiki></code>
* <code><nowiki>common/init.sls</nowiki></code> starter med å ved includen si at alt som er i <code><nowiki>/srv/salt/common/packages</nowiki></code> også skal kjøres i tillegg til innholdet den har (som for dette eksempelet er ikke noe mer)
* <code><nowiki>packages.sls</nowiki></code> sier at to pakker, vim og grep, skal være installert på alle maskiner som hører til staten.
* <code><nowiki>sl_eksempel.sls</nowiki></code> sier at pakken sl skal være installert.

For at minionsene skal gå inn å sjekke hvilke states de skal ha, og anvende dem, kjør: 
<code><nowiki>salt '*' state.highstate</nowiki></code> 
på salt-master.

=== Sørg for at Salt-minion er kjørende og at den jevnlig poller om nye ting fra master ===

Lag en mappe <code><nowiki>/srv/salt/minion_configuration</nowiki></code> som inneholder en <code><nowiki>init.sls</nowiki></code> fil og en <code><nowiki>minion</nowiki></code> fil. La <code><nowiki>init.sls</nowiki></code> se slik ut:

<pre>
salt-minion: # sier at det er salt-minion servicen vi påvirker
service:
# sier at den skal være kjørende:
- running
- enable: True
# sier at servicen skal restartes om man merker en endring i den oppgitte filen:
- watch:
- file /etc/salt/minion
/etc/salt/minion: #sier at denne filen skal speile den oppgitte fra master
file.managed:
# filen som skal kopieres over til minionen
- source salt://minion_configuration/minion
# bruker, gruppe, og premissions for filen når den ender opp på minionen:
- user: root
- group: root
- mode: 644
# sier at filen er et jinjatemplate, og at variablene i templatet skal byttes ut
# med verdiene gitt for dem i context-seksjonen:
- template: jinja
- context:
saltmaster: lommel.pvv.ntnu.no
timer: 4
</pre>

Kopier så inn en minion-fil til <code><nowiki>/srv/salt/minion_configuration/minion</nowiki></code>, og legg til disse linjene:

<pre>
#sett inn under "#master: salt" eller istedenfor det som måtte stå på på linjen som begynner med "master:"
master: {{saltmaster}}

#sier at highstate skal schedules til å kjøre hver 'timer' time:
schedule:
highstate:
function: state.highstate
hours: {{ timer }}
</pre>

== Behandlig av errors og feilmeldinger som kan dukke opp ofte ==

Hvis du får feilen: 
<code><nowiki>No matching sls found for 'sls_file_or_folder_name' in env 'base'</nowiki></code> 
Så har du sannsynligvis skrevet <code><nowiki>filnavn.sls</nowiki></code> (må være uten <code><nowiki>.sls</nowiki></code>), eller mappenavnet feil.

== Nyttige kommandoer og syntax ==

Viktig om syntax:
* All indentering er med mellomrom da tabs ser ut til å krasje, to ser ut til å være standard

Hvordan kopiere enkeltfiler ad-hoc fra salt-master til minions: 
<code><nowiki>salt-cp "*" /path/to/file/on/salt/master /path/to/file/on/minions</nowiki></code>

Hvordan kjøre kode på minions: 
<code><nowiki>salt "*" cmd.run "ps -e | grep salt"</nowiki></code>

For å kjøre på enkeltmaskiner istedenfor alle eller grains skriv inn navnet istedenfor <code><nowiki>"*"</nowiki></code>. Eksempel: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no cmd.run "ps -e | grep salt"</nowiki></code>

For å sjekke om en pakke er installer og hvilken versjon den har: 
<code><nowiki>salt "*" pkg.version "grep"</nowiki></code>

For å installere eller oppgradere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.install sl</nowiki></code>

For å avinstallere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.remove sl</nowiki></code>

For å se salt-pkg kommandoer: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.</nowiki></code> og spam tab.

Drift/Salt

2015-10-04T20:50:41Z

Knuta: fiks syntraks

Salt er, som [[Drift/Puppet]], et system for å distribuere filer og sørge for at maskiner har samme oppsett.

== Sette opp ny salt minion ==

=== Installasjon ===
<pre>
ny-minion$ apt-get install salt-minion
ny-minion$ rediger /etc/salt/grains og legg til gruppene maskinen er i, se dokumentasjonen for [[Drift/Salt#Grains|grains (grupper)]]
ny-minion$ service salt-minion restart
ny-minion$ ssh root@salt.pvv.ntnu.no
salt-master# salt-key -L
salt-master# salt-key -a hostname.pvv.ntnu.no
salt-master# salt hostname.pvv.ntnu.no saltutil.sync_grains
salt-master# salt hostname.pvv.ntnu.no state.sls minion_configuration
</pre>

Hvis alt har har gått bra, vil pingtesten gi true for maskinen din nå. Hvis ikke, kjør <code><nowiki>service salt-minion status</nowiki></code> som root på din nye minion for å få hint om hva som er galt. Konfigurasjonsfilen til salt ligger i <code><nowiki>/etc/salt/minion</nowiki></code>.

I tilfellet man endrer hostname på en minion, gjør følgende for å få det oppdatert i salt: Stop salt-minion på den berørte maskinen. Slett nøkkelen til maskinen fra salt-master ved å kjøre <code><nowiki>salt-key -d minion_id</nowiki></code> på salt-masteren. Slett <code><nowiki>/etc/salt/minion/minion_id</nowiki></code>. Start salt-minion service-en. Autoriser den nye nøkkelen med det nye navnet i salt-master.

Husk å legge nyoppsatte maskiner til i riktige [[Drift/Salt#Grains|grains (grupper)]].

== Gjøre endringer ==

Endringer gjøres på salt-masteren (salt.pvv.ntnu.no, som for tiden peker på lommel.pvv.ntnu.no). Alle endringer gjøres som din personlige bruker.

=== Opprette bruker på salt-masteren ===
Om du ikke har en bruker, logg inn som root på serveren og lag en. Adduser vil spørre deg om «Current Kerberos password», men du kan bare trykke enter og si nei til å prøve igjen, så fungerer det fint.

<pre>
lommel ~ # adduser johndoe
Adding user `johndoe' ...
Adding new group `johndoe' (1000) ...
Adding new user `johndoe' (1000) with group `johndoe' ...
Current Kerberos password:
Current Kerberos password:
passwd: Authentication token manipulation error
passwd: password unchanged
Try again? [y/N] n
Changing the user information for johndoe
Enter the new value, or press ENTER for the default
Full Name []: John Doe
Room Number []:
Work Phone []:
Home Phone []:
Other []:
Is the information correct? [Y/n]
</pre>

Passordet du bruker vil være det samme som admin-principalen din i Kerberos har, altså johndoe/admin i eksempelet over. Om du ikke har en admin-principal, se [[Drift/Kerberos#Lage_admin-principal]].

=== Gjøre endringer ===

Når du logger inn første gang vil du automatisk få sjekket ut salt-treet i ~/salt. Gjør endringene dine der inne, og push master til origin for å aktivere endringene.

Det kan være lurt å teste med en maskin først, ved å logge inn på den og gjøre en dry-run (du kan kjøre kommandoer rett fra salt-masteren også, men det er uansett en fordel å ha et skall på maskinen i tilfelle noe går galt):

<pre>
salt-call state.highstate test=True
</pre>

== Grains ==
Salt kan bruke grains for å gjøre noe på en gruppe med maskiner. <code><nowiki>salt 'hostname*' grains.items</nowiki></code> viser alle grains hostname er med i. For eksempel kan man si <code><nowiki>salt -G 'os_familt:Debian' test.ping</nowiki></code> for å pinge maskiner som er basert på Debian.

For å legge en minion til en gruppe gjør følgende på minion-en:

=== Konfigurasjon ===
<pre>$ vim /etc/salt/grains

roles:
- standard
- desktop
</pre>

I skrivende stund har vi følgende roller:

{|
|standard
|Alle maskiner med standard-oppsett (det vil si at brukere kan logge inn der)
|-
|file-server
|Filservere, som f.eks. microbel.
|-
| mysql-server
| Mysql-serveren
|-
| web-frontend
| Web-frontend (ikke den som hoster brukerenes hjemmesider)
|-
| web-homes
| Web-backend for brukeres hjemmesider
|-
| wiki
| Mediawiki-serveren
|-
| desktop
| Desktopmaskiner
|-
| pkgsync
| Maskinen bruker pkgsync for pakker
|-
| fwlogin
| Maskinen lytter på SSH på port 80 og 443
|-
|saltmaster
|salt-masteren (skal ikke ha standardoppsett)
|}

Når minions har blitt lagt til i roller er det viktig å huske på å synkronisere disse med masteren. Den letteste måten å gjøre det på er å kjøre <code><nowiki>salt '*' saltutil.sync_grains</nowiki></code> fra salt-masteren.

For å nå maskiner gjennom egendefinerte grains bruk <code><nowiki>salt -G 'attributt:verdi' kommando</nowiki></code>. Et eksempel er <code><nowiki>salt -G 'roles:workstation' test.ping</nowiki></code>.

== Tekniske ting ==

Litt nyttig info om hvordan ting fungerer under panseret

=== Distribuere mapper ===

Lag en overordnet mappe som inneholder både mappen du ønsker å distribuere og en sls-fil i salt-mappen: <code><nowiki>/srv/salt/overordnet_mappe</nowiki></code>. Der legger du mappen du ønsker å distribuere, og lager en fil du kaller for <code><nowiki>init.sls</nowiki></code>. Den formateres slik:

<pre><nowiki>
/path/til/der/du/vil/at/mappen/skal/ende/opp/på/minions
file.recurse:
- source: salt://overornet_mappe/mappen_du_vil_distribuere
#optional felter:
- include_empty: True #sørger for at tomme undermapper kommer med
- dir_mode: 777 #må bruke dir_mode når man dister mapper, bruk mode: hvis du dister filer
- user: brukernavn #hilken bruker skal mappen, undermapper og filer tilhøre
- group: eall_s #default-gruppen er root. Skal mappen tilhøre noen andre bruk eall_s eksplisitt
</nowiki></pre>

For å så få distribuert mappen kjør følgende kommando: <code><nowiki>salt '*' state.sls overordnet_mappe</nowiki></code>

=== States og håndheving ===

Salt oppererer med SLS filer (SaLt State) for å holde orden på reglene for distribusjon og hvordan disse skal håndheves. Legg SLS filene i <code><nowiki>/srv/salt/</nowiki></code>. En av de viktigste SLS filene er <code><nowiki>/srv/salt/top.sls</nowiki></code> da den spesifiserer hvilke SLS filer som skal anvendes på hvilke minions. (Alle sls-filene er på salt-master.)

For eksempel hvis vi har SLS filene:
<pre>
/srv/salt/top.sls
/srv/salt/common/init.sls
/srv/salt/common/packages.sls
/srv/salt/sl_eksempel.sls
</pre>

La så filene se slik ut:
<pre>
#top.sls:
base:
'*':
- common
'roles:desktop':
- match: grain
- sl_eksempel
</pre>
<pre>
#common/init.sls:
include:
- common.packages
</pre>
<pre>
#common/packages.sls:
vim:
pkg:
- installed
grep:
pkg:
- installed
</pre>
<pre>
#sl_eksempel.sls:
sl:
pkg:
- installed
</pre>

Hva filene sier:
* <code><nowiki>top.sls</nowiki></code> sier at at alle maskiner skal få staten som er spesifisert i 'common'. Siden 'common' er en mappe og ikke en SLS fil vil det implisitt bety at staten som er gitt i <code><nowiki>common/init.sls</nowiki></code> brukes istedenfor.
** Den sier også at alle maskiner som matcher grainen <code><nowiki>roles:desktop</nowiki></code> skal ha staten spesifisert i <code><nowiki>sl_eksempel.sls</nowiki></code>
* <code><nowiki>common/init.sls</nowiki></code> starter med å ved includen si at alt som er i <code><nowiki>/srv/salt/common/packages</nowiki></code> også skal kjøres i tillegg til innholdet den har (som for dette eksempelet er ikke noe mer)
* <code><nowiki>packages.sls</nowiki></code> sier at to pakker, vim og grep, skal være installert på alle maskiner som hører til staten.
* <code><nowiki>sl_eksempel.sls</nowiki></code> sier at pakken sl skal være installert.

For at minionsene skal gå inn å sjekke hvilke states de skal ha, og anvende dem, kjør: 
<code><nowiki>salt '*' state.highstate</nowiki></code> 
på salt-master.

=== Sørg for at Salt-minion er kjørende og at den jevnlig poller om nye ting fra master ===

Lag en mappe <code><nowiki>/srv/salt/minion_configuration</nowiki></code> som inneholder en <code><nowiki>init.sls</nowiki></code> fil og en <code><nowiki>minion</nowiki></code> fil. La <code><nowiki>init.sls</nowiki></code> se slik ut:

<pre>
salt-minion: # sier at det er salt-minion servicen vi påvirker
service:
# sier at den skal være kjørende:
- running
- enable: True
# sier at servicen skal restartes om man merker en endring i den oppgitte filen:
- watch:
- file /etc/salt/minion
/etc/salt/minion: #sier at denne filen skal speile den oppgitte fra master
file.managed:
# filen som skal kopieres over til minionen
- source salt://minion_configuration/minion
# bruker, gruppe, og premissions for filen når den ender opp på minionen:
- user: root
- group: root
- mode: 644
# sier at filen er et jinjatemplate, og at variablene i templatet skal byttes ut
# med verdiene gitt for dem i context-seksjonen:
- template: jinja
- context:
saltmaster: lommel.pvv.ntnu.no
timer: 4
</pre>

Kopier så inn en minion-fil til <code><nowiki>/srv/salt/minion_configuration/minion</nowiki></code>, og legg til disse linjene:

<pre>
#sett inn under "#master: salt" eller istedenfor det som måtte stå på på linjen som begynner med "master:"
master: {{saltmaster}}

#sier at highstate skal schedules til å kjøre hver 'timer' time:
schedule:
highstate:
function: state.highstate
hours: {{ timer }}
</pre>

== Behandlig av errors og feilmeldinger som kan dukke opp ofte ==

Hvis du får feilen: 
<code><nowiki>No matching sls found for 'sls_file_or_folder_name' in env 'base'</nowiki></code> 
Så har du sannsynligvis skrevet <code><nowiki>filnavn.sls</nowiki></code> (må være uten <code><nowiki>.sls</nowiki></code>), eller mappenavnet feil.

== Nyttige kommandoer og syntax ==

Viktig om syntax:
* All indentering er med mellomrom da tabs ser ut til å krasje, to ser ut til å være standard

Hvordan kopiere enkeltfiler ad-hoc fra salt-master til minions: 
<code><nowiki>salt-cp "*" /path/to/file/on/salt/master /path/to/file/on/minions</nowiki></code>

Hvordan kjøre kode på minions: 
<code><nowiki>salt "*" cmd.run "ps -e | grep salt"</nowiki></code>

For å kjøre på enkeltmaskiner istedenfor alle eller grains skriv inn navnet istedenfor <code><nowiki>"*"</nowiki></code>. Eksempel: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no cmd.run "ps -e | grep salt"</nowiki></code>

For å sjekke om en pakke er installer og hvilken versjon den har: 
<code><nowiki>salt "*" pkg.version "grep"</nowiki></code>

For å installere eller oppgradere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.install sl</nowiki></code>

For å avinstallere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.remove sl</nowiki></code>

For å se salt-pkg kommandoer: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.</nowiki></code> og spam tab.

Drift/Salt

2015-10-04T20:35:34Z

Knuta: Oppdatert dokumentasjon etter porting av rdist-treet til salt

Salt er, som [[Drift/Puppet]], et system for å distribuere filer og sørge for at maskiner har samme oppsett.

== Sette opp ny salt minion ==

=== Installasjon ===
<pre>
ny-minion$ apt-get install salt-minion
ny-minion$ rediger /etc/salt/grains og legg til gruppene maskinen er i, se dokumentasjonen for [[Drift/Salt#Grains|grains (grupper)]]
ny-minion$ service salt-minion restart
ny-minion$ ssh root@salt.pvv.ntnu.no
salt-master# salt-key -L
salt-master# salt-key -a hostname.pvv.ntnu.no
salt-master# salt hostname.pvv.ntnu.no saltutil.sync_grains
salt-master# salt hostname.pvv.ntnu.no state.sls minion_configuration
</pre>

Hvis alt har har gått bra, vil pingtesten gi true for maskinen din nå. Hvis ikke, kjør <code><nowiki>service salt-minion status</nowiki></code> som root på din nye minion for å få hint om hva som er galt. Konfigurasjonsfilen til salt ligger i <code><nowiki>/etc/salt/minion</nowiki></code>.

I tilfellet man endrer hostname på en minion, gjør følgende for å få det oppdatert i salt: Stop salt-minion på den berørte maskinen. Slett nøkkelen til maskinen fra salt-master ved å kjøre <code><nowiki>salt-key -d minion_id</nowiki></code> på salt-masteren. Slett <code><nowiki>/etc/salt/minion/minion_id</nowiki></code>. Start salt-minion service-en. Autoriser den nye nøkkelen med det nye navnet i salt-master.

Husk å legge nyoppsatte maskiner til i riktige [[Drift/Salt#Grains|grains (grupper)]].

== Gjøre endringer ==

Endringer gjøres på salt-masteren (salt.pvv.ntnu.no, som for tiden peker på lommel.pvv.ntnu.no). Alle endringer gjøres som din personlige bruker.

=== Opprette bruker på salt-masteren ===
Om du ikke har en bruker, logg inn som root på serveren og lag en. Adduser vil spørre deg om «Current Kerberos password», men du kan bare trykke enter og si nei til å prøve igjen, så fungerer det fint.

<pre>
lommel ~ # adduser johndoe
Adding user `johndoe' ...
Adding new group `johndoe' (1000) ...
Adding new user `johndoe' (1000) with group `johndoe' ...
Current Kerberos password:
Current Kerberos password:
passwd: Authentication token manipulation error
passwd: password unchanged
Try again? [y/N] n
Changing the user information for johndoe
Enter the new value, or press ENTER for the default
Full Name []: John Doe
Room Number []:
Work Phone []:
Home Phone []:
Other []:
Is the information correct? [Y/n] n
</pre>

Passordet du bruker vil være det samme som admin-principalen din i Kerberos har, altså johndoe/admin i eksempelet over. Om du ikke har en admin-principal, se [[Drift/Kerberos#Lage_admin-principal]].

=== Gjøre endringer ===

Når du logger inn første gang vil du automatisk få sjekket ut salt-treet i ~/salt. Gjør endringene dine der inne, og push master til origin for å aktivere endringene.

Det kan være lurt å teste med en maskin først, ved å logge inn på den og gjøre en dry-run (du kan kjøre kommandoer rett fra salt-masteren også, men det er uansett en fordel å ha et skall på maskinen i tilfelle noe går galt):

<pre
salt-call state.highstate test=True
</pre>

== Grains ==
Salt kan bruke grains for å gjøre noe på en gruppe med maskiner. <code><nowiki>salt 'hostname*' grains.items</nowiki></code> viser alle grains hostname er med i. For eksempel kan man si <code><nowiki>salt -G 'os_familt:Debian' test.ping</nowiki></code> for å pinge maskiner som er basert på Debian.

For å legge en minion til en gruppe gjør følgende på minion-en:

=== Konfigurasjon ===
<pre>$ vim /etc/salt/grains

roles:
- standard
- desktop
</pre>

I skrivende stund har vi følgende roller:

{|
|standard
|Alle maskiner med standard-oppsett (det vil si at brukere kan logge inn der)
|-
|file-server
|Filservere, som f.eks. microbel.
|-
| mysql-server
| Mysql-serveren
|-
| web-frontend
| Web-frontend (ikke den som hoster brukerenes hjemmesider)
|-
| web-homes
| Web-backend for brukeres hjemmesider
|-
| wiki
| Mediawiki-serveren
|-
| desktop
| Desktopmaskiner
|-
| pkgsync
| Maskinen bruker pkgsync for pakker
|-
| fwlogin
| Maskinen lytter på SSH på port 80 og 443
|-
|saltmaster
|salt-masteren (skal ikke ha standardoppsett)
|}

Når minions har blitt lagt til i roller er det viktig å huske på å synkronisere disse med masteren. Den letteste måten å gjøre det på er å kjøre <code><nowiki>salt '*' saltutil.sync_grains</nowiki></code> fra salt-masteren.

For å nå maskiner gjennom egendefinerte grains bruk <code><nowiki>salt -G 'attributt:verdi' kommando</nowiki></code>. Et eksempel er <code><nowiki>salt -G 'roles:workstation' test.ping</nowiki></code>.

== Tekniske ting ==

Litt nyttig info om hvordan ting fungerer under panseret

=== Distribuere mapper ===

Lag en overordnet mappe som inneholder både mappen du ønsker å distribuere og en sls-fil i salt-mappen: <code><nowiki>/srv/salt/overordnet_mappe</nowiki></code>. Der legger du mappen du ønsker å distribuere, og lager en fil du kaller for <code><nowiki>init.sls</nowiki></code>. Den formateres slik:

<pre><nowiki>
/path/til/der/du/vil/at/mappen/skal/ende/opp/på/minions
file.recurse:
- source: salt://overornet_mappe/mappen_du_vil_distribuere
#optional felter:
- include_empty: True #sørger for at tomme undermapper kommer med
- dir_mode: 777 #må bruke dir_mode når man dister mapper, bruk mode: hvis du dister filer
- user: brukernavn #hilken bruker skal mappen, undermapper og filer tilhøre
- group: eall_s #default-gruppen er root. Skal mappen tilhøre noen andre bruk eall_s eksplisitt
</nowiki></pre>

For å så få distribuert mappen kjør følgende kommando: <code><nowiki>salt '*' state.sls overordnet_mappe</nowiki></code>

=== States og håndheving ===

Salt oppererer med SLS filer (SaLt State) for å holde orden på reglene for distribusjon og hvordan disse skal håndheves. Legg SLS filene i <code><nowiki>/srv/salt/</nowiki></code>. En av de viktigste SLS filene er <code><nowiki>/srv/salt/top.sls</nowiki></code> da den spesifiserer hvilke SLS filer som skal anvendes på hvilke minions. (Alle sls-filene er på salt-master.)

For eksempel hvis vi har SLS filene:
<pre>
/srv/salt/top.sls
/srv/salt/common/init.sls
/srv/salt/common/packages.sls
/srv/salt/sl_eksempel.sls
</pre>

La så filene se slik ut:
<pre>
#top.sls:
base:
'*':
- common
'roles:desktop':
- match: grain
- sl_eksempel
</pre>
<pre>
#common/init.sls:
include:
- common.packages
</pre>
<pre>
#common/packages.sls:
vim:
pkg:
- installed
grep:
pkg:
- installed
</pre>
<pre>
#sl_eksempel.sls:
sl:
pkg:
- installed
</pre>

Hva filene sier:
* <code><nowiki>top.sls</nowiki></code> sier at at alle maskiner skal få staten som er spesifisert i 'common'. Siden 'common' er en mappe og ikke en SLS fil vil det implisitt bety at staten som er gitt i <code><nowiki>common/init.sls</nowiki></code> brukes istedenfor.
** Den sier også at alle maskiner som matcher grainen <code><nowiki>roles:desktop</nowiki></code> skal ha staten spesifisert i <code><nowiki>sl_eksempel.sls</nowiki></code>
* <code><nowiki>common/init.sls</nowiki></code> starter med å ved includen si at alt som er i <code><nowiki>/srv/salt/common/packages</nowiki></code> også skal kjøres i tillegg til innholdet den har (som for dette eksempelet er ikke noe mer)
* <code><nowiki>packages.sls</nowiki></code> sier at to pakker, vim og grep, skal være installert på alle maskiner som hører til staten.
* <code><nowiki>sl_eksempel.sls</nowiki></code> sier at pakken sl skal være installert.

For at minionsene skal gå inn å sjekke hvilke states de skal ha, og anvende dem, kjør: 
<code><nowiki>salt '*' state.highstate</nowiki></code> 
på salt-master.

=== Sørg for at Salt-minion er kjørende og at den jevnlig poller om nye ting fra master ===

Lag en mappe <code><nowiki>/srv/salt/minion_configuration</nowiki></code> som inneholder en <code><nowiki>init.sls</nowiki></code> fil og en <code><nowiki>minion</nowiki></code> fil. La <code><nowiki>init.sls</nowiki></code> se slik ut:

<pre>
salt-minion: # sier at det er salt-minion servicen vi påvirker
service:
# sier at den skal være kjørende:
- running
- enable: True
# sier at servicen skal restartes om man merker en endring i den oppgitte filen:
- watch:
- file /etc/salt/minion
/etc/salt/minion: #sier at denne filen skal speile den oppgitte fra master
file.managed:
# filen som skal kopieres over til minionen
- source salt://minion_configuration/minion
# bruker, gruppe, og premissions for filen når den ender opp på minionen:
- user: root
- group: root
- mode: 644
# sier at filen er et jinjatemplate, og at variablene i templatet skal byttes ut
# med verdiene gitt for dem i context-seksjonen:
- template: jinja
- context:
saltmaster: lommel.pvv.ntnu.no
timer: 4
</pre>

Kopier så inn en minion-fil til <code><nowiki>/srv/salt/minion_configuration/minion</nowiki></code>, og legg til disse linjene:

<pre>
#sett inn under "#master: salt" eller istedenfor det som måtte stå på på linjen som begynner med "master:"
master: {{saltmaster}}

#sier at highstate skal schedules til å kjøre hver 'timer' time:
schedule:
highstate:
function: state.highstate
hours: {{ timer }}
</pre>

== Behandlig av errors og feilmeldinger som kan dukke opp ofte ==

Hvis du får feilen: 
<code><nowiki>No matching sls found for 'sls_file_or_folder_name' in env 'base'</nowiki></code> 
Så har du sannsynligvis skrevet <code><nowiki>filnavn.sls</nowiki></code> (må være uten <code><nowiki>.sls</nowiki></code>), eller mappenavnet feil.

== Nyttige kommandoer og syntax ==

Viktig om syntax:
* All indentering er med mellomrom da tabs ser ut til å krasje, to ser ut til å være standard

Hvordan kopiere enkeltfiler ad-hoc fra salt-master til minions: 
<code><nowiki>salt-cp "*" /path/to/file/on/salt/master /path/to/file/on/minions</nowiki></code>

Hvordan kjøre kode på minions: 
<code><nowiki>salt "*" cmd.run "ps -e | grep salt"</nowiki></code>

For å kjøre på enkeltmaskiner istedenfor alle eller grains skriv inn navnet istedenfor <code><nowiki>"*"</nowiki></code>. Eksempel: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no cmd.run "ps -e | grep salt"</nowiki></code>

For å sjekke om en pakke er installer og hvilken versjon den har: 
<code><nowiki>salt "*" pkg.version "grep"</nowiki></code>

For å installere eller oppgradere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.install sl</nowiki></code>

For å avinstallere en pakke: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.remove sl</nowiki></code>

For å se salt-pkg kommandoer: 
<code><nowiki>salt maskinnavn.pvv.ntnu.no pkg.</nowiki></code> og spam tab.

Drift/Puppet

2015-07-19T04:06:59Z

Knuta:

Puppet er et fint og flott system for å distribuere informasjon mellom maskiner med forskjellige operativsystemer og maskinvare.

== Bruk ==

Alle driftere har (eller kan ha) sin egen utsjekkede kopi av puppet-treet. For å få tilgang til dette, logg inn som din egen bruker på puppet-boksen. Passordet er samme passord som adminprincipalen din i kerberos (e.g. brukernavn foo, passordet til foo/admin i kerberos). Brukere må opprettes manuelt, og kan gjøres ved å logge inn på boksen og kjøre adduser (bare trykk enter når den ber om kerberos-passord).

=== Git-repository ===
Puppet-konfigen (som fortsatt ser mistenkelig ut som rdist-konfig) sjekkes ut automatisk den første gangen du logger inn på puppet-boksen (i skrivende stund lommel.pvv.ntnu.no). Når vi har fått portet rdist-konfigen vil du "slå på" endringer ved å pushe dem til origin.

== Administrativt ==
Lure ting:
* Installer vim-puppet og puppet-el (pakker for puppetsyntaks i vim og Emacs).
* Rediger /etc/default/puppet til å starte Puppet.

== Syntaks ==

=== Diste en fil ===
Disting av filer gjøres ved å opprette klasser og å tilordne maskiner til forskjellige klasser (karakterer ser det dog ikke ut til å være). Sørg for at nodetypen inkluderer (include) denne klassen. Noden definerer du i /etc/puppet/manifest/site.pp: denne ser ut til å holde orden på alle maskinene på bruket. Selve klassen opprettes i manifests/classes/, hvor du lager en ny fil med passende navn.

==== Diste motd ====
Disse filene dister filen /etc/puppet/modules/motd/files/motd/, ganske logisk igrunnen at den interne pathen har et ekstra navn, men du venner deg til det.

puppet:/// sender deg til puppetdir, som er /etc/puppet/ i vårt tilfelle.
<pre># /etc/puppet/manifests/site.pp

import "classes/*"

node default {
include motd
}</pre>

<pre># /etc/puppet/manifests/classes/motd.pp

class motd
{
file {"/local/etc/motd":
group => 'root',
owner => 'root',
mode => '644',
ensure => present,
source => "puppet:///modules/motd/motd",
}
}</pre>
=Automagi=
Absolutt ingen snøring på hva som er greia her. torjehoa har til nå kjørt manuelt når han vil noe, men det er nok ikke slik det henger sammen, det er nok automagi i bildet.

Drift/Puppet

2015-07-19T04:02:53Z

Knuta: /* Git-endringslager */

Puppet er et fint og flott system for å distribuere informasjon mellom maskiner med forskjellige operativsystemer og maskinvare. Det fases i første omgang inn på [[Maskiner/Dash8|dash8]]. torjehoa fra avdeling for brå og uventet drifting fjernet pkgsync fra denne og annekterte maskinen til å teste Puppet på inntil videre. pkgsync så mest ut som om den hadde '*' i musthave. Dette syntes torjehoa var kjipt.

Lure ting:
* Installer vim-puppet og puppet-el (pakker for puppetsyntaks i vim og Emacs).
* Rediger /etc/default/puppet til å starte Puppet.

=== Git-endringslager ===
Puppet-konfigen (som fortsatt ser mistenkelig ut som rdist-konfig) sjekkes ut automatisk den første gangen du logger inn på puppet-boksen (i skrivende stund lommel.pvv.ntnu.no). Når vi har fått portet rdist-konfigen vil du "slå på" endringer ved å pushe dem til origin.

=== Diste en fil ===
Disting av filer gjøres ved å opprette klasser og å tilordne maskiner til forskjellige klasser (karakterer ser det dog ikke ut til å være). Sørg for at nodetypen inkluderer (include) denne klassen. Noden definerer du i /etc/puppet/manifest/site.pp: denne ser ut til å holde orden på alle maskinene på bruket. Selve klassen opprettes i manifests/classes/, hvor du lager en ny fil med passende navn.

==== Diste motd ====
Disse filene dister filen /etc/puppet/modules/motd/files/motd/, ganske logisk igrunnen at den interne pathen har et ekstra navn, men du venner deg til det.

puppet:/// sender deg til puppetdir, som er /etc/puppet/ i vårt tilfelle.
<pre># /etc/puppet/manifests/site.pp

import "classes/*"

node default {
include motd
}</pre>

<pre># /etc/puppet/manifests/classes/motd.pp

class motd
{
file {"/local/etc/motd":
group => 'root',
owner => 'root',
mode => '644',
ensure => present,
source => "puppet:///modules/motd/motd",
}
}</pre>
=Automagi=
Absolutt ingen snøring på hva som er greia her. torjehoa har til nå kjørt manuelt når han vil noe, men det er nok ikke slik det henger sammen, det er nok automagi i bildet.

Maskiner/Dvask

2014-03-10T17:38:23Z

Knuta: /* Misc. */

= Hardware =

MicroVAX II.

= OS =

NetBSD

= Funksjon =

DNS

= Misc. =

Se [[Drift/DNS og dvask]] for informasjon om hvordan man jobber på dvask.

== Boot monitor ==

Boot monitoren (firmware) på dvask starter når maskinen starter og viser et >>>-prompt. Man kan hoppe ut i boot monitoren når som helst ved å sende break på seriekonsollet (Ctrl-A F i minicom, ~# i cu).
* b - Boot, boot standard.
* c - Continue, fortsett der vi var.

__NOTOC__

Maskiner/Dvask

2014-03-10T17:38:00Z

Knuta:

= Hardware =

MicroVAX II.

= OS =

NetBSD

= Funksjon =

DNS

= Misc. =

Se [[DNS og dvask]] for informasjon om hvordan man jobber på dvask.

== Boot monitor ==

Boot monitoren (firmware) på dvask starter når maskinen starter og viser et >>>-prompt. Man kan hoppe ut i boot monitoren når som helst ved å sende break på seriekonsollet (Ctrl-A F i minicom, ~# i cu).
* b - Boot, boot standard.
* c - Continue, fortsett der vi var.

__NOTOC__

CERTsrapport/V2014

2014-02-14T14:10:31Z

Knuta: Created page with "Rundt 26. oktober ble PVV svartelistet i SpamCop. Grunnen var at en kompromittert bruker hadde sendt ut store mengder spam. Årsaken til at brukeren ble kompromittert er ukjent, …"

Rundt 26. oktober ble PVV svartelistet i SpamCop. Grunnen var at en kompromittert bruker hadde sendt ut store mengder spam. Årsaken til at brukeren ble kompromittert er ukjent, men det er sannsynlig at det var snakk om SSH-bruteforce. Cert noterer at vi nok bør fikse noe ratelimiting og varsling når enkeltbrukere begynner å sende farlig mye epost.

tim (brukerweb) har vært en god del nede denne perioden, stort sett på grunn av buggy PHP-programvare som får alle indianerbarna til å løpe i sirkel rundt totempælen uten å klare å stoppe. Det er noe usikkert hvorfor PHP-scriptene ikke timer ut som de skal, men det er mulig de faktisk gjør det, men at ymse crawlere bare setter dem i gang igjen med en gang.

PVV ble brukt som forsterkende ledd i noen DDoS-angrep i januar, på grunn av en feilkonfigurering i NTP. Dette ble fikset, men et par uker senere kom det inn klager på dvask. dvask er ikke i rdist, og hadde derfor glidd under radaren. Det er nok tvilsomt at en 4MHz µVAX II fra 1985 klarte å bidra særlig mye i det aktuelle angrepet, men det var tydeligvis nok til å bli lagt merke til.

Californiafilialen av CERT er fremdeles den mest aktive, og den eneste med tilgang til loghost. Cert er som vanlig særdeles mottakelige for nominasjoner til nye medlemmer. CERT oppfordrer også drift til å sette opp sin egen loghost, slik at visse ting kan feilsøkes litt lettere uten å måtte innom CERT.

CERTsrapport/H2013

2013-09-12T08:10:22Z

Knuta: Created page with "En bruker ble kompromittert rett før forrige halvårsmøte. Vi fant aldri ut hvordan angriperene fikk tak i passordet. Stud-drift hevder de heller ikke hadde noen tegn til brute…"

En bruker ble kompromittert rett før forrige halvårsmøte. Vi fant aldri ut hvordan angriperene fikk tak i passordet. Stud-drift hevder de heller ikke hadde noen tegn til bruteforcing.

Noen glemte et rootskall innlogget på tty1 på tallulah 2. mars, men ingenting tyder på at det ble misbrukt. Det ble drept av drifteren som oppdaget det. CERT bemerker at neste gang kan det være lurt å sjekke $LOGNAME før man dreper skallet, så man vet hvem det var som glemte det.

16. mars gikk en gallery-installasjon amok og låste samtlige apachebarn. Katalogen ble sperret med chmod og brukeren fikk en passiv-aggressiv epost.

En gang i mars sluttet Google å stole på sertifikatet til pop.pvv.ntnu.no. Vi vurderte å fikse ordentlig sertifikat, men endte med å bare be brukeren videresende med .forward-filen sin isteden.

Noen flere gallery-installasjoner gikk agurk, og 23. mai ihversatte CERT søk på hele disken etter andre potensielle syndere. CERT kan ikke huske om de gjorde noe med søkeresultatet, så det er gode sjanser for at det ble glemt.

Status på loghost er fortsatt som før, det er bare knuta som har passordet. Videre er det fortsatt åpent for nominasjoner til CERT.

Halvårsmøte/2013V

2013-02-14T18:56:49Z

Knuta: /* Sak 6: CERTs halvårsrapport */

== Innkallinger ==

* [http://list.pvv.org/pipermail/aktive/2013-January/001091.html Første innkalling]
* [http://list.pvv.org/pipermail/aktive/2013-February/001092.html Innkalling med endelig saksliste]

== Referat ==

=== Referat fra halvårsmøte i Programvareverkstedet 14.02.2013 ===

De tilstedeværende på møtet er (brukernavn og fullt navn):

==== Saksliste ====

<ol start="0">
<li>Møtet er satt</li>
<li>Valg av ordstyrer, referent, tellekorps og protokollunderskrivere</li>
<li>Godkjenning av innkalling og dagsorden</li>
<li>Godkjenning av referat fra forrige halvårsmøte</li>
<li>Styrets halvårsrapport</li>
<li>Drifts halvårsrapport</li>
<li>CERTs halvårsrapport</li>
<li>Godkjenning av forrige års regnskap</li>
<li>Godkjenning av årets budsjett</li>
<li>Nominasjon av kandidater til prisene «Beste program» og «Årets hakker»</li>
<li>Kåring av «Beste program» og «Årets hakker»</li>
<li>Utdeling av prisen «Beste kurs»</li>
<li>Valg av styre</li>
<li>Valg av revisor</li>
<li>Valg av valgkomité</li>
<li>Møtet heves</li>
</ol>

==== Sak 0: Møtet er satt ====

==== Sak 1: Valg av ordstyrer, referent, tellekorps og protokollunderskrivere ====

==== Sak 2: Godkjenning av innkalling og dagsorden ====

==== Sak 3: Godkjenning av referat fra forrige halvårsmøte ====

==== Sak 4: Styrets halvårsrapport ====

==== Sak 5: Drifts halvårsrapport ====

[[Driftsrapport/V2013|drifts halvårsrapport]].

==== Sak 6: CERTs halvårsrapport ====
[[CERTsrapport/V2013|CERTs halvårsrapport]]

==== Sak 8: Godkjenning av årets budsjett ====

==== Sak 13: Valg av styre ====

==== Sak 14: Valg av valgkomité ====

==== Sak 15: Møtet heves ====

__NOTOC__

CERTsrapport/V2013

2013-02-14T18:55:40Z

Knuta: Created page with "CERT patchet et alvorlig DKIM-relatert sikkerhetshull i Exim 26. oktober, mest for å være på den sikre siden. Hullet rammet trolig ikke PVV, siden vi ikke bruker DKIM. En bru…"

CERT patchet et alvorlig DKIM-relatert sikkerhetshull i Exim 26. oktober, mest for å være på den sikre siden. Hullet rammet trolig ikke PVV, siden vi ikke bruker DKIM.

En bruker fikk kompromittert kontoen sin i februar, dette ble (som vanlig) oppdaget ved at sudo sendte E-post. CERT bemerker at e-postene til sudo har vist seg å være nyttigere enn tidligere antatt. CERT tar selvkritikk for å ikke ha innsett at e-posten var på grunn av kompromittering, og ytterligere selvkritikk for å ha brukt noen dager på å reagere. CERT bemerker også at vi nok bør sende cronmail til flere driftere, de siste årene har nye driftere utelukkende blitt påmeldt driftslista.

Angrepet er for ferskt til å konkludere, men er etter alt å dømme et kompromittert passord, enten bruteforcet eller sniffet på en annen maskin der tvilling.pvv.ntnu.no var i known_hosts. Angriperene ser ikke ut til å ha gjort annet enn å forsøke å kjøre sudo, og gadd trolig ikke bry seg med boksen når det ikke fungerte.

CERT bemerker at den eneste i CERT som har passordet til loghost er Knut Auvor (knuta). Dette bør nok ordnes vha PGP-distribuering av passordet til øvrige medlemmer av CERT, men har ikke skjedd. Apropos øvrige medlemmer av CERT, CERT er mottakelige for nominasjoner. CERTs hovedkvarter er for tiden i California, og norske korrespondenter ville være kjærkomne.

Drift/Endre bruker i kadmin

2012-10-30T10:41:55Z

Knuta: link direkte til «Lage adminprincipal» i kerberosdoken

For å endre en brukers passord, logg inn med kadmin med adminprincipalen din (om du ikke har en adminprincipal, se [[Drift/Kerberos#Lage_admin-principal]] for info om hvordan du skaffer deg en):

kadmin -p knuta/admin

Når du er inne i skallet bruker du kommandoen passwd for å sette et nytt passord:

passwd johndoe

Om dette ikke virker (fordi brukeren ikke har noen adminprincipal fra før) kan du lage en ny:

add johndoe

Velg defaults på alle valg (bortsett fra når den ber om passord, så klart).

Retroinfo for mimrere:

* [[Redigere passwd]]: Hvordan redigere passordfilen.

Drift/Endre bruker i kadmin

2012-10-30T10:39:22Z

Knuta: Created page with "For å endre en brukers passord, logg inn med kadmin med adminprincipalen din (om du ikke har en adminprincipal, se Drift/Kerberos for info om hvordan du skaffer deg en): k…"

For å endre en brukers passord, logg inn med kadmin med adminprincipalen din (om du ikke har en adminprincipal, se [[Drift/Kerberos]] for info om hvordan du skaffer deg en):

kadmin -p knuta/admin

Når du er inne i skallet bruker du kommandoen passwd for å sette et nytt passord:

passwd johndoe

Om dette ikke virker (fordi brukeren ikke har noen adminprincipal fra før) kan du lage en ny:

add johndoe

Velg defaults på alle valg (bortsett fra når den ber om passord, så klart).

Retroinfo for mimrere:

* [[Redigere passwd]]: Hvordan redigere passordfilen.

Drift

2012-10-30T10:35:16Z

Knuta: Oppdatert passordendringsinfo

Drift har ansvaret for å drive maskinene på PVV. Tidligere var drift organisert i egne grupper, først med ansvar for bestemte maskiner, deretter for bestemte tjenester, men har siden 2002 vært organisert i en stor driftsgruppe. I tillegg finnes en gruppe med ansvar for drift av e-postsystemet og en [[CERT|sikkerhetsgruppe]].

Dersom du har generelle spørsmål skal disse sendes drift(at)pvv.ntnu.no, ikke til enkelpersoner som er med i driftsgruppa. Driftskoordinator er p.t. `orjane`.

Husk at drift utelukkende består av frivillige. Ingen får betalt for å gjøre dette og ingen driver med dette 24 timer i døgnet, 365 dager i året. Vi vil likevel gjøre vårt beste for å gi god hjelp og service til våre brukere.

Driftsgruppen har ingen strenge krav til aktivitet eller erfaring for å bli medlem, så selv om du er ny i virket går det fint an å bare observere og absorbere i begynnelsen. Det finnes også en slags [[/Intro|introduksjon]] for nye driftere.

= [[Dokumentasjon|Nyttig for både bruk og drift]] =
Se [[Dokumentasjon]]

= Bare nyttig for drift =
* [[/ToDo]] Ting som trenger gjøring
* [[/Scanner]] Scanner
* [[/Netboot]] Legge til linuxer i pxe-boot
* [[/DNS og dvask]] Legge til record på namnetenaren vår, dvask
* [[/Kerberos]] Oppsett av kerberos
* [[/Mediawiki]] Oppsett av mediawiki
* [[/Seriellkonsoll]] Oppsett av seriellkonsoll
* [[/TRAC]] Trac på dev.pvv.ntnu.no
* [[/Puppet]] Dokumentasjon for Puppet

= Handling drift ofte utfører =

* [[Legge til bruker]]: Hvordan legge til en ny bruker på PVV.
* [[Drift/Endre brukeres passord]] Endre brukeres passord
* [[Redigere kvote]]: Hvordan opprette/utvide diskplass for en bruker når han har betalt for utvidet kvote.
* [[Planlagt nedetid]]: Prosedyre for varsling av planlagt nedetid.
* [[Systembrukere]]: Regler for systembrukere.
* [[Endre eller slette bruker]]: Hva som skal gjøres når man endrer eller sletter brukere
* [[Opprette nye prosjekt på dev]]: Ting og tang som må gjøres for å opprette et nytt prosjekt.
* [[Drift/Oppdatere SSL-sertifikater|Oppdatere SSL-sertifikater]]
* [[Starte etter strømbrudd]]: Hva må gjøres når strømmen har vært borte?

== Annet ==
* [[Drift/Backup|Backup]]
* [[Drift/Maskininstallasjon|Installasjon av OS]]
* [[Drift/Pakkeinstallasjon|Installasjon av programvare]]
* OS-Drift
** [[Drift/Partisjonering]]
** [[Drift/IRIX Install]]
** [[Drift/VAX Netboot]]
** [[Maskiner/Vrimmel|Virtualisering på vrimmel.pvv.ntnu.no]]
** [[Drift/SUSE]]
* [[Drift/RootpassordReglement]]
* [http://www.pvv.ntnu.no/rootpassordskjema.ps Rootpassordskjema]

= Roteloftet =

Sider som egentlig ikke er relevante lenger.

* <del>[[Maskiner/Octopus|Octopus]]</del> (Ikke i bruk)
* [[Drift/Wiki|Den gamle wikien]]
* [[Drift/Bacula|Bacula, det forrige backupsystemet]]

__NOTOC__

Drift/Redigere passwd

2012-10-30T10:34:17Z

Knuta:

Dette er totalt utdatert, se heller [[Drift/Endre brukeres passord]]

Hvis en bruker kjører <code><nowiki>yppasswd</nowiki></code> mens du redigerer passordfila, kan alt skje. Så hanche har installert et program <code><nowiki>/var/yp/edityppw</nowiki></code> på [[Maskiner/Anar]] som låser passordfila slik at <code><nowiki>rpc.yppasswdd</nowiki></code> holder fingrene av fatet.

Det ligger et skript under <code><nowiki>/var/yp/</nowiki></code> med fire navn: <code><nowiki>vi-passwd</nowiki></code>, <code><nowiki>vim-passwd</nowiki></code>, <code><nowiki>emacs-passwd</nowiki></code>, <code><nowiki>ed-passwd</nowiki></code> som man kan bruke for å redigere passordfilen med sin favoritteditor, eller man kan bruke skriptet som oppskrift på hvordan edityppw skal brukes. Alle disse scriptene kjøres som root på anar.

__NOTOC__

Dokumentasjon

2012-10-30T10:31:45Z

Knuta:

Her finner du dokumentasjon om bruk av PVVs systemer.

Administrativt:
* [[Medlemskontingent|Betale kontingent/Melde seg inn]]
* [[Passordendring|Glemt/endre passord]]
* [[Feilmelding|Melde feil ved PVVs maskiner]] (eller kontakt drift per epost)
* [[Diskplass|Hvor mye diskplass har du, og hvordan skaffe mer?]]
* [[Korttilgang|Hvordan få korttilgang til PVVs lokaler]]

Koble til PVV:
* [[Unixkommandoer|Introduksjon til kommandolinjen]]
* [[Drift/Mail|Introduksjon til epostsystemet]]
* [[Drift/Samba|Tilgang til hjemmeområdet fra Windows]]
* [[SSL-Sertifikat|Sikkerhetssertifikatet]]
* [[Versjonskontroll|Versjonskontrollsystemer]]
* [https://www.pvv.ntnu.no/webmail/src/login.php Webmail]
* [http://tvilling.pvv.ntnu.no:631/printers/ Utskrift]

Tjenester:
* [[Hjemmesider|Opprettelse av hjemmesider]]
* [[Drift/Web|Teknisk informasjon om webserveren]]
* [[Databaser|Bruk av PVVs MySQL- og PostgreSQL-databaser]]
* [[Maskiner/Tjenestealias|Tjenestealias]] for en del tjenester.

== Tekniske detaljer ==

Om du er av den nysgjerrige typen og vil ha mer detaljert info, se [[Drift|sidene til drift]].

Kurs/Linux-kommandolinje for viderekomne

2012-09-30T07:16:47Z

Knuta: /* Filer fra kurset */

Tid: Torsdag 13. september 2012, kl. 18:15 
Sted: [[../Hvor er R3?|R3]] 
Kursholder: Knut Auvor Grythe 

Om du trodde kommandolinjen i Linux bare duger til å skrive «sudo
apt-get» tar du feil. Shellet er et utrolig kraftig verktøy, og
om du lærer deg å bruke det effektivt kan det gi deg store
tidsbesparelser i hverdagen.

Kurset kommer til å ta for seg enkel tekstparsing ved hjelp av
onelinere, en intro til multikunstneren find, diverse triks med
grep, sort, uniq, xargs og lignende, subskall og hvordan det kan
gjøre onelineren din mer robust, behandling eller kombinering av
output fra ulike kommandoer samtidig uten bruk av midlertidige
filer, og sannsynligvis en hel del mer. Det blir også muligheter
for å prøve å sette kursholder fast med vanskelige spørsmål eller
utfordringer.

Vi kommer til å bruke bash siden det er vanligst, men det meste vil
virke i zsh, sh og andre POSIX-lignende shell også.

== Filer fra kurset ==
* [http://www.pvv.ntnu.no/~knuta/kurs/bash/bashkurs.txt Oversikt i stikkordsform]
* [http://www.pvv.ntnu.no/~knuta/kurs/bash/logg.txt Uredigert logg fra terminalen (full av kontrolltegn, renskes kanskje senere)]

Kurs/Linux-kommandolinje for viderekomne

2012-09-30T07:16:26Z

Knuta: /* Filer fra kurset */

Tid: Torsdag 13. september 2012, kl. 18:15 
Sted: [[../Hvor er R3?|R3]] 
Kursholder: Knut Auvor Grythe 

Om du trodde kommandolinjen i Linux bare duger til å skrive «sudo
apt-get» tar du feil. Shellet er et utrolig kraftig verktøy, og
om du lærer deg å bruke det effektivt kan det gi deg store
tidsbesparelser i hverdagen.

Kurset kommer til å ta for seg enkel tekstparsing ved hjelp av
onelinere, en intro til multikunstneren find, diverse triks med
grep, sort, uniq, xargs og lignende, subskall og hvordan det kan
gjøre onelineren din mer robust, behandling eller kombinering av
output fra ulike kommandoer samtidig uten bruk av midlertidige
filer, og sannsynligvis en hel del mer. Det blir også muligheter
for å prøve å sette kursholder fast med vanskelige spørsmål eller
utfordringer.

Vi kommer til å bruke bash siden det er vanligst, men det meste vil
virke i zsh, sh og andre POSIX-lignende shell også.

== Filer fra kurset ==
- [http://www.pvv.ntnu.no/~knuta/kurs/bash/bashkurs.txt Oversikt i stikkordsform]
- [http://www.pvv.ntnu.no/~knuta/kurs/bash/logg.txt Uredigert logg fra terminalen (full av kontrolltegn, renskes kanskje senere)]

Kurs/Linux-kommandolinje for viderekomne

2012-09-30T07:15:50Z

Knuta:

Tid: Torsdag 13. september 2012, kl. 18:15 
Sted: [[../Hvor er R3?|R3]] 
Kursholder: Knut Auvor Grythe 

Om du trodde kommandolinjen i Linux bare duger til å skrive «sudo
apt-get» tar du feil. Shellet er et utrolig kraftig verktøy, og
om du lærer deg å bruke det effektivt kan det gi deg store
tidsbesparelser i hverdagen.

Kurset kommer til å ta for seg enkel tekstparsing ved hjelp av
onelinere, en intro til multikunstneren find, diverse triks med
grep, sort, uniq, xargs og lignende, subskall og hvordan det kan
gjøre onelineren din mer robust, behandling eller kombinering av
output fra ulike kommandoer samtidig uten bruk av midlertidige
filer, og sannsynligvis en hel del mer. Det blir også muligheter
for å prøve å sette kursholder fast med vanskelige spørsmål eller
utfordringer.

Vi kommer til å bruke bash siden det er vanligst, men det meste vil
virke i zsh, sh og andre POSIX-lignende shell også.

== Filer fra kurset ==
[http://www.pvv.ntnu.no/~knuta/kurs/bash/bashkurs.txt Oversikt i stikkordsform]
[http://www.pvv.ntnu.no/~knuta/kurs/bash/logg.txt Uredigert logg fra terminalen (full av kontrolltegn, renskes kanskje senere)]