The seventh release candidate for FOG 1.6.0 is available on the rc-1.6.0 branch. It reports version 1.6.0-RC-7.
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-6
- FOS check-in failed behind Apache's forced HTTPS (#1835, issue #1829). Check-in failed with "Invalid MAC Address!" and registration with "No viable macs to use". The redirect turned FOS's POST into an empty GET. It now keeps the POST. Re-run the installer to apply it.
- Legacy FOG Client: "Thumbprints did not match" after restoring an old root CA (#1837). The installer kept a client communication certificate that the restored root did not sign. It now re-issues that certificate under the current root, with the same key. Registered clients need no reinstall.
- Schema update stopped at step 344 on MySQL (#1840). It failed with
1067 Invalid default value for 'hostSecTime'on databases first built on MySQL 5.x. The schema updater now completes. - Install failed with "Could not download bzImage32 properly" (#1842). A short GitHub error page was saved as the kernel and as its checksum file. The installer now treats an HTTP error as a failed download and logs the reason. If you already hit this, delete
/root/fogproject/tmp/bzImage32*(or the file it names) and re-run the installer.
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.