I start with a clean Ubuntu 8.04 install. So, first things first:

sudo apt-get update
sudo apt-get dist-upgrade
sudo shutdown -r now

Now that we’re up-to-date, let’s begin:

sudo apt-get build-dep php5
sudo apt-get install libmcrypt-dev libc-client-dev checkinstall

Now we have all the crap to build PHP with. Let’s get PHP itself:

cd /tmp/
wget http://us3.php.net/get/php-5.3.0.tar.gz/from/this/mirror
tar xvzf php-5.3.0.tar.gz
cd php-5.3.0/

Now all that is left is to build PHP…

./configure --prefix=/usr --with-apxs2=/usr/bin/apxs2 --with-config-file-path=/etc/php5/apache2 --with-config-file-scan-dir=/etc/php5/apache2/conf.d --mandir=/usr/share/man --disable-debug --with-regex=php --disable-rpath --disable-static --with-pic --with-layout=GNU --with-pear=/usr/share/php --enable-calendar --enable-sysvsem --enable-sysvshm --enable-sysvmsg --enable-bcmath --with-bz2 --enable-ctype --with-db4 --without-gdbm --with-iconv --enable-exif --enable-ftp --with-gettext --enable-mbstring --with-pcre-regex=/usr --enable-shmop --enable-sockets --enable-wddx --with-libxml-dir=/usr --with-zlib --with-kerberos=/usr --with-openssl=/usr --enable-soap --enable-zip --with-exec-dir=/usr/lib/php5/libexec --without-mm --with-curl=shared,/usr --with-zlib-dir=/usr --with-gd=shared,/usr --enable-gd-native-ttf --with-gmp=shared,/usr --with-jpeg-dir=shared,/usr --with-xpm-dir=shared,/usr/X11R6 --with-png-dir=shared,/usr --with-freetype-dir=shared,/usr --with-t1lib=shared,/usr --with-ldap=shared,/usr --with-ldap-sasl=/usr --with-mhash=shared,/usr --with-mysql=shared,/usr --with-mysqli=/usr/bin/mysql_config --with-pspell=shared,/usr --with-unixODBC=shared,/usr --with-xsl=shared,/usr --with-snmp=shared,/usr --with-sqlite=shared,/usr --with-mssql=shared,/usr --with-tidy=shared,/usr --with-xmlrpc=shared --with-pgsql=shared,/usr --enable-gd-native-ttf --enable-dba=shared --with-openssl-dir=shared,/usr --enable-gd-jis-conv --enable-json --with-mcrypt=shared,/usr --enable-pcntl --with-pdo-mysql --with-pdo-odbc=unixODBC,/usr --with-pdo-pgsql=shared,/usr --with-pdo-sqlite --enable-xmlreader --with-tsrm-pthreads --with-imap --with-imap-ssl

I’m sure this doesn’t enable ALL features in PHP, but it works for me so far. If I’ll ever find I was missing something, I’ll be sure to update this post.

When building make sure to pass the correct number of CPUs to make with the -j parameter to safe some time.

make -j2

And now we wait…

Now we need to add these lines to our httpd.conf (which is empty in this case)

#LoadModule directive to aid module installations
#LoadModule dummy_module /usr/lib/apache2/modules/mod_dummy.so

Now we can build our .deb for PHP.

sudo checkinstall -D --install=no --fstrans=no --maintainer=your@email --reset-uids=yes --nodoc --pkgname=php5 --pkgversion=5.3 --pkgrelease=200908060830 --arch=amd64

And that’s it. Now you have a .deb which you can install on a different system or (as checkinstall told you) just put on this system with dpkg -i.

Have fun

The first thing we’ll need is the screen package.

sudo apt-get install screen

Now let’s create a user for steam and switch to it.

sudo adduser --disabled-login steam
sudo su - steam

Let’s download gSteam, my frontend, and set it executable for only steam.

wget http://www.dirty-motherfucker.org/steam/gSteam.sh
chmod 700 gSteam.sh

Now we can install the steam client.

./gSteam.sh install steam

As noted in my post regarding the L4D server, if the installation does not seem to properly start or
hang, you can try to create a Steam.cfg file (in the homedir) with preferred content server ids.

http://www.dirty-motherfucker.org/blog/2008/12/26/running-a-source-dedicated-server-for-left-4-dead/

After you get the magic line “Steam Linux Client updated, please retry the command” you are ready to
install some games. So let’s install Team Fortress 2.

./gSteam.sh install tf

The identifiers for the games can be obtained with:

./steam -command list

The “No installation record found at…” messages can be safely ignored.
Now you will have to wait until the game is fully downloaded. This can take from “forever” to
“until the fucking end of time” in some cases. The old Steam.cfg can help here as well, but
I personally found that patience is the best tool.

Once the installation is completed a profile template for tf will be created. gSteam will try its
best to determine some default parameters. You should edit it nevertheless to at least adjust
the name of your server (and possibly the profile).

If everything worked fine you can now simply

./gSteam start tf2

and the thing should be running.

Installing other games is as simple as:

./gSteam install l4d_full

Let me just add that the script is far from fail-proof. Especially error-cases aren’t properly handled. But it saved me a lot of time so I thought I’d share it.
Hope it helps someone else ;)

As all of my administration articles (so far) this one is for Ubuntu Server 8.04.1.

Let’s start by adding a new user that will run our servers.

sudo adduser --disabled-login steam

Now to log in with the newly created user to install the servers. We need to switch the user as root as a normal user can not log into this account.

sudo su - steam

No we can install the HLDSUpdateTool.

wget http://www.steampowered.com/download/hldsupdatetool.bin
chmod +x hldsupdatetool.bin
./hldsupdatetool.bin
./steam

In case it will hang at “Checking bootstrapper version…” you can try to set a set of preferred content servers. You do that by creating a file called “steam.cfg” and adding the following line to it:

PreferredContentServerIDs = "id id id"

You can find the ids on http://store.steampowered.com/stats/content/ under “Individual Server Statisistics”. Look for Valve #NN servers and place the number of the servers you want to use inside the quotes. Then retry running steam.

Now we’ll install a game. Let’s start out with Left 4 Dead. If you want to see what games are available, run:

./steam -command list

This will also show you the correct game identifier for Left 4 Dead, which is l4d_full (left4dead was for the demo).

./steam -command update -game l4d_full -dir /home/steam

In case the installation process hangs you can also try setting the preferred content servers as mentioned above. Now, theoretically you’re good to go and you can start your server. But we’re gonna go a step further. I use a start script based on the article mentioned at the start of this article. Now let’s grab it.
But wait, in case you realize that you really don’t want to use any of my shitty scripts and that you just want to get a clean server running, in that case it can stilll be helpful to get the script. You see when you use my script and you start a profile it will print out the command line it used. That way you can build up your desired configuration according to this guide, then run the script and get the correct command line to run your server. Thus I still highly recommend getting the script.

wget http://www.dirty-motherfucker.org/blog/wp-content/uploads/2008/12/steamLauncher.sh
chmod +x steamLauncher.sh

The script allows to easily start and stop Source servers in the background. It also allows for several profiles for several games. So you can start all games through the same interface. I like it, if you don’t then maybe have a look at the original script.

So let’s create a profile for Left 4 Dead.

mkdir profiles
editor profiles/l4d.conf

Now, this is how a profile should look like:

longName                = Left 4 Dead - 1 instance      ; The name of this profile/game
gameName                = left4dead                     ; The name given by steam to the game (equals the foldername ex. cstrike|tf2|left4dead)
daemon                  = /home/steam/l4d/srcds_run     ; Usually srcds_run
updater                 = /home/steam/steam             ; Where is the updater located? (steam binary)
basePath                = /home/steam/l4d               ; The base path of the steam installation (this folder contains tf2/cstrike/left4dead folders)
userName                = steam                         ; What user the server should run as

serverName              = My L4D Server                 ; The name that will appear in the server browser
serverIp                = 11.222.33.111                 ; The IP address to bind the server socket to
serverPort              = 27010                         ; The first port to use for listening (will be treated as base port with forked l4d servers)
serverMap               = l4d_hospital01_apartment      ; The first map to load
serverMaxPlayers        = 4                             ; Maximum number of players allowed on the server
serverPriority          = 0                             ; Renice to set for the server process (-20 is high, 0 is normal, +19 is low)
forkCount               = 0                             ; How many instances to fork
additionalParams        = -nohltv -steamport 27960+## +clientport 25030+## +exec server##.cfg +sv_lan 0 ; Additional params to run the server with

Obviously in that profile you need to adjust at least the serverIp parameter. Now you can run that profile by typing.

./steamLauncher start l4d

Keep in mind though, this is not a state that we want to be comfortable with just yet. Nevertheless start it up and check if there is any trouble. If it comes up, attach to the screen session as the script tells you to.
In case you get an error saying “Cannot open terminal ‘/dev/pts/0′”, you can run “script /dev/null” and then attach to the session. There are other ways to resolve it. If you wanna find out about those they’re easy to find in Google ;)

Now, in the profile of Left 4 Dead in the additionParameters we also tell the server to execute a certain config file. Let’s create that one now.

editor l4d/left4dead/cfg/server01.cfg

In here we can now override the default map, difficulty and whatnot. For example:

hostname        My L4D Server - No Mercy - Normal Difficulty
map             l4d_hospital01_apartment
m_difficulty    normal

Setting the difficulty and map is almost pointless though as they can be changed by vote anyway. But I’m sure you can think of some other server variables that you might want to set. And this is the place to do it.

Now might be a good time to talk about forking with Left 4 Dead servers. Given that there are only 4 or 8 players on a Left 4 Dead server it’s almost a waste only running a single instance. That’s why you can fork multiple instances of servers. Let’s have a look at a Left 4 Dead profile modified to run 4 servers.

longName                = Left 4 Dead - 4 instances     ; The name of this profile/game
gameName                = left4dead                     ; The name given by steam to the game (equals the foldername ex. cstrike|tf2|left4dead)
daemon                  = /home/steam/l4d/srcds_run     ; Usually srcds_run
updater                 = /home/steam/steam             ; Where is the updater located? (steam binary)
basePath                = /home/steam/l4d               ; The base path of the steam installation (this folder contains tf2/cstrike/left4dead folders)
userName                = steam                         ; What user the server should run as

serverName              = My L4D Server                 ; The name that will appear in the server browser
serverIp                = 11.222.33.111                 ; The IP address to bind the server socket to
serverPort              = 27010                         ; The first port to use for listening (will be treated as base port with forked l4d servers)
serverMap               = l4d_hospital01_apartment      ; The first map to load
serverMaxPlayers        = 4                             ; Maximum number of players allowed on the server
serverPriority          = 0                             ; Renice to set for the server process (-20 is high, 0 is normal, +19 is low)
forkCount               = 4                             ; How many instances to fork
additionalParams        = -nohltv -steamport 27960+## +clientport 25030+## +exec server##.cfg +sv_lan 0 ; Additional params to run the server with

You can now also create server02.cfg, server03.cfg and server04.cfg in the l4d folder. This way you can start up each instance with a different map, difficulty, key, …
It remains a mystery to me how to properly send commands to the console with forked instances though. Although from what I read there are ways, but I just never had any luck with those. I also never had any luck with rcon. So basically when I play on my own servers I can’t do shit when someone is getting on my nerves. And we sure don’t want that!
So what do we do? We install SourceMod. It gives us a nice and easy way to kick players when they get on our balls. And we can be happy little server admins. During the installation of SourceMod it may be helpful to run only a single instance profile of Left 4 Dead so you can easily attach to the screen session and send of some commands to test your installation.
So let’s get to it!

First of all we require MetaMod. A very straight-forward guide can be found on the MetaMod Wiki. For completeness sake I’ll replicate the required information here though.

1. Download MetaMod at http://www.metamodsource.net/
2. Put it into the left4dead folder. (cd l4d/left4dead)
3. tar xvzf mmsource-1.7.0.tar.gz (Filename might differ)
4. In l4d/left4dead/addons create a file metamod.vdf and put the following into it:

   "Plugin"
   {
           "file"  "../left4dead/addons/metamod/bin/server_i486.so"
   }
   

5. Go back into your home directory and restart your server (./steamLauncher restart l4d)
6. Attach to the screen session and type “meta version”. Everything other than “Unknown command” is a good sign.

If the installation of MetaMod fails, refer to the MetaMod Wiki or bug me about it.

Now we’re gonna install SourceMod. Again a proper guide can be found at http://wiki.alliedmods.net/Installing_SourceMod.

1. Grab one of the latest snapshots of SourceMod from http://www.sourcemod.net/snapshots-1.2.php
2. Just like we did with MetaMod, put it into the l4d/left4dead folder.
3. Extract it via tar xvzf sourcemod-1.2.0-hg2469.tar.gz (Filename may differ again)
4. Go back into your home directory and restart your server (./steamLauncher restart l4d)
5. Attach to the screen session and type “meta list”. You should see that SourceMod is loaded.

Now last but not least we need to set ourself up as an admin in SourceMod. We do that by editing

l4d/left4dead/addons/sourcemod/configs/admins_simple.ini

Right at the bottom we will now put the following line:

"STEAM_YOURID" "99:z"

If you’re like me then you’ll have no clue what your Steam ID is. So open up steam and connect to any server in any game. Then open up the console and type “status”. In the list that appears there should be your nick somewhere. And close to it, you’ll find your Steam ID.

Now you should be an admin on your Left 4 Dead servers. You can join your own servers easily by invoking “openserverbrowser” in the Left 4 Dead console. To enjoy being an admin it helps to bind “sm_admin” to some key. Then you can open the admin menu and kick those pesky players who just can’t stop running ahead to get themselves killed.

In case this isn’t clear. You’ll have to forward some ports for your servers to work. Which can easily be accomplished by adding two lines to your /etc/ufw/after.rules file. Similar to these two:

# Steam TF2 Server
-A ufw-after-input -d 11.222.33.111 -m udp -p udp --dport 26900:27040 -m conntrack --ctstate NEW,RELATED,ESTABLISHED -j ACCEPT
-A ufw-after-input -d 11.222.33.111 -m tcp -p tcp --dport 27000:27020 -m conntrack --ctstate NEW,RELATED,ESTABLISHED -j ACCEPT

I hope I haven’t left any open questions. In case I did, please let me know ;)

The host system Cacti will be running on, is Ubuntu Server 8.04.1 with no prior modifications. I just installed all pending updates as of today of course. To reproduce this I’m running it in a VMWare virtual machine (just to make sure I’m not missing something important). The configuration of the systems that are being monitored is really not that important. As long as you can run an SNMP deamon on them.

Which brings me to the first thing I didn’t understand from the start. Cacti itself is the tool that is monitoring other servers. Of course you can monitor the machine that Cacti is running on as well, but the main point is, you don’t have to install it on every machine that you want to monitor.

We start off by installing MySQL-Server, as the configure process for Cacti can’t do that on it’s own.

sudo apt-get install mysql-server -y

We input a root password and that’s that with the MySQL-Server.

Now let’s install Cacti itself.

sudo apt-get install cacti -y

I configure it to use Apache2. And I use dbconfig-common for database configuration. Give it the MySQL-Server root password and then a password for the Cacti user. And then Cacti is installed.

Now we configure Cacti via the web interface. For the initial setup process you could just use w3m:

w3m http://localhost/cacti

But sooner or later you better get something with a GUI ;)

When you get to the login screen, give it the default login admin/admin. After that you have to give the admin account a new password. Congratulations, now Cacti is set up and ready to go.

So, when you click the Graphs tab now, you’ll most likely see nothing, or if you already waited for the poller to run for the first time, you see 4 (almost) empty graphs for localhost. These graphs are created by running scripts on the local host. I usually use SNMP to gather the data. So now we create a new device for the local host which is SNMP enabled. But for that, we first need to install the SNMP deamon.

sudo apt-get install snmpd -y;
sudo vi /etc/default/snmpd

What we want to change in /etc/default/snmpd is mainly the logging options. SNMDOPTS includes “-Lsd”, more suitable would be “-LS 0-5 d”. The original setting will log at a debug level and pollute the logfiles. The new one will only log important messages.
At the end of SNMPDOPTS there is also a 127.0.0.1, this is the listening address. To monitor our host system this would be fine. But for additional machines, make sure to either remove it or adjust it to the correct listening address.

sudo vi /etc/snmp/snmpd.conf

In this file look for lines starting with com2sec. What you’re gonna want to do is, comment out the first line (the one for paranoid settings) and enable the second line, which allows read-only access.
Now restart snmpd:

sudo invoke-rc.d snmpd restart

We’re not ready to create our new device.
In Cacti, go to the console tab. Select “create Devices” from the list in the middle. Click Add in the upper right corner.
Give the new device a proper name and supply the ip address. If you didn’t adjust the ip address in /etc/default/snmpd, then make sure to use 127.0.0.1 here.
As the host template select “Generic SNMP-enabled Host” and at the bottom of the form, select “Version 1″ as the SNMP Version.
Now you can select SNMP as the Downed Device Detection as well. And that’s it.

Now, let’s first add a few more data sources. In the “Add data query” dropdown in the lower right, select “SNMP – Get mounted partitions” then click “Add” on the right. Repeat the process for “SNMP – Get Processor Information”.
Now we’re ready to create some graphs.

Make sure that all the data queries have already returned successful results. The status will say “Success” and it will signal that some items have been returned. Especially the Processor information can take a while until valid data is returned. You can click the green circle to refresh the data. When you have proper data, click “Create Graphs for this Host” at the top of the page. Add all data queries for “SNMP – Get Mounted Partitions” and “SNMP – Get Processor Information“. For “SNMP – Interface Statistics“, select the eth interfaces you wanna monitor, then select the graph from the dropdown on the lower right. For example “Traffic (bytes/sec, Total Bandwidth)“. You can come back later to this screen to create more interface related graphs. Confirm the next screen with the “Create” button.

Now select the Devices from the menu on the left. Select your newly created device from the list, select “Place on a Tree (default Tree)” from the dropdown on the bottom right and click “Add”. Confirm by clicking “yes”.

Now go to the “graphs” tab again. As before, you’ll most likely see nothing when looking at your new device, just wait for it ;)

That should be sufficient to get you started. Have fun.