Central Repository Installation

This is the main piece of software which is made of Postgres database and Wildfly application server. Both of those are deployed as docker/podman containers once you finish this chapter.

Pre-Install Recommendations

The following dedicated mount points are not mandatory, but are highly recommended for production environments:

/var/lib/docker, 10GB — used for Docker/Podman images.
/srv/appm, >= 50GB — used to store collected samples. More databases and longer retention periods require more space.
/opt/abakus, 10GB — used only in Enterprise Edition when configuring an external collector.

Installation

Following steps must be executed as user root. All it takes is adding dnf/apt repository and running dnf/apt install command like this:

Debian

wget -O - https://appm.abakus.si/tools/setup-debian-13.sh | bash
apt update && apt full-upgrade
apt install aba-appm-repository

Oracle Linux

wget -O - https://appm.abakus.si/tools/setup-oel-10.sh | bash
dnf update
dnf install aba-appm-repository

Now you can open the browser and access APPM at following url. Default username/password are admin / change_me. Nothe that after install, sometimes it takes a few minues for application server to start and web app to deploy.

https://<HOSTNAME>/appm/

Post-Installation tasks

You should enable log rotating and backup scripts (using crontab -e and then entering the following):

SHELL=/bin/bash
15 * * * *  /srv/appm/utl/logrotate.sh > /srv/appm/vol/hk-log/logrotate-$(date '+%Y-%m-%d').log 2>&1
30 1 * * *  /srv/appm/utl/backup.sh    > /srv/appm/vol/hk-log/backup-$(date '+%Y-%m-%d').log 2>&1

Finding Logs

When things don’t work as expected, you can check log(s) at:

/srv/appm/vol/wf-log/server.log
/srv/appm/vol/pg-log/*

Backup

Backup script /srv/appm/utl/backup.sh assumes that /srv/appm/vol/pg-dbf is a dedicated mountpoint based on LVM LV. It creates backups to /backup/pg-backup. This script can be used as-is or adopted to your specific needs (you may backup PostgreSQL database in any way you want).

Changing SSL Certificate

This is optional because APPM uses self-signed certificate by default.

Certificate and private key files (both in PEM format) are required in order to produce pkcs12 keystore, compatible with default setting of Wildfly. Example:

cd /srv/appm/utl/
./create-keystore.sh /path/to/cert.pem /path/to/private-key.pem

After creating keystore using this procedure, rerun installer using following command:

systemctl stop aba-appm
cd /srv/appm/utl/
./install.sh

This will regenerate docker-compose.yml file, which points to newly created keystore. Alternatively, edit the docker-compose.yml yourself and restart wildfly container. Relevant section of docker-compose.yml:

wildfly:
  ...
  volumes:
     ...
     - '/etc/appm/appm-keystore.p12:/opt/abakus/wildfly/as/standalone/configuration/application.keystore:ro'

Quick helper to generate CSR:

openssl req -new -newkey rsa:4096 -nodes -keyout private.key -out public.csr

Upgrade

First, upgrade APPM software:

Debian

apt update && apt upgrade

Oracle Linux

dnf upgrade

Post-Upgrade

And then go to graphical interface, Repository -> Databases and for each database, click on “Upgrade Schema” to update/recreate Oracle objects under APPM2 schema. See Create / Upgrade Schema chapter for more info.

You should also restart APPM collector after upgrading the database objects.

Start & Stop

All services are running as a set of docker containers and can be started/stopped using systemctl:

systemctl stop aba-appm
systemctl start aba-appm

Keyboard shortcuts

APPM Installation Manual