BAR (Backup and Restore) Tools

November 11, 2025 ยท View on GitHub

AI Agent Integration with DSA Architecture

flowchart TD
    %% AI Agent Layer
    User[๐Ÿ‘ค User] --> LLM[๐Ÿค– AI Agent] --> Output[๐Ÿ“„ Output]
    
    %% MCP Integration
    LLM --> MCP[๐Ÿ”Œ MCP Server]
    MCP --> API[๐ŸŒ DSA API]
    API --> DSC[๐ŸŽ›๏ธ DSC]
    
    %% DSA Infrastructure
    DSC --> DSMain[๐Ÿ“Š DSMain]
    DSC --> BarNC[๐Ÿ“ฆ BarNC]
    
    %% Data Flow
    DB[(๐Ÿ—„๏ธ Database)] <--> DSMain
    DSMain <--> BarNC
    BarNC --> Storage{๐Ÿ’พ Storage}
    
    %% Storage Options
    Storage --> Disk[๐Ÿ“ Disk]
    Storage --> Cloud[โ˜๏ธ Cloud]
    Storage --> Enterprise[๐Ÿ”’ Enterprise]
    
    %% Styling
    classDef primary fill:#e3f2fd,stroke:#1976d2
    classDef secondary fill:#f3e5f5,stroke:#7b1fa2
    classDef storage fill:#e8f5e8,stroke:#388e3c
    
    class User,LLM,Output primary
    class MCP,API,DSC secondary
    class DSMain,BarNC,DB,Storage,Disk,Cloud,Enterprise storage

Prerequisites

DSA Infrastructure must be properly configured and running before using BAR tools

Environment Variables

The BAR tools require the following environment variables for DSA connection:

  • DSA_BASE_URL - Base URL for DSA API (default: https://localhost:9090/)
  • DSA_USERNAME - Username for DSA authentication (default: admin)
  • DSA_PASSWORD - Password for DSA authentication (default: admin)
  • DSA_VERIFY_SSL - Whether to verify SSL certificates (default: true)
  • DSA_CONNECTION_TIMEOUT - Request timeout in seconds (default: 30)

BAR Profile Configuration

The BAR profile is defined in config/profiles.yml and controls access to BAR-related tools and resources.

Profile Configuration:

bar:
  tool:
    - ^bar_*          # All BAR tools (bar_manageDsaDiskFileSystem, etc.)
    - ^base_readQuery$  # Read-only database queries
    - ^base_databaseList$  # Database listing
  prompt:
    - ^bar_*          # BAR-specific prompts
  resource:
    - ^bar_*          # BAR-specific resources

What the BAR profile enables:

  • Access to all bar_* tools for backup and restore operations
  • Basic database read operations for backup source identification
  • Database listing capabilities for backup planning
  • BAR-specific prompts and resources

Usage: Specify --profile bar when running MCP server to enable BAR-specific functionality.

Available Tools

Total Estimated Tools: 16 (5 โœ… Developed, 11 ๐Ÿšง Planned)

Storage Configuration Tools

bar_manageDsaDiskFileSystem โœ…

Status: Developed Unified tool for managing DSA disk file system configurations for backup storage.

bar_manageAwsS3 ๐Ÿšง

Status: Work-In-Progress Tool for managing AWS S3 bucket configurations for backup storage.

bar_manageAzureBlob ๐Ÿšง

Status: Planned Tool for managing Azure Blob Storage configurations for backup storage.

bar_manageGoogleCloud ๐Ÿšง

Status: Planned Tool for managing Google Cloud Storage configurations for backup storage.

bar_manageNetBackup ๐Ÿšง

Status: Planned Tool for managing NetBackup configurations for enterprise backup storage.

bar_manageIbmSpectrum ๐Ÿšง

Status: Planned Tool for managing IBM Spectrum Protect configurations for backup storage.

Infrastructure Management Tools

bar_manageMediaServer โœ…

Status: Implemented Tool for managing media server configurations including list, get, add, delete, and consumer management operations.

bar_manageTeradataSystem โœ…

Status: Implemented Tool for managing Teradata system configurations and consumers in DSA. Supports listing systems, getting system details, configuring new systems, enabling/deleting systems, and managing system consumers.

Target Group Management Tools

bar_manageDiskFileTargetGroup โœ…

Status: Implemented Tool for managing disk file target group configurations with comprehensive management of backup target groups including create, list, get, enable, disable, and delete operations.

bar_manageAwsS3TargetGroup ๐Ÿšง

Status: Planned Tool for managing media server configurations with AWS S3 storage solutions.

bar_manageAzureBlobTargetGroup ๐Ÿšง

Status: Planned Tool for managing media server configurations with Azure Blob storage solutions.

bar_manageGoogleCloudTargetGroup ๐Ÿšง

Status: Planned Tool for managing media server configurations with Google Cloud storage solutions.

bar_manageNetBackupTargetGroup ๐Ÿšง

Status: Planned Tool for managing media server configurations with NetBackup storage solutions.

bar_manageIbmSpectrumTargetGroup ๐Ÿšง

Status: Planned Tool for managing media server configurations with IBM Spectrum storage solutions.

Operations Management Tools

bar_manageJob โœ…

Status: Implemented Comprehensive tool for managing backup and restore job lifecycle including creation, updates, retrieval, retirement, deletion, execution, and status monitoring. Supports all DSA job operations through REST API endpoints.

bar_manageSaveSets ๐Ÿšง

Status: Planned Tool for managing backup files/objects (save sets) created by backup operations.


โ† Return to Main README