DragonflyBSD Dedicated Server Setup

From GMod Wiki

Jump to: navigation, search


Contents

Dragonflybsdlogo.png DragonflyBSD

NOTICE: Linux server binaries are currently in beta and are not guaranteed to be updated as often as the Windows binaries. AzuiSleet is doing his best to keep them up to date.

Notes about CPUs / Multiple servers

In DragonFly, threads are locked to CPUs by design, and each processor has its own LWKT scheduler. Threads are never preemptively switched from one processor to another; they are only migrated by the passing of an "inter-processor interrupt" (IPI) message between the CPUs involved. Inter-processor thread scheduling is also accomplished by sending asynchronous IPI messages. One advantage to this clean compartmentalization of the threading subsystem is that the processors' on-board caches in SMP systems do not contain duplicated data, allowing for higher performance by giving each processor in the system the ability to use its own cache to store different things to work on.

The LWKT subsystem is being employed to partition work among multiple kernel threads (for example in the networking code; one thread per protocol per processor), reducing contention by removing the need to share certain resources among various kernel tasks. This thread partitioning implementation of CPU localization algorithms is arguably the key differentiating feature of DragonFly's design. - Reference: http://en.wikipedia.org/wiki/DragonFly_BSD

How does this affect my server?

It means that by default, if you choose to run more than one instance of the gmod server at the same time (eg: your community has both a Spacebuild and an RP server on the same physical server) and you are wanting to assign a dedicated server to a specific CPU to improve performance, that you don't have to do anything else because this OS will not move the processes between CPUs anyway.

Install Guide

Stop.png You will need to be root at one point in this guide so be careful! You can do serious damage while logged in as root.

Install Linux Compatibility

Become root and execute the following command:

kldload linux

Now edit /etc/rc.conf and append the following text to the end of the file:

linux_enable=YES

We're going to use pkgsrc to install linux libraries from SuSE.

If you don't have pkgsrc installed, here's how you install it

cd /usr
make pkgsrc-create

Now we install the necessary Linux-compatibility libraries:

cd /usr/pkgsrc/meta-pkgs/suse100
bmake install distclean
ln -s /usr/pkg/emul /compat


Finally, mount the Linux proc filesystem.

mount_linprocfs proc /compat/linux/proc

To avoid having to mount it manually like that ^ at every boot, add the following line to the end of /etc/fstab

linprocfs    /compat/linux/proc    linprocfs    rw    0    0

Unfortunately, if you're running dragonfly 2.4.3, we are going to need to recompile the kernel because there is a bug which is stopping linux emulation from working (are you sure you don't want to just use Linux? Of course you are. Keep reading...)

Change to your /usr directory and run make src-create to check out the kernel source code from the dragonfly git repository

cd /usr
make src-create

Now edit: /usr/src/sys/platform/pc32/isa/npx.c and comment out the line which looks like this: lwpsignal(curproc, curthread->td_lwp, SIGFPE);

Now recompile the kernel you've just edited

cd /usr/src
make buildworld
make buildkernel KERNCONF=GENERIC
make installkernel KERNCONF=GENERIC

Reboot.

Create a user

Never run srcds as root.


You should use an unprivileged user to run srcds.

If you have root access:

adduser
Username: gmod
Full Name: Garry Mod
Uid (Leave empty for default):
Login group [gmod]:
Login group is gmod. Invite gmod into other groups? []:
Login class [default]:
Shell (sh csh tcsh nologin) [sh]:
Home directory [/home/gmod]:
Home directory permissions (Leave empty for default):
Use password-based authentication? [yes]:
Use an empty password? (yes/no) [no]:
Use a random password? (yes/no) [no]:
Enter password: (whatever you like here)
Enter password again: (whatever you like here - same as above)
Lock out the account after creation? [no]:
OK? (yes/no): yes
adduser: INFO: Successfully added (gmod) to the user database.
Add another user? (yes/no): no
Goodbye!

Login as gmod before continuing.

su gmod

Change to home directory:

cd

Make a folder for your server

Go to your home folder if not already there:

cd ~
mkdir srcds
cd srcds

Installing Steam

Do this bit as the "gmod" user for security reasons:

su gmod

Download the dedicated server update tool, make it executable and run it.

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

You will need to agree to the terms of the license agreement - type 'yes' and press return.

If you receive an error about uncompressing, make a symbolic link to the gunzip tool called "/usr/bin/uncompress". If you already have a tool called uncompress, be sure to move it away from /usr/bin/uncompress first.

ln -s /usr/bin/gunzip /usr/bin/uncompress

Now run Steam - Providing you have an active Internet connection and the Steam servers are up, it will update itself.

./steam

Now we want to install Garry's Mod.

Installing GM10 Content

Enter the following:

./steam -command update -game orangebox -dir .
./steam -command update -game garrysmod -dir .

Installing the necessary Linux binary code

Now, download the GMod Linux server binaries from http://www.facepunch.com/showthread.php?t=933697, and save the zip file to your srcds folder and unzip them there:

unzip <filename>.zip

Next, move each of the extracted files below into the places they need to be for the server to operate:

mv server_i486.so orangebox/garrysmod/bin
mv lua_shared_i486.so orangebox/bin
mv scenecacheproxy_i486.so orangebox/bin
mv gm_sqlite orangebox/garrysmod/lua/includes/modules/gm_sqlite_486.dll

Installing extra game content

See the Extra Content section of General Server Setup Information.

Optionally Creating a Startup Script

You can now in theory just run the server with this command: orangebox/srcds_run -console -game garrysmod +maxplayers 16 +map gm_construct -autoupdate

However if you close SSH your server will close too.

We want to attach our GMod server to a virtual screen so we can log off and come back later or share the screen with other users (Other admins for example).

Open up a file called startgmod.sh with your favourite editor, for example:

nano -w startgmod.sh

Enter the following into the file:

#!/bin/bash
echo "Starting up Garry's Mod 10 server."
sleep 5
screen -A -m -d -S gm10server orangebox/srcds_run -console -game garrysmod +maxplayers 16 +map gm_construct -autoupdate
echo "Started. Type screen -x to resume!"

You may wish to edit maxplayers and map.

Once you've got to this stage you're good to go. Make the script executable before running it:

chmod +x startgmod.sh

Everyday Server Operations

Starting Up

Type:

./startgmod.sh

Shutting Down

Type:

screen -x

This resumes your screen session, sharing it with any other users. If the server is still active with players, it's advisable to shut it down by typing:

killserver

Once you've done that, press Ctrl+C+X to kill the screen.

If it's hung, just press Ctrl+C+X.

Administration

If you type:

screen -x

You're sitting at the console of your server.

Info 64.png To disconnect from screen, type Ctrl+D+A.
Personal tools
Namespaces
Variants
Actions
Navigation
Lua Scripting
Functions
Hooks
Toolbox