Skip to content

Commit 20ee882

Browse files
committed
document rethinkcli and remove old information
1 parent 5c8a98a commit 20ee882

File tree

1 file changed

+12
-37
lines changed

1 file changed

+12
-37
lines changed

datacenter/dtr/2.2/guides/admin/monitor-and-troubleshoot/troubleshoot-with-logs.md

Lines changed: 12 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ keywords: docker, registry, monitor, troubleshoot
44
title: Troubleshoot Docker Trusted Registry
55
---
66

7-
<!-- TODO: review page for v2.2 -->
7+
## Troubleshooting overlay networks
88

99
High availability in DTR depends on having overlay networking working in UCP.
1010
To manually test that overlay networking is working in UCP run the following
@@ -20,45 +20,20 @@ You can also use any images that contain `sh` and `ping` for this test.
2020

2121
If the second command succeeds, overlay networking is working.
2222

23-
## DTR doesn't come up after a Docker restart
23+
## Accessing rethinkdb directly
2424

25-
This is a known issue with Docker restart policies when DTR is running on the same
26-
machine as a UCP controller. If this happens, you can simply restart the DTR replica
27-
from the UCP UI under "Applications". The best workaround right now is to not run
28-
DTR on the same node as a UCP controller.
25+
To perform operations against rethinkdb directly, one may use the following
26+
custom rethinkdb debugging tool. It connects to one of your rethinkdb servers as
27+
indicated by `$REPLICA_ID` and presents you with an interactive prompt for
28+
running rethinkdb queries. It must be run on the same machine as the replica
29+
it's connecting to.
2930

30-
## Etcd refuses to start after a Docker restart
31-
32-
If you see the following log message in etcd's logs after a DTR restart it means that
33-
your DTR replicas are on machines that don't have their clocks synchronized. Etcd requires
34-
synchronized clocks to function correctly.
35-
36-
```
37-
2016-04-27 17:56:34.086748 W | rafthttp: the clock difference against peer aa4fdaf4c562342d is too high [8.484795885s > 1s]
38-
```
39-
40-
## Accessing the RethinkDB Admin UI
41-
42-
> Warning: This command will expose your database to the internet with no authentication. Use with caution.
43-
44-
Run this on the UCP node that has a DTR replica with the given replica id:
45-
46-
```
47-
docker run --rm -it --net dtr-br -p 9999:8080 svendowideit/ambassador dtr-rethinkdb-$REPLICA_ID 8080
31+
```none
32+
$ docker run --rm -it --net dtr-ol -v dtr-ca-$REPLICA_ID:/ca dockerhubenterprise/rethinkcli:v2.2.0 $REPLICA_ID
4833
```
4934

50-
Options to make this more secure:
51-
52-
* Use `-p 127.0.0.1:9999:8080` to expose the admin UI only to localhost
53-
* Use an SSH tunnel in combination with exposing the port only to localhost
54-
* Use a firewall to limit which IPs are allowed to connect
55-
* Use a second proxy with TLS and basic auth to provide secure access over the Internet
56-
57-
## Accessing etcd directly
35+
You can use javascript syntax to execute rethinkdb queries like so:
5836

59-
You can execute etcd commands on a UCP node hosting a DTR replica using etcdctl
60-
via the following docker command:
61-
62-
```
63-
docker run --rm -v dtr-ca-$REPLICA_ID:/ca --net dtr-br -it --entrypoint /etcdctl docker/dtr-etcd:v2.2.4 --endpoint https://dtr-etcd-$REPLICA_ID.dtr-br:2379 --ca-file /ca/etcd/cert.pem --key-file /ca/etcd-client/key.pem --cert-file /ca/etcd-client/cert.pem
37+
```none
38+
> r.db('dtr2').table('repositories')
6439
```

0 commit comments

Comments
 (0)