README
=================

Dieses Setup ist gedacht, um schnell und reproduzierbar eine kix-Installation bereitzustellen ( https://www.kixdesk.com/ ). 
Es ist getestet sowohl auf Notebooks als auch auf unseren Produktiv-Maschinen im Serverbetrieb. 

Innerhalb des Docker-Containers wird ein normaler ubuntu-server verwendet 

**Vorteile**

* bekannte Umgebung
* die Konfiguration kann bei Bedarf ohne Anpassungen auch ohne Docker verwendet werden 


Schritte um das System auf einem beliebigen Linux in Betrieb zu nehmen (müsste auch in virtualbox gehen):


## repo clonen
```
git clone git@gitlab.rz.uni-bamberg.de:itfl-service-public/kix-referenz-installation.git
```

## IP / Port anpassen / Prüfen
in Datei docker-compose.yml
sollte passen, wenn auf der Maschine sonst keine Server laufen

## pubkeys hinterlegen (optional)
Container startet ssh-server
Pubkey hinterlegen in Datei 
docker/authorized_keys2

## docker-compose installiert ?
aktuelle Version installieren 
wenn nicht vorhanden Anleitung z.B. für Ubuntu 16.04 
https://gitlab.rz.uni-bamberg.de/itfl-service-public/misc/raw/master/docker/install


## einschalten
```
#im Verzeichnis wo docker-compose.yml liegt
#einschalten
sudo docker-compose up -d

```

## nach erstem einschalten Datenbank und /opt/kix ins normale Host-Dateisystem kopieren

### einloggen auf host

ssh -p 220 root@localhost
oder wenn anders angegeben ssh -p [port aus docker-compose.yml] root@[ip aus docker-compose.yml]

alternativ docker-compose exec bash 




### dateien rauskopieren

* liegen dann normal unter /volumes/
* sind unabhängig vom Container

```
service mysql stop
service apache2 stop

rsync -a --delete /root/uniba.de/initial/var/lib/mysql/ /var/lib/mysql/ 
service mysql restart

rsync -a --delete /root/uniba.de/initial/opt/ /opt/ 

service apache2 restart


```

## einloggen in kix
wenn alles durchgelaufen ist, müsste nach wenigen Sekunden ein fertiges kix im Browser erreichbar sein unter:  

http://localhost/kix/index.pl 

(oder http://<IP:PORT>/kix/index.pl  wie oben angegeben in docker-compose.yml

username:	root@localhost

password:	 root

im jetzigen Stand sind nur die Daten aus der Installation auf der Maschine.
In Zukunft können wir hier als Option Daten für Funktionstests bereitstellen.



## container ausschalten 

```
#Der Container ist als autostart konfiguriert. Damit er nicht beim  Systemstart wieder angeht folgendes Kommando

sudo docker-compose down 

```