diff --git a/installers/deb_package_build/readme.md b/installers/deb_package_build/readme.md index e69de29b..3ad74b8d 100644 --- a/installers/deb_package_build/readme.md +++ b/installers/deb_package_build/readme.md @@ -0,0 +1,24 @@ +To prepare your environment for building .deb package install instruments:
+`sudo apt-get install build-essential devscripts debhelper`
+
+Important: to build .deb package archive name must be in the format $(name)\_$(version).orig.tar.gz
and directory within it must be named as $(name)\_$(version)

+ +This build uses dh-virtualenv. For installation please follow the [tutorial] (http://dh-virtualenv.readthedocs.org/en/0.10/tutorial.html) + +To build debian package from scratch:
+1) make working directory (basically with any name) near archive bench_0.92.orig.tar.gz:
+`mkdir build_dir`
+2) copy debian directory in there:
+`cp -r debian/ build_dir/`
+3) change directory:
+`cd build_dir/`
+4) run package build:
+`debuild -us -uc`
+5) install resulting package:
+`sudo dpkg -i ../bench_0.92_amd64.deb`
+Please note that name of package contains your architecture so for 32-bit machines name will differ.
+
+Current state: runs without problems on all Ubuntu versions installing bench in `/usr/share/python/bench/bin/bench`. Fails on Debian 8 with version format conflict. + +Useful links: +[Introduction to Debian Packaging](https://wiki.debian.org/IntroDebianPackaging#Step_3:_Add_the_Debian_packaging_files) diff --git a/installers/rpm_package_build/readme.md b/installers/rpm_package_build/readme.md index e69de29b..672b9ab4 100644 --- a/installers/rpm_package_build/readme.md +++ b/installers/rpm_package_build/readme.md @@ -0,0 +1,38 @@ +Important: +* archive name must be in the format $(name)-$(version).tar.gz +and directory within it must be named as $(name)-$(version)
+* filename of the .spec file must be exactly as a package name, do not change it
+* do not run `rpmdev-setuptree` and `rpmbuild` as a root user
+ +To prepare your environment for building .rpm package do the following:
+1. install instruments:
+`sudo yum install epel-release rpmdevtools yum-utils`
+2. create directory hierarchy for rpm (this will create directory ~/rpmbuild with the subdirectories BUILD RPMS SOURCES SPECS SRPMS):
+`rpmdev-setuptree`
+3. place `bench.spec` into ~/rpmbuild/SPECS
+4. place `bench-0.92.tar.gz` into ~/rpmbuild/SOURCES
+5. install all required for .rpm building dependencies:
+`yum-builddep ~/rpmbuild/SPECS/bench.spec` +
+ +To build .rpm package run:
+`rpmbuild -ba ~/rpmbuild/SPECS/bench.spec`
+The resulting .rpm will be in `~/rpmbuild/RPMS/` and .srpm in `~/rpmbuild/SRPMS` + +To install .rpm package run:
+`sudo yum localinstall path/to/rpm/package`
+
+Current state: builds ok but resulting bench fails with the error:
+`Traceback (most recent call last):`
+`File "/usr/bin/bench", line 7, in `
+`from bench.cli import cli`
+`ImportError: No module named bench.cli`
+ +Useful links: +[rpm packaging tutorial] (http://www.ibm.com/developerworks/library/l-rpm1/) + + + + + +