NeoAnd/netbox
1
0
Fork 0
mirror of https://github.com/netbox-community/netbox.git synced 2025-07-27 02:48:38 -06:00
Code Issues Actions 4 Packages Projects Releases Wiki Activity

Adding the getting started doc for Centos

Browse Source
This commit is contained in:
Chagara 2016-07-07 17:51:59 -04:00
parent cdb51e42f3
commit 4e1eef28e9
1 changed files with 79 additions and 47 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

126
docs/centos.md
View File

@ -1,71 +1,103 @@
<h1>Getting started on RHEL/Centos OS</h1> <h1>Getting started on RHEL/Centos OS( DRAFT STILL IN THE WORKS)</h1>
This guide documents the process of installing NetBox on RHEL/Centos 7 with [nginx](https://www.nginx.com/) and [gunicorn](http://gunicorn.org/). 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 CENTOS 7 - Centos 6 is similar, but slightly different
sudo postgresql-setup initdb [TOC]
sudo systemctl start postgresql
sudo systemctl enable postgresql # 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 # Install postgresql repository
yum groupinstall 'Development Tools' yum localinstall https://download.postgresql.org/pub/repos/yum/9.5/redhat/rhel-7-x86_64/pgdg-centos95-9.5-2.noarch.rpm
pip install gunicorn
# Install posgresql
yum install postgresql95-server postgresql95-devel python-psycopg2 -y
# Enable the service
systemctl enable postgresql-9.5
# Initialize the database
/usr/pgsql-9.5/bin/postgresql95-setup initdb
sudo su - # Allow password login for users
su - postgres
cd data/
vim pg_hba.conf
change the indent on the localhost connections to password and save sed -i -e 's/ident/md5/' /var/lib/pgsql/9.5/data/pg_hba.conf
exit postgres user # Start the service
service postgresql reload service postgresql-9.5 start
test connections # Create our user/database
sudo -u postgres psql <<EOL
CREATE DATABASE netbox;
CREATE USER netbox WITH PASSWORD 'J5brHrAXFLQSif0K';
GRANT ALL PRIVILEGES ON DATABASE netbox TO netbox;
\q
EOL
# Install required RPM's
yum install epel-release
yum install -y gcc openssl-devel python python-dev git python-pip libxml2-devel libxslt-devel libffi-devel graphviz
# Quickstart # Either choose to clone or pull stable.
mkdir -p /opt/netbox
cd /opt/netbox
git clone -b master https://github.com/digitalocean/netbox.git .
pip install -r requirements.txt
sed -i -e "s/'USER': ''/'USER': 'netbox'/" /opt/netbox/netbox/netbox/configuration.py
sed -i -e "s/'PASSWORD': ''/'PASSWORD': 'J5brHrAXFLQSif0K'/" /opt/netbox/netbox/netbox/configuration.py
sed -i -e "s/ALLOWED_HOSTS = \[\]/ALLOWED_HOSTS = \['\*'\]/" /opt/netbox/netbox/netbox/configuration.py
key=`python2.7 /opt/netbox/netbox/generate_secret_key.py`
sed -i -e "s/SECRET_KEY = ''/SECRET_KEY = '$key'/" /opt/netbox/netbox/netbox/configuration.py
python2.7 /opt/netbox/netbox/manage.py migrate
python2.7 /opt/netbox/netbox/manage.py collectstatic
# You should probably createsuperuser too, but django doesn't like heredocs
# You can also test your install at this point using python2.7 manage.py runserver 0.0.0.0:8080
Create a vagrant directory: # Latest Nginx is better
echo "[nginx]
name=nginx repo
baseurl=http://nginx.org/packages/centos/7/$basearch/
gpgcheck=0
enabled=1" > /etc/yum.repos.d/nginx.repo
``` yum install -y nginx python-gunicorn supervisor
mkdir -p ~/vagrant
cd ~/vagrant
``` # nginx:
The vagrant is hosted on dropbox since vagrant charges for hosting the files. echo 'server {
listen 80;
Download from and put into your ~/vagrant: server_name netbox.example.com;
https://www.dropbox.com/s/frlh9ul4n0wna46/package.box?dl=0
access_log off;
This install uses this default user and passwd for all the services: location /static/ {
* user: vagrant alias /opt/netbox/netbox/static/;
* password: vagrant }
When I say all the services this includes the ssh log-in, postgresql and the netbox location / {
Gui log-in. 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"\';
}
}' > /etc/nginx/conf.d/netbox.conf
rm /etc/nginx/conf.d/default
Do the following inside ~/vagrant: # Creater a user to run netbox services
vagrant box add netbox ~/vagrant/package.box useradd -M netbox
vagrant init netbox
vagrant up
vagrant ssh
open up a browser and put 127.0.0.1:2223 and log-in! # Gunicorn config
echo "command = '/usr/bin/gunicorn'
pythonpath = '/opt/netbox/netbox'
bind = '0.0.0.0:8001'
workers = 3
user = 'netbox'" > /opt/netbox/gunicorn_config.py
# if you cannot ssh or bring up the GUI check the virtualbox settings: # supervisor config
* In the Virtualbox GUI click on your VM then settings. echo "[program:netbox]
* Go to the networking and click on "port forwarding". command = gunicorn -c /opt/netbox/gunicorn_config.py netbox.wsgi
* Make sure that ssh and nginx port are there. If not add them directory = /opt/netbox/netbox/
* rule: [Name: SSH, Protocol: TCP, Host IP: blank, Host Port: 2222, Guest IP: blank, Guest Port: 22] user = netbox" >> /etc/supervisord.conf
* rule: [Name: nginx, Protocol: TCP, Host IP: blank, Host Port: 2223, Guest IP: blank, Guest Port: 80] service nginx restart
service supervisord restart
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.