Open-Source Code Repository links #
The release package of COPSI is available on a dedicated Open-Source GitHub repository:
Public Docker Repository links #
The relevant Docker image is available on dedicated Public Docker Hub repositories:
Installation and Configuration Guidelines #
Installation of the COPSI takes place via docker compose.
Software pre-requirements #
The following HW requirement are recommended for COPSI:
- OS: Centos7 64 bit
- RAM: 8GB
- CPU: 4Cores
- Storage: 100 GB
The following software must be pre-installed on the Virtual Machine:
- Docker Engine v.20.03.5 (API version 1.40)
- Docker Compose v.1.24.1
- A tool to unzip files
- proxy to handle cross-origin requests from COPSI towards a target CSC OData Server
Installation #
To install COPSI is needed to download the release package as COPSI user, unzip it and execute the installation script with the following command:
sh install.sh <copsi-version>
and check that the docker image of COPSI has been downloaded locally executing:
docker images
The following files have to be configured before starting the execution:
docker-compose.yml
config.json
To start COPSI the following command has to be launched from the same directory of the docker-compose.yml file:
sh start.shConfiguration #
Please refer to Installation and Configuration Manual [ALIA-COPSI-ICM-22-001] for details about the configuration.
User Guide #
COPSI is a web application accessible via web-browser. Detailed information on how to use COPSI features is present in COPSI Software User Manual [ALIA-COPSI-SUM-22-0001]:
Login #
First time the user reaches the application via URL, a login panel displayed.
The user will be redirected to the Sign In page of an external authentication service to supply the needed credentials. In particular, COPSI is well proven to work with the open-source Keycloak service.
Since COPSI is the Graphical User Interface of a CSC OData Service, it shall use the same Keycloak Client of the related CSC OData Service. This approach will ensure to have the same CSC OData Service Client Roles and moreover will avoid maintaining additional Keycloak Client Roles mapping for COPSI.
After the log-in the COPSI main page appears:
Product Search #
User can perform product search queries using the following tools:
- Search Bar, placed on the top left of the page, can be used as a simple text input where the user inserts queries according OData syntax or can insert wildcard ‘*’ to a text string as a simplified form of the query by product Name: <Text>*, *<Text>*, *<Text>
- Advanced search panel that can be shown by clicking on the icon on the left side of the search bar. Here it is possible to order and sorting products and it is possible to filter products to retrieve by date or according to mission-specific attributes
- Geographical search, that allow to draw a polygon on the COPSI map and to return only product matching the selected AOI
Product Visualization #
Products matching the user query appear in a list under the search bar. The relevant footprints are shown on the map.
Every product in the list is contained in a frame and the Product Name is on the top as a header; in addition, the Platform Name, the Sensing Date and the File Size are shown, together with configurable product tags and product quicklook, if present.
Actions on products #
It is possible to perform the following actions on products returned in the product list:
- Show product details, clicking on the eye icon.
The product detail panel is opened on the right of the product list containing the name of the product the quicklook, together with a section with the product properties section the attributes. Attributes to be shown can be configured by Administrator.
- Zoom To Map Position, clicking on the zoom icon under a product in the product list the map moves, and the relevant footprint is visualized
- Copy URL, clicking with the left mouse button on the Copy Url button under a product in the product list. The whole link address is copied in the clipboard, so that the user can paste it elsewhere.
- Download, clicking on the download icon under a product in the product list. When the download starts a progress bar appears and it becomes blue when the download is ended. Clicking again the same icon a download is aborted. Parallel download can be performed according to quota configuration on of the related CSC OData Service.
Tutorials #
Please find available Tutorials at the following link:
