Programvareverkstedet - User contributions [en]

Maskiner/Dash8

2022-09-24T20:33:39Z

Ecsvihus: /* Maskinvare */ added OS and Function

== OS ==

Debian 10

== Funksjon ==

CUPS, bitlbee

= Maskinvare =
* CPU: Intel(R) Xeon(TM) CPU 3.20GHz
* 2.96 GB RAM
* 70 GB DISK

== OS ==

Debian Buster

== Funksjon ==

CUPS og bitlbee

Maskiner/isvegg

2022-09-24T20:31:36Z

Ecsvihus: /* Maskinvare */ formatting

= Programvare / OS =
Ingen spesifikk arbeidsoppgave, åpen for bruk av alle medlemmer. Fin servermaskin for web- og andre prosjekter.

Kjører for øyeblikket Debian 11(Bullseye).

= Maskinvare =
* CPU: Intel(R) Core(TM) i5-3570 @ 3.40GHz
* GPU: AMD ATI Radeon HD 6670/7670
* 16GB RAM
* 2x 120GB disker i raid 1
* 2x 470GB disker i raid 1

= Historie =
Isvegg er en blanding av kabinettet til [[/Horisont]], innmaten fra en arbeidsPC fra byggsikring og en dobbel strømforsyning fra den gamle adgangsserveren til byggsikring.
Maskinen er blitt satt i drift uten noen formell funksjon.

Maskiner/ludvigsen

2022-09-24T20:30:34Z

Ecsvihus: /* Maskinvare */

==Maskinvare==
* CPU: Intel Core i7-3770S
* 8 GB RAM
* 238 GB disk

==Tunnellen==
Ludvigsen er det ene endepunktet for [[Drift/Subnett|tunnellen]], på terminalrommet.
[[Maskiner/Knutsen|Knutsen]] er det andre endepunktet, på maskinrommet.

Maskiner/innovation

2022-09-24T19:35:15Z

Ecsvihus:

Minecraftserver \o/

Innovation har tatt over for monty som minecraftserver.
Den kjører nyeste vaniljeversjon av Minecraft.
Vi opererer med whitelisting så dersom du ønsker å bli lagt inn, må du stikke
innom på IRC/Discord og spørre oss. Evt. spør en av andreasd, davidk og terjesc.

Kart: http://minecraft.pvv.org/

===For Drift===
Et initscript slår minecraftserveren av og på (kjører i screen(1)).
Bruk service minecraft-screen start/stop/restart/status for å kontrollere den.
Serveren starter opp ved oppstart av maskinen automatisk.

davidk tar backup i ny og ne.

== Maskinvare ==

Kort oppsummering.

* CPU: Intel(R) Core(TM) i7-3770S CPU @ 3.10GHz
* 8 GB RAM
* 120 GB disk

== OS ==

CentOS 7

Maskiner/innovation

2022-09-24T19:33:27Z

Ecsvihus:

Minecraftserver \o/

Innovation har tatt over for monty som minecraftserver.
Den kjører nyeste vaniljeversjon av Minecraft.
Vi opererer med whitelisting så dersom du ønsker å bli lagt inn, må du stikke
innom på IRC/Discord og spørre oss. Evt. spør en av andreasd, davidk og terjesc.

Kart: http://minecraft.pvv.org/

== Maskinvare ==

Kort oppsummering.

* CPU: Intel(R) Core(TM) i7-3770S CPU @ 3.10GHz
* 8 GB RAM
* 120 GB disk

== OS ==

CentOS 7

===For Drift===
Et initscript slår minecraftserveren av og på (kjører i screen(1)).
Bruk service minecraft-screen start/stop/restart/status for å kontrollere den.
Serveren starter opp ved oppstart av maskinen automatisk.

davidk tar backup i ny og ne.

Drift/Salt

2022-09-24T19:21:08Z

Ecsvihus: /* Gjøre endringer */

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)]].

For montering av hjemmeområdene (autofs) skal bli tillat av filtjeneren må maskinen ha en IP addresse med gydlig DNS revers-oppslag. Legg den nye maskinen inn i DNS.

== Gjøre endringer ==

Endringer gjøres på salt-masteren (salt.pvv.ntnu.no, som for tiden peker på sleipner.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.

Maskiner/Spikkjeposche

2022-09-24T19:04:42Z

Ecsvihus: fixed formating

"Spikkjepøsche": Røros-dialekt for spekepølse. Favorittfrokosten til [[User:Pederbs]]

Denne maskinen serverer nettsidene til PVV.
Dette innebærer:

* reversproxy
* nettsiden
* mediawiki
* rainloop
* squirrelmail
* roundcube
* afterlogic-lite
* simplesamlphp IDP

Reversproxien er ansvarlig for HTTPS og ruter om de forskjellige addressene til de forskjellige tjenestene.
Addresser som starter med ~ rutes f.eks. videre til hjemmeområdehosten [[Maskiner/Tom]].

Alle nettsidene som er hostet på Spikkjeposche ligger i /usr/local/www, reversproksien er konfigurert i /usr/local/etc/lighttpd/www_pvv_ntnu_no.conf

== Maskinvare ==

* CPU: Intel(R) Xeon(R) CPU E3-1220 V2 @ 3.10GHz
* 1.96 GB RAM
* 8 GB disk

== OS ==

FreeBSD

Maskiner/Spikkjeposche

2022-09-24T19:04:22Z

Ecsvihus: added maskinvare info

"Spikkjepøsche": Røros-dialekt for spekepølse. Favorittfrokosten til [[User:Pederbs]]

Denne maskinen serverer nettsidene til PVV.
Dette innebærer:

* reversproxy
* nettsiden
* mediawiki
* rainloop
* squirrelmail
* roundcube
* afterlogic-lite
* simplesamlphp IDP

Reversproxien er ansvarlig for HTTPS og ruter om de forskjellige addressene til de forskjellige tjenestene.
Addresser som starter med ~ rutes f.eks. videre til hjemmeområdehosten [[Maskiner/Tom]].

Alle nettsidene som er hostet på Spikkjeposche ligger i /usr/local/www, reversproksien er konfigurert i /usr/local/etc/lighttpd/www_pvv_ntnu_no.conf

== Maskinvare ==

minne.
Os freebsd

* CPU: Intel(R) Xeon(R) CPU E3-1220 V2 @ 3.10GHz
* 1.96 GB RAM
* 8 GB disk

== OS ==

FreeBSD

Maskiner/Skrotnisse

2022-09-24T18:54:54Z

Ecsvihus: added maskinvare info

Skrotnisse kjører diverse tjenester

[[../Isvegg]] skal ta over. Backups ble lagt i `toriel:/backup/skrotnisse` ([[../Toriel]]) ettersom [[../Principal]]
er furten.

== Maskinvare ==
* CPU: Intel(R) Xeon(TM) CPU 2.40GHz
* 4 GB RAM
* 70 GB disk

== OS ==

Debian Squeeze

== Funksjon ==

* dev.pvv.ntnu.no (inkludert trac, svn)
* [[Drift/Netboot]]
* CUPS

Maskiner/Tom

2022-09-24T18:22:22Z

Ecsvihus: /* Hardware */ added disk info

Den spirituelle etterfølgeren til [[Maskiner/Tim]]. Denne maskiner serverer hjemmeområdene til PVV brukere på pvv.ntnu.no/~BRUKERNAVN. Dette blir servert med apache fra ~BRUKERNAVN/web-docs mappen
[[Maskiner/Spikkjeposche]] proxyer relevante http forespursler videre til Tom.

==Hardware==
* CPU: Intel(R) Xeon(R) CPU E3-1220 V2 @ 3.10GHz
* 996MB RAM
* 16GB DISK

Maskiner/Monty

2022-09-24T18:20:42Z

Ecsvihus: /* Hardware */ added disk information

Maskin for å ssh til dns server dvask
Dvask-mgmt

== Hardware ==
* CPU: Intel(R) Xeon(TM) CPU 2.00GHz
* 3.71GB RAM
* 17GB DISK
* 34GB DISK

serielport for å snakke med dvask.

Maskiner/knutsen

2022-09-24T18:13:30Z

Ecsvihus: /* Maskinvare */ added disk information

==Maskinvare==
* CPU: Intel Core i7 860
* 16 GB RAM
* 240 GB DISK

==Tunnellen==
Knutsen er det ene endepunktet for [[Drift/Subnett|tunnellen]], på maskinrommet.
[[Maskiner/Ludvigsen|Ludvigsen]] er det andre endepunktet, på terminalrommet.

Maskiner/hildring

2022-09-24T17:58:29Z

Ecsvihus: /* Hardware */ added disk information and fixed formating

= Hildring =

Dette er PVVs primære login maskin, det er en søt liten sak som for tiden kjører debian Jessie.

== Hardware ==
CPU: Intel(R) Xeon(R) CPU E3-1220 V2 @ 3.10GHz

1.95G RAM

16GB DISK

Maskiner/Dash8

2022-09-24T17:46:26Z

Ecsvihus: /* Maskinvare */ fixed formating to match template

== OS ==

Debian 10

== Funksjon ==

CUPS, bitlbee

= Maskinvare =
CPU: Intel(R) Xeon(TM) CPU 3.20GHz

2.96 GB RAM

70 GB DISK

Maskiner/Dash8

2022-09-24T17:45:58Z

Ecsvihus: /* Maskinvare */ added disk information

== OS ==

Debian 10

== Funksjon ==

CUPS, bitlbee

= Maskinvare =
Intel(R) Xeon(TM) CPU 3.20GHz

2.96 GB RAM

70 GB DISK

Maskiner/isvegg

2022-09-24T17:38:14Z

Ecsvihus: added disk information

= Programvare / OS =
Ingen spesifikk arbeidsoppgave, åpen for bruk av alle medlemmer. Fin servermaskin for web- og andre prosjekter.

Kjører for øyeblikket Debian 11(Bullseye).

= Maskinvare =
CPU: Intel(R) Core(TM) i5-3570 @ 3.40GHz

GPU: AMD ATI Radeon HD 6670/7670

16GB RAM

2x 120GB disker i raid 1

2x 470GB disker i raid 1

= Historie =
Isvegg er en blanding av kabinettet til [[/Horisont]], innmaten fra en arbeidsPC fra byggsikring og en dobbel strømforsyning fra den gamle adgangsserveren til byggsikring.
Maskinen er blitt satt i drift uten noen formell funksjon.