# Documentation

### System Refresh High-Level Process <a href="#documentation-systemrefreshhigh-levelprocess" id="documentation-systemrefreshhigh-levelprocess"></a>

The following image below depicts the high-level process of system refresh. The export, cleanup, and import processes are simplified, automated, and optimized using SID-Refresh™.

![Figure 1: System Refresh High-Level Process](/files/yJxllTtbE6cxt0d8Q3by)

SID-Refresh exports the target system tables that contain configuration information before the system refresh is started and imports them afterward.

The typical task list runs in the following sequence:

* **Export System Configuration**: The connection-related configuration data is exported as table content for the file system using R3trans.
* **Copy SAP System**: The database of the production system is copied into the quality system.
* **Rename Cloned SAP System**: The copied system is renamed with the same SID as the old target system.
* **Clean System Configuration**: The contents of the tables that contain information about the source system will be cleaned up.
* **Import System Configuration**: The connection-related configuration data in the form of table content is imported back to the new target system using R3trans.
* **Conversion of Logical System Names (BDLS)**: When logical system names are duplicated, you have to convert them to have unique IDs again. To convert one or more logical system names to new or existing logical names, transaction BDLS is used.

{% hint style="info" %}
**Note:** The Copy SAP system, Rename Cloned SAP System, and Conversion of Logical System Names can be automated using [E2E System Refresh Automation](/user-guide/automation/e2e-system-refresh.md).
{% endhint %}

### Administering System Refresh Using SID-Refresh <a href="#documentation-administeringsystemrefreshusingsid-refresh-tm" id="documentation-administeringsystemrefreshusingsid-refresh-tm"></a>

In the following sections, you will be quickly introduced to how the exporting, cleanup, and importing processes are executed using SID-Refresh.

{% hint style="info" %}
**Before You Start**

Please ensure all the [general prerequisites](/user-guide/sid-refresh/getting-started.md) are met before performing any activities using the tool.
{% endhint %}

#### **Exporting and Importing the Technical Data and Configurations** <a href="#documentation-exportingandimportingthetechnicaldataandconfigurations" id="documentation-exportingandimportingthetechnicaldataandconfigurations"></a>

Below is a list of technical data and configurations that may be exported and imported using SID-Refresh.

<figure><img src="/files/oru0SvV8x6LWNZHmmATJ" alt=""><figcaption><p>Figure 2: SAP NetWeaver ABAP Technical Configuration Components</p></figcaption></figure>

#### Cleaning Up the Technical Data and Configurations

Below is a list of technical data and configurations that may be cleaned up using SID-Refresh.

<figure><img src="/files/9C28S1WhFx1aBxEK9eA8" alt=""><figcaption><p>Figure 3: SAP NetWeaver ABAP Technical Configuration Components for Clean Tasks</p></figcaption></figure>

#### High-Level Instructions <a href="#documentation-high-levelinstructions" id="documentation-high-levelinstructions"></a>

1\. Launch SID-Refresh.

2\. SID-Refresh will check the environment variables and automatically search for R3trans in the default directory. If R3trans is not in the default directory, you must specify the path where it is saved.

3\. SID-Refresh will also define a default directory for the export/import/clean. We recommend using a different export/import/clean directory other than the default.

4\. Select the number of R3trans processes to use for the export/import/clean. By default, the slider is positioned at 1. The slider in the tool allows you to select the number of concurrent R3trans tasks that you want to run. A maximum of 8 is allowed since higher than 8 does not yield to shorter runtime.

5\. Select the operation (Export Tables, Import Tables, or Clean Tables) to perform.

6\. Select the components that you want to export/import/clean. Alternatively, you have the option to load a previously saved configuration from the previous run.

7\. Click the Start button to start the export/import/clean process.\\

{% hint style="info" %}
**Note:**

* Users have the option to use SID-Refresh GUI or run the program using a console.
* Users can save the selected options on initial use to be reused in the subsequent execution of the system refresh process.
* The entire process may take from a few minutes up to several hours depending on the complexity of your systems, the degree of parallelism, and the number of components you selected for the export/cleanup/import process.
  {% endhint %}

#### Customizing the List of Tables for Export/Import <a href="#documentation-customizingthelistoftablesforexport-import" id="documentation-customizingthelistoftablesforexport-import"></a>

When adding your own tasks or changing the list of tables in the existing tasks, you have the option to customize them prior to running SID-Refresh. It is necessary to ensure that you perform the above procedure in the same directory where the **SIDRefresh.jar** is located.

1.) Create a new "./config" directory.

2.) Copy the "package\_data.json" file to the "./config" directory.

3.) Edit the "package\_data.json" file and add the necessary tables to the selected package.

4.) Re-execute export/import.

### Download the SID-Refresh User Guide <a href="#documentation-downloadthesid-refresh-tm-userguide" id="documentation-downloadthesid-refresh-tm-userguide"></a>

For a more detailed guide, you may download the file attached below:

{% file src="/files/HnR6oQQ0A4pavcbVn64h" %}

### Videos <a href="#documentation-instructionalvideos" id="documentation-instructionalvideos"></a>

{% embed url="<https://www.youtube.com/playlist?list=PLCw28MEnrwjviq2eupd-Yj3mOmFss4hNv>" %}

{% embed url="<https://youtu.be/DsWsDkTUHyE>" %}

{% embed url="<https://youtu.be/AH_uCz0h0hA>" %}

{% embed url="<https://youtu.be/Ih8vGUg0weo>" %}

{% embed url="<https://youtu.be/7Hek7-NtNGc>" %}

{% embed url="<https://youtu.be/j2LTPGu97tw>" %}

{% embed url="<https://youtu.be/GMCMg9NiW8w>" %}

{% embed url="<https://youtu.be/T_WjdQYSFpA>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.itconductor.com/user-guide/sid-refresh/documentation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.