Skip to content

Commit d54ca25

Browse files
committed
docs(troubleshooting): add "could not find unit template" section
1 parent dbaf4ec commit d54ca25

1 file changed

Lines changed: 21 additions & 4 deletions

File tree

docs/troubleshooting_deis/index.rst

Lines changed: 21 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -123,13 +123,30 @@ All the given peers are not reachable
123123
-------------------------------------
124124

125125
A ``deisctl`` command fails with: 'All the given peers are not reachable (Tried to connect to each peer twice and failed)'.
126-
The most common cause of this issue is that a [new discovery URL](https://discovery.etcd.io/new)
127-
wasn't generated and updated in ``contrib/coreos/user-data`` before the cluster was launched.
128-
Each Deis cluster must have a unique discovery URL, or else ``etcd`` will try and fail to connect to old hosts.
129-
Try destroying the cluster and relaunching the cluster with a fresh discovery URL.
126+
The most common cause of this issue is that a new discovery URL wasn't generated and updated in
127+
``contrib/coreos/user-data`` before the cluster was launched. Each Deis cluster must have a unique
128+
discovery URL, or else ``etcd`` will try and fail to connect to old hosts. Try destroying the cluster
129+
and relaunching the cluster with a fresh discovery URL.
130130

131131
You can use ``make discovery-url`` to automatically fetch a new discovery URL.
132132

133+
Could not find unit template...
134+
-------------------------------
135+
136+
If you built ``deisctl`` locally or didn't use its installer, you may see an error like this:
137+
138+
.. code-block:: console
139+
140+
$ deisctl install platform
141+
142+
Storage subsystem...
143+
Could not find unit template for store-daemon
144+
145+
This is because ``deisctl`` could not find unit files for Deis locally. Run
146+
``deisctl help refresh-units`` to see where ``deisctl`` searches, and then run a command such as
147+
``deisctl refresh-units --tag=v1.0.1``, or set the ``$DEISCTL_UNITS`` environment variable to a directory
148+
containing the unit files.
149+
133150
Other issues
134151
------------
135152

0 commit comments

Comments
 (0)