Centro stella dei pagamenti elettronici
  • Centro Stella
    • Instructions for Agenzia delle Entrate Mandate
      • How to join
        • 01. Sign the Agreement
        • 02. Integrate PagoPA Environments
          • Open routes
          • Request the mutual authentication certificates
          • Obtain an API key
          • Wait for activation email
          • Check if you are enabled for PagoPA UAT environment
        • 03. Configure the Batch Service
          • Prepare the Java KeyStore
          • Install the software
            • How to install JAR version
              • Download JAR file
              • Prepare the working directories
              • Define environment variables
            • How to install Docker version
              • Download Docker image
              • Define environment variables
              • Choose working directory to mount
          • Run the software
            • Run from JAR
            • Run with Docker
        • 04. Test and monitor integration
          • Test UAT
          • Test PROD
        • 05. Go live!
      • Releases / Changelog
        • Note regarding the modifications from 2.2.0 to 2.2.3
        • Note regarding the modifications from 2.1.2 to 2.2.0
        • Note regarding the modifications of the yaml file from 2.0.0 to 2.1.0
        • Note regarding the modifications of the yaml file from 1.5.1 to 2.0.0
        • Note regarding the modifications of the yaml file from 1.4.1 to 1.5.0
        • Note regarding the modifications of the yaml file from 1.3.2 to 1.4.1
        • Note regarding the modifications of the yaml file from 1.2.5 to 1.3.2
      • Appendixes
        • Appendix 1 - Environments
        • Appendix 2 - Input file specifications
        • Appendix 3 - AdE output file specifications
          • Appendix 3 - AdE output file specifications v1.2.5
        • Appendix 4 - AdE errors file specifications
        • Appendix 5 - Logback configuration
        • Appendix 6 - Configuration properties
        • Appendix 7 - Console log overview
        • Appendix 8 - Database connection for Spring Batch
        • Appendix 9 - FAQ & Troubleshooting
        • Appendix 10 - Python and Poetry installation
        • Appendix 11 - List of output and log files
      • Api Integration
  • Glossary
  • RTD documentation
    • Input file specifications
Powered by GitBook
On this page
  • Create an environment script
  • Relevant environment variables presets
  1. Centro Stella
  2. Instructions for Agenzia delle Entrate Mandate
  3. How to join
  4. 03. Configure the Batch Service
  5. Install the software
  6. How to install Docker version

Define environment variables

PreviousDownload Docker imageNextChoose working directory to mount

Last updated 1 year ago

Create an environment script

Relevant environment variables presets

Make sure to set the proper environment entities (API key, JKSs and passwords) every time you change environment variables file.

UAT check preset

Use this preset to with UAT environment.

Features:

  • RTD send disabled

  • TAE send enabled

  • Output retention enabled

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

ACQ_BATCH_DELETE_OUTPUT_FILE=KEEP
ACQ_BATCH_TRX_SENDER_RTD_ENABLED=false
ACQ_BATCH_TRX_SENDER_ADE_ENABLED=true
PROD check preset

Use this preset to with PROD environment.

Features:

  • RTD send disabled

  • TAE send disabled

  • Output retention disabled

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

ACQ_BATCH_TRX_SENDER_RTD_ENABLED=false
ACQ_BATCH_TRX_SENDER_ADE_ENABLED=false
PROD operating preset

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 is released or

  • the agreement with PagoPA is updated.

Features:

  • RTD send disabled

  • TAE send enabled

  • Output retention disabled

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

ACQ_BATCH_TRX_SENDER_RTD_ENABLED=false
ACQ_BATCH_TRX_SENDER_ADE_ENABLED=true

Copy and paste the preset to your environment variables file.

You have to specify the path in docker run command.

test and monitor integration
test and monitor integration
transaction filter