Install:

run all commands from root (as superuser)


install dependency packages:
    you need: bash sudo uuid-runtime aufs-tools fuse genisoimage mutt
    for apt based OS use command:
        apt-get install bash sudo uuid-runtime aufs-tools fuse genisoimage mutt


create and edit config file:
    use config.sh.blank as a base:
        cp config.sh.blank config.sh

    we use config (some_path is a fake):
        PACKET_BUILD_DIR=/some_path/builder-packet
        chrooter() {
            export CHROOTER_PREFIX="/some_path_to_mount"
            $BASE_DIR/chrooter/chrooter.sh $@
        }
        OPENTOONZ_TESTING_TAG="morevna"
        export EMAIL_FAILED="e@mail.org"
        export EMAIL_SUCCESS="$EMAIL_FAILED"
        export EMAIL_SUBJECT="builder task finished"

    for emails configure ~/.muttrc, for example:
        set smtp_url=smtps://login:password@server.org
        set from="My Mail Bot <e@mail.org>"
        set record=
    see "background tasks" below


download virtual environment:
    you may download our (we are Morevna Project team) os images from:
        https://coolbug.org/downloads/morevna/builder-images/

    you need two files:
        https://coolbug.org/downloads/morevna/builder-images/morevnaproject_build-debian-7-32.iso
        https://coolbug.org/downloads/morevna/builder-images/morevnaproject_build-debian-7-64.iso
    approximate 6.5Gb, place both into chrooter/images/


build virtual environment:
    if you does not want to download os images you can build it

    before begin you may configure debian mirror in files:
        env/debian-7-32bit/files/sources.list
        env/debian-7-64bit/files/sources.list
        env/debian-7-32bit/build-iso.sh into variable apt_mirror
        env/debian-7-64bit/build-iso.sh into variable apt_mirror

    here you still can download a base debian images from:
        https://coolbug.org/downloads/morevna/builder-images/debian-wheezy-i386.iso
        https://coolbug.org/downloads/morevna/builder-images/debian-wheezy-amd64.iso
    approximate 500Mb, place first into env/debian-7-32bit and second into env/debian-7-64bit

    or build these images from scratch by debootstrap
    install debootstarp:
        apt-get install debootstrap
    and build base debian images
        cd env/debian-7-32bit # go to env/debian-7-32bit
        ./build-iso.sh
        cd ../debian-7-64bit  # go to env/debian-7-64bit
        ./build-iso.sh
        cd ../..              # go back
    after that will appear two new files:
        env/debian-7-32bit/debian-wheezy-i386.iso
        env/debian-7-64bit/debian-wheezy-amd64.iso


    now when you have files debian-wheezy-XXXX.iso you can build os images for builder
    it's a long process because it will build GCC and MinGW from scratch
    run commands:
        cd env/debian-7-32bit # go to env/debian-7-32bit
        ./build-base.sh       # just to copy base os image into chrooter/images
        ./build.sh            # a long build process
        cd ../debian-7-64bit  # go to env/debian-7-64bit
        ./build-base.sh       # just to copy base os image into chrooter/images
        ./build.sh            # a long build process
        cd ../..              # go back

    build environment ready


installation done


also you may download full backets build data made by us:
    https://coolbug.org/downloads/morevna/builder-images/
    https://coolbug.org/downloads/morevna/builder-images/builder-packets--YYYY-MM-DD.tar.gz
approximate 20Gb compressed and 75Gb after decompress
NB: build data contains a lot of hardlinks so make sure that you unpack it properly (tar -xf)



Let's build something:


now you may build packages by macro script:
    see files ./build-*.sh

also you can add hooks to publish built packages:
    for example create file publish/publish-synfigstudio.sh with content:
        #!/bin/bash
        cp "$1" /var/www/public/downloads/
    when build is done new synfigstudio packge will placed into web-site directory
    you may look file publish/publish.sh for more info

run internal builder commands in virtual environment:
    cd env
    ./run.sh some_command

also you may use:
    env/debian-7-32bit/run.sh
    env/debian-7-64bit/run.sh
    env/debian-7-64bit/win32.sh
    env/debian-7-64bit/win64.sh

run build commands in native environment
    ./run-native.sh some_command

build a selected package:
    cd env
    ./run.sh env_release MEGAPROGRAM-1.0.0

take files from directory
    env-builder-data/build/packet/linux-x64/MEGAPROGRAM-1.0.0/env_release
or
    your_build_path/packet/linux-x64/MEGAPROGRAM-1.0.0/env_release


"dry_run" option for paranoics:
    ./run.sh dry_run with_deps unpack MEGAPROGRAM-1.0.0 

List of commands
    <action> <packet>
        do <action> for <packet>
        List of actions:
        - download
        - unpack
        - build
        - install
        - install_release
        - envdeps
        - envdeps_release
        - env
        - env_release

    dry_run <any other command>
        - simulate activity

    with_deps <command> <packet>
        - execute <command> for <packet> and all deps
          for example, you can call download for all deps without build:
                run.sh with_deps download mypacket

    clean_ACTION <packet>
        - remove all data of completed ACTION for <packet>
        ex.: clean_unpack MEGAPROGRAM-1.0.0

    clean_all_unpack <packet>
        - cleans download and unpack
        see: clean_ACTION <packet>

    clean_all_env <packet>
        - cleans install, install_release, envdeps, envdeps_release, env and env_release
        see: clean_ACTION <packet>

    clean_all_install <packet>
        - cleans all env and build
        see: clean_all_env <packet>, clean_ACTION <packet>

    clean_all <packet>
        - remove all data of all completed actions for <packet>

    set_undone_ACTION <packet>
    set_undone_all_unpack <packet>
    set_undone_all_env <packet>
    set_undone_all_install <packet>
    set_undone_all <packet>
        - mark ACTION incomplete for <packet>, but keep action data
        see: clean_* comands

    shell <packet>
        - run shell in environment of <packet>

    chain <command> chain <other_command> ...
        - run several command sequentially wihtout remounting of environment to increase speed

see also
    env-builder-data/build/script/common/manager.sh


Background tasks:
    to call task in background use:
        backgrouns.sh some_command
    command will run in background and result will be sent to email (see config.sh)
    if you do not want to receive emai about success result (look only errors), call:
        backgrouns.sh -q some_command
    logs stored in log/background.log


Troubles:
    sometimes virtual environmens does not unmounted properly
    to clear this you need to unmount all mounts for */chrooter-*
    look mounts list by command:
        mount

    unmount by command:
        umount "/some_path/chrooter-SOME_UUID"
    or with "force" option
        umount -f "/some_path/chrooter-SOME_UUID" 
    or with "lazy" option
        umount -l "/some_path/chrooter-SOME_UUID" 
    and check againt with
        mount

    after that remove the files
    you MUST do unmount before, if some dir are still mounted you can remove some system files
    we recommend to check content of directories before remove
    option "--one-file-system" for additional protection but anyway BE CAREFULL!!
    command:
        rm -rf --one-file-system /some_path/chrooter-*