AdminGloves SSPR— Linux Installation

1. Java 21+
   # Ubuntu/Debian sudo apt update sudo apt install openjdk-21-jdk # RHEL/CentOS (example) sudo yum install java-21-openjdk-devel # Verify java -version
2. MySQL / MariaDB — install and enable service.
3. WildFly — download + extract to /opt/wildfly.
4. Optional: license.aglic, refresh.txt.

Before You Start

Important: If you plan to use the database.sql script during installation:

1. Locate database.sql in the installer directory.
2. You must edit it before installation to set the password for the admingloves_app user.
3. Find the line: CREATE USER IF NOT EXISTS 'admingloves_app'@'%' IDENTIFIED BY 'CHANGE_ME_PASSWORD';
4. Replace CHANGE_ME_PASSWORD with your desired password.
5. Save the file. The installer will not proceed until you confirm you've edited this file.
6. During installation, when prompted for database credentials, use the same username (admingloves_app) and password you set in database.sql.

Step 1: Unpack the Installer

Step 2: Run the Installer

Note: Always use bash to run the installer, not sh, as the script requires bash-specific features.

Step 3: Choose Installation Mode

The installer offers two modes:

Option 1: Full Installation (Auto)

Select 1. Full Installation (Auto - installs Java, MariaDB, WildFly)

This mode will:

• Automatically detect your Linux distribution (Debian/Ubuntu or RHEL-family)
• Install OpenJDK 21 from your distribution's package repository
• Install MariaDB server and client and start the service
• Download and install WildFly 38 to /opt/wildfly
• Ask for your license files path
• Optionally run database.sql (if you edited it first)
• Guide you through configuring database credentials, LDAP, AES key, and optionally LDAPS certificate

Note: This mode requires root privileges and will install system packages. Supported distributions: Debian, Ubuntu, RHEL, CentOS, Rocky Linux, AlmaLinux, Oracle Linux.

Option 2: Full Installation (Manual)

Select 2. Full Installation (Manual - prerequisites already installed)

Use this mode if you have already installed Java 21, MariaDB/MySQL, and WildFly manually. The installer will:

• Ask you to provide paths to Java, WildFly, and MySQL/MariaDB
• Validate that all prerequisites are present
• Ask for your license files path
• Optionally run database.sql (if you edited it first)
• Guide you through configuring database credentials, LDAP, AES key, and optionally LDAPS certificate

Step 4: Database Setup

During installation, the installer will ask if you want to run database.sql (defaults to yes):

• You must confirm you've edited the file - The installer will loop until you answer "yes" to confirm you've edited database.sql to set the password.
• MariaDB root password:
  • If you have a root password, enter it when prompted.
  • If you don't have a root password set, leave it blank and press Enter. The installer will automatically use sudo mysql -u root to connect.
• The script will create the database (AdminGlovesDB) and user (admingloves_app) as defined in database.sql.
• When prompted for database credentials later, use:
  • Database name: AdminGlovesDB
  • Username: admingloves_app
  • Password: The password you set in database.sql
  • JDBC URL: jdbc:mariadb://localhost:3306/AdminGlovesDB? or jdbc:mysql://localhost:3306/AdminGlovesDB?

Step 5: Configure Credentials

The installer will ask if you want to configure (you can skip any step and do it later):

• Database credentials — JDBC URL, username, password
  • Standard values: Database AdminGlovesDB, Username admingloves_app
  • Sample JDBC URLs: jdbc:mysql://localhost:3306/AdminGlovesDB? or jdbc:mariadb://localhost:3306/AdminGlovesDB?
  • Use the password you set in database.sql
• LDAP/LDAPS connection details — LDAPS address, base DN, service account credentials
  • Use the FQDN you added to /etc/hosts (e.g., ldaps://sspr-test-002.admingloves.com:636)
  • If the hostname doesn't resolve, use the IP address directly (e.g., ldaps://172.17.0.4:636)
• AES encryption key — can be auto-generated (recommended) or you can provide your own
• LDAPS certificate import (optional but recommended) — provide the path to your exported AD/LDAPS CA certificate file (.cer, .crt, or .pem) to import into Java's cacerts trust store. This is required if Java doesn't trust your LDAPS server's certificate.

Step 6: Deploy the Application

After installation completes, deploy to WildFly:

Step 7: Start WildFly Service (if configured)

You can re-run the installer anytime to update individual components without reinstalling everything:

• 3 – Only AES Key Update
• 4 – Only LDAP Configuration Update
• 5 – Only Database Credentials Update
• 6 – Only License Files Update
• 7 – Only LDAPS Certificate Update (imports your CA certificate into Java trust store)
• 8 – Change Java Location
• 9 – Change WildFly Location

Important: Store all secrets (AES key, database credentials, LDAP service account details) in a secure location (vault, encrypted file, etc.).

• Java not found — run java -version.
• MySQL/MariaDB service — sudo systemctl status mysql or sudo systemctl status mariadb.
• WildFly — ensure bin/standalone.sh exists and is executable.
• LDAP connection errors — If you see javax.naming.CommunicationException:
  • Verify LDAP server hostname resolves: ping your-ldap-server.admingloves.com
  • If hostname doesn't resolve, add it to /etc/hosts (see "Before You Start" section)
  • Import LDAPS certificate using installer menu option 7
  • Test connectivity: telnet your-ldap-server.admingloves.com 636
• Database connection errors — Verify:
  • Database exists: mysql -u root -p -e "SHOW DATABASES LIKE 'AdminGlovesDB';"
  • User exists: mysql -u root -p -e "SELECT User, Host FROM mysql.user WHERE User='admingloves_app';"
  • Credentials match what you set in database.sql
• Menu not visible — Always run with bash: sudo bash install-admingloves-New.sh
• Logs: check /opt/wildfly/standalone/log/server.log, /opt/wildfly/AdminGloves/Logs/admingloves-*.log, and install.log.

Auto Installation (Recommended)

Manual Installation