ICO wiki - User contributions [en]

User:Hleinola

2011-09-02T09:23:28Z

Hleinola: /* Powershell kodutöö */

== Quest lahendus 37 - Skript, mis leiab etteantud kataloogist kõik katkised nimelingid [Bash] ==
<source lang="bash">
#!/bin/bash
#Autor: Henrik Leinola
#Versioon: 0.1

OODATUD_ARGU=1
REKURSIIVSELT="-r"

die () {
echo >&2 "$@"
exit 1
}

if [ $# -lt $OODATUD_ARGU ]; then
die "Kasutamine:" $0 "ja kataloogi nimi."
fi

if [ ! -d $1 ]; then
die "Tegemist ei ole kataloogiga."
fi

if [ $# -gt $OODATUD_ARGU ]; then

if [ $2 == $REKURSIIVSELT ]; then
find $1 -type l ! -exec test -r {} \; -print 2>/dev/null
else
die "Rekursiivselt otsimiseks kasuta -r argumenti."
fi
else
ind $1 -maxdepth 1 -type l ! -exec test -r {} \; -print 2>/dev/null
fi
exit 0
</source>

==Powershell kodutöö==
<source lang = "Powershell">
#Skript, eemaldab mp3 faili nimest alakriipsud ja muudab kõikide sõnade esimese tähe suureks
#Autor: Henrik Leinola

Param($Path)

$Extension = "mp3"

if (Test-Path $Path)
{
cd $Path
$AllFiles = Get-ChildItem . *.$Extension | % { [IO.Path]::GetFileNameWithoutExtension($_) }
}
else
{
Write-Host "Sellist kausta ei eksisteeri"
exit
}

foreach ($File in $AllFiles) {
$String = $File.ToString()
$String = $String -replace '_',' '
$String = $String.ToLower()
$String = (Get-Culture).TextInfo.ToTitleCase($String)
Rename-Item "$File.$Extension" "$String.$Extension"
}

cd ..
</source>

== Pythoni kodutöö ==
<source lang="Python">
#!/usr/bin/python
# -*- coding: utf-8 -*-
#Autor: Henrik Leinola
#Skript, mis võtab teksti failist ees- ja perenime ning teeb nendest kasutaja nime, genereerib parooli ja loob vastava kasutaja ning väljastab tulemused uude tekstifaili.

import sys, os, random

NewName = True
String = ""
LowerCase = "abcdefhijklmnopqrstuv"
UpperCase = "ABCDEFGHIJKLMNIPQRSTUV"
Numbers = "1234567890"

if os.getuid() != 0:
print "Käivita skript juurkasutaja õigustes!"
sys.exit(1)

if len(sys.argv) == 3:
SourceFile = sys.argv[1]
OutFile = sys.argv[2]
else:
print "Kasuta skripti järgmiselt: " + sys.argv[0] + " <sisend fail> <väljund fail>"
sys.exit(1)

def GeneratePassword():
password = ""
for i in range(1,12):
rand = random.randrange(1,4)
if rand == 1:
rand = random.randrange(1,len(LowerCase))
char = LowerCase[rand]
elif rand == 2:
rand = random.randrange(1,len(UpperCase))
char = UpperCase[rand]
else:
rand = random.randrange(1,len(Numbers))
char = Numbers[rand]
password = password + char
return password

fh = open(SourceFile)
AllLines = fh.readlines()
fh.close()

fw = open(OutFile,"w")
for line in AllLines:
name = line.split()
for part in name:
if NewName:
Counter = len(name)
NewName = False

String = (String + part[:4])
Counter = Counter - 1
if Counter == 0:
NewName = True
UserPassword = GeneratePassword()
Write = (String + " " + UserPassword)
fw.write(Write + "\n")
os.system ("useradd -m -d /home" + String + " " + String + " ")
os.system ("echo " + String + ":" + UserPassword + "| chpasswd ")
String = ""
fw.close()
</source>

User:Hleinola

2011-06-09T20:57:06Z

Hleinola: /* Pythoni kodutöö */

== Quest lahendus 37 - Skript, mis leiab etteantud kataloogist kõik katkised nimelingid [Bash] ==
<source lang="bash">
#!/bin/bash
#Autor: Henrik Leinola
#Versioon: 0.1

OODATUD_ARGU=1
REKURSIIVSELT="-r"

die () {
echo >&2 "$@"
exit 1
}

if [ $# -lt $OODATUD_ARGU ]; then
die "Kasutamine:" $0 "ja kataloogi nimi."
fi

if [ ! -d $1 ]; then
die "Tegemist ei ole kataloogiga."
fi

if [ $# -gt $OODATUD_ARGU ]; then

if [ $2 == $REKURSIIVSELT ]; then
find $1 -type l ! -exec test -r {} \; -print 2>/dev/null
else
die "Rekursiivselt otsimiseks kasuta -r argumenti."
fi
else
ind $1 -maxdepth 1 -type l ! -exec test -r {} \; -print 2>/dev/null
fi
exit 0
</source>

==Powershell kodutöö==
<source lang = "Powershell">
#Skript, eemaldab mp3 faili nimest alakriipsud ja muudab kõikide sõnade esimese tähe suureks
#Autor: Henrik Leinola

Param($Path)

$Extension = "mp3"

if (Test-Path $Parth)
{
cd $Path
$AllFiles = Get-ChildItem . *.$Extension | % { [IO.Path]::GetFileNameWithoutExtension($_) }
}
else
{
Write-Host "Sellist kausta ei eksisteeri"
exit
}

foreach ($File in $AllFiles) {
$String = $File.ToString()
$String = $String -replace '_',' '
$String = $String.ToLower()
$String = (Get-Culture).TextInfo.ToTitleCase($String)
Rename-Item "$File.$Extension" "$String.$Extension"
}

cd ..
</source>

== Pythoni kodutöö ==
<source lang="Python">
#!/usr/bin/python
# -*- coding: utf-8 -*-
#Autor: Henrik Leinola
#Skript, mis võtab teksti failist ees- ja perenime ning teeb nendest kasutaja nime, genereerib parooli ja loob vastava kasutaja ning väljastab tulemused uude tekstifaili.

import sys, os, random

NewName = True
String = ""
LowerCase = "abcdefhijklmnopqrstuv"
UpperCase = "ABCDEFGHIJKLMNIPQRSTUV"
Numbers = "1234567890"

if os.getuid() != 0:
print "Käivita skript juurkasutaja õigustes!"
sys.exit(1)

if len(sys.argv) == 3:
SourceFile = sys.argv[1]
OutFile = sys.argv[2]
else:
print "Kasuta skripti järgmiselt: " + sys.argv[0] + " <sisend fail> <väljund fail>"
sys.exit(1)

def GeneratePassword():
password = ""
for i in range(1,12):
rand = random.randrange(1,4)
if rand == 1:
rand = random.randrange(1,len(LowerCase))
char = LowerCase[rand]
elif rand == 2:
rand = random.randrange(1,len(UpperCase))
char = UpperCase[rand]
else:
rand = random.randrange(1,len(Numbers))
char = Numbers[rand]
password = password + char
return password

fh = open(SourceFile)
AllLines = fh.readlines()
fh.close()

fw = open(OutFile,"w")
for line in AllLines:
name = line.split()
for part in name:
if NewName:
Counter = len(name)
NewName = False

String = (String + part[:4])
Counter = Counter - 1
if Counter == 0:
NewName = True
UserPassword = GeneratePassword()
Write = (String + " " + UserPassword)
fw.write(Write + "\n")
os.system ("useradd -m -d /home" + String + " " + String + " ")
os.system ("echo " + String + ":" + UserPassword + "| chpasswd ")
String = ""
fw.close()
</source>

User:Hleinola

2011-06-09T20:50:52Z

Hleinola:

== Quest lahendus 37 - Skript, mis leiab etteantud kataloogist kõik katkised nimelingid [Bash] ==
<source lang="bash">
#!/bin/bash
#Autor: Henrik Leinola
#Versioon: 0.1

OODATUD_ARGU=1
REKURSIIVSELT="-r"

die () {
echo >&2 "$@"
exit 1
}

if [ $# -lt $OODATUD_ARGU ]; then
die "Kasutamine:" $0 "ja kataloogi nimi."
fi

if [ ! -d $1 ]; then
die "Tegemist ei ole kataloogiga."
fi

if [ $# -gt $OODATUD_ARGU ]; then

if [ $2 == $REKURSIIVSELT ]; then
find $1 -type l ! -exec test -r {} \; -print 2>/dev/null
else
die "Rekursiivselt otsimiseks kasuta -r argumenti."
fi
else
ind $1 -maxdepth 1 -type l ! -exec test -r {} \; -print 2>/dev/null
fi
exit 0
</source>

==Powershell kodutöö==
<source lang = "Powershell">
#Skript, eemaldab mp3 faili nimest alakriipsud ja muudab kõikide sõnade esimese tähe suureks
#Autor: Henrik Leinola

Param($Path)

$Extension = "mp3"

if (Test-Path $Parth)
{
cd $Path
$AllFiles = Get-ChildItem . *.$Extension | % { [IO.Path]::GetFileNameWithoutExtension($_) }
}
else
{
Write-Host "Sellist kausta ei eksisteeri"
exit
}

foreach ($File in $AllFiles) {
$String = $File.ToString()
$String = $String -replace '_',' '
$String = $String.ToLower()
$String = (Get-Culture).TextInfo.ToTitleCase($String)
Rename-Item "$File.$Extension" "$String.$Extension"
}

cd ..
</source>

== Pythoni kodutöö ==
<source lang="Python">
#!/usr/bin/python
# -*- coding: utf-8 -*-
#Skript, mis võtab teksti failist ees- ja perenime ning teeb nendest kasutaja nime, genereerib parooli ja loob vastava kasutaja ning väljastab tulemused uude tekstifaili.

import sys, os, random

NewName = True
String = ""
LowerCase = "abcdefhijklmnopqrstuv"
UpperCase = "ABCDEFGHIJKLMNIPQRSTUV"
Numbers = "1234567890"

if os.getuid() != 0:
print "Käivita skript juurkasutaja õigustes!"
sys.exit(1)

if len(sys.argv) == 3:
SourceFile = sys.argv[1]
OutFile = sys.argv[2]
else:
print "Kasuta skripti järgmiselt: " + sys.argv[0] + " <sisend fail> <väljund fail>"
sys.exit(1)

def GeneratePassword():
password = ""
for i in range(1,12):
rand = random.randrange(1,4)
if rand == 1:
rand = random.randrange(1,len(LowerCase))
char = LowerCase[rand]
elif rand == 2:
rand = random.randrange(1,len(UpperCase))
char = UpperCase[rand]
else:
rand = random.randrange(1,len(Numbers))
char = Numbers[rand]
password = password + char
return password

fh = open(SourceFile)
AllLines = fh.readlines()
fh.close()

fw = open(OutFile,"w")
for line in AllLines:
name = line.split()
for part in name:
if NewName:
Counter = len(name)
NewName = False

String = (String + part[:4])
Counter = Counter - 1
if Counter == 0:
NewName = True
UserPassword = GeneratePassword()
Write = (String + " " + UserPassword)
fw.write(Write + "\n")
os.system ("useradd -m -d /home" + String + " " + String + " ")
os.system ("echo " + String + ":" + UserPassword + "| chpasswd ")
String = ""
fw.close()
</source>

Skriptimiskeeled: powershelli kodutööd 2011, kevad, päevaõpe

2011-06-08T19:52:47Z

Hleinola: /* Henrik Leinola */

[[Category: Skriptimiskeeled]]

=Kodutööd 2011, PowerShell=
Siia tulevad siis kokkuvõtted..
==Jaan Igamees==
Lühike jutt, mida skript teeb... bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla, bla.

[[PowerShell: Jaan Igamees, kavalskript]]

==Kaido Loonurm==

Arvutiinfo: Skript leiab arvuti seadeid ja konfiguratsiooni puudutava info (arvuti nimi, mälu hulk, protsessoritüüp jne) ning väljastab selle

[[PowerShell: Kaido Loonurm, PCinfo.ps1]]

==Ivar Ambos==
Ühendatud ketaste info

[[User:Iambos]]

==Vadim Vinogradin==
Ping skript
#Skript, mis kontrollib, saidi IP-aadressi töötamine.
#Kui töötab, siis kirjutab andmeid C:\ping.txt failisse, kui ei tööta, siis kirjutab andmeid C:\ping.txt failisse ja teavitab e-maili kaudu.

[[PowerShell: Vadim Vinogradin, Ping skript]]

==Tarmo Trumm==
Skript mis otsib üles kindla laiendiga failid, mis on x päeva vanad ja kustutab need.

[[PowerShell: Tarmo Trumm,Kustutame x-päeva vanad failid]]

==Toomas Rohumets==
Skript, mis muudab võrgukaardi MAC aadressi.

[[User:Trohumet]]

==Sergei Gorjunov==
Skript, mis loob uut kasutajat

[[User:Sgorjuno]]

==Oliver Kilk==
1. Skript, mis otsib arvutist kõik printerid ja väljastab need koos detailsemate andmetega

2. Skript, mis lahendab OU-sse kuuluvuse AD-s ning sisesndiks on tekstifail ja väljund samuti.

[[User:Okilk]]

==Karet Rikko==
Skript võtab kõikide kasutajate home folderite suuruse ning sorteerib suuruse järgi ning kirjutab kasutajanime ning kasutatud suuruse faili.

[[User:Krikko]]

==Vladimir Kolesnik==

Skript, mis kuvab kõike protsesse, mille mälu on üle 1MB ja vormistab sisend faili HTML kujul

[[PowerShell: Vladimir Kolesnik, maluCheck]] | [[User:Vkolesni|Vkolesni]] 19:42, 23 May 2011 (EEST)

--

Skript, mis kontrollib kas ettemääratud protsess töötab või ei.

[[PowerShell: Vladimir Kolesnik, minuProtsess]] | [[User:Vkolesni|Vkolesni]] 19:42, 23 May 2011 (EEST)

Lisaks saab leida siin: [[User:vkolesni]]

==Ivar Krustok==
skript, mis küsib emaili, eraldab sellest user ja domeeni. Uurib välja domeeni ip aadressi, kas kodukas on üleval ja mis aadressil ja prindib selle info arvutikasutaja folderisse txt faili koos kellajaga millal küsiti.

[[User:ikrustok]]

==Ilja Peters==
[[PowerShell: Ilja Peters, Kasutajate halduse skript]]

Skript mis haldab lokaalseid kasutajaid (lisab/kustutab/kuvab kasutajaid ning saab hallata gruppidesse kuuluvust)

==Rene Pärnpuu==
Otsib lokaalsest arvutist ülesse kõik installeeritud printerid ja shareb kõikidele kasutajatele antud arvutis.

[[PowerShell: Rene Pärnpuu, Printerid.ps1]]

==Arvutite Andmed==
tulemüürist tuleks lubada: windows management instrumentarium
UAC kinni või administrator account sisse
sisendiks on fail kuhu on kirjutatud arvutite nimed, millede eraldajaks on enter
väljundiks on viisakal kujul tekstifail mille ta meilile saata suudab
Kasutamine kujul skript.ps1 -in sisendfail -out väljudfail

<source lang="powershell">
$from = "kust@minuserver.ee"
$to = "kuhu@minuserver.ee"
$smtp = "smtp.minuserver.ee"
$smtp.EnableSsl = $True
param(
$in,
$out
)
$file = $out
New-Item -ItemType file $file -Force

Get-Content $in | ForEach-Object {
$computerSystem = ""
$computer = $_
$computerSystem = get-wmiobject win32_computersystem -computer $computer
$bios = get-wmiobject win32_bios -computer $computer
$operatingsystem = get-wmiobject win32_operatingsystem -computer $computer
$processor = get-wmiobject win32_processor -computer $computer
if(-not $computerSystem) {
Add-Content $file "Computer: $computer"
Add-Content $file "Error!"
}
else {
$user = $computerSystem.username
$manufacturer = $computerSystem.manufacturer
$model = $computerSystem.model
$serviceTag = $bios.serialnumber
$os = $operatingsystem.caption
$servicePack = $operatingsystem.servicepackmajorversion
$coreCount = @($processor)[0].numberofcores
$procName = @($processor)[0].name
$ram = [int]$operatingsystem.totalvisiblememorysize / 1024
$disk = gwmi -computer $computer -class win32_logicaldisk -Credential $creds -Filter "DriveType = '3'" | select DeviceID,Size
Add-Content $file "Computer: $computer"
Add-Content $file "Manufacturer: $manufacturer"
Add-Content $file "OS: $os"
Add-Content $file "ServicePack: $servicePack"
Add-Content $file "CoreCount: $coreCount"
Add-Content $file "Processor Name: $procName"
Add-Content $file "Ram: $ram"
$i = 0
if($disk -is [system.array]){
while ($i -ne ($disk.length)) {
$id = @($disk)[$i].deviceid
$size = (@($disk)[$i].size / 1GB)
Add-Content $file "$id $size GB"
$i++
}
}
else {
$id = $disk.deviceid
$size = ($disk.size / 1GB)
Add-Content $file "$id $size GB"
}
}
Add-Content $file "##############################################"
}
$smtpserver = “smtp.neti.ee” #Siia kirjuta oma SMTP serveri aadress
$message = new-object Net.Mail.MailMessage
$att = new-object Net.Mail.Attachment($file)
$smtp = new-object Net.Mail.SmtpClient($smtpserver)
$message.From = $from #Saatja meiliaadress
$message.To.Add($to) #Saaja meiliaadress
$message.Subject = “Computer Information ( $(date) )” #E-maili pealkiri
$message.Body = “$failinimi on lisatud manustesse.” #E-Maili sisu ( tekst )
$message.Attachments.Add($att)
$smtp.Send($message)

$att.Dispose()
$message.Dispose()
</source>

==Rene Sepp==
Skript, mis disableb/enableb wireless adapterit.

[[User:rsepp]]

==Automatiseeritud portide avamine ja sulgemine - Katrin Kukk==
tulemüürist tuleks lubada: windows management instrumentarium

UAC kinni või administrator account sisse

sisendiks on failid:

1) arvutite nimed

2) portide numbrid

skript töötab kujul: skript.ps1 -pcs <sisendfail> -ports <sisendfail> -action <open|close>

<source lang="powershell">
param(
$pcs,
$action,
$ports
)
#käime läbi masinate listi
Get-Content $pcs | ForEach-Object {
$computer = $_
#iga masina kohta käime läbi portide nimekirja
Get-Content $ports | ForEach-Object {
$port = $_
#teeme pordid lahti
if(action == "open") {
Invoke-Command {netsh advfirewall firewall add rule name=”Open Port $port” dir=in action=allow protocol=TCP localport=$port} -ComputerName $computer
#või paneme need kinni
} elseif(action == "close") {
Invoke-Command {netsh advfirewall firewall add rule name=”Open Port $port” dir=in action=block protocol=TCP localport=$port} -ComputerName $computer
#või suuname kasutajat õigesti käituma
} else {
Write-Host "Porte kas avatakse (open) või suletakse (close)"
}

}
}
</source>

==Rain Kõrgmaa==
Skript kontrollib windowsi versiooni, kustutab temporary kaustast kõik (võimalikud) failid ning väljastab kasutaja kausta Logi faili.
Skript eeldab, et masinasse on installeeritud Powershell 2.0.

<source lang="Powershell">
$ver = (Get-WmiObject Win32_OperatingSystem).Version
Echo "Sinu masina versioon on:" $ver.tostring()
$count = -1
$Time = Get-Date

if($ver.tostring().Contains("5.")) {
$Dir = Get-Childitem $Env:temp -recurse
$Dir | Remove-Item -force -ErrorAction silentlycontinue
foreach ($_ in $Dir ){
$count = $count +1
$a = $Time.ToShortDateString()+" "+$Time.ToShortTimeString()+ "Kustutasin " +$_ +" faili"
$a >> logi.txt}}

ElseIf($ver.tostring().Contains("6.")) {
$Dir = Get-Childitem $Env:temp -recurse
$Dir | Remove-Item -force -ErrorAction silentlycontinue
foreach ($_ in $Dir ){
$count = $count +1
$a = $Time.ToShortDateString()+" "+$Time.ToShortTimeString()+ " Kustutasin " +$_ + " faili"
$a >> logi.txt}}

Else{
echo "Ei leidnud sobivat windowsi versiooni"}

</source>
==Andres Mill==
#Skript kontrollib, kas mingi rakendus töötab. Näiteks Skype. Kui töötab, siis saadab e-maili, et rakendus töötab selles arvutis.
#Skript käivitab rakenduse töötamise kontrolli skripti iga 60 sekundi tagant.
[[PowerShell: Andres Mill, rakenduse töötamise kontroll]]

==Kalev Jõgi==
Skript küsib tudengi eesnime, perekonnanime, matriklinumbrit ja parooli ning loob Active Directory kasutaja Üldkasutus -> Eco Tudengid organisatsiooniüksusesse, lisab logimisel võrguketaste jne. lisamiseks kasutatava logon.bat faili ning lisab kasutaja gruppi Tudengid

<source lang="Powershell">
#Autor: Kalev Jõgi
#Rühm: A22
#Versioon: 1.0
#Kuupäev: 26.05.2011
#Skript, mis teeb tudengile AD kasutaja ja lisab selle Tudengid gruppi

#Loeme sisse vajalikud andmed
$Firstname = Read-Host "Eesnimi"
$Lastname = Read-Host "Perekonnanimi"
$SCode = Read-Host "Matrikklinumber"
$Password = Read-Host "Parool"

$Name = $Firstname+" "+$Lastname
$username = "t"+$SCode

#Tekitame AD-sse kasutaja
New-ADUser -Path "ou=Eco Tudengid,ou=Üldkasutus,dc=testikas,dc=local" -
GivenName $Firstname -Surname $Lastname -Name $Name -SamAccountName $username
-DisplayName $Name -Enabled $true -PasswordNeverExpires $true
-AccountPassword (ConvertTo-SecureString $Password -AsPlainText -force)
-ScriptPath "login.bat" -UserPrincipalName $username

#Lisame loodud kasutaja AD-s gruppi Tudengid
Add-ADGroupMember -Identity Tudengid -Members $username
</source>

==Kristjan Väljako==

Arvuti usaldusväärsuse index

[[User:KValjako]]

==Kristjan Vask==

Active Directory/lokaalse kasutaja tegemine võttes username/pw sisendid eraldi failidest

[[User:Krvask]]

==Silver Kullarand==
Skript, võtab käsurealt kaasaantud nimega failist parameetrid, millega vormistatab päringu, väljastab soovitul hulgal uusimaid kirjeid otsitavate tüübide kohta ning lisab tulemused manustena mailile ja saadab need etteantud aadressile.

[[PowerShell: Silver Kullarand, newest_events_param.ps1]]

== Risto Siitan ==

[[https://wiki.itcollege.ee/index.php/Skript_otsib_viimase_24_tunni_errorid_ning_saadab_need_meiliga_määratud_aadressile Skript otsib viimase 24 tunni errorid ning saadab need meiliga määratud aadressile]]

==Martin Lehari==
Skript, mille abil saab mitmesse serverisse/arvutisse laiali kopeerida faile/katalooge.
Enne kopeerimist muudetakse sihtkoha ''power plan'' '''High Performance''' peale. Pärast kopeerimist taastatakse jälle endine olukord.

Parameetrid:

'''-hostlist''' - fail, mis sisaldab arvutite/serverite nimesid

'''-hostname''' - üksiku arvuti/serveri nimi

'''-src''' - kopeeritav fail/kataloog

'''-dest''' - sihtkoht

<source lang="Powershell">
#Autor: Martin Lehari
#Rühm: A32
#Versioon: 1.0
#Kuupäev: 02.06.2011
#Skript, mille abil saab mitmesse serverisse/arvutisse laiali kopeerida faile/katalooge.

param (
[string]$hostlist,
[string]$hostname,
[string]$src = $(throw "Source file/dir required."),
[string]$dest = $(throw "Destination dir required.")
)

function SetPowerPlan([string]$preferred_plan, [string]$computer_name) {
$guid = (Get-WmiObject -Class win32_powerplan -Namespace root\cimv2\power -CN $computer_name -Filter "ElementName='$preferred_plan'" -EA silentlyContinue).InstanceID.tostring()
$regex = [regex]"{(.*?)}$"
$newpowerVal = $regex.Match($guid).groups[1].value

Invoke-Command -computer $computer_name -ScriptBlock {param($p1,$p2) powercfg $p1 $p2} -ArgumentList "-S",$newpowerVal
}

function CopyFiles([string]$src, [string]$dest) {
if(!(test-path -path $dest)) {
if((get-item $src).PSIsContainer){
# folder @ destination missing. Creating it!
new-Item $dest -type Directory -force | out-Null
Copy-Item “$src\*” $dest -recurse
}
else {
# file @ dest missing. Creating it!
new-Item $dest -type File -force | out-Null
Copy-Item $src $dest -force
}
}
else {
if((get-item $src).PSIsContainer) {
# coping folder(s)
Copy-Item “$src\*” $dest -recurse
}
else {
# coping file(s)
Copy-Item $src $dest -force
}
}
}

# if we have only one destination...
if($hostname -ne "") {
$computers = $hostname
}
else {
$computers = Get-Content $hostlist
}

foreach ($computer_name in $computers) {
Write-Host "Host: " $computer_name

# get current powerplan
$current_plan = (Get-WmiObject -Class win32_powerplan -Namespace root\cimv2\power -CN $computer_name -Filter "isActive='true'" -EA silentlyContinue).ElementName.tostring()

# set 'High Performance' powerplan
Write-Host "-> Setting powerplan to High performance..."
SetPowerPlan "High Performance" $computer_name

# do the magic!
$dest = "\\"+$computer_name+"\"+$dest.Replace(":","$")
Write-Host "-> Copying files..."
CopyFiles $src $dest

# set computers powerplan back to its original state
Write-Host "-> Setting powerplan to $current_plan..."
SetPowerPlan $current_plan $computer_name

Write-Host "-> Done!"
Write-Host ""
}
</source>

==Juhan Liiva==
Skript leiab kasutaja kodukataloogist 0-suurusega failid, kuvab need ja laseb kustutada, ükshaaval või korraga.

[[User:Jliiva]]

==Urmas Luuk==
[[User:Uluuk#Powershelli kodutöö]]

==Siim Kängsepp==

[[User:skangsep]]

==Henrik Leinola==
Skript, mis eemaldab mp3 failide nimedest alakriipsud ("_") ja muudab kõikide sõnade esimesed tähed suureks.

[[User:Hleinola#Powershell kodutöö]]

Skriptimiskeeled: powershelli kodutööd 2011, kevad, päevaõpe

2011-06-08T19:51:35Z

Hleinola:

User:Hleinola

2011-06-08T19:50:44Z

Hleinola:

Bash quests

2011-06-01T10:18:58Z

Hleinola: /* Quest 37 */

[[Category: Skriptimiskeeled]]
=Sissejuhatus=
Bash quests annab võimaluse teha bash skriptimise kodutööd ka neile, kellel teemat pole.
Skript tuleb panna Tudengi enda wiki lehele. Punktid saab esimene, kes antud questi täies mahus valmis sai. Kui lahendus pole rahuldav saab punktid järgmine OK lahenduse looja.

Kui quest valmis, siis pane link questi juurde (nagu näites)

Queste tuleb pidevalt juurde.

=Quest 0 - Näide=
Teha skript, mis ei tee midagi asjalikku, kuid väljasta sõna BÖÖÖ

Lahendus: [[User:Mernits]]

Quest lukus (tehtud) [[User:Mernits|Mernits]] 10:36, 10 May 2011 (EEST)

=Quest 1 - Leia suured kaustad oma kodukataloogist=

Probleem: Kodukaustast on vaja leida suured kataloogid ja teada, palju nendele ruumu kulub.

Luua skript suuredkaustad.sh

Väljasta kataloogid suuremad kõige alla kujul:

20MB Allalaadimised

100MB Dokumendid

hint: '''du -s * | sort -nr'''

Lahendus : [[User:Kakukk|Katrin Kukk]]

Quest lukus ja tehtud [[User:Mernits|Mernits]] 16:27, 10 May 2011 (EEST)

=Quest 2=
Teha skript, mis taastab poolelijäänud tarkvarapaigalduse (apt-get baasil)

Kui näiteks kasutaja tahab midagi installeerida ja talle öeldakse, et eelmine install jäi pooleli (vool läks ära või mis iganes), siis viidaks installeerimine/konfigureerimine lõpuni.

Bashi lahendus: [[User:Hvosujal]]

Pythoni lahendus: [[User:Hvosujal]]

Quest lukus (tehtud) [[User:Mernits|Mernits]] 13:37, 10 May 2011 (EEST)

=Quest 3=
Teha skript, mis eemaldab vanad kernelid (jätab alles kaks viimast). Tulemuseks on grub2 menüüs näha kahe viimase kerneli ridu ja vanade kernelite arvelt hoitakse kettaruumi kokku.

Lahendus: [[User:otuur]]

Lahendus: [[User:Metamm]] - Parandatud 16.05 14:24
Rpm eemaldust kasutades ubuntu 10.10'ga saab teate "head: unrecognized option '--1'"
peale seda teavitatakse, kasutajat, et skript kustutas kõik kernelid peale kahe viimase, ometi seda ei toimunud. Dpkg eemaldus toimib.
Olle Tuur 13.05.2011 21:38

Parandasin Olle välja toodud vea, nüüd skript kontrollib, kas kasutajal ikka on see paketihaldur olemas, millega skripi käivitab.
Olle skript töötab dpkg paketihalduriga linuxites (N: Ubuntu, Debian) ilusti.
Aga Fedoras, kus on kasutusel rpm paketihaldur ei saa kasutada apt-get remove kernelite eemaldamiseks
Meelis Tamm 16.05.2011 14:30

Quest lukus [[User:Mernits|Mernits]] 10:26, 24 May 2011 (EEST)

=Quest 4=
Teha skript, mis ühendab lahti kõik kettajaod/saalealad etteantud kettalt ja kustutab partitsioonid sellelt kettalt.

Skript peab kasutajat hoiatama, et eemaldatakse see ja too kettajagu.

Skript annab vea, kui lahtiühendamine ei õnnestu.

Skript kontrollib, kas kasutajal on piisavalt õiguseid.

Käivitamine: trash.sh <kettas>

näiteks: trash.sh /dev/sdb

Lahendus: [[User:Uluuk]]

Quest lukus ja tehtud [[User:Mernits|Mernits]] 12:12, 12 May 2011 (EEST)

=Quest 5=
Teha shell funktsioon, mis kontrollib faili olemasolu ja sellele antud õiguseid

Näiteks on fail rwxrwxrwx /var/kala.txt

funktsioon välja kutsudes argumentidega /var/kala.txt 777 tagastatakse 0
Teistel juhtudel:
1 - faili pole
2 - omanikul on valed õigused
3 - grupil on valed õigused
4 - teistel kasutajatel on valed õigused

Lahendus: [[User:Krikko]] - parandatud

Lahendus: [[User:Skangsep]] -Täiendatud. Skript peab tegema exit 0 või 1 ... echoda pole vaja

Python'is lahendus [[User:Uluuk#Quest 5 - Python]]

=Quest 6=
Teha skript save-alias, mis töötab nagu käsk alias, kuid salvestab loodud aliase .bashrc faili ja sourceb .bashrc faili.

Juhtus, et sai valmis:
[[User:Kkalder|Kkalder]]

Quest lukus (tehtud) [[User:Mernits|Mernits]] 12:36, 10 May 2011 (EEST)

=Quest 7=
Looge skript mis lisab kasutaja nimetatud gruppi.

Skript peab kontrollima kas grupp on juba olemas, vajadusel grupi looma.

Skript peab kontrollima mitte ainult lokaalseid gruppe vaid ka globaalseid (LDAP).

Skript peab kontrollima ka seda, kas kasutaja on olemas, vajadusel küsib kas kasutaja luua või mitte.

nt. ./att-to-group.sh kasutajanimi grupinimi

Lahendus: [[User:Mlehari]]

Täiendused tehtud! --[[User:Mlehari|Mlehari]] 10:24, 13 May 2011 (EEST)
Quest lukus [[User:Mernits|Mernits]] 19:30, 16 May 2011 (EEST)

=Quest 8=
Luua skript, mis otsiks etteantud kataloogist ühesuguseid faile. Failide võrdlemine võiks toimuda md5sum tasandil. Loodav skript peaks olema suuteline leidma kõikide ühesuguste failide asukoha ja kuvama ka nende nimed.

Näideks failidel võivad olla erinevad nimed, kuid sama sisu :

fca209683890bb2a02c60535ca82f920 joujou

fca209683890bb2a02c60535ca82f920 tere

fca209683890bb2a02c60535ca82f920 hello

fca209683890bb2a02c60535ca82f920 asd

Lahendus: [[User:Vkolesni]]

Quest tehtud [[User:Mernits|Mernits]] 12:19, 12 May 2011 (EEST)

=Quest 9 Kasutajanime küsimine ja faili salvestamine=
Teha skript, mis küsib kasutajanime ja salvestab selle tekstifaili /var/tmp/username

Peale nime küsimist küsib skript kinnitust, et nimi on õige.

Skript kirjutab eelneva faili üle (kui ei saa üle kirjutada, siis annab vea)

Lahendus: [[User:okilk]]
Quest Lukus [[User:Mernits|Mernits]] 10:31, 17 May 2011 (EEST)

=Quest 10 - Keerukam - Mysql varukoopia tegemise skript (koos installiskriptiga) =

NB: seda skripti võivad teha 3 inimest, kui iga inimene teeb ühe allosa.

Taust: on varundusarvuti ja mysql andmebaasi arvuti. Andmebaasi arvutis töötab mysql server, mille külge otse üle võrgu ühenduda ei saa. Andmevaasist on vaja teha varukoopiaid, mida igapäevalselt kopeeritakse varundusserverisse. Varundusserver algatab kopeerimise ja autentimine käib võtmete abil.

Skript koosneb kolmest osast.

*Skript, mis on mysql serveris ja käivitatakse cron abil. Skript teeb mydqldump -A ... käsuga koopia /var/varukoopiad kausta ja failinimega <DATE>-mysql-<masinanimi>.sql.gz - seega sisaldab kuupäeva ja masina nime, ning pakitakse kokku.

Bash lahendus: [[User:kjogi#Quest10.1]]

*Teine skript kopeerib andmebaasiserverist varukoopiad varundusserverisse ja kustutab andmebaasiserverist varukoopiad, mis on vanemad, kui üks kuu

Python lahendus: [[User:kjogi#Quest10.2]]

*Kolmas skript on installatsiooniskript. See küsib andmebaasiserveri nime/parooli ja mysql root parooli.
Skript kopeerib esimese skripti andmebaasiserverisse ja seadistab sealse cron-i seda regulaarselt käivitama. Skript seadistab varundusserveri cron-i regulaarselt käivitama kopeerimise skripti.

=Quest 11 - Skript paki installi kontrolliks=
Teha skript, mis kontrollib, kas etteantud tarkvarapakk on installeeritud. Kui on installeeritud, siis tagastab 0 ja vastasel juhul 1.

is_installed.sh <pakinimi>

[[User:ikrustok]]

Väikest mööndustega on skript OK (Kui keel on Eesti, siis skript ei toimi. Skripti algusesse export LC_ALL=C oleks hea)

Quest tehtud [[User:Mernits|Mernits]] 13:01, 12 May 2011 (EEST)

=Quest 12 kasutaja/grupi olemasolu testimine=

Teha skriptid is_user.sh is_group.sh mis kontrollivad, kas kasutaja või grupp eksisteerib.

is_user.sh <username>

is_group.sh <username>

Skriptid tagastavad 0, kui kasutaja/grupp on olemas ja 1 kui kasutajat/gruppi pole.

Lahendus : [[User:Vvinogra]]

Quest tehtud [[User:Mernits|Mernits]] 12:29, 12 May 2011 (EEST)

Bash skript, mis vähendab foto lahutus: [https://wiki.itcollege.ee/index.php/User:Vvinogra#Skript.2C_mis_v.C3.A4hendab_foto_lahutus Skript, mis vähendab foto lahutus]

Python skript (bash quest 12 ülesanne): [[User:Vvinogra#Python_kasutaja_olemasolu_testimine_skript]]

=Quest 13 - kas kasutaja kuulub gruppi?=

Teha skript user_in_group.sh mis kontrollib, kas etteantud kasutaja kuulub etteantud gruppi.

Tagastab 0, kui kuulub ja 1 kui ei kuulu.

user_in_group.sh <kasutaja> <grupp>

Lahendus: [[User:Amill]] - lahendus OK [[User:Mernits|Mernits]] 12:55, 12 May 2011 (EEST)

Lahendus: [[User:Skullara]] - lahendus OK - kuna leitud teisest lahendusest viga, siis lähevad punktid kirja... [[User:Mernits|Mernits]] 22:34, 12 May 2011 (EEST)

Quest lukus [[User:Mernits|Mernits]] 12:55, 12 May 2011 (EEST)

=Quest 14 IP aliase loomine ja salvestamine=

Teha skript, mis loob ubuntu serverile IP aliase ja salvestab selle.

add_ip.sh <IP aadress>

Skript teeb võrgule restardi ja kontrollib, kas IP vastab. (enne võiks pingida, et ip ei vastaks)

Lahendus: [[User:trohumet]] - Siin luuakse alati alias eth0:0, samas võib see juba olemas olla ja seda tuleks kontrollida ja seejärel luua eth0:1 jne. [[User:Mernits|Mernits]] 19:32, 16 May 2011 (EEST)

Nüüd oskab see skript ka teistele liidestele Aliast anda.

Lahendus: [[User:Rkorgmaa]]

Parandused sisestatud 26.05.2011

=Quest 15 - IP aliase kontroll =

Skript kontrollib, kas Ubuntu serveris on seadistatud etteantud IP alias

is_ip_alias.sh <IP aadress>

return 0 - alias olemas

return 1 - aliast pole

Lahendus: [[User:rsepp]]

=Quest 16 - Osta elevant ära=
Teha programm, mis käivitamisel paku kasutajale "osta elevant ära" ja ootaks kasutaja sisendit. Ükskõik mida kasutaja sisestab ütleb skript "Seda ütlevad kõik, aga osta elevant ära" ja nii lõpmatuseni.

Lahendus: [[User:skullara]]

Quest tehtud [[User:Mernits|Mernits]] 14:21, 12 May 2011 (EEST)

=Quest 17 - Kas serveris on piisavalt mälu=
Teha skript, mis kontrollib, kas servers on piisavalt operatiivmälu (näiteks mõne teenuse installi skript võiks seda teha)

./ram.sh <mälu MB>

./ram.sh 512

Väljund:
exit 0 - mälu on piisavalt

exit 1 - mälu pole piisavalt

Lahendus : [[User:ttoppi]] | Lahendus OK, quest lukus [[User:Mernits|Mernits]] 13:17, 19 May 2011 (EEST)

=Quest 18=

Tuleb tekitada skript, mis suunaks kasutaja viimati kasutatud failid nende viimase muutmise kuupäeva järgi kaustadesse.

Skript peab sisaldama: viite erinevat kausta.

Skript peab tegema seda toimingut iga 2 päeva tagant ja teavitama kasutajat sellest, et failid on ümber jagatud.

Skript peab peale failide sorteerimist ütlema mitu faili mingisse kausta tõsteti.

Kaustadesse tuleb failid sorteerida järgmiselt: esimesse kausta peavad minema failid mida on viimati muudetud vähem kui 2 päeva tagasi, teisse kausta failid mis on muudetud 2-7 päeva tagasi, kolmandasse failid mis on 8-14 päeva tagasi muudetud, neljandasse kausta 15-29 päeva tagasi muudetud failid ja viiendaks 30 päeva ning vanemad failid mis on muudetud.

Lahendus: [[User:Iambos]]

Quest lukus [[User:Mernits|Mernits]] 10:48, 24 May 2011 (EEST)

=Quest 19=

Kasutaja saab määrata mis faile otsitakse (.torrent; .avi või mkv vmt.) kogusüsteemist. Kui failid on leitud peab skript kasutajale teada andma millised on failide nime.

Skript peab leidma kõik kasutaja poolt sisestatud lõpuga failid.

Skript peab failid ära nummerdama ja kasutajale nende nimesid näitama.

Skript peab võimaldama kasutajal valida numbritega failid mida soovib kustutada (Näiteks: 1-3, 9, 12, 19-20). Peab toimima valiku võimalus näiteks: 15-19

Skript peab kontrollima kas kasutajal on õigused faile kustutada. Kui õigused puuduvad tuleb anda vea teade.

Skript peab peale kasutaja poolt valitud numbreid väljastama uuesti failide nimed mis on valitud ja küsima kas valitud failid on õiged. (kui on õiged peab sisestama 0 , kui valed siis 1)

Skript peab peale failide kustutamist väljastama teate, et failid on kustutatud.

Lahendus: [[User:Msuursal]]

Quest lukus [[User:Mernits|Mernits]] 10:49, 24 May 2011 (EEST)

=Quest 20=
Teha skript, mis käib läbi PATH muutuja sisu ja leiab sealt üles kataloogid, mida pole olemas.
Leitud olematud kataloogid kuvatakse kasutajale.

Skript lisab uue PATH muutuja kasutaja profile faili

Lahendus: [[User:krvask]]

Quest lukus, tehtud [[User:Mernits|Mernits]] 09:47, 24 May 2011 (EEST)

=Quest 21=
Teha skript, mis lisab kataloogi PATH muutujasse (ja sinna faili, kus kasutaja oma PATH muutujat hoiab)

./add_path.sh <KATALOOG>

Lahendus: [[User:Akannus]] Töötas Mac OS keskonnas. - See töötab siiski vaid root kasutaja alt (tavakasutaja ei kirjuta /etc/ kataloogi. Otsi, kus hoitakse tavakasutaja PATH väärtust, mida ta ise muuta saab. [[User:Mernits|Mernits]] 09:22, 17 May 2011 (EEST)


Questile võib teha ka linux lahenduse


=Quest 22 - kontrollib, kas lokaalne kasutaja on lukus=

./user_is_locked.sh <loginname>

exit 0 - kasutaja on lukus

exit 1 - kasutaja pole lukus

exit 2 - kasutajat pole üldse

[[User:skangsep]]

Quest lukus [[User:Mernits|Mernits]] 09:46, 24 May 2011 (EEST)

=Quest 23=

Luua skript, mis otsib logifailist välja kasutajate ebaõnnestunud sisselogimised ja kordade arvu viimase kolme päeva jooksul, järjestades kasutajad alustades kõige rohkem ebaõnnestunud sisselogimisi teinud kasutajast ja suunab need faili vead.txt.
vihjeks: faillog näitab ebaõnnestunud sisselogimisi, on käivitav käsurealt

[[User:Jliiva]]

Quest lukus (kuigi see sudo puhul ei toimi) [[User:Mernits|Mernits]] 10:28, 24 May 2011 (EEST)

=Quest 24=
Teha skript, mis kontrollib, kas etteantud string on palindroom või mitte.
http://et.wikipedia.org/wiki/Palindroom

./is_palindroom.sh kaak
Tagastab 0

./is_palindroom.sh kala
Tagastab 1

Quest lukus (Tehakse tunnis) [[User:Mernits|Mernits]] 10:17, 24 May 2011 (EEST)

=Quest 25=

Skript, mis leiab lehelt google anatytics andmed ja väljastab need.

./is_google_analytics.sh veebileht

exit 0 - olemas

exit 1 - pole

Lisaks peab skript kasutajale tevitama ID

=Quest 26=

Kirjutada skript, mis otsib üles kõik .html failid ning kirjutab iga faili html dokumendi pealkirja failid.html faili. Loodud html fail (failid.html) peab sisaldama .html faile linkidena, ehk sinna klikates suunab asukohta, kus fail asub.

[[user:ulaaneot]] - Siin kirjutatakse esimene rida. [[User:Mernits|Mernits]] 10:15, 27 May 2011 (EEST)
NB keegi võiks seda täiendada. [[User:Ulaaneot|Ulaaneot]] 16:55, 27 May 2011 (EEST) Täiendatud ja muudetud vastavalt kirjeldusele

[[User:Metamm]] - Pythonis

=Quest 27=

Kirjutada skript, mis kopeerib data CD-lt pilditõmmise (image) kõvakettale ning kirjutab selle
sama pildi uuele plaadile. Pärast kirjutasmit küsib, kas soovib pildi (image) kõvakettalt kustutada.
NB! Data plaadilt tehtud image peab olemuselt olema MD5 räsi. ( md5sum < > )

[[User:Tsalumet]]

Quest tehtud [[User:Mernits|Mernits]] 12:18, 26 May 2011 (EEST)

=Quest - Python arvestus (saata ära 24.mai enne 12:30)=

Leida etteantud failist kõik palindroomid ja kirjutada tulemus uude faili.
Failinimed antakse ette käsurealt.

Seega väljundfailis on ainult palindroomid või fail on tühi.

./pal.py sisendfail väljundfail

Quest lukus [[User:Mernits|Mernits]] 13:25, 24 May 2011 (EEST)

=Quest 28=

Kirjutada skript, mis eemaldab Opera veebibrauseri bookmarkidest kirjeldused (descriptionid).
Skripti jaoks peaks olemas olema Opera veebibrauser ja failid asuvad ~/.opera

[[user:Eumal]]

Quest lukus [[User:Mernits|Mernits]] 15:37, 30 May 2011 (EEST)

=Quest 29=

Teha skript, mis pakub kasutajale välja erinevate promptide valikuid a'la kombineeri ise endale bash prompt.


=Quest 30 - Python arvestustöö - Lahendused saata laurile ja margusele 27.mai hiljemalt kell 11:30!=

Luua isikukoodi parser ja õigsuse kontroll. Sisendiks fail kus igal
real on isikukood,
mis võib olla õige või vale. Väljundiks on fail kus on õiged
isikukoodid kus kontrollsumma klapib
ning kuupäev on korrektne (aastas 12 kuud ning iga kuu päevade arv sobiv).

Sisendfail enesekontrolliks: http://lauri.vosandi.eu/python/isikukoodid.txt

NB! Kuupäeva õigsuse kontrollimiseks kasutage datetime.strptime funktsiooni ja uuesti vormindamiseks datetime.strftime funktsiooni

Eeldatav väljund:

<pre>
lauri@lauri-t410:~/isikukood$ python isikukoodid.py isikukoodid.txt
61206116170 - 11.06.2012 - naine
40511309870 - 30.11.1905 - naine
41407165380 - 16.07.1914 - naine
63511033026 - 03.11.2035 - naine
44408261855 - 26.08.1944 - naine
36001157802 - 15.01.1960 - mees
68905216902 - 21.05.2089 - naine
44702094652 - 09.02.1947 - naine
63812277449 - 27.12.2038 - naine
41207203213 - 20.07.1912 - naine
68708158219 - 15.08.2087 - naine
59803250119 - 25.03.2098 - mees
53912086035 - 08.12.2039 - mees
51211188093 - 18.11.2012 - mees
43805027379 - 02.05.1938 - naine
63206180726 - 18.06.2032 - naine
51501095401 - 09.01.2015 - mees
41609258538 - 25.09.1916 - naine
60306250756 - 25.06.2003 - naine
61901193165 - 19.01.2019 - naine
43107188423 - 18.07.1931 - naine
48210160415 - 16.10.1982 - naine
48910144868 - 14.10.1989 - naine
37605156061 - 15.05.1976 - mees
30907090640 - 09.07.1909 - mees
53907089733 - 08.07.2039 - mees
</pre>

Programm peab sisaldama infot skripti autori kohta ning valede
parameetrite korral
väljastama programmi kasutusinfo

=Quest 31=

Teha skript mis ärataks hommikul (öösel) unise tudengi. Skripti tuleks lisada ka mingi phrase mille tudeng peab kirjutaama, et alarm kinni jääks.


[[User:Tsalumet]]

=Quest 32=

Luua skript mis automaatselt installeerib uued ATI graafika driverid.


=Quest 33=

Luua skript mis automaatselt installeerib uued Geforce graafika driverid.


=Quest 34 - Viimane arvestus=
Saata 16:30 seisuga toimiv kood aadressile lauri.vosandi@gmail.com

Lugeda sisendfailist tabulaatoritega ("\t") eraldatud read kus tulpades vastavalt: ainekood, aine nimi, õppejõud, hindamisviis, hinne, EAP

Sisendfail: http://lauri.vosandi.eu/python/ainepunktid.txt

Programm peab lugema käsurealt sisend ja väljundfailide nimed:

<pre>lauri@lauri-t410:~/midagi$ python lahendus.py
Usage: lahendus.py <input_file> <output_file>
</pre>

Väljundfaili peaks kirjutama kaalutud keskhinde ning Euroopa ainepunktid kokku:

<pre>lauri@lauri-t410:~/midagi$ python lahendus.py ainepunktid.txt out.txt
lauri@lauri-t410:~/midagi$ cat out.txt
Kokku EAP: 88.0
Kaalutud keskhinne: 2.15</pre>

=Quest 35=
Teha skript, mis paneb ubuntu serveri kasutajale e-posti saatma, kui tuleb uusi uuendusi.


* Paigaldab [[apticron]] tarkvara.
* Muudab selle konfiguratsioonis määratavat e-posti aadressi vastavalt kasutajalt küsitavale aadressile.

=Quest 36=
Luua skript, mis seadistab võtmete baasil autentimise ssh abil.

Kasutaja kirjutab:

./ssh-setup.sh kasutajanimi@server

Skript kontrollib, kas kasutajal on olemas privaatvõti (kui pole, siis genereerib)

Skript logib ssh abil serverisse ja kopeerib avaliku võtme .ssh kataloogi

Teatab, et edaspidi saab serverisse ühenduda võtmetega autentimisega.

Skripti tooriku leiab skriptimise loengus (sealne skript teeb pea kõik ära, kuid küsib kaks korda parooli. Piisaks ühest korrast)

Valmis skript asub [[User:rkorgmaa]]

=Quest 37=

Luua skript, mis leiab etteantud kataloogist kõik katkised nimelingid


[[User:Hleinola]]

=Quest 38=

Luua skript, mis muuda etteantud faili muutmisaega


Skript saab käsurealt argumendina failinime.

*Kontrollib, kas fail on olemas, kui pole - exit 1
*Küsib kasutajalt aastat, kuupäeva, kellaaega
*Seab failile muutmiskuupäeva

[[User:Ikrustok]]

=Quest 39=

Luua skript, mis leiab kasutaja kodukaustast kõik failid ja kataloogid, mille omanikuks ta ise pole ja väljastab nende täispikad nimed


=Quest 40=
=Quest 41=
=Quest 42=
=Quest 43=

User:Hleinola

2011-06-01T10:18:23Z

Hleinola: Created page with '== Quest lahendus 37 - Skript, mis leiab etteantud kataloogist kõik katkised nimelingid [Bash] == <source lang="bash"> #!/bin/bash #Autor: Henrik Leinola #Versioon: 0.1 OODATUD…'

Manpremo

2011-05-03T06:27:09Z

Hleinola: /* Manpremo veebiliidese ülevaade */

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, kuhu on paigaldatud Manpremo server.

*'''Klient''' on arvuti, kuhu on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

= '''Manpremo serverite paigaldamine''' =

Järgnevalt käin läbi erinevate Manpremo serverite paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

== '''Manpremo Development Serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

== '''Production serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

= '''Manpremo klientide paigaldamine ja registreerimine''' =

Järgnevalt käin läbi Manpremo klientide paigladamise ja registreerimise. Hetkel on võimalik kasutada Linuxi ja Windowsi operatsioonisüsteeme klientideks.

== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ==

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ==

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

== '''Linuxi kliendi registreerimine''' ==

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

''' Registreerimine '''

Registreerimise võtme saamise kohta lugeda [[Manpremo#Registration Keys|Registration Keys]] lõigu alt.

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMISE_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMISE_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

Selleks, et Manpremo daemon hakkaks tööle operatsioonisüsteemi alglaadimisel, tuleb lisada antud käsklus alglaadimisel käimaminevasse skripti. Selleks:

cd /etc/init.d
sudo touch manpremo
sudo nano manpremo

Avanenud aknasse kirjutada:

sudo manpremo-daemon

= '''Manpremo veebiliidese ülevaade''' =

== '''Sisselogimine ja kasutajate registreerimine''' ==
[[File:Manpremo_login.png|thumb|Manpremo sisselogimise aken]]
Kui kasutaja külastab Manpremo serveri veebiliidese lehte esimene kord, avaneb talle selline [[Media:Manpremo_login.png|vaade]]. Seal on võimalik kasutajal valida keel, mida ta soovib kasutada. Käesoleva ülevaate keelevalik on inglise keel. Veel on võimalik lugeda Manpremo kohta täpsemalt vajutades vastavale lingile. Client software taga peitub nimekiri kliendile vajaminevatest paketidest või tarkvarast.

'''Kasutaja registreerimine'''

Kasutaja registreerimiseks tuleb vajutada lingile Register. Siis avaneb kasutajale järgmine [[Media:Manpremo_registration.png|leht]]. Korrektsete andmete sisestamisel ja nupule Register vajutades, küsitakse kasutaja kohta veel täpsustavaid andmeid, millede kinnitamisel kuvatakse Manpremo serveri peavaadet või siis -menüüd.

== '''Peavaade''' ==

Peamenüü näeb välja [[Media:Manpremo_main.png|selline]]. Kõik menüü osad on ringi liigutatavad, suletavad ja minimiseeritavad. Kinni pandud osa võib hiljem ka tagasi panna kasutades Add portlet linki.

== '''Organizational Units''' ==

Selle funktsiooni eesmärk on pakkuda administraatoritele võimalus jagada oma kasutatavad seadmed ning kliendid organisatsiooniliselt ära. Iga Organizational Uniti (OU) kohta on võimalik lisada nimi, kirjeldus ja vajaduse korral ülem (parent) OU. Organizational Uniti vaade näeb välja [[Media:Manpremo_OU.png|selline]] ja lisamise vaade [[Media:Manpremo_ou_create.png|selline]].

Hiljem on võimalik iga OU infot ja ülem OU-d muuta. Lisaks on olemas logi, kus on näha kõik sündmused, mis on vastava OU-ga seotud. Igale OU-le on võimalik lisada kasutajaid ja nendele jagada õiguseid rollipõhiselt. Kokku on 5 erinevat rolli. Rollide lisamise vaade näeb välja [[Media:Manpremo_ou_roles.png|selline]] ja logide vaade [[Media:Manpremo_ou_logs.png|selline]].

== '''Registration Keys''' ==

Registreerimisvõtmed on loodud selleks, et lubatud arvutid saaksid loodud Manpremo serveriga liituda. Registreerimisvõtmete loomise puhul tuleb lisada võtmele nimi, kirjeldus ei ole kohustuslik. Veel tuleb märkida ära võtme kehtivusaja alg- ja lõppkuupäev ning kasutajate arv, kes antud võtmega saab end registreerida. Võimalik on ka lisada OU, kuhu selle võtmega ennast registreeritakse, kuid selle lisamine ei ole kohustuslik. Hiljem tuleb lihtsalt käsitsi kliendid ringi paigutada. Võtmete loomise vaade näev välja [[Media:Manpremo_key_create.png|selline]].

== '''Clients''' ==

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

Manpremo

2011-05-03T06:26:23Z

Hleinola: /* Linuxi kliendi registreerimine */

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, kuhu on paigaldatud Manpremo server.

*'''Klient''' on arvuti, kuhu on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

= '''Manpremo serverite paigaldamine''' =

Järgnevalt käin läbi erinevate Manpremo serverite paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

== '''Manpremo Development Serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

== '''Production serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

= '''Manpremo klientide paigaldamine ja registreerimine''' =

Järgnevalt käin läbi Manpremo klientide paigladamise ja registreerimise. Hetkel on võimalik kasutada Linuxi ja Windowsi operatsioonisüsteeme klientideks.

== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ==

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ==

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

== '''Linuxi kliendi registreerimine''' ==

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

''' Registreerimine '''

Registreerimise võtme saamise kohta lugeda [[Manpremo#Registration Keys|Registration Keys]] lõigu alt.

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMISE_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMISE_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

Selleks, et Manpremo daemon hakkaks tööle operatsioonisüsteemi alglaadimisel, tuleb lisada antud käsklus alglaadimisel käimaminevasse skripti. Selleks:

cd /etc/init.d
sudo touch manpremo
sudo nano manpremo

Avanenud aknasse kirjutada:

sudo manpremo-daemon

= '''Manpremo veebiliidese ülevaade''' =

== '''Sisselogimine ja kasutajate registreerimine''' ==
[[File:Manpremo_login.png|thumb|Manpremo sisselogimise aken]]
Kui kasutaja külastab Manpremo serveri veebiliidese lehte esimene kord, avaneb talle selline [[Media:Manpremo_login.png|vaade]]. Seal on võimalik kasutajal valida keel, mida ta soovib kasutada. Käesoleva ülevaate keelevalik on inglise keel. Veel on võimalik lugeda Manpremo kohta täpsemalt vajutades vastavale lingile. Client software taga peitub nimekiri kliendile vajaminevatest paketidest või tarkvarast.

'''Kasutaja registreerimine'''

Kasutaja registreerimiseks tuleb vajutada lingile Register. Siis avaneb kasutajale järgmine [[Media:Manpremo_registration.png|leht]]. Korrektsete andmete sisestamisel ja nupule Register vajutades, küsitakse kasutaja kohta veel täpsustavaid andmeid, millede kinnitamisel kuvatakse Manpremo serveri peavaadet või siis -menüüd.

== '''Peavaade''' ==

Peamenüü näeb välja [[Media:Manpremo_main.png|selline]]. Kõik menüü osad on ringi liigutatavad, suletavad ja minimiseeritavad. Kinni pandud osa võib hiljem ka tagasi panna kasutades Add portlet linki.

== '''Organizational Units''' ==

Selle funktsiooni eesmärk on pakkuda administraatoritele võimalus jagada oma kasutatavad seadmed ning kliendid organisatsiooniliselt ära. Iga Organizational Uniti (OU) kohta on võimalik lisada nimi, kirjeldus ja vajaduse korral ülem (parent) OU. Organizational Uniti vaade näeb välja [[Media:Manpremo_OU.png|selline]] ja lisamise vaade [[Media:Manpremo_ou_create.png|selline]].

Hiljem on võimalik iga OU infot ja ülem OU-d muuta. Lisaks on olemas logi, kus on näha kõik sündmused, mis on vastava OU-ga seotud. Igale OU-le on võimalik lisada kasutajaid ja nendele jagada õiguseid rollipõhiselt. Kokku on 5 erinevat rolli. Rollide lisamise vaade näeb välja [[Media:Manpremo_ou_roles.png|selline]] ja logide vaade [[Media:Manpremo_ou_logs.png|selline]].

== '''Registration Keys''' ==

Registreerimisvõtmed on loodud selleks, et lubatud arvutid saaksid loodud Manpremo serveriga liituda. Registreerimisvõtmete loomise puhul tuleb lisada võtmele nimi, kirjeldus ei ole kohustuslik. Veel tuleb märkida ära võtme kehtivusaja alg- ja lõppkuupäev ning kasutajate arv, kes antud võtmega saab end registreerida. Võimalik on ka lisada OU, kuhu selle võtmega ennast registreeritakse, kuid selle lisamine ei ole kohustuslik. Hiljem tuleb lihtsalt käsitsi kliendid ringi paigutada. Võtmete loomise vaade näev välja [[Media:Manpremo_key_create.png|selline]].

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

Manpremo

2011-05-03T06:25:27Z

Hleinola: /* Linuxi kliendi registreerimine */

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, kuhu on paigaldatud Manpremo server.

*'''Klient''' on arvuti, kuhu on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

= '''Manpremo serverite paigaldamine''' =

Järgnevalt käin läbi erinevate Manpremo serverite paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

== '''Manpremo Development Serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

== '''Production serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

= '''Manpremo klientide paigaldamine ja registreerimine''' =

Järgnevalt käin läbi Manpremo klientide paigladamise ja registreerimise. Hetkel on võimalik kasutada Linuxi ja Windowsi operatsioonisüsteeme klientideks.

== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ==

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ==

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

== '''Linuxi kliendi registreerimine''' ==

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

''' Registreerimine '''

Registreerimise võtme saamise kohta lugeda [[Manpremo#Registration Keys|siit]].

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMISE_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMISE_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

Selleks, et Manpremo daemon hakkaks tööle operatsioonisüsteemi alglaadimisel, tuleb lisada antud käsklus alglaadimisel käimaminevasse skripti. Selleks:

cd /etc/init.d
sudo touch manpremo
sudo nano manpremo

Avanenud aknasse kirjutada:

sudo manpremo-daemon

= '''Manpremo veebiliidese ülevaade''' =

== '''Sisselogimine ja kasutajate registreerimine''' ==
[[File:Manpremo_login.png|thumb|Manpremo sisselogimise aken]]
Kui kasutaja külastab Manpremo serveri veebiliidese lehte esimene kord, avaneb talle selline [[Media:Manpremo_login.png|vaade]]. Seal on võimalik kasutajal valida keel, mida ta soovib kasutada. Käesoleva ülevaate keelevalik on inglise keel. Veel on võimalik lugeda Manpremo kohta täpsemalt vajutades vastavale lingile. Client software taga peitub nimekiri kliendile vajaminevatest paketidest või tarkvarast.

'''Kasutaja registreerimine'''

Kasutaja registreerimiseks tuleb vajutada lingile Register. Siis avaneb kasutajale järgmine [[Media:Manpremo_registration.png|leht]]. Korrektsete andmete sisestamisel ja nupule Register vajutades, küsitakse kasutaja kohta veel täpsustavaid andmeid, millede kinnitamisel kuvatakse Manpremo serveri peavaadet või siis -menüüd.

== '''Peavaade''' ==

Peamenüü näeb välja [[Media:Manpremo_main.png|selline]]. Kõik menüü osad on ringi liigutatavad, suletavad ja minimiseeritavad. Kinni pandud osa võib hiljem ka tagasi panna kasutades Add portlet linki.

== '''Organizational Units''' ==

Selle funktsiooni eesmärk on pakkuda administraatoritele võimalus jagada oma kasutatavad seadmed ning kliendid organisatsiooniliselt ära. Iga Organizational Uniti (OU) kohta on võimalik lisada nimi, kirjeldus ja vajaduse korral ülem (parent) OU. Organizational Uniti vaade näeb välja [[Media:Manpremo_OU.png|selline]] ja lisamise vaade [[Media:Manpremo_ou_create.png|selline]].

Hiljem on võimalik iga OU infot ja ülem OU-d muuta. Lisaks on olemas logi, kus on näha kõik sündmused, mis on vastava OU-ga seotud. Igale OU-le on võimalik lisada kasutajaid ja nendele jagada õiguseid rollipõhiselt. Kokku on 5 erinevat rolli. Rollide lisamise vaade näeb välja [[Media:Manpremo_ou_roles.png|selline]] ja logide vaade [[Media:Manpremo_ou_logs.png|selline]].

== '''Registration Keys''' ==

Registreerimisvõtmed on loodud selleks, et lubatud arvutid saaksid loodud Manpremo serveriga liituda. Registreerimisvõtmete loomise puhul tuleb lisada võtmele nimi, kirjeldus ei ole kohustuslik. Veel tuleb märkida ära võtme kehtivusaja alg- ja lõppkuupäev ning kasutajate arv, kes antud võtmega saab end registreerida. Võimalik on ka lisada OU, kuhu selle võtmega ennast registreeritakse, kuid selle lisamine ei ole kohustuslik. Hiljem tuleb lihtsalt käsitsi kliendid ringi paigutada. Võtmete loomise vaade näev välja [[Media:Manpremo_key_create.png|selline]].

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

Manpremo

2011-05-03T06:23:34Z

Hleinola: /* Registration Keys */

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, kuhu on paigaldatud Manpremo server.

*'''Klient''' on arvuti, kuhu on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

= '''Manpremo serverite paigaldamine''' =

Järgnevalt käin läbi erinevate Manpremo serverite paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

== '''Manpremo Development Serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

== '''Production serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

= '''Manpremo klientide paigaldamine ja registreerimine''' =

Järgnevalt käin läbi Manpremo klientide paigladamise ja registreerimise. Hetkel on võimalik kasutada Linuxi ja Windowsi operatsioonisüsteeme klientideks.

== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ==

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ==

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

== '''Linuxi kliendi registreerimine''' ==

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

''' Registreerimine '''

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

Selleks, et Manpremo daemon hakkaks tööle operatsioonisüsteemi alglaadimisel, tuleb lisada antud käsklus alglaadimisel käimaminevasse skripti. Selleks:

cd /etc/init.d
sudo touch manpremo
sudo nano manpremo

Avanenud aknasse kirjutada:

sudo manpremo-daemon

= '''Manpremo veebiliidese ülevaade''' =

== '''Sisselogimine ja kasutajate registreerimine''' ==
[[File:Manpremo_login.png|thumb|Manpremo sisselogimise aken]]
Kui kasutaja külastab Manpremo serveri veebiliidese lehte esimene kord, avaneb talle selline [[Media:Manpremo_login.png|vaade]]. Seal on võimalik kasutajal valida keel, mida ta soovib kasutada. Käesoleva ülevaate keelevalik on inglise keel. Veel on võimalik lugeda Manpremo kohta täpsemalt vajutades vastavale lingile. Client software taga peitub nimekiri kliendile vajaminevatest paketidest või tarkvarast.

'''Kasutaja registreerimine'''

Kasutaja registreerimiseks tuleb vajutada lingile Register. Siis avaneb kasutajale järgmine [[Media:Manpremo_registration.png|leht]]. Korrektsete andmete sisestamisel ja nupule Register vajutades, küsitakse kasutaja kohta veel täpsustavaid andmeid, millede kinnitamisel kuvatakse Manpremo serveri peavaadet või siis -menüüd.

== '''Peavaade''' ==

Peamenüü näeb välja [[Media:Manpremo_main.png|selline]]. Kõik menüü osad on ringi liigutatavad, suletavad ja minimiseeritavad. Kinni pandud osa võib hiljem ka tagasi panna kasutades Add portlet linki.

== '''Organizational Units''' ==

Selle funktsiooni eesmärk on pakkuda administraatoritele võimalus jagada oma kasutatavad seadmed ning kliendid organisatsiooniliselt ära. Iga Organizational Uniti (OU) kohta on võimalik lisada nimi, kirjeldus ja vajaduse korral ülem (parent) OU. Organizational Uniti vaade näeb välja [[Media:Manpremo_OU.png|selline]] ja lisamise vaade [[Media:Manpremo_ou_create.png|selline]].

Hiljem on võimalik iga OU infot ja ülem OU-d muuta. Lisaks on olemas logi, kus on näha kõik sündmused, mis on vastava OU-ga seotud. Igale OU-le on võimalik lisada kasutajaid ja nendele jagada õiguseid rollipõhiselt. Kokku on 5 erinevat rolli. Rollide lisamise vaade näeb välja [[Media:Manpremo_ou_roles.png|selline]] ja logide vaade [[Media:Manpremo_ou_logs.png|selline]].

== '''Registration Keys''' ==

Registreerimisvõtmed on loodud selleks, et lubatud arvutid saaksid loodud Manpremo serveriga liituda. Registreerimisvõtmete loomise puhul tuleb lisada võtmele nimi, kirjeldus ei ole kohustuslik. Veel tuleb märkida ära võtme kehtivusaja alg- ja lõppkuupäev ning kasutajate arv, kes antud võtmega saab end registreerida. Võimalik on ka lisada OU, kuhu selle võtmega ennast registreeritakse, kuid selle lisamine ei ole kohustuslik. Hiljem tuleb lihtsalt käsitsi kliendid ringi paigutada. Võtmete loomise vaade näev välja [[Media:Manpremo_key_create.png|selline]].

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

File:Manpremo key create.png

2011-05-03T06:23:25Z

Hleinola:

File:Manpremo ou logs.png

2011-05-03T06:14:06Z

Hleinola:

Manpremo

2011-05-03T06:13:58Z

Hleinola: /* Manpremo veebiliidese ülevaade */

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, kuhu on paigaldatud Manpremo server.

*'''Klient''' on arvuti, kuhu on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

= '''Manpremo serverite paigaldamine''' =

Järgnevalt käin läbi erinevate Manpremo serverite paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

== '''Manpremo Development Serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

== '''Production serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

= '''Manpremo klientide paigaldamine ja registreerimine''' =

Järgnevalt käin läbi Manpremo klientide paigladamise ja registreerimise. Hetkel on võimalik kasutada Linuxi ja Windowsi operatsioonisüsteeme klientideks.

== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ==

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ==

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

== '''Linuxi kliendi registreerimine''' ==

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

''' Registreerimine '''

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

Selleks, et Manpremo daemon hakkaks tööle operatsioonisüsteemi alglaadimisel, tuleb lisada antud käsklus alglaadimisel käimaminevasse skripti. Selleks:

cd /etc/init.d
sudo touch manpremo
sudo nano manpremo

Avanenud aknasse kirjutada:

sudo manpremo-daemon

= '''Manpremo veebiliidese ülevaade''' =

== '''Sisselogimine ja kasutajate registreerimine''' ==
[[File:Manpremo_login.png|thumb|Manpremo sisselogimise aken]]
Kui kasutaja külastab Manpremo serveri veebiliidese lehte esimene kord, avaneb talle selline [[Media:Manpremo_login.png|vaade]]. Seal on võimalik kasutajal valida keel, mida ta soovib kasutada. Käesoleva ülevaate keelevalik on inglise keel. Veel on võimalik lugeda Manpremo kohta täpsemalt vajutades vastavale lingile. Client software taga peitub nimekiri kliendile vajaminevatest paketidest või tarkvarast.

'''Kasutaja registreerimine'''

Kasutaja registreerimiseks tuleb vajutada lingile Register. Siis avaneb kasutajale järgmine [[Media:Manpremo_registration.png|leht]]. Korrektsete andmete sisestamisel ja nupule Register vajutades, küsitakse kasutaja kohta veel täpsustavaid andmeid, millede kinnitamisel kuvatakse Manpremo serveri peavaadet või siis -menüüd.

== '''Peavaade''' ==

Peamenüü näeb välja [[Media:Manpremo_main.png|selline]]. Kõik menüü osad on ringi liigutatavad, suletavad ja minimiseeritavad. Kinni pandud osa võib hiljem ka tagasi panna kasutades Add portlet linki.

== '''Organizational Units''' ==

Selle funktsiooni eesmärk on pakkuda administraatoritele võimalus jagada oma kasutatavad seadmed ning kliendid organisatsiooniliselt ära. Iga Organizational Uniti (OU) kohta on võimalik lisada nimi, kirjeldus ja vajaduse korral ülem (parent) OU. Organizational Uniti vaade näeb välja [[Media:Manpremo_OU.png|selline]] ja lisamise vaade [[Media:Manpremo_ou_create.png|selline]].

Hiljem on võimalik iga OU infot ja ülem OU-d muuta. Lisaks on olemas logi, kus on näha kõik sündmused, mis on vastava OU-ga seotud. Igale OU-le on võimalik lisada kasutajaid ja nendele jagada õiguseid rollipõhiselt. Kokku on 5 erinevat rolli. Rollide lisamise vaade näeb välja [[Media:Manpremo_ou_roles.png|selline]] ja logide vaade [[Media:Manpremo_ou_logs.png|selline]].

== '''Registration Keys''' ==

Registreerimise võtmed on loodud selleks, et lubatud arvutid saaksid loodud Manpremo serveriga liituda.

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

File:Manpremo ou roles.png

2011-05-03T06:11:17Z

Hleinola:

Manpremo

2011-05-03T05:51:34Z

Hleinola: /* Organizational Units */

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, kuhu on paigaldatud Manpremo server.

*'''Klient''' on arvuti, kuhu on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

= '''Manpremo serverite paigaldamine''' =

Järgnevalt käin läbi erinevate Manpremo serverite paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

== '''Manpremo Development Serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

== '''Production serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

= '''Manpremo klientide paigaldamine ja registreerimine''' =

Järgnevalt käin läbi Manpremo klientide paigladamise ja registreerimise. Hetkel on võimalik kasutada Linuxi ja Windowsi operatsioonisüsteeme klientideks.

== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ==

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ==

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

== '''Linuxi kliendi registreerimine''' ==

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

''' Registreerimine '''

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

Selleks, et Manpremo daemon hakkaks tööle operatsioonisüsteemi alglaadimisel, tuleb lisada antud käsklus alglaadimisel käimaminevasse skripti. Selleks:

cd /etc/init.d
sudo touch manpremo
sudo nano manpremo

Avanenud aknasse kirjutada:

sudo manpremo-daemon

= '''Manpremo veebiliidese ülevaade''' =

== '''Sisselogimine ja kasutajate registreerimine''' ==
[[File:Manpremo_login.png|thumb|Manpremo sisselogimise aken]]
Kui kasutaja külastab Manpremo serveri veebiliidese lehte esimene kord, avaneb talle selline [[Media:Manpremo_login.png|vaade]]. Seal on võimalik kasutajal valida keel, mida ta soovib kasutada. Käesoleva ülevaate keelevalik on inglise keel. Veel on võimalik lugeda Manpremo kohta täpsemalt vajutades vastavale lingile. Client software taga peitub nimekiri kliendile vajaminevatest paketidest või tarkvarast.

'''Kasutaja registreerimine'''

Kasutaja registreerimiseks tuleb vajutada lingile Register. Siis avaneb kasutajale järgmine [[Media:Manpremo_registration.png|leht]]. Korrektsete andmete sisestamisel ja nupule Register vajutades, küsitakse kasutaja kohta veel täpsustavaid andmeid, millede kinnitamisel kuvatakse Manpremo serveri peavaadet või siis -menüüd.

== '''Peavaade''' ==

Peamenüü näeb välja [[Media:Manpremo_main.png|selline]]. Kõik menüü osad on ringi liigutatavad, suletavad ja minimiseeritavad. Kinni pandud osa võib hiljem ka tagasi panna kasutades Add portlet linki.

== '''Organizational Units''' ==

Selle funktsiooni eesmärk on pakkuda administraatoritele võimalus jagada oma kasutatavad seadmed ning kliendid organisatsiooniliselt ära. Iga Organizational Uniti (OU) kohta on võimalik lisada nimi, kirjeldus ja vajaduse korral ülem (parent) OU. Organizational Uniti vaade näeb välja [[Media:Manpremo_OU.png|selline]] ja lisamise vaade [[Media:Manpremo_ou_create.png|selline]].

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

Manpremo

2011-05-03T05:49:19Z

Hleinola: /* Organizational Units */

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, kuhu on paigaldatud Manpremo server.

*'''Klient''' on arvuti, kuhu on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

= '''Manpremo serverite paigaldamine''' =

Järgnevalt käin läbi erinevate Manpremo serverite paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

== '''Manpremo Development Serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

== '''Production serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

= '''Manpremo klientide paigaldamine ja registreerimine''' =

Järgnevalt käin läbi Manpremo klientide paigladamise ja registreerimise. Hetkel on võimalik kasutada Linuxi ja Windowsi operatsioonisüsteeme klientideks.

== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ==

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ==

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

== '''Linuxi kliendi registreerimine''' ==

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

''' Registreerimine '''

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

Selleks, et Manpremo daemon hakkaks tööle operatsioonisüsteemi alglaadimisel, tuleb lisada antud käsklus alglaadimisel käimaminevasse skripti. Selleks:

cd /etc/init.d
sudo touch manpremo
sudo nano manpremo

Avanenud aknasse kirjutada:

sudo manpremo-daemon

= '''Manpremo veebiliidese ülevaade''' =

== '''Sisselogimine ja kasutajate registreerimine''' ==
[[File:Manpremo_login.png|thumb|Manpremo sisselogimise aken]]
Kui kasutaja külastab Manpremo serveri veebiliidese lehte esimene kord, avaneb talle selline [[Media:Manpremo_login.png|vaade]]. Seal on võimalik kasutajal valida keel, mida ta soovib kasutada. Käesoleva ülevaate keelevalik on inglise keel. Veel on võimalik lugeda Manpremo kohta täpsemalt vajutades vastavale lingile. Client software taga peitub nimekiri kliendile vajaminevatest paketidest või tarkvarast.

'''Kasutaja registreerimine'''

Kasutaja registreerimiseks tuleb vajutada lingile Register. Siis avaneb kasutajale järgmine [[Media:Manpremo_registration.png|leht]]. Korrektsete andmete sisestamisel ja nupule Register vajutades, küsitakse kasutaja kohta veel täpsustavaid andmeid, millede kinnitamisel kuvatakse Manpremo serveri peavaadet või siis -menüüd.

== '''Peavaade''' ==

Peamenüü näeb välja [[Media:Manpremo_main.png|selline]]. Kõik menüü osad on ringi liigutatavad, suletavad ja minimiseeritavad. Kinni pandud osa võib hiljem ka tagasi panna kasutades Add portlet linki.

== '''Organizational Units''' ==

Selle funktsiooni eesmärk on pakkuda administraatoritele võimalus jagada oma kasutatavad seadmed ning kliendid organisatsiooniliselt ära. Iga Organizational Uniti (OU) kohta on võimalik lisada nimi, kirjeldus ja vajaduse korral ülem (parent) OU. Organizational Uniti vaade näeb välja [[Media:Manpremo_OU.png|selline]] ja lisamise vaade [[Media:Manpremo_create_OU.png|selline]].

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

File:Manpremo ou create.png

2011-05-03T05:48:32Z

Hleinola:

Manpremo

2011-05-03T05:10:59Z

Hleinola: /* Organizational Units */

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, kuhu on paigaldatud Manpremo server.

*'''Klient''' on arvuti, kuhu on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

= '''Manpremo serverite paigaldamine''' =

Järgnevalt käin läbi erinevate Manpremo serverite paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

== '''Manpremo Development Serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

== '''Production serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

= '''Manpremo klientide paigaldamine ja registreerimine''' =

Järgnevalt käin läbi Manpremo klientide paigladamise ja registreerimise. Hetkel on võimalik kasutada Linuxi ja Windowsi operatsioonisüsteeme klientideks.

== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ==

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ==

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

== '''Linuxi kliendi registreerimine''' ==

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

''' Registreerimine '''

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

Selleks, et Manpremo daemon hakkaks tööle operatsioonisüsteemi alglaadimisel, tuleb lisada antud käsklus alglaadimisel käimaminevasse skripti. Selleks:

cd /etc/init.d
sudo touch manpremo
sudo nano manpremo

Avanenud aknasse kirjutada:

sudo manpremo-daemon

= '''Manpremo veebiliidese ülevaade''' =

== '''Sisselogimine ja kasutajate registreerimine''' ==
[[File:Manpremo_login.png|thumb|Manpremo sisselogimise aken]]
Kui kasutaja külastab Manpremo serveri veebiliidese lehte esimene kord, avaneb talle selline [[Media:Manpremo_login.png|vaade]]. Seal on võimalik kasutajal valida keel, mida ta soovib kasutada. Käesoleva ülevaate keelevalik on inglise keel. Veel on võimalik lugeda Manpremo kohta täpsemalt vajutades vastavale lingile. Client software taga peitub nimekiri kliendile vajaminevatest paketidest või tarkvarast.

'''Kasutaja registreerimine'''

Kasutaja registreerimiseks tuleb vajutada lingile Register. Siis avaneb kasutajale järgmine [[Media:Manpremo_registration.png|leht]]. Korrektsete andmete sisestamisel ja nupule Register vajutades, küsitakse kasutaja kohta veel täpsustavaid andmeid, millede kinnitamisel kuvatakse Manpremo serveri peavaadet või siis -menüüd.

== '''Peavaade''' ==

Peamenüü näeb välja [[Media:Manpremo_main.png|selline]]. Kõik menüü osad on ringi liigutatavad, suletavad ja minimiseeritavad. Kinni pandud osa võib hiljem ka tagasi panna kasutades Add portlet linki.

== '''Organizational Units''' ==

Selle funktsiooni eesmärk on pakkuda administraatoritele võimalus jagada oma kasutatavad seadmed ning kliendid organisatsiooniliselt ära. Iga Organizational Uniti (OU) kohta on võimalik lisada nimi, kirjeldus ja vajaduse korral ülem (parent) OU. Organizational Uniti vaade näeb välja [[Media:Manpremo_OU.png|selline]].

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

File:Manpremo OU.png

2011-05-03T05:10:45Z

Hleinola:

Manpremo

2011-05-03T05:04:12Z

Hleinola: /* Manpremo veebiliidese ülevaade */

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, kuhu on paigaldatud Manpremo server.

*'''Klient''' on arvuti, kuhu on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

= '''Manpremo serverite paigaldamine''' =

Järgnevalt käin läbi erinevate Manpremo serverite paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

== '''Manpremo Development Serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

== '''Production serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

= '''Manpremo klientide paigaldamine ja registreerimine''' =

Järgnevalt käin läbi Manpremo klientide paigladamise ja registreerimise. Hetkel on võimalik kasutada Linuxi ja Windowsi operatsioonisüsteeme klientideks.

== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ==

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ==

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

== '''Linuxi kliendi registreerimine''' ==

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

''' Registreerimine '''

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

Selleks, et Manpremo daemon hakkaks tööle operatsioonisüsteemi alglaadimisel, tuleb lisada antud käsklus alglaadimisel käimaminevasse skripti. Selleks:

cd /etc/init.d
sudo touch manpremo
sudo nano manpremo

Avanenud aknasse kirjutada:

sudo manpremo-daemon

= '''Manpremo veebiliidese ülevaade''' =

== '''Sisselogimine ja kasutajate registreerimine''' ==
[[File:Manpremo_login.png|thumb|Manpremo sisselogimise aken]]
Kui kasutaja külastab Manpremo serveri veebiliidese lehte esimene kord, avaneb talle selline [[Media:Manpremo_login.png|vaade]]. Seal on võimalik kasutajal valida keel, mida ta soovib kasutada. Käesoleva ülevaate keelevalik on inglise keel. Veel on võimalik lugeda Manpremo kohta täpsemalt vajutades vastavale lingile. Client software taga peitub nimekiri kliendile vajaminevatest paketidest või tarkvarast.

'''Kasutaja registreerimine'''

Kasutaja registreerimiseks tuleb vajutada lingile Register. Siis avaneb kasutajale järgmine [[Media:Manpremo_registration.png|leht]]. Korrektsete andmete sisestamisel ja nupule Register vajutades, küsitakse kasutaja kohta veel täpsustavaid andmeid, millede kinnitamisel kuvatakse Manpremo serveri peavaadet või siis -menüüd.

== '''Peavaade''' ==

Peamenüü näeb välja [[Media:Manpremo_main.png|selline]]. Kõik menüü osad on ringi liigutatavad, suletavad ja minimiseeritavad. Kinni pandud osa võib hiljem ka tagasi panna kasutades Add portlet linki.

== '''Organizational Units''' ==

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

Manpremo

2011-05-03T05:02:23Z

Hleinola: /* Peavaade */

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, kuhu on paigaldatud Manpremo server.

*'''Klient''' on arvuti, kuhu on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

= '''Manpremo serverite paigaldamine''' =

Järgnevalt käin läbi erinevate Manpremo serverite paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

== '''Manpremo Development Serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

== '''Production serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

= '''Manpremo klientide paigaldamine ja registreerimine''' =

Järgnevalt käin läbi Manpremo klientide paigladamise ja registreerimise. Hetkel on võimalik kasutada Linuxi ja Windowsi operatsioonisüsteeme klientideks.

== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ==

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ==

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

== '''Linuxi kliendi registreerimine''' ==

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

''' Registreerimine '''

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

Selleks, et Manpremo daemon hakkaks tööle operatsioonisüsteemi alglaadimisel, tuleb lisada antud käsklus alglaadimisel käimaminevasse skripti. Selleks:

cd /etc/init.d
sudo touch manpremo
sudo nano manpremo

Avanenud aknasse kirjutada:

sudo manpremo-daemon

= '''Manpremo veebiliidese ülevaade''' =

== '''Sisselogimine ja kasutajate registreerimine''' ==
[[File:Manpremo_login.png|thumb|Manpremo sisselogimise aken]]
Kui kasutaja külastab Manpremo serveri veebiliidese lehte esimene kord, avaneb talle selline [[Media:Manpremo_login.png|vaade]]. Seal on võimalik kasutajal valida keel, mida ta soovib kasutada. Käesoleva ülevaate keelevalik on inglise keel. Veel on võimalik lugeda Manpremo kohta täpsemalt vajutades vastavale lingile. Client software taga peitub nimekiri kliendile vajaminevatest paketidest või tarkvarast.

'''Kasutaja registreerimine'''

Kasutaja registreerimiseks tuleb vajutada lingile Register. Siis avaneb kasutajale järgmine [[Media:Manpremo_registration.png|leht]]. Korrektsete andmete sisestamisel ja nupule Register vajutades, küsitakse kasutaja kohta veel täpsustavaid andmeid, millede kinnitamisel kuvatakse Manpremo serveri peavaadet või siis -menüüd.

== '''Peavaade''' ==

Peamenüü näeb välja [[Media:Manpremo_main.png|selline]]. Kõik menüü osad on ringi liigutatavad, suletavad ja minimiseeritavad. Kinni pandud osa võib hiljem ka tagasi panna kasutades Add portlet linki.

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

File:Manpremo main.png

2011-05-03T04:59:04Z

Hleinola:

Manpremo

2011-05-02T20:28:44Z

Hleinola: /* Manpremo veebiliidese ülevaade */

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, kuhu on paigaldatud Manpremo server.

*'''Klient''' on arvuti, kuhu on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

= '''Manpremo serverite paigaldamine''' =

Järgnevalt käin läbi erinevate Manpremo serverite paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

== '''Manpremo Development Serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

== '''Production serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

= '''Manpremo klientide paigaldamine ja registreerimine''' =

Järgnevalt käin läbi Manpremo klientide paigladamise ja registreerimise. Hetkel on võimalik kasutada Linuxi ja Windowsi operatsioonisüsteeme klientideks.

== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ==

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ==

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

== '''Linuxi kliendi registreerimine''' ==

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

''' Registreerimine '''

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

Selleks, et Manpremo daemon hakkaks tööle operatsioonisüsteemi alglaadimisel, tuleb lisada antud käsklus alglaadimisel käimaminevasse skripti. Selleks:

cd /etc/init.d
sudo touch manpremo
sudo nano manpremo

Avanenud aknasse kirjutada:

sudo manpremo-daemon

= '''Manpremo veebiliidese ülevaade''' =

== '''Sisselogimine ja kasutajate registreerimine''' ==
[[File:Manpremo_login.png|thumb|Manpremo sisselogimise aken]]
Kui kasutaja külastab Manpremo serveri veebiliidese lehte esimene kord, avaneb talle selline [[Media:Manpremo_login.png|vaade]]. Seal on võimalik kasutajal valida keel, mida ta soovib kasutada. Käesoleva ülevaate keelevalik on inglise keel. Veel on võimalik lugeda Manpremo kohta täpsemalt vajutades vastavale lingile. Client software taga peitub nimekiri kliendile vajaminevatest paketidest või tarkvarast.

'''Kasutaja registreerimine'''

Kasutaja registreerimiseks tuleb vajutada lingile Register. Siis avaneb kasutajale järgmine [[Media:Manpremo_registration.png|leht]]. Korrektsete andmete sisestamisel ja nupule Register vajutades, küsitakse kasutaja kohta veel täpsustavaid andmeid, millede kinnitamisel kuvatakse Manpremo serveri peavaadet või siis -menüüd.

== '''Peavaade''' ==

Peamenüü koosneb erinevatest osadest.

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

Manpremo

2011-05-02T20:18:29Z

Hleinola: /* Manpremo veebiliidese kasutusjuhend */

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, kuhu on paigaldatud Manpremo server.

*'''Klient''' on arvuti, kuhu on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

= '''Manpremo serverite paigaldamine''' =

Järgnevalt käin läbi erinevate Manpremo serverite paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

== '''Manpremo Development Serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

== '''Production serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

= '''Manpremo klientide paigaldamine ja registreerimine''' =

Järgnevalt käin läbi Manpremo klientide paigladamise ja registreerimise. Hetkel on võimalik kasutada Linuxi ja Windowsi operatsioonisüsteeme klientideks.

== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ==

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ==

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

== '''Linuxi kliendi registreerimine''' ==

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

''' Registreerimine '''

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

Selleks, et Manpremo daemon hakkaks tööle operatsioonisüsteemi alglaadimisel, tuleb lisada antud käsklus alglaadimisel käimaminevasse skripti. Selleks:

cd /etc/init.d
sudo touch manpremo
sudo nano manpremo

Avanenud aknasse kirjutada:

sudo manpremo-daemon

= '''Manpremo veebiliidese ülevaade''' =

== '''Sisselogimine ja kasutajate registreerimine''' ==
[[File:Manpremo_login.png|thumb|Manpremo sisselogimise aken]]
Kui kasutaja külastab Manpremo serveri veebiliidese lehte esimene kord, avaneb talle selline [[Media:Manpremo_login.png|vaade]]. Seal on võimalik kasutajal valida keel, mida ta soovib kasutada. Käesoleva ülevaate keelevalik on inglise keel. Veel on võimalik lugeda Manpremo kohta täpsemalt vajutades vastavale lingile. Client software taga peitub nimekiri kliendile vajaminevatest paketidest või tarkvarast.

'''Kasutaja registreerimine'''

Kasutaja registreerimiseks tuleb vajutada lingile Register!. Siis avaneb kasutajale järgmine [[Media:Manpremo_registration.png|leht]].

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

File:Manpremo registration.png

2011-05-02T20:17:13Z

Hleinola: uploaded a new version of "File:Manpremo registration.png"

File:Manpremo registration.png

2011-05-02T20:14:11Z

Hleinola:

File:Manpremo login.png

2011-05-02T19:56:02Z

Hleinola: uploaded a new version of "File:Manpremo login.png"

File:Manpremo login.png

2011-05-02T19:51:26Z

Hleinola:

Manpremo

2011-05-02T19:18:05Z

Hleinola:

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, kuhu on paigaldatud Manpremo server.

*'''Klient''' on arvuti, kuhu on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

= '''Manpremo serverite paigaldamine''' =

Järgnevalt käin läbi erinevate Manpremo serverite paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

== '''Manpremo Development Serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

== '''Production serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

= '''Manpremo klientide paigaldamine ja registreerimine''' =

Järgnevalt käin läbi Manpremo klientide paigladamise ja registreerimise. Hetkel on võimalik kasutada Linuxi ja Windowsi operatsioonisüsteeme klientideks.

== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ==

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ==

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

== '''Linuxi kliendi registreerimine''' ==

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

''' Registreerimine '''

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

Selleks, et Manpremo daemon hakkaks tööle operatsioonisüsteemi alglaadimisel, tuleb lisada antud käsklus alglaadimisel käimaminevasse skripti. Selleks:

cd /etc/init.d
sudo touch manpremo
sudo nano manpremo

Avanenud aknasse kirjutada:

sudo manpremo-daemon

= '''Manpremo veebiliidese kasutusjuhend''' =

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

Manpremo

2011-05-02T19:10:32Z

Hleinola: /* Linuxi kliendi registreerimine */

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, kuhu on paigaldatud Manpremo server.

*'''Klient''' on arvuti, kuhu on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

= '''Manpremo serverite paigaldamine''' =

Järgnevalt käin läbi erinevate Manpremo serverite paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

== '''Manpremo Development Serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

== '''Production serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

= '''Manpremo klientide paigaldamine ja registreerimine''' =

Järgnevalt käin läbi Manpremo klientide paigladamise ja registreerimise. Hetkel on võimalik kasutada Linuxi ja Windowsi operatsioonisüsteeme klientideks.

== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ==

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ==

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

== '''Linuxi kliendi registreerimine''' ==

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

''' Registreerimine '''

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

Selleks, et Manpremo daemon hakkaks tööle operatsioonisüsteemi alglaadimisel, tuleb lisada antud käsklus alglaadimisel käimaminevasse skripti. Selleks:

cd /etc/init.d
sudo touch manpremo
sudo nano manpremo

Avanenud aknasse kirjutada:

sudo manpremo-daemon

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

Manpremo

2011-05-02T19:09:32Z

Hleinola: /* Manpremo klientide paigaldamine ja registreerimine */

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, kuhu on paigaldatud Manpremo server.

*'''Klient''' on arvuti, kuhu on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

= '''Manpremo serverite paigaldamine''' =

Järgnevalt käin läbi erinevate Manpremo serverite paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

== '''Manpremo Development Serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

== '''Production serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

= '''Manpremo klientide paigaldamine ja registreerimine''' =

Järgnevalt käin läbi Manpremo klientide paigladamise ja registreerimise. Hetkel on võimalik kasutada Linuxi ja Windowsi operatsioonisüsteeme klientideks.

== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ==

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ==

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

== '''Linuxi kliendi registreerimine''' ==

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

''' Registreerimine '''

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

Selleks, et Manpremo daemon hakkaks tööle operatsioonisüsteemi alglaadimisel, tuleb lisada antud käsklus alglaadimisel käimaminevasse skripti. Selleks:

cd /etc/init.d
sudo touch manpremo
sudo nano manpremo

Avanenud aknasse kirjutada sudo-manpremo-daemon. Pärast seda:

sudo update-rc.d manpremo defaults
sudo chmod +x manpremo

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

Manpremo

2011-05-02T19:07:34Z

Hleinola: /* Manpremo serverite paigaldamine */

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, kuhu on paigaldatud Manpremo server.

*'''Klient''' on arvuti, kuhu on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

= '''Manpremo serverite paigaldamine''' =

Järgnevalt käin läbi erinevate Manpremo serverite paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

== '''Manpremo Development Serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

== '''Production serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

= '''Manpremo klientide paigaldamine ja registreerimine''' =

== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ==

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ==

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

== '''Linuxi kliendi registreerimine''' ==

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

''' Registreerimine '''

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

Selleks, et Manpremo daemon hakkaks tööle operatsioonisüsteemi alglaadimisel, tuleb lisada antud käsklus alglaadimisel käimaminevasse skripti. Selleks:

cd /etc/init.d
sudo touch manpremo
sudo nano manpremo

Avanenud aknasse kirjutada sudo-manpremo-daemon. Pärast seda:

sudo update-rc.d manpremo defaults
sudo chmod +x manpremo

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

Manpremo

2011-05-02T19:06:23Z

Hleinola: /* Mõisted (lähtudes käesoleva referaadi teemast) */

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, kuhu on paigaldatud Manpremo server.

*'''Klient''' on arvuti, kuhu on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

= '''Manpremo serverite paigaldamine''' =

Järgnevalt käin läbi erinevate Manpremo osade paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

== '''Manpremo Development Serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

== '''Production serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

= '''Manpremo klientide paigaldamine ja registreerimine''' =

== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ==

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ==

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

== '''Linuxi kliendi registreerimine''' ==

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

''' Registreerimine '''

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

Selleks, et Manpremo daemon hakkaks tööle operatsioonisüsteemi alglaadimisel, tuleb lisada antud käsklus alglaadimisel käimaminevasse skripti. Selleks:

cd /etc/init.d
sudo touch manpremo
sudo nano manpremo

Avanenud aknasse kirjutada sudo-manpremo-daemon. Pärast seda:

sudo update-rc.d manpremo defaults
sudo chmod +x manpremo

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

Manpremo

2011-05-02T18:56:23Z

Hleinola:

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, millele on paigaldatud Manpremo server.

*'''Klient''' on arvuti, millele on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

= '''Manpremo serverite paigaldamine''' =

Järgnevalt käin läbi erinevate Manpremo osade paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

== '''Manpremo Development Serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

== '''Production serveri paigaldamine''' ==

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

= '''Manpremo klientide paigaldamine ja registreerimine''' =

== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ==

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ==

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

== '''Linuxi kliendi registreerimine''' ==

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

''' Registreerimine '''

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

Selleks, et Manpremo daemon hakkaks tööle operatsioonisüsteemi alglaadimisel, tuleb lisada antud käsklus alglaadimisel käimaminevasse skripti. Selleks:

cd /etc/init.d
sudo touch manpremo
sudo nano manpremo

Avanenud aknasse kirjutada sudo-manpremo-daemon. Pärast seda:

sudo update-rc.d manpremo defaults
sudo chmod +x manpremo

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

Manpremo

2011-05-02T00:27:24Z

Hleinola: /* Linuxi kliendi registreerimine */

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, millele on paigaldatud Manpremo server.

*'''Klient''' on arvuti, millele on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

== '''Manpremo serverite paigaldamine''' ==

Järgnevalt käin läbi erinevate Manpremo osade paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

=== '''Manpremo Development Serveri paigaldamine''' ===

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

=== '''Production serveri paigaldamine''' ===

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

== '''Manpremo klientide paigaldamine ja registreerimine''' ==

=== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ===

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

=== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ===

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

=== '''Linuxi kliendi registreerimine''' ===

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

''' Registreerimine '''

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

Selleks, et Manpremo daemon hakkaks tööle operatsioonisüsteemi alglaadimisel, tuleb lisada antud käsklus alglaadimisel käimaminevasse skripti. Selleks:

cd /etc/init.d
sudo touch manpremo
sudo nano manpremo

Avanenud aknasse kirjutada sudo-manpremo-daemon. Pärast seda:

sudo update-rc.d manpremo defaults
sudo chmod +x manpremo

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

Manpremo

2011-05-02T00:26:54Z

Hleinola: /* Linuxi kliendi registreerimine */

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, millele on paigaldatud Manpremo server.

*'''Klient''' on arvuti, millele on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

== '''Manpremo serverite paigaldamine''' ==

Järgnevalt käin läbi erinevate Manpremo osade paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

=== '''Manpremo Development Serveri paigaldamine''' ===

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

=== '''Production serveri paigaldamine''' ===

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

== '''Manpremo klientide paigaldamine ja registreerimine''' ==

=== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ===

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

=== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ===

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

=== '''Linuxi kliendi registreerimine''' ===

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

Selleks, et Manpremo daemon hakkaks tööle operatsioonisüsteemi alglaadimisel, tuleb lisada antud käsklus alglaadimisel käimaminevasse skripti. Selleks:

cd /etc/init.d
sudo touch manpremo
sudo nano manpremo

Avanenud aknasse kirjutada sudo-manpremo-daemon. Pärast seda:

sudo update-rc.d manpremo defaults
sudo chmod +x manpremo

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

Manpremo

2011-05-01T19:51:29Z

Hleinola: /* Linuxi kliendi registreerimine */

'''REFERAAT ON VEEL POOLELI JA TÄIENEB JOOKSVALT!!!!'''

Manpremo on kaughaldus süsteem, mis on loodud selleks, et süsteemi administraatorid saaksid keskselt hallata paljusid arvuteid kiirelt ja mugavalt. Seda rakendust arendab Eesti firma [http://www.povi.ee Povi Software OÜ]. Manpremo on vabavaraline ja avatud lähtekoodiga. Tarkvara loomisel on põhiliselt kasutatud Pythonit. Serveri poole loomiseks on kasutatud lahtise lähtekoodiga võrguraamistikku nimega Django. Kliendi pool on kirjutatud Pythonis. Manpremo projekt on hetkel veel varajases arengu staadiumis, kuid on kasutatav Linux põhiste süsteemide administreerimisel.

Praegune Manpremo stabiilne versioon on 0.2.

= '''Põhilised omadused''' =

*'''Veebi põhine kasutajaliides''' laseb arvuteid hallata olenemata asukohast spetsiaalset tarkvara paigaldamata. Liides töötab korralikult kõikide peamiste veebilehitsejatega.

*'''Jõuline kasutajaõiguste kontroll''' annab täieliku kontrolli selle üle, mida kasutajad teha saavad. Näiteks võib neil keelata muude käskude jooksutamise peale nende, mis süsteemi administraator on lubanud, anda ligipääs ainult teatud arvutitele ja palju muud.

*'''Mitme operatsiooni süsteemi tugi''' laseb hallata Linuxi, Windowsi ja Mac OS X põhiseid arvutied ühe süsteemiga. Käskluseid võib teisendada operatsiooni süsteemide vahel, lastes administraatoril kasutada samu käsklusi kõikides erinevates süsteemides.

*'''Lihtne kasutada''' nii administraatorite kui ka kasutajate poolel. Administraator võib telegeerida ülesandeid kasutajatele ilma, et nemad peaks õppima keerulisi käsklusi kirjutama.

*'''Turvaline''' platvorm tagab selle, et kliendi ja serveri vahelist suhtlust ei saa pealt kuulata ega muuta.

= '''Vajalikud mõisted, teadmised ja tarkvara''' =

Selleks, et järgnevat oleks võimalik järgida seletan lahti mõned mõisted ja panen kirja vajalikud teadmised ja tarkvara.

== '''Mõisted (lähtudes käesoleva referaadi teemast)''' ==

*'''Server''' on arvuti, millele on paigaldatud Manpremo server.

*'''Klient''' on arvuti, millele on paigaldatud Manpremo kliendi poolne tarkvara.

*'''Development server''' on Manpremo server, mis on eelkõige mõeldud testimiseks ja arendamiseks.

*'''Production server''' on Manpremo server, mis on mõeldud töös oleva arvutivõrgu haldamiseks. See server kasutab serveri ja klientide vahelise ühenduse turvamiseks SSL krüpteerimist.

== '''Teadmised/Tarkvara''' ==

Mina kasutasin server paigaldamiseks Ubuntu 10.10 Maverick versiooni. Manpremo loojad ise on testinud paigaldamist Debian Squeeze peal. Nende sõnul peaks paigaldamine õnnestuma Ubuntu ja sarnaste operatsioonisüsteemide peal.

Selleks, et paigaldada Manpremo peab olemas olema järgnev:

*Django - Serveri veebiliides
*Gettext - Serveri veebiliides
*stunnel (valikuline) - Turvalisus
*Mercurial - Manpremo koodi saamiseks
*Python - Manpremo on kirjutatud Pythonis

Kõide vajaminevate pakettide paigaldamiseks võib kasutada järgnevat käsurea käsklust:

sudo apt-get install python-django gettext stunnel4 mercurial python-tz

== '''Manpremo serverite paigaldamine''' ==

Järgnevalt käin läbi erinevate Manpremo osade paigladamise. Mina kasutasin serverite paigaldamisel operatsioonisüsteemi Ubuntu 10.10. Kõik juhised ja käsud lähtuvad antud operatsioonisüsteemist. Vigade tekkimise korral kontrollida, et kõik ülesse loetud paketid on korralikult arvutisse paigaldatud. Enne kui paigaldama hakata, tuleks läbi mõelda kumba versiooni soovitakse kasutada. Development serveri peale ei õnnestu ilma suuremate jamadeta paigaldada production serverit seega tuleks enne ära otsustada.

=== '''Manpremo Development Serveri paigaldamine''' ===

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine:

hg clone http://manpremo.org/hg/manpremo/

Manpremo kataloogi sisenemine ja viimase versiooni valimine:

cd manpremo/
hg up default

Andmebaasi intialiseerimine:

cd pyserver/
./manage.py syncdb
./manage.py createcachetable cache_manpremo_ccs

Serveri käivitamine:

./manage.py runserver

Kui server käivitus (konsooli ekraanile ilmub kinnitus teade), on serveri veebillides kätte saadav aadressilt [http://127.0.0.1:8000 127.0.0.1:8000].

=== '''Production serveri paigaldamine''' ===

Töö alustamiseks avada Terminal. (Applications > Accessories > Terminal).

Kõige viimase Manpremo versiooni kloonimine ja selle paigutamine /srv/manpremo kataloogi:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo/
hg up stable-0.2
cd
sudo mv manpremo /srv/

Manpremo andmebaasi jaoks vajalike pakettide paigaldamine:

sudo apt-get install postgresql python-psycopg2

(Vaikimisi kasutatakse PostgreSQL andmebaasi. [http://docs.djangoproject.com/en/dev/topics/install/#get-your-database-running Django dokumentatsioon] annab ülevaate võimalikest alternatiividest.)

Andmebaasi ja kasutaja loomine:

sudo -u postgres psql
CREATE DATABASE manpremo;
CREATE USER manpremo; //Või sisesta omal valikul mõni kasutajatunnus.
ALTER USER manpremo WITH ENCRYPTED PASSWORD 'notsecure'; //Või sisesta omal valikul mõni parool.
GRANT ALL PRIVILEGES ON DATABASE manpremo TO manpremo;
\q

Andmebaasi seadistamine:

sudo gedit /srv/manpremo/pyserver/settings.py

(Mina kasutasin gedit tööriista. Võib asendada ka muude alternatiividega nagu näiteks nano.)

Avanenud aknas otsida järgnevad väljad ja muuta ringi vasvalt juhisele:

DATABASE_ENGINE = 'postgresql_psycopg2'
DATABASE_NAME = 'manpremo'
DATABASE_USER = 'manpremo' //Kui valisite enne mingi muu kasutajatunnuse, sisestada see siia.
DATABASE_PASSWORD = 'notsecure' //Kui valisite enne mingi muu parooli, sisestada see siia.
DATABASE_HOST = 'localhost' # Use TCP socket, not local UNIX domain socket
DATABASE_PORT = ''

CACHE_BACKEND = 'db://cache_manpremo_ccs'

Andmebaasi initiliseerimine:

cd /srv/manpremo/pyserver
./manage.py syncdb //Käsu jooksutamisel lastakse luua "super" kasutaja, kui seda veel ei ole.
./manage.py createcachetable cache_manpremo_ccs

Süsteemi kasutaja loomine andmebaasi jaoks:

sudo useradd manpremo
sudo mkdir -p /srv/manpremo/pyserver/data
sudo chown manpremo:manpremo -R /srv/manpremo/pyserver/data

Apache veebiserveri jaoks vajalike pakettide paigaldamine:

sudo apt-get install apache2-mpm-prefork libapache2-mod-python libapache2-mod-wsgi

Serveri jaoks võtmete loomine:

sudo mkdir /etc/apache2/ssl
sudo openssl req -new -x509 -nodes -out /etc/apache2/ssl/manpremo.crt -keyout /etc/apache2/ssl/manpremo.key //Käsu jooksutamisel küsitakse sertifikaadi loomiseks erinevat informatsiooni.
//Väljale CN(Common Name) sisestada serveri IP aadress või URL.
sudo chmod 600 -R /etc/apache2/ssl
sudo chown root:root -R /etc/apache2/ssl

Apache seadistus faili loomine:

sudo touch /etc/apache2/sites-enabled/manpremo
sudo gedit /etc/apache2/sites-enabled/manpremo

Avanenud aknasse kopeerida järgnev tekst ja see salvestada:

WSGIRestrictStdout Off
<VirtualHost *:80>
# Redirect from HTTP to HTTPS:
RewriteEngine On
RewriteRule ^/(.*)$ https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
WSGIScriptAlias / /srv/manpremo/pyserver/manpremo.wsgi
WSGIDaemonProcess manpremo user=manpremo group=manpremo
WSGIProcessGroup manpremo
Alias /media "/srv/manpremo/pyserver/media
SSLEngine on
SSLCertificateFile /etc/apache2/ssl/manpremo.crt
SSLCertificateKeyFile /etc/apache2/ssl/manpremo.key
</VirtualHost>

SSL-i aktiveerimine ja moodulite ülekirjutamine:

sudo a2enmod ssl rewrite

Apache veebiserveri restart:

sudo apache2ctl restart

Kui kõik sammud said õigesti ja edukalt läbitud, peaks saama aadressilt [https://localhost/ https://localhost/] siseneda Manpremo veebiliidesesse käsu ./manage.py syncdb ajal sisestatud kasutajatunnustega. Kui sellel aadressil pärast sertifikaadi laadimist kuvatakse Internal Server Error 500, sisestada terminali järgmine käsk ja uurida viimaseid ridu vea põhjuse leidmiseks:

gedit /var/log/apache2/error.log

== '''Manpremo klientide paigaldamine ja registreerimine''' ==

=== '''Linuxi kliendi paigaldamine kasutades Mercuriali''' ===

Mercuriali ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Setup.py skripti kasutamine paigaldamiseks:

sudo ./setup.py install

=== '''Linuxi kliendi paigaldamine Debiani paketti ehitades''' ===

Mercuriali, Debiani tööriistade ja Pythoni paigaldamine:

sudo apt-get install mercurial tortoisehg python-setuptools devscripts debhelper

Manpremo koodi allalaadimine:

hg clone http://manpremo.org/hg/manpremo/
cd manpremo

Kliendi paketti ehitamine:

sudo ./build-clientpkg.sh

Kui eelmine skript lõpetas töö edukalt. Jooksutada seda korra uuesti. Kui teisel korral on kõik korras:

cd .. && cd /srv/manpremo/ba

Kontrollida, kas selles kaustas asub (ls -l) fail nimega manpremo-client_0.2~<mingi number>_all.deb. Kui asub siis:

sudo dpkg -i manpremo-client_0.2~<mingi number>_all.deb

Pärast seda teha arvutile restart. Käsurealt käsklusega:

sudo reboot

Kui kõik läks edukalt, peaksid olema tekkinud järgmised kaustad ja failid:

/etc/manpremo
/etc/manpremo/certs
/etc/manpremo/manpremo.conf
/etc/manpremo/certs/servers.crt

=== '''Linuxi kliendi registreerimine''' ===

Kui kliendi osa sai eduaklt paigaldatud, saab kliendi nüüd registreerida, et see oleks näha Manpremo veebiliideses.

''' Sertifikaat '''

Serveri sertifikaadi hankimine külastades Manpremo serveri veebiliidest aadressil [https://localhost https://localhost] 
'''Firefox:''' Add Exception... > Get Certificate > View > Details > Export > Save to file. 
'''IE:''' Continue to this website > Right click > Properties > Certificates > Details > Copy to file 
'''Chrome:''' Vajuta aadressi ribal asuvale hoiatusmärgile > Certificate Information -> Details Tab -> Copy to file 

Kopeeri loodud faili sisu ja lisa see faili /etc/manpremo/certs/servers.crt

Production serverisse kliendi registreerimine:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server manpremo.com --port 443

Development serverisse kliendi registreerimine ilma ssl-ita:

sudo manpremo-register --registration-key REGISTREERIMIS_VÕTI --client-name KLIENDI_NIMI --server localhost --port 8000 --insecure

Selleks, et kindel olla, et klient kasutab turvamata versiooni, lisa

insecure = true

faili /etc/manpremo/manpremo.conf

Kui ei soovi lisada kliendile kindlat nime, võib ära jätta --client-name KLIENDI_NIMI osa. Siis kasutatakse registreerimisel arvuti nime.

Kui kliendi juures näidatakse teadet "client has never been seen" võib see tähendada, et Manpremo daemon ei tööta. Kliendi arvutis sisestada järgmine käsklus:

sudo manpremo-daemon

= Kasutatud kirjandus =
[https://www.manpremo.org/redmine/projects/manpremo/wiki Manpremo Wiki]
= Autor =
Henrik Leinola A22

Manpremo

2011-05-01T18:47:02Z

Hleinola: /* Manpremo klientide paigaldamine ja registreerimine */

Manpremo

2011-04-30T22:42:55Z

Hleinola: /* Linuxi kliendi paigaldamine Debiani paketti ehitades */

Manpremo

2011-04-30T22:42:31Z

Hleinola: /* Manpremo klientide paigaldamine */

Manpremo

2011-04-30T17:49:20Z

Hleinola:

Manpremo

2011-04-30T16:36:22Z

Hleinola: /* Manpremo serverite paigaldamine */

Manpremo

2011-04-30T16:35:56Z

Hleinola: /* Manpremo Development Server */

Operatsioonisüsteemide referaadid 2011 kevad

2011-04-18T12:29:13Z

Hleinola: /* Henrik Leinola A22 */

=Kaugõpe=
==Rene Albin AK31==
==Lembit Elmik AK21==
==Aleksei Issaikin AK21==
[[Ubuntu Serveri Install]]

==Andre Jõgi AK21==
==Pavel Kodotšigov AK22==

[[FreeBSD Packet Filter tulemüüriga]] - Valmis ülevaatamiseks.

==Ivo Kruusamäe AK21==

[[Gzip]] - pisut veel nokitsen

[[Dig]] - täiendan veel

==Lauri Liibert AK21==
==Siim Kullerkupp AK21==
[[Failisüsteemide jõudluse testimine]]

==Märt Lindre AK21==

[[Linux saalealaa ehk swap]] [[User:Mlindre|Mlindre]] 15:27, 15 April 2011 (EEST)

==Rasmus Linnamäe AK22==
[[ Netcat]] Valmis ülevaatamiseks 22:40, 17 Aprill 2011 (EEST)
==Priit Lume AK31==

[[Tshark]] ülevaatamiseks valmis 22:45, 17 April 2011 (EEST)

==Tiit Maripuu AK22==
==Marko Megerild AK21==
==Artur Mölter AK22==
[[Iozone]]

==Margus Nairis AK31==

[[Wireshark]] Valmis ülevaatamiseks.

==Karel Niine AK22==
[[PXE boot]] (Preboot Execution Environment) - Valmis ülevaatamiseks.

==Ulvar Petmanson AK22==
==Märten Rodes AK22==
[[htop]] Valmis ülevaatamiseks

==Tanel Štaub AK22==
==Alvar Teearu AK31==
KVM tegemisel, valmib järgmise nädala jooksul
[https://wiki.itcollege.ee/index.php/KVM]

==Aleksei Timošenko AK21==
=Päevaõpe=

==Rasmus Aav A21==
==Pavel Abin 12==
==Allar Adoberg A22==
==Arvi Alamaa A21==
==Ivar Ambos A22==
==Sergei Gorjunov A21==
==Merili Gutmann A31==
Referaat teemal "Lsof" valmib kahe nädala jooksul.
[https://wiki.itcollege.ee/index.php/Lsof]

==Rene Haavre A32==
==Kristjan Kalder A22==
==Kadri Kalme A22==
==Alfi Kannus A21==
==Nikolai Klõga G11==
==Reio Kokla A31==
==Vladimir Kolesnik A22==
==Ivar Krustok A22==
==Katrin Kukk A22==
==Rain Kõrgmaa A22==
==Siim Kängsepp A22==
==Urmo Laaneots A21==
==Karel Laid A31==
==Henrik Leinola A22==

[[Manpremo]]

==Kaspar Leivo A41==
==Juhan Liiva A21==
==Kaido Loonurm A41==
==Urmas Luuk A22==
==Andres Mill A22==
==Janar Märjama A22==
==Kairo Ostapenko A31==
==Kristjan Pajumaa A22==
==Ilja Peters 12==
==Veiko Pilt A31==
==Jagnar Pindmaa A31==
==Priit Pobbul A22==
==Arina Püvi A21==
==Karet Rikko A21==
==Toomas Rohumets A21==
==Taavi Salumets A21==
==Risto Siitan A22==
[[https://wiki.itcollege.ee/index.php/Partimage Partimage]]

==Oliver Soom A22==
==Kaspar Steinberg A32==
==Andres Sumin A22==
==Meelis Suursalu A22==
==Meelis Tamm A21==
==Ott Telga A31==
==Tavo Toomemägi A41==
==Taavi Toppi A21==
==Tarmo Trumm A21==
==Timo Trummer A32==
==Olle Tuur A22==
==Arto Vaas A32==
==Andres Vaher A22==
==Jaan Vahtre A21==
==Kristjan Vaik A21==
==Sten Vaisma A22==
==Kristjan Vask A21==
==Vadim Vinogradin A21==
==Heigo Võsujalg A21==
==Kristjan Väljako A21==

Manpremo

2011-04-17T15:00:38Z

Hleinola: /* Production serveri paigaldamine */

Manpremo

2011-04-17T14:33:59Z

Hleinola:

Manpremo

2011-04-17T14:33:10Z

Hleinola:

Manpremo

2011-04-17T14:30:46Z

Hleinola: /* Teadmised/Tarkvara */