Skip to content

feat: TOOLS-3078 added schema for Server 8.1.0 #15

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open

Conversation

a-spiker
Copy link
Contributor

@a-spiker a-spiker commented Jul 7, 2025

🔄 Overview

This PR introduces the Aerospike configuration schema 8.1.0, which includes new administrative interface capabilities, enhanced logging, improved TLS security features, and namespace-level TTL management.

New Features

1. Enhanced Admin Interface Configuration

  • Added: New network.admin section with comprehensive admin interface controls
  • Features:
    • addresses: Array of admin interface addresses
    • disable-localhost: Option to disable localhost access (default: false)
    • port: Admin port configuration (1024-65535)
    • Enterprise-only TLS features:
      • tls-addresses: TLS-enabled admin addresses
      • tls-authenticate-client: Client authentication with hostname validation
      • tls-name: TLS context name
      • tls-port: TLS port configuration

2. Improved Logging System

  • Added: deprecation logging category for better monitoring of deprecated features
  • Removed: info-port logging category (functionality moved to admin interface)
  • Maintained: All existing logging levels and categories

3. Enhanced TLS Security

  • Added: pki-user-append-ou property in TLS configuration
    • Allows appending organizational unit to PKI user identification
    • Enterprise-only feature
    • Default: false

4. Namespace TTL Management

  • Added: apply-ttl-reductions property in namespace configuration
    • Controls whether TTL reductions are applied to records
    • Default: true
    • Dynamic configuration support

🔧 Configuration Changes

Network Structure Reorganization

  • Before: network.info contained admin interface properties
  • After: network.admin dedicated section with enhanced capabilities
  • Impact: Better separation of concerns and more granular control

Logging Configuration Updates

  "logging": {
    "properties": {
+     "deprecation": {
+       "enum": ["CRITICAL", "WARNING", "INFO", "DEBUG", "DETAIL"],
+       "default": "CRITICAL"
+     },
-     "info-port": {
-       "enum": ["CRITICAL", "WARNING", "INFO", "DEBUG", "DETAIL"],
-       "default": "CRITICAL"
-     }
    }
  }

🏢 Enterprise vs Community Edition

Enterprise-Only Features

  • TLS admin interface configuration
  • PKI user organizational unit handling
  • All existing Enterprise features maintained

Community Edition Features

  • Basic admin interface configuration
  • Standard logging capabilities
  • Core namespace TTL management

🔒 Security Enhancements

  • Enhanced admin interface with TLS support
  • Improved PKI user identification
  • Better client authentication controls

📋 Migration Guide

For Existing Configurations

  1. Admin Interface: No breaking changes - existing network.info configurations remain valid
  2. Logging: Remove any info-port logging configurations if present
  3. TLS: New pki-user-append-ou option available for Enterprise users
  4. Namespaces: New apply-ttl-reductions defaults to true (existing behavior)

Recommended Updates

# Before (8.0.0)
network:
  info:
    port: 3003

# After (8.1.0) - Enhanced capabilities
network:
  admin:
    port: 3003
    disable-localhost: false
    # Enterprise users can add:
    # tls-port: 3004
    # tls-name: "admin-tls"

Further Changes Made

1. data-size minimum value increased from 256M to 512M

  • Updated the minimum value in the schema generation from 256 * 1024 * 1024 to 512 * 1024 * 1024
  • This change affects the JSON schema validation for namespace storage memory data-size configuration

2. max-record-size minimum value corrected from 0 to 64 bytes

  • Updated the minimum value in the schema generation from 0 to 64

@a-spiker a-spiker requested a review from sud82 July 7, 2025 11:52
a-spiker added 2 commits July 9, 2025 11:21
Increased the minimum for

- TOOLS-3080 'max-record-size' from 0 to 64

- TOOLS-3073 'data-size' from 268435456 to 536870912
@a-spiker
Copy link
Contributor Author

a-spiker commented Jul 9, 2025

This includes fixes for TOOLS-3074 and TOOLS-3080 for version 8.1.0 schema

cc @sud82

@a-spiker a-spiker changed the title feat: added schema for Server 8.1.0 feat: TOOLS-3078 added schema for Server 8.1.0 Jul 9, 2025
a-spiker added 2 commits July 18, 2025 13:16
Updated the Aerospike 8.1.0 JSON schema to include 'service' as a required property, ensuring configurations must specify this field.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants