From Fedora Project Wiki

(Adding build notes for Anaconda development)
(Updated the anaconda development instructions, pointed to docs for lorax and livemedia-creator)
 
(34 intermediate revisions by the same user not shown)
Line 1: Line 1:
Nothing to see here yet.
[http://www.brianlane.com Personal homepage]


[http://www.brianlane.com Homepage]
[https://src.fedoraproject.org/user/bcl Fedora packages I am maintainer of, or involved with]


== Anaconda Development ==
== Misc ==


* [http://bcl.fedorapeople.org/scripts/git-changelog git-changelog] A simplified version of dcantrell's [http://git.fedorahosted.org/git/?p=anaconda.git;a=blob;f=scripts/makebumpver;hb=HEAD makebumpver] script, it prints a nice summary of commits since the specified tag, suitable for use in a rpm spec file %changelog section.
* [http://bcl.fedorapeople.org/ update images, logs, etc.]


Development System
== Anaconda Development ==
* Fedora 12
* squid proxy to cache packages
* lighttpd to serve up updates.img
* tftpd to serve up pxe boot images
* mock + pungi for building


== mock setup ==
* grab the relevant boot.iso for the release you are working on
  https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/images/boot.iso
  (I use Everything because it has, well, everything)


* <code> yum install mock </code>
* Boot the iso in a VM and check the anaconda version in the boot.iso
* Edit the <code>/etc/mock/</code> file for the distribution or copy it to a new name and edit
  This version can be used to set where in history the makeupdates script starts grabbing changes from.
** Add <code>proxy=http://proxy.home:3128</code> to the main section.
  Use virt-viewer->Send key->Ctrl+Alt+F1 to switch to the tmux console, the version will be at the top
** comment out mirrorlist entries
** Open up the mirror list url(s) in a browser and pick a mirror, use the same one for base and updates
** Add <code>baseurl=<mirror url></code> in each section instead of mirrorlist
** Do this for each section with a mirrorlist
* Setup the initial mock environment, replace the fedora-13-i386 with the mock file edited above
** <code>mock -r fedora-13-i386 --init</code>
** <code>mock -r fedora-13-i386 --no-clean --install pungi</code>
* Enter the chroot - <code> mock -r fedora-13-i386 --shell </code>
** Edit <code> /usr/lib/anaconda-runtime/buildinstall </code>
*** add <code> proxy=http://proxy.home:3128 </code> to the main section of the yum config embedded in it.
** Edit <code> /usr/lib/python2.6/site-packages/pypungi/__init__.py </code> to add:
<pre>
diff --git a/src/pypungi/__init__.py b/src/pypungi/__init__.py
index e57e72a..d30eefa 100644
--- a/src/pypungi/__init__.py
+++ b/src/pypungi/__init__.py
@@ -206,6 +206,8 @@ class Pungi(pypungi.PungiBase):
                thisrepo.cost = repo.cost
            if repo.ignoregroups:
                thisrepo.enablegroups = 0
+            if repo.proxy:
+                thisrepo.proxy = repo.proxy
            self.ayum.repos.add(thisrepo)
            self.ayum.repos.enableRepo(thisrepo.id)
            self.ayum._getRepos(thisrepo=thisrepo.id, doSetup = True)
--
1.6.6.1
</pre>


This patch should be in the next release of pungi, but check to make sure just to be safe.
* Branch anaconda from the release you are working on
  Make some changes (eg. start out by adding a log.info("FOO WAS HERE") to ./anaconda right before the
  anaconda._intf.setup(ksdata) line.


Now you have a mock chroot environment setup that will use the proxy cache for packages.
* Run ./scripts/makeupdates to generate an updates.img
  If you're curious about what it put into it, run with -k and it will keep the ./updates/ directory with all
  the files it put into it.
  If the version on the boot.iso is older than the most recent anaconda tag (shown by git log) you will
  need to tell the script that, by running it like:


  ./scripts/makeupdates -t anaconda-29.18-1


== Building boot images ==
  (the boot.iso I have is .18 and the current branch is tagged as .19 so you need to include
  all changes since .18 in the updates.img)


Use the compose and pungi.ks files below, place them into /root/ in the mock to be built:
* Setup a webserver to serve up the updates.img
  This can be as simple as: mkdir /tmp/updates; cp updates.img /tmp/updates; cd /tmp/updates; python3 -m http.server
  You'll need to know the IP of your workstation, and may need to open up port 8000 so the VM can access
  the webserver. You can do this with firewalld by by running:


* pungi.ks
  firewall-cmd  --add-port=8000/tcp && firewall-cmd --permanent --add-port=8000/tcp
<pre>
# un-comment the applicable repo


repo --name=fedora --baseurl=http://mirrors.cat.pdx.edu/fedora/linux/development/13/i386/os/ --proxy=http://proxy.home:3128
* Then reboot the VM with the boot.iso, and interrupt the boot screen (I hit the up arrow to select the
  first entry), hit tab to edit it, delete 'quiet' to enable boot message output, and add:


# Very small install footprint
  updates=http://IP-TO-DEVBOX:8000/updates.img
%packages
@base
kernel
syslinux
nomtools
anaconda
%end
</pre>


* compose
  And hit enter to boot with the updates.img
<pre>
#!/bin/bash
echo "*** Running pungi --force --nosource --nodebuginfo --nosplitmedia -G -C -B -c /root/pungi.ks --ver=13"


pungi --cachedir=/extra/released/pungi/cache --force --nosource --nodebuginfo --nosplitmedia -G -C -B -c /root/pungi.ks --ver=13
After it boots switch to the tmux console and check /tmp/anaconda.log for your new log message (FOO WAS HERE)
echo "*** Done."
</pre>
* <code> chmod a+x compose </code>
* <code> exit </code>
* <code> mock -r fedora-13-i386 --chroot "/root/compose" </code>


Change the --ver to match whichever release you are building for
If it doesn't boot it is likely a problem reading the updates.img, which can be a networking issue (VM not able
to connect to the host) or the port (8000 in this case) isn't open.


== Building boot images ==


== Building updates ==
See the [http://weldr.io/lorax/lorax.html Lorax documentation]
 
Anaconda includes the ability to update itself by passing <code>updates=http://path/to/update.img</code> to the kernel at boot time. This allows you to use the same boot media and test changes to  stage2 of the installer.
 
* This assumes a working mock chroot (ie. I built boot images with this one first)
* You need a git repo of Anaconda, I branch for the build so I don't clutter up master with build by-products.
** <code> git clone git://git.fedorahosted.org/anaconda.git </code>
** <code> cd anaconda; git checkout -b build-upates </code>
* bind the anaconda directory to the mock being used (needs to be done as root)
** <code> mkdir /var/lib/mock/fedora-13-i386/root/root/anaconda/ </code>
** <code> mount -o bind /home/bcl/projs/anaconda/ /var/lib/mock/fedora-13-i386/root/root/anaconda/ </code>
* enter the chroot
** <code> mock -v -r fedora-13-i386 --shell </code>
** Install the development tools group
*** <code> yum groupinstall "development tools" </code>
** grab a copy of the current anaconda*src.rpm from someplace and install the dependencies with:
*** <code> yum-builddep anaconda*src.rpm </code>
** now build anaconda
*** <code> ./autogen.sh </code>
*** <code> ./configure </code>
*** <code> make updates </code>
** <code> exit </code>
* copy the updates.img over to the updates directory and optionally rename it
** <code> cp /var/lib/mock/fedora-13-i386/root/root/anaconda/updates.img /home/tftpboot/images/updates/ </code>
 
You can skip installing development tools and anaconda deps for subsequent iterations.
 
Now add <code> updates=http://proxy.home/updates/updates.img </code> to the kernel parameters when booting the install media.
 
 
== Build with a test anaconda.rpm ==
 
Normally when a punji build is done it pulls anaconda from the repo/proxy cache. Instead you want it to use your new build (ie. when doing stage1 development which cannot be updated by updates= being passed to the kernel)
 
* <code> mount -o bind /home/bcl/Red_Hat/projs/anaconda/ /var/lib/mock/fedora-13-i386/root/root/anaconda/ </code>
* <code> mock -v -r fedora-13-i386-proxy --shell </code>
* <code> cd /root/anaconda </code>
* Removed the cached files. Otherwise it pull pull from there and not update to the latest
** <code> rm -rf /13 </code>
** <code> rm -rf /extra/released/pungi/cache </code>
* <code> ./autogen.sh </code>
* <code> ./configure </code>
* <code> make scratch </code>
* <code> rpmbuild -ts --nodeps anaconda...tar.gz </code>
* <code> yum-builddep /builddir/build/SRPMS/anaconda...src.rpm </code>
* <code> rpmbuild --rebuild  /builddir/build/SRPMS/anaconda...src.rpm </code>
* <code> mkdir /repo </code>
* <code> cp /builddir/build/RPMS/anaconda...rpm /repo </code>
* <code> createrepo /repo </code>
* edit <code> /root/pungi.ks </code> and add
** <code> repo --name=local --baseurl=file:///repo/ </code>
* <code> exit </code>
* <code> mock -v -r fedora-13-i386 --chroot "/root/compose" </code>
* <code> rsync -avc /var/lib/mock/fedora-13-i386/root/13/i386/os/images/ /home/tftpboot/images/fedora/13/i386/ </code>
 
Boot with the pxe image and see what happens
 
== Update boot.iso with new anaconda rpm ==


After you have a working boot.iso you can easily update it with the files from the new anaconda rpm you built above. Use the [[http://bcl.fedorapeople.org/scripts/upd_bootiso | upd_bootiso]] script to do this:
== Creating a disk image ==


<code>upd_bootiso boot.iso anaconda-13.35-1.fc13.i686.rpm</code>
See the [http://weldr.io/lorax/livemedia-creator.html livemedia-creator documentation]


This will extract the files from initrd.img and install.img on the boot.iso, update the files and then re-build the boot.iso
== Moving a project to github ==


This is considerably faster than using mock + pungi to compose a whole new iso from scratch.
* Make a new repo there (in rhinstaller or wherever it is going)
* Edit .git/config and make a copy of the origin section, replace the url with the new one.
* rename the old origin to something descriptive like 'fedorahosted' and also change the fetch line so the origin is replaced by this new name.
* on master run git push -u origin master to push it to the new location on github
* git push --tags
* git checkout rhel7-branch && git push -u origin rhel7-branch
* Repeat for any other active branches.
* git fetch fedorahosted
* git checkout -b fh-master fedorahosted/master
* git rm -r * && git rm .gitignore
* create and edit a dead.repo file
* git add dead.repo
* git commit -m "Moved XX to github"
* git push --dry-run
* If the destination looks correct, git push and if not, git push fedorahosted HEAD:<branchname>

Latest revision as of 18:20, 29 June 2018

Personal homepage

Fedora packages I am maintainer of, or involved with

Misc

Anaconda Development

  • grab the relevant boot.iso for the release you are working on
 https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/images/boot.iso
 (I use Everything because it has, well, everything)
  • Boot the iso in a VM and check the anaconda version in the boot.iso
 This version can be used to set where in history the makeupdates script starts grabbing changes from.
 Use virt-viewer->Send key->Ctrl+Alt+F1 to switch to the tmux console, the version will be at the top
  • Branch anaconda from the release you are working on
 Make some changes (eg. start out by adding a log.info("FOO WAS HERE") to ./anaconda right before the
 anaconda._intf.setup(ksdata) line.
  • Run ./scripts/makeupdates to generate an updates.img
 If you're curious about what it put into it, run with -k and it will keep the ./updates/ directory with all
 the files it put into it.
 If the version on the boot.iso is older than the most recent anaconda tag (shown by git log) you will
 need to tell the script that, by running it like:
 ./scripts/makeupdates -t anaconda-29.18-1
 (the boot.iso I have is .18 and the current branch is tagged as .19 so you need to include
 all changes since .18 in the updates.img)
  • Setup a webserver to serve up the updates.img
 This can be as simple as: mkdir /tmp/updates; cp updates.img /tmp/updates; cd /tmp/updates; python3 -m http.server
 You'll need to know the IP of your workstation, and may need to open up port 8000 so the VM can access
 the webserver. You can do this with firewalld by by running:
 firewall-cmd  --add-port=8000/tcp && firewall-cmd --permanent --add-port=8000/tcp
  • Then reboot the VM with the boot.iso, and interrupt the boot screen (I hit the up arrow to select the
 first entry), hit tab to edit it, delete 'quiet' to enable boot message output, and add:
 updates=http://IP-TO-DEVBOX:8000/updates.img
 And hit enter to boot with the updates.img

After it boots switch to the tmux console and check /tmp/anaconda.log for your new log message (FOO WAS HERE)

If it doesn't boot it is likely a problem reading the updates.img, which can be a networking issue (VM not able to connect to the host) or the port (8000 in this case) isn't open.

Building boot images

See the Lorax documentation

Creating a disk image

See the livemedia-creator documentation

Moving a project to github

  • Make a new repo there (in rhinstaller or wherever it is going)
  • Edit .git/config and make a copy of the origin section, replace the url with the new one.
  • rename the old origin to something descriptive like 'fedorahosted' and also change the fetch line so the origin is replaced by this new name.
  • on master run git push -u origin master to push it to the new location on github
  • git push --tags
  • git checkout rhel7-branch && git push -u origin rhel7-branch
  • Repeat for any other active branches.
  • git fetch fedorahosted
  • git checkout -b fh-master fedorahosted/master
  • git rm -r * && git rm .gitignore
  • create and edit a dead.repo file
  • git add dead.repo
  • git commit -m "Moved XX to github"
  • git push --dry-run
  • If the destination looks correct, git push and if not, git push fedorahosted HEAD:<branchname>