Mercurial > p > roundup > code
comparison doc/installation.txt @ 6581:b5fb268b7f04
Docker installation doc improved and switchable debugging
Using a Docker container, login was failing with no error or ok
message. After a lengthy debugging session on irc with alxjsn
assisted by taggnostr realised it was the web setting in config.ini.
Install doc for docker now mentions that the web setting must end in
/issues/.
SHELL_DEBUG environment variable enabled set -xv in startp script.a
| author | John Rouillard <rouilj@ieee.org> |
|---|---|
| date | Tue, 04 Jan 2022 16:31:04 -0500 |
| parents | c55d56ab9ee9 |
| children | 24e2eeb2ed9a |
comparison
equal
deleted
inserted
replaced
| 6580:77a35268cd7c | 6581:b5fb268b7f04 |
|---|---|
| 289 | 289 |
| 290 If the tracker directory is empty, the docker container will prompt | 290 If the tracker directory is empty, the docker container will prompt |
| 291 you to install a tracker template and prompt you for the database | 291 you to install a tracker template and prompt you for the database |
| 292 type. | 292 type. |
| 293 | 293 |
| 294 Once you have edited and configured ``template/config.ini``, (see | 294 Then you need to configure the tracker by editing |
| 295 `Configuring your first tracker`) run another interactive session | 295 ``template/config.ini``. Make sure that the tracker web setting ends |
| 296 in ``/issues/`` See `Configuring your first tracker` and the top of | |
| 297 ``config.ini`` for other settings. | |
| 298 | |
| 299 Once you have configured the tracker, run another interactive session | |
| 296 with:: | 300 with:: |
| 297 | 301 |
| 298 docker run --rm -it -p 9017:8080 \ | 302 docker run --rm -it -p 9017:8080 \ |
| 299 -v $PWD/tracker:/usr/src/app/tracker roundup-app:latest | 303 -v $PWD/tracker:/usr/src/app/tracker roundup-app:latest |
| 300 | 304 |
| 313 | 317 |
| 314 docker exec -it c0d5 sh | 318 docker exec -it c0d5 sh |
| 315 | 319 |
| 316 where ``c0d5`` is the id prefix for the running container obtained | 320 where ``c0d5`` is the id prefix for the running container obtained |
| 317 from ``docker container ls``. | 321 from ``docker container ls``. |
| 322 | |
| 323 If you add ``-e SHELL_DEBUG=1`` to the docker command, it sets the | |
| 324 ``SHELL_DEBUG`` environment variable which will enable debugging | |
| 325 output from the startup script. | |
| 318 | 326 |
| 319 Non-Guided Installation | 327 Non-Guided Installation |
| 320 ''''''''''''''''''''''' | 328 ''''''''''''''''''''''' |
| 321 | 329 |
| 322 If you got a tracker installed using the automatic setup above, you | 330 If you got a tracker installed using the automatic setup above, you |