Doomsday Manual

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== doomsday-host ======


Command line utility for hosting dedicated servers. Starts a number of servers, monitors their status, restarts them if they crash, and maintains output log storage. Intended for automation.


===== Installation =====


Currently [[doomsday-host]] is not installed by default. You need to use ''CONFIG+=deng_host'' with [[qmake]] to include it in the build. The script will then be installed in the binary installation directory (where the **doomsday** executable is also located).

[[doomsday-host]] is intended to be run periodically from cron. You could for instance run it every minute or every five minutes.


===== .doomsdayhostrc =====


The configuration file **~/.doomsdayhostrc** defines what the script will actually do when run. See an example below with comments (in this example, ''PREFIX=/home/jaakko/usr'' is being used to allow cron to rebuild and install the engine).

<code xml><hostconfig>
	<doomsday>/home/jaakko/usr/bin/doomsday-server</doomsday></code>
Location of the **doomsday-server** binary.

<code xml>	<option>-parse</option>
	<option>/home/jaakko/host.cfg</option>
	<option>-iwad</option>
	<option>/home/jaakko/iwads/</option></code>
Command line options to use with all server instances.

<code xml>	<branch>master</branch>
	<buildDir>/home/jaakko/src/deng/doomsday-build</buildDir>
	<qmakeCommand>qmake -r ../doomsday/doomsday.pro PREFIX=/home/jaakko/usr
                CONFIG+='debug deng_packres'</qmakeCommand>
	<rebuildTimes> 
 		<rebuild weekday="Mon" hour="11" minute="5" />
		<rebuild weekday="Wed" hour="11" minute="5" />
		<rebuild weekday="Fri" hour="11" minute="5" />
	</rebuildTimes></code>
Rebuild settings. At the specified times, the script will pull new changes from the [[git_repository]], rebuild the engine, and install.

<code xml>	<servers>
		<server port="13209" game="doom1-ultimate" 
			name="Deng Team (Co-op)" 
			info="Public multiplayer testing; everyone is welcome to join"
			dir="/home/jaakko/runtime/doom">
			<option>-parse</option>
			<option>/home/jaakko/coop.cfg</option>
		</server>
		<server port="13210" game="doom2" 
			name="Deng Team (Co-op)" 
			info="Public multiplayer testing; everyone is welcome to join"
			dir="/home/jaakko/runtime/doom2">
			<option>-parse</option>
			<option>/home/jaakko/coop.cfg</option>
		</server>
		<server port="13211" game="heretic" 
			name="Deng Team (Co-op)" 
			info="Public multiplayer testing; everyone is welcome to join"
			dir="/home/jaakko/runtime/heretic">
			<option>-parse</option>
			<option>/home/jaakko/coop.cfg</option>
		</server>
		<server port="13212" game="hexen" 
			name="Deng Team (Co-op)" 
			info="Public multiplayer testing; everyone is welcome to join"
			dir="/home/jaakko/runtime/hexen">
			<option>-parse</option>
			<option>/home/jaakko/coop.cfg</option>
		</server>
		<server port="13213" game="doom1-ultimate" 
			name="Deng Team (DM)" 
			info="Public multiplayer testing; everyone is welcome to join"
			dir="/home/jaakko/runtime/doom-dm">
			<option>-parse</option>
			<option>/home/jaakko/deathmatch.cfg</option>
		</server>
		<server port="13214" game="doom2" 
			name="Deng Team (DM)" 
			info="Public multiplayer testing; everyone is welcome to join"
			dir="/home/jaakko/runtime/doom2-dm">
			<option>-parse</option>
			<option>/home/jaakko/deathmatch.cfg</option>
		</server>
		<server port="13215" game="heretic" 
			name="Deng Team (DM)" 
			info="Public multiplayer testing; everyone is welcome to join"
			dir="/home/jaakko/runtime/heretic-dm">
			<option>-parse</option>
			<option>/home/jaakko/deathmatch.cfg</option>
		</server>
		<server port="13216" game="hexen" 
			name="Deng Team (DM)" 
			info="Public multiplayer testing; everyone is welcome to join"
			dir="/home/jaakko/runtime/hexen-dm">
			<option>-parse</option>
			<option>/home/jaakko/deathmatch.cfg</option>
		</server>  
	</servers>
</hostconfig>
</code>
All of these servers are started in the background. If they crash, they get automatically restarted. You'll need to manually create the runtime directories.
Doomsday Manual

User Tools

Site Tools

Page Tools
