Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

 

 

Diese Seite

...

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

 

Tip

Bitte beachten Sie auch die Hinweise auf folgenden Seiten:

Administration Guide

Tipps & Tricks

 

Notwendige Voraussetzungen

...

  • Damit Ihr WEEASY Appliance über das Internet erreicht werden kann, ist eine öffentliche IP-Adresse und Domain notwendig (z.B. weeasy.company.com)
  • Bei Nutzung des von anaptecs zur Verfügung gestellten Microsoft Office Web Apps Servers muss Ihr WEEASY Appliance ebenfalls über eine öffentliche IP / URL erreichbar sein
  • Bei Verwendung von SSL ist die Verwendung von "echten" SSL Zertifikaten notwendig. Self-signed Zertifikate verursachen regelmässig Probleme und werden daher nicht supported.

...

WEEASY ermöglicht es dem Benutzer im Falle von Fehlern direkt eine E-Mail mit der entsprechenden Fehlermeldung an ein Support-Team zu senden. Dazu ist die Konfiguration der entsprechenden E-Mail Addresse notwendig

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

Table of Contents
maxLevel3
minLevel3

 

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.

...

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

 

Info

Es wird in den nachfolgenden Schritten davon ausgegangen, dass alle Aktionen mit dem User root erfolgen. Die Inbetriebnahme kann sowohl direkt über die Konsole oder per SSH erfolgen.

Beim Zugriff per SSH ist zu beachten, dass hierzu der User weeasy verwendet wird und dann per su auf root gewechselt wird.

Das Default-Passwort für die Benutzer weeasy und root ist weeasy

 

Hostname anpassen / Statische IP-Adresse einrichten (optional)

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

 

Code Block
languagebash
# 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

Image Removed   Image Removed

 

Code Block
# 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)

Warning
titleSSH Login

Mit dem User root ist ein Login per SSH aus Sicherheitsgründen nicht möglich. Stattdessen muss für den Login per SSH der User weeasy verwendet werden. Per su kann danach auf den User root gewechselt werden.

 

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.

Code Block
languagebash
# 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.

Tip

Zum besseren Überblick was während des Updates passiert, ist es hilfreich in einer zweiten Konsole die JBoss Logs anzuzeigen:

tail -f /usr/share/jboss-as/standalone/log/boot.log /usr/share/jboss-as/standalone/log/server.log

Code Block
languagebash
[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

...

Achtung:

...

Mittlerweile existiert für die Version 1.3.0.47 ein Hotfix 2. Dieser muss nach der Installation ebenfalls noch angewendet werden. Weitere Details finden Sie unter:
Hotfix 2 für WEEASY 1.3.0.47

beschriebt die Konfiguration von WEEASY direkt über die Datenbank. Alternativ hierzu besteht auch die Möglichkeit die Konfiguration per BASH-Skript durchzuführen

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

 

Warning

Achtung:

Als Server-URL kann sowohl eine IP-Adresse oder auch ein Hostname verwendet werden. Am Ende der Server-URL darf jedoch kein / sein.
Beispiele für gültige Server-URLs:

  • weeasy.company.de
  • 192.168.1.100

Wird als Server-URL eine https Adresse eingetragen, so muss auch ein korrektes SSL-Zertifikat verwendet werden. Ansonsten kommt es zu Problemen z.B. mit den Office Web Apps und den Zoho Apps.

 

 

Code Block
languagebash
# 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.

Code Block
languagesql
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.

 

Code Block
languagebash
# 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

...

Online Server

...

 

SSL einrichten

Info

Aus Sicherheitsgründen wird der Einsatz von SSL dringend empfohlen. Bitte beim Einsatz von SSL unbedingt korrekte Zertifikate und keine Self-Signed Zertifikate verwenden, da diese von diversen Servern und Browsern nicht akzeptiert werden.

 

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

...

Theme konfigurieren

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

Bekannte Probleme

siehe Releasenotes 

 

Inhalt

...