Automatic data transmission to IBM Software Central

In online mode, IBM Usage Metering Service automatically sends usage data to IBM Software Central on a scheduled basis. This is the recommended configuration for environments with internet connectivity.

Before you begin

You must have the following items:
  • IBM Entitlement Key
  • Network connectivity to Software Central (swc.saas.ibm.com)
  • Usage Metering Service installed and running in the same namespace as Operational Decision Manager

About this task

  • Usage data is automatically sent every 24 hours at 12:05 AM UTC

  • No manual intervention required after initial setup

Procedure

  1. Create an Entitlement Key secret.
    Store your Entitlement Key as a Kubernetes secret:
    export NAMESPACE=<namespace>
    export ENTITLEMENT_SECRET_NAME=entitlement-secret
    export ENTITLEMENT_KEY_VALUE=<your_entitlement_key>
    
    kubectl create secret generic ${ENTITLEMENT_SECRET_NAME} \
        --from-literal=token=${ENTITLEMENT_KEY_VALUE} \
        -n ${NAMESPACE}
    Tip: Obtain your Entitlement Key from the IBM Container Software Library External link opens a new window or tab.
  2. Configure automatic data transmission.
    Patch the IBMUsageMetering instance to enable automatic data transmission:
    kubectl patch IBMUsageMetering ibm-usage-metering-instance \
        -n ${NAMESPACE} \
        --type=merge \
        -p "{
            \"spec\": {
                \"sender\": {
                    \"softwareCentral\": {
                        \"enable\": true,
                        \"entitlementKeySecret\": \"${ENTITLEMENT_SECRET_NAME}\",
                        \"anonymize\": false
                    }
                }
            }
        }"
    Configuration Parameters:
    • enable: Set to true to activate automatic transmission
    • entitlementKeySecret: Name of the secret containing your Entitlement Key
  3. Verify configuration.
    Check that the configuration was applied successfully:
    kubectl get IBMUsageMetering ibm-usage-metering-instance -n ${NAMESPACE} -o yaml
    Look for the sender.softwareCentral section in the output to confirm your settings.
  4. Monitor data transmission.
    Monitor the Usage Metering Service logs to verify successful data transmission:
    kubectl logs -n ${NAMESPACE} -l app.kubernetes.io/component=ibm-usage-metering-instance --tail=100
    Look for log entries indicating successful uploads to Software Central.

What to do next

After the first scheduled transmission or 24 hours, verify your usage data in Software Central:
Note: The first data transmission occurs at the next scheduled time (12:05 AM UTC). You can also trigger an immediate transmission by restarting the Usage Metering Service pod.
Troubleshooting
If data transmission fails:
  1. Verify network connectivity to swc.saas.ibm.com
  2. Confirm that the Entitlement Key is valid and not expired
  3. Check Usage Metering Service pod logs for error messages
  4. Ensure the secret name matches the configuration