Skip to main content
Version: 1.7.1

REGARDS Command line interface

REGARDS stack Administration tools

Connect to the master node of your stack, and open the REGARDS working directory.
To do that, you need these two values from your inventories :

group_workdir_local: /opt/regards/
group_stack_name: 'regards'

It means your stack is installed inside /opt/regards/regards.

Open this folder and go to the cli folder:

cd /opt/regards/regards-cnes/cli

Let's look at these scripts :

  • let you go inside a running container. For advanced debugging.
  • let you display container logs from a running container. Once the stack is running fine, you should prefer to use Kibana to see logs
  • let you reboot a container
  • display the status of your stack (running container, how many containers are missing, history)
  • boot or update the stack using stack files. It checks for updated images on the Docker registry, and track updates on files available on the master node.
  • let you fetch an updated docker image and reboot only that single container. For advanced usage, you should prefer
  • : let you completly shutdown the regards swarm stack.
  • : let you retrieve microservices global heathness for a specific tenant.

When you deploy the stack, you should run to see if containers are running:

nothing found in stack: regards-cnes
[RUNNING] 25/25
86.. regards-cnes_rs-fluent.w4pf3rfr47yjny8y2jmvy9n0s myregistry/regards-fluent:latest Running 23 hours ago
nh.. regards-cnes_rs-fluent.jh7i65fsxbrnce85yjexucna3 myregistry/regards-fluent:latest Running 23 hours ago
77.. regards-cnes_rs-fluent.iodt1aszolajpqq5f12q12v1w myregistry/regards-fluent:latest Running 23 hours ago
ij.. regards-cnes_rs-admin.1 myregistry/rs-administration:V1.1.0 Running 23 hours ago
lh.. regards-cnes_rs-postgres.1 myregistry/regards-database:latest Running 23 hours ago
vm.. regards-cnes_rs-phppgadmin.1 myregistry/regards-phpmyadmin:latest Running 23 hours ago
59.. regards-cnes_rs-notifier.1 myregistry/rs-notifier:V1.1.0 Running 23 hours ago
3r.. regards-cnes_rs-logs-elasticsearch.1 myregistry/regards-elasticsearch:latest Running 23 hours ago
jd.. regards-cnes_rs-kibana.1 myregistry/regards-kibana:latest Running 23 hours ago
3t.. regards-cnes_rs-dam.1 myregistry/rs-dam:V1.1.0 Running 23 hours ago
ir.. regards-cnes_rs-access-instance.1 myregistry/rs-access-instance:V1.1.0 Running 23 hours ago
pp.. regards-cnes_rs-fem.1 myregistry/rs-fem:V1.1.0 Running 23 hours ago
lx.. regards-cnes_rs-config.1 myregistry/rs-config:V1.1.0 Running 23 hours ago
2k.. regards-cnes_rs-authentication.1 myregistry/rs-authentication:V1.1.0 Running 23 hours ago
mh.. regards-cnes_rs-catalog.1 myregistry/rs-catalog:V1.1.0 Running 23 hours ago
qu.. regards-cnes_rs-registry.1 myregistry/rs-registry:V1.1.0 Running 23 hours ago
8m.. regards-cnes_rs-rabbitmq.1 myregistry/regards-messaging:latest Running 23 hours ago
n9.. regards-cnes_rs-maildev.1 myregistry/regards-maildev:latest Running 23 hours ago
m8.. regards-cnes_rs-logs-kibana.1 myregistry/regards-kibana:latest Running 23 hours ago
ke.. regards-cnes_rs-elasticsearch.1 myregistry/regards-elasticsearch:latest Running 23 hours ago
kw.. regards-cnes_rs-access-project.1 myregistry/rs-access-project:V1.1.0 Running 23 hours ago
51.. regards-cnes_rs-gateway.1 myregistry/rs-gateway:V1.1.0 Running 23 hours ago
jd.. regards-cnes_rs-front.1 myregistry/rs-front:V1.1.0 Running 23 hours ago
y4.. regards-cnes_rs-admin-instance.1 myregistry/rs-administration-instance:V1.1.0 Running 23 hours ago

In the history, there is no container starting again and again every minutes. That's what we're expecting in a production environment.
Moreover, we display the number of running containers and the number of expected ones. In this exemple everything is fine ([RUNNING] 25/25). The current state of these containers is also important. You need to wait 5 to 15 minutes to see if containers succeed to boot, some containers are waiting to others so they usually crash in that short period if there is some files unwritable, COTS not accessible...


The number of running services depends of your inventory. You may see less actives services than this exemple, but the [RUNNING] X/X must equals 100%.

You can run the script to check the healthness returned by each microservice of the stack, for a specfic tenant.

./ demo
[200] fem
[200] admin
[200] dam
[200] processing
[200] storage
[200] authentication
[200] ingest
[200] admin_instance
[200] access
[200] catalog
[200] access_instance
[200] order
[200] dataprovider
[200] notifier

The microservice healthness is still in a early access and not heavily tested.

Simple debugging

Now, let's see how you can debug some microservice. First, let's remove the elasticsearch:

docker service scale regards-cnes_rs-elasticsearch=0

Then, reboot dam:

./ rs-dam

Now we can read logs of the booting dam to see if it succeed to boot without ElasticSearch :

$./ rs-dam -f | 2020-05-12 10:49:54,315 [rs-dam] [main ] ERROR o.s.boot.SpringApplication [] - Application run failed
[..] | Caused by: rs-elasticsearch: Try again

Definitly, it doesn't like it. Now we can restart the ElasticSearch by just running :


Now we can run again :

# ./ 
86m.. regards-cnes_rs-fluent.w4pf3rfr47yjny8y2jmvy9n0s myregistry/regards-fluent:latest@sha256:4e733e[...] Shutdown Shutdown 2 minutes ago
nhu.. regards-cnes_rs-fluent.jh7i65fsxbrnce85yjexucna3 myregistry/regards-fluent:latest@sha256:4e733e[...] Shutdown Shutdown 2 minutes ago
778.. regards-cnes_rs-fluent.iodt1aszolajpqq5f12q12v1w myregistry/regards-fluent:latest@sha256:4e733e[...] Shutdown Shutdown 2 minutes ago
ty0.. regards-cnes_rs-authentication.1 myregistry/rs-authentication:V1.1.0@sha256:875ca2aa[..] Shutdown Shutdown 3 minute ago
7yw.. regards-cnes_rs-access-project.1 myregistry/rs-access-project:V1.1.0@sha256:17a0d7e9[..] Shutdown Shutdown 3 minute ago
[RUNNING] 25/25

We see in the history the last activity starts to be old (2 mins) and there is again 25/25 services deployed.