Operations grimoire/FreeBSD - Revision history

Dereckson: See also Operations grimoire/Services

2025-09-15T23:27:05Z

Dereckson: +cats

2024-10-24T22:13:22Z

+cats

← Older revision		Revision as of 22:13, 24 October 2024
Line 139:		Line 139:
	$ make build package deinstall reinstall		$ make build package deinstall reinstall
	$ pkg lock --yes postgresql15-server		$ pkg lock --yes postgresql15-server

			[[Category:Operations grimoire\|FreeBSD]]
			[[Category:FreeBSD]]

Dereckson: /* Upgrade OS */ service os-release restart

2024-08-10T11:44:01Z

Upgrade OS: service os-release restart

← Older revision		Revision as of 11:44, 10 August 2024
Line 54:		Line 54:

	See also [https://docs.freebsd.org/en/books/handbook/cutting-edge/ Updating and Upgrading FreeBSD] in FreeBSD handbook.		See also [https://docs.freebsd.org/en/books/handbook/cutting-edge/ Updating and Upgrading FreeBSD] in FreeBSD handbook.

			At the end:

			* Regenerate /etc/os-release content with <code>service os-release restart</code>
			* Run needed Salt units (see below)

	=== Salt units to run ===		=== Salt units to run ===

Dereckson: /* PostgreSQL */

2024-01-15T00:05:04Z

PostgreSQL

← Older revision		Revision as of 00:05, 15 January 2024
Line 68:		Line 68:

	We need a lot of things to rebuild the package:		We need a lot of things to rebuild the package:
	- An up-to-date ports tree
	- To unlock the previous package		* An up-to-date ports tree
	- To clean the build to avoid artefacts from previous version		* To unlock the previous package
	- Rebuild the package		* To clean the build to avoid artefacts from previous version
	- Check no library is missing (see "an up-to-date ports tree")		* Rebuild the package
	- Install it		* Check no library is missing (see "an up-to-date ports tree")
	- Restart the service		* Install it
			* Restart the service

	If the ports tree would have been up-to-date, that could work:		If the ports tree would have been up-to-date, that could work:

Dereckson: /* PostgreSQL */

2024-01-15T00:04:42Z

PostgreSQL

← Older revision		Revision as of 00:04, 15 January 2024
Line 68:		Line 68:

	We need a lot of things to rebuild the package:		We need a lot of things to rebuild the package:
	* An up-to-date ports tree		- An up-to-date ports tree
	* To unlock the previous package		- To unlock the previous package
	* To clean the build to avoid artefacts from previous version		- To clean the build to avoid artefacts from previous version
	* Rebuild the package		- Rebuild the package
	* Check no library is missing (see "an up-to-date ports tree")		- Check no library is missing (see "an up-to-date ports tree")
	* Install it		- Install it
	* Restart the service		- Restart the service

	If the ports tree would have been up-to-date, that could work:		If the ports tree would have been up-to-date, that could work:

Dereckson: /* PostgreSQL */ PostgreSQL: that would be easier to create db-A-002 actually

2024-01-15T00:03:46Z

PostgreSQL: PostgreSQL: that would be easier to create db-A-002 actually

@@ Line 65: / Line 65: @@
 ==== PostgreSQL ====
-PostgreSQL requires XML support for Orbeon, see {{T|1888}}, so run:
+PostgreSQL requires XML support for Orbeon, see {{T|1888}}, so the package should be run again.
     $ salt -G "roles:dbserver-pgsql" state.apply roles/dbserver-pgsql/server/build

Dereckson: /* Upgrade OS */

2024-01-14T23:27:54Z

Upgrade OS

← Older revision		Revision as of 23:27, 14 January 2024
Line 54:		Line 54:

	See also [https://docs.freebsd.org/en/books/handbook/cutting-edge/ Updating and Upgrading FreeBSD] in FreeBSD handbook.		See also [https://docs.freebsd.org/en/books/handbook/cutting-edge/ Updating and Upgrading FreeBSD] in FreeBSD handbook.

			=== Salt units to run ===
			==== php-fpm ====

	When you upgrade packages, if php-fpm (php package) is touched, run:		When you upgrade packages, if php-fpm (php package) is touched, run:
Line 60:		Line 63:

	If you are invited to upgrade the ZFS pool, please follow instructions form [[Operations_grimoire/ZFS]].		If you are invited to upgrade the ZFS pool, please follow instructions form [[Operations_grimoire/ZFS]].

			==== PostgreSQL ====
			PostgreSQL requires XML support for Orbeon, see {{T\|1888}}, so run:

			$ salt -G "roles:dbserver-pgsql" state.apply roles/dbserver-pgsql/server/build

Dereckson: /* Upgrade OS */

2024-01-06T17:24:26Z

Upgrade OS

← Older revision		Revision as of 17:24, 6 January 2024
Line 58:		Line 58:

	$ salt-call --local state.apply roles/webserver-alkane/php/service		$ salt-call --local state.apply roles/webserver-alkane/php/service

			If you are invited to upgrade the ZFS pool, please follow instructions form [[Operations_grimoire/ZFS]].

Dereckson: /* Upgrade OS */ +1

2023-06-09T22:27:33Z

Upgrade OS: +1

← Older revision		Revision as of 22:27, 9 June 2023
Line 54:		Line 54:

	See also [https://docs.freebsd.org/en/books/handbook/cutting-edge/ Updating and Upgrading FreeBSD] in FreeBSD handbook.		See also [https://docs.freebsd.org/en/books/handbook/cutting-edge/ Updating and Upgrading FreeBSD] in FreeBSD handbook.

			When you upgrade packages, if php-fpm (php package) is touched, run:

			$ salt-call --local state.apply roles/webserver-alkane/php/service

Dereckson: Created page with "'''FreeBSD''' is the most deployed OS on Nasqueron servers. == General tips == * Directories adheres to UNIX hierarchy: Applications use /usr/local/etc for configuration More generally, if an application on Linux uses /usr/..., on FreeBSD it will generally be /usr/local/... * BSD userland is different than Linux userland, but GNU coreutils is available, with g as prefix. For example, you can use gsed -i for inline sed replacement * Use GNU Makefile (gmake) if some..."

2023-05-30T23:27:39Z

Created page with "'''FreeBSD''' is the most deployed OS on Nasqueron servers. == General tips == * Directories adheres to UNIX hierarchy: ** Applications use /usr/local/etc for configuration ** More generally, if an application on Linux uses /usr/..., on FreeBSD it will generally be /usr/local/... * BSD userland is different than Linux userland, but GNU coreutils is available, with g as prefix. For example, you can use gsed -i for inline sed replacement * Use GNU Makefile (gmake) if some..."

New page

'''FreeBSD''' is the most deployed OS on Nasqueron servers.

== General tips ==
* Directories adheres to UNIX hierarchy:
** Applications use /usr/local/etc for configuration
** More generally, if an application on Linux uses /usr/..., on FreeBSD it will generally be /usr/local/...
* BSD userland is different than Linux userland, but GNU coreutils is available, with g as prefix. For example, you can use gsed -i for inline sed replacement
* Use GNU Makefile (gmake) if something is wrong with make

You can ask {{u|Dereckson}} for any question about FreeBSD.

== Ports ==
Some packages need to be built through ports.

On some roles, this process is automated by Salt:
* {{Ops file|roles/dbserver-pgsql/server/build.sls}} for PostgreSQL with XML support (required by Orbeon)
* {{Ops file|roles/devserver/userland-software/ports.sls}} for the list defined in {{Ops file|pillar/devserver/ports.sls}}

In other cases, for example when there is a conflict of versions, it's handled manually.

For example, as of 2023-05-30, the PDO extension in packages is built against PostgreSQL 13 while we use PostgreSQL 15.

Good to know. We maintain a package repository to put our own packages.

=== Example of upgrade ===
The general process is to go to the port directory, build it and install it.
To avoid any reinstallation with wrong parameters, you can lock it.

To use the previous example:

$ portsnap fetch update
$ cd /usr/ports/databases/php82-pdo_pgsql
$ pkg unlock php82-pdo_pgsql
$ make clean build package deinstall reinstall
$ pkg lock php82-pdo_pgsql

=== List locked packges ===

$ pkg lock -l

== Salt bootstrap ==
{{Ops file|utils/bootstrap/hello-FreeBSD.sh}} can be used to install Salt and connect to Complector.

== Upgrade OS ==
You can use the <code>freebsd-update</code> utility:

$ freebsd-update fetch
[…]
No updates needed to update system to 13.2-RELEASE-p0.

For upgrade to a new version:

$ freebsd-update upgrade -r 14.0-RELEASE

See also [https://docs.freebsd.org/en/books/handbook/cutting-edge/ Updating and Upgrading FreeBSD] in FreeBSD handbook.

← Older revision		Revision as of 23:27, 15 September 2025
Line 139:		Line 139:
	$ make build package deinstall reinstall		$ make build package deinstall reinstall
	$ pkg lock --yes postgresql15-server		$ pkg lock --yes postgresql15-server

			== See also ==
			* [[Operations grimoire/Services]]

	[[Category:Operations grimoire\|FreeBSD]]		[[Category:Operations grimoire\|FreeBSD]]
	[[Category:FreeBSD]]		[[Category:FreeBSD]]