FileGPS 6.3.3.1 Release Notes 

🔍 Release Overview ​

This release introduces IANN FileGPS version 6.3.3.1, delivering a more standardized, stable, secure, and feature-rich experience. Building on the core capabilities of earlier versions, this update includes key enhancements in alerting, performance, security, and integration flexibility. 

🔄 Upgrade Impact Summary – IANN FileGPS v6.3.3.1 ​

Upgrading to version 6.3.3.1 introduces several functional changes. While most features are backward compatible, certain enhancements may require configuration validation and testing to ensure a smooth transition and full utilization of new capabilities. 

🔧 Infrastructure-Level Impact ​

Area Impact 
Tomcat Upgrade   (9.0.82 → 10.1.36) May require revalidation of connectors and TLS configurations. Ensure compatibility with OS-level dependencies and service wrappers. 
Datasource Password Resolution New flexible resolution order: Command line → Env variable → YML file. Update your deployment scripts or environment variables accordingly. 
 

⚙️Configuration Impact​

Feature Impact & Required Action 
Favicon Configuration New optional property favicon: true/false. The default is true. No change needed unless customization is required. 

🆕 What’s New ​

1. External Favicon Configuration Support

Summary: 
A new configuration property has been introduced to control favicon (browser tab icon) behavior. This enhancement allows teams to customize the favicon or disable it entirely based on deployment needs. 

Configuration Details: 

 

Application.yml 

 

filegps: 

   favicon: true # default is true 

 

  • When favicon: true (default): 
    The application will load a favicon from an external path (outside the JAR) if present. 

  • You can override the default icon by placing a custom favicon in a designated directory name icon with the following specs: 

  • 📏 Resolution: 32×32 pixels 

  • 🧾 MIME Type: image/x-icon 

  • 📁 File Extension: .ico 

  • 📦 Recommended Size: ≤ 5.55 KB 

  • 🎨 Bit Depth: 32-bit 

  • When favicon: false: 
    The application will not load any favicon, resulting in no icon being shown in the browser tab. 

Use Case: 

  • Enables branding flexibility by allowing deployments to use custom favicons without modifying the application JAR. 

  • Suitable for white-labeled environments or minimal UI setups. 

Impact: 

  • Backward compatible. 

  • Default behavior remains unchanged (true). 

2. Maintenance Window for Alerts

The Maintenance Window for Alerts feature allows administrators to define specific time periods during which alerts are temporarily suppressed across various modules, including: 

  • FNR (File Not Received) 
  • TNR (Transaction Not Received) 
  • SLA  
  • Subscription  
  • Agent Down 

This ensures that planned maintenance activities such as system updates, batch process reruns, or network-level changes do not trigger false or unnecessary alerts, thereby avoiding alert fatigue and maintaining clarity for operational teams. 

3. Retention Policy with Purge Option

The Retention Policy with Purge Option introduces advanced data lifecycle management capabilities, enabling organizations to control how long operational and transactional data is retained within the IANN FileGPS system. In addition to scheduled purging of outdated data, the system now supports archiving purged records into a secondary storage table (either within the same or a different database), helping meet regulatory, compliance, and audit requirements. 

Benefits Summary 

Reduces database size and improves system efficiency. 

Ensures compliance with enterprise data retention and deletion policies. 

Provides a secure fallback mechanism for recovering purged records. 

Enhances audit and traceability controls without retaining stale data in operational workflows. 

4. File Not Received (FNR) Alert with Count Conditions

The File Not Received (FNR) Alert is a critical monitoring mechanism in IANN FileGPS that detects and notifies when expected files are not received within a configured time window or frequency. This ensures early identification of data transfer issues, system integration failures, or upstream processing delays. 

  • The latest enhancement introduces Count-Based Conditions, allowing administrators to configure quantitative thresholds for triggering alerts based on the actual file count vs. the expected file count. 
  • Configure alerts based on file count logic: 
    • Less Than – Alert if file count ≥ expected count. 
    • Less Than or Equal To – Alert if file count > expected count. 
    • Equal To – Alert if file count ≠ expected count. 
    • Greater Than – Alert if file count ≤ expected count. 
    • Greater Than or Equal To – Alert if file count < expected count. 

5. Multi-File Pattern Support for FNR Alerts

  • In earlier versions of IANN FileGPS, File Not Received (FNR) alerts were restricted to monitoring a single file pattern per alert configuration. This posed limitations for systems that expected multiple files with different naming conventions or formats as part of a single business transaction or batch cycle. 
  • With version 6.3.3.1, this restriction is removed. Users can now define and monitor multiple file patterns within a single FNR alert rule, significantly enhancing flexibility and simplifying alert management. 

6. Transaction Not Received (TNR) Alert with Count Conditions

  • The Transaction Not Received (TNR) alert is designed to notify users when a specific number of expected transactions are not received within a defined time window. This is critical for detecting failures or delays in business-critical transaction flows, such as purchase orders, payments, invoices, or API-based data integrations. 
  • The latest enhancement introduces count-based logic, allowing alerts to be raised based on a comparison of actual vs. expected transaction counts using customizable thresholds. 
  • Configure alerts based on file count logic: 
    • Less Than – Alert if file count ≥ expected count. 
    • Less Than or Equal To – Alert if file count > expected count. 
    • Equal To – Alert if file count ≠ expected count. 
    • Greater Than – Alert if file count ≤ expected count. 
    • Greater Than or Equal To – Alert if file count < expected count. 

7. Agent Down Alert Enhancements

  • Overview: Enhanced the Agent Down Alert functionality to improve flexibility, reduce false alerts during planned downtime, and enable programmatic management. 
  • Configurable Email Subject & Body: 
    • Users can now define custom email subjects and body templates for Agent Down Alerts. 
    • Helps improve clarity and align alerting with organizational communication styles. 
  • Maintenance Window Support: 
    • Allows suppression of alerts during scheduled maintenance of windows. 
    • Prevents unnecessary notifications during expected downtimes. 
  • REST API Capabilities: 
    • Added APIs to create, update, delete, and retrieve Agent Down Alert configurations. 
    • Enables external systems and automation tools to manage alert settings programmatically. 

⚙️Enhancements / Improvements​

1. Tomcat Version Upgrade:

  • As part of the IANN FileGPS v6.3.3.1 release, the embedded web server component has been upgraded from Apache Tomcat 9.0.82 to 10.1.36. This upgrade delivers significant improvements in security, compatibility, performance, and long-term maintainability, aligning the product with modern enterprise application standards. 
  • Directory traversal attacksResolved multiple known vulnerabilities (CVEs) present in Tomcat 9.x, including issues related to:
    • HTTP/2 header parsing 
    • Session fixation
  • Enhanced TLS/SSL support, including better defaults for secure ciphers and protocols (e.g., TLS 1.3). 
  • Strengthens the platform’s compliance posture for standards like SOC2, ISO 27001, HIPAA, and GDPR. 

2. Rest Consumer changes

  • Rest Consumer is a component designed to interact with RESTful web services, enabling efficient communication and data exchange between systems. It acts as a client that sends requests to REST APIs and processes the responses, facilitating integration with various web services. 
  • Features of Rest Consumer: 
    • Basic Authentication: Supports basic authentication to ensure secure access to REST APIs, protecting sensitive data during communication. 
    • SSL Integration: Implements SSL (Secure Sockets Layer) to encrypt data transmitted between the client and server, enhancing security and preventing unauthorized access. 
    • Flexible Configuration: Allows customization of request headers, parameters, and payloads to meet specific integration requirements. 
    • Error Handling: Provides robust error handling mechanisms to manage and respond to various HTTP status codes and exceptions.

3. Alert Name Text Limit Changes

  • Extended Text Limit: The alert name text limit has been increased from 100 characters to 200 characters. 
  • Enhanced Flexibility: This change allows for more descriptive and detailed alert names, improving clarity and usability.log

4. Extended Alert Time Windows

  • Extended Time Window: The configurable time window for FNR (File Not Received) and TNR (Transaction Not Received) alerts has been extended from 15 minutes to 30 minutes. 
  • Flexible Configuration: Users can now set the alert window to either 15 minutes or 30 minutes, providing greater flexibility in monitoring and alerting. 

5. Enhanced SNOW Integration

  • Enhanced Integration: SNOW integration with FileGPS has been improved to support seamless API integration. 
  • Customizable Alert Parameters: Users can now add SNOW-supported API details directly to the FileGPS alert creation body using the $ symbol followed by key=value. 
  • Simplified Configuration: This enhancement allows for easier customization of alert parameters, streamlining the integration process. 

6. Improved Alert Traceability

The Improved Alert Traceability feature enhances the visibility, auditability, and diagnostics of alerts triggered within the FileGPS platform. In this release, alert records are enriched with comprehensive metadata, making it easier for users, administrators, and support teams to: 

  • Understand the context and flow of alerts 
  • Perform root cause analysis 
  • Audit incident notification chains 
  • Troubleshoot integration issues with downstream systems (like SNOW or external APIs)  

What’s Included in the Enhanced Alert Details 

When an alert (such as FNR, TNR, SLA breach, Agent Down, etc.) is triggered, the system now captures and displays the following details on the UI and in alert logs: 

Field Description 
Email Subject The actual subject line sent in alert email notifications. 
Email Body The complete body content of the email sent, including dynamic parameters like file name, alert time, etc. 
API URL / Endpoint The URL of the external system endpoint (e.g., SNOW API, webhook) where the alert was posted. 
Incident Service Used The integration service responsible for triggering incidents (e.g., SNOW, Webhook, PagerDuty). 
Response Code The HTTP status code received from the API call (e.g., 200 OK, 500 Internal Server Error). 
Response Message The message returned by the external system (e.g., Incident Created, Authentication Failed). 
Request Payload The exact JSON or XML payload sent to the external system, including parameters like incident title, description, timestamp, priority, etc. 

7. Flexible Database Password Configuration

Summary: The application now supports reading the encrypted datasource password (spring.datasource.fgks) from multiple sources, improving flexibility in deployment and environment configuration. 

  • Previously, the password was read only from the JVM command-line (-Dspring.datasource.fgks). 
  • Now, the password is resolved in the following order: 
    • JVM Command Line (-Dspring.datasource.fgks) 
    • Environment Variable (SPRING_DATASOURCE_FGKS) 
    • application.yml / application.properties 

8. Debug Logging Support

  • The Debug Logging Support enhancement introduced in IANN FileGPS v6.3.3.1 provides fine-grained, module-level debug logging capabilities to assist developers, DevOps teams, and administrators in faster diagnosis, issue tracing, and root cause analysis during integration, testing, or production support activities. 
  • This feature helps expose internal runtime behaviours, API flows, data processing steps, and error propagation chains without requiring code changes or server restarts. 
  • Updated the Backend jobs to rotate based on the time instead of size. 

🐞 Bug Fixes ​

  • In IANN FileGPS v6.3.3.1, we have implemented a comprehensive round of security upgrades focused on mitigating known vulnerabilities, enhancing encryption practices, and aligning the platform with enterprise security compliance standards such as SOC2, ISO 27001, GDPR, and internal cybersecurity policies. 
  • These updates primarily involved the upgrade of third-party libraries, patching CVEs (Common Vulnerabilities and Exposures), and strengthening configuration defaults to improve the overall security posture of the product. 

    Key Enhancements & Fixes 

    • Updated core libraries and dependencies used across FileGPS modules 
    • Addressed and resolved a set of known CVEs flagged by OWASP, Snyk, and internal tools 
    • Improved Configuration Security Defaults: Hardened default security settings in application.yml and startup scripts. 
    • Token & Secret Handling: Refined handling of sensitive credentials (e.g., API keys, DB passwords) 

✅ Backward Compatibility ​

Most changes are non-breaking and backward compatible. Default behaviors are preserved unless explicitly overridden in configuration. However, validation and reconfiguration are recommended to fully leverage new features and avoid misconfigurations. 

 

📩 Support & Contact Information 

For any questions, clarifications, or further discussions related to this release, please reach out to the Pragma Support Team: 

 

  • 📧 Email: techsupport@pragmaedge.com