keremet/mkimage-profiles
2
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
d7567f3ed8
mkimage-profiles/QUICKSTART

54 lines
1.6 KiB
Plaintext
Raw Normal View History

minor documentation facelift A few more items were asking for some attention. In particular, build examples should start with the most basic, error-proof and quick targets.
2012-08-11 23:31:15 +04:00
English quickstart: make syslinux.iso (after setting up
http://en.altlinux.org/Hasher; large tmpfs helps a lot).
docs updated Minor tweaks to toplevel docs as well as some doc/*.txt, doc/variables.txt renamed to doc/params.txt, and a brand new doc/pkglists.txt is added (thanks manowar@ for his considerations).
2012-06-25 15:52:56 +04:00
official {distro,ve}/* support This is quite a large-scale change since mkimage-profiles got used to baking distributions over the last year, and virtual environments are quite different, so e.g. image.in/Makefile had to be split in two with the main part of it moved into features.in/iso/lib/. Short overview: - features.in/Makefile: lib/ support (supporting VE images requires dynamic modifications to image.in/Makefile before starting the build; the most natural way to achieve that seems to use features mechanism along with makefile include dir) - packaging format related part moved into features.in/pack (should be better prepared for diversity either) - features.in/iso renamed to features.in/build-distro - features.in/ve renamed to features.in/build-ve + NB: these could not be merged as e.g. features.in/build due to completely different script hooks - lib/image.mk renamed to lib/build.mk - image, config, log postprocessing moved downstream - added a sort of a topping in the form of lib/sugar.mk - assorted style fixups (like ifeq usage) - clean.mk: reliability fix (the problem was observed by Oleg Ivanov and me too but finally it did get the attention quantum) - reviewed, updated and extended docs + QUICKSTART: should be[come] a step-by-step guide (thanks Leo-sp50 for prodiving feedback)
2011-10-06 12:46:31 +04:00
требуется
~~~~~~~~~
QUICKSTART: it's p7/t7 or later now 0.6.3 has introduced some changes that were deemed incompatible with t6/p6 branches; it should be possible to restore compatibility at least for non-EFI images but the effort required hasn't been up for grabs so far. See also https://bugzilla.altlinux.org/30474
2014-11-16 21:29:12 +03:00
- ALT Linux 7.0 или выше (возможна адаптация "вниз")
official {distro,ve}/* support This is quite a large-scale change since mkimage-profiles got used to baking distributions over the last year, and virtual environments are quite different, so e.g. image.in/Makefile had to be split in two with the main part of it moved into features.in/iso/lib/. Short overview: - features.in/Makefile: lib/ support (supporting VE images requires dynamic modifications to image.in/Makefile before starting the build; the most natural way to achieve that seems to use features mechanism along with makefile include dir) - packaging format related part moved into features.in/pack (should be better prepared for diversity either) - features.in/iso renamed to features.in/build-distro - features.in/ve renamed to features.in/build-ve + NB: these could not be merged as e.g. features.in/build due to completely different script hooks - lib/image.mk renamed to lib/build.mk - image, config, log postprocessing moved downstream - added a sort of a topping in the form of lib/sugar.mk - assorted style fixups (like ifeq usage) - clean.mk: reliability fix (the problem was observed by Oleg Ivanov and me too but finally it did get the attention quantum) - reviewed, updated and extended docs + QUICKSTART: should be[come] a step-by-step guide (thanks Leo-sp50 for prodiving feedback)
2011-10-06 12:46:31 +04:00
- установленный mkimage (свежий, как и hasher)
QUICKSTART, mktmpdir, build.mk: hasher's /proc Either /etc/hasher-priv/system or /etc/hasher-priv/user.d/$USER must contain at least "allowed_mountpoints=/proc" for mkimage to work for mkimage-profiles; thanks Daniil Golovanov for providing feedback indicating the lack of the corresponding checks.
2016-01-10 12:48:06 +03:00
- пользователь с правом запуска hasher и подключения /proc к нему
official {distro,ve}/* support This is quite a large-scale change since mkimage-profiles got used to baking distributions over the last year, and virtual environments are quite different, so e.g. image.in/Makefile had to be split in two with the main part of it moved into features.in/iso/lib/. Short overview: - features.in/Makefile: lib/ support (supporting VE images requires dynamic modifications to image.in/Makefile before starting the build; the most natural way to achieve that seems to use features mechanism along with makefile include dir) - packaging format related part moved into features.in/pack (should be better prepared for diversity either) - features.in/iso renamed to features.in/build-distro - features.in/ve renamed to features.in/build-ve + NB: these could not be merged as e.g. features.in/build due to completely different script hooks - lib/image.mk renamed to lib/build.mk - image, config, log postprocessing moved downstream - added a sort of a topping in the form of lib/sugar.mk - assorted style fixups (like ifeq usage) - clean.mk: reliability fix (the problem was observed by Oleg Ivanov and me too but finally it did get the attention quantum) - reviewed, updated and extended docs + QUICKSTART: should be[come] a step-by-step guide (thanks Leo-sp50 for prodiving feedback)
2011-10-06 12:46:31 +04:00
полезно
~~~~~~~
QUICKSTART: mention BUILDDIR Some people might end up with setup that leads bin/mktmpdir to accept e.g. tmpfs on /tmp but that's not enough to build a larger image (e.g. 2 Gb RAM); let's quickly hint that it's not the only way to go :-)
2015-11-15 22:23:23 +03:00
- смонтированный tmpfs на несколько гигабайт (или укажите BUILDDIR)
documentation: fix bulleted lists marked with '+'
2012-11-22 08:56:57 +04:00
* например, в /tmp или /home/USER/hasher
* каталог из prefix в /etc/hasher-priv/system
QUICKSTART: tweaked a tiny bit ~/.gitconfig is only relevant when git-core is installed, no need to put it as a standalone item (turned up when discussing things with cas@ on the way from #OSEDUCONF).
2016-02-01 01:04:54 +03:00
- установленный git-core и настроенный ~/.gitconfig
official {distro,ve}/* support This is quite a large-scale change since mkimage-profiles got used to baking distributions over the last year, and virtual environments are quite different, so e.g. image.in/Makefile had to be split in two with the main part of it moved into features.in/iso/lib/. Short overview: - features.in/Makefile: lib/ support (supporting VE images requires dynamic modifications to image.in/Makefile before starting the build; the most natural way to achieve that seems to use features mechanism along with makefile include dir) - packaging format related part moved into features.in/pack (should be better prepared for diversity either) - features.in/iso renamed to features.in/build-distro - features.in/ve renamed to features.in/build-ve + NB: these could not be merged as e.g. features.in/build due to completely different script hooks - lib/image.mk renamed to lib/build.mk - image, config, log postprocessing moved downstream - added a sort of a topping in the form of lib/sugar.mk - assorted style fixups (like ifeq usage) - clean.mk: reliability fix (the problem was observed by Oleg Ivanov and me too but finally it did get the attention quantum) - reviewed, updated and extended docs + QUICKSTART: should be[come] a step-by-step guide (thanks Leo-sp50 for prodiving feedback)
2011-10-06 12:46:31 +04:00
команды
~~~~~~~
documentation: fix lists and blocks in QUICKSTART
2012-11-22 09:14:02 +04:00
от имени root::
----
QUICKSTART: refer to mkimage-preinstall Thanks ksa at Russia-2 forum: http://forum.russ2.com/index.php?showtopic=3784&st=0&p=37927&#entry37927
2013-12-28 01:58:53 +04:00
# apt-get install mkimage mkimage-preinstall hasher git-core
official {distro,ve}/* support This is quite a large-scale change since mkimage-profiles got used to baking distributions over the last year, and virtual environments are quite different, so e.g. image.in/Makefile had to be split in two with the main part of it moved into features.in/iso/lib/. Short overview: - features.in/Makefile: lib/ support (supporting VE images requires dynamic modifications to image.in/Makefile before starting the build; the most natural way to achieve that seems to use features mechanism along with makefile include dir) - packaging format related part moved into features.in/pack (should be better prepared for diversity either) - features.in/iso renamed to features.in/build-distro - features.in/ve renamed to features.in/build-ve + NB: these could not be merged as e.g. features.in/build due to completely different script hooks - lib/image.mk renamed to lib/build.mk - image, config, log postprocessing moved downstream - added a sort of a topping in the form of lib/sugar.mk - assorted style fixups (like ifeq usage) - clean.mk: reliability fix (the problem was observed by Oleg Ivanov and me too but finally it did get the attention quantum) - reviewed, updated and extended docs + QUICKSTART: should be[come] a step-by-step guide (thanks Leo-sp50 for prodiving feedback)
2011-10-06 12:46:31 +04:00
# hasher-useradd USER
documentation: fix lists and blocks in QUICKSTART
2012-11-22 09:14:02 +04:00
----
official {distro,ve}/* support This is quite a large-scale change since mkimage-profiles got used to baking distributions over the last year, and virtual environments are quite different, so e.g. image.in/Makefile had to be split in two with the main part of it moved into features.in/iso/lib/. Short overview: - features.in/Makefile: lib/ support (supporting VE images requires dynamic modifications to image.in/Makefile before starting the build; the most natural way to achieve that seems to use features mechanism along with makefile include dir) - packaging format related part moved into features.in/pack (should be better prepared for diversity either) - features.in/iso renamed to features.in/build-distro - features.in/ve renamed to features.in/build-ve + NB: these could not be merged as e.g. features.in/build due to completely different script hooks - lib/image.mk renamed to lib/build.mk - image, config, log postprocessing moved downstream - added a sort of a topping in the form of lib/sugar.mk - assorted style fixups (like ifeq usage) - clean.mk: reliability fix (the problem was observed by Oleg Ivanov and me too but finally it did get the attention quantum) - reviewed, updated and extended docs + QUICKSTART: should be[come] a step-by-step guide (thanks Leo-sp50 for prodiving feedback)
2011-10-06 12:46:31 +04:00
documentation: fix lists and blocks in QUICKSTART
2012-11-22 09:14:02 +04:00
от имени указанного пользователя (после повторного входа)::
----
official {distro,ve}/* support This is quite a large-scale change since mkimage-profiles got used to baking distributions over the last year, and virtual environments are quite different, so e.g. image.in/Makefile had to be split in two with the main part of it moved into features.in/iso/lib/. Short overview: - features.in/Makefile: lib/ support (supporting VE images requires dynamic modifications to image.in/Makefile before starting the build; the most natural way to achieve that seems to use features mechanism along with makefile include dir) - packaging format related part moved into features.in/pack (should be better prepared for diversity either) - features.in/iso renamed to features.in/build-distro - features.in/ve renamed to features.in/build-ve + NB: these could not be merged as e.g. features.in/build due to completely different script hooks - lib/image.mk renamed to lib/build.mk - image, config, log postprocessing moved downstream - added a sort of a topping in the form of lib/sugar.mk - assorted style fixups (like ifeq usage) - clean.mk: reliability fix (the problem was observed by Oleg Ivanov and me too but finally it did get the attention quantum) - reviewed, updated and extended docs + QUICKSTART: should be[come] a step-by-step guide (thanks Leo-sp50 for prodiving feedback)
2011-10-06 12:46:31 +04:00
$ git config --global user.email "my@email"
$ git config --global user.name "My Name"
QUICKSTART: mention ~/tmp This has to be present with default RPM macros, otherwise: rpmdb: /home/altlinux/tmp: No such file or directory rpmdb: unable to create temporary backing file See also http://bugzilla.altlinux.org/26514
2014-03-17 20:53:23 +04:00
$ mkdir -p ~/out ~/tmp
documentation: fix lists and blocks in QUICKSTART
2012-11-22 09:14:02 +04:00
----
official {distro,ve}/* support This is quite a large-scale change since mkimage-profiles got used to baking distributions over the last year, and virtual environments are quite different, so e.g. image.in/Makefile had to be split in two with the main part of it moved into features.in/iso/lib/. Short overview: - features.in/Makefile: lib/ support (supporting VE images requires dynamic modifications to image.in/Makefile before starting the build; the most natural way to achieve that seems to use features mechanism along with makefile include dir) - packaging format related part moved into features.in/pack (should be better prepared for diversity either) - features.in/iso renamed to features.in/build-distro - features.in/ve renamed to features.in/build-ve + NB: these could not be merged as e.g. features.in/build due to completely different script hooks - lib/image.mk renamed to lib/build.mk - image, config, log postprocessing moved downstream - added a sort of a topping in the form of lib/sugar.mk - assorted style fixups (like ifeq usage) - clean.mk: reliability fix (the problem was observed by Oleg Ivanov and me too but finally it did get the attention quantum) - reviewed, updated and extended docs + QUICKSTART: should be[come] a step-by-step guide (thanks Leo-sp50 for prodiving feedback)
2011-10-06 12:46:31 +04:00
QUICKSTART: minor tweak It was found out during the "from scratch" walkthrough over http://altlinux.org/m-p with a new user that the proposed test build run isn't clear regarding the proper current working directory (wiki refers to QUICKSTART copy over at http://git.altlinux.org, and this file has been written with assumption that it's being read from within the repository's toplevel directory; the resulting context isn't consistent in that regard).
2015-04-03 22:10:23 +03:00
тестовая сборка (в каталоге mkimage-profiles)::
documentation: fix lists and blocks in QUICKSTART
2012-11-22 09:14:02 +04:00
----
minor documentation facelift A few more items were asking for some attention. In particular, build examples should start with the most basic, error-proof and quick targets.
2012-08-11 23:31:15 +04:00
$ make syslinux.iso
documentation: fix lists and blocks in QUICKSTART
2012-11-22 09:14:02 +04:00
----
official {distro,ve}/* support This is quite a large-scale change since mkimage-profiles got used to baking distributions over the last year, and virtual environments are quite different, so e.g. image.in/Makefile had to be split in two with the main part of it moved into features.in/iso/lib/. Short overview: - features.in/Makefile: lib/ support (supporting VE images requires dynamic modifications to image.in/Makefile before starting the build; the most natural way to achieve that seems to use features mechanism along with makefile include dir) - packaging format related part moved into features.in/pack (should be better prepared for diversity either) - features.in/iso renamed to features.in/build-distro - features.in/ve renamed to features.in/build-ve + NB: these could not be merged as e.g. features.in/build due to completely different script hooks - lib/image.mk renamed to lib/build.mk - image, config, log postprocessing moved downstream - added a sort of a topping in the form of lib/sugar.mk - assorted style fixups (like ifeq usage) - clean.mk: reliability fix (the problem was observed by Oleg Ivanov and me too but finally it did get the attention quantum) - reviewed, updated and extended docs + QUICKSTART: should be[come] a step-by-step guide (thanks Leo-sp50 for prodiving feedback)
2011-10-06 12:46:31 +04:00
QUICKSTART: mention `make help' It wasn't really obvious what are the available targets; sorry for that and thanks led@ for a suggestion.
2013-02-21 21:45:31 +04:00
список доступных целей::
----
$ make help
----
QUICKSTART: tweaked build example for readability aris@ suggested that the most important variables, namely ARCH and APTCONF, be spelled out explicitly.
2013-03-25 22:47:36 +04:00
переменные, влияющие на результат (подробнее в doc/params.txt)::
---
$ make ARCH=i586 APTCONF=~/apt/apt.conf.i586 REPORT=1 ve/generic.tar
---
official {distro,ve}/* support This is quite a large-scale change since mkimage-profiles got used to baking distributions over the last year, and virtual environments are quite different, so e.g. image.in/Makefile had to be split in two with the main part of it moved into features.in/iso/lib/. Short overview: - features.in/Makefile: lib/ support (supporting VE images requires dynamic modifications to image.in/Makefile before starting the build; the most natural way to achieve that seems to use features mechanism along with makefile include dir) - packaging format related part moved into features.in/pack (should be better prepared for diversity either) - features.in/iso renamed to features.in/build-distro - features.in/ve renamed to features.in/build-ve + NB: these could not be merged as e.g. features.in/build due to completely different script hooks - lib/image.mk renamed to lib/build.mk - image, config, log postprocessing moved downstream - added a sort of a topping in the form of lib/sugar.mk - assorted style fixups (like ifeq usage) - clean.mk: reliability fix (the problem was observed by Oleg Ivanov and me too but finally it did get the attention quantum) - reviewed, updated and extended docs + QUICKSTART: should be[come] a step-by-step guide (thanks Leo-sp50 for prodiving feedback)
2011-10-06 12:46:31 +04:00
ссылки
~~~~~~
- http://www.altlinux.org/tmpfs
- http://www.altlinux.org/hasher
- http://www.altlinux.org/mkimage
minor documentation facelift A few more items were asking for some attention. In particular, build examples should start with the most basic, error-proof and quick targets.
2012-08-11 23:31:15 +04:00
- http://www.altlinux.org/m-p
QUICKSTART: added howto reference It's actually worth working into the offline docs probably but it appears that overlooking this howto's existence is easier than I thought; thanks manowar@ for pointing this out.
2014-05-31 22:11:37 +04:00
- http://www.altlinux.org/m-p-howto ("как поправить под себя")
Reference in New Issue Copy Permalink