AdminGloves SSPR— Windows Installation

Windows Installation Walkthrough Video

We recommend watching the Windows installation walkthrough video on YouTube before starting the installation steps:

Watch on YouTube: https://youtu.be/lD1qfVTfzNc
1. Download & Run the Installer

The new AdminGloves SSPR installer is a single .exe wizard — no manual setup of Java, MariaDB, or WildFly is required beforehand. The installer downloads and configures everything for you.

  1. Download AdminGloves SSPR Solution.exe from your customer portal or the link provided in your welcome email.
  2. Right-click the file and choose Run as Administrator. This is required — the installer configures system-level services and environment variables.
  3. If Windows SmartScreen appears, click More info → Run anyway.
2. Accept the License Agreement (EULA)

The first screen displays the End User License Agreement. Read through the terms and click I Accept to continue. The installer will not proceed until the EULA is accepted.

3. Choose Installation Mode

The Welcome screen presents three options. Select the one that matches your situation:

  • ↓ Full InstallationRecommended for most users.
    The installer automatically downloads and installs Java JDK 21, MariaDB 11.8, and WildFly 38. No pre-existing software required.
  • ◫ Manual Installation — Choose this if Java, MariaDB, and WildFly are already installed on your machine. You will be asked to point to their existing locations.
  • ⚙ Manage & Configure — Use this after installation to update credentials, licenses, LDAP settings, and more.

Click Continue → after making your selection.

4. Select Components (Full Installation only)

If you chose Full Installation, the next screen lets you choose which components to download and install:

  • Java JDK 21 — Required runtime environment.
  • MariaDB 11.8 — Database server for application data.
  • WildFly 38 — Jakarta EE application server. Required — do not uncheck unless WildFly is already installed.

All three are checked by default. Uncheck only if you already have that component installed — a warning will appear reminding you that the existing installation must be detectable. Click Continue →.

5. Install Location

Specify where AdminGloves SSPR should be installed. The default root is C:\ and the installer will create its own subfolder automatically.

If you are using Manual Installation, this screen also asks you to browse to your existing Java, MariaDB, and WildFly installation folders. Use the Browse buttons to locate each one. The installer validates each path before allowing you to proceed.

Click Continue → once the paths are confirmed.

6. Database Setup

Enter the database connection details the application will use:

  • MariaDB Root Password — The root password for your MariaDB instance (used to create the application database).
  • JDBC URL — Defaults to jdbc:mariadb://localhost:3306/AdminGlovesDB. Change only if your database is on a different host or port.
  • App DB Password — The password the application will use to connect to its own database schema.

The installer creates the AdminGlovesDB database and configures the data source automatically. Click Continue →.

7. LDAP / Active Directory Configuration

Configure the connection to your Active Directory or LDAP server so users can authenticate for self-service password reset:

  • LDAP Server — The installer auto-detects available domain controllers on your network and populates a drop-down list. Select your server or type its hostname/IP manually.
  • LDAP Username — A service account with read access to the directory (e.g. svc-admingloves@yourdomain.com).
  • LDAP Password — Password for the service account above.

The installer tests the connection and shows a status indicator. If your environment uses LDAPS (port 636), you can also browse for and import the SSL certificate into the Java trust store from this screen.

Click Continue →.

8. Encryption Key (AES)

The application uses AES encryption to protect sensitive data at rest. On this screen, either:

  • Enter your own AES key (if you have one from a previous installation or your security team), or
  • Leave the field blank and the installer will generate a secure key automatically.
⚠ Important: Copy and store your AES key in a safe location (e.g. a password manager). You will need it if you ever migrate or restore the application. It cannot be recovered after installation.

Click Continue → to begin installation.

9. Installation Progress

The installer now runs automatically through all phases. A progress bar and live log track each stage:

  • Downloading components (Java, MariaDB, WildFly) — if selected
  • Installing and configuring each component
  • Setting up environment variables
  • Configuring the database and LDAP connection
  • Copying AdminGloves application files

This step runs fully automatically. Do not close the installer window. Installation typically takes 5–15 minutes depending on your internet speed.

Click Show log at any time to see the detailed install log.

10. Deploy & Launch

When installation completes, the Finished screen shows a checklist of every step with a ✓ or ✗ status. If everything succeeded:

  1. Click the Deploy Application button. This deploys the AdminGloves WAR file to WildFly and starts the service.
  2. Once deployed, click Open in Browser — the installer will launch your default browser to http://localhost:8080 where the application is running.
  3. Click Copy URL if you need to share the address with your team.
🔒 HTTPS / SSL: For production use over HTTPS, configure a reverse proxy (IIS or Nginx) pointing to http://localhost:8080, or go to Main Menu → Manage & Configure → Configure SSL Certificate to import your certificate.

You can close the installer once the application is running. To return to the main menu at any time (e.g. to update credentials or licenses), re-run AdminGloves SSPR Solution.exe and choose Manage & Configure.

11. Post-Installation — Manage & Configure

Re-run AdminGloves SSPR Solution.exe at any time and choose ⚙ Manage & Configure from the Welcome screen to access these options:

  • Update AES Encryption Key — Replace the application encryption key.
  • Update LDAP Settings — Change LDAP server, credentials, or certificate.
  • Update Database Credentials — Update the application's DB username/password.
  • Update License — Replace license.aglic and refresh.txt when your license is renewed.
💡 Tip: Always securely store your AES key, database credentials, and LDAP service account details. These are needed for future updates and migrations.
12. Troubleshooting
  • Installer won't start — Ensure you right-clicked and chose Run as Administrator.
  • Download fails during installation — Check your internet connection. The installer downloads Java, MariaDB, and WildFly from their official sources.
  • LDAP connection fails — Verify the service account credentials and ensure the domain controller is reachable from this machine. For LDAPS, confirm the certificate is valid.
  • Application not accessible after deploy — Ensure WildFly started successfully. Check the log at C:\wildfly\standalone\log\server.log.
  • Deployment failed on Finished screen — Click the Deploy Application button again to retry. Check setup.log in the same folder as the installer for details.