[Starlingx-discuss] Build installer instructions

[Hu, Yong]

Hi Erich,
I would suggest to highlight that the following 2 files need to exist BEFORE running " $ update-pxe-network-installer"
"$MY_REPO/$CENTOS_REPO/Binary/images/pxeboot/initrd.img"
"$MY_REPO/$CENTOS_REPO/Binary/LiveOS/squashfs.img"

- Yong

On 18/09/2018, 11:51 PM, "Cordoba Malibran, Erich" <erich.cordoba.malibran at intel.com> wrote:

    Thanks for the feedback :)
    
    I updated the documentation in the wiki. I included the note that this
    procedure doesn't need to be done frequently..
    
    Here is the wiki link: https://wiki.openstack.org/wiki/StarlingX/Developer_Guide#Build_installer
    
    -Erich
    
    On Mon, 2018-09-17 at 16:40 +0000, Penney, Don wrote:
    > It's good to note that if you've already got installer images
    > generated (ie. on a shared system, in /import/mirror/CentOS/tis-
    > installer), you don't need to run "build-pkgs --installer". So
    > presumably, this would not be part of a general designer workflow.
    > 
    > Historically, we upversioned these images whenever they were updated,
    > but this introduces some challenges under Starling-X. It may make
    > sense to drop the version number from the images as referenced in the
    > pxe-network-installer package build, essentially treating it as a
    > .latest version. Individuals or groups could then manage their own
    > installer version history as they see fit, ie. build images with 0.1,
    > 0.2, 0.3, with symlinks to the latest perhaps. If these images aren't
    > being hosted somewhere, if individuals/groups are generating their
    > own, then the versioning shouldn't be in the build files.
    > 
    > 
    > 
    > -----Original Message-----
    > From: Cordoba Malibran, Erich [mailto:erich.cordoba.malibran at intel.co
    > m] 
    > Sent: Monday, September 17, 2018 12:12 PM
    > To: starlingx-discuss at lists.starlingx.io
    > Subject: [Starlingx-discuss] Build installer instructions
    > 
    > Hi, 
    > 
    > I would like to share/discuss the instructions to generate the
    > installer before are publish into the wiki. I couldn't find a
    > previous
    > version of these instructions, probably I confused with this warning
    > from the download_mirror.sh[0]. The update-pxe-network-installer
    > script
    > follows the steps detailed here[1].
    > 
    > Build installer
    > ===============
    > 
    > To get your StarlingX ISO ready to use, you will need to create the
    > init files that will be used to boot the ISO as well to boot
    > additional
    > controllers and compute nodes.
    > 
    > Once you had run `build-iso`, run:
    > 
    > ```
    > build-pkgs --installer
    > ```
    > 
    > This will build `rpm` and `anaconda` packages. Then run:
    > 
    > ```
    > update-pxe-network-installer
    > ```
    > 
    > The update-pxe-network-installer` covers the steps detailed in
    > `$MY_REPO/stx/stx-metal/installer/initrd/README`. This script will
    > create three files on `/localdisk/loadbuild/<user>/<project>/pxe-
    > network-installer/output`
    > 
    > ```
    > new-initrd.img
    > new-squashfs.img
    > new-vmlinuz
    > ```
    > 
    > Then, rename them to:
    > 
    > ```
    > initrd.img-stx-0.2
    > squashfs.img-stx-0.2
    > vmlinuz-stx-0.2
    > ```
    > 
    > There are two ways to use these files:
    > 
    > 1. Store the files in the '/import/mirror/CentOS/tis-installer/`
    > folder  for future use.
    > 2. Store it in an arbitrary location and modify the
    > `$MY_REPO/stx/stx-
    > metal/installer/pxe-network-installer/centos/build_srpm.data` file to
    > point to these files.
    > 
    > Now, the `pxe-network-installer` package needs to be recreated and
    > the
    > ISO regenerated.
    > 
    > ```
    > build-pkgs --clean pxe-network-installer
    > build-pkgs pxe-network-installer
    > build-iso
    > ```
    > 
    > Now your ISO should be able to boot. 
    > 
    > Updating these files is not a common tasks, it is recommended only do
    > it if the kernel version is upgraded or new kernel modules are added.
    > 
    > 
    > =====================
    > End of documentation
    > 
    > 
    > 
    > [0] http://git.starlingx.io/cgit/stx-tools/tree/centos-mirror-tools/d
    > ownload_mirror.sh#n264
    > [1] http://git.starlingx.io/cgit/stx-metal/tree/installer/initrd/READ
    > ME
    > _______________________________________________
    > Starlingx-discuss mailing list
    > Starlingx-discuss at lists.starlingx.io
    > http://lists.starlingx.io/cgi-bin/mailman/listinfo/starlingx-discuss
    _______________________________________________
    Starlingx-discuss mailing list
    Starlingx-discuss at lists.starlingx.io
    http://lists.starlingx.io/cgi-bin/mailman/listinfo/starlingx-discuss