Merge cdb51e42f3 into b9e0739f72

docs/centos.md

@@ -0,0 +1,71 @@
+<h1>Getting started on RHEL/Centos OS</h1>
+
+This guide documents the process of installing NetBox on RHEL/Centos 7 with [nginx](https://www.nginx.com/) and [gunicorn](http://gunicorn.org/).
+
+ sudo yum install postgresql-server python-psycopg2 postgresql-devel
+
+  sudo postgresql-setup initdb
+  sudo systemctl start postgresql
+
+sudo systemctl enable postgresql
+
+sudo yum install epel-release
+
+
+yum install python python-devel python-pip git libxml2-devel libxslt-devel libffi-devel graphviz gcc openssl-devel
+
+This will install all the missing packages for a successful pip install
+yum groupinstall 'Development Tools'
+pip install gunicorn
+
+
+sudo su -
+su - postgres
+cd data/
+vim  pg_hba.conf
+
+change the indent on the localhost connections to password and save
+exit postgres user
+service postgresql reload
+
+test connections
+
+
+# Quickstart
+
+Create a vagrant directory:
+
+```
+mkdir -p ~/vagrant
+cd ~/vagrant
+
+```
+The vagrant is hosted on dropbox since vagrant charges for hosting the files.
+
+Download from  and put into your ~/vagrant:
+https://www.dropbox.com/s/frlh9ul4n0wna46/package.box?dl=0   
+
+
+This install uses this default user and passwd for all the services:
+* user: vagrant
+* password: vagrant
+
+When I say all the services this includes the ssh log-in, postgresql and the netbox
+Gui log-in.
+
+Do the following inside ~/vagrant:
+vagrant box add netbox ~/vagrant/package.box
+vagrant init netbox
+vagrant up
+vagrant ssh
+
+ open up a browser and put 127.0.0.1:2223 and log-in!
+
+# if you cannot ssh or bring up the GUI check the virtualbox settings:
+* In the Virtualbox GUI click on your VM then settings.
+* Go to the networking and click on "port forwarding".
+* Make sure that ssh and nginx port are there. If not add them
+* rule: [Name: SSH, Protocol: TCP, Host IP: blank, Host Port: 2222, Guest IP: blank, Guest Port: 22]
+* rule: [Name: nginx, Protocol: TCP, Host IP: blank, Host Port: 2223, Guest IP: blank, Guest Port: 80]
+
+You can change the Host port since that is the port your host is going to use but, keep the Guest port the same as above since those are the default.

docs/getting-started-vagrant.md

@@ -0,0 +1,42 @@
+<h1>Getting Started with Vagrant using Virtualbox</h1>
+
+This guide assumes that the latest versions of [Vagrant](https://www.vagrantup.com/downloads.html) and [Virtualbox](https://www.virtualbox.org/wiki/Downloads) are already installed in your host.
+
+# Quickstart
+
+Create a vagrant directory:
+
+```
+mkdir -p ~/vagrant
+cd ~/vagrant
+
+```
+The vagrant is hosted on dropbox since vagrant charges for hosting the files.
+
+Download from  and put into your ~/vagrant:
+https://www.dropbox.com/s/frlh9ul4n0wna46/package.box?dl=0   
+
+
+This install uses this default user and passwd for all the services:
+* user: vagrant
+* password: vagrant
+
+When I say all the services this includes the ssh log-in, postgresql and the netbox
+Gui log-in.
+
+Do the following inside ~/vagrant:
+vagrant box add netbox ~/vagrant/package.box
+vagrant init netbox
+vagrant up
+vagrant ssh
+
+ open up a browser and put 127.0.0.1:2223 and log-in!
+
+# if you cannot ssh or bring up the GUI check the virtualbox settings:
+* In the Virtualbox GUI click on your VM then settings.
+* Go to the networking and click on "port forwarding".
+* Make sure that ssh and nginx port are there. If not add them
+* rule: [Name: SSH, Protocol: TCP, Host IP: blank, Host Port: 2222, Guest IP: blank, Guest Port: 22]
+* rule: [Name: nginx, Protocol: TCP, Host IP: blank, Host Port: 2223, Guest IP: blank, Guest Port: 80]
+
+You can change the Host port since that is the port your host is going to use but, keep the Guest port the same as above since those are the default.

docs/localization/es_spanish/GettingStarted_es.md

@@ -0,0 +1,291 @@
+<h1>Como Empesar</h1>
+
+Esta guía document el proceso de instalar NetBox en servidor con Ubuntu 14.04 usando  [nginx](https://www.nginx.com/) y [gunicorn](http://gunicorn.org/).
+
+[TOC]
+
+# PostgreSQL
+
+## Instalación
+
+Estos paquetes son necesarios para poder instalar PostgreSQL:
+
+* postgresql
+* libpq-dev
+* python-psycopg2
+
+```
+# apt-get install postgresql libpq-dev python-psycopg2
+```
+
+## Configuración
+
+a el mínimo necesitamos crear una base de datos y asignar un nombre para el usuario y una contraseña para autenticación. Esto es echo con estos comandos.
+
+No uses la contraseña de este ejemplo.
+
+```
+# sudo -u postgres psql
+psql (9.3.13)
+Type "help" for help.
+
+postgres=# CREATE DATABASE netbox;
+CREATE DATABASE
+postgres=# CREATE USER netbox WITH PASSWORD 'J5brHrAXFLQSif0K';
+CREATE ROLE
+postgres=# GRANT ALL PRIVILEGES ON DATABASE netbox TO netbox;
+GRANT
+postgres=# \q
+```
+
+Puedes verificar que la autenticación funciono haciendo estos comandos:
+
+```
+# psql -U netbox -h localhost -W
+```
+
+---
+
+# NetBox
+
+## Dependencias
+
+* python2.7
+* python-dev
+* git
+* python-pip
+* libxml2-dev
+* libxslt1-dev
+* libffi-dev
+* graphviz*
+
+```
+# apt-get install python2.7 python-dev git python-pip libxml2-dev libxslt1-dev libffi-dev graphviz
+```
+
+*graphviz es necesario para poder representar los mapas con topología. Si no necesita este requisito entonces graphviz no es necesario.
+
+## Copiar el deposito de git.
+
+Crear la base y el directorio donde NetBox va ser instalado. Para esta guía vamos a usar  `/opt/netbox`.
+
+```
+# mkdir -p /opt/netbox/
+# cd /opt/netbox/
+```
+
+Entonces  copie el deposito de git en esta misma directorio:
+
+```
+# git clone https://github.com/digitalocean/netbox.git .
+Cloning into '.'...
+remote: Counting objects: 1994, done.
+remote: Compressing objects: 100% (150/150), done.
+remote: Total 1994 (delta 80), reused 0 (delta 0), pack-reused 1842
+Receiving objects: 100% (1994/1994), 472.36 KiB | 0 bytes/s, done.
+Resolving deltas: 100% (1495/1495), done.
+Checking connectivity... done.
+```
+
+Instala los paquetes necesario de Python usand pip.( Si encuentas algun error compilando en este paso, asegurate que tienes todas las dependencias necesarias.)
+
+```
+# pip install -r requirements.txt
+```
+
+## Configuración
+
+Mueve en el directorio de la configuración y alte una copia de el `configuration.example.py` llamado `configuration.py`.
+
+```
+# cd netbox/netbox/
+# cp configuration.example.py configuration.py
+```
+
+Abre `configuration.py` con tu preferido editor y pon entos valores:
+* ALLOWED_HOSTS
+* DATABASE
+* SECRET_KEY
+
+### ALLOWED_HOSTS
+
+Esta es una lista de los aparatos que el servidor puede comunicarse. Tienes que especificar el nombre de el aparato o el IP address.
+
+Ejemplo:
+
+```
+ALLOWED_HOSTS = ['netbox.example.com', '192.0.2.123']
+```
+
+### Base de Datos
+
+Este parámetro tiene los detalles y la configuración de la base de datos. Tienes que definir un nombre para el usuario y una contraseña cuando configuras PostgreSQL. Si el servicio
+esta en un servidor remoto cambia `localhost` con su dirección.
+
+Ejemplo:
+
+```
+DATABASE = {
+    'NAME': 'netbox',               # Database name
+    'USER': 'netbox',               # PostgreSQL username
+    'PASSWORD': 'J5brHrAXFLQSif0K', # PostgreSQL password
+    'HOST': 'localhost',            # Database server
+    'PORT': '',                     # Database port (leave blank for default)
+}
+```
+
+### SECRET_KEY
+
+Genera una llave secreta algarete con polo menos 50 letras alfanuméricas. Esta llave tiene que ser la unica en esta instalación y no puede ser compartida fuera de este sistema.
+
+Puedes usar este script en`netbox/generate_secret_key.py` para generar una llave.
+
+## Hacer migraciónes de el sistema
+
+Antes que NetBox pueda correr necesitamos instalar la schema para la base de datos. Esto es echo corriendo `./manage.py migrate` de el `netbox` directorio (`/opt/netbox/netbox/` en nuestro ejemplo):
+
+```
+# ./manage.py migrate
+Operations to perform:
+  Apply all migrations: dcim, sessions, admin, ipam, utilities, auth, circuits, contenttypes, extras, secrets, users
+Running migrations:
+  Rendering model states... DONE
+  Applying contenttypes.0001_initial... OK
+  Applying auth.0001_initial... OK
+  Applying admin.0001_initial... OK
+  ...
+```
+
+Si en este paso resulta con errores de autenticación en PostgreSQL , asegura que el nombre de el usuario y la contraseña creada en la base de datos es igual a lo que fue especificado en `configuration.py`
+
+## Crear un super usuario
+
+NetBox no viene con ninguna cuentas basica.Vas a necesitar crear un super usuario para poder entrar a NetBox:
+
+```
+# ./manage.py createsuperuser
+Username: admin
+Email address: admin@example.com
+Password:
+Password (again):
+Superuser created successfully.
+```
+
+## Colecionar archivos estaticos
+
+```
+# ./manage.py collectstatic
+
+You have requested to collect static files at the destination
+location as specified in your settings:
+
+    /opt/netbox/netbox/static
+
+This will overwrite existing files!
+Are you sure you want to do this?
+
+Type 'yes' to continue, or 'no' to cancel: yes
+```
+
+## Testiar la aplicación
+
+En este punto ya NetBox puede correr. Podemos verificar empesando la aplicación:
+
+```
+# ./manage.py runserver 0.0.0.0:8000 --insecure
+Performing system checks...
+
+System check identified no issues (0 silenced).
+June 17, 2016 - 16:17:36
+Django version 1.9.7, using settings 'netbox.settings'
+Starting development server at http://0.0.0.0:8000/
+Quit the server with CONTROL-C.
+```
+
+Ahora si vamos a el nombre de el aparato o IP de el servidor (como definido en `ALLOWED_HOSTS`) Nos encontramos con la página de NetBox. Nota que este servicio de web es para testiar o desarrollo namas y no se deveria ser usada para nada en producción.
+
+Si el servicio no corre or no te sale la página de NetBox entonces algo paso. No sigas con el resto de esta guía hasta que el problema a sido resuelto.
+
+# nginx and gunicorn
+
+## Instalación
+
+Vamos a setiar un simple HTTP front end suando [nginx](https://www.nginx.com/resources/wiki/) y [gunicorn](http://gunicorn.org/) como ejemplos en esta guía . (Tu puedes usar cualquier combinación que quieras de  HTTP and WSGI .) Tambien vamos a usar [supervisord](http://supervisord.org/).
+
+```
+# apt-get install nginx gunicorn supervisor
+```
+
+## nginx Configuración
+
+Esto servira para correr lo minimo de nginx. Acuerdate cambiar el nombre de el servidor y el directorio de la instalación.
+
+```
+server {
+    listen 80;
+
+    server_name netbox.example.com;
+
+    access_log off;
+
+    location /static/ {
+        alias /opt/netbox/netbox/static/;
+    }
+
+    location / {
+        proxy_pass http://127.0.0.1:8001;
+        proxy_set_header X-Forwarded-Host $server_name;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        add_header P3P 'CP="ALL DSP COR PSAa PSDa OUR NOR ONL UNI COM NAV"';
+    }
+}
+```
+
+Graba esta configuración a `/etc/nginx/sites-available/netbox`. entonces borra `/etc/nginx/sites-enabled/default` y crea un  symlink en `sites-enabled` directorio para la configuración  de el archivo que creaste.
+
+```
+# cd /etc/nginx/sites-enabled/
+# rm default
+# ln -s /etc/nginx/sites-available/netbox
+```
+
+Vuelve a empezar el servicio de nginx para usar la nueva configuración.
+
+```
+# service nginx restart
+ * Restarting nginx nginx
+```
+
+## gunicorn Configuración
+
+Save the following configuración file in the root netbox installation path (in this example, `/opt/netbox/`.) as `gunicorn_config.py`. Be sure to verify the location of the gunicorn executable (e.g. `which gunicorn`) and to update the `pythonpath` variable if needed.
+
+```
+command = '/usr/bin/gunicorn'
+pythonpath = '/opt/netbox/netbox'
+bind = '127.0.0.1:8001'
+workers = 3
+user = 'www-data'
+```
+
+## supervisord Configuración
+
+Save the following as `/etc/supervisor/conf.d/netbox.conf`. Update the `command` and `directory` paths as needed.
+
+```
+[program:netbox]
+command = gunicorn -c /opt/netbox/gunicorn_config.py netbox.wsgi
+directory = /opt/netbox/netbox/
+user = www-data
+```
+
+Finally, restart the supervisor service to detect and run the gunicorn service:
+
+```
+# service supervisor restart
+```
+
+A este punto deverias poder conectarte a  nginx con el nombre de el servidor o el que pusistes. Si no te pudes conectar chequea que el servicio de nginx esta corriendo y tiene la configuración correcta. Si recibes un 502 (bad gateway) error esto indica que gunicorn no tiene la configuración correcta o no esta prendido.
+
+Please keep in mind that the configurations provided here are a bare minimum to get NetBox up and running. You will almost certainly want to make some changes to better suit your production environment.