The twenty-first release candidate for FOG 1.6.0 is available on the rc-1.6.0 branch. It reports version 1.6.0-RC-21.
Test it on a lab or non-production server first. The upgrade from 1.5 to 1.6 is one-way: it changes the database schema, and there is no down-migration.
Changed since RC-20
These fixes prepare the update channels and the version number for the 1.6.0 release. They add no schema step and no UI change.
- The beta channel finds the current development line (#2014, #2015).
--channel betanamedworking-1.6directly. It now uses the newestworking-*branch, the same way--channel rcfinds the newestrc-*branch. When no beta line exists,updatefog.shand the bootstrap installer say so and suggest--channel stable. Before, the checkout failed. - The version number after 1.6.0 is correct (#2012, #2013). After the
1.6.0tag, the patches line would report1.6.N. The installer reads anX.Y.Zversion as a FOS release tag, so it would ask for a kernel that does not exist. The patches line now reports1.6.0.N. - The required 1.5 upgrade check also runs on
rc-1.6.0(#2011). CI only.
FOS (kernel and init), from the Latest FOS release
An RC install or update downloads the Latest FOS release. Latest is still EXP_20261027-181357, unchanged since RC-18:
- Kernel 6.18.59, the current 6.18 LTS release.
- FOS verifies TLS, which is the client half of #1978.
- The Performance Test task.
- x64 and x86 boot an initramfs, not an ext2 initrd (FOGProject/fos#75). The file names stay
init.xzandinit_32.xz, and the boot menu does not change./tmpis now a real RAM disk with a size limit: FOG_KERNEL_RAMDISK_SIZE sets the size, kept between 64 MB and half of the client's memory.- Warning: a customized init can no longer be loop-mounted. Add your files as an overlay cpio appended to
init.xzinstead: https://docs.fogproject.org/en/latest/kb/how-tos/customize-the-fos-init/ . A post-init script needs no rebuild at all: https://docs.fogproject.org/en/latest/kb/how-tos/post-init-scripts/ - If a client fails to boot with this init, go to FOG Configuration > Initrd Update and install the init from
EXP_20261027-155909, the last ext2 init. Then report it on FOGProject/fos#75.
- Warning: a customized init can no longer be loop-mounted. Add your files as an overlay cpio appended to
API documentation: https://docs.fogproject.org/en/latest/1.6/kb/integrations/api
Before you upgrade
- Back up your database and
/opt/fog/.fogsettings. - Read the release notes: https://github.com/FOGProject/fogproject/blob/rc-1.6.0/docs/release/1.6.0-release-notes.md
- 1.6 removes Display Manager, Directory Cleaner, User Cleanup, Client Updater, Green FOG and the persistentgroups plugin. Their data is dropped. The site and accesscontrol plugins move into core.
- PHP 7.4 or later is required. Plugins built for 1.5 do not load.
Install or update (as root)
- A 1.6 beta or RC server: run
bin/updatefog.sh --channel rcfrom your FOG checkout. - A 1.5 server installed from git: update to the current 1.5 stable, then run
bin/updatefog.sh --channel rcfrom the checkout. - A new server, or a 1.5 server installed from a tarball:
curl -fsSL https://raw.githubusercontent.com/FOGProject/fogproject/working-1.6/bin/bootstrap.sh | bash -s -- --channel rc
Report problems
Open an issue at https://github.com/FOGProject/fogproject/issues. Include your FOG version, your OS, and the installer log from bin/error_logs/. Report a security problem through "Report a vulnerability" on the same repository, not in a public issue.