04. Test and monitor integration

Once you have installed the Batch Service you have to complete the integration checklist running a set of functional test in UAT environment using the tools PagoPA provides. It is strongly suggested that you run also a test in PROD environment, as documented in the following pages.

Before running the test you have to enable the log tracking and prepare a Python environment as described below.

The Python environment is required only to generate a set of input file for the Batch Service and the related expected output file.

If in your UAT environment Python is not available, you may run the CLI tools wherever you prefer. You just have to move the input and output files from and to the UAT environment (e.g. with scp).

Please note that the Python script will require access to the client certificate and to the API Key.

Enable log tracking

By default the application log are saved in the ACQ_BATCH_TRX_LOGS_PATH directory and named application.log.

If you wish to change the default behaviour you can visit this page.

Activate Python environment

Make sure to have a properly configured Python interpreter (version >=3.9) and Poetry installed on your machine.

Click here for more information.

Every time you want to use a CSTAR-CLI command you have to activate both a Python environment and a Poetry shell.

• Make sure to be in CSTAR-CLI root directory.

• Enter the Poetry shell by running the following commands:

$HOME/.poetry/bin/poetry install
$HOME/.poetry/bin/poetry shell

Run the following script to access CSTAR-CLI tools:

./install.sh

Now you are ready tu use Python tools offered by CSTAR-CLI.