Xcelerator Adoption in SDK & Platform¶

Xcelerator is a comprehensive suite of applications and services designed to transform existing on-premise software products into SaaS-enabled offerings, build new cloud-native XaaS solutions and create a consistent customer experience across Siemens products.

Adopting Xcelerator¶

Adoption of the Xcelerator platform and services will help us to leverage Xcelerator to enhance and scale applications according to business needs. Major steps in adoption of Xcelerator include efforts to migrate the existing applications to Xcelerator clusters if needed.

As all services slowly migrate from the previously used mindsphere.io to siemens.app domain, applications created on the Onboarding Console will use siemens.app domain APIs and resources to use the Xcelerator services capabilities. Customers and API requests to the previous domain following the previous API contracts must be redirected to the new domain instead, which maintains the same APIs, thus without any loss of functionality.

Applications previously developed using our SDKs and new applications leveraging the Xcelerator platform capabilities through SDKs can easily adopt the new domain by following the guidelines:

CASE: Application uses AppCredentials¶

1. Create a "New Application" in the Onboarding Console.
2. Generate "Application Credentials" with the necessary scopes and permissions to use the corresponding APIs in the Xcelerator domain.
3. Use new credentials in your old application source code.
4. Use with newly released Xcelerator-enabled SDK dependencies.
5. Deploy an application in the new domain.
6. Use the new basedomain available in the Xcelerator domain.

HOST_BASEDOMAIN¶

The basedomain URL is set to siemens.app.

The newly released SDKs, which incorporate Xcelerator domain API requests and Xcelerator-specific token handling, allow you to use the SDK with your Xcelerator domain applications and authentication credentials.

Key Configuration Notes¶

Production Pipelines:

Remove MDSP_MANAGEMENT_TENANT variable entirely
Use HOST_BASEDOMAIN: siemens.app for Xcelerator platform
Store sensitive credentials in GitLab CI/CD variables (masked/protected)

Testing/CI Pipelines:

Include MDSP_MANAGEMENT_TENANT for test environment routing
Use HOST_BASEDOMAIN: siemens.app for testing
Use dedicated test credentials and tenant IDs
Please check the below example demonstrating using the new Xcelerator settings.

The following example demonstrates the use of the new Xcelerator settings:

# Production Configuration (Recommended)
credentials = mindsphere_credentials.AppCredentials(
    app_name="APPNAME",
    app_version="v1.0.0",
    key_store_client_id="TENANT-APPNAME-v1.0.0",
    key_store_client_secret="xyzxyzxyzxyzxyzxyzxyz",
    host_tenant="TENANT",
    user_tenant="TENANT"
)
config = mindsphere_core.RestClientConfig(host_environment="eu1", host_domain="siemens.app")
timeSeriesClientObj = TimeSeriesOperationsClient(rest_client_config=config, mindsphere_credentials=credentials)

# Testing/Development Configuration
credentials = mindsphere_credentials.AppCredentials(
    app_name="APPNAME",
    app_version="v1.0.0",
    key_store_client_id="TENANT-APPNAME-v1.0.0",
    key_store_client_secret="xyzxyzxyzxyzxyzxyzxyz",
    host_tenant="TENANT",
    user_tenant="TENANT",
    management_tenant="MANAGEMENT_TENANT"
)
config = mindsphere_core.RestClientConfig(host_environment="eu1", host_domain="siemens.app")
timeSeriesClientObj = TimeSeriesOperationsClient(rest_client_config=config, mindsphere_credentials=credentials)