To make a long story short:


1) Install container with dachs and awstats on your laptop

(you need the docker app installed on your machine)


cd somewhere_convenient
git clone https://github.com/gavodachs/docker-dachs.git
      (install container the first time) 

cd docker-dachs/
cd dockerfiles/
docker-compose up -d
     (will start docker)
docker exec -ti dachs bash
     (will start dachs 2.5)


2a) Install example service (for CSV input)


cd /var/gavo/inputs
     (then clone the example:)
git clone https://voparis-gitlab.obspm.fr/workshop-2021-material/planets.git
cd planets


From here you can then ingest the data: 

dachs val q.rd
dachs imp q.rd 


2b) Install your service from scratch


cd /var/gavo/inputs
mkdir dummy_service
cd dummy_service
dachs start epntap
     (writes a generic q.rd template you can edit)


Then, remind to backup your work before exiting Docker - at least on your machine (outside Docker) or possibly on voparis-gitlab.
Keep voparis-gitlab updated with your q.rd and a sample data file.


2c) Install a service from another directory

Edit file docker-compose.yml to add this last line:

volumes:
        - "${DACHS_LOGS_PATH:-./tmp/logs}:/var/gavo/logs"
        - "path_to_service/dummy_service:/var/gavo/inputs/dummy_service"

(For instance, if located in docker-dachs:)
         - "$PWD/dummy_service:/var/gavo/inputs/dummy_service"

The first time this will copy the service files in directory dockerfiles/

  where you can edit with your host editor - changes are reflected in the guest system.

(you can add new services this way in your docker - beware that everything is reconstructed on restart, so you'll have to ingest again the previous ones)


3) Access the local service from your browser


Go to
 http://localhost:8080/
To see service tables:
 http://localhost:8080/__system__/dc_tables/list
To query tables (SQL-like):
  http://localhost:8080/__system__/adql/query/form


See presentations from Carlos and Chloé (day 3) for details: 2021-vespa-implementation-workshop:




  • No labels