Files
qt-migration-legatus/qt6-after/qt6-migrated-legatus/Lts/Tests

Lts/Tests Module - Qt6 Migration

This directory contains the migrated Lts/Tests module from the Qt5 legacy codebase.

Overview

The Lts/Tests module provides:

  • Database initialization scripts for PostgreSQL
  • Test data generators for various projects (GUEZ, AHTC, Qatar, L400P2, Demo, ComMaster)
  • Symbol definition files (XML) and SQL generators
  • Test scenario definitions

Important: This module does NOT build any C++ binaries. It only installs files and provides manual targets for database initialization.

Directory Structure

Lts/Tests/
├── CMakeLists.txt                          # Main CMake configuration
├── DatabaseInitialisation/
│   ├── CMakeLists.txt                      # DB init CMake configuration
│   ├── README                              # Legacy documentation
│   ├── README.python3.md                   # Python 3 migration notes
│   ├── create_excon_db.py                  # Main DB creation script (Python 3)
│   ├── *.py                                # Supporting Python scripts
│   ├── *.sql                               # SQL initialization files
│   ├── AhtcSymbols/                        # AHTC symbol definitions
│   ├── ComMasterSymbols/                   # ComMaster symbol definitions
│   └── GuezSymbols/                        # GUEZ symbol definitions
├── Bt56Test/                               # FAT test data
└── Schnoeggersburg/                        # Additional test data

Manual Database Initialization Targets

After building with CMake, the following targets are available:

# Production databases
make db              # Create GUEZ production database
make ahtc-db         # Create AHTC production database
make qatar-db        # Create Qatar production database
make l400p2-db       # Create L400P2 production database
make demo-db         # Create Demo production database
make commaster-db    # Create ComMaster production database

# Test databases (with exercise data)
make test-db         # Create GUEZ test database
make ahtc-test-db    # Create AHTC test database
make qatar-test-db   # Create Qatar test database
make l400p2-test-db  # Create L400P2 test database
make demo-test-db    # Create Demo test database
make commaster-test-db  # Create ComMaster test database

Note: These targets require:

  1. A running PostgreSQL instance
  2. A valid lts-cc.conf configuration file

Using db-manage.sh

The recommended way to manage databases is via the db-manage.sh script:

# Container management
./db-manage.sh start              # Start PostgreSQL container
./db-manage.sh stop               # Stop PostgreSQL container
./db-manage.sh status             # Show container status

# Database initialization
./db-manage.sh init-db guez       # Initialize GUEZ database
./db-manage.sh init-db ahtc       # Initialize AHTC database
./db-manage.sh init-db test-db    # Initialize test database

# Database operations
./db-manage.sh list-dbs           # List all databases
./db-manage.sh psql guez          # Open psql shell
./db-manage.sh backup guez        # Create backup
./db-manage.sh restore guez file  # Restore from backup
./db-manage.sh drop-db guez       # Drop database

Configuration

The lts-cc.conf file contains database connection settings:

[Global]
DatabaseName=lts_ets_pro
DatabaseHostName=legatus-postgresql
DatabasePort=5432
DatabaseUser=postgres
DatabasePassword=postgres

Locations:

  • Build tree: qt6-after/qt6-migrated-legatus/lts-cc.conf
  • Installed: /etc/lts-cc.conf

Python 3 Migration

All Python scripts have been ported from Python 2 to Python 3. See DatabaseInitialisation/README.python3.md for details.

SQL Generation from XML

Symbol definitions are stored as XML files and can be converted to SQL:

# Generate AHTC symbol SQL
make generate-ahtc-symbols

# Generate GUEZ symbol SQL
make guez-generate-symbols

SQL Syntax Validation

Validate SQL files against PostgreSQL syntax:

make validate-guez-symbols
make validate-ahtc-symbols
make validate-qatar-symbols

Note: Requires running PostgreSQL container.

Installation

The module installs files to:

  • share/Lts/tests/ - Test scripts and data
  • share/Lts/tests/DatabaseInitialisation/ - DB initialization files
  • share/Lts/tests/Bt56Test/ - FAT test data
  • share/Lts/tests/Schnoeggersburg/ - Additional test data

DEB Packages

This module is part of the following DEB packages:

  • legatus-qt6-ltscc - Contains /etc/lts-cc.conf
  • legatus-qt6-sv - Server installation
  • legatus-qt6-ws - Workstation installation
  • legatus-qt6-aar - AAR application installation

See ../../../specs/ for package specifications.