Sebastien Clerc|
Part 4 - Upload and run your own processor
In this section, we learn how to integrate a new processor on the CTEP.
Suitable processors include:
- Linux executables
- shell scripts
- python scripts Other script languages can be supported, please contact us if you have a specific need.
In a first step, we start with a very basic shell script which adds two integers and returns the result in a text file. This example illustrates how the integration mechanism works.
The shell script is the following:
The script has to start with #!/bin/sh. Notice that it has two input variables $1 and $2 and that output results are placed in the CTEP_OUTPUT_DIR folder. The last point is important: this will allow the CTEP to know where to retrieve the processing results.
To upload the processor, create a targz archive with this file. Assuming the file is called proc1.sh, the command is
tar cvzf proc1.sh.tar.gz proc1.sh.
Now we need to create new processor on the CTEP and define its parameters. Go to the Porcessor Integration interface 
.
Use the the interface to create a new processor ("New" button), then edit it. The "Info" tab lets you define the processor name and a short description. The "Visibility" button lets you share your processor with other users once you consider it validated.
Now go to the "Inputs" tab to define input parameters:
Go to the execution panel and enter the path of your processor. The path is relative to the root directory of your archive file.
We have now completely documented the processor. Press "create" to register it in the CTEP.
The last step is uploading the processor archive. Go back to the main page by clicking on "All Processors".
The processor status is "Waiting for a binary".
Click on the Upload button and select your compressed file.
Your processor is building.
Your processor is now ready.
13. Return to the geobrowser interface: https://coastal-tep.eo.esa.int/geobrowser/. In the processor panel you will now see your processor.
14. Enter the values of input parameters. And execute your job.
15. After few minutes, your process should be done.
16. Go now to the Interactive Application Service to see your results.
17. Open an Ubuntu virtual machine by clicking on Start new.
18. Click on Start container.
19. And connect to the machine.
20. You should see the following result. Click on the file manager button.
21. Go in your basket folder.
22. Choose the folder corresponding to your last job.
23. You can see two files: the output of your process and the associated log.
24. Click on the result file and open it with the application of your choice.
25. For example LibreOffice.
26. Congratulations! You have processed your first job on the CTep!
27. You can also have a look on the log file.
|