96661239cb
- Add main exception handler - Add more detailed, individual exceptions for common Armada failure points - Add exception documentation
58 lines
1.4 KiB
ReStructuredText
58 lines
1.4 KiB
ReStructuredText
Armada - Troubleshooting
|
|
========================
|
|
|
|
Debugging Pods
|
|
--------------
|
|
|
|
Before starting to work in armada we need to check that the tiller pod is active and running.
|
|
|
|
.. code:: bash
|
|
|
|
kubectl get pods -n kube-system | grep tiller
|
|
|
|
.. code:: bash
|
|
|
|
armada tiller --status
|
|
|
|
Checking Logs
|
|
-------------
|
|
|
|
In order to check the logs the logs file will be in `~/.armada` directory.
|
|
|
|
When running Armada in the container you can execute docker logs to retrieve logs
|
|
|
|
.. code:: bash
|
|
|
|
docker logs [container-name | container-id]
|
|
|
|
Errors/Exceptions
|
|
-----------------
|
|
|
|
A guide for interpreting errors/exceptions can be found `here <http://armada-helm.readthedocs.io/en/latest/operations/guide-exceptions.html>`_.
|
|
|
|
Working with SSL
|
|
----------------
|
|
|
|
You might run into SSL error with armada if you are not using the correct
|
|
versions of SSL.
|
|
|
|
Debugging Checklist:
|
|
|
|
1. python -c "import ssl; print ssl.OPENSSL_VERSION"
|
|
|
|
If the version that appers is less than 1.0 then problems will occur, please
|
|
update to current or use our docker container solve this issue
|
|
|
|
2. check your urllib3 version, you could run into urllib3 issues. older versions
|
|
of this lib can cause SSL errors run ``pip install --upgrade urllib3`` and it
|
|
should solve this issue
|
|
|
|
|
|
|
|
Issue
|
|
-----
|
|
|
|
If the issue that you are having does not appear here please check the aramda
|
|
issues `here <https://github.com/att-comdev/armada/issues>`_. If the issue does
|
|
not exist, please create an issue.
|