CentOS 7 x86_64 BBR offline bundle
================================

This bundle contains the same ELRepo kernel installed on your server:
kernel-lt-5.4.278-1.el7.elrepo.x86_64.rpm
Plus the ELRepo signing public key, installer, verification and rollback scripts.
No server passwords or SSH tools are included.

Scope and prerequisites
-----------------------
Only CentOS 7 x86_64 on a BIOS/GRUB2 VM or physical machine is supported.
UEFI and containers are deliberately refused by the installer.
The existing system must already have its base dependencies, rpm, grubby,
dracut, kmod, coreutils, procps-ng and iproute installed. This is an offline
kernel/BBR bundle, not a full OS installer or an offline CentOS repository.
rpm --test stops installation if a package dependency is missing.
Keep access to the provider console and preferably take a VM snapshot first.

CentOS 7 and this ELRepo el7 kernel are historical, unsupported software.
This package enables BBR but is not an OS security update solution.
Plan a migration to a supported OS. BBR does not guarantee a speed increase.

Install
-------
Upload the ZIP to the server, extract it and enter bbr-centos7-x86_64.
Use your existing ZIP extraction tool (unzip is not bundled).

  unzip bbr-centos7-x86_64.zip
  cd bbr-centos7-x86_64
  bash install.sh --check
  bash install.sh
  reboot

After reconnecting:

  cd /path/to/bbr-centos7-x86_64
  bash verify.sh

Optional explicit install + automatic reboot:

  bash install.sh --reboot

Running install.sh without --reboot never reboots automatically.
It checks SHA256 hashes, imports the ELRepo public key, checks the RPM
signature and installs the kernel alongside existing kernels. It saves
the original boot default and BBR configuration under /root/bbr-backups/.
It selects the new kernel for the next boot and persists BBR + FQ in:
  /etc/sysctl.d/99-bbr.conf
  /etc/modules-load.d/bbr.conf
It does not overwrite unrelated sysctl settings or modify firewall rules.
If install.sh exits with an error, do not reboot; inspect the error first.
Other sysctl files or application-specific socket settings can override BBR.
Verify after reboot; existing established TCP connections may keep their
previous congestion-control algorithm.

Rollback
--------
Use the exact backup path printed during installation:

  bash rollback.sh /root/bbr-backups/YYYYMMDD-HHMMSS-PID
  reboot

This restores the previous boot kernel and the two configuration files,
and leaves both kernels installed. It does not reboot automatically.
Choose the original pre-BBR backup if you ran the installer multiple times.
If SSH is unavailable after a kernel boot, use the provider console and
select the old kernel in GRUB; then run rollback.sh after logging in.

Checksums and provenance
-----------------------
  sha256sum -c SHA256SUMS

SHA256SUMS detects accidental changes. For tamper detection, obtain the
ZIP hash separately from the sender and independently verify the ELRepo
key. The bundled key itself is not an independent trust source.

Kernel mirror:
https://mirrors.coreix.net/elrepo-archive-archive/kernel/el7/x86_64/RPMS/kernel-lt-5.4.278-1.el7.elrepo.x86_64.rpm
Signing key:
https://www.elrepo.org/RPM-GPG-KEY-elrepo.org
