info: | Download steam-boiler to install steam and boiler. |
---|---|
author: | Erik Southworth |
version: | 49 |
revision: | July 30, 2012 |
description: | Linux Reference Manual |
Steam-Boiler is a package-friendly steam distribution. It is one part steam, Valve’s command-line tool for installing and updating game-servers on Linux and one part boiler, a wrapper script for steam that started as a simple run-wrapper and has since gained many features.
Mostly to have a package-friendly steam distribution for any game-server appliance that need be installed only once. Most software utilities only need to be installed on a system once. steam defies this principle with it’s auto-update feature, has many annoyances and behaves poorly in general.
And many more...
A GNU/Linux or compatible system is needed.
There is nothing to compile, so no compilers are needed.
The following requirements are typically already provided on a Linux system. If the target system is of arch x86_64 the required libs for x86 may need to be installed if it not bi-arch already.
Installing is done by the following three commands:
$ ./configure
$ make
# make install (as root)
The default configure uses --prefix=/usr/local and this works fine. Run ./configure, with some options if you wish. The standard options are documented in the INSTALL file. The most interesting options to set are the usual --prefix=/usr.
For more configuration details run:
$ ./configure --help
If there are any errors during configuration, check your build environment and try to find the error, otherwise file a bug-report on the issue tracker or contact one of the authors.
These files will be installed.
- ${bindir}/boiler
- ${bindir}/steam -> ${bindir}/boiler (symlink)
- ${pkgdatadir}/hldsupdatetool
- ${mandir}/man6/steam.6
- ${mandir}/man6/boiler.6
To run steam the legacy way, just type on a terminal:
$ steam -command CMD [-game NAME] [-dir PATH] [options]
There are a few command line options. See the manual page or run for details:
$ steam
Otherwise to run boiler just type on a terminal:
$ boiler <command> [game] [directory] [options]
There are a few command line options. See the manual page or run for details:
$ boiler --help
Or look into the documention in the doc/ directory.
Mostly, boiler is intended to be an alias for the steam command so, the preferred usage would be as follows:
$ steam <command> [game] [directory] [options]
And so on...You get the idea.
Boiler is distributed under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. A copy of the license can be found in the file COPYING included with the source code of the program. If not, see <http://www.gnu.org/licenses/>.
The HldsUpdateTool(Steam) application (found in the subdirectory hldsupdatetool/) has its own license, which can be found in the file LICENSE included with the program.
If you add something, or fix a bug, please send a patch (in ‘diff -u’ format) to the issue tracker or one of the authors.
Assuming you have installed your favorite flavor of Linux and have logged in to a normal user account with ‘sudo’ admin priveleges. The following shell session demonstrates how a typical installation is accomplished. Open a shell terminal and follow these steps.
1. Make directory (if required) and change directory to where local system software downloads are to be stored. Here we call it ‘Source’.
- $ mkdir -pv ~/Source/steam-boiler
- $ cd ~/Source/steam-boiler
[~]$ mkdir -pv ~/Source/steam-boiler
mkdir: created directory `/home/user/Source/steam-boiler'
[~]$ cd ~/Source/steam-boiler
[steam-boiler]$
2. Download Steam-Boiler and unpack the tarball. The current release distribution archive is: steam-boiler-49.tar.bz2.
- $ wget http://bitbucket.org/superstition/steam-boiler/downloads/steam-boiler-49.tar.bz2
- $ tar -xvf steam-boiler-49.tar.bz2
[steam-boiler]$ wget http://bitbucket.org/superstition/steam-boiler/downloads/steam-boiler-49.tar.bz2
--23:00:58-- steam-boiler-|version|.tar.bz2
=> `steam-boiler-49.tar.bz2'
Resolving bitbucket.org... 184.73.244.143
Connecting to bitbucket.org|184.73.244.143|:80... connected.
HTTP request sent, awaiting response... 302 FOUND
Location: http://cdn.bitbucket.org/superstition/steam-boiler/downloads/steam-boiler-49.tar.bz2 [following]
--23:00:58-- http://cdn.bitbucket.org/superstition/steam-boiler/downloads/steam-boiler-49.tar.bz2
=> `steam-boiler-49.tar.bz2'
Resolving cdn.bitbucket.org... 216.137.59.5, 216.137.59.30, 216.137.59.32, ...
Connecting to cdn.bitbucket.org|216.137.59.5|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 2,134,171 (2.0M) [application/x-tar]
100%[================================================================>] 2,134,171 83.74K/s ETA 00:00
23:01:30 (66.71 KB/s) - `steam-boiler-49.tar.bz2' saved [2134171/2134171]
[steam-boiler]$ tar -xvf steam-boiler-49.tar.bz2
steam-boiler-49/
steam-boiler-49/doc/
steam-boiler-49/doc/html/
...
steam-boiler-49/hldsupdatetool/hldsupdatetool
steam-boiler-49/wscript
steam-boiler-49/THANKS
[steam-boiler]$
3. Change directory to where the distribution software was unpacked, configure the build settings, build the software and install Steam-Boiler.
- $ cd steam-boiler-49
- $ ./configure
- $ make
- $ sudo make install
[steam-boiler]$ cd steam-boiler-49
[steam-boiler-49]$ ./configure
Checking for WAF : /home/user/Source/steam-boiler/steam-boiler-49/waf
Checking for program find : /usr/bin/find
Checking for program getopt : /usr/bin/getopt
Checking for program install : /usr/bin/install
Checking for program ln : /bin/ln
'configure' finished successfully (0.013s)
[steam-boiler-49]$ make
Waf: Entering directory `/home/user/Source/steam-boiler/steam-boiler-49/build'
[1/2] copy: src/boiler.in -> build/default/src/boiler
[2/2] true: src/steam.6 src/boiler.6
Waf: Leaving directory `/home/user/Source/steam-boiler/steam-boiler-49/build'
'build' finished successfully (0.049s)
[steam-boiler-49]$ sudo make install
/home/user/Source/steam-boiler/steam-boiler-49/waf install
Waf: Entering directory `/home/user/Source/steam-boiler/steam-boiler-49/build'
* installing hldsupdatetool/hldsupdatetool as /usr/local/share/steam-boiler/hldsupdatetool
* installing build/default/src/boiler as /usr/local/bin/boiler
* symlink /usr/local/bin/steam (-> boiler)
* installing src/steam.6 as /usr/local/share/man/man6/steam.6
* installing src/boiler.6 as /usr/local/share/man/man6/boiler.6
Waf: Leaving directory `/home/user/Source/steam-boiler/steam-boiler-49/build'
'install' finished successfully (0.149s)
[steam-boiler-49]$
Hint
configure also accepts some other, not widely useful, options. Run ./configure --help for more details.