/sap-btp-service-manager

name: sap-btp-service-manager
description: |
  This skill provides comprehensive knowledge for SAP Service Manager on SAP Business Technology Platform (BTP). It should be used when managing service instances, bindings, brokers, and platforms across Cloud Foundry, Kyma, Kubernetes, and other environments. Use when provisioning services via SMCTL CLI, BTP CLI, or REST APIs, configuring OAuth2 authentication, working with the SAP BTP Service Operator in Kubernetes, troubleshooting service consumption issues, or implementing cross-environment service management.

  Keywords: SAP Service Manager, BTP, service instances, service bindings, SMCTL, service broker, OSBAPI, Cloud Foundry, Kyma, Kubernetes, service-manager, service-operator-access, subaccount-admin, OAuth2, X.509, service marketplace, service plans, rate limiting, cf create-service, btp create services/instance, ServiceInstance CRD, ServiceBinding CRD
license: GPL-3.0
metadata:
  maintainer: "Eduard Jiglau"
  maintainer_email: "hello@sap-ai-skills.com"
  website: "https://sap-ai-skills.com"
  version: "2.4.1"
  last_verified: 2025-11-27
  documentation_source: "https://github.com/SAP-docs/sap-btp-service-manager"
  documentation_files_analyzed: 80+
  reference_files: 6
  template_files: 5
  status: production
  important_notes: SMCLI repository archived (2025-09-30) - Go installation recommended

SAP BTP Service Manager Skill

Related Skills

• **sap-btp-cloud-platform**: Use for platform fundamentals, service understanding, and BTP integration
• **sap-btp-best-practices**: Use for production deployment patterns and service management guidelines
• **sap-btp-connectivity**: Use for destination configuration when services require connectivity setup
• **sap-cap-capire**: Use for CAP service provisioning and binding management

Comprehensive skill for managing services across SAP BTP environments using SAP Service Manager.

---

Table of Contents

• [When to Use This Skill](#when-to-use-this-skill)
• [Quick Start](#quick-start)
• [Core Concepts](#core-concepts)
• [Cloud Foundry Operations](#cloud-foundry-operations)
• [Kubernetes Operations](#kubernetes-operations)
• [SMCTL CLI Reference](#smctl-cli-reference)
• [API Reference](#api-reference)
• [Bundled Resources](#bundled-resources)

When to Use This Skill

Use this skill when working on tasks involving:

**Service Instance Management**:

• Creating service instances in Cloud Foundry, Kyma, Kubernetes, or other environments
• Provisioning services via SAP BTP cockpit, SMCTL CLI, or BTP CLI
• Configuring service parameters and labels
• Deleting service instances and managing lifecycle

**Service Binding Management**:

• Creating bindings to deliver credentials to applications
• Binding service instances to Cloud Foundry applications
• Creating service keys for external client access
• Managing Kubernetes ServiceBinding CRDs

**Platform & Broker Management**:

• Registering platforms (OSBAPI-enabled systems)
• Registering service brokers
• Managing broker catalogs and offerings
• Updating and deleting platform/broker registrations

**Authentication & Authorization**:

• Configuring OAuth2 client credentials
• Working with X.509 certificate authentication
• Assigning Subaccount Service Administrator role
• Managing service manager plans and scopes

**Kubernetes/Kyma Integration**:

• Setting up SAP BTP Service Operator
• Creating ServiceInstance and ServiceBinding CRDs
• Migrating from Service Catalog (svcat) to SAP BTP Service Operator
• Installing cert-manager for operator communication

**API & CLI Operations**:

• Using SMCTL command-line interface
• Using BTP CLI for service management
• Working with Service Manager REST APIs
• Filtering and querying service resources

**Troubleshooting**:

• Debugging service provisioning failures
• Resolving binding credential issues
• Handling rate limiting (HTTP 429)
• Checking async operation status

---

Quick Start

1. Install SMCTL CLI

**⚠️ Important**: The SMCLI repository was archived on September 30, 2025. While the tool remains functional, consider migration strategies for long-term SAP BTP workflows.

**Recommended Method (Go)**:

# Install via Go (preferred approach)
go install github.com/Peripli/service-manager-cli@latest

# Add to PATH (if not already)
export PATH=$PATH:$(go env GOPATH)/bin
smctl --version

**Alternative Method (Prebuilt Binary)**:

# Download from: https://github.com/Peripli/service-manager-cli/releases/latest
tar -xzf smctl-*.tar.gz && chmod +x smctl
sudo mv smctl /usr/local/bin/ && smctl --version

**Note**: While the prebuilt binary method remains functional, the Go installation approach is officially recommended. Consider evaluating SAP's native BTP CLI as an alternative for new deployments.

2. Login

# Interactive login
smctl login -a https://service-manager.cfapps.<region>.hana.ondemand.com \
  --param subdomain=<subdomain>

# Client credentials
smctl login -a https://service-manager.cfapps.<region>.hana.ondemand.com \
  --param subdomain=<subdomain> --auth-flow client-credentials \
  --client-id <id> --client-secret <secret>

3. Basic Operations

# Browse services
smctl marketplace

# Create instance (async)
smctl provision my-instance <service> <plan>

# Create binding
smctl bind my-instance my-binding

---

Core Concepts

Service Manager Architecture

SAP Service Manager is the **central registry for service brokers and platforms** in SAP BTP.

**Primary Resources**:

• **Platforms** - OSBAPI-enabled systems where applications run
• **Service Brokers** - Intermediaries advertising service catalogs
• **Service Instances** - Individual service instantiations
• **Service Bindings** - Access credentials for instances
• **Service Plans** - Capability sets offered by services
• **Service Offerings** - Service advertisements from brokers

Service Manager Plans

| Plan | Purpose | Scopes | |------|---------|--------| | **subaccount-ad