File: INSTALL

package info (click to toggle)
boxer 1.4.3-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 1,236 kB
  • sloc: perl: 2,063; sh: 22; makefile: 5
file content (45 lines) | stat: -rw-r--r-- 1,261 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
Boxer installation
==================

Preparations
------------

On Debian 8+ (Jessie or newer), or Debian unstable (Sid),
boxer is available as a regular package:

    apt install boxer

Alternatively install from CPAN, and only helper tools from Debian:

    cpanm Boxer
    apt install mmdebstrap || apt install debootstrap


Usage
-----

    cp /usr/share/doc/boxer/examples/nodes/parl-greens.yml .
    boxer compose parl-greens

    cp /usr/share/doc/boxer/examples/nodes/lxp5.yml .
    boxer bootstrap lxp5 -- lxp5_rootfs
    sudo -- boxer bootstrap --helper debootstrap lxp5 -- lxp5_rootfs

NB! If code was pulled from CPAN or git, you may need to adapt location
of example file and environment variables PATH PYTHONPATH PERL5LIB.


Development
-----------

    git clone https://salsa.debian.org/boxer-team/boxer
    cd boxer
    PERL5LIB=lib bin/boxer compose --skeldir share/skel --datadir examples parl-greens
    PERL5LIB=lib bin/boxer bootstrap --skeldir share/skel --datadir examples lxp5

You may want to explore the larger dataset in active use:

    git clone https://salsa.debian.org/boxer-team/boxer-data.git

System compositions are expressed using a set of YAML files.
See the README in the sample data dir for more info on its structure.