1. Overview
2. Quick Start: Initial Setup
   • Prerequisites
   • Setup Workflow
   • Step 1: Configure Entitlements
   • Step 2: Subscribe to the Service
   • Step 3: Set Up Role Collections
   • Step 4: Create Service Instance and Key
3. Landscape Configuration
   • Transport Nodes
   • Transport Routes
   • Transport Landscape Wizard
4. Destination Configuration
   • Destination to TMS Service (Source Environment)
   • MTA Deployment Destinations (Cloud Foundry)
   • BTP ABAP Environment Destinations
5. Import Queue Operations
   • Import Methods
   • File Upload
   • Scheduling
   • Automatic Import
6. Transport Request Statuses
   • Import Statuses
   • Lifecycle Statuses
7. Troubleshooting
   • Quick Reference: Common Errors
   • MTA Deployment Errors
   • SAP Support
8. Security
   • Service Plans for API Access
9. Bundled Resources
   • Node-Specific Restrictions
   • Malware Scanning
10. Integrations

• CI/CD Integration
• Alert Notifications
• API Operations

1. Reference Documentation
2. Documentation Links

• MTA (Multitarget Applications):

  .mtar

  files for Cloud Foundry deployments
• BTP ABAP: References to ABAP objects in Git repositories
• Application Content: Application-specific formats (

  .zip

  ,

  .rar

  )
• XSC DU: SAP HANA XS classic delivery units

• Global account administrator access
• At least one SAP BTP subaccount
• Cloud Foundry environment enabled

standard

free

build-runtime

standard

export

transport_operator

Instance plans require an active application plan. The

export

plan is for CI/CD pipelines.

1. Navigate to Services > Service Marketplace
2. Search for "Cloud Transport Management"
3. Select Create from the Actions menu
4. Choose a subscription plan (

   standard

   ,

   free

   , or

   build-runtime

   )
5. Verify status shows "Subscribed"

• TMS_LandscapeOperator_RC

• TMS_Viewer_RC

1. Create a Cloud Foundry space in your subaccount
2. Navigate to Services > Instances and Subscriptions > Create
3. Select:
   • Service:

     Cloud Transport Management

   • Plan:

     standard

     (instance type)
   • Runtime:

     Cloud Foundry

4. Create a service key - credentials structure:

{
  "uaa": {
    "clientid": "sb-xxxxxx",
    "clientsecret": "xxxxxx",
    "url": "[https://<domain>.authentication.sap.hana.ondemand.com"](https://<domain>.authentication.sap.hana.ondemand.com")
  },
  "uri": "[https://transport-service-app-backend.ts.cfapps.sap.hana.ondemand.com"](https://transport-service-app-backend.ts.cfapps.sap.hana.ondemand.com")
}

• Physical Nodes: Actual deployment endpoints (e.g., Cloud Foundry spaces)
• Virtual Nodes: Placeholders for aggregation/distribution without physical deployment

sourceSystemId

Pre-Import

Post-Import

On Success

Manual

MTA

BTP ABAP

Application Content

XSC DU

default

blue-green

1. Select template (number of nodes)
2. Configure each node
3. Customize route names
4. Review and finish

[https://deploy-service.cf.<domain>/slprot/<org>/<space>/slp

[https://deploy-service.cf.<domain>/slprot/<guid>/slp

SpaceDeveloper

Get space GUID:

cf space <space-name> --guid

URL-encode special characters in org/space names

cf

[https://login.cf.<domain>

• Max file size: 1 GB (500 MB on free plan)
• Storage quota: 50 GB standard, 500 MB free
• Retention: 30 days (7 days free) after final status
• Formats:

  .mtar

  (MTA),

  .tgz

  (XSC DU),

  .zip

  (Application Content)

• Patterns: Daily (hourly, 4x/day) or Weekly (specific days/times)
• Auto-deactivation: After 3 consecutive fatal failures over 3+ weeks

• Modifiable: Request can be edited
• Released: In at least one queue with non-archived status
• Deleted: Deleted from all queues
• Archived: Cleaned up by retention policy

Not Found

1. Wrong Cloud Foundry domain in URL
2. Special characters in org/space names not URL-encoded

• Verify domain matches CF API endpoint:

  cf api

• Use space GUID instead of names
• URL-encode special characters (

  +

  →

  %2B

  , space →

  %20

  )

Forbidden

1. User lacks

   SpaceDeveloper

   role
2. User from wrong identity provider

• Verify user roles:

  cf space-users <org> <space>

• Use OAuth2Password auth for custom IdP users

• TmsNodesTransportOperator

• TmsNodesImport

• TmsNodesExport

ALERT_NOTIFICATION_SERVICE

• TmsImportFinished

  /

  TmsImportStarted

• TmsTransportRequestAdded

• TmsNodeImportJobDeactivated

• TmsStorageQuotaUsage

  (85% threshold)

1. File Upload: Upload content archive
2. Node Export: Attach file to new request, forward to target nodes
3. Node Upload: Upload to specific node (CI/CD scenarios)
4. Import operations: Async - monitor with Get transport action

• references/initial-setup.md

  - Complete setup procedures

• references/landscape-configuration.md

  - Nodes, routes, visualization, and wizard

• references/destinations.md

  - All 8 destination types with configurations

• references/import-operations.md

  - Import queue, MTA descriptors, modifiable requests

• references/administration.md

  - Service plans, backup, storage, data export

• references/troubleshooting.md

  - Error resolution guide

• references/integrations.md

  - Integration scenarios and API operations

• references/security-roles.md

  - Role and permission details

• GitHub Docs: https://github.com/SAP-docs/sap-btp-cloud-transport-management
• SAP Help Portal: https://help.sap.com/docs/cloud-transport-management
• API Reference: https://api.sap.com/package/TmsForCloudPub/rest