> For the complete documentation index, see [llms.txt](https://docs.pagopa.it/centrostella-1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagopa.it/centrostella-1/centro-stella/instructions-for-agenzia-delle-entrate-mandate/how-to-join/03.-configure-the-batch-service/install-the-software/how-to-install-jar-version/define-environment-variables.md).

# Define environment variables

## Create an environment script

### Relevant environment variables presets

{% hint style="danger" %}
**Make sure** to set the proper environment entities (API key, JKSs and passwords) every time you change environment variables file.
{% endhint %}

<details>

<summary><mark style="color:green;">UAT check preset</mark></summary>

Use this preset to [test and monitor integration](/centrostella-1/centro-stella/instructions-for-agenzia-delle-entrate-mandate/how-to-join/04.-test-and-monitor-integration.md) with **UAT** environment.

Features:

* RTD send **disabled**
* TAE send **enabled**
* Output retention **enabled**

```
export ACQ_BATCH_SCHEDULED=true
export ACQ_BATCH_INPUT_CRON="*/10 * * * * *"
export ACQ_BATCH_TRX_INPUT_PATH=/workdir/input
export ACQ_BATCH_HPAN_INPUT_PATH=/workdir/hpans
export ACQ_BATCH_TRX_LOGS_PATH=/workdir/logs
export ACQ_BATCH_OUTPUT_PATH=/workdir/output
export ACQ_BATCH_SENDER_ADEACK_OUTPUT_PATH=/workdir/ade-errors
export ACQ_BATCH_FILE_REPORT_PATH=/workdir/reports
export HPAN_SERVICE_URL=https://api.uat.cstar.pagopa.it
export HPAN_SERVICE_API_KEY=<YOUR_UAT_API_KEY_HERE>
export HPAN_SERVICE_KEY_STORE_FILE=<PATH_TO_UAT_JKS>
export HPAN_SERVICE_KEY_STORE_PASSWORD=<UAT_JKS_PASSWORD>
export HPAN_SERVICE_TRUST_STORE_FILE=<PATH_TO_UAT_JKS>
export HPAN_SERVICE_TRUST_STORE_PASSWORD=<UAT_JKS_PASSWORD>
export JAVA_TOOL_OPTIONS="-Xms6g -Xmx6g"

export ACQ_BATCH_DELETE_OUTPUT_FILE=KEEP
export ACQ_BATCH_TRX_SENDER_RTD_ENABLED=false
export ACQ_BATCH_TRX_SENDER_ADE_ENABLED=true
```

</details>

<details>

<summary><mark style="color:blue;">PROD check preset</mark></summary>

Use this preset to [test and monitor integration](/centrostella-1/centro-stella/instructions-for-agenzia-delle-entrate-mandate/how-to-join/04.-test-and-monitor-integration.md) with **PROD** environment.

Features:

* RTD send **disabled**
* TAE send **disabled**
* Output retention **disabled**

```
export ACQ_BATCH_SCHEDULED=true
export ACQ_BATCH_INPUT_CRON="*/10 * * * * *"
export ACQ_BATCH_TRX_INPUT_PATH=/workdir/input
export ACQ_BATCH_HPAN_INPUT_PATH=/workdir/hpans
export ACQ_BATCH_TRX_LOGS_PATH=/workdir/logs
export ACQ_BATCH_OUTPUT_PATH=/workdir/output
export ACQ_BATCH_SENDER_ADEACK_OUTPUT_PATH=/workdir/ade-errors
export ACQ_BATCH_FILE_REPORT_PATH=/workdir/reports
export HPAN_SERVICE_URL=https://api.cstar.pagopa.it
export HPAN_SERVICE_API_KEY=<YOUR_PROD_API_KEY_HERE>
export HPAN_SERVICE_KEY_STORE_FILE=<PATH_TO_PROD_JKS>
export HPAN_SERVICE_KEY_STORE_PASSWORD=<PROD_JKS_PASSWORD>
export HPAN_SERVICE_TRUST_STORE_FILE=<PATH_TO_PROD_JKS>
export HPAN_SERVICE_TRUST_STORE_PASSWORD=<PROD_JKS_PASSWORD>
export JAVA_TOOL_OPTIONS="-Xms6g -Xmx6g"

export ACQ_BATCH_TRX_SENDER_RTD_ENABLED=false
export ACQ_BATCH_TRX_SENDER_ADE_ENABLED=false
```

</details>

<details>

<summary><mark style="color:red;">PROD operating preset</mark></summary>

Use this preset during the **production** activity of the Batch Service.

Only **TAE** flow will be sent to PagoPA in this way.

**Update** your configuration by copying the code block below when:

* a new major of the [transaction filter](https://github.com/pagopa/rtd-ms-transaction-filter) is released or
* the **agreement** with PagoPA is updated.

Features:

* RTD send **disabled**
* TAE send **enabled**
* Output retention **disabled**

```
export ACQ_BATCH_SCHEDULED=true
export ACQ_BATCH_INPUT_CRON="0 0 * * * *"
export ACQ_BATCH_TRX_INPUT_PATH=/workdir/input
export ACQ_BATCH_HPAN_INPUT_PATH=/workdir/hpans
export ACQ_BATCH_TRX_LOGS_PATH=/workdir/logs
export ACQ_BATCH_OUTPUT_PATH=/workdir/output
export ACQ_BATCH_SENDER_ADEACK_OUTPUT_PATH=/workdir/ade-errors
export ACQ_BATCH_FILE_REPORT_PATH=/workdir/reports
export HPAN_SERVICE_URL=https://api.cstar.pagopa.it
export HPAN_SERVICE_API_KEY=<YOUR_PROD_API_KEY_HERE>
export HPAN_SERVICE_KEY_STORE_FILE=<PATH_TO_PROD_JKS>
export HPAN_SERVICE_KEY_STORE_PASSWORD=<PROD_JKS_PASSWORD>
export HPAN_SERVICE_TRUST_STORE_FILE=<PATH_TO_PROD_JKS>
export HPAN_SERVICE_TRUST_STORE_PASSWORD=<PROD_JKS_PASSWORD>
export JAVA_TOOL_OPTIONS="-Xms6g -Xmx6g"

export ACQ_BATCH_TRX_SENDER_RTD_ENABLED=false
export ACQ_BATCH_TRX_SENDER_ADE_ENABLED=true
```

</details>

Copy and paste the preset export of the target environment to your environment script. You may set the environment variables launching the following instruction (*`setenv.sh`* is the name of script where you saved the export commands).

```
source ./setenv.sh
```