From 34539d1317c41e4b74204be18aab58b9518955ec Mon Sep 17 00:00:00 2001
From: Tomas Hrcka <thrcka@redhat.com>
Date: Wed, 12 Apr 2023 16:38:36 +0200
Subject: [PATCH] Final freeze info

Signed-off-by: Tomas Hrcka <thrcka@redhat.com>
---
 modules/release_guide/pages/final_freeze.adoc |  28 +++-
 modules/release_guide/pages/torrents.adoc     | 137 ++++++++++++++++++
 2 files changed, 164 insertions(+), 1 deletion(-)
 create mode 100644 modules/release_guide/pages/torrents.adoc

diff --git a/modules/release_guide/pages/final_freeze.adoc b/modules/release_guide/pages/final_freeze.adoc
index 65cba57..4df6bf2 100644
--- a/modules/release_guide/pages/final_freeze.adoc
+++ b/modules/release_guide/pages/final_freeze.adoc
@@ -1,3 +1,29 @@
 include::_partials/attributes.adoc[]
 
-== Fedora Final Freeze
\ No newline at end of file
+== Fedora Final Freeze
+
+Before freezing everything we need to do the last stable push in bodhi.
+
+=== Stable push
+
+....
+$sudo -u apache bodhi-push --releases --stable '{branched},{branched}M'
+....
+
+=== Ansible changes
+
+Freeze is enabled by editing
+https://infrastructure.fedoraproject.org/cgit/ansible.git/tree/vars/all/RelEngFrozen.yaml[RelEngFrozen
+variable] in infra ansible repo and then run the bodhi playbook.
+
+....
+$ sudo rbac-playbook groups/bodhi-backend.yml
+....
+
+
+=== Update bodhi release
+....
+$ bodhi releases edit --name {branched} --state frozen
+....
+
+=== Process stable push requests
\ No newline at end of file
diff --git a/modules/release_guide/pages/torrents.adoc b/modules/release_guide/pages/torrents.adoc
new file mode 100644
index 0000000..d9ccd82
--- /dev/null
+++ b/modules/release_guide/pages/torrents.adoc
@@ -0,0 +1,137 @@
+	
+== Torrent Release
+ 
+When you want to add a new torrent to the tracker at
+http://torrent.fedoraproject.org you need to take the following
+steps to have it listed correctly:
+ 
+[arabic]
+. login to _torrent02.fedoraproject.org_. If you are unable to do so please
+contact the fedora infrastructure group about access. This procedure
+requires membership in the torrentadmin group.
+. Change the group ID to torrentadmin
++
+
++
+....
+newgrp torrentadmin
+....
+. Remove everything from the working directory `/srv/torrent/new/fedora/`
++
+....
+rm -r /srv/torrent/new/fedora/*
+....
+. rsync all the iso's from ibiblio
++
+....
+rsync -avhHP rsync://download-ib01.fedoraproject.org/fedora-stage/<Version>_<Release>-<Label>/*/*/iso/ /srv/torrent/new/fedora/
+....
+. cd into `/srv/torrent/new/fedora/` to change the directory structure
++
+....
+cd /srv/torrent/new/fedora/
+....
+. Directories should be created by removing Label in the iso's name
++
+....
+for iso in $(ls *iso); do dest=$(echo $iso|sed -e 's|-<Label>.iso||g' ); mkdir $dest; mv $iso $dest; done
+....
+. Copy the checksum's into the associated directories
++
+....
+for checksum in $(ls *CHECKSUM); do for file in $(cat $checksum | grep "SHA256 (" | awk '{print $2}' | sed -e 's/(\|)//g' | awk -F'-<Label>' '{print $1}'); do cp $checksum $file ; done; done
+....
+. Verify if all the checksums are copied into the right locations
++
+....
+ls */
+....
+. Remove the manifest files and checksums for netinst (since we dont
+mirror netinst images) and other files
++
+....
+rm -rf *manifest *netinst* *CHECKSUM *i386 *x86_64
+....
+. Run the maketorrent script from `/srv/torrent/new/fedora/`
++
+....
+../maketorrent *
+....
++
+____
+[NOTE]
+====
+Next steps should be run 12 hours before the release time which is
+generally 14:00 UTC on Tuesday.
+====
+____
+
+. Grab `fedora-torrent-init.py` from releng scripts and change it to
+executable
++
+....
+cd ~
+wget https://pagure.io/releng/raw/master/f/scripts/fedora-torrent-ini.py
+chmod 755 ~/fedora-torrent-ini.py
+....
+. Run the following command from `/srv/torrent/new/fedora/`
+____
+[NOTE]
+====
+Release is empty for Final release
+====
+____
++
+....
+~/fedora-torrent-ini.py <Version>_<Release> <Current_Date> > <Version>_<Release>.ini
+....
+. Copy all the torrents to `/srv/web/torrents/`
++
+....
+cp *torrent /srv/web/torrents/
+....
+. Copy everything in `/srv/torrent/new/fedora/` to `/srv/torrent/btholding/`
++
+....
+cp -rl * /srv/torrent/btholding/
+....
+. Copy the .ini file created in step 12 to `/srv/torrent/torrent-generator/`
+____
+[NOTE]
+====
+Release is empty for Final release
+====
+____
++
+....
+sudo cp <Version>_<Release>.ini /srv/torrent/torrent-generator/
+....
+. Restart rtorrent and opentracker services
++
+....
+systemctl restart opentracker-ipv4 opentracker-ipv6
+sudo -i
+tmux (or tmux attach if the session is already running, generally named att)
+control-q if rtorrent is already running.
+cd /srv/torrent/btholding
+rtorrent *.torrent
+control-b d (disconnect from tmux)
+....
+
+[NOTE]
+====
+For final release, remove all the alpha and beta directories and torrent
+files corresponding to the release in `/srv/torrent/btholding/` directory.
+====
+
+[NOTE]
+====
+At EOL of a release, remove all the directories and torrent files
+corresponding to the release in `/srv/torrent/btholding/` directory.
+====
+
+[NOTE]
+====
+If `Failure reason "Requested download is not authorized for use with this tracker."`
+issue is thrown by rtorrent, then restart the opentracker-ipv4 and opentracker-ipv6 services
+====
\ No newline at end of file