Master Data Upload setup in developer toolkit

The Master Data Upload feature allows an enterprise administrator to upload certain system data for their organization in a bulk or batch mode format. This facilitates the process of loading large amounts of data onto the system in an efficient manner and avoids the need to manually enter the details of each entity type (also called as upload type) into the system, especially if the entity type contains a large amount of master data.

About this task

Perform the following steps for Master Data Upload setup in developer toolkit.

Procedure

  1. Configure Upload Directory
    • Follow a similar approach as Catalog Search Index setup in DTK, which uses the common mount /var/oms shared across all containers.
    • Set the property:
      sc.file.upload.dir=/var/oms
  2. Restart the om-appserver docker container
    Restart the om-appserver docker container with the following command:
    ./om-compose.sh restart om-appserver
  3. Queue creation and agent setup (Runner, Scheduler, Summarizer)
    • Create the necessary queues for Master Data Upload.
    • Configure the Master Data Upload agents.
    • Navigate to: Application Platfom > Process Modeling > General > Transactions
    • Following are the agents:
      • Master Upload Runner
      • Master Upload Scheduler
      • Master Upload Summarizer
  4. Agent startup commands from om-runtime
    Run the om-runtime container and start the following agents in the background:
    nohup ./agentserver.sh Runner > runner.log 2>&1 &
    nohup ./agentserver.sh Scheduler > scheduler.log 2>&1 &
    nohup ./agentserver.sh Summarizer > summarizer.log 2>&1 &
  5. File upload and verification steps
    • Upload the file via the Sterling™ Business Center UI.
    • Verify that the file is processed successfully.
      Important: Master Data Upload is not supported in cloud environments. The platform is designed to handle master data creation through APIs and services that provides a more secure and scalable approach.