Versions Compared

Key

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

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.

 

Tip

Bitte beachten Sie auch die Hinweise auf folgenden Seiten:

Administration Guide

Tipps & Tricks

 

Notwendige Voraussetzungen

Requirements 
HardwareVMware, 2 CPU Core, 4 GB RAM, 20 GB für Appliance plus Diskspace für eigene Daten (Erweiterung Diskspace siehe hier)
Öffentliche IP-Adresse
  • 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.
Support E-Mail

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 herunterladen

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.


Virtuelle Maschine importieren

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

   

 

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



SSL Konfiguration 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


WEEASY Software konfigurieren

Die Konfiguration von WEEASY standardmäßig ab Release 1.3.0.48 per Skript. Alternativ dazu ist auch weiterhin die Konfiguration via Datenbank möglich (siehe WEEASY Appliance via Datenbank konfigurieren)

Zur Konfiguration von WEEASy werden die folgenden Informationen benötigt

KonfigurationsparameterBeschreibungBeispiel
Server-URLURL unter der das Appliance verfügbar sein soll. Wird als Server-URL eine https Adresse eingetragen, so muss auch ein korrektes SSL-Zertifikat verwendet werden.
https://weeasy.company.de
Allow self registrationParameter steuert, ob sich Benutzer an WEEASY selbst registrieren können z.B. wenn WEEASY als öffentlicher Dienst angeboten wird.true / false
Activate sending of mails

Aktiviert das Versenden von Mails. Es ist dringend empfohlen einen entsprechenden Mail Provider zu konfigurieren, so dass WEEASY Mails z.B. zum Passwort zurücksetzen versenden kann.

Weitere Details sind hier dokumentiert: Mail Server konfigurieren


Support E-MailWEEASY ermöglicht es Benutzer bei Fehlermeldungen diese direkt an den Support zu senden. Dazu muss im System die Support E-Mail Addresse hinterlegt werden.
Office Online Server URLURL unter der der Office Online Server verfügbar ist. Dies ist nur relevant wenn die Office Online Apps verwendet werden sollhttps://oos.company.de/hosting/discovery



Code Block
languagebash
[root@weeasy weeasy]# /var/weeasy/scripts/configure_weeasy.sh
==========================================================================
=
= Welcome to WEEASY Configuration Tool
=
==========================================================================

Please make sure that you have a backup of your complete appliance. This
script only creates a backup of your database

Do you really want to update your the configuration of your WEEASY appliance? [y/n]

Please enter public URL of your WEEASY appliance e.g. https://weeasy.company.com: https://weeasy.company.de

Do you want to allow self registration for your WEEASY appliance? [true / false]: false

Do you want to disable sending of mails? Enter false to activate sennding of mails [true / false]: false

Please provide the required information to send mails
For for details how to configure mails please refer to: https://development.anaptecs.de/confluence/x/l4Di
Please enter mail address of sender (mail from) e.g. weeasy@company.de: mail@company.de

Please enter display name for of sender (mail from personal) e.g. WEEASY Administrator: WEEASY Administrator

Does your mail server require authentication? [true / false]: true

Please enter login name for your mail server: mail

Please enter password for your mail server: *****

Please enter host name for your mail server e.g smtp.office365.com: smtp.company.de

Please enter port for your mail server: 457

Do you want to use TLS encryption for communication with your mail server? [true / false]: true

Do you want to configure a Office Online Server that should be used? [true / false]: true

For details on the configuration of Office Online Servers please refer to: https://development.anaptecs.de/confluence/x/ZIDi"
Please configure the URL of you Office Online Server?: https://oos.company.de/hosting/discovery


Updating WEEASY database
Configuration update completed


Master-Key sichern

Insert excerpt
Master-Key Handling
Master-Key Handling
nopaneltrue


Automatische Updates einrichten (optional)

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


Theme konfigurieren (optional)

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


Bekannte Probleme

siehe Releasenotes 

 

Inhalt

Table of Contents