git-lfs/rpm/INSTALL.md

# Building RPMs #

All of the code to build the RPM is stored in a SPECS/git-lfs.spec file. The source 
code tarball needs to be put in a SOURCES directory. A BUILD and BUILDROOT directory 
is used during the build process, and the final RPM ends up in the RPMS directory, 
and a source-rpm in SRPMS

In order to expedite installing all dependencies (mainly ruby-rconn and golang) and 
download any files (outside of yum) a build_rpms.bsh script is included. This is the 
**RECOMMENDED** way to build the rpms. It will install all yum packages in order to
build the rpm. This can be especially difficult in CentOS 5 and 6, but it will build
and install a suitable golang/ruby so that git-lfs can be built.

Simple run:

```
./clean.bsh
./build_rpms.bsh
```

The clean.bsh script removes previoeu rpms, etc... and removed the source tar.gz
file. Otherwise you might end up creating an rpm with pieces from different versions

Practice is to run rpmbuild as non-root user. This prevents inadvertently installing
files in the operating system. The intent was to run build_rpms.bsh as a non-root user
with sudo privileges. If you have a different command for sudo, or do not have sudo
installed (which is possible, but unlikely), you can set the SUDO environment variable
to nothing or another command and you can run as root if that is your style. Example:

```
./clean.bsh
SUDO=echo ./build_rpms.bsh
  or
(as root) SUDO= ./build_rpms.bsh
```

(The echo example will let you know what yum commands you need to run to make the build
work. Not ideal, but 95% of people will just run ```./build_rpms.bsh``` and have it work)

When all is down, install (or distribute) RPMS/git-lfs.rpm 

### Alternative build 1 ###

If you want to use your own ruby/golang without using the version from build_rpms.bsh,
you will have to disable dependencies on the rpms. It's pretty easy, just make sure
rconn and go are in the path, and run

```
NODEPS=1 ./build_rpms.bsh
```

### Alternative build 2 ###

If you want to use your own ruby/golang without using build_rpms.bsh, it is a little 
more complicated. You have to make sure rconn and go are in the path, and create the
build structure, and download/create the tar.gz file used. This is not recommended,
but is possible

```
mkdir -p {BUILD,BUILDROOT,SOURCES,RPMS,SRPMS}
#download file to SOURCES/v{version number}.tar.gz
rpmbuild --define "_topdir `pwd`" -bb SPECS/git-lfs.spec --nodeps

#(and optionally)
rpmbuild --define "_topdir `pwd`" -bs SPECS/git-lfs.spec --nodeps
```

Or course, with this it is up to you to get the SOURCES/v**{version}**.tar.gz

### Releases ###

The only thing that needs to be updated with a new version is the version number in 
lfs/lfs.go needs to be updated. build_rpm.bsh will download:

https://github.com/github/git-lfs/archive/v%{version}.tar.gz 

This way when a new version is archived, it will always get downloaded. When
preparing for a release, it would be advantageous to use the currently checked out
version to test against. In order do that, after running ./clean.bsh, set the 
environment variable BUILD_LOCAL to 1

```
./clean.bsh
BUILD_LOCAL=1 ./build_rpms.bsh
```

### Troubleshooting ###

**Q**) "error: Bad owner/group" when building SRPM (rpmbuild -bs command)

**A**) For some... STUPID reason, git-lfs.spec has to be OWNED by a valid used. Just chown 
git-lfs.spec to a valid user AND group. root will do