Difference between revisions of "Server Configuration"
(16 intermediate revisions by 9 users not shown) | |||
Line 1: | Line 1: | ||
==Installation== | ==Installation== | ||
− | + | File installation: | |
− | Note that the <tt>etpro</tt> directory should be in the same directory as <tt>etmain</tt>. <i>Do | + | Note that the <tt>etpro</tt> directory should be in the same directory as <tt>etmain</tt>. <i>Do <b>NOT</b> extract the files to etmain</i> |
− | + | :Linux: | |
Unzip the server archive to <tt>enemy-territory/etpro/</tt> | Unzip the server archive to <tt>enemy-territory/etpro/</tt> | ||
− | + | :Windows: | |
Unzip the server archive to <tt>Wolfenstein - Enemy Territory\etpro</tt> | Unzip the server archive to <tt>Wolfenstein - Enemy Territory\etpro</tt> | ||
− | + | Starting an ETPro server requires <tt>+set fs_game etpro</tt> to be appended to the end of the command line. | |
− | <tt> ./etded +set fs_game etpro</tt> | + | :Linux example: |
− | + | ::<tt> ./etded +set fs_game etpro</tt> | |
− | <tt> | + | :Windows: |
− | + | ::<tt> etded.exe +set fs_game etpro</tt> | |
− | Right click on the shortcut for Enemy Territory and select "Properties." In the "Target" Box (Top text box) add <tt>+set fs_game etpro</tt> to the end, after the quotes. | + | :Windows Shortcut: |
− | <tt> "C:\Program Files\Wolfenstein - Enemy Territory\et.exe" +set fs_game etpro</tt>< | + | ::Right click on the shortcut for Enemy Territory and select "Properties." In the "Target" Box (Top text box) add <tt>+set fs_game etpro</tt> to the end, after the quotes. |
+ | ::<tt> "C:\Program Files\Wolfenstein - Enemy Territory\et.exe" +set fs_game etpro</tt><br> | ||
+ | |||
+ | ''Note'': Starting from version ET 2.60, the Windows executables are et.exe for the game and etded.exe for the server. If you want to run a listen server on Windows start your game with et.exe, otherwise use etded.exe for a dedicated server. | ||
+ | |||
+ | If you want to run 2.56 or earlier servers on Windows, you can only use et.exe and append <tt>+set dedicated 1</tt> (or 2). | ||
+ | |||
==Warnings== | ==Warnings== | ||
− | + | <i><u>WARNING: Server improperly installed! Incorrect fs_game setting! Please notify administrator.</u></i> | |
− | + | :Incorrect <tt>+set fs_game</tt> string. Make sure it is set to <tt>+set fs_game etpro</tt>. | |
− | + | <i><u>fs_game is write protected.</u></i> | |
− | + | :You must start your server via the command line (Or by changing the shortcut) with the <tt>+set fs_game etpro</tt> command.<br> | |
− | + | <i><u>Client .pk3 missing!</u></i> | |
− | + | :The PK3 file that is contained in the server install file is missing. Download the [http://bani.anime.net/etpro/download.html server install] again and place the PK3 file in the server's ETPro directory.<br> | |
− | + | <i><u>Incorrect client .pk3 installed on server!</u></i> | |
− | + | :The PK3 file mentioned above does not match the version of the server. Download the PK3 (And possibly updated server) from the [http://bani.anime.net/etpro/download.html download page]. | |
− | + | <i><u>Multiple client .pk3 versions installed on server!</u></i> | |
− | + | :This means that the server has more than one ETPro client PK3. Remove the older versions from the server's ETPro directory. | |
− | + | :This can also happen from having fs_game set twice in your shortcut or config.<br> | |
− | + | <i><u>Incorrect ET version!</u></i> | |
− | + | :This happens when you are attempting to install ETPro on a non-patched ET server. Download the [http://games.activision.com/games/wolfenstein patch] and try again.<br> | |
− | + | <i><u>Cvar dedicated is 0! Some features will break!</u></i> | |
− | + | :ETPro is meant to be installed on a dedicated server. Set the server to dedicated by using <tt>+set dedicated 2</tt> in the command-line used to start the server.<br> | |
− | + | <i><u>etpro_cheats.dat is corrupt or missing!</u></i> | |
− | + | :The ETPro database file for positively identifying cheats has either been corrupted or does not exist on the server. Download a recent version of [http://etpro.anime.net/etpro_cheats.dat the database]. | |
− | + | <br> | |
==Other Errors== | ==Other Errors== | ||
− | + | <i><u>Server sends users the ETPro PK3 file over and over.</u></i><br> | |
− | + | :If you are using download redirects, make sure that the download path is set correctly if changed between versions. eg: If the old PK3 was in <tt>server/etpro2</tt> and the new version is in <tt>server/etpro3</tt> and the redirect path in the server configuration was not changed, it would send the old ETPro 2.x files; which not being what the server is using, it would cause the download to start again.<br> | |
− | eg: If the old PK3 was in <tt>server/etpro2</tt> and the new version is in <tt>server/etpro3</tt> and the redirect path in the server configuration was not changed, it would send the old ETPro 2.x files; which not being what the server is using, it would cause the download to start again.<br> | + | :If you are redirecting to an http or ftp server, make sure the pk3 on the http/ftp server exactly matches the pk3 on the game server. |
− | + | :Some http servers may incorrectly try to send pk3 files as text/plain, which will corrupt downloads. Make sure they are sent as application/octet-stream: | |
− | + | <i><u>*WARNING*: PunkBuster Reports PB Server Running Old Version Cx.xxx</u></i><br> | |
+ | Windows: | ||
+ | :Run <tt>\Wolfenstein - Enemy territory\pb\pbweb.exe</tt><br> | ||
+ | Linux: | ||
+ | :Run <tt>/path_to_et_server/pb/pbweb.x86</tt> (first chmod +x pbweb.x86)<br> | ||
+ | |||
+ | ==Tips for server admins== | ||
+ | In general, the ettv/etded process should be restarted every 20 days or less. If the server is running on windows, the OS should be restarted at the same time. | ||
+ | |||
+ | Q: Why do my logs and console keep getting flooded with stuff like this: | ||
+ | saneClientCommand: 5 obj -1 | ||
+ | |||
+ | A: See [[ETPro:Server_cvar_list|b_showClientCmds]] in the server cvar list. | ||
+ | |||
+ | Q: rcon stopped working | ||
+ | |||
+ | A: Your server has been up for more than 49 days, you need to restart it. | ||
+ | |||
+ | Q: All clients trying to connect to my ettv server get stuck awaiting gamestate, even though the network is fine. | ||
+ | |||
+ | A: restart it. | ||
+ | |||
+ | ==Campaign configuration== | ||
+ | Campaigns are created by editing a file with the extension ".campaign". | ||
+ | |||
+ | This is the structure of a .campaign file : | ||
+ | |||
+ | <pre> | ||
+ | { | ||
+ | name "" | ||
+ | shortname "" | ||
+ | description "" | ||
+ | maps "" | ||
+ | mapTC 374 374 | ||
+ | type "wolfmp" | ||
+ | } | ||
+ | </pre> | ||
+ | |||
+ | <table border="1"> | ||
+ | <tr><th>Key</th><th>Value</th></tr> | ||
+ | <tr><td>name</td><td>This is displayed at the start of a match when awaiting players to readyup, on the score screen, and also in the top-right of the map loading screen. It can be a maximum of 31 characters long, though to stay within the graphic background of the loading screen, and to preserve the "xofx" text, 13 characters is the maximum. Color codes can be used.</td></tr> | ||
+ | <tr><td>shortname</td><td>The name used to call the campaign using the "campaign" and "nextcampaign" commands.</td></tr> | ||
+ | <tr><td>description</td><td>The information displayed on the map loading screen. The available character resolution is 23x26. "\n" is used for a new-line and colour codes can be used.</td></tr> | ||
+ | <tr><td>maps</td><td>A semi-colon (";") separated list of maps (up to 10). The map name is the filename found in the \maps folder of the PK3 file, minus the .bsp extension.</td></tr> | ||
+ | <tr><td>mapTC</td><td>Texture Coordinates -- the x, y location on the map image for the upper left when drawing the small version of the map (e.g. in the server creation menu, or during intermission.)</td></tr> | ||
+ | <tr><td>type</td><td>Leave this as the default ("wolfmp")</td></tr> | ||
+ | </table> | ||
+ | |||
+ | Example : | ||
+ | <pre> | ||
+ | { | ||
+ | name "^0My ^1Campaign" | ||
+ | shortname "myCamp" | ||
+ | description "^1This is an example campaign.\n^0Map 1 : Goldrush\nMap 2 : Adlernest\nMap 3 : Oasis" | ||
+ | maps "goldrush;adlernest;oasis" | ||
+ | mapTC 374 374 | ||
+ | type "wolfmp" | ||
+ | } | ||
+ | </pre> | ||
+ | |||
+ | The compeleted .campaign file is then usually placed in the "scripts/" directory of either servers' etpro/ directory directly, or in a PK3 file on the server. The difference between the two methods is that if the .campaign file is placed directly on the server, the client wont have the campaign information, and therefore the campaign name, description and number of maps information sections will be empty. | ||
+ | |||
+ | The .campaign file is then referenced using the CVAR b_campaignfile, for example : | ||
+ | <pre> | ||
+ | b_campaignfile "scripts/myCampaign.campaign" | ||
+ | </pre> | ||
+ | |||
+ | Once the campaign file is loaded, the campaign shortname's contained within can be called, using the "campaign" and "nextcampaign" commands, eg : | ||
+ | <pre> | ||
+ | campaign myCamp | ||
+ | nextcampaign myNewCamp | ||
+ | </pre> | ||
+ | |||
==Configuration:== | ==Configuration:== | ||
− | + | [[:Category:ETPro:Server_Cvars|ETPro Server CVAR Explanations]] | |
+ | |||
+ | [[ETPro:Pluggable Config Files]] | ||
+ | |||
+ | <i>[http://bani.anime.net/banimod/forums/viewforum.php?f=13 Server Admin Forums]</i> | ||
+ | |||
+ | [http://rtcw.jolt.co.uk/content/enemy_territory/server_guide/index.html DG's Advanced Server Guide] | ||
+ | |||
+ | [http://et.d1p.de/etadmin_mod/wiki/index.php/User:Phats#Advanced_Campaign_Structure_-_Using_etadmin_mod____.28Prototype.29 Advanced Campaign Structure - Using etadmin_mod (Prototype)] | ||
+ | |||
+ | [http://tjw.org/etded/ tjw's chrooted linux server guide] | ||
+ | [[Category:ETPro]] |
Latest revision as of 19:57, 28 August 2009
Contents
Installation
File installation: Note that the etpro directory should be in the same directory as etmain. Do NOT extract the files to etmain
- Linux:
Unzip the server archive to enemy-territory/etpro/
- Windows:
Unzip the server archive to Wolfenstein - Enemy Territory\etpro Starting an ETPro server requires +set fs_game etpro to be appended to the end of the command line.
- Linux example:
- ./etded +set fs_game etpro
- Windows:
- etded.exe +set fs_game etpro
- Windows Shortcut:
- Right click on the shortcut for Enemy Territory and select "Properties." In the "Target" Box (Top text box) add +set fs_game etpro to the end, after the quotes.
- "C:\Program Files\Wolfenstein - Enemy Territory\et.exe" +set fs_game etpro
Note: Starting from version ET 2.60, the Windows executables are et.exe for the game and etded.exe for the server. If you want to run a listen server on Windows start your game with et.exe, otherwise use etded.exe for a dedicated server.
If you want to run 2.56 or earlier servers on Windows, you can only use et.exe and append +set dedicated 1 (or 2).
Warnings
WARNING: Server improperly installed! Incorrect fs_game setting! Please notify administrator.
- Incorrect +set fs_game string. Make sure it is set to +set fs_game etpro.
fs_game is write protected.
- You must start your server via the command line (Or by changing the shortcut) with the +set fs_game etpro command.
Client .pk3 missing!
- The PK3 file that is contained in the server install file is missing. Download the server install again and place the PK3 file in the server's ETPro directory.
Incorrect client .pk3 installed on server!
- The PK3 file mentioned above does not match the version of the server. Download the PK3 (And possibly updated server) from the download page.
Multiple client .pk3 versions installed on server!
- This means that the server has more than one ETPro client PK3. Remove the older versions from the server's ETPro directory.
- This can also happen from having fs_game set twice in your shortcut or config.
Incorrect ET version!
- This happens when you are attempting to install ETPro on a non-patched ET server. Download the patch and try again.
Cvar dedicated is 0! Some features will break!
- ETPro is meant to be installed on a dedicated server. Set the server to dedicated by using +set dedicated 2 in the command-line used to start the server.
etpro_cheats.dat is corrupt or missing!
- The ETPro database file for positively identifying cheats has either been corrupted or does not exist on the server. Download a recent version of the database.
Other Errors
Server sends users the ETPro PK3 file over and over.
- If you are using download redirects, make sure that the download path is set correctly if changed between versions. eg: If the old PK3 was in server/etpro2 and the new version is in server/etpro3 and the redirect path in the server configuration was not changed, it would send the old ETPro 2.x files; which not being what the server is using, it would cause the download to start again.
- If you are redirecting to an http or ftp server, make sure the pk3 on the http/ftp server exactly matches the pk3 on the game server.
- Some http servers may incorrectly try to send pk3 files as text/plain, which will corrupt downloads. Make sure they are sent as application/octet-stream:
*WARNING*: PunkBuster Reports PB Server Running Old Version Cx.xxx
Windows:
- Run \Wolfenstein - Enemy territory\pb\pbweb.exe
Linux:
- Run /path_to_et_server/pb/pbweb.x86 (first chmod +x pbweb.x86)
Tips for server admins
In general, the ettv/etded process should be restarted every 20 days or less. If the server is running on windows, the OS should be restarted at the same time.
Q: Why do my logs and console keep getting flooded with stuff like this: saneClientCommand: 5 obj -1
A: See b_showClientCmds in the server cvar list.
Q: rcon stopped working
A: Your server has been up for more than 49 days, you need to restart it.
Q: All clients trying to connect to my ettv server get stuck awaiting gamestate, even though the network is fine.
A: restart it.
Campaign configuration
Campaigns are created by editing a file with the extension ".campaign".
This is the structure of a .campaign file :
{ name "" shortname "" description "" maps "" mapTC 374 374 type "wolfmp" }
Key | Value |
---|---|
name | This is displayed at the start of a match when awaiting players to readyup, on the score screen, and also in the top-right of the map loading screen. It can be a maximum of 31 characters long, though to stay within the graphic background of the loading screen, and to preserve the "xofx" text, 13 characters is the maximum. Color codes can be used. |
shortname | The name used to call the campaign using the "campaign" and "nextcampaign" commands. |
description | The information displayed on the map loading screen. The available character resolution is 23x26. "\n" is used for a new-line and colour codes can be used. |
maps | A semi-colon (";") separated list of maps (up to 10). The map name is the filename found in the \maps folder of the PK3 file, minus the .bsp extension. |
mapTC | Texture Coordinates -- the x, y location on the map image for the upper left when drawing the small version of the map (e.g. in the server creation menu, or during intermission.) |
type | Leave this as the default ("wolfmp") |
Example :
{ name "^0My ^1Campaign" shortname "myCamp" description "^1This is an example campaign.\n^0Map 1 : Goldrush\nMap 2 : Adlernest\nMap 3 : Oasis" maps "goldrush;adlernest;oasis" mapTC 374 374 type "wolfmp" }
The compeleted .campaign file is then usually placed in the "scripts/" directory of either servers' etpro/ directory directly, or in a PK3 file on the server. The difference between the two methods is that if the .campaign file is placed directly on the server, the client wont have the campaign information, and therefore the campaign name, description and number of maps information sections will be empty.
The .campaign file is then referenced using the CVAR b_campaignfile, for example :
b_campaignfile "scripts/myCampaign.campaign"
Once the campaign file is loaded, the campaign shortname's contained within can be called, using the "campaign" and "nextcampaign" commands, eg :
campaign myCamp nextcampaign myNewCamp
Configuration:
ETPro Server CVAR Explanations