Diese Seite beschreibt die Inbetriebnahme eines WEEASY Appliance. WEEASY Appliances können als Test- und Evaluierungsversion von der WEEASY Hompeage heruntergeladen werden.

Für den produktiven Einsatz von WEEASY ist eine Lizenz erforderlich.

Notwendige Voraussetzungen

Installation 

Im Folgenden wird die Inbetriebnahme eines WEEASY Appliance beschrieben. Eine Installation im eigentliche Sinne ist nicht mehr notwendig. Das downloadbare Appliance enthält bereits alles was zum Starten benötigt wird. Dennoch ist eine Inbetriebnahme erforderlich. Im Rahmen dieser müssen Konfigurationsanpassungen vorgenommen werden, so dass das Appliance in seiner Umgebung verwendet werden kann. Mit Hilfe dieser Step-by-Step Anleitung ist die Inbetriebnahme sehr einfach möglich.

Notwendige Schritte

Virtuelle Maschine in Betrieb nehmen

Nach dem Download des Appliance muss diese in die Virtualisierungslösung Ihrer Wahl importiert werden. Aktuell werden VMware und Hyper-V unterstützt. Für beide Zielplattformen werden auf der Download-Seite die entsprechenden Images angeboten.

• Importanleitung für VMware
• Importanleitung für Hyper-V
  
  

Nach dem erfolgreichen Import muss die VM gestartet werden. Danach kann WEEASY in Betrieb genommen werden

Hostname anpassen / Statische IP-Adresse einrichten (optional)

• IP- Adresse des Netzwerk-Adapters korrigieren
• Hostname ändern
• DNS-Einstellungen anpassen

# Hostname anpassen
hostnamectl set-hostname 'YOUR_HOST_NAME'


# Server Name in Apache Konfiguration anpassen
vim /etc/httpd/conf/httpd.conf
  
# Dabei ist der folgende Eintrag anzupassen
ServerName weeasy.company.com
 
# Statische IP-Adresse über Network Manager Tool für 1. Netzwerk-Adapter starten
nmtui edit ens160

# Danach muss der Netzwerk-Dienst neu gestartet werden. 
# Achtung: Falls eine Verbindung per SSH besteht, so wird diese durch den Neustart des Service abgebrochen. 
#          Eine neue Verbindung muss mit der festgelegten statischen IP-Addresse erfolgen
# Grundsätzlich reicht es aus den Netzwerkdienst per systemctl restart network.service
# neu zu starten. Die Erfahrung zeigt jedoch dass ein Reboot des gesamten Appliance die 
# robustere Variante ist ;-)
shutdown -r now

SSH Passwort und Root Passwort ändern (optional jedoch empfohlen)

WEEASY wird mit unsicheren Default-Passwörtern ausgeliefert. Daher sollten die Passwörter für die User weeasy und root aus Sicherheitsgründen bei der Inbetriebnahme geändert. Das Passwort kann mit Hilfe des Befehls passwd über die Konsole geändert werden.

# Mit Hilfe des Befehls passwd kann das Passwort des aktuellen Benutzers geändert werden.
passwd

WEEASY installieren

Aktuellen WEEASY Release installieren

Zur Installation des aktuellen WEEASY Release muss das Skript /var/weeasy/scripts/install_weeasy.sh ausgeführt werden.

[root@weeasy weeasy]# /var/weeasy/scripts/install_weeasy.sh 2>&1 | tee weeasy_install.log
==========================================================================
=
= Welcome to WEEASY Installation
=
==========================================================================
Do you really want to complete the installation of your WEEASY appliance? [y/n]
y

Server-URL festlegen

Das WEEASY Appliance enthält bereits eine vorkonfigurierte initiale MySQL Datenbank. Diese muss im Rahmen der Inbetriebnahme nun noch an das lokale Umfeld angepasst werden. Hierzu sind die folgende Schritte notwendig

# An lokaler MySQL Datenbank als User 'root' anmelden
mysql -u root weeasy_db
 
#
# {SERVER_URL} muss durch die URL / IP-Adresse für Ihr Appliance ersetzt werden 
# z.B. weeasy.company.de

# Server-URL konfigurieren
UPDATE JEAF_PROPERTY SET value='https://{SERVER_URL}' WHERE name='serverURL';

Selbstregistrierung (Sign-up) deaktivieren (optional)

Standardmässig wird eine WEEASY Appliance mit aktiver Selbstregistrierung ausgeliefert. Dies bedeutet, dass jeder, der auf die URL unter der Ihr WEEASY Appliance läuft Zugriff hat, sich dort als Benutzer registrieren kann. Daher sollte die Selbstregistrierung für Appliances, die über das Internet erreichbar sind abgeschaltet werden. Dies führt dazu, dass neue User nur noch über die Team Manager App erstellt werden können.

In der aktuell Version erfolgt das Abschalten der Selbstregistrierung ebenfalls über die MySQL Datenbank mit Hilfe den unten stehenden Befehls.

UPDATE JEAF_PROPERTY SET VALUE='false' WHERE NAME='signUpEnabled';

Mail-Server konfigurieren

Nach der initialen Installation eines WEEASY Appliance ist das Versenden von Mail durch WEEASY deaktiviert. Es ist jedoch dringend empfohlen einen entsprechenden Mail Provider zu konfigurieren, so dass WEEASY Mails z.B. zum Passwort zurücksetzen versenden kann. Die dazu notwendigen Schritte sind auf der folgende Seite beschrieben: Mail Server konfigurieren

Support E-Mail Addresse festlegen

WEEASY ermöglicht es Benutzer bei Fehlermeldungen diese direkt an den Support zu senden. Dazu muss im System die Support E-Mail Addresse hinterlegt werden.

# Verbindung zu MySQL Datenbank herstellen
mysql -u root weeasy_db
 
# Support E-Mail Addresse per SQL Statement setzen. Dabei muss anstelle von SUPPORT_MAIL noch die korrekte E-Mail Addresse angebenen werden
UPDATE jeaf_property SET VALUE='SUPPORT_MAIL' WHERE  NAME='supportEmailAddress';

Office Web Apps

Beim Einsatz der Office Web Apps sind folgende Punkte unbedingt zu berücksichtigen:

Damit die Apps auf Daten zugreifen können, ist es zwingend notwendig, dass für den Fall dass der Zugriff auf WEEASY per SSL erfolgt, gültige SSL-Zertifikate verwendet werden. Der Einsatz von Self-Signed Zertifikate ist aus Sicherheitsgründen nicht möglich.

Weitere Details zur Konfiguration der Office Web Apps (Office Online Server) finden Sie hier: Microsoft Office Web Apps

SSL einrichten

Standardmässig wird Ihr WEEASY Appliance nur mit einem self-signed Zertifikat ausgeliefert. Damit es im Browser zu keinen Fehlermeldungen kommt, ist die Installation eines "echten" SSL-Zertifikat notwendig. Die Anleitung dazu befindet sich hier.

Wird WEEASY hinter einer Firewall, Web Appliaction Firewall o.ä. betrieben und bereits dort wird das SSL Protokoll terminiert, so muss auf dem WEEASY Appliance der Redirect auf https deaktiviert werden

Automatische Updates einrichten

Mit Hilfe von yum-cron werden kritische Linux-Updates automatisch auf dem Appliance eingespielt. Bitte prüfen Sie, ob die Standardeinstellungen für Sie passend sind: Automatische Updates

Master-Key sichern

Bei der Installation von WEEASY wird automatisch ein Master-Key für die Verschlüsselung erstellt. Dieser Master-Key liegt nach der Installation verschlüsselt und unverschlüsselt auf dem Appliance.
Icon.

Aus Sicherheitsgründen muss der unverschlüsselte Master-Key nach der Installation entfernt werden. Dieser wird von WEEASY im Normalbetrieb nicht benötigt.

# Der generierte Master-Key befindet sich in der Datei /var/weeasy/data/secure/key.properties
 
# Master-Key-File öffnen
vim /var/weeasy/data/secure/key.properties
 
# Master-Key-File hat folgenden Aufbau
# Der Eintrag WEEASY_KEY_PLAIN muss aus der Datei entfernt und gesichert aufbewahrt werden
WEEASY_KEY_AES=JF9SuMwhc85FWZ+3fAojGS3EaSLimzSfasfdkds5vhsH4CiO9X1ZQflwydgzYWE9TNMQ90aMA\=\=
WEEASY_KEY_PLAIN=m1YHHCL1cAAU*_4eA5TTJxMxqk0mn9fefrh4E?2a*
WEEASY_KEY_IV=wa6NhGGsMBjm334cddSw\=\=
 
 
# Solange der Master-Key unverschlüsselt auf dem Appliance vorhanden ist, erscheint beim Startup folgende Warning im Log
[ 1044] anonymous            Unencrypted master key is still available on the system. Please see WEEASY Admin Guide for resolution.

Theme konfigurieren

Alle notwendigen Informationen zur Konfiguration von Themes finden Sie hier: Theming

Bekannte Probleme

siehe Releasenotes