Operations grimoire/NetBox - Revision history

Dereckson: /* Troubleshoot */

2024-08-04T16:10:25Z

Troubleshoot

← Older revision		Revision as of 16:10, 4 August 2024
Line 66:		Line 66:

	== Troubleshoot ==		== Troubleshoot ==
			=== Grafana ===

			Use [https://grafana.nasqueron.org/d/O6v4rMpizda/netbox?orgId=1&refresh=10s Grafana dashboard] to check statistics.

			As of 2024-08-04, all the rates are erroneous and (a lot) over-evaluated.

	=== 500 after server reboot ===		=== 500 after server reboot ===
	After the server is restarted, NetBox needs PostgreSQL and Redis to work.		After the server is restarted, NetBox needs PostgreSQL and Redis to work.

Dereckson at 21:18, 8 July 2024

2024-07-08T21:18:50Z

← Older revision		Revision as of 21:18, 8 July 2024
Line 64:		Line 64:

	Documentation needs to be generated before collectstatic. If not, run again the collectstatic command to copy docs from project-static to static directory.		Documentation needs to be generated before collectstatic. If not, run again the collectstatic command to copy docs from project-static to static directory.

			== Troubleshoot ==
			=== 500 after server reboot ===
			After the server is restarted, NetBox needs PostgreSQL and Redis to work.

			* If PostgreSQL is down, we don't have any message on the web UI, it serves directly a 500 error code
			* If PostgreSQL up, Redis down, an explicit error message tells us it can't connect to Redis
			* When both services are up, site should work again

	== Conventions ==		== Conventions ==

Dereckson: /* Upgrade */

2024-01-06T19:40:01Z

Upgrade

← Older revision		Revision as of 19:40, 6 January 2024
Line 61:		Line 61:
	To track configuration changes, you can use https://github.com/netbox-community/netbox/commits/develop/netbox/netbox/configuration_example.py		To track configuration changes, you can use https://github.com/netbox-community/netbox/commits/develop/netbox/netbox/configuration_example.py

	If psycopg can't build, you can build it with <code>pip install "psycopg[c]"</code>. That requires development headers for PostgreSQL, available on all FreeBSD servers where ~~FreeBSD~~ is ~~available. For~~ a Docker image based on Linux, search for a libpq-dev or libpq-devel package for that purpose.		If psycopg can't build, you can build it with <code>pip install "psycopg[c]"</code>. That requires development headers for PostgreSQL, available on all FreeBSD servers where PostgreSQL is installed ; for a Docker image based on Linux, search for a libpq-dev or libpq-devel package for that purpose.

	Documentation needs to be generated before collectstatic. If not, run again the collectstatic command to copy docs from project-static to static directory.		Documentation needs to be generated before collectstatic. If not, run again the collectstatic command to copy docs from project-static to static directory.

Dereckson: /* Upgrade */

2024-01-06T19:35:26Z

Upgrade

← Older revision		Revision as of 19:35, 6 January 2024
Line 62:		Line 62:

	If psycopg can't build, you can build it with <code>pip install "psycopg[c]"</code>. That requires development headers for PostgreSQL, available on all FreeBSD servers where FreeBSD is available. For a Docker image based on Linux, search for a libpq-dev or libpq-devel package for that purpose.		If psycopg can't build, you can build it with <code>pip install "psycopg[c]"</code>. That requires development headers for PostgreSQL, available on all FreeBSD servers where FreeBSD is available. For a Docker image based on Linux, search for a libpq-dev or libpq-devel package for that purpose.

			Documentation needs to be generated before collectstatic. If not, run again the collectstatic command to copy docs from project-static to static directory.

	== Conventions ==		== Conventions ==

Dereckson: /* Upgrade */ As doc icons links to https://netbox.nasqueron.org/static/docs/, we need to generate the doc

2024-01-06T19:34:30Z

Upgrade: As doc icons links to https://netbox.nasqueron.org/static/docs/, we need to generate the doc

← Older revision		Revision as of 19:34, 6 January 2024
Line 49:		Line 49:
	rm netbox		rm netbox
	ln -s netbox-3.7.0 netbox		ln -s netbox-3.7.0 netbox
			cd /srv/netbox/netbox
			mkdocs build
	cd /srv/netbox/netbox/netbox		cd /srv/netbox/netbox/netbox
	python3 manage.py migrate		python3 manage.py migrate

Dereckson at 19:29, 6 January 2024

2024-01-06T19:29:15Z

← Older revision		Revision as of 19:29, 6 January 2024
Line 22:		Line 22:

	sudo -u postgres pg_dump netbox \| gzip > netbox-$(date +"%Y-%m-%d").gz		sudo -u postgres pg_dump netbox \| gzip > netbox-$(date +"%Y-%m-%d").gz

			Database is currently hosted on WindRiver, not on DB-A, even if a user exists there and an outdated copy exists.

			== Upgrade ==

			To upgrade NetBox:
			# Backup database on WindRiver
			# Install the new version
			# Copy configuration
			# Update Python dependencies
			# Shutdown the service: <code>service netbox stop</code> or if pid is wrong <code>killall netbox</code>
			# Symlink the directory in /srv/netbox
			# Run the database migrations and regenerate static resources, etc. as documented in upgrade.sh
			# Start the service

			An example for upgrade to 3.7.0:

			sudo -u postgres pg_dump netbox \| gzip > netbox-$(date +"%Y-%m-%d").gz
			cd /srv/netbox
			wget https://github.com/netbox-community/netbox/archive/refs/tags/v3.7.0.tar.gz
			tar xzf v3.7.0.tar.gz
			cp /srv/netbox/netbox/netbox/netbox/configuration.py netbox-3.7.0/netbox/netbox/
			source venv/bin/activate
			pip install -r netbox-3.7.0/requirements.txt
			killall -u netbox
			rm netbox
			ln -s netbox-3.7.0 netbox
			cd /srv/netbox/netbox/netbox
			python3 manage.py migrate
			python3 manage.py collectstatic
			python3 manage.py remove_stale_contenttypes
			python3 manage.py reindex --lazy
			python3 manage.py clearsessions
			service netbox start

			To track configuration changes, you can use https://github.com/netbox-community/netbox/commits/develop/netbox/netbox/configuration_example.py

			If psycopg can't build, you can build it with <code>pip install "psycopg[c]"</code>. That requires development headers for PostgreSQL, available on all FreeBSD servers where FreeBSD is available. For a Docker image based on Linux, search for a libpq-dev or libpq-devel package for that purpose.

	== Conventions ==		== Conventions ==

Dereckson: /* Integration with IRC */

2024-01-06T18:03:55Z

Integration with IRC

← Older revision		Revision as of 18:03, 6 January 2024
Line 15:		Line 15:
	17:13:59 < Dereckson> 172.27.27.6		17:13:59 < Dereckson> 172.27.27.6
	17:14:00 < Odderon> (Dereckson): 172.27.27.6/28 docker-001.nasqueron.org / Decommissioned address for docker-001.nasqueron.org / Drake [deprecated]		17:14:00 < Odderon> (Dereckson): 172.27.27.6/28 docker-001.nasqueron.org / Decommissioned address for docker-001.nasqueron.org / Drake [deprecated]

			Source code of the translation code is available at https://devcentral.nasqueron.org/source/netbox-darkbot-db/

	== Backup ==		== Backup ==

Dereckson: Backup

2023-06-12T20:26:30Z

Backup

← Older revision		Revision as of 20:26, 12 June 2023
Line 15:		Line 15:
	17:13:59 < Dereckson> 172.27.27.6		17:13:59 < Dereckson> 172.27.27.6
	17:14:00 < Odderon> (Dereckson): 172.27.27.6/28 docker-001.nasqueron.org / Decommissioned address for docker-001.nasqueron.org / Drake [deprecated]		17:14:00 < Odderon> (Dereckson): 172.27.27.6/28 docker-001.nasqueron.org / Decommissioned address for docker-001.nasqueron.org / Drake [deprecated]

			== Backup ==
			To backup the PostgreSQL database:

			sudo -u postgres pg_dump netbox \| gzip > netbox-$(date +"%Y-%m-%d").gz

	== Conventions ==		== Conventions ==

Dereckson: /* Integration with IRC */

2023-05-15T17:15:11Z

Integration with IRC

← Older revision		Revision as of 17:15, 15 May 2023
Line 10:		Line 10:
	== Integration with IRC ==		== Integration with IRC ==
	Export to a database for [[Odderon]] is discussed at [https://devcentral.nasqueron.org/T1868 T1868].		Export to a database for [[Odderon]] is discussed at [https://devcentral.nasqueron.org/T1868 T1868].

			That should allow the following workflow:

			17:13:59 < Dereckson> 172.27.27.6
			17:14:00 < Odderon> (Dereckson): 172.27.27.6/28 docker-001.nasqueron.org / Decommissioned address for docker-001.nasqueron.org / Drake [deprecated]

	== Conventions ==		== Conventions ==

Dereckson at 17:12, 15 May 2023

2023-05-15T17:12:40Z

← Older revision		Revision as of 17:12, 15 May 2023
Line 7:		Line 7:
	* /etc/hosts data for Drake network machines		* /etc/hosts data for Drake network machines
	* the same information available at pillar/nodes/nodes.sls, so we won't need to maintain that anymore		* the same information available at pillar/nodes/nodes.sls, so we won't need to maintain that anymore

			== Integration with IRC ==
			Export to a database for [[Odderon]] is discussed at [https://devcentral.nasqueron.org/T1868 T1868].

	== Conventions ==		== Conventions ==
	=== Devices ===		=== Devices ===
	==== Device role colors ===		==== Device role colors ====
	* Network appliances and assimilated (e.g. machines with router role): gray		* Network appliances and assimilated (e.g. machines with router role): gray
	* Devices for human to connect to and work from (e.g. shellserver, devserver): purple		* Devices for human to connect to and work from (e.g. shellserver, devserver): purple
	* Devices hosting services (e.g. dbserver, paas-docker): pink		* Devices hosting services (e.g. dbserver, paas-docker): pink