Managing Containers

Objective

After completing this lesson, you will be able to manage containers.

Manage Containers

The Managed Containers feature is essential for managing environments within the Universal Model. This functionality allows for the export and import of entire environments, facilitating processes such as backups, migrations, and environment replication. By exporting an environment, you effectively create a comprehensive snapshot of all configurations and data, which can then be transferred or restored in another instance.

A screenshot of the SAP 'Manage Containers' interface, displaying a list of data containers in a table with options to import, export, create, and delete them.

Manage Containers allows for the Export of Environments into a ZIP file. This file can then be Imported to other Tenants - e.g. Exported from a DEV Tenant and Imported to a QA Tenant. This functionality includes an Export Delta option to capture only differences made since an original Export.

Note

This process ONLY works on Universal Models and cannot facilitate migration of PaPM on-premise or Standard Model to Universal Model.

Steps to Export an Environment

Overview: Exporting an environment involves creating a complete backup of the environment's settings, configurations, and data. The export process generates a zip file containing all the necessary JSON and XML files that encapsulate the environment's structure and content.

Export Environment

First, we need to select the environment and click on Export Environment. This will create a zip file that will automatically start downloading to the PC.

A three-step visual guide for exporting an environment: a user selects an environment from a list, confirms the export in a pop-up, and a new ZIP file is created.

If you look inside that zip file, what's in there, you will find the list of JSON files (picture on the right). The list of fields and functions within the exported environment will appear.

An image showing the download of an exported environment ZIP file from the SAP interface. The contents of the downloaded file are displayed, revealing a series of JSON files for various fields and functions.

Import Environment

The next step would be to import that zip file (environment) to the new tenant. Within the Manage Containers app, there is an Import Environment button. So, an exported environment (zip file) from another tenant can be uploaded like this. There is also an option to "Activate Environment." By selecting "Yes," the imported environment will be activated automatically upon import.

An SAP interface showing the process for importing an environment. A user has selected a container and clicked 'Import Environment,' which opens a pop-up to confirm the action.

Import as New allows you to create a new Environment from the Exported Container file and gives you the option to activate it or not. "Import as a New" is when you import an already existing environment and have a chance to rename it.

The 'Import as New' pop-up in the SAP interface, where a user is creating a new environment named 'PARAM2' from an existing container.

Because we imported with option No on Activate Environment, the newly created PARAM2 environment has Runtime statuses of Inactive.

The SAP Environment details page for 'PARAM2', highlighting that the Runtime Function and Artifact statuses are both 'Inactive'.

Export Delta

After Export and subsequent Import and Import as New, adding a new Function - Currencies1 should allow for an Export Delta.

The SAP Manage Functions screen, showing a filtered list of ten functions within the PARAM environment.

Selecting the previous Export Container and selecting Export Delta yields a new Container - this one with a more recent timestamp. The original ZIP file contained 27 files. The new Delta Container only contains 12 .json files.

The SAP Manage Containers screen showing a list of containers with one selected, ready for a delta export.

Create

In order to migrate an exported and downloaded Container to another SAP PaPM UM instance, click on Create. Click the Upload icon.

A two-part image showing the process of creating a new container in SAP, highlighting the 'Create' button and the subsequent file upload screen.

Find your downloaded zip file. Click Open, then provide a description and click Create.

A two-part image showing the process of uploading a container file in SAP: selecting a ZIP file from a file dialog, then in the SAP interface, adding a description and clicking 'Create'.

Finally, click the Import Environment button. The newly imported Environment now shows up in Manage Environments.

A two-part image showing an SAP environment import. The 'Import Environment' button is highlighted on the container screen, and the resulting 'PARAM' environment is shown selected on the manage environments screen.