[PROBLEM STATEMENT]:
Currently, there is no hammer command available to retrieve subscription manifest details for an organization in Red Hat Satellite/Katello (API). Users must manually access this information through the Satellite web UI. This workflow is cumbersome for users who prefer or rely on command-line interfaces (CLI) for daily operations, automation, or managing multiple organizations. The lack of this capability limits efficiency and increases the complexity of retrieving essential data.
 
[USER EXPERIENCE AND WORKFLOW]:
The proposed solution is to introduce a new Hammer CLI command:
 
   `hammer subscription-manifest info [OPTIONS]`
 
This command will allow users to easily retrieve critical information about a subscription manifest for a specified organization, including:
    • Manifest Name
    • UUID
    • Expiration Date
    • Import Date
    • Account Number (if available)
 
Current Workflow:
Users have to manually navigate the Satellite web interface, which can be time-consuming, especially when dealing with multiple organizations or environments.
 
Proposed Workflow:
With the new command, users can run a simple CLI command to get the subscription manifest details, streamlining their experience and saving time. This CLI-centric approach aligns with the existing workflows of users who prefer automation and scripting for system management tasks.
 
As Red Hat support, this can be useful for trouble-shooting as user can query the requested information and quickly observe commonly looked for items (Manifest name, expiration date, associated UUID, etc).
 
[REQUIREMENTS]:
    • New Command:
        ◦ Create a new Hammer command: `hammer subscription-manifest info --organization "ORG"`.
        ◦ This command should fetch and display the following details:
            ▪ Manifest Name
            ▪ UUID
            ▪ Expiration Date
            ▪ Import Date
            ▪ Account Number (if applicable)
 
    • API Integration:
        ◦ The command should interface with the Satellite API as well.
 
    • Output Format:
        ◦ The retrieved information should be displayed in a structured and human-readable format.
 
Example:
 

Manifest Name: Manifest_Name 
UUID: 12345678-abcd-dcba-1234-567890abcdef 
Expiration Date: 2025-12-31 
Import Date: 2024-01-15 
Account Number: 1234567

 
 
    • Error Handling:
        ◦ Proper error messages should be displayed if the organization is not found or if no manifest exists for the organization.
 
[BUSINESS IMPACT]:
    • Increased Efficiency:
By allowing users to retrieve subscription manifest data directly from the CLI, this enhancement significantly reduces the time spent navigating the UI. It also simplifies workflows for users managing large environments or multiple organizations.
 
    • Enhanced Automation:
This command will enable users to script and automate the retrieval of manifest data, which is essential for streamlining operations in large-scale environments. It integrates with existing automation workflows that rely on Hammer CLI commands.
 
    • Improved User Satisfaction:
Many Satellite users prefer the CLI for quick operations. Adding this functionality enhances the overall user experience and provides consistency across other Hammer commands, reducing frustration and increasing satisfaction.
 
    • Alignment with Customer Needs:
Red Hat Satellite users who manage subscription content and entitlements will benefit from easier access to manifest information, improving their ability to monitor and manage subscription compliance, ensuring business continuity.