Windows

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/61vWrGvq1EE
1. Prerequisites

Required before installation:

Verify Prerequisites:
# Verify Java java -version # Verify MySQL/MariaDB mysql --version # Verify WildFly exists Test-Path "C:\WildFly\bin\standalone.bat"
2. Pre-Installation Setup

2.1 Prepare Installer Folder

Extract the AdminGloves Windows installer ZIP to a permanent folder (for example C:\AdminGloves-Installer).

Inside that folder you should see at least these sub‑folders/files (do not rename them):

  • Programdata\AdminGloves
  • Wildfly-Files
  • Scripts
  • Install-AdminGloves-CLI.ps1

2.2 Prepare License Files

You'll receive license files via email. Create a folder and copy them there (this path will be asked during installation):

New-Item -ItemType Directory -Path "C:\AdminGloves\License" -Force

Place both license.aglic and refresh.txt inside this folder.

2.3 Setup Database

Run the included SQL script to create the database:

# Login to MySQL/MariaDB mysql -u root -p # Run the script source C:\path\to\database.sql;
3. Installation

Step 1: Open Windows PowerShell as Administrator.

Step 2: Go to the installer folder and start the CLI installer:

cd C:\AdminGloves-Installer .\Install-AdminGloves-CLI.ps1

Step 3: In the main menu, type 1 and press Enter to choose Full Installation.

Step 4: When prompted, provide or confirm:

  • WildFly Installation Path (for example C:\wildfly)
  • Java Installation Path (for example C:\Program Files\Java\jdk-21)
  • MySQL Installation Path (root folder where MySQL/MariaDB is installed)
  • License Files Path (the folder containing license.aglic and refresh.txt)

The installer validates these paths, copies all required files, sets environment variables, and then asks if you want to configure:

  • Database credentials (JDBC URL, username, password)
  • LDAP/LDAPS connection details
  • LDAPS certificate import into Java trust store
  • AES encryption key (used to protect sensitive data)

You can answer yes/no to each step. Any step you skip can be configured later by re‑running the script and choosing the appropriate menu option.

Step 5: After the installer shows Installation Succeeded, deploy the application to WildFly:

cd C:\wildfly\bin .\deploy-wildfly.bat

Step 6: Access the application:

  • Application: http://localhost:8080
  • Admin Console: http://localhost:9990
4. Post-Installation / Configuration

If you skipped any configuration during the first run, you can safely re‑run the installer script and choose a specific menu option instead of Full Installation.

  • Run: cd C:\AdminGloves-Installer then .\Install-AdminGloves-CLI.ps1
  • From the menu choose:
    • 2 – Only AES Key Update
    • 3 – Only LDAP Configuration Update
    • 4 – Only Database Credentials Update
    • 5 – Only License Files Update
    • 6 – Only LDAPS Certificate Update
    • 7 – Change Java Location
    • 8 – Change WildFly Location
  • Always store the AES key, database credentials, and LDAP service account details in a secure location.
5. Troubleshooting (common)
  • Java not found — verify java -version, set JAVA_HOME.
  • MySQL — check Services or run: Get-Service -Name 'MySQL*'.
  • WildFly — ensure bin/standalone.bat exists.
  • Check logs: install.log and C:\wildfly\standalone\log\server.log.
6. Quick Reference
# Install cd C:\AdminGloves-Installer .\Install-AdminGloves-CLI.ps1 # choose option 1: Full Installation # Deploy cd C:\wildfly\bin .\deploy-wildfly.bat