Confluence

Vorbereitungen

Es muss ein Postgresql Server ab Version 14 mit folgender Datenbank installiert sein:

  • Database-Name: confluence

  • Database-User: confluence-app

Siehe auch

Sicherstellen, dass im Confluence Data Verzeichnis (default: /opt/atlassian/confluence) genug Platz ist. Wenn man Bilder und Anhänge verwendet, kann das Wiki schnell recht gross werden. Von daher sollte das entsprechende Volume nicht kleiner als 100GB sein.

Installation

Das Installations-Binary kann von https://www.atlassian.com/software/confluence/download-archives heruntergeladen werden.

File executable machen:

chmod +x ./atlassian-confluence-8.2.1-x64.bin

Installer ausführen:

$ ./atlassian-confluence-8.2.1-x64.bin
Installing fontconfig and fonts
Last metadata expiration check: 3:44:47 ago on Thu 11 May 2023 12:11:44 PM CEST.

emacs-filesystem.noarch                                                                                              1:26.1-7.el8_7.1                                                                                                 baseos
python3-psycopg2.x86_64                                                                                              2.9.5-3.rhel8                                                                                                    pgdg-common
Obsoleting Packages
libpq5.x86_64                                                                                                        15.1-42PGDG.rhel8                                                                                                pgdg-common
    libpq.x86_64                                                                                                     13.5-1.el8                                                                                                       @appstream
libpq5.x86_64                                                                                                        15.2-42.1PGDG.rhel8                                                                                              pgdg-common
    libpq.x86_64                                                                                                     13.5-1.el8                                                                                                       @appstream
Last metadata expiration check: 3:44:48 ago on Thu 11 May 2023 12:11:44 PM CEST.
Package fontconfig-2.13.1-4.el8.x86_64 is already installed.
Dependencies resolved.
Nothing to do.
Complete!
Last metadata expiration check: 3:44:49 ago on Thu 11 May 2023 12:11:44 PM CEST.
Package dejavu-sans-fonts-2.35-7.el8.noarch is already installed.
Dependencies resolved.
Nothing to do.
Complete!
Last metadata expiration check: 3:44:50 ago on Thu 11 May 2023 12:11:44 PM CEST.
No match for argument: google-noto-cjk-fonts
Error: Unable to find a match: google-noto-cjk-fonts
Last metadata expiration check: 3:44:51 ago on Thu 11 May 2023 12:11:44 PM CEST.
No match for argument: google-noto-sans-cjk-fonts
Error: Unable to find a match: google-noto-sans-cjk-fonts
Last metadata expiration check: 3:44:52 ago on Thu 11 May 2023 12:11:44 PM CEST.
No match for argument: google-noto-serif-cjk-fonts
Error: Unable to find a match: google-noto-serif-cjk-fonts
Regenerating the font cache
Fonts and fontconfig have been installed
Unpacking JRE ...
Starting Installer ...

This will install Confluence 8.2.1 on your computer.
OK [o, Enter], Cancel [c]

Click Next to continue, or Cancel to exit Setup.

Choose the appropriate installation or upgrade option.
Please choose one of the following:
Express Install (uses default settings) [1],
Custom Install (recommended for advanced users) [2, Enter],
Upgrade an existing Confluence installation [3]


Select the folder where you would like Confluence 8.2.1 to be installed,
then click Next.
Where should Confluence 8.2.1 be installed?
[/opt/atlassian/confluence]


Default location for Confluence data
[/var/atlassian/application-data/confluence]


Configure which ports Confluence will use.
Confluence requires two TCP ports that are not being used by any other
applications on this machine. The HTTP port is where you will access
Confluence through your browser. The Control port is used to Startup and
Shutdown Confluence.
Use default ports (HTTP: 8090, Control: 8000) - Recommended [1, Enter], Set custom value for HTTP and Control ports [2]


Confluence can be run in the background.
You may choose to run Confluence as a service, which means it will start
automatically whenever the computer restarts.
Install Confluence as Service?
Yes [y, Enter], No [n] n


Extracting files ...


Please wait a few moments while we configure Confluence.

Installation of Confluence 8.2.1 is complete
Start Confluence now?
Yes [y, Enter], No [n]


Please wait a few moments while Confluence starts up.
Launching Confluence ...

Installation of Confluence 8.2.1 is complete
Your installation of Confluence 8.2.1 is now ready and can be accessed via
your browser.
Confluence 8.2.1 can be accessed at http://localhost:8090
Finishing installation ...

Der Installer fragt während der Installation, ob Confluence automatisch starten soll:

Confluence can be run in the background.
You may choose to run Confluence as a service, which means it will start
automatically whenever the computer restarts.
Install Confluence as Service?

Ablehnen - es wird später manuell ein Systemd-Service angelegt.

Mit dem Browser http://example.com:8090 aufrufen und fertig einrichten:

  • Trial-Lizenz beziehen

  • non-clustered

  • Database type: PostgreSQL

  • Setup type: Simple

  • Hostname: localhost

  • Port: 5432

  • Database name: confluence

  • Username: confluence-app

Wenn vorhanden anschliessend die Lizenz unter http://example.com:8090/admin/license.action hinzufügen.

Bemerkung

Läuft Confluence erst einmal, wird es in der Standardeinstellung jede Nacht um 02:00 Uhr unter /var/atlassian/application-data/confluence/backups ein Backup in Form eines ZIP-Files anlegen. Möchte man Backups löschen, die z.B. älter als 10 Tage sind, funktioniert das auf Basis von Logrotating nicht, da die Dateinamen der Backup-ZIPs einen Timestamp enthalten. Ein passender cronjob wäre:

00 01 * * * cd /var/atlassian/application-data/confluence/backups; find -name '*zip' -ctime +10 -exec rm {} \;

Reverse Proxy

Confluence muss vom Reverse Proxy wissen, daher im Tomcat den entsprechenden Connector aktivieren: (https://confluence.atlassian.com/confkb/after-upgrading-confluence-you-are-unable-to-create-new-pages-or-spaces-785457379.html)

/opt/atlassian/confluence/conf/server.xml
<Connector port="8090" connectionTimeout="20000" redirectPort="8443"
   maxThreads="200" minSpareThreads="10"
   enableLookups="false" acceptCount="10" debug="0" URIEncoding="UTF-8"
   protocol="org.apache.coyote.http11.Http11NioProtocol"
   proxyName="wiki.linuxfabrik.ch" proxyPort="443" scheme="https" />
setsebool -P httpd_can_network_connect on

Migration

Einen Export sämtlicher Daten auf dem ursprünglichen Confluence erstellen:

  • Gear-Icon oben rechts > General configuration

  • In der Sidebar Backup & Restore

  • Export this site

    • Checkbox Include attachments und Also save a copy to the Backups directory

    • Export

    • Exportierte Datei kann unter /var/atlassian/application-data/confluence/temp/xmlexport-20230530-225905-1.zip gefunden werden

  • Datei auf Zielrechner in den Pfad /var/atlassian/application-data/confluence/restore/ bewegen

Auf dem neuen Confluence den Import starten:

  • Zahnrad oben rechts > General configuration

  • In der Sidebar Backup & Restore

  • Import from the home directory

Built on 2023-09-21