Skip to content

Latest commit

 

History

History
101 lines (70 loc) · 3.54 KB

troubleshooting.md

File metadata and controls

101 lines (70 loc) · 3.54 KB

Troubleshooting your 5GTANGO Installation

Apple means that a workaround needed on macOS.
Linux means that a workaround needed on Linux.
Windows 10 means that a workaround needed on Windows.

The following are some of the problems commonly encountered during installation:

  • [Python - virtualenv not found] (/troubleshooting#)
  • Installing the SDK
  • Ansible/Docker - container deploy problem due to wrong python interpreter

Virtualenv Issues Apple Linux Windows 10

https://stackoverflow.com/questions/39964635/error-virtualenv-command-not-found-but-install-location-is-in-pythonpath?noredirect=1&lq=1

Alternative: try to install virtualenv with 'sudo pip3 install virtualenv'

Ansible Issues Linux

Failed to import docker or docker-py

TASK [sp : deploy a PostgreSQL database server as a Container] *****************
fatal: [localhost]: FAILED! => {"changed": false, "msg": "Failed to import docker or docker-py - No module named requests.exceptions. Try \`pip install docker\` or \`pip install docker-py\` (Python 2.6)"}
    to retry, use: --limit @/home/kwx420965/5gtango/tng-devops/roles/sp.retry

If you encounter errors like the above when executing the V&V ansible playbook e, then please try undeploying docker-py from pip3 using the following commands.

$ pip3 uninstall docker-py

then

$ pip3 install docker-py

Verify Environment before Installation

Check Ubuntu is 16.04

$ lsb_release -a

Should return the following

No LSB modules are available.
Distributor ID:	Ubuntu
Description:	Ubuntu 16.04.5 LTS
Release:	16.04
Codename:	xenial

Troubleshooting your running 5GTANGO Platform

Verify that V&V is running

$ docker inspect -f '{{.State.Running}}' tng-gtk-vnv
$ docker inspect -f '{{.State.Running}}' tng-vnv-lcm
$ docker inspect -f '{{.State.Running}}' tng-vnv-tee
$ docker inspect -f '{{.State.Running}}' tng-vnv-platform-adapter

Reconfigure the VIM

If you need to change the VIM info or reconfigure it, first you need to clear the previous info deom the DB, You can do it with these commands:

$ sudo docker exec -t son-postgres psql -h localhost -U sonatatest -d vimregistry -c "DELETE FROM VIM *"
$ sudo docker exec -t son-postgres psql -h localhost -U sonatatest -d vimregistry -c "DELETE FROM LINK_VIM *"
$ sudo docker exec -t son-postgres psql -h localhost -U postgres -d wimregistry -c "DELETE FROM ATTACHED_VIM *"
$ sudo docker exec -t son-postgres psql -h localhost -U postgres -d wimregistry -c "DELETE FROM WIM *"
$ sudo docker restart son-sp-infrabstract
$ sudo docker restart wim-adaptor

Cleaning the system

In case you want to clean the system for any reason (re-install for example), you can use these commands, that will delete all the dockers, the images, the docker network and tne files where resides persistent storage of all DBs:

$ sudo docker stop $(sudo docker ps -aq)
$ sudo docker rm $(sudo docker ps -aq)
$ sudo docker rmi $(sudo docker images -a -q)
$ docker network rm tango
$ sudo rm -rf /etc/sonata

And for reinstalling we recommend to mark as 'true' the variable "clean· in the file /tng-devops/host_vars/localhost