[debian-edu-commits] [Debian Wiki] Update of "DebianEdu/HowTo/TestCDinstall" by RolandClobus
Debian Wiki
wiki at debian.org
Wed Nov 18 11:48:34 GMT 2026
Dear Wiki user,
You have subscribed to a wiki page or wiki category on "Debian Wiki" for change notification.
The "DebianEdu/HowTo/TestCDinstall" page has been changed by RolandClobus:
https://wiki.debian.org/action/diff/DebianEdu/HowTo/TestCDinstall?action=diff&rev1=74&rev2=75
Comment:
Add script snippet to modify the netinst/BD image
#language en
- == Please test in VirtualBox only first ==
+ = Adjust a Debian Edu installation medium to refer to stable-proposed-updates =
+ You will need to make a few changes to the installation medium (which could be done while interacting with the VM during the installation process, but it is more convenient to modify the image before starting the VM.
- How to test DebianEdu on [[ https://wiki.debian.org/SystemVirtualization | Virtual Machines ]]:
- [[ https://wiki.debian.org/DebianEdu/HowTo/TestInstallVirtualMachine | Testing of Debian Edu Virtual Machines ]]
- = How to test Debian Edu CD/DVDs with kvm/VirtualBox =
+ Copy and adjust the following command snippets to a bash prompt:
+ {{{#!highlight bash
+ # Please update the variables below to refer to the most recent stable version of Debian
+ export STABLE=trixie
+ export POINTRELEASE=13.7.0
+ export MEDIUM_TYPE=netinst # netinst or BD
+ export USE_PROXY='http://192.168.122.1:3142' # Example for apt-cacher-ng with the IP address of the VM host
+
+ # If packages from an aptly repository need to be used, place the URLs here, the counter starts at 1
+ #declare UPDATED_PACKAGE[1]=https://salsa.debian.org/debian-edu/debian-edu-artwork/-/jobs/10448775
+ #declare UPDATED_PACKAGE[2]=https://salsa.debian.org/debian-edu/debian-edu-config/-/jobs/10478123
+ #declare UPDATED_PACKAGE[3]=https://salsa.debian.org/debian-edu/debian-edu-install/-/jobs/10364641
+
+ # If udebs need to be replaced, place all file paths here, the counter starts at 1
+ # An example from proposed-updates
+ #declare UPDATED_UDEB_URLPREFIX[1]=https://deb.debian.org/debian/pool/main/d/debian-edu-install
+ #declare UPDATED_UDEB_POOLPATH[1]=main/d/debian-edu-install
+ #declare UPDATED_UDEB_OLDFILENAME[1]=debian-edu-profile-udeb_2.12.11+deb13u1_all.udeb
+ #declare UPDATED_UDEB_NEWFILENAME[1]=debian-edu-profile-udeb_2.12.11+deb13u2_all.udeb
+ # An example from aptly (note aptly artifacts expire)
+ #declare UPDATED_UDEB_URLPREFIX[2]=https://salsa.debian.org/debian-edu/debian-edu-install/-/jobs/10364641/artifacts/raw/aptly/pool/main/d/debian-edu-install
+ #declare UPDATED_UDEB_POOLPATH[2]=main/d/debian-edu-install
+ #declare UPDATED_UDEB_OLDFILENAME[2]=debian-edu-install-udeb_2.12.11+deb13u1_all.udeb
+ #declare UPDATED_UDEB_NEWFILENAME[2]=debian-edu-install-udeb_2.13.2+salsaci+20260925+37_all.udeb
+
+ #### No changes should be required after this point
+
+ # Download the image
+ if [ ${MEDIUM_TYPE} == "BD" ]; then
+ MEDIUM_FILE=debian-edu-${POINTRELEASE}-amd64-BD-1.iso
+ wcurl --curl-options="--clobber --continue-at -" https://get.debian.org/images/release/current/amd64/iso-bd/${MEDIUM_FILE}
+ else
+ MEDIUM_FILE=debian-edu-${POINTRELEASE}-amd64-netinst.iso
+ wcurl --curl-options="--clobber --continue-at -" https://get.debian.org/images/release/current/amd64/iso-cd/${MEDIUM_FILE}
+ fi
+
+ # Unpack it, as described on the [[DebianInstaller/Modify/CD|Wiki]]
+ mkdir unpacked
+ bsdtar -C unpacked -xf ${MEDIUM_FILE}
+ chmod -R +w unpacked
+
+ # Update the kernel command line
+ echo -n '' \
+ 'apt-setup/local0/repository="http://deb.debian.org/debian proposed-updates main non-free-firmware"' \
+ 'apt-setup/local0/comment="proposed-updates, to see what would be released with the upcoming point release"' \
+ > kernel_command_line
+
+ i=0; while i="$(($i + 1))" || true; do
+ if [ -z "${UPDATED_PACKAGE[$i]}" ]; then
+ break
+ fi
+ echo -n "" \
+ "apt-setup/local${i}/repository=\"${UPDATED_PACKAGE[$i]}/artifacts/raw/aptly/ unstable main\"" \
+ "apt-setup/local${i}/key=\"${UPDATED_PACKAGE[$i]}/artifacts/raw/aptly/public-key.gpg\"" >> kernel_command_line
+ done
+
+ # Use the proxy
+ if [ ! -z "${USE_PROXY}" ]; then
+ echo -n " mirror/http/proxy=\"${USE_PROXY}\"" >> kernel_command_line
+ fi
+
+ # Apply to the grub configuration (UEFI boot)
+ sed -i -e "s/quiet/quiet $(sed 's|/|\\/|g' kernel_command_line)/" unpacked/boot/grub/grub.cfg
+
+ # Apply to the isolinux configuration (BIOS boot)
+ sed -i -e "s/quiet/quiet $(sed 's|/|\\/|g' kernel_command_line)/" unpacked/isolinux/gtk.cfg
+
+ # Replace the udebs
+ i=0; while i="$(($i + 1))" || true; do
+ if [ -z "${UPDATED_UDEB_URLPREFIX[$i]}" ]; then
+ break
+ fi
+ rm -f unpacked/pool/${UPDATED_UDEB_POOLPATH[$i]}/${UPDATED_UDEB_OLDFILENAME[$i]}
+ wcurl --curl-options="--clobber --continue-at -" ${UPDATED_UDEB_URLPREFIX[$i]}/${UPDATED_UDEB_NEWFILENAME[$i]} -o unpacked/pool/${UPDATED_UDEB_POOLPATH[$i]}/${UPDATED_UDEB_NEWFILENAME[$i]}
+ done
+
+ # Prepare the override file
+ mkdir indices
+ cd indices
+ wcurl --curl-options="--clobber --continue-at -" https://deb.debian.org/debian/indices/override.${STABLE}.main.debian-installer.gz -o override.gz
+ gunzip override.gz
+ cd ..
+
+ # Create the configuration file for apt-ftparchive
+ cat << EOF > config-udeb
+ Dir {
+ ArchiveDir "unpacked";
+ OverrideDir "indices";
+ CacheDir "indices";
+ };
+
+ TreeDefault {
+ Directory "pool/";
+ };
+
+ BinDirectory "pool/main" {
+ Packages "dists/${STABLE}/main/debian-installer/binary-amd64/Packages";
+ BinOverride "override";
+ };
+
+ Default {
+ Packages {
+ Extensions ".udeb";
+ };
+ };
+ EOF
+
+ # Update the meta-information
+ apt-ftparchive generate config-udeb --sha1=no --sha512=no
+
+ # Repack the installation image
+ chmod -R -w unpacked
+ dd if=${MEDIUM_FILE} bs=1 count=432 of=isohdpfx.bin
+ xorriso -as mkisofs -o ${MEDIUM_FILE}.withPU.iso \
+ -isohybrid-mbr isohdpfx.bin \
+ -c isolinux/boot.cat -b isolinux/isolinux.bin \
+ -no-emul-boot -boot-load-size 4 -boot-info-table ./unpacked
+ }}}
+
+ = How to get suitable aptly packages =
+
+ To find out which values to use for {{{UPDATED_PACKAGE}}} in the shell snippet above, take a look at the Salsa pages for the package.
+
+ Example: for {{{debian-edu-config}}} the base URL is {{{https://salsa.debian.org/debian-edu/debian-edu-config/-/pipelines}}}.
+
+ The third stage in the ''Stages'' column should show a green checkmark.<<BR>>
+ If not, click on the circle and run the ''aptly'' stage.<<BR>>
+ Right click on the checkmark and select ''Copy link'' for the aptly stage.<<BR>>
+ Use that URL for the value of {{{UPDATED_PACKAGE}}}.
+
+ '''Note:''' the aptly artifacts will expire after newer versions have been made available, so you'll need to update the script regularly.
+
+ = Set up the virtual machines =
+
+ Follow the [[TestInstallVirtualMachine|instructions]] to configure your set of [[SystemVirtualization|virtual machines]] for Debian Edu.
+
+ = Previous content =
+
+ The content below was originally in this Wiki page and will be restructured. Most parts belong in [[TestInstallVirtualMachine]].
+
+ ------
There are three steps required to test the debian edu installation.
More information about the debian-edu-commits
mailing list