Repository files navigation

Siptrackweb is the web GUI for Siptrack.

Other components include;

• siptrackd backend API
• siptrack client library

First read the Quickstart section in the README ofsiptrackd andsiptrack client library.

Then you can quickly get siptrackweb running like this, assuming siptrackd backend API is running on localhost:9242 and that your CWD is above the two previously cloned repos.

$ git clone https://github.com/sii/siptrackweb$ cd siptrackweb$ virtualenv .venv$ source .venv/bin/activate(.venv) $ pip install -r requirements.txt(.venv) $ python setup.py install(.venv) $ pushd ../siptrack(.venv) $ python setup.py install && popd(.venv) $ django-admin startproject stweb(.venv) $ echo 'SIPTRACK_SERVER="localhost"' >> stweb/stweb/settings.py(.venv) $ echo 'SIPTRACK_PORT=9242' >> stweb/stweb/settings.py(.venv) $ echo 'SIPTRACK_USE_SSL=False' >> stweb/stweb/settings.py

Editstweb/stweb/settings.py and make sure the listINSTALLED_APPS hassiptrackweb as the last item, like this.

INSTALLED_APPS = [    'django.contrib.admin',    'django.contrib.auth',    'django.contrib.contenttypes',    'django.contrib.sessions',    'django.contrib.messages',    'django.contrib.staticfiles',    'siptrackweb']

Comment out the CSRF line in the listMIDDLEWARE so it looks like this.

MIDDLEWARE = [    'django.middleware.security.SecurityMiddleware',    'django.contrib.sessions.middleware.SessionMiddleware',    'django.middleware.common.CommonMiddleware',    #'django.middleware.csrf.CsrfViewMiddleware',    'django.contrib.auth.middleware.AuthenticationMiddleware',    'django.contrib.messages.middleware.MessageMiddleware',    'django.middleware.clickjacking.XFrameOptionsMiddleware',]

Inserturl(r'', include('siptrackweb.urls')), at the end of theurlpatterns list instweb/stweb/urls.py, and add include to the first import line so the file looks like this.

from django.conf.urls import url, includefrom django.contrib import adminurlpatterns = [    url(r'^admin/', admin.site.urls),    url(r'', include('siptrackweb.urls')),]

Next run some django commands to prepare the app and create a default user.

(.venv) $ python stweb/manage.py migrate(.venv) $ python stweb/manage.py createsuperuser --noinput --username=admin --email=my-email@host.tld(.venv) $ python stweb/manage.py runserver

Now the siptrackweb GUI should be available on localhost:8000. First step should always be to add a new View.

Of course this is just a quick example, in reality you might prefer sharing a virtualenv for all siptrack components.

Install pwgen on your system because siptrackweb uses it to generate passwords for user accounts when no other password is specified.

• Seehttps://github.com/sii/siptrackweb/wiki for documentation.

You can separate all your objects with views for clients or projects. Each view has a hierarchical object-tree database that can contain folders and devices.

Create devices quickly from templates.

Siptrackweb visualizes devices of class "rack" and each Unit is a sub-device that can be linked to another device.

Passwords can be stored encrypted with master keys, either under the Password view or linked directly to a device.

Screenshot coming soon