# Alpha Platform LTS Release Notes - 25.11-21.0.0.0-lts

**URL:** https://community.neutrinos.com/t/alpha-platform-lts-release-notes-25-11-21-0-0-0-lts/1522
**Category:** Product Release Notes
**Tags:** neutrinos-platform, neutrinos-alpha, alpha-release-notes
**Created:** [November 21, 2025, 6:41pm UTC](https://community.neutrinos.com/t/alpha-platform-lts-release-notes-25-11-21-0-0-0-lts/1522 "2025-11-21T18:41:05Z")
**Posts on this page:** 1
**Page:** 1

<div class="post-metadata">

### Author: ![gaurav.pandey](https://community.neutrinos.com/user_avatar/community.neutrinos.com/gaurav.pandey/32/89_2.png) [@gaurav.pandey](https://community.neutrinos.com/u/gaurav.pandey)
#### Post date: [November 21, 2025, 6:41pm UTC](https://community.neutrinos.com/t/alpha-platform-lts-release-notes-25-11-21-0-0-0-lts/1522/1 "2025-11-21T18:41:06Z")

</div>

# Alpha Archival - LTS Release Announcement

**Release Version:** 25.11-21.0.0.0-lts  
**Service Version:** 25.11.0.0.13-87bff8cf7b-lts  
**Release Date:** November 2025  
**Channel:** LTS (Long-Term Support)

* * *

## Introduction

We’re excited to announce the official **LTS release** of **Alpha Archival** – aservice for managing jBPM process data lifecycle with automated backup, restore, and archival capabilities.

## What is Alpha Archival?

Alpha Archival is a archival and recovery API service designed for jBPM-backed process data. It provides comprehensive REST APIs to safely archive, backup, restore, and manage business process data at scale.

## Key Features

### Advanced Process Discovery

- Filter and retrieve process instances
- Paginated queries for efficient data retrieval
- Child process relationship tracking

### Intelligent Backup & Restore

- Automated batch processing (100 processes per batch)
- Audit trail with detailed operation tracking
- Bi-directional data movement between production and backup databases
- SQL script generation for manual backup scenarios

### Data Deletion

- Deletion of archived processes with full audit trails

### Audit Logging

- Track every backup, restore, and delete operation
- Query audit history with flexible filtering and pagination

### Security

- Bearer token authentication via IDS integration
- Secure database connections with SSL/TLS support
- Separate credentials for production and backup databases
- Optional CA certificate support for enhanced security

## Installation (LTS Channel)

### Deploy via Helm

```bash
helm install archival-release ./alpha-archival \
  --namespace <your-namespace> \
  --values ./alpha-archival/values.yaml

```

### Configuration

Update `values.yaml` with your environment-specific settings:

```yaml
image:
  repository: neutrinos.azurecr.io/alpha/alpha-archival
  tag: "25.11.0.0.13-87bff8cf7b-lts"
  pullPolicy: Always

env:
  # Primary Database
  DB_HOST: your-primary-db.postgres.database.azure.com
  DB_PORT: "5432"
  DB_USERNAME: pgusername
  DB_PASSWORD: pgpassword
  DB_SSL: "true"
  BPM_DB_NAME: WORKFLOW_DB
  BPM_DB_SCHEMA_NAME: public
  
  # Backup/Archive Database (must be different from primary)
  BPM_BACKUP_DB_HOST: your-backup-db.postgres.database.azure.com
  BPM_BACKUP_DB_PORT: "5432"
  BPM_BACKUP_DB_NAME: WORKFLOW_BACKUP_DB
  BPM_BACKUP_DB_USERNAME: pgusername
  BPM_BACKUP_DB_PASSWORD: pgpassword
  BPM_BACKUP_DB_SSL: "true"
  BPM_BACKUP_DB_SCHEMA_NAME: public
  
  # Authentication (IDS)
  IDS_URL: https://your-ids-server.com
  IDS_CLIENT_ID: your-client-id
  IDS_CLIENT_SECRET: your-client-secret
  IDS_ENABLE: "true"
  
  # Alpha Auth Service
  ALPHA_AUTH_SERVICE_URL: https://your-domain.com/authservice
  
  # Optional
  ENABLE_SWAGGER: "true"

```

> **CRITICAL:** Primary and backup databases must use different host/port/database combinations to prevent data conflicts.

Full API documentation available at: `https://<your-domain>/archivalservice/api-docs`

## Environment Variables Reference

| Variable | Description | Required |
| --- | --- | --- |
| `DB_HOST` | Primary database hostname | Yes |
| `DB_PORT` | Primary database port | Yes |
| `DB_USERNAME` | Primary database username | Yes |
| `DB_PASSWORD` | Primary database password | Yes |
| `DB_SSL` | Enable SSL for primary DB | No |
| `DB_CA_CERT_PATH` | Path to CA cert for primary DB | No |
| `DB_CA_CERT` | CA cert content for primary DB | No |
| `BPM_DB_NAME` | Primary BPM database name | Yes |
| `BPM_DB_SCHEMA_NAME` | Primary database schema | Yes |
| `BPM_DB_LOGGING` | Logging levels for DB queries | No |
| `BPM_BACKUP_DB_HOST` | Backup database hostname | Yes |
| `BPM_BACKUP_DB_PORT` | Backup database port | Yes |
| `BPM_BACKUP_DB_NAME` | Backup database name | Yes |
| `BPM_BACKUP_DB_USERNAME` | Backup database username | Yes |
| `BPM_BACKUP_DB_PASSWORD` | Backup database password | Yes |
| `BPM_BACKUP_DB_SSL` | Enable SSL for backup DB | No |
| `BPM_BACKUP_DB_CA_CERT_PATH` | Path to CA cert for backup DB | No |
| `BPM_BACKUP_DB_CA_CERT` | CA cert content for backup DB | No |
| `BPM_BACKUP_DB_SCHEMA_NAME` | Backup database schema | Yes |
| `BPM_BACKUP_DB_LOGGING` | Logging levels for backup DB | No |
| `IDS_URL` | IDS authentication server URL | Yes |
| `IDS_CLIENT_ID` | IDS client credentials ID | Yes |
| `IDS_CLIENT_SECRET` | IDS client credentials secret | Yes |
| `IDS_ENABLE` | Enable IDS authentication | Yes |
| `ALPHA_AUTH_SERVICE_URL` | Auth service base URL | Yes |
| `ENABLE_SWAGGER` | Enable API documentation | No |

## Verification

After deployment, verify the service is running:

```bash
# Check pod status
kubectl get pods -n <your-namespace> | grep archival

# Check service health
curl https://<your-domain>/archivalservice/ping

# Expected response:
# {
# "status": "ok",
# "timestamp": "2025-11-21T16:40:18.423Z"
# }

# Access Swagger UI (if enabled)
https://<your-domain>/archivalservice/api-docs

```

## Common Use Cases

1. **Archive Completed Workflows**

2. **Compliance & Auditing**

3. **Data Recovery**

4. **Database Maintenance**

## Important Notes

- **Single Instance Only** : Run only one instance of alpha-archival at a time to prevent concurrent backup/restore conflicts
- **Database Separation** : Primary and backup databases must be completely separate instances
- **Authentication** : Requires valid IDS bearer token for all API calls
- **Batch Size** : Default batch size is 100 processes; this is optimized for performance and reliability

## Support & Documentation

- **LTS Release Notes** : [🔗 041 - 25.11-21.0.0.0-lts.md](https://bitbucket.org/bhivedevs/alpha-helm-charts/src/lts/release/041%20-%2025.11-21.0.0.0-lts.md)
- **API Documentation** : Available at `/archivalservice/api-docs` (when Swagger is enabled)
- **Image Repository** : `neutrinos.azurecr.io/alpha/alpha-archival`
- **Image Tag** : `25.11.0.0.13-87bff8cf7b-lts`

## What’s Next?

**Current Channel Release** : Coming Soon

The alpha-archival service will be available in the Current channel via Trinity deployment in an upcoming release. Stay tuned for the Current channel announcement!

* * *

**Need Help?**

For questions, issues, or feedback, please contact the Alpha platform team.

**Happy Archiving!**
