From c1c4f28f29400cd837456f2436d2c4473db2f6b3 Mon Sep 17 00:00:00 2001 From: Jeremy Stretch Date: Tue, 17 Nov 2020 13:23:07 -0500 Subject: [PATCH] Update installation docs to use CentOS 8 --- docs/installation/1-postgresql.md | 15 +++++++-------- docs/installation/2-redis.md | 1 - docs/installation/3-netbox.md | 13 ++++++------- docs/installation/index.md | 2 +- 4 files changed, 14 insertions(+), 17 deletions(-) diff --git a/docs/installation/1-postgresql.md b/docs/installation/1-postgresql.md index 667b667d7..bcc670e2b 100644 --- a/docs/installation/1-postgresql.md +++ b/docs/installation/1-postgresql.md @@ -9,7 +9,7 @@ This section entails the installation and configuration of a local PostgreSQL da #### Ubuntu -If a recent enough version of PostgreSQL is not available through your distribution's package manager, you'll need to install it from an official [PostgreSQL repository](https://wiki.postgresql.org/wiki/Apt). +Install the PostgreSQL server and client development libraries using `apt`. ```no-highlight sudo apt update @@ -18,15 +18,14 @@ sudo apt install -y postgresql libpq-dev #### CentOS -CentOS 7 does not ship with a recent enough version of PostgreSQL, so it will need to be installed from an external repository. The instructions below show the installation of PostgreSQL 9.6, however you may opt to install a more recent version. +PostgreSQL 9.6 and later are available natively on CentOS 8.2. If using an earlier CentOS release, you may need to [install it from an RPM](https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/). ```no-highlight -sudo yum install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm -sudo yum install -y postgresql96 postgresql96-server postgresql96-devel -sudo /usr/pgsql-9.6/bin/postgresql96-setup initdb +sudo yum install -y postgresql-server libpq-devel +sudo postgresql-setup --initdb ``` -CentOS users should modify the PostgreSQL configuration to accept password-based authentication by replacing `ident` with `md5` for all host entries within `/var/lib/pgsql/9.6/data/pg_hba.conf`. For example: +CentOS configures ident host-based authentication for PostgreSQL by default. Because NetBox will need to authenticate using a username and password, modify `/var/lib/pgsql/data/pg_hba.conf` to support MD5 authentication by changing `ident` to `md5` for the lines below: ```no-highlight host all all 127.0.0.1/32 md5 @@ -36,8 +35,8 @@ host all all ::1/128 md5 Then, start the service and enable it to run at boot: ```no-highlight -sudo systemctl start postgresql-9.6 -sudo systemctl enable postgresql-9.6 +sudo systemctl start postgresql +sudo systemctl enable postgresql ``` ## Database Creation diff --git a/docs/installation/2-redis.md b/docs/installation/2-redis.md index a2b049e54..19ec9073e 100644 --- a/docs/installation/2-redis.md +++ b/docs/installation/2-redis.md @@ -16,7 +16,6 @@ sudo apt install -y redis-server ### CentOS ```no-highlight -sudo yum install -y epel-release sudo yum install -y redis sudo systemctl start redis sudo systemctl enable redis diff --git a/docs/installation/3-netbox.md b/docs/installation/3-netbox.md index e14a1405b..39189bbd1 100644 --- a/docs/installation/3-netbox.md +++ b/docs/installation/3-netbox.md @@ -18,8 +18,7 @@ sudo apt install -y python3.6 python3-pip python3-venv python3-dev build-essenti ### CentOS ```no-highlight -sudo yum install -y gcc python36 python36-devel python36-setuptools libxml2-devel libxslt-devel libffi-devel openssl-devel redhat-rpm-config -sudo easy_install-3.6 pip +sudo yum install -y gcc python36 python36-devel python3-pip libxml2-devel libxslt-devel libffi-devel openssl-devel redhat-rpm-config ``` Before continuing with either platform, update pip (Python's package management tool) to its latest release: @@ -37,10 +36,10 @@ This documentation provides two options for installing NetBox: from a downloadab Download the [latest stable release](https://github.com/netbox-community/netbox/releases) from GitHub as a tarball or ZIP archive and extract it to your desired path. In this example, we'll use `/opt/netbox` as the NetBox root. ```no-highlight -# wget https://github.com/netbox-community/netbox/archive/vX.Y.Z.tar.gz -# tar -xzf vX.Y.Z.tar.gz -C /opt -# ln -s /opt/netbox-X.Y.Z/ /opt/netbox -# ls -l /opt | grep netbox +$ sudo wget https://github.com/netbox-community/netbox/archive/vX.Y.Z.tar.gz +$ sudo tar -xzf vX.Y.Z.tar.gz -C /opt +$ sudo ln -s /opt/netbox-X.Y.Z/ /opt/netbox +$ ls -l /opt | grep netbox lrwxrwxrwx 1 root root 13 Jul 20 13:44 netbox -> netbox-2.9.0/ drwxr-xr-x 2 root root 4096 Jul 20 13:44 netbox-2.9.0 ``` @@ -73,7 +72,7 @@ sudo yum install -y git Next, clone the **master** branch of the NetBox GitHub repository into the current directory. (This branch always holds the current stable release.) ```no-highlight -sudo git clone -b master https://github.com/netbox-community/netbox.git . +$ sudo git clone -b master https://github.com/netbox-community/netbox.git . Cloning into '.'... remote: Counting objects: 1994, done. remote: Compressing objects: 100% (150/150), done. diff --git a/docs/installation/index.md b/docs/installation/index.md index d06561906..730176e0c 100644 --- a/docs/installation/index.md +++ b/docs/installation/index.md @@ -1,6 +1,6 @@ # Installation -The installation instructions provided here have been tested to work on Ubuntu 20.04 and CentOS 7.5. The particular commands needed to install dependencies on other distributions may vary significantly. Unfortunately, this is outside the control of the NetBox maintainers. Please consult your distribution's documentation for assistance with any errors. +The installation instructions provided here have been tested to work on Ubuntu 20.04 and CentOS 8.2. The particular commands needed to install dependencies on other distributions may vary significantly. Unfortunately, this is outside the control of the NetBox maintainers. Please consult your distribution's documentation for assistance with any errors. The following sections detail how to set up a new instance of NetBox: