mirror/netbox-community-netbox
1
0
Fork 0
mirror of https://github.com/netbox-community/netbox.git synced 2024-05-10 07:54:54 +00:00
Code Activity

added centos/rhel installation on netbox.md postgresql.md and web-server.md

Browse Source
This commit is contained in:
Chagara
2016-09-02 16:38:58 -04:00
parent 8341800a85
commit 2213e3e0cf
3 changed files with 56 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
docs/installation/netbox.md
View File

@ -2,6 +2,8 @@
NetBox requires following system dependencies: NetBox requires following system dependencies:
Debian/Ubuntu
* python2.7 * python2.7
* python-dev * python-dev
* python-pip * python-pip
@ -12,9 +14,26 @@ NetBox requires following system dependencies:
* libpq-dev * libpq-dev
* libssl-dev * libssl-dev
Centos/RHEL
* python27
* python-devel
* git
* python-pip
* libxml2-devel
* libxslt-devel
* libffi-devel
* graphviz
* openssl-devel
### Debian/Ubuntu
``` ```
# sudo apt-get install -y python2.7 python-dev python-pip libxml2-dev libxslt1-dev libffi-dev graphviz libpq-dev libssl-dev # sudo apt-get install -y python2.7 python-dev python-pip libxml2-dev libxslt1-dev libffi-dev graphviz libpq-dev libssl-dev
``` ```
## Centos/RHEL
```
# sudo yum install -y epel-release
# sudo yum install -y python27 python-devel git python-pip libxml2-devel lbxslt-devel libffi-devel graphviz.x_86_64 openssl-devel
You may opt to install NetBox either from a numbered release or by cloning the master branch of its repository on GitHub. You may opt to install NetBox either from a numbered release or by cloning the master branch of its repository on GitHub.
@ -76,7 +95,7 @@ Move into the NetBox configuration directory and make a copy of `configuration.e
``` ```
Open `configuration.py` with your preferred editor and set the following variables: Open `configuration.py` with your preferred editor and set the following variables:
* ALLOWED_HOSTS * ALLOWED_HOSTS
* DATABASE * DATABASE
* SECRET_KEY * SECRET_KEY
@ -143,8 +162,8 @@ NetBox does not come with any predefined user accounts. You'll need to create a
# ./manage.py createsuperuser # ./manage.py createsuperuser
Username: admin Username: admin
Email address: admin@example.com Email address: admin@example.com
Password: Password:
Password (again): Password (again):
Superuser created successfully. Superuser created successfully.
``` ```

14
docs/installation/postgresql.md
View File

@ -4,13 +4,27 @@ NetBox requires a PostgreSQL database to store data. MySQL is not supported, as
The following packages are needed to install PostgreSQL with Python support: The following packages are needed to install PostgreSQL with Python support:
Debian/Ubuntu
* postgresql * postgresql
* libpq-dev * libpq-dev
* python-psycopg2 * python-psycopg2
Centos/RHEL
* postgresql
* postgresql-server
* postgresql-libs
* postgresql-devel
Debian/Ubuntu
``` ```
# sudo apt-get install -y postgresql libpq-dev python-psycopg2 # sudo apt-get install -y postgresql libpq-dev python-psycopg2
``` ```
Centos/RHEL
```
# sudo yum install postgresql postgresql-server postgresql-libs postgresql-devel
```
# Configuration # Configuration

22
docs/installation/web-server.md
View File

@ -1,18 +1,29 @@
# Web Server Installation # Web Server Installation
We'll set up a simple WSGI front end using [gunicorn](http://gunicorn.org/) for the purposes of this guide. For web servers, we provide example configurations for both [nginx](https://www.nginx.com/resources/wiki/) and [Apache](http://httpd.apache.org/docs/2.4). (You are of course free to use whichever combination of HTTP and WSGI services you'd like.) We'll also use [supervisord](http://supervisord.org/) to enable service persistence. We'll set up a simple WSGI front end using [gunicorn](http://gunicorn.org/) for the purposes of this guide. For web servers, we provide example configurations for both [nginx](https://www.nginx.com/resources/wiki/) and [Apache](http://httpd.apache.org/docs/2.4). (You are of course free to use whichever combination of HTTP and WSGI services you'd like.) We'll also use [supervisord](http://supervisord.org/) to enable service persistence.
Debian/Ubuntu
``` ```
# sudo apt-get install -y gunicorn supervisor # sudo apt-get install -y gunicorn supervisor
``` ```
Centos/RHEL
```
# sudo yum install -y gunicorn supervisor
```
## Option A: nginx ## Option A: nginx
The following will serve as a minimal nginx configuration. Be sure to modify your server name and installation path appropriately. The following will serve as a minimal nginx configuration. Be sure to modify your server name and installation path appropriately.
Debian/Ubuntu
``` ```
# sudo apt-get install -y nginx # sudo apt-get install -y nginx
``` ```
Centos/RHEL
```
# sudo yum install -y nginx
```
Once nginx is installed, proceed with the following configuration: Once nginx is installed, proceed with the following configuration:
@ -43,7 +54,7 @@ Save this configuration to `/etc/nginx/sites-available/netbox`. Then, delete `/e
``` ```
# cd /etc/nginx/sites-enabled/ # cd /etc/nginx/sites-enabled/
# rm default # rm default
# ln -s /etc/nginx/sites-available/netbox # ln -s /etc/nginx/sites-available/netbox
``` ```
Restart the nginx service to use the new configuration. Restart the nginx service to use the new configuration.
@ -57,9 +68,16 @@ To enable SSL, consider this guide on [securing nginx with Let's Encrypt](https:
## Option B: Apache ## Option B: Apache
Debian/Ubuntu
``` ```
# sudo apt-get install -y apache2 # sudo apt-get install -y apache2
``` ```
Centos/RHEL
```
# sudo yum install -y httpd
```
Once Apache is installed, proceed with the following configuration (Be sure to modify the `ServerName` appropriately): Once Apache is installed, proceed with the following configuration (Be sure to modify the `ServerName` appropriately):