WolfWiki - User contributions [en]

ETTV:Server Configuration

2006-07-30T11:42:49Z

Deej: added ettv_netblast 2

<dot_graph>
digraph ettv {
master -> slave1
master -> slave2
slave1 -> "client1.."
slave1 -> "..client50"
slave2 -> "client51.."
slave2 -> "..client100"
slave1 -> "chained_slave1"
chained_slave1 -> "client101"
chained_slave1 -> "...client150"
}
</dot_graph>

==Installation - "Master" (gameserver)==

Copy ettv.(x86|exe) to the same directory your etded.(x86|exe) is located.
Start your gameserver as normal, but run ettv.(x86|exe) instead of etded.(x86|exe).

===Set some cvars===

'''ettv_sv_maxslaves''' (default 0, no slave connections allowed)
:Number of ettv slaves allowed to connect.
:''Note:'' Slave slots are always reserved, like private slots.
'''ettv_password''' (default "", no slave connections allowed)
:Password for ettv slaves.
:Must be set, or no slaves will be able to connect!
'''b_ettv_flags''' (default 3)
:1 = prevent slaves from being callvote kicked
:2 = grant shoutcaster status to slaves
:values can be added together, eg 3 for both features.

===Playing on the master===
Players may now connect to your gameserver as normal.

==Installation - "Slave" (broadcast server)==

Copy ettv.(x86|exe) to the same directory your etded.(x86|exe) is located.
Copy tvgame.mp.i386.(so|dll) to the same directory as your etpro/qagame.mp.i386.(so|dll) is located.

===Set some cvars===
'''sv_maxclients'''
:Number of spectator clients to allow. This number is only limited by available cpu and memory.
:Some guidelines when provisioning a broadcast server:
:*100 spectator slots will require ~ 128mb ram. Use com_hunkmegs to set this.
:*100 spectator slots will require ~ 768kbyte/sec (6mbits), roughly 6kbyte/sec per client
:*100 spectator slots will take ~ 80% cpu of a Xeon 2.2ghz
:*Each slave will require ~20-40kbyte/sec from the master.

'''ettv_clientname''' (default "ETTV")
:Playername the slave will use when connecting to the master, eg "ETTV-xyz"

'''ettv_delay''' (default 0, disabled)
:number of seconds for slave to delay the master feed. Recording/playback chains should no longer be needed, and slaves should always maintain an exact delay from the master server.
:''note'': this should ONLY be set on the slave.
:''note'': only supported in ettv beta8 and later

===Chat passwords===
In order to curb the rampant abuse of ettv chat, admins may set "chat passwords" on their servers. If enabled, viewers are not allowed to chat unless they have a password. You can define as many passwords as you like, so you can easily track down individual abusers and limit the damage of stolen passwords.

'''ettv_chatpasswords''' (default 0, disabled)
:number of chat passwords defined.
'''ettv_chatpassword'''(1-99999)
:individual chat passwords.

viewers use <tt>/chatpassword <password></tt> to login.

if logged in, ettv chats will be tagged with a number in parentheses identifying which chat password the viewer is using.
===Misc commands for viewers===
;For ettv beta 4 and above
* spectators may <tt>/ignore</tt> and <tt>/unignore</tt> other spectators
* semiadmin functionality now works for slaves
* rcon may now mute/unmute specs

===Connect the slave===
Now start your slave server by running ettv.(x86|exe)

Tell the slave server to connect up to the master server:
:<tt>tv connect master.ip.address:port ettv_password(required) g_password(if the master has a g_password set)</tt>

If you have configured everything correctly, the slave should connect to the master.
Clients should now be able to connect to the slave and spectate the game in progress.

This is a "live broadcast" with no delay.

===Disconnect the slave===
To tell the slave to disconnect from the master:
:<tt>tv disconnect</tt>

===Slave Chaining===

==== What is chaining and why chain slaves? ====

ETTV allows chaining slaves together. This very neat feature lets you connect one ETTV slave to another ETTV slave that is broadcasting a match instead of directly to the game server hosting the match. Apart from the "w00t this is very cool" factor, why is this feature so important for admins? Basicly, working in a chained model allows to broadcast a match to a large number of spectators without too much hastle and too many risks for the master server.

Chaining was developped for a simple reason: if you take into account that one ETTV slave connects at an '''unlimited''' rate to a master, you really don't want to connect 15 or 20 slaves to a game server to broadcast let's say the ''Atlantic Battle''. Chances are you will bring down the master game server and thus the game. Chaining slaves firmly alleviates the load on the master game server. 2 or 4 of these ''Hubs'' can do the job of delaying the signal and feeding it to other slaves.

Other benefits might include better network performance. If you can choose to either connect your slave to the game server where your connection is not optimal or to a nearby slave who is on a better connection to the master, it might help the quality of your broadcast. Plus you don't need to record anything when connecting to a delayed slave.

==== Setting up your slave to allow connections from other slaves ====

This part is actually pretty easy. You need to set up your slave as if you were setting up a master game server. This means that, next to the normal slave parameters, you have to set up the following:

* '''b_ettv_flags''': set this to at least 1
* '''ettv_sv_maxslaves''': set this to at least 1. Depending on how powerful your machine is you can set this number higher. Don't set it too high though, a slave still connects at an unlimited rate
* '''ettv_password''': set to something else than "". This password is needed by the slaves connecting to your slave (together with g_password of course)

Other settings such as ettv_netblast, ettv_tv_iptos etc... can be set as well. You can even use autorecord if you wish, or just add an extra delay.

==== Pitfalls ====

There are however a few risks associated with slave chaining. One of the biggest issues is '''PK3 dependancies'''.

As you know, a slave needs to have at least all the PK3s of the server it connects too. But a slave can have more PK3s installed, as long as it has the ones on the server's pure list. This is what complicates things! The further you go down the "chain", the more the chances exist of PK3 pollution, which makes the job of the last slave very hard. And the viewers connecting to that slave will not be very happy either.

So for those of you venturing into chaining slaves here's a rule of thumb: '''always keep the installed PK3s to the bare minimum'''! Do not add stuff you do not need. If you want to know what PK3s you need and not need, connect your slave to the master or the hub, see which PK3s are on the pure list and rename or remove the PK3s that are not on the list. You will make your viewers and other admins connecting to your slave very happy.

Another risk could be '''chained lag'''. If one of the slaves that is higher in the chain starts lagging, the consequenses for the slaves depending on it will be seen immedeatily. So if you offer to be one of the higher slaves in the chain, make sure your machine can handle it! An ETTV chain is much like the food chain ;-).

==== Admin contributions ====

If by now you feel like getting your hands dirty in ETTV chaining madness and you want to see some example of hubs, slaves, broadcasters and scripts to get it all working, you can already start by checking out [[User:Deej|deej's page]].

==ETTV Demos==
ETTV can record and playback '''ETTV demos'''. ETTV demos have the extension .tv_84 (or .tv_83 for older versions) and are completely different from the .dm_84 demos recorded on clients.

You may record the match in progress to a file, with the command:
:<tt>record <'''demo name'''></tt>
If you omit the demo name, ettv will start recording using a filename of demoXXXX where XXXX is the first available number starting from 0000.

Demos will stop recording when a map changes.

To stop recording a demo:
:<tt>stoprecord</tt>

To play back a recorded demo:
:<tt>demo <'''demo name'''></tt>

To check the status of an ettv slave:
:<tt>tv status</tt>
This will tell you if the slave is connected to a master, or if it is currently playing back a demo.

To fastforward a demo:
:<tt>ff <seconds></tt>
Eg <tt>ff 30</tt> will fast foward 30 seconds. Fast forward stops at map restarts, so you can safely ff 999 to fast forward through a warmup.
:''note'': requires ettv beta 7 or later

===Autorecording demos===
ettv is able to automatically continuously record demos, creating new demofiles when the map changes. To do this, set the cvar ettv_autorecord to 1. ettv will start recording demos with the name demoXXXX where XXXX is a number starting at 0000 and incrementing on each map change.

Server admins may find it useful to use the demo recording feature of ettv to record matches, instead of requiring individual players to record them. An ettv demo records everything that happens on a server, including all player viewpoints.

===How to create demo based delayed feeds===
Autorecording demos is the first half of the process for delayed feeds. Typically you would run a passworded slave server with the smallest number of sv_maxclients possible. No spectators should connect to this server. The only purpose of this slave is to connect up to the master and record the match to sequentially numbered demofiles.

Now start up a slave, and tell it to broadcast the demo being recorded.

:<tt>demo demo0000</tt>

If you wait approx. 60 seconds after the master begins recording before issuing this command to your slaves, then you have a 60 second delay on your broadcast.

If you want slaves to automatically switch to the next demo when the end of the demo is reached (eg on a map change), you would set the cvar ettv_autoplay to 1. If a slave is playing demo0000 and it reaches the end, it will then try to play demo0001 and so on.

Disadvantage of this method: It is not automated in ettv itself, though admins can script it.
Advantage of this method: You may run multiple broadcast servers from the same single demo stream.

Automated delayed feeds are supported in ettv beta 8. See the above.

===Playing back previously recorded ETTV demos===
This is essentially the same as delayed feeds above.
* Configure your server as described in [[ETTV:Server_Configuration#Installation_-_.22Slave.22_.28broadcast_server.29|Slave Installation]] section
* Obtain the <tt>.tv_*</tt> demos and place them in <tt>''fs_game''/demos</tt>
* Start the ettv executable with pb disabled
* <tt>set ettv_autoplay 1</tt> if you want to play back sequential demos named <tt>demo0000.tv_84</tt>, <tt>demo0001.tv_84</tt> etc.
* <tt>demo '''<yourdemoname>'''</tt>
* connect a client and enjoy the show!

==Troubleshooting==

* The slave server must be running the same fs_game setting as the master server.
* The slave server must have a copy of every map pk3 the master server is using.
* If the master server loads a map the slave server doesn't have, the slave will get stuck.
* Spectators will be forced to download any custom pk3 you are using.
* It is a good idea to keep the master server pk3 list to a minimum.
* If you are using the autorecord/autoplay feature for running delayed feeds, you will usually want to make sure you clear out the demos directory first. Autorecording will start numbering demofiles using the first available number, so if you have old recorded demos then ettv might start recording from eg demo0017. If your scripts expect to start playback from demo0000 then you might end up broadcasting a game recorded at some earlier date...
* If the broadcaster constantly reloads on round starts etc, it's probably a problem with too many pk3s on the ettv servers.

==Miscellaneous==
* Slaves may send chats to the master with the command msay
* Slaves may list players on the master with the command players

==Performance tuning==

Spectator servers with large numbers of clients (eg >100) will push the OS very hard with huge amounts of UDP traffic. The default OS buffer settings for Linux are inadequate and can hurt performance, causing lag and/or disconnects.

If you get messages like
:<tt>NET_SendPacket ERROR: No buffer space available to 192.168.120.142:27960</tt>

Then you definitely need to increase your kernel network buffers.

Large spectator servers should increase the kernel buffers.

The following commands should be issued as root on linux:
:<tt>echo "524288" > /proc/sys/net/core/rmem_max</tt>
:<tt>echo "524288" > /proc/sys/net/core/wmem_max</tt>

These values will be lost on a reboot of your system. A good way to reapply the values upon boot is to include the following in your /etc/sysctl.conf:

:<tt>net.core.rmem_default = 524288</tt>
:<tt>net.core.rmem_max = 524288</tt>
:<tt>net.core.wmem_default = 524288</tt>
:<tt>net.core.wmem_max = 524288</tt>

FreeBSD can try this:
:<tt>sysctl -w net.inet.udp.recvspace=65535</tt>
:<tt>sysctl -w net.inet.udp.maxdgram=57344</tt>
:<tt>sysctl -w kern.ipc.maxsockbuf=8388608</tt>

===Network tuning cvars===
;The following are only available in ettv beta 7 and later.
By default, et uses small packets of 1400 bytes or less to send to clients. If messages need to be larger, they are 'fragmented' and sent over several server frames. ettv slave messages tend to be large and often fragment. ettv normally tries to send slaves all fragments at once to avoid jittery playback, but some networks / OSes handle this badly. ettv beta 7 introduces new controls so admins can optimize ettv for their individual network.

'''ettv_netblast''' (default 1)
:by default, ettv tries to send all fragments at once. some networks may handle this badly. Possible values are:
:* 0 - disable sending all fragments at once. Warning: setting this to 0 without increasing ettv_mtu will result in severely laggy slave playback.
:* 1 - send all fragments at once (default behaviour)
:* 2 - use the old (very broken) beta4 netblast behavior (only applicable for ETTV beta 11 & higher)

'''ettv_mtu''' (default 1400)
:; master only
:if your network / os supports it, you can set this to large values (eg 16000) to prevent message fragmentation and provide smoother ettv links. this cvar has no effect on normal ET clients.
:''note'': ettv_mtu must currently be set from commandline, it cannot be changed on the fly (yet).

'''ettv_tv_iptos''' (default 0)
:you can set the ip type of service field of ettv link packets. if your network/ISP supports it, you can use a value like 16 ("minimize delay") to prioritize ettv link packets over others on the network.

'''ettv_sv_iptos''' (default 0)
:same as ettv_tv_iptos, but affects packets for normal ET clients.

===Article Reference===
(x86|exe) refers to the file extension of the ettv file, for linux use .x86 and for windows use .exe
(so|dll) refers to the file extension of the slave file, for linux use .so and for windows use .dll

[[Category:ETTV]]

ETTV:Server Configuration

2006-07-17T14:03:28Z

Deej: Fusen missed a spot :-)

<dot_graph>
digraph ettv {
master -> slave1
master -> slave2
slave1 -> "client1.."
slave1 -> "..client50"
slave2 -> "client51.."
slave2 -> "..client100"
slave1 -> "chained_slave1"
chained_slave1 -> "client101"
chained_slave1 -> "...client150"
}
</dot_graph>

==Installation - "Master" (gameserver)==

Copy ettv.(x86|exe) to the same directory your etded.(x86|exe) is located.
Start your gameserver as normal, but run ettv.(x86|exe) instead of etded.(x86|exe).

===Set some cvars===

'''ettv_sv_maxslaves''' (default 0, no slave connections allowed)
:Number of ettv slaves allowed to connect.
:''Note:'' Slave slots are always reserved, like private slots.
'''ettv_password''' (default "", no slave connections allowed)
:Password for ettv slaves.
:Must be set, or no slaves will be able to connect!
'''b_ettv_flags''' (default 3)
:1 = prevent slaves from being callvote kicked
:2 = grant shoutcaster status to slaves
:values can be added together, eg 3 for both features.

===Playing on the master===
Players may now connect to your gameserver as normal.

==Installation - "Slave" (broadcast server)==

Copy ettv.(x86|exe) to the same directory your etded.(x86|exe) is located.
Copy tvgame.mp.i386.(so|dll) to the same directory as your etpro/qagame.mp.i386.(so|dll) is located.

===Set some cvars===
'''sv_maxclients'''
:Number of spectator clients to allow. This number is only limited by available cpu and memory.
:Some guidelines when provisioning a broadcast server:
:*100 spectator slots will require ~ 128mb ram. Use com_hunkmegs to set this.
:*100 spectator slots will require ~ 768kbyte/sec (6mbits), roughly 6kbyte/sec per client
:*100 spectator slots will take ~ 80% cpu of a Xeon 2.2ghz
:*Each slave will require ~20-40kbyte/sec from the master.

'''ettv_clientname''' (default "ETTV")
:Playername the slave will use when connecting to the master, eg "ETTV-xyz"

'''ettv_delay''' (default 0, disabled)
:number of seconds for slave to delay the master feed. Recording/playback chains should no longer be needed, and slaves should always maintain an exact delay from the master server.
:''note'': this should ONLY be set on the slave.
:''note'': only supported in ettv beta8 and later

===Chat passwords===
In order to curb the rampant abuse of ettv chat, admins may set "chat passwords" on their servers. If enabled, viewers are not allowed to chat unless they have a password. You can define as many passwords as you like, so you can easily track down individual abusers and limit the damage of stolen passwords.

'''ettv_chatpasswords''' (default 0, disabled)
:number of chat passwords defined.
'''ettv_chatpassword'''(1-99999)
:individual chat passwords.

viewers use <tt>/chatpassword <password></tt> to login.

if logged in, ettv chats will be tagged with a number in parentheses identifying which chat password the viewer is using.
===Misc commands for viewers===
;For ettv beta 4 and above
* spectators may <tt>/ignore</tt> and <tt>/unignore</tt> other spectators
* semiadmin functionality now works for slaves
* rcon may now mute/unmute specs

===Connect the slave===
Now start your slave server by running ettv.(x86|exe)

Tell the slave server to connect up to the master server:
:<tt>tv connect master.ip.address:port ettv_password(required) g_password(if the master has a g_password set)</tt>

If you have configured everything correctly, the slave should connect to the master.
Clients should now be able to connect to the slave and spectate the game in progress.

This is a "live broadcast" with no delay.

===Disconnect the slave===
To tell the slave to disconnect from the master:
:<tt>tv disconnect</tt>

===Slave Chaining===

==== What is chaining and why chain slaves? ====

ETTV allows chaining slaves together. This very neat feature lets you connect one ETTV slave to another ETTV slave that is broadcasting a match instead of directly to the game server hosting the match. Apart from the "w00t this is very cool" factor, why is this feature so important for admins? Basicly, working in a chained model allows to broadcast a match to a large number of spectators without too much hastle and too many risks for the master server.

Chaining was developped for a simple reason: if you take into account that one ETTV slave connects at an '''unlimited''' rate to a master, you really don't want to connect 15 or 20 slaves to a game server to broadcast let's say the ''Atlantic Battle''. Chances are you will bring down the master game server and thus the game. Chaining slaves firmly alleviates the load on the master game server. 2 or 4 of these ''Hubs'' can do the job of delaying the signal and feeding it to other slaves.

Other benefits might include better network performance. If you can choose to either connect your slave to the game server where your connection is not optimal or to a nearby slave who is on a better connection to the master, it might help the quality of your broadcast. Plus you don't need to record anything when connecting to a delayed slave.

==== Setting up your slave to allow connections from other slaves ====

This part is actually pretty easy. You need to set up your slave as if you were setting up a master game server. This means that, next to the normal slave parameters, you have to set up the following:

* '''b_ettv_flags''': set this to at least 1
* '''ettv_sv_maxslaves''': set this to at least 1. Depending on how powerful your machine is you can set this number higher. Don't set it too high though, a slave still connects at an unlimited rate
* '''ettv_password''': set to something else than "". This password is needed by the slaves connecting to your slave (together with g_password of course)

Other settings such as ettv_netblast, ettv_tv_iptos etc... can be set as well. You can even use autorecord if you wish, or just add an extra delay.

==== Pitfalls ====

There are however a few risks associated with slave chaining. One of the biggest issues is '''PK3 dependancies'''.

As you know, a slave needs to have at least all the PK3s of the server it connects too. But a slave can have more PK3s installed, as long as it has the ones on the server's pure list. This is what complicates things! The further you go down the "chain", the more the chances exist of PK3 pollution, which makes the job of the last slave very hard. And the viewers connecting to that slave will not be very happy either.

So for those of you venturing into chaining slaves here's a rule of thumb: '''always keep the installed PK3s to the bare minimum'''! Do not add stuff you do not need. If you want to know what PK3s you need and not need, connect your slave to the master or the hub, see which PK3s are on the pure list and rename or remove the PK3s that are not on the list. You will make your viewers and other admins connecting to your slave very happy.

Another risk could be '''chained lag'''. If one of the slaves that is higher in the chain starts lagging, the consequenses for the slaves depending on it will be seen immedeatily. So if you offer to be one of the higher slaves in the chain, make sure your machine can handle it! An ETTV chain is much like the food chain ;-).

==== Admin contributions ====

If by now you feel like getting your hands dirty in ETTV chaining madness and you want to see some example of hubs, slaves, broadcasters and scripts to get it all working, you can already start by checking out [[User:Deej|deej's page]].

==ETTV Demos==
ETTV can record and playback '''ETTV demos'''. ETTV demos have the extension .tv_84 (or .tv_83 for older versions) and are completely different from the .dm_84 demos recorded on clients.

You may record the match in progress to a file, with the command:
:<tt>record <'''demo name'''></tt>
If you omit the demo name, ettv will start recording using a filename of demoXXXX where XXXX is the first available number starting from 0000.

Demos will stop recording when a map changes.

To stop recording a demo:
:<tt>stoprecord</tt>

To play back a recorded demo:
:<tt>demo <'''demo name'''></tt>

To check the status of an ettv slave:
:<tt>tv status</tt>
This will tell you if the slave is connected to a master, or if it is currently playing back a demo.

To fastforward a demo:
:<tt>ff <seconds></tt>
Eg <tt>ff 30</tt> will fast foward 30 seconds. Fast forward stops at map restarts, so you can safely ff 999 to fast forward through a warmup.
:''note'': requires ettv beta 7 or later

===Autorecording demos===
ettv is able to automatically continuously record demos, creating new demofiles when the map changes. To do this, set the cvar ettv_autorecord to 1. ettv will start recording demos with the name demoXXXX where XXXX is a number starting at 0000 and incrementing on each map change.

Server admins may find it useful to use the demo recording feature of ettv to record matches, instead of requiring individual players to record them. An ettv demo records everything that happens on a server, including all player viewpoints.

===How to create demo based delayed feeds===
Autorecording demos is the first half of the process for delayed feeds. Typically you would run a passworded slave server with the smallest number of sv_maxclients possible. No spectators should connect to this server. The only purpose of this slave is to connect up to the master and record the match to sequentially numbered demofiles.

Now start up a slave, and tell it to broadcast the demo being recorded.

:<tt>demo demo0000</tt>

If you wait approx. 60 seconds after the master begins recording before issuing this command to your slaves, then you have a 60 second delay on your broadcast.

If you want slaves to automatically switch to the next demo when the end of the demo is reached (eg on a map change), you would set the cvar ettv_autoplay to 1. If a slave is playing demo0000 and it reaches the end, it will then try to play demo0001 and so on.

Disadvantage of this method: It is not automated in ettv itself, though admins can script it.
Advantage of this method: You may run multiple broadcast servers from the same single demo stream.

Automated delayed feeds are supported in ettv beta 8. See the above.

===Playing back previously recorded ETTV demos===
This is essentially the same as delayed feeds above.
* Configure your server as described in [[ETTV:Server_Configuration#Installation_-_.22Slave.22_.28broadcast_server.29|Slave Installation]] section
* Obtain the <tt>.tv_*</tt> demos and place them in <tt>''fs_game''/demos</tt>
* Start the ettv executable with pb disabled
* <tt>set ettv_autoplay 1</tt> if you want to play back sequential demos named <tt>demo0000.tv_84</tt>, <tt>demo0001.tv_84</tt> etc.
* <tt>demo '''<yourdemoname>'''</tt>
* connect a client and enjoy the show!

==Troubleshooting==

* The slave server must be running the same fs_game setting as the master server.
* The slave server must have a copy of every map pk3 the master server is using.
* If the master server loads a map the slave server doesn't have, the slave will get stuck.
* Spectators will be forced to download any custom pk3 you are using.
* It is a good idea to keep the master server pk3 list to a minimum.
* If you are using the autorecord/autoplay feature for running delayed feeds, you will usually want to make sure you clear out the demos directory first. Autorecording will start numbering demofiles using the first available number, so if you have old recorded demos then ettv might start recording from eg demo0017. If your scripts expect to start playback from demo0000 then you might end up broadcasting a game recorded at some earlier date...
* If the broadcaster constantly reloads on round starts etc, it's probably a problem with too many pk3s on the ettv servers.

==Miscellaneous==
* Slaves may send chats to the master with the command msay
* Slaves may list players on the master with the command players

==Performance tuning==

Spectator servers with large numbers of clients (eg >100) will push the OS very hard with huge amounts of UDP traffic. The default OS buffer settings for Linux are inadequate and can hurt performance, causing lag and/or disconnects.

If you get messages like
:<tt>NET_SendPacket ERROR: No buffer space available to 192.168.120.142:27960</tt>

Then you definitely need to increase your kernel network buffers.

Large spectator servers should increase the kernel buffers.

The following commands should be issued as root on linux:
:<tt>echo "524288" > /proc/sys/net/core/rmem_max</tt>
:<tt>echo "524288" > /proc/sys/net/core/wmem_max</tt>

These values will be lost on a reboot of your system. A good way to reapply the values upon boot is to include the following in your /etc/sysctl.conf:

:<tt>net.core.rmem_default = 524288</tt>
:<tt>net.core.rmem_max = 524288</tt>
:<tt>net.core.wmem_default = 524288</tt>
:<tt>net.core.wmem_max = 524288</tt>

FreeBSD can try this:
:<tt>sysctl -w net.inet.udp.recvspace=65535</tt>
:<tt>sysctl -w net.inet.udp.maxdgram=57344</tt>
:<tt>sysctl -w kern.ipc.maxsockbuf=8388608</tt>

===Network tuning cvars===
;The following are only available in ettv beta 7 and later.
By default, et uses small packets of 1400 bytes or less to send to clients. If messages need to be larger, they are 'fragmented' and sent over several server frames. ettv slave messages tend to be large and often fragment. ettv normally tries to send slaves all fragments at once to avoid jittery playback, but some networks / OSes handle this badly. ettv beta 7 introduces new controls so admins can optimize ettv for their individual network.

'''ettv_netblast''' (default 1)
:by default, ettv tries to send all fragments at once. some networks may handle this badly. setting this to 0 disables. warning: setting this to 0 without increasing ettv_mtu will result in severely laggy slave playback.

'''ettv_mtu''' (default 1400)
:; master only
:if your network / os supports it, you can set this to large values (eg 16000) to prevent message fragmentation and provide smoother ettv links. this cvar has no effect on normal ET clients.
:''note'': ettv_mtu must currently be set from commandline, it cannot be changed on the fly (yet).

'''ettv_tv_iptos''' (default 0)
:you can set the ip type of service field of ettv link packets. if your network/ISP supports it, you can use a value like 16 ("minimize delay") to prioritize ettv link packets over others on the network.

'''ettv_sv_iptos''' (default 0)
:same as ettv_tv_iptos, but affects packets for normal ET clients.

===Article Reference===
(x86|exe) refers to the file extension of the ettv file, for linux use .x86 and for windows use .exe
(so|dll) refers to the file extension of the slave file, for linux use .so and for windows use .dll

[[Category:ETTV]]

User talk:Dersaidin

2006-07-05T13:53:02Z

Deej:

Good work but I'll give you a heads-up: ReyalP might end up slapping you with the preview stick ;-). [[User:Deej|deej]] 06:53, 5 July 2006 (PDT)

EDV

2006-07-05T13:41:14Z

Deej: some spelling & punctation stuff

EDV stands for Extended Demo Viewer. It's a tool which gives you camera-moving possibilities. The most important options are the freecam and the weaponcam.

The freecam gives you the ability to watch a demo as a spectator, in other words you can freely fly around the map using your ingame movement
keys. type ''/freecam'' in the console to enable it. If you want fly through walls, you can use the well known "noclip" command.

'''NOTE:''' If you move
out of the pvs of the demo (the pvs of the player who recorded the demo), you won't see anything at all. Sometimes it's hard to find your way
back to the pvs, if you set the cvar b_demo_pvshint to 1, a line will be drawn from the camera origin to the demo-recorder's origin, in addition of noclip you will easily find your way back to the pvs. If ''b_predefineddemokeys'' is set to 1 you will be able to use the
hardcoded keys from the demohelpmenu, KP_ENTER is the key to toggle freecam, but I recommend that you set ''b_predefineddemokeys'' to 0 because in this doc the cvars/cmd's will be explained.

With "freecamgetpos" you can retrieve the position of the camera, and with "freecamsetpos" you can set it. When you set ''b_demo_lookat'' to a clientNum (default value is -1 = turned off) the camera will always look at that player. You can reveal the clientNums with b_demo_nametag +4 (nametags are actually floating playernames): +1 draws nametags from players who are in your pvs, +2 from every player, +4 adds the clientnumber to the nametag, +8 adds the class (letter) to the nametag. The same option exists for dynamites: ''b_demo_dynamitecounter'' which draws a floating timer for every dynamite in your current fov.

If you want turn the camera with some keys, use:
<pre>
+freecam_turnup
+freecam_turndown
+freecam_turnleft
+freecam_turnright
+freecam_rollleft
+freecam_rollright
</pre>
the cvars '''b_demo_yawturnspeed b_demo_pitchturnspeed b_demo_rollspeed''', will control the speed of these commands

''b_demo_playersprites'' turns of player sprites in demoplay (the docs icon, the ! mark, ...)

The weaponcam attaches the camera to a missile (grenade, panzer, dynamite)

set:
<pre>
b_demo_grenadecam +1 to follow grenades
b_demo_grenadecam +2 to follow airstrike/smokegrenade cannisters
b_demo_mortarcam 1 to follow mortars
b_demo_panzercam 1 to follow panzers
</pre>
b_demo_teamonlymissilecam 1 if you only want to see the missiles of your teammates

next cvars control the distance from the camera to the missile:
<pre>
b_demo_followxDistance
b_demo_followyDistance
b_demo_followzDistance
</pre>
''b_demo_nopitch'' toggles the camera pitching when attached to a missile

If you want a good config, read this thread: http://bani.anime.net/banimod/forums/viewtopic.php?t=3207

Auto change timescale to b_demo_autotimescale in weaponcam if the weapon is set in b_demo_autotimescaleweapons (bitflag)
* 1 = panzer
* 2 = grenade
* 4 = dynamite
* 8 = mortar
* 16 = smoke

Lua Tutorials

2006-04-27T09:03:59Z

Deej: it's madness...

__NOEDITSECTION__

This page isn't finished but it is supposed to make you understand [[ETPro]] [http://www.lua.org/ lua] functions.

Before you start on this tutorial I assume you know basic [http://www.lua.org/ lua] scripting. If not then I suggest you take a look at the online edition of the book [http://www.lua.org/pil/ Programming in Lua] or the [http://lua-users.org/wiki/ lua-users wiki].
You can also take a look at someone else his code, a list of [[ETPro]] mods can be found [[:Category:ETPro:Mods|here]].

==Getting started==
===Loading a Script===
:Scripts are loaded by their file name out of the /etpro sub directory of your Enemy Territory installation, so don't forget to save them in the right folder. 
:if you want to load HelloWorld.lua you would have to set the server cvar '''lua_modules''' to ''"HelloWorld.lua"''. 
:If you want to load more mods you can add them to the same variables separated by a space like ''"HelloWorld.lua lol.lua pingpong.lua"''
:'''NOTE''': if you modify this cvar all currently loaded [http://www.lua.org/ lua] modules will be unloaded.

:After editing your script you save it and then reload it in [[ETPro]] to make your chances take effect, this can simply be done by '''reset_match''' server command.

===Development Environment===
:While scripting you will see your code gets hard to read, its much easier to read with syntax highlighting. This can be done be scripting inside an [http://www.lua.org/ lua] development environment.

:At [http://lua-users.org/wiki/LuaAddons this page] under ''[http://lua-users.org/wiki/LuaAddons development environments]'' you will find a list of [http://lua-users.org/wiki/LuaAddons development environments].

==Tutorials==
:'''NOTE''': Lines written in '''Bold''' are the actual lines we are going to write in our script.
===Hello World===
:Here we will show a simple hello world example for the server console.
:Just follow the steps and read the comments.

:1. First we need a new file so, create a new file and name it HelloWorld.lua.

::Now we need an [[ETPro]] [http://www.lua.org/ lua] function that will be called automatically by [[ETPro]] when we want it. Therefore we will use ''et_InitGame(levelTime,randomSeed,restart)''. That function is called once every round at the beginning. It's a good function to do some initial settings. We do not have to worry about those parameters (levelTime,randomSeed,restart) in this example.

:2. Inside our file at line ''1'' we will write '''function et_InitGame(levelTime,randomSeed,restart) -- called at beginning of a gameround'''

::Now we got a part of our script that is called at the beginning of a round so now we can add our code to it. We are going to print ''"hello world"'' in the server console. To do this we will use ''et.G_Print("message")''. That function will simply print the ''"message"'' in the server console.

:3. At line ''2'' we will write ''' et.G_Print("Hello World!!!\n") -- printout our text to the console'''

::Lastly we need to end out function at line ''1'' with a simple ''end''

:4. At line ''3'' place '''end --close et_InitGame()'''

::Now if you did it right you should have something like [http://home.zonnet.nl/westhof99/lua/HelloWorld.lua this]:
function et_InitGame(levelTime,randomSeed,restart) -- called at beginning of a gameround
et.G_Print("Hello World!!!\n") -- printout our text to the console
end --close et_InitGame()

::Now save and load your script and you will see Hello World!!! in the server console.

<hr>
===Hello Spam===
:Here we will show a simple Spammy hello world example for the server console.
:Just follow the steps and read the comments.

:1. First we need a new file so, create a new file and name it '''HelloSpam.lua'''.

::Now we need an [[ETPro]] [http://www.lua.org/ lua] function that will be called automatically by [[ETPro]] many times to make it spammy. Therefore we will use ''et_RunFrame(levelTime)''. That function is called every server frame. It is a good function for stuff you need to constantly check but you should not put to much code in here. We do not have to worry about those parameter (levelTime) in this example.

:2. Inside our file at line ''1'' we will write '''function et_RunFrame(levelTime) --called every serverframe'''

::Now we got a part of our script that is called at the beginning of a round so, now we can add our code to it. We are going to print ''"hello world"'' in the server console. To do this we will use ''et.G_Print("message")''; that function will simply print the ''"message"'' in the server console

:3. Now at line ''2'' we will write ''' et.G_Print("Hello Spam!!!\n") -- printout our text to the console'''

::Lastly we need to end our function at line ''1'' with a simple at line ''3'' ''end''

:4. At line ''3'' place '''end --close et_RunFrame()'''

::Now if you did it right you should have something like [http://home.zonnet.nl/westhof99/lua/HelloSpam.lua this]:
function et_RunFrame(levelTime) --called every serverframe
et.G_Print("Hello Spam!!!\n") -- printout our text to the console
end --close et_RunFrame()
::Now save and load your script and you will see Hello Spam!!! in the server console.
<hr>
===Hello Client===
:Here we will show a simple hello world example for the client console.
:Just follow the steps and read the comments.

:1. First we need a new file so, create a new file and name it HelloClient.lua.

::Now we need a [[ETPro]] [http://www.lua.org/ lua] function that will be called automatically by [[ETPro]] when we want it. To do this we will use ''et_InitGame(levelTime,randomSeed,restart)'' as shown in the ''Hello World'' example.

:2. Inside our file at line ''1'' we will write '''function et_InitGame(levelTime,randomSeed,restart) --called at beginning of a gameround'''

::Now we need a function to print a message to the client his console. We will use et.trap_SendServerCommand(-1,"print \"message\n\"")'' to achieve this. That function will simply print the ''"message"'' in the client's console.
::The first parameter is the client slot to send to. When this is -1 ETPro will send the message to all clients. The 2nd parameter looks confusing and like the original author's spelling, it is. First you have the main command witch is "print ..". Then, at the place of the dots, comes the data to send with the print. In our case this is "message\n"".
::The \n will send a newline command to the console so the next message written to the console is on the next line. The \" are just quotes but since they are already inside a string you need to prefix them with a \ (commonly known as an escape character).

:3. So just write this at line ''2'' ''' et.trap_SendServerCommand(-1,"print \"Hello Client\n\"") -- printout our text to the console'''

::Last we need to end our function at line ''1'' with a simple ''end''

:4. At line ''3'' place '''end --close et_InitGame()'''

::Now if you did it right you should have something like [http://home.zonnet.nl/westhof99/lua/HelloClient.lua this]:
function et_InitGame(levelTime,randomSeed,restart) -- called at beginning of a gameround
et.trap_SendServerCommand(-1,"print \"Hello Client\n\"") -- printout our text to the console
end -- close et_InitGame()

::Now save and load your script and you will see Hello World!!! in the client's console at the begin of a round.
<hr>
[[Category:ETPro]]
[[Category:ETPro:Mods]]
[[Category:ETPro:LUA]]

Lua Tutorials

2006-04-27T09:01:51Z

Deej: whipped out the spelling & grammer stick but surely missed a few ones

__NOEDITSECTION__

This page isn't finished but its supposed to make you understand [[ETPro]] [http://www.lua.org/ lua] functions.

Before you start on this tutorial it's assumed you do know basic [http://www.lua.org/ lua] scripting. If not then I suggest you take a look at the online edition of the book [http://www.lua.org/pil/ Programming in Lua] or the [http://lua-users.org/wiki/ lua-users wiki].
You can also take a look at someone else his code, a list of [[ETPro]] mods can be found [[:Category:ETPro:Mods|here]].

==Getting started==
===Loading a Script===
:Scripts are loaded by their file name out of the /etpro sub directory of your Enemy Territory installation, so don't forget to save them in the right folder. 
:if you want to load HelloWorld.lua you would have to set the server cvar '''lua_modules''' to ''"HelloWorld.lua"''. 
:If you want to load more mods you can add them to the same variables separated by a space like ''"HelloWorld.lua lol.lua pingpong.lua"''
:'''NOTE''': if you modify this cvar all currently loaded [http://www.lua.org/ lua] modules will be unloaded.

:After editing your script you save it and then reload it in [[ETPro]] to make your chances take effect, this can simply be done by '''reset_match''' server command.

===Development Environment===
:While scripting you will see your code gets hard to read, its much easier to read with syntax highlighting. This can be done be scripting inside an [http://www.lua.org/ lua] development environment.

:At [http://lua-users.org/wiki/LuaAddons this page] under ''[http://lua-users.org/wiki/LuaAddons development environments]'' you will find a list of [http://lua-users.org/wiki/LuaAddons development environments].

==Tutorials==
:'''NOTE''': Lines written in '''Bold''' are the actual lines we are going to write in our script.
===Hello World===
:Here we will show a simple hello world example for the server console.
:Just follow the steps and read the comments.

:1. First we need a new file so, create a new file and name it HelloWorld.lua.

::Now we need an [[ETPro]] [http://www.lua.org/ lua] function that will be called automatically by [[ETPro]] when we want it. Therefore we will use ''et_InitGame(levelTime,randomSeed,restart)''. That function is called once every round at the beginning. It's a good function to do some initial settings. We do not have to worry about those parameters (levelTime,randomSeed,restart) in this example.

:2. Inside our file at line ''1'' we will write '''function et_InitGame(levelTime,randomSeed,restart) -- called at beginning of a gameround'''

::Now we got a part of our script that is called at the beginning of a round so now we can add our code to it. We are going to print ''"hello world"'' in the server console. To do this we will use ''et.G_Print("message")''. That function will simply print the ''"message"'' in the server console.

:3. At line ''2'' we will write ''' et.G_Print("Hello World!!!\n") -- printout our text to the console'''

::And as last we need to end out function at line ''1'' whit a simple ''end''

:4. At line ''3'' place '''end --close et_InitGame()'''

::Now if you did it right you should have something like [http://home.zonnet.nl/westhof99/lua/HelloWorld.lua this]:
function et_InitGame(levelTime,randomSeed,restart) -- called at beginning of a gameround
et.G_Print("Hello World!!!\n") -- printout our text to the console
end --close et_InitGame()

::Now save and load your script and you will see Hello World!!! in the server console.

<hr>
===Hello Spam===
:Here we will show a simple Spammy hello world example for the server console.
:Just follow the steps and read the comments.

:1. First we need a new file so, create a new file and name it '''HelloSpam.lua'''.

::Now we need an [[ETPro]] [http://www.lua.org/ lua] function that will be called automatically by [[ETPro]] many times to make it spammy. Therefore we will use ''et_RunFrame(levelTime)''. That function is called every server frame. It is a good function for stuff you need to constantly check but you should not put to much code in here. We do not have to worry about those parameter (levelTime) in this example.

:2. Inside our file at line ''1'' we will write '''function et_RunFrame(levelTime) --called every serverframe'''

::Now we got a part of our script that is called at the beginning of a round so, now we can add our code to it. We are going to print ''"hello world"'' in the server console. To do this we will use ''et.G_Print("message")''; that function will simply print the ''"message"'' in the server console

:3. Now at line ''2'' we will write ''' et.G_Print("Hello Spam!!!\n") -- printout our text to the console'''

::And lastly we need to end our function at line ''1'' whit a simple at line ''3'' ''end''

:4. At line ''3'' place '''end --close et_RunFrame()'''

::Now if you did it right you should have something like [http://home.zonnet.nl/westhof99/lua/HelloSpam.lua this]:
function et_RunFrame(levelTime) --called every serverframe
et.G_Print("Hello Spam!!!\n") -- printout our text to the console
end --close et_RunFrame()
::Now save and load your script and you will see Hello Spam!!! in the server console.
<hr>
===Hello Client===
:Here we will show a simple hello world example for the client console.
:Just follow the steps and read the comments.

:1. First we need a new file so, create a new file and name it HelloClient.lua.

::Now we need a [[ETPro]] [http://www.lua.org/ lua] function that will be called automatically by [[ETPro]] when we want it. To do this we will use ''et_InitGame(levelTime,randomSeed,restart)'' as shown in the ''Hello World'' example.

:2. Inside our file at line ''1'' we will write '''function et_InitGame(levelTime,randomSeed,restart) --called at beginning of a gameround'''

::Now we need a function to print a message to the client his console. We will use et.trap_SendServerCommand(-1,"print \"message\n\"")'' to achieve this. That function will simply print the ''"message"'' in the client's console.
::The first parameter is the client slot to send to. When this is -1 ETPro will send the message to all clients. The 2nd parameter looks confusing and like the original author's spelling, it is. First you have the main command witch is "print ..". Then, at the place of the dots, comes the data to send with the print. In our case this is "message\n"".
::The \n will send a newline command to the console so the next message written to the console is on the next line. The \" are just quotes but since they are already inside a string you need to prefix them with a \ (commonly known as an escape character).

:3. So just write this at line ''2'' ''' et.trap_SendServerCommand(-1,"print \"Hello Client\n\"") -- printout our text to the console'''

::Last we need to end our function at line ''1'' with a simple ''end''

:4. At line ''3'' place '''end --close et_InitGame()'''

::Now if you did it right you should have something like [http://home.zonnet.nl/westhof99/lua/HelloClient.lua this]:
function et_InitGame(levelTime,randomSeed,restart) -- called at beginning of a gameround
et.trap_SendServerCommand(-1,"print \"Hello Client\n\"") -- printout our text to the console
end -- close et_InitGame()

::Now save and load your script and you will see Hello World!!! in the client's console at the begin of a round.
<hr>
[[Category:ETPro]]
[[Category:ETPro:Mods]]
[[Category:ETPro:LUA]]

Lua Tutorials

2006-04-27T09:00:58Z

Deej: whipped out the spelling & grammer stick but surely missed a few ones

__NOEDITSECTION__

This page isn't finished but its supposed to make you understand [[ETPro]] [http://www.lua.org/ lua] functions.

Before you start on this tutorial its assumed you do know basic [http://www.lua.org/ lua] scripting ,if not then I suggest you take a look at the online edition of the book [http://www.lua.org/pil/ Programming in Lua] or the [http://lua-users.org/wiki/ lua-users wiki].
You can also take a look at someone else his code, a list of [[ETPro]] mods can be found [[:Category:ETPro:Mods|here]].

==Getting started==
===Loading a Script===
:Scripts are loaded by their file name out of the /etpro sub directory of your Enemy Territory installation, so don't forget to save them in the right folder. 
:if you want to load HelloWorld.lua you would have to set the server cvar '''lua_modules''' to ''"HelloWorld.lua"''. 
:If you want to load more mods you can add them to the same variables separated by a space like ''"HelloWorld.lua lol.lua pingpong.lua"''
:'''NOTE''': if you modify this cvar all currently loaded [http://www.lua.org/ lua] modules will be unloaded.

:After editing your script you save it and then reload it in [[ETPro]] to make your chances take effect, this can simply be done by '''reset_match''' server command.

===Development Environment===
:While scripting you will see your code gets hard to read, its much easier to read with syntax highlighting. This can be done be scripting inside an [http://www.lua.org/ lua] development environment.

:At [http://lua-users.org/wiki/LuaAddons this page] under ''[http://lua-users.org/wiki/LuaAddons development environments]'' you will find a list of [http://lua-users.org/wiki/LuaAddons development environments].

==Tutorials==
:'''NOTE''': Lines written in '''Bold''' are the actual lines we are going to write in our script.
===Hello World===
:Here we will show a simple hello world example for the server console.
:Just follow the steps and read the comments.

:1. First we need a new file so, create a new file and name it HelloWorld.lua.

::Now we need an [[ETPro]] [http://www.lua.org/ lua] function that will be called automatically by [[ETPro]] when we want it. Therefore we will use ''et_InitGame(levelTime,randomSeed,restart)''. That function is called once every round at the beginning. It's a good function to do some initial settings. We do not have to worry about those parameters (levelTime,randomSeed,restart) in this example.

:2. Inside our file at line ''1'' we will write '''function et_InitGame(levelTime,randomSeed,restart) -- called at beginning of a gameround'''

::Now we got a part of our script that is called at the beginning of a round so now we can add our code to it. We are going to print ''"hello world"'' in the server console. To do this we will use ''et.G_Print("message")''. That function will simply print the ''"message"'' in the server console.

:3. At line ''2'' we will write ''' et.G_Print("Hello World!!!\n") -- printout our text to the console'''

::And as last we need to end out function at line ''1'' whit a simple ''end''

:4. At line ''3'' place '''end --close et_InitGame()'''

::Now if you did it right you should have something like [http://home.zonnet.nl/westhof99/lua/HelloWorld.lua this]:
function et_InitGame(levelTime,randomSeed,restart) -- called at beginning of a gameround
et.G_Print("Hello World!!!\n") -- printout our text to the console
end --close et_InitGame()

::Now save and load your script and you will see Hello World!!! in the server console.

<hr>
===Hello Spam===
:Here we will show a simple Spammy hello world example for the server console.
:Just follow the steps and read the comments.

:1. First we need a new file so, create a new file and name it '''HelloSpam.lua'''.

::Now we need an [[ETPro]] [http://www.lua.org/ lua] function that will be called automatically by [[ETPro]] many times to make it spammy. Therefore we will use ''et_RunFrame(levelTime)''. That function is called every server frame. It is a good function for stuff you need to constantly check but you should not put to much code in here. We do not have to worry about those parameter (levelTime) in this example.

:2. Inside our file at line ''1'' we will write '''function et_RunFrame(levelTime) --called every serverframe'''

::Now we got a part of our script that is called at the beginning of a round so, now we can add our code to it. We are going to print ''"hello world"'' in the server console. To do this we will use ''et.G_Print("message")''; that function will simply print the ''"message"'' in the server console

:3. Now at line ''2'' we will write ''' et.G_Print("Hello Spam!!!\n") -- printout our text to the console'''

::And lastly we need to end our function at line ''1'' whit a simple at line ''3'' ''end''

:4. At line ''3'' place '''end --close et_RunFrame()'''

::Now if you did it right you should have something like [http://home.zonnet.nl/westhof99/lua/HelloSpam.lua this]:
function et_RunFrame(levelTime) --called every serverframe
et.G_Print("Hello Spam!!!\n") -- printout our text to the console
end --close et_RunFrame()
::Now save and load your script and you will see Hello Spam!!! in the server console.
<hr>
===Hello Client===
:Here we will show a simple hello world example for the client console.
:Just follow the steps and read the comments.

:1. First we need a new file so, create a new file and name it HelloClient.lua.

::Now we need a [[ETPro]] [http://www.lua.org/ lua] function that will be called automatically by [[ETPro]] when we want it. To do this we will use ''et_InitGame(levelTime,randomSeed,restart)'' as shown in the ''Hello World'' example.

:2. Inside our file at line ''1'' we will write '''function et_InitGame(levelTime,randomSeed,restart) --called at beginning of a gameround'''

::Now we need a function to print a message to the client his console. We will use et.trap_SendServerCommand(-1,"print \"message\n\"")'' to achieve this. That function will simply print the ''"message"'' in the client's console.
::The first parameter is the client slot to send to. When this is -1 ETPro will send the message to all clients. The 2nd parameter looks confusing and like the original author's spelling, it is. First you have the main command witch is "print ..". Then, at the place of the dots, comes the data to send with the print. In our case this is "message\n"".
::The \n will send a newline command to the console so the next message written to the console is on the next line. The \" are just quotes but since they are already inside a string you need to prefix them with a \ (commonly known as an escape character).

:3. So just write this at line ''2'' ''' et.trap_SendServerCommand(-1,"print \"Hello Client\n\"") -- printout our text to the console'''

::Last we need to end our function at line ''1'' with a simple ''end''

:4. At line ''3'' place '''end --close et_InitGame()'''

::Now if you did it right you should have something like [http://home.zonnet.nl/westhof99/lua/HelloClient.lua this]:
function et_InitGame(levelTime,randomSeed,restart) -- called at beginning of a gameround
et.trap_SendServerCommand(-1,"print \"Hello Client\n\"") -- printout our text to the console
end -- close et_InitGame()

::Now save and load your script and you will see Hello World!!! in the client's console at the begin of a round.
<hr>
[[Category:ETPro]]
[[Category:ETPro:Mods]]
[[Category:ETPro:LUA]]

Talk:B placebo

2006-04-24T17:39:51Z

Deej:

Some people feel that [[B_placebo]] should require a vid_restart, or even a full game restart after changes, to prevent abuse (see [[Placebo Scripts]]). Discuss.

:[[User:ReyalP|ReyalP]] 00:59, 22 April 2006 (PDT)

I think that simply delaying the change should be sufficient, as usually even those who use Placebo Scripts want b_placebo on 90% of the time. It's just a few points in time where they need to quickly switch it off that is the problem. Delaying it would nullify any abuses I can think of. Another thing may be to make it only server-side. And to prevent it from being changed without users noticing after a map change or warm-up ends, there could be either a visual or audio indication as to b_placebo status.
:--[[User:WeblionX|WeblionX]] 16:02, 22 April 2006 (PDT)

Why don't make it like the regionCode in standalone DVD-Players. Let them change, hmm lets say, 5 times, then keep the current setting until they die.
So they have some time to test if they prefer either 0 or 1 --[[User:Deus|Deus]] 01:08, 23 April 2006 (PDT)

That would be good, but people seem to bypass region codes too easily. :\
:--[[User:WeblionX|WeblionX]] 10:46, 23 April 2006 (PDT)

You are really limiting yourself if you only use 0 and 1
:--[[User:ReyalP|ReyalP]] 16:56, 23 April 2006 (PDT)

George Boole just turned in his grave ReyalP ;-) -- [[User:Deej|deej]] 10:39, 24 April 2006 (PDT)

User:Deej

2006-04-06T12:31:52Z

Deej: tweaked oldschool script a bit

http://www.fragland.org/deej/572.gif 
Guilty for founding the [http://www.fragland.org Retired Old Farts] which provide: 
- ETPro servers 
- ETTV servers 
- ETPub servers 
- General annoyance 
- Pub requests for a competition mod 

== My interpretation of ETTV setups ==

Since I'm quite fond of toying around with new developments, I'm always one of the first to test new ETTV / ETPro releases and bug bani with questions about them. Having said that, here's my 'personal' view on a good ETTV broadcast (this is not the Bible!):

=== Terminology ===

There are 5 different "participants" possibly involved in an ETTV broadcast:

* '''Master''' - the gameserver hosting the actual game
* '''Viewer''' - the viewer wanting to view a game (duh)
* '''Broadcaster''' - a server that is directly connected to a gameserver and allows viewer to connect directly to itself
* '''Hub''' - a server that is directly connected to a gameserver and allows other ETTV 'slaves' to connect to itself, but not viewers
* '''Slave''' - a server that connects to a hub or perhaps a broadcaster and and allows viewers to connect to itself

Keep this terminology in mind when you stroll through my text ;-).

=== Today's broadcasts ===

Most ETTV games I see today use this set-up:

:<code>Viewer -> Broadcaster -> Master</code>

If you remember that an ETTV server connects at an ''unlimited rate'' to another server, and as from ETTV b9 the slaves are in fact not limited at all by the original ET netcode, you might see a problem arising when lots of people would like to see a "big match".

The trouble was / is that before ETTV b8 and 'autodelay', we had to do some fancy flying to get a delayed broadcast or delayed hub up. Usually you would start a 'recorder' daemon that recorded demos and a 'playback' daemon from that same directory, so that it started playing back the recorded demo after roughly 60 or 90 seconds. This does require fancy scripting and lots of manual work to sort out demos, connect slaves to hubs etc...

With <code>ettv_autodelay</code>, things have become a lot easier. Ideally the gameserver now only allows 2 or 4 ETTV hubs to connect to it, which delay and relay the signal. The responsibility for the admins of the hub is of course greater as they should not have any PK3s active on their hubs that are not on the pure list of the server. The less PK3s you need, the better!

=== Deej's proposition ===

The best setup IMHO is to have the following:

<pre>Viewers -> Slave 1 |
Viewers -> Slave 2 |
Viewers -> Slave 3 |--> Hub 1 |
|--> Hub 2 | --> Master
Viewers -> Slave ... |--> Hub n |
|
Viewers -> Slave n |</pre>

This alleviates the load on the Master Game Server firmly as only 2 or 4 hubs are required where slaves can then connect to! Furthermore with autodelay all the 'slave' administrators only need to connect their slave to a given hub. No more playing around with delays, demos, symbolic links, PIDs that get screwed up etc...

== Some scripts I use ==

=== Hub script ===

This script launches a hub that delays its feed by x seconds, configurable inside the script. You can safely remove the stuff like PERONI_IP, FRAGLAND_IP etc... at the beginning since those only store the IPs of the root servers we manage (it's easier for me to keep track of them that way).

'''How do you use this script?''' Copy / paste this script and save it as <code>hub.sh</code> or any other name you prefer. Then use <code>./hub.sh start</code> to start and <code>./hub.sh stop</code> to stop your hub. The script generates the server.cfg dynamically every time you start it. If you just want to generate server.cfg do <code>./hub.sh sim</code>.

Be aware that it's much better to actually do "quit" in the console of your hub instead of <code>./hub.sh stop</code> as this cleanly disconnects the hub from a game server. With <code>./hub.sh stop</code> the hub stays with ping 999 on the gameserver and needs to time out. Maybe we should ask Bani to improve POSIX signal interpretation of the ETTV binary :-).

<pre>#!/bin/bash

#################################################################
# #
# ettv delayed hub script #
# - #
# deej. #
# #
#################################################################
# #
# This script can be used to start up a delayed ETTV stream #
# where ETTV slaves connect to the hub to relay the signal. #
# #
# The daemon serves as a hub for other ETTV slaves to connect #
# to and as such alleviate the load on the game server hosting #
# the match. #
# #
# This script creates a subdirectory which represents the #
# date of the match and stores the demos in this subdir. #
# #
# The script generates etmain/server.cfg dynamically. #
# #
# The script launches the daemon in a different screen #
# which you can reattach with "screen -r hub". #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# Start Modifying From Here #
# #
#################################################################
#
# Parameters of the Game Server to Connect to
#
# IMPORTANT: Let the admin of the game server do
# "fdir *.pk3" in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Do NOT modify
MATCH_HOST="et.fragland.org:27965" # Match server port & address
MATCH_ETTV_PASS="[get_pass_from_admin]" # Match server ETTV password
MATCH_PASS="[get_pass_from_admin]" # Match server password

MATCH_HOME_TEAM="uQ" # Making our hostname more fancy ;-)
MATCH_AWAY_TEAM="Logitech"
MATCH_CUP="Warleagues"

#
# IPs & Ports For Your Host
#
HUB_IP="$PERONI_IP" # This host is Webperoni
HUB_PORT="30000" # Port of public hub for ETTV slaves

#
# Hostnames & ETTV Client name
#
# - hostname shows up in server browsers
# - ETTV client name shows up as the name
# of your server in the game server.
#
ETTV_CLIENT="^7reT^1!^7reD^1.^7ettv ^7hub ^1#^71"
HUB_HOSTNAME="$ETTV_CLIENT - ^3$MATCH_CUP^7: $MATCH_HOME_TEAM vs $MATCH_AWAY_TEAM"

#
# Passwords
#
HUB_RCON_PASS="[put_your_pass_here]"
HUB_PRIVATE_PASS="[put_your_pass_here]"
HUB_ETTV_PASS="[put_your_pass_here]"
HUB_PASS="[put_your_pass_here]"

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_hub" # Use absolute paths here!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1"
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400"

#
# Other relevant ETTV settings
#
HUB_DELAY="1" # Delay between live match & hub in seconds
HUB_SLAVES="8" # 1 ETTV slave connects at an UNLIMITED rate!
HUB_PRIVATE_SLOTS="0"

RECORD_GAME="1" # Record the game?

ALLOW_DL="0" # Slaves don't download from the hub
ALLOW_WWW_DL="0"
WWW_DL_URL="http://www.yoursite.com"

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path where
# all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying Here #
# #
#################################################################
#
# Make sure buffers are high enough!
#
echo "524288" > /proc/sys/net/core/rmem_max
echo "524288" > /proc/sys/net/core/wmem_max

#
# Assembling the Command Line
#
BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"
HOMEPATH="$BASEPATH/$MATCH_DATE"

HUB_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set net_ip $HUB_IP \
+set net_port $HUB_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $HOMEPATH \
+set com_hunkMegs 128 \
+set sv_maxclients $HUB_SLAVES \
+exec server.cfg"

#
# Functions
#

hub_start () {
#
# FYI'ing the user
#
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $HOMEPATH/etpro/demos/.\n"

echo -n "Starting Hub: "
screen -dmS hub su -m -c "$DAEMON $HUB_OPTIONS" - $USER
sleep 1
echo -e "done.\n"

echo -e "Getting PID...\n"

get_pids

echo -n "Hub has PID "
echo -e "$HUB_PID\n"

echo "ETTV slaves can now connect to your box by issuing:"
echo -e "tv connect $HUB_IP:$HUB_PORT $HUB_ETTV_PASS $HUB_PASS\n"
}

hub_stop () {
#
# Refresh the PIDs
#
get_pids

echo -n "Shutting Down Hub: "
sleep 1
if [ -n $HUB_PID ]
then
kill -SIGTERM $HUB_PID
echo -e "done."
else
echo -e "failed.\nHub wasn't active anymore.\n"
fi

sleep 1
}

create_config (){
#
# Generate etmain/server.cfg
#
TIMESTAMP=`date +"%d/%m/%Y %H:%M:%S"`

echo "//" > $BASEPATH/etmain/server.cfg
echo "// server.cfg generated $TIMESTAMP" >> $BASEPATH/etmain/server.cfg
echo -e "//\n" >> $BASEPATH/etmain/server.cfg

echo "set sv_privateclients $HUB_PRIVATE_SLOTS" >> $BASEPATH/etmain/server.cfg
echo "set sv_maxRate 25000" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_hostname \"$HUB_HOSTNAME\"\n" >> $BASEPATH/etmain/server.cfg

echo "set g_password \"$HUB_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set rconpassword \"$HUB_RCON_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_privatepassword \"$HUB_PRIVATE_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_allowDownload $ALLOW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwDownload $ALLOW_WWW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwBaseURL \"$WWW_DL_URL\"" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_wwwDlDisconnected 0\n" >> $BASEPATH/etmain/server.cfg

echo "set b_ettv_flags 3" >> $BASEPATH/etmain/server.cfg
echo "set ettv_delay $HUB_DELAY" >> $BASEPATH/etmain/server.cfg
echo "set ettv_autorecord $RECORD_GAME" >> $BASEPATH/etmain/server.cfg
echo "set ettv_clientname \"$ETTV_CLIENT\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_maxslaves \"$HUB_ETTV_SLAVES\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_password \"$HUB_ETTV_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_netblast $ETTV_NETBLAST" >> $BASEPATH/etmain/server.cfg
echo "set ettv_tv_iptos $ETTV_TV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_iptos $ETTV_SV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo -e "set ettv_mtu $ETTV_MTU\n" >> $BASEPATH/etmain/server.cfg

echo "set b_crashlogpath \"$BASEPATH/etpro\"" >> $BASEPATH/etmain/server.cfg
echo "set g_log \"slave.log\"" >> $BASEPATH/etmain/server.cfg
echo -e "set logfile 2\n" >> $BASEPATH/etmain/server.cfg

echo "tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS" >> $BASEPATH/etmain/server.cfg
}

get_pids (){
#
# We used to launch the same binary twice so pidof didn't work.
# As from beta 8 ettv delayed feeds were automatic so
# no more fancy scripting tricks are required :-)
#
HUB_PID=`pidof $DAEMON`
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

#
# Performing The magic :-)
#

case "$1" in
start)
create_config
hub_start
;;
stop)
hub_stop
clean_up
;;
sim)
create_config
echo -e "\nFollowing config was generated automatically:\n"
cat $BASEPATH/etmain/server.cfg
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop|sim}"
exit 1
;;
esac
exit 0
</pre>

=== Slave script ===

This script connects a delayed or undelayed slave to a Hub or directly to a gameserver. The usage of this script is very similar to the Hub script. Copy / paste it and save it as <code>slave.sh</code> or any other name you prefer. Then issue <code>./slave.sh start</code> to start your slave and <code>./slave.sh stop</code> to stop it. Use <code>./slave.sh sim</code> to only create etmain/server.cfg. Like above, it is actually better to do quit in the console instead of just killing the slave with this script.

<pre>#!/bin/bash

#################################################################
# #
# ETTV slave script #
# - #
# deej. #
# #
#################################################################
# #
# This script can be used to start up an ETTV slave to connect #
# to an ETTV HUB or directly to a game server. #
# #
# The script generates etmain/server.cfg dynamically. #
# #
# This script launches the daemon in a different screen which #
# you can reattach with "screen -r slave" #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# #
# Questions? deej@fragland.org or go to #gamestv.org #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# Start Modifying From Here #
# #
#################################################################
#
# Hub Info
#
# IMPORTANT: Let the admin of the hub do a
# fdir *.pk3 in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Do NOT modify
MATCH_HOST="et.fragland.org:27965" # HUB / Match server port & address
MATCH_ETTV_PASS="[get_pass_from_admin]" # HUB / Match server ETTV password
MATCH_PASS="[get_pass_from_admin]" # HUB / Match server password

MATCH_HOME_TEAM="uQ" # Making our hostname more fancy ;-)
MATCH_AWAY_TEAM="Logitech"
MATCH_CUP="Warleagues"

#
# Slave Info
#
SLAVE_IP="$PERONI_IP" # This host is Peroni
SLAVE_PORT="27960" # port of public broadcaster

ETTV_CLIENT="^7reT^1!^7reD^1.^7ettv ^1#^71" # shows up on the Hub
SLAVE_HOSTNAME="$ETTV_CLIENT - ^3$MATCH_CUP^7: $MATCH_HOME_TEAM vs $MATCH_AWAY_TEAM"

SLAVE_SLOTS="100"
SLAVE_PASS="[put_your_pass_here]"

SLAVE_PRIVATE_SLOTS="20"
SLAVE_PRIVATE_PASS="[put_your_pass_here]"

SLAVE_ETTV_SLAVES="5" # Allow chaining?
SLAVE_ETTV_PASS="[put_your_pass_here]"

SLAVE_RCON_PASS="[put_your_pass_here]"

RECORD_GAME="1" # 1 = record game, 0 = don't
SLAVE_DELAY="60" # Time in seconds

REDIRECT="Server is full" # Message displayed when server is full
#REDIRECT="ET://ettv2.fragland.org:27960" # Allows redirecting to other ettv's

#
# Downloading
#
ALLOW_DL="1" # Can clients download stuff?
ALLOW_WWW_DL="1" # Allow downloading over http?
WWW_DL_URL="http://www.yoursite.com" # No "/" at the end!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1"
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400"

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_slave" # Path to ettv.x86
# Use absolute paths here!

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path where
# all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying Here #
# #
#################################################################
#
# Make sure buffers are ok!
#
echo "524288" > /proc/sys/net/core/rmem_max
echo "524288" > /proc/sys/net/core/wmem_max

#
# Assembling the Command Line
#
BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"
HOMEPATH="$BASEPATH/$MATCH_DATE"

SLAVE_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set com_hunkMegs 256 \
+set net_ip $SLAVE_IP \
+set net_port $SLAVE_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $HOMEPATH \
+set sv_maxclients $SLAVE_SLOTS \
+exec server.cfg"

#
# Functions
#

slave_start (){
#
# FYI the user
#
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $HOMEPATH/etpro/demos/.\n"

#
# Start the slave
#
echo -n "Starting Slave: "

screen -dmS slave su -m -c "$DAEMON $SLAVE_OPTIONS" - $USER

echo -e "done.\n"

echo -e "Getting PID...\n"
sleep 1

SLAVE_PID=`pidof $DAEMON`

echo -n "Slave has PID "
echo -e "$SLAVE_PID.\n"

if [ $SLAVE_ETTV_SLAVES != 0 ]
then
echo "ETTV slaves can now connect to your box by issuing:"
echo -e "tv connect $SLAVE_IP:$SLAVE_PORT $SLAVE_ETTV_PASS $SLAVE_PASS\n"
fi
}

slave_stop (){
#
# Refresh the PID
#
SLAVE_PID=`pidof $DAEMON`

echo -n "Shutting Down Slave: "
sleep 1
if [ $SLAVE_PID ]
then
kill -SIGTERM $SLAVE_PID
echo -e "done."
else
echo -e "failed.\nSlave wasn't active anymore.\n"
fi
}

create_config (){
#
# Generate etmain/server.cfg
#
TIMESTAMP=`date +"%d/%m/%Y %H:%M:%S"`

echo "//" > $BASEPATH/etmain/server.cfg
echo "// server.cfg generated $TIMESTAMP" >> $BASEPATH/etmain/server.cfg
echo -e "//\n" >> $BASEPATH/etmain/server.cfg

echo "set sv_privateclients $SLAVE_PRIVATE_SLOTS" >> $BASEPATH/etmain/server.cfg
echo "set sv_maxRate 25000" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_hostname \"$SLAVE_HOSTNAME\"\n" >> $BASEPATH/etmain/server.cfg

echo "set g_password \"$SLAVE_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set rconpassword \"$SLAVE_RCON_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_privatepassword \"$SLAVE_PRIVATE_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_allowDownload $ALLOW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwDownload $ALLOW_WWW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwBaseURL \"$WWW_DL_URL\"" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_wwwDlDisconnected 0\n" >> $BASEPATH/etmain/server.cfg

echo "set b_ettv_flags 3" >> $BASEPATH/etmain/server.cfg
echo "set ettv_delay $SLAVE_DELAY" >> $BASEPATH/etmain/server.cfg
echo "set ettv_autorecord $RECORD_GAME" >> $BASEPATH/etmain/server.cfg
echo "set ettv_clientname \"$ETTV_CLIENT\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_maxslaves \"$SLAVE_ETTV_SLAVES\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_password \"$SLAVE_ETTV_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_netblast $ETTV_NETBLAST" >> $BASEPATH/etmain/server.cfg
echo "set ettv_tv_iptos $ETTV_TV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_iptos $ETTV_SV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo -e "set ettv_mtu $ETTV_MTU\n" >> $BASEPATH/etmain/server.cfg

echo "set b_crashlogpath \"$BASEPATH/etpro\"" >> $BASEPATH/etmain/server.cfg
echo "set g_log \"slave.log\"" >> $BASEPATH/etmain/server.cfg
echo -e "set logfile 2\n" >> $BASEPATH/etmain/server.cfg

echo "tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS" >> $BASEPATH/etmain/server.cfg
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

#
# Performing The magic :-)
#

case "$1" in
start)
create_config
slave_start
;;
stop)
slave_stop
clean_up
;;
restart)
$0 stop
sleep 1
$0 start
;;
sim)
create_config
echo -e "\nFollowing config was generated automatically:\n"
cat $BASEPATH/etmain/server.cfg
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop|restart|sim}"
exit 1
;;
esac
exit 0
</pre>

=== Old school record / playback script ===

This is a script to broadcast a game the old-fashioned way. It records a demo and starts playing it back after roughly 60 seconds. There's some symbolic linking stuff done inside to make sure it stores all the logs, otherwise the 'broadcaster' would override the recorder's log, ''which makes broadcasting very hard to debug'' :-)!

Copy / paste this script and save it as <code>broadcast.sh</code> or any other name you prefer. The usual comments on quit and 999 are applicable here as well. This script "should" work with ETTV earlier then b8. However, YMMV.

<pre>#!/bin/bash

#################################################################
# #
# reT!reD.ettv delayed broadcast script #
# - #
# reT!reD.deej #
# #
#################################################################
# #
# This script can be used to start up a delayed ETTV stream #
# where viewers connect directly to the broadcaster. #
# #
# This script creates a subdirectory which represents the #
# date of the match and stores the demos in this subdir. #
# #
# The script launches the daemons in different screens #
# which you can reattach with "screen -r recorder" #
# or "screen -r broadcaster". #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################
# #
# http://www.fragland.org #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# WServer2.ath.cx IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv.fragland.org
KLEIN_IP="83.243.82.88"

#################################################################
# #
# START Modifying #
# #
#################################################################
#
# Parameters of the Game Server to Connect to
#
# IMPORTANT: Let the admin of the game server do a
# fdir *.pk3 in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Do NOT modify
MATCH_HOST="et.fragland.org:27970" # Match server port & address
MATCH_ETTV_PASS="[put_your_pass_here]" # Match server ETTV password
MATCH_PASS="[put_your_pass_here]" # Match server password

#
# Match info for setting hostname & storing demos
#
MATCH_HOME_TEAM="NED"
MATCH_AWAY_TEAM="BEL"
MATCH_CUP="NationsCup"

#
# IPs & Ports For Your Host
#
THISHOST_IP="$KLEIN_IP" # Select from list above
RECORDER_PORT="29995" # Port of the private recorder
SLAVE_PORT="27960" # Port of the public broadcaster

#
# Hostnames & ETTV Client name
#
# - hostname shows up in server browsers
# - ETTV client name shows up as the name
# of your server in the game server.
#
RECORDER_HOSTNAME="^7reT^1!^7reD^1.^7ettv ^7recorder ^1#^71"
ETTV_CLIENT="^7reT^1!^7reD^1.^7ettv ^1#^71"
SLAVE_HOSTNAME="$ETTV_CLIENT - ^3$MATCH_CUP^7: $MATCH_HOME_TEAM vs $MATCH_AWAY_TEAM"

#
# Passwords
#
RECORDER_RCON_PASS="[put_your_pass_here]"
RECORDER_PASS="[put_your_pass_here]"
SLAVE_RCON_PASS="[put_your_pass_here]"
SLAVE_PRIVATE_PASS="[put_your_pass_here]"
SLAVE_ETTV_PASS="[put_your_pass_here]"
SLAVE_PASS="[put_your_pass_here]" # /rcon g_password "" to clear

#
# Other relevant settings
#
SLAVE_DELAY="60" # Delay between live match &
# broadcaster in seconds

SLAVE_SLOTS="100"
SLAVE_PRIVATE_SLOTS="25"
SLAVE_ETTV_SLAVES="0" # Allow chaining?

REDIRECT="Server is full" # Message displayed when server is full
#REDIRECT="ET://ettv2.fragland.org:27960"

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1"
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400"

#
# Download settings
#
ALLOW_DL="1"
ALLOW_WWW_DL="1" # Allow downloading over http?
WWW_DL_URL="http://wwww.fragland.org/maps"

#
# Directories
#
BASEPATH="/srv/et/ETTV" # Use absolute paths here!
RECORDER_BASEPATH="$BASEPATH/ettv_recorder"
SLAVE_BASEPATH="$BASEPATH/ettv_slave"

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path where
# all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying #
# #
#################################################################
#
# Make sure buffers are ok!
#
echo "262144" > /proc/sys/net/core/rmem_max
echo "262144" > /proc/sys/net/core/wmem_max

#
# Assembling the Command Line
#
MATCH=""$MATCH_HOME_TEAM"vs"$MATCH_AWAY_TEAM""
HOMEPATH="$BASEPATH/$MATCH"

BINARY="ettv.x86"
RECORDER_DAEMON="$RECORDER_BASEPATH/$BINARY"
SLAVE_DAEMON="$SLAVE_BASEPATH/$BINARY"

RECORDER_OPTIONS="\
+set fs_game etpro \
+set dedicated 1 \
+set net_ip $THISHOST_IP \
+set net_port $RECORDER_PORT \
+set fs_basepath $RECORDER_BASEPATH \
+set fs_homepath $HOMEPATH \
+set com_hunkMegs 128 \
+exec recorder.cfg"

SLAVE_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set net_ip $THISHOST_IP \
+set net_port $SLAVE_PORT \
+set fs_basepath $SLAVE_BASEPATH \
+set fs_homepath $HOMEPATH \
+set sv_maxclients $SLAVE_SLOTS \
+set com_hunkMegs 160 \
+exec slave.cfg"

#
# Only add for ETTV b8 & up
#
#+set ettv_mtu $ETTV_MTU \

#
# Functions
#

broadcast_start (){
#
# FYI'ing the user
#
echo -e "\n"
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $HOMEPATH/etpro/demos/.\n"

echo -n "Starting Recorder: "
screen -dmS recorder su -m -c "$RECORDER_DAEMON $RECORDER_OPTIONS" - $USER
echo "done."

echo "Sleeping for $SLAVE_DELAY seconds."
sleep $SLAVE_DELAY

echo -n "Starting Broadcaster: "
screen -dmS slave su -m -c "$SLAVE_DAEMON $SLAVE_OPTIONS" - $USER
echo -e "done.\n"

echo -e "Getting PIDs...\n"
sleep 1

get_pids

echo -n "Recorder has PID "
echo $RECORDER_PID
renice -8 $RECORDER_PID
echo -n "Broadcaster has PID "
echo -e "$SLAVE_PID\n"
renice -7 $SLAVE_PID
}

broadcast_stop (){

get_pids

echo -n "Shutting Down Slave: "
sleep 1
if [ $SLAVE_PID ]
then
kill -SIGTERM $SLAVE_PID
echo -e "done."
else
echo -e "failed.\nSlave wasn't active anymore.\n"
fi

echo -n "Shutting Down Recorder: "
sleep 1
if [ $RECORDER_PID ]
then
kill -SIGTERM $RECORDER_PID
echo -e "done."
else
echo -e "failed.\nRecorder wasn't active anymore.\n"
fi

sleep 1
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH
ls -l $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l $BASEPATH/$MATCH/etpro/demos/
;;
esac
}

create_recorder_config (){
#
# Generate etmain/recorder.cfg
#
TIMESTAMP=`date +"%d/%m/%Y %H:%M:%S"`
RECORDER_CFG="$RECORDER_BASEPATH/etmain/recorder.cfg"

echo "//" > $RECORDER_CFG
echo "// config generated $TIMESTAMP" >> $RECORDER_CFG
echo -e "//\n" >> $RECORDER_CFG

echo "set sv_maxclients 2" >> $RECORDER_CFG
echo "set sv_privateclients 0" >> $RECORDER_CFG
echo "set sv_maxRate 25000" >> $RECORDER_CFG
echo -e "set sv_hostname \"$RECORDER_HOSTNAME\"\n" >> $RECORDER_CFG

echo "set g_password \"$RECORDER_PASS\"" >> $RECORDER_CFG
echo "set rconpassword \"$RECORDER_RCON_PASS\"" >> $RECORDER_CFG
echo -e "set sv_allowDownload 0\n" >> $RECORDER_CFG

echo "set ettv_delay 1" >> $RECORDER_CFG
echo "set ettv_autorecord 1" >> $RECORDER_CFG
echo "set ettv_clientname \"$ETTV_CLIENT\"" >> $RECORDER_CFG
echo "set ettv_sv_maxslaves 0" >> $RECORDER_CFG
echo "set ettv_netblast $ETTV_NETBLAST" >> $RECORDER_CFG
echo "set ettv_tv_iptos $ETTV_TV_IPTOS" >> $RECORDER_CFG
echo -e "set ettv_sv_iptos $ETTV_SV_IPTOS\n" >> $RECORDER_CFG

echo "set b_crashlogpath \"$RECORDER_BASEPATH/etpro\"" >> $RECORDER_CFG
echo "set g_log \"recorder.log\"" >> $RECORDER_CFG
echo -e "set logfile 2\n" >> $RECORDER_CFG

echo "tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS" >> $RECORDER_CFG
}

create_slave_config (){
#
# Generate etmain/slave.cfg
#
TIMESTAMP=`date +"%d/%m/%Y %H:%M:%S"`
SLAVE_CFG="$SLAVE_BASEPATH/etmain/slave.cfg"

echo "//" > $SLAVE_CFG
echo "// config generated $TIMESTAMP" >> $SLAVE_CFG
echo -e "//\n" >> $SLAVE_CFG

echo "set sv_maxclients $SLAVE_SLOTS" >> $SLAVE_CFG
echo "set sv_privateclients $SLAVE_PRIVATE_SLOTS" >> $SLAVE_CFG
echo "set sv_maxRate 25000" >> $SLAVE_CFG
echo -e "set sv_hostname \"$SLAVE_HOSTNAME\"\n" >> $SLAVE_CFG

echo "set g_password \"$SLAVE_PASS\"" >> $SLAVE_CFG
echo "set rconpassword \"$SLAVE_RCON_PASS\"" >> $SLAVE_CFG
echo "set sv_privatepassword \"$SLAVE_PRIVATE_PASS\"" >> $SLAVE_CFG
echo "set sv_allowDownload $ALLOW_DL" >> $SLAVE_CFG
echo "set sv_wwwDownload $ALLOW_WWW_DL" >> $SLAVE_CFG
echo "set sv_wwwBaseURL \"$WWW_DL_URL\"" >> $SLAVE_CFG
echo -e "set sv_wwwDlDisconnected 0\n" >> $SLAVE_CFG

echo "set b_ettv_flags 3" >> $SLAVE_CFG
echo "set ettv_delay 0" >> $SLAVE_CFG
echo "set ettv_autorecord 0" >> $SLAVE_CFG
echo "set ettv_clientname \"$ETTV_CLIENT\"" >> $SLAVE_CFG
echo "set ettv_sv_maxslaves \"$SLAVE_ETTV_SLAVES\"" >> $SLAVE_CFG
echo "set ettv_password \"$SLAVE_ETTV_PASS\"" >> $SLAVE_CFG
echo "set ettv_netblast $ETTV_NETBLAST" >> $SLAVE_CFG
echo "set ettv_tv_iptos $ETTV_TV_IPTOS" >> $SLAVE_CFG
echo -e "set ettv_sv_iptos $ETTV_SV_IPTOS\n" >> $SLAVE_CFG

echo "set b_crashlogpath \"$SLAVE_BASEPATH/etpro\"" >> $SLAVE_CFG
echo "set g_log \"slave.log\"" >> $SLAVE_CFG
echo -e "set logfile 2\n" >> $SLAVE_CFG

echo "demo demo0000" >> $SLAVE_CFG
}

get_pids (){
#
# Since we want to run multiple casts in parallel we launch the same
# binary twice or more. pidof then doesn't work so we have to recreate
# the human behaviour of looking for the PID.
#
RECORDER_PID=`ps aux|grep "+set net_port $RECORDER_PORT"|grep -v "su -m -c"|grep -v "SCREEN -dmS"|grep -v grep|awk '{ print $2 }'`
SLAVE_PID=`ps aux|grep "+set net_port $SLAVE_PORT"|grep -v "su -m -c"|grep -v "SCREEN -dmS"|grep -v grep|awk '{ print $2 }'`

}

#
# Performing The magic :-)
#

case "$1" in
start)
create_recorder_config
create_slave_config
broadcast_start
;;
stop)
broadcast_stop
clean_up
;;
sim)
create_recorder_config
create_slave_config
echo -e "\nFollowing configs were generated automatically:\n"
cat $RECORDER_CFG | more
cat $SLAVE_CFG | more
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop|sim}"
exit 1
;;
esac
exit 0
</pre>

=== Sanitization script ===

This is a script to restore an ETTV directory to the bare minimum required to broadcast matches or be a hub. It isn't a very advanced script but it gets the job done. Copy / paste this script and save it as <code>sanitize.sh</code> or any other name you prefer. Just do <code>./sanitize.sh</code> do delete all files in etmain & etpro that are not needed anymore.

''Note'': this script deletes '''everything''' it finds in the etmain and etpro directories. If you have stuff that you do not want to delete in there, add it to the ETMAIN_FILES & ETPRO_FILES arrays.

<pre>#!/bin/bash

#################################################################
# #
# ettv clean-up script #
# - #
# deej. #
# #
#################################################################
# #
# This script is used to restore an ETTV directory to the bare #
# minimum in terms of files. #
# #
# Use it to clean up after an ETTV session so you can start the #
# next session with a minimum of PK3s. #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################

ETMAIN_FILES=(\
"description.txt" \
"hunkusage.dat" \
"mp_bin.pk3" \
"pak0.pk3" \
"pak1.pk3" \
"pak2.pk3" \
"et_ice.pk3" \
"braundorf_b4.pk3" \
"supplydepot2.pk3" \
"sw_goldrush_te.pk3" \
"sw_oasis_b3.pk3")

ETPRO_FILES=(\
"etpro-3_2_4.pk3" \
"etpro_cheats.dat" \
"qagame.mp.i386.so" \
"tvgame.mp.i386.so")

SCRIPT_NAME=`basename $0`

case $1 in
hub)
BASEPATH="/srv/et/ETTV/ettv_hub"
;;
slave)
BASEPATH="/srv/et/ETTV/ettv_slave"
;;
*)
echo -e "\nError: $1 is not a valid installation target."
echo -e "Usage: $SCRIPT_NAME {hub|slave}\n"
exit 1
esac

#
# Test for existence of backup directories
#
if [ ! -d "$BASEPATH/etmain/bak/" ]; then
mkdir "$BASEPATH/etmain/bak"
fi

if [ ! -d "$BASEPATH/etpro/bak/" ]; then
mkdir "$BASEPATH/etpro/bak"
fi

#
# Clear etmain
#
for i in ${ETMAIN_FILES[@]}
do
mv "$BASEPATH/etmain/$i" "$BASEPATH/etmain/bak/"
done
rm $BASEPATH/etmain/*

#
# Clear etpro
#
for i in ${ETPRO_FILES[@]}
do
mv "$BASEPATH/etpro/$i" "$BASEPATH/etpro/bak/"
done
rm $BASEPATH/etpro/*

#
# Restore etmain
#
for i in ${ETMAIN_FILES[@]}
do
mv "$BASEPATH/etmain/bak/$i" "$BASEPATH/etmain/"
done

#
# Restore etpro
#
for i in ${ETPRO_FILES[@]}
do
mv "$BASEPATH/etpro/bak/$i" "$BASEPATH/etpro/"
done

#
# Clean the backup directories
#
rm -Rf $BASEPATH/etmain/bak
rm -Rf $BASEPATH/etpro/bak
</pre>

=== Switching beta's script ===

This script allows you to quickly switch between the different beta's Bani has released. Just save it as <code>switchbeta.sh</code> and adapt the directory fields to your setup. Usage example: <code>./switchbeta.sh 9 hub</code> switches the hub to beta 9. <code>./switchbeta.sh 4 all</code> switches hub & slave (or others you can define of course) back to beta 4.

<pre>#!/bin/bash

#################################################################
# #
# switching ettv betas script #
# - #
# deej. #
# #
#################################################################
# #
# This script allows you to easily switch ETTV beta versions. #
# #
# Just put the ettv-beta[x].zip files in directory $REPODIR, #
# adapt settings for hub & slave and start switching! #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################

#
# Paths & files
#
REPODIR="/srv/et" # Where the ettv-betaX.zip files reside
HUB_DIR="/srv/et/ETTV/ettv_hub"
SLAVE_DIR="/srv/et/ETTV/ettv_slave"

#
# Argument check
#
SCRIPT_NAME=`basename $0`
ARGS=2
E_BADARGS=65

if [ $# -lt "$ARGS" ]
then
echo -e "\nError: missing arguments"
echo -e "Usage: $SCRIPT_NAME {beta number} {hub|slave|broadcast|all}\n"
exit $E_BADARGS
fi

FILENAME="ettv-beta$1.zip"

if [ ! -e "$REPODIR/$FILENAME" ]
then
echo -e "\nError: beta version $1 is not present in $REPODIR."
echo -e "Usage: $SCRIPT_NAME {beta number} {hub|slave|all}\n"
exit $E_BADARGS
fi

case $2 in
hub)
unzip -o "$REPODIR/$FILENAME" -d "$HUB_DIR" ettv.x86
chmod +x "$HUB_DIR/ettv.x86"
unzip -o "$REPODIR/$FILENAME" -d "$HUB_DIR/etpro" tvgame.mp.i386.so
;;
slave)
unzip -o "$REPODIR/$FILENAME" -d "$SLAVE_DIR" ettv.x86
chmod +x "$SLAVE_DIR/ettv.x86"
unzip -o "$REPODIR/$FILENAME" -d "$SLAVE_DIR/etpro" tvgame.mp.i386.so
;;
all)
$0 $1 hub
$0 $1 slave
;;
*)
echo -e "\nError: $2 is not a valid installation target."
echo -e "Usage: $SCRIPT_NAME {beta number} {hub|slave|all}\n"
exit $E_BADARGS
esac
exit 0
</pre>

Have fun broadcasting!

[[User:Deej|deej]] 01:46, 3 January 2006 (PST)

[[Category:ETTV]]

WolfWiki:Community Portal

2006-03-07T22:31:40Z

Deej: /* News Sites */

== News Sites ==

* [http://www.et-center.com/ ET-Center]
* [http://www.xfire.be/ Xfire.be]
* [http://www.gamestv.org/ GamesTV.org]
* [http://www.swertcw.com/ sweRTCW]
* [http://www.planetwolfenstein.com/ Planet Wolfenstein]
* [http://www.etnation.co.uk/ ETNation.co.uk]
* [http://www.splashdamage.com/ SplashDamage.com]
* [http://www.planetwolfenstein.de/ PlanetWolfenstein.de]
* [http://www.rtcw.co.uk/ rtcw.co.uk]
* [http://velocity.lunarpages.com/index.html Unofficial Enemy Territory Strategy Guide]
* [http://www.planetwolfenstein.com/4newbies/ RTCW 4 Newbies]
* [http://www.enemy-territory.com Enemy Territory Resource Site]
* [http://www.geheimgemein.de/kallisti/ Kallisti.et Enemy Territory Fun Community]
* [http://www.et-scene.de/news.php ET-Scene.de (German)]

== Leagues / Competitions ==

* [http://www.clanbase.com/ Clanbase]
* [http://www.teamwarfare.com/ TeamWarfare League]
* [http://www.sta-league.org/ Stronger Than All]
* [http://www.et-cup.net/ ET-Cup]
* [http://www.warleagues.com/ Warleagues]
* [http://www.frenchy-cup.com/ Frenchy-Cup european]
* [http://et-gather.be/ #et.gather Fast Gaming Cup]

== Mods ==

* [http://stealthy.foolishgames.net/ FalckonET]
* [http://www.truecombat.com/intro.php TC:Elite]
* [http://www.omni-bot.com/ Omni-Bot]
* [http://www.priceofpeace.net/ The Price of Peace]
* [http://www.etpub.org/news.php ETPub]
* [http://jaymod.clanfu.org/ Jaymod]
* [http://www.splashdamage.com/index.php?name=pnPHPbb2&file=viewtopic&t=7522 ET-Mod-Project-List]

WolfWiki:Community Portal

2006-03-07T22:30:05Z

Deej: Fast gaming Cup added

== News Sites ==

* [http://www.et-center.com/ ET-Center]
* [http://www.xfire.be/ Xfire.be]
* [http://www.gamestv.org/ GamesTV.org]
* [http://www.swertcw.com/ sweRTCW]
* [http://www.planetwolfenstein.com/ Planet Wolfenstein]
* [http://www.etnation.co.uk/ ETNation.co.uk]
* [http://www.splashdamage.com/ SplashDamage.com]
* [http://www.planetwolfenstein.de/ PlanetWolfenstein.de]
* [http://www.rtcw.co.uk/ rtcw.co.uk]
* [http://velocity.lunarpages.com/index.html Unofficial Enemy Territory Strategy Guide]
* [http://www.planetwolfenstein.com/4newbies/ RTCW 4 Newbies]
* [http://www.enemy-territory.com Enemy Territory Resource Site]
* [http://www.geheimgemein.de/kallisti/ Kallisti.et Enemy Territory Fun Community]

== Leagues / Competitions ==

* [http://www.clanbase.com/ Clanbase]
* [http://www.teamwarfare.com/ TeamWarfare League]
* [http://www.sta-league.org/ Stronger Than All]
* [http://www.et-cup.net/ ET-Cup]
* [http://www.warleagues.com/ Warleagues]
* [http://www.frenchy-cup.com/ Frenchy-Cup european]
* [http://et-gather.be/ #et.gather Fast Gaming Cup]

== Mods ==

* [http://stealthy.foolishgames.net/ FalckonET]
* [http://www.truecombat.com/intro.php TC:Elite]
* [http://www.omni-bot.com/ Omni-Bot]
* [http://www.priceofpeace.net/ The Price of Peace]
* [http://www.etpub.org/news.php ETPub]
* [http://jaymod.clanfu.org/ Jaymod]
* [http://www.splashdamage.com/index.php?name=pnPHPbb2&file=viewtopic&t=7522 ET-Mod-Project-List]

WolfWiki:Community Portal

2006-03-07T21:27:17Z

Deej: Added Kallisti.et

== News Sites ==

* [http://www.et-center.com/ ET-Center]
* [http://www.xfire.be/ Xfire.be]
* [http://www.gamestv.org/ GamesTV.org]
* [http://www.swertcw.com/ sweRTCW]
* [http://www.planetwolfenstein.com/ Planet Wolfenstein]
* [http://www.etnation.co.uk/ ETNation.co.uk]
* [http://www.splashdamage.com/ SplashDamage.com]
* [http://www.planetwolfenstein.de/ PlanetWolfenstein.de]
* [http://www.rtcw.co.uk/ rtcw.co.uk]
* [http://velocity.lunarpages.com/index.html Unofficial Enemy Territory Strategy Guide]
* [http://www.planetwolfenstein.com/4newbies/ RTCW 4 Newbies]
* [http://www.enemy-territory.com Enemy Territory Resource Site]
* [http://www.geheimgemein.de/kallisti/ Kallisti.et Enemy Territory Fun Community]

== Leagues / Competitions ==

* [http://www.clanbase.com/ Clanbase]
* [http://www.teamwarfare.com/ TeamWarfare League]
* [http://www.sta-league.org/ Stronger Than All]
* [http://www.et-cup.net/ ET-Cup]
* [http://www.warleagues.com/ Warleagues]
* [http://www.frenchy-cup.com/ Frenchy-Cup european]

== Mods ==

* [http://stealthy.foolishgames.net/ FalckonET]
* [http://www.truecombat.com/intro.php TC:Elite]
* [http://www.omni-bot.com/ Omni-Bot]
* [http://www.priceofpeace.net/ The Price of Peace]
* [http://www.etpub.org/news.php ETPub]
* [http://jaymod.clanfu.org/ Jaymod]
* [http://www.splashdamage.com/index.php?name=pnPHPbb2&file=viewtopic&t=7522 ET-Mod-Project-List]

ETTV:Server Configuration

2006-02-07T16:11:00Z

Deej: ettv flags is default 3

<dot_graph>
digraph ettv {
master -> slave1
master -> slave2
slave1 -> "client1.."
slave1 -> "..client50"
slave2 -> "client51.."
slave2 -> "..client100"
slave1 -> "chained_slave1"
chained_slave1 -> "client101"
chained_slave1 -> "...client150"
}
</dot_graph>

==Installation - "Master" (gameserver)==

Copy ettv.x86 to the same directory your etded.x86 is located.
Start your gameserver as normal, but run ettv.x86 instead of etded.x86.

===Set some cvars===

'''ettv_sv_maxslaves''' (default 0, no slave connections allowed)
:Number of ettv slaves allowed to connect.
:''Note:'' Slave slots are always reserved, like private slots.
'''ettv_password''' (default "", no slave connections allowed)
:Password for ettv slaves.
:Must be set, or no slaves will be able to connect!
'''b_ettv_flags''' (default 3)
:1 = prevent slaves from being callvote kicked
:2 = grant shoutcaster status to slaves
:values can be added together, eg 3 for both features.

===Playing on the master===
Players may now connect to your gameserver as normal.

==Installation - "Slave" (broadcast server)==

Copy ettv.x86 to the same directory your etded.x86 is located.
Copy tvgame.mp.i386.so to the same directory as your etpro/qagame.mp.i386.so is located.

===Set some cvars===
'''sv_maxclients'''
:Number of spectator clients to allow. This number is only limited by available cpu and memory.
:Some guidelines when provisioning a broadcast server:
:*100 spectator slots will require ~ 128mb ram. Use com_hunkmegs to set this.
:*100 spectator slots will require ~ 768kbyte/sec (6mbits), roughly 6kbyte/sec per client
:*100 spectator slots will take ~ 80% cpu of a Xeon 2.2ghz
:*Each slave will require ~20-40kbyte/sec from the master.

'''ettv_clientname''' (default "ETTV")
:Playername the slave will use when connecting to the master, eg "ETTV-xyz"

'''ettv_delay''' (default 0, disabled)
:number of seconds for slave to delay the master feed. Recording/playback chains should no longer be needed, and slaves should always maintain an exact delay from the master server.
:''note'': this should ONLY be set on the slave.
:''note'': only supported in ettv beta8 and later

===Chat passwords===
In order to curb the rampant abuse of ettv chat, admins may set "chat passwords" on their servers. If enabled, viewers are not allowed to chat unless they have a password. You can define as many passwords as you like, so you can easily track down individual abusers and limit the damage of stolen passwords.

'''ettv_chatpasswords''' (default 0, disabled)
:number of chat passwords defined.
'''ettv_chatpassword'''(1-99999)
:individual chat passwords.

viewers use <tt>/chatpassword <password></tt> to login.

if logged in, ettv chats will be tagged with a number in parentheses identifying which chat password the viewer is using.
===Misc commands for viewers===
;For ettv beta 4 and above
* spectators may <tt>/ignore</tt> and <tt>/unignore</tt> other spectators
* semiadmin functionality now works for slaves
* rcon may now mute/unmute specs

===Connect the slave===
Now start your slave server by running ettv.x86

Tell the slave server to connect up to the master server:
:<tt>tv connect master.ip.address:port ettv_password(required) g_password(if the master has a g_password set)</tt>

If you have configured everything correctly, the slave should connect to the master.
Clients should now be able to connect to the slave and spectate the game in progress.

This is a "live broadcast" with no delay.

===Disconnect the slave===
To tell the slave to disconnect from the master:
:<tt>tv disconnect</tt>

===Slave Chaining===

==== What is chaining and why chain slaves? ====

ETTV allows chaining slaves together. This very neat feature lets you connect one ETTV slave to another ETTV slave that is broadcasting a match instead of directly to the game server hosting the match. Apart from the "w00t this is very cool" factor, why is this feature so important for admins? Basicly, working in a chained model allows to broadcast a match to a large number of spectators without too much hastle and too many risks for the master server.

Chaining was developped for a simple reason: if you take into account that one ETTV slave connects at an '''unlimited''' rate to a master, you really don't want to connect 15 or 20 slaves to a game server to broadcast let's say the ''Atlantic Battle''. Chances are you will bring down the master game server and thus the game. Chaining slaves firmly alleviates the load on the master game server. 2 or 4 of these ''Hubs'' can do the job of delaying the signal and feeding it to other slaves.

Other benefits might include better network performance. If you can choose to either connect your slave to the game server where your connection is not optimal or to a nearby slave who is on a better connection to the master, it might help the quality of your broadcast. Plus you don't need to record anything when connecting to a delayed slave.

==== Setting up your slave to allow connections from other slaves ====

This part is actually pretty easy. You need to set up your slave as if you were setting up a master game server. This means that, next to the normal slave parameters, you have to set up the following:

* '''b_ettv_flags''': set this to at least 1
* '''ettv_sv_maxslaves''': set this to at least 1. Depending on how powerful your machine is you can set this number higher. Don't set it too high though, a slave still connects at an unlimited rate
* '''ettv_password''': set to something else than "". This password is needed by the slaves connecting to your slave (together with g_password of course)

Other settings such as ettv_netblast, ettv_tv_iptos etc... can be set as well. You can even use autorecord if you wish, or just add an extra delay.

==== Pitfalls ====

There are however a few risks associated with slave chaining. One of the biggest issues is '''PK3 dependancies'''.

As you know, a slave needs to have at least all the PK3s of the server it connects too. But a slave can have more PK3s installed, as long as it has the ones on the server's pure list. This is what complicates things! The further you go down the "chain", the more the chances exist of PK3 pollution, which makes the job of the last slave very hard. And the viewers connecting to that slave will not be very happy either.

So for those of you venturing into chaining slaves here's a rule of thumb: '''always keep the installed PK3s to the bare minimum'''! Do not add stuff you do not need. If you want to know what PK3s you need and not need, connect your slave to the master or the hub, see which PK3s are on the pure list and rename or remove the PK3s that are not on the list. You will make your viewers and other admins connecting to your slave very happy.

Another risk could be '''chained lag'''. If one of the slaves that is higher in the chain starts lagging, the consequenses for the slaves depending on it will be seen immedeatily. So if you offer to be one of the higher slaves in the chain, make sure your machine can handle it! An ETTV chain is much like the food chain ;-).

==== Admin contributions ====

If by now you feel like getting your hands dirty in ETTV chaining madness and you want to see some example of hubs, slaves, broadcasters and scripts to get it all working, you can already start by checking out [[User:Deej|deej's page]].

==ETTV Demos==
ETTV can record and playback '''ETTV demos'''. ETTV demos have the extension .tv_84 (or .tv_83 for older versions) and are completely different from the .dm_84 demos recorded on clients.

You may record the match in progress to a file, with the command:
:<tt>record <'''demo name'''></tt>
If you omit the demo name, ettv will start recording using a filename of demoXXXX where XXXX is the first available number starting from 0000.

Demos will stop recording when a map changes.

To stop recording a demo:
:<tt>stoprecord</tt>

To play back a recorded demo:
:<tt>demo <'''demo name'''></tt>

To check the status of an ettv slave:
:<tt>tv status</tt>
This will tell you if the slave is connected to a master, or if it is currently playing back a demo.

To fastforward a demo:
:<tt>ff <seconds></tt>
Eg <tt>ff 30</tt> will fast foward 30 seconds. Fast forward stops at map restarts, so you can safely ff 999 to fast forward through a warmup.
:''note'': requires ettv beta 7 or later

===Autorecording demos===
ettv is able to automatically continuously record demos, creating new demofiles when the map changes. To do this, set the cvar ettv_autorecord to 1. ettv will start recording demos with the name demoXXXX where XXXX is a number starting at 0000 and incrementing on each map change.

Server admins may find it useful to use the demo recording feature of ettv to record matches, instead of requiring individual players to record them. An ettv demo records everything that happens on a server, including all player viewpoints.

===How to create demo based delayed feeds===
Autorecording demos is the first half of the process for delayed feeds. Typically you would run a passworded slave server with the smallest number of sv_maxclients possible. No spectators should connect to this server. The only purpose of this slave is to connect up to the master and record the match to sequentially numbered demofiles.

Now start up a slave, and tell it to broadcast the demo being recorded.

:<tt>demo demo0000</tt>

If you wait approx. 60 seconds after the master begins recording before issuing this command to your slaves, then you have a 60 second delay on your broadcast.

If you want slaves to automatically switch to the next demo when the end of the demo is reached (eg on a map change), you would set the cvar ettv_autoplay to 1. If a slave is playing demo0000 and it reaches the end, it will then try to play demo0001 and so on.

Disadvantage of this method: It is not automated in ettv itself, though admins can script it.
Advantage of this method: You may run multiple broadcast servers from the same single demo stream.

Automated delayed feeds are supported in ettv beta 8. See the above.

===Playing back previously recorded ETTV demos===
This is essentially the same as delayed feeds above.
* Configure your server as described in [[ETTV:Server_Configuration#Installation_-_.22Slave.22_.28broadcast_server.29|Slave Installation]] section
* Obtain the <tt>.tv_*</tt> demos and place them in <tt>''fs_game''/demos</tt>
* Start the ettv executable with pb disabled
* <tt>set ettv_autoplay 1</tt> if you want to play back sequential demos named <tt>demo0000.tv_84</tt>, <tt>demo0001.tv_84</tt> etc.
* <tt>demo '''<yourdemoname>'''</tt>
* connect a client and enjoy the show!

==Troubleshooting==

* The slave server must be running the same fs_game setting as the master server.
* The slave server must have a copy of every map pk3 the master server is using.
* If the master server loads a map the slave server doesn't have, the slave will get stuck.
* Spectators will be forced to download any custom pk3 you are using.
* It is a good idea to keep the master server pk3 list to a minimum.
* If you are using the autorecord/autoplay feature for running delayed feeds, you will usually want to make sure you clear out the demos directory first. Autorecording will start numbering demofiles using the first available number, so if you have old recorded demos then ettv might start recording from eg demo0017. If your scripts expect to start playback from demo0000 then you might end up broadcasting a game recorded at some earlier date...
* If the broadcaster constantly reloads on round starts etc, it's probably a problem with too many pk3s on the ettv servers.

==Miscellaneous==

Slaves may send chats to the master with the command msay
Slaves may list players on the master with the command players

==Performance tuning==

Spectator servers with large numbers of clients (eg >100) will push the OS very hard with huge amounts of UDP traffic. The default OS buffer settings for Linux are inadequate and can hurt performance, causing lag and/or disconnects.

If you get messages like
:<tt>NET_SendPacket ERROR: No buffer space available to 192.168.120.142:27960</tt>

Then you definitely need to increase your kernel network buffers.

Large spectator servers should increase the kernel buffers.

The following commands should be issued as root on linux:
:<tt>echo "524288" > /proc/sys/net/core/rmem_max</tt>
:<tt>echo "524288" > /proc/sys/net/core/wmem_max</tt>

FreeBSD can try this:
:<tt>sysctl -w net.inet.udp.recvspace=65535</tt>
:<tt>sysctl -w net.inet.udp.maxdgram=57344</tt>
:<tt>sysctl -w kern.ipc.maxsockbuf=8388608</tt>

===Network tuning cvars===
;The following are only available in ettv beta 7 and later.
By default, et uses small packets of 1400 bytes or less to send to clients. If messages need to be larger, they are 'fragmented' and sent over several server frames. ettv slave messages tend to be large and often fragment. ettv normally tries to send slaves all fragments at once to avoid jittery playback, but some networks / OSes handle this badly. ettv beta 7 introduces new controls so admins can optimize ettv for their individual network.

'''ettv_netblast''' (default 1)
:by default, ettv tries to send all fragments at once. some networks may handle this badly. setting this to 0 disables. warning: setting this to 0 without increasing ettv_mtu will result in severely laggy slave playback.

'''ettv_mtu''' (default 1400)
:; master only
:if your network / os supports it, you can set this to large values (eg 16000) to prevent message fragmentation and provide smoother ettv links. this cvar has no effect on normal ET clients.
:''note'': ettv_mtu must currently be set from commandline, it cannot be changed on the fly (yet).

'''ettv_tv_iptos''' (default 0)
:you can set the ip type of service field of ettv link packets. if your network/ISP supports it, you can use a value like 16 ("minimize delay") to prioritize ettv link packets over others on the network.

'''ettv_sv_iptos''' (default 0)
:same as ettv_tv_iptos, but affects packets for normal ET clients.

[[Category:ETTV]]

SendServerCommand

2006-01-27T08:25:30Z

Deej: typo corrected

__NOEDITSECTION__
et.trap_SendServerCommand() is used to send a command from the server to one or more clients. The first argument is the slot number of the client the command will be sent to. If it's equal to -1, the command will be broadcast to all clients.

The following commands can be issued with this function:

==Printing==
===Print===
* "'''print''' \"''Message''\n\""
:'''print''' prints ''Message'' to the client's console.

===Center Print MoO===
* "'''cpm''' \"''Message''\n\"" 
:'''cpm''' prints ''Message'' to the client's annoucement area and console.

===Center Print===
* "'''cp''' \"''Message''\n\"" 
:'''cp''' prints ''Message'' to the center of the client's screen.

===Banner Print===
* "'''b''' ''locations'' \"''Message''\n\"" 
:'''b''' prints ''Message'' to the client's banner ''locations'' 
:the ''locations'' can be a number from 0 to 248
:For compatibility, the old-style locations (from 0-4) are also supported. 
:8 - player chat area 
:16 - left popup area (not recommended) 
:32 - centered above the chat area 
:64 - console only 
:128 - banner area (recommended)(top of screen)

===Scores Print===
* "'''sc''' \"''Message''\n\"" 
:'''sc''' prints ''Message'' to the client's console and writes it to the statsdump file.

==Chatting==
===Chat===
* "'''c''' ''ClientNum'' \"''Message''\"" 
:'''c''' prints ''Message'' as a global chat message on behalf of the client specified by ''ClientNum''.

===Team Chat===
* "'''tc''' ''ClientNum'' \"''Message''\" ''X-Location'' ''Y-Location'' ''Z-Location''" 
:'''tc''' prints ''Message'' as a team chat message on behalf of the client specified by ''ClientNum'', 
:the ''X,Y,Z-Location's'' are optional parematers that represent the client's location, 
:if the ''X,Y,Z-Location's'' are left out then the message will be printed without a location.

===Fireteam Chat===
* "'''bc''' ''ClientNum'' \"''Message''\" ''X-Location'' ''Y-Location'' ''Z-Location''". 
:'''bc''' prints ''Message'' as a fireteam chat message on behalf of the client specified by ''ClientNum'', 
:the ''X,Y,Z-Location's'' are parematers that represent the client's location.

==Voice Chat==
===Global Voice Chat===
* "'''vchat''' ''VoiceOnly'' ''ClientNum'' 50 ''Vsay-String'' ''Vsay-Number'' \"''Custom-Message''\"". 
:'''vchat''' sends a global voice chat ''Vsay-String'' on behalf of the client specified by ''ClientNum''. 
:''Vsay-Number'' is by default random, however, it can be set by the player by passing parameters to the vsay command (/vsay <''Vsay-Number''> <''Vsay-String''>), ''Vsay-Number'' represents the vsay number of Vsay as listed in the .voice files. 
:''Custom-Message'' is by default \"\" (empty), otherwise it's the message that gets printed in the chat area.
:if ''VoiceOnly'' is 0 it will print a chat message on behalf of ''ClientNum'' contaning the message 
:if ''VoiceOnly'' is 1 it will only do the sound but not the message

===Team Voice Chat===
* "'''vtchat''' ''VoiceOnly'' ''ClientNum'' 50 ''Vsay-String'' ''Vsay-Number'' ''X-Location'' ''Y-Location'' ''Z-Location'' \"''Custom-Message''\"" 
:'''vchat''' sends a team voice chat ''Vsay-String'' a on behalf of client ''ClienNtum''. 
:''Vsay-Number'' is by default random, however, it can be set by the player by passing parameters to the vsay command (/vsay <''Vsay-Number''> <''Vsay-String''>), ''Vsay-Number'' represents the vsay number of Vsay as listed in the .voice files. 
:the ''X,Y,Z-Location's'' parematers the represent the clients location. 
:''Custom-Message'' is by default \"\" (empty), otherwise it's the message that gets printed in the chat area.
:if ''VoiceOnly'' is 0 it will print a chat message on behalf of ''ClientNum'' contaning the message 
:if ''VoiceOnly'' is 1 it will only do the sound but not the message

===Fireteam Voice Chat===
* "'''vtchat''' ''VoiceOnly'' ''ClientNum'' 50 ''Fireteam-String'' ''Vsay-Number'' ''X-Location'' ''Y-Location'' ''Z-Location'' \"''Custom-Message''\"" 
:'''vchat''' will team voice chat ''Vsay-String'' on behalf of client ''ClienNum''. 
:''Vsay-Number'' is by default random, however, it can be set by the player by passing parameters to the vsay command (/vsay <''Vsay-Number''> <''Vsay-String''>), ''Vsay-Number'' represents the vsay number of Vsay as listed in the .voice files. 
:the ''X,Y,Z-Location's'' parematers the represent the clients location. 
:''Custom-Message'' is by default \"\" (empty), otherwise it's the message that gets printed in the chat area.
:if ''VoiceOnly'' is 0 it will print a chat message on behalf of ''ClientNum'' contaning the message 
:if ''VoiceOnly'' is 1 it will only do the sound but not the message

==Fireteam==
===Application===
* "'''application''' ''Number''"
:'''application''' shows a fireteam invation message to the client. 
:if ''Number'' > -1 - the "accept ... application to join your fireteam" message shows up. In this case ''Number'' is the ClientNum of the applying client. 
:if ''Number'' == -1 - the "your aplication has been submitted" message shows up. 
:if ''Number'' == -2 - the "your aplication failed" message shows up. 
:if ''Number'' == -3 - the "your aplication has been approved" message shows up. 
:if ''Number'' == -4 - the "your aplication reply has been sent" message shows up.

===Proposition===
* "'''proposition''' ''Number'' ''Number2''"
:'''proposition''' shows a fireteam proposition message to the client. 
:if ''Number'' > -1 - the "accept ... proposition to invite ... to your fireteam" message shows up. In this case ''Number'' is the ClientNum of the proposed client, and ''Number2'' is the ClientNum of the proposing player. 
:if ''Number'' == -1 - the "your proposition has been submitted" message shows up. 
:if ''Number'' == -2 - the "your proposition was rejected" message shows up. 
:if ''Number'' == -3 - the "your proposition was accepted" message shows up. 
:if ''Number'' == -4 - the "your proposition reply has been sent" message shows up. 
:''Number2'' is an optional paramater only used when ''Number'' > -1.

===Invitation===
* "'''invitation''' ''Number''"
:'''invitation''' shows the fireteam invation message to the client. 
:if ''Number'' > -1 - the "accept .. invitation to join your fireteam" message shows up. In this case ''Number'' is the ClientNum of the applying client. 
:if ''Number'' == -1 - the "your invitation has been submitted" message shows up. 
:if ''Number'' == -2 - the "your invitation rejected" message shows up. 
:if ''Number'' == -3 - the "your invitation was accepted" message shows up. 
:if ''Number'' == -4 - the "your invitation reply has been sent" message shows up.

==Others==
===Complaining===
* "'''complaint''' ''Number''" 
:'''complaint''' shows the complaint vote message to the client. 
:if ''Number'' > 1 - the vote shows up. In this case ''Number'' is the ClientNum of the teamkilling player. 
:if ''Number'' == -1 - the "complaint filed" message shows up. 
:if ''Number'' == -2 - the "complaint dismissed" message shows up.

===Spawning===
* "'''setspawnpt''' ''Number''" 
:'''setspawnpt''' sets the client game selected spawnpoint to number ''number''.

===kicking===
* "'''disconnect''' \"''reason''\"" 
:'''disconnect''' will disconnect the client it has been send with a "Server disconnected" message 
:''reason'' is an optialnal parameter to show a reason after "Server disconnected"

===Configstrings===
* "'''cs''' ''Number'' \"''String''\"" 
: '''cs''' will set the clients configstringnumber ''Number'' to the ''String''

===Shaders===
* "'''remapShader''' \"''OldShader''\" \"''NewShader''\" ''0''" 
: '''remapShader''' remaps the ''OldShader'' whit ''NewShader'' 
: ''0'' is the Timeoffset, i have no idea wut it means so better leave it 0

[[Category:ETPro]]
[[Category:ETPro:Mods]]

Server Configuration

2006-01-24T09:03:26Z

Deej: etded is for the server

==Installation==
File installation:
Note that the <tt>etpro</tt> directory should be in the same directory as <tt>etmain</tt>. Do NOT extract the files to etmain
:Linux:
Unzip the server archive to <tt>enemy-territory/etpro/</tt>
:Windows:
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.
:Linux example:
::<tt> ./etded +set fs_game etpro</tt>
:Windows:
::<tt> etded.exe +set fs_game etpro</tt>
:Windows Shortcut:
::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> 

''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==
WARNING: Server improperly installed! Incorrect fs_game setting! Please notify administrator.
:Incorrect <tt>+set fs_game</tt> string. Make sure it is set to <tt>+set fs_game etpro</tt>.
fs_game is write protected.
:You must start your server via the command line (Or by changing the shortcut) with the <tt>+set fs_game etpro</tt> command. 
Client .pk3 missing!
: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. 
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 [http://bani.anime.net/etpro/download.html 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 [http://games.activision.com/games/wolfenstein 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 <tt>+set dedicated 2</tt> 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 [http://etpro.anime.net/etpro_cheats.dat 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 <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. 
: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 <tt>\Wolfenstein - Enemy territory\pb\pbweb.exe</tt> 
Linux:
:Run <tt>/path_to_et_server/pb/pbweb.x86</tt> (first chmod +x pbweb.x86) 

==Configuration:==
[http://bani.anime.net/banimod/forums/viewforum.php?f=13 Server Admin Forums]

[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)]

[[Category:ETPro]]

TrickJumpLines

2006-01-24T09:00:29Z

Deej: spelling error

Trickjumplines or tjl's in short are lines that trace the path of your movement.

http://www.twwwo.be/etpro/docs/tjl/tjl_inaction.jpg

You can use them in two ways: the first one is the easy to use one (with a built-in menu), the second one is the console-way but gives you more possibilities. Important: cheats must be enabled before you can use this tool.

===The Menu Way===

To use the menu you have to bind the console command to a key.

''Example:'' '''/bind tjl_menu'''

http://www.twwwo.be/etpro/docs/tjl/tjl_menu.jpg

As you can see there are five menu items:

* Record: this starts recording your movements.
* Stoprecord: this stops your movement recoring.
* Quicksave: if you want to save your impressive jump into a file so you can share it with your friends, use this option.
* Quickload: this loads the last Quicksaved trickjumpline, if you want to load other tjl files you have to use the console.
* Draw slot: this toggles the drawing of the current slot.

All these actions are executed on the slotnumber set in the cvar '''*b_tjl_quickslot*''', you can use a maximum of 10 slots.

===The Console Way===

Open the console and type the commando '''/tjl_info''', this will give you detailed information about all the tjl cmd's and cvars.

* tjl_startrecord <clientnum> <slot> OR <slot> | no parameters records your own movements: starts recording your movements
* tjl_stoprecord : stops recording your movements
* tjl_drawslot <slot> OR <slot> <color> : draws a given slot (toggle) b_tjl_color must be set to -1 in order to use this option
* tjl_save <filename> <slot> : saves the current slot into a file
* tjl_load <filename> <slot> : loads the current file into a slot
* tjl_menu : a nice menu to easy use the tjl tools
* b_tjl_draw <1/0> : draws a recorded movement
* b_tjl_stoponnomove <1/0> : stops recording when not moving
* b_tjl_color <hex value> : default linecolor
* b_tjl_showmaxspeed <1/0>: shows the players max speed at that point on the line
* b_tjl_stepsize <number> : the distance between two points on the line, if you want to draw much long lines, use a big stepsize
* b_tjl_quickslot <number> : this slotnumber is used when u use the tjl_menu

===Other benefits of the trickjumplines===

You can use the trickjumplines to teach your tactics to your teammates, by showing them the places where they have to move to.
Or custommapmakers can include some tjl's into their pk3's so people can use them to learn the shortest path to the objectives.

http://www.twwwo.be/etpro/docs/tjl/tjl_tactics.jpg

User:Deej

2006-01-06T09:38:13Z

Deej: parameter correction

http://www.fragland.org/deej/572.gif 
Guilty for founding the [http://www.fragland.org Retired Old Farts] which provide: 
- ETPro servers 
- ETTV servers 
- ETPub servers 
- General annoyance 
- Pub requests for a competition mod 

== My interpretation of ETTV setups ==

Since I'm quite fond of toying around with new developments, I'm always one of the first to test new ETTV / ETPro releases and bug bani with questions about them. Having said that, here's my 'personal' view on a good ETTV broadcast (this is not the Bible!):

=== Terminology ===

There are 5 different "participants" possibly involved in an ETTV broadcast:

* '''Master''' - the gameserver hosting the actual game
* '''Viewer''' - the viewer wanting to view a game (duh)
* '''Broadcaster''' - a server that is directly connected to a gameserver and allows viewer to connect directly to itself
* '''Hub''' - a server that is directly connected to a gameserver and allows other ETTV 'slaves' to connect to itself, but not viewers
* '''Slave''' - a server that connects to a hub or perhaps a broadcaster and and allows viewers to connect to itself

Keep this terminology in mind when you stroll through my text ;-).

=== Today's broadcasts ===

Most ETTV games I see today use this set-up:

:<code>Viewer -> Broadcaster -> Master</code>

If you remember that an ETTV server connects at an ''unlimited rate'' to another server, and as from ETTV b9 the slaves are in fact not limited at all by the original ET netcode, you might see a problem arising when lots of people would like to see a "big match".

The trouble was / is that before ETTV b8 and 'autodelay', we had to do some fancy flying to get a delayed broadcast or delayed hub up. Usually you would start a 'recorder' daemon that recorded demos and a 'playback' daemon from that same directory, so that it started playing back the recorded demo after roughly 60 or 90 seconds. This does require fancy scripting and lots of manual work to sort out demos, connect slaves to hubs etc...

With <code>ettv_autodelay</code>, things have become a lot easier. Ideally the gameserver now only allows 2 or 4 ETTV hubs to connect to it, which delay and relay the signal. The responsibility for the admins of the hub is of course greater as they should not have any PK3s active on their hubs that are not on the pure list of the server. The less PK3s you need, the better!

=== Deej's proposition ===

The best setup IMHO is to have the following:

<pre>Viewers -> Slave 1 |
Viewers -> Slave 2 |
Viewers -> Slave 3 |--> Hub 1 |
|--> Hub 2 | --> Master
Viewers -> Slave ... |--> Hub n |
|
Viewers -> Slave n |</pre>

This alleviates the load on the Master Game Server firmly as only 2 or 4 hubs are required where slaves can then connect to! Furthermore with autodelay all the 'slave' administrators only need to connect their slave to a given hub. No more playing around with delays, demos, symbolic links, PIDs that get screwed up etc...

== Some scripts I use ==

=== Hub script ===

This script launches a hub that delays its feed by x seconds, configurable inside the script. You can safely remove the stuff like PERONI_IP, FRAGLAND_IP etc... at the beginning since those only store the IPs of the root servers we manage (it's easier for me to keep track of them that way).

'''How do you use this script?''' Copy / paste this script and save it as <code>hub.sh</code> or any other name you prefer. Then use <code>./hub.sh start</code> to start and <code>./hub.sh stop</code> to stop your hub. The script generates the server.cfg dynamically every time you start it. If you just want to generate server.cfg do <code>./hub.sh sim</code>.

Be aware that it's much better to actually do "quit" in the console of your hub instead of <code>./hub.sh stop</code> as this cleanly disconnects the hub from a game server. With <code>./hub.sh stop</code> the hub stays with ping 999 on the gameserver and needs to time out. Maybe we should ask Bani to improve POSIX signal interpretation of the ETTV binary :-).

<pre>#!/bin/bash

#################################################################
# #
# ettv delayed hub script #
# - #
# deej. #
# #
#################################################################
# #
# This script can be used to start up a delayed ETTV stream #
# where ETTV slaves connect to the hub to relay the signal. #
# #
# The daemon serves as a hub for other ETTV slaves to connect #
# to and as such alleviate the load on the game server hosting #
# the match. #
# #
# This script creates a subdirectory which represents the #
# date of the match and stores the demos in this subdir. #
# #
# The script generates etmain/server.cfg dynamically. #
# #
# The script launches the daemon in a different screen #
# which you can reattach with "screen -r hub". #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# Start Modifying From Here #
# #
#################################################################
#
# Parameters of the Game Server to Connect to
#
# IMPORTANT: Let the admin of the game server do
# "fdir *.pk3" in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Do NOT modify
MATCH_HOST="et.fragland.org:27965" # Match server port & address
MATCH_ETTV_PASS="[get_pass_from_admin]" # Match server ETTV password
MATCH_PASS="[get_pass_from_admin]" # Match server password

MATCH_HOME_TEAM="uQ" # Making our hostname more fancy ;-)
MATCH_AWAY_TEAM="Logitech"
MATCH_CUP="Warleagues"

#
# IPs & Ports For Your Host
#
HUB_IP="$PERONI_IP" # This host is Webperoni
HUB_PORT="30000" # Port of public hub for ETTV slaves

#
# Hostnames & ETTV Client name
#
# - hostname shows up in server browsers
# - ETTV client name shows up as the name
# of your server in the game server.
#
ETTV_CLIENT="^7reT^1!^7reD^1.^7ettv ^7hub ^1#^71"
HUB_HOSTNAME="$ETTV_CLIENT - ^3$MATCH_CUP^7: $MATCH_HOME_TEAM vs $MATCH_AWAY_TEAM"

#
# Passwords
#
HUB_RCON_PASS="[put_your_pass_here]"
HUB_PRIVATE_PASS="[put_your_pass_here]"
HUB_ETTV_PASS="[put_your_pass_here]"
HUB_PASS="[put_your_pass_here]"

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_hub" # Use absolute paths here!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1"
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400"

#
# Other relevant ETTV settings
#
HUB_DELAY="1" # Delay between live match & hub in seconds
HUB_SLAVES="8" # 1 ETTV slave connects at an UNLIMITED rate!
HUB_PRIVATE_SLOTS="0"

RECORD_GAME="1" # Record the game?

ALLOW_DL="0" # Slaves don't download from the hub
ALLOW_WWW_DL="0"
WWW_DL_URL="http://www.yoursite.com"

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path where
# all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying Here #
# #
#################################################################
#
# Make sure buffers are high enough!
#
echo "524288" > /proc/sys/net/core/rmem_max
echo "524288" > /proc/sys/net/core/wmem_max

#
# Assembling the Command Line
#
BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"
HOMEPATH="$BASEPATH/$MATCH_DATE"

HUB_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set net_ip $HUB_IP \
+set net_port $HUB_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $HOMEPATH \
+set com_hunkMegs 128 \
+set sv_maxclients $HUB_SLAVES \
+exec server.cfg"

#
# Functions
#

hub_start () {
#
# FYI'ing the user
#
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $HOMEPATH/etpro/demos/.\n"

echo -n "Starting Hub: "
screen -dmS hub su -m -c "$DAEMON $HUB_OPTIONS" - $USER
sleep 1
echo -e "done.\n"

echo -e "Getting PID...\n"

get_pids

echo -n "Hub has PID "
echo -e "$HUB_PID\n"

echo "ETTV slaves can now connect to your box by issuing:"
echo -e "tv connect $HUB_IP:$HUB_PORT $HUB_ETTV_PASS $HUB_PASS\n"
}

hub_stop () {
#
# Refresh the PIDs
#
get_pids

echo -n "Shutting Down Hub: "
sleep 1
if [ -n $HUB_PID ]
then
kill -SIGTERM $HUB_PID
echo -e "done."
else
echo -e "failed.\nHub wasn't active anymore.\n"
fi

sleep 1
}

create_config (){
#
# Generate etmain/server.cfg
#
TIMESTAMP=`date +"%d/%m/%Y %H:%M:%S"`

echo "//" > $BASEPATH/etmain/server.cfg
echo "// server.cfg generated $TIMESTAMP" >> $BASEPATH/etmain/server.cfg
echo -e "//\n" >> $BASEPATH/etmain/server.cfg

echo "set sv_privateclients $HUB_PRIVATE_SLOTS" >> $BASEPATH/etmain/server.cfg
echo "set sv_maxRate 25000" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_hostname \"$HUB_HOSTNAME\"\n" >> $BASEPATH/etmain/server.cfg

echo "set g_password \"$HUB_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set rconpassword \"$HUB_RCON_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_privatepassword \"$HUB_PRIVATE_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_allowDownload $ALLOW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwDownload $ALLOW_WWW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwBaseURL \"$WWW_DL_URL\"" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_wwwDlDisconnected 0\n" >> $BASEPATH/etmain/server.cfg

echo "set b_ettv_flags 3" >> $BASEPATH/etmain/server.cfg
echo "set ettv_delay $HUB_DELAY" >> $BASEPATH/etmain/server.cfg
echo "set ettv_autorecord $RECORD_GAME" >> $BASEPATH/etmain/server.cfg
echo "set ettv_clientname \"$ETTV_CLIENT\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_maxslaves \"$HUB_ETTV_SLAVES\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_password \"$HUB_ETTV_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_netblast $ETTV_NETBLAST" >> $BASEPATH/etmain/server.cfg
echo "set ettv_tv_iptos $ETTV_TV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_iptos $ETTV_SV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo -e "set ettv_mtu $ETTV_MTU\n" >> $BASEPATH/etmain/server.cfg

echo "set b_crashlogpath \"$BASEPATH/etpro\"" >> $BASEPATH/etmain/server.cfg
echo "set g_log \"slave.log\"" >> $BASEPATH/etmain/server.cfg
echo -e "set logfile 2\n" >> $BASEPATH/etmain/server.cfg

echo "tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS" >> $BASEPATH/etmain/server.cfg
}

get_pids (){
#
# We used to launch the same binary twice so pidof didn't work.
# As from beta 8 ettv delayed feeds were automatic so
# no more fancy scripting tricks are required :-)
#
HUB_PID=`pidof $DAEMON`
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

#
# Performing The magic :-)
#

case "$1" in
start)
create_config
hub_start
;;
stop)
hub_stop
clean_up
;;
sim)
create_config
echo -e "\nFollowing config was generated automatically:\n"
cat $BASEPATH/etmain/server.cfg
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop|sim}"
exit 1
;;
esac
exit 0
</pre>

=== Slave script ===

This script connects a delayed or undelayed slave to a Hub or directly to a gameserver. The usage of this script is very similar to the Hub script. Copy / paste it and save it as <code>slave.sh</code> or any other name you prefer. Then issue <code>./slave.sh start</code> to start your slave and <code>./slave.sh stop</code> to stop it. Use <code>./slave.sh sim</code> to only create etmain/server.cfg. Like above, it is actually better to do quit in the console instead of just killing the slave with this script.

<pre>#!/bin/bash

#################################################################
# #
# ETTV slave script #
# - #
# deej. #
# #
#################################################################
# #
# This script can be used to start up an ETTV slave to connect #
# to an ETTV HUB or directly to a game server. #
# #
# The script generates etmain/server.cfg dynamically. #
# #
# This script launches the daemon in a different screen which #
# you can reattach with "screen -r slave" #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# #
# Questions? deej@fragland.org or go to #gamestv.org #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# Start Modifying From Here #
# #
#################################################################
#
# Hub Info
#
# IMPORTANT: Let the admin of the hub do a
# fdir *.pk3 in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Do NOT modify
MATCH_HOST="et.fragland.org:27965" # HUB / Match server port & address
MATCH_ETTV_PASS="[get_pass_from_admin]" # HUB / Match server ETTV password
MATCH_PASS="[get_pass_from_admin]" # HUB / Match server password

MATCH_HOME_TEAM="uQ" # Making our hostname more fancy ;-)
MATCH_AWAY_TEAM="Logitech"
MATCH_CUP="Warleagues"

#
# Slave Info
#
SLAVE_IP="$PERONI_IP" # This host is Peroni
SLAVE_PORT="27960" # port of public broadcaster

ETTV_CLIENT="^7reT^1!^7reD^1.^7ettv ^1#^71" # shows up on the Hub
SLAVE_HOSTNAME="$ETTV_CLIENT - ^3$MATCH_CUP^7: $MATCH_HOME_TEAM vs $MATCH_AWAY_TEAM"

SLAVE_SLOTS="100"
SLAVE_PASS="[put_your_pass_here]"

SLAVE_PRIVATE_SLOTS="20"
SLAVE_PRIVATE_PASS="[put_your_pass_here]"

SLAVE_ETTV_SLAVES="5" # Allow chaining?
SLAVE_ETTV_PASS="[put_your_pass_here]"

SLAVE_RCON_PASS="[put_your_pass_here]"

RECORD_GAME="1" # 1 = record game, 0 = don't
SLAVE_DELAY="60" # Time in seconds

REDIRECT="Server is full" # Message displayed when server is full
#REDIRECT="ET://ettv2.fragland.org:27960" # Allows redirecting to other ettv's

#
# Downloading
#
ALLOW_DL="1" # Can clients download stuff?
ALLOW_WWW_DL="1" # Allow downloading over http?
WWW_DL_URL="http://www.yoursite.com" # No "/" at the end!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1"
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400"

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_slave" # Path to ettv.x86
# Use absolute paths here!

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path where
# all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying Here #
# #
#################################################################
#
# Make sure buffers are ok!
#
echo "524288" > /proc/sys/net/core/rmem_max
echo "524288" > /proc/sys/net/core/wmem_max

#
# Assembling the Command Line
#
BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"
HOMEPATH="$BASEPATH/$MATCH_DATE"

SLAVE_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set com_hunkMegs 256 \
+set net_ip $SLAVE_IP \
+set net_port $SLAVE_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $HOMEPATH \
+set sv_maxclients $SLAVE_SLOTS \
+exec server.cfg"

#
# Functions
#

slave_start (){
#
# FYI the user
#
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $HOMEPATH/etpro/demos/.\n"

#
# Start the slave
#
echo -n "Starting Slave: "

screen -dmS slave su -m -c "$DAEMON $SLAVE_OPTIONS" - $USER

echo -e "done.\n"

echo -e "Getting PID...\n"
sleep 1

SLAVE_PID=`pidof $DAEMON`

echo -n "Slave has PID "
echo -e "$SLAVE_PID.\n"

if [ $SLAVE_ETTV_SLAVES != 0 ]
then
echo "ETTV slaves can now connect to your box by issuing:"
echo -e "tv connect $SLAVE_IP:$SLAVE_PORT $SLAVE_ETTV_PASS $SLAVE_PASS\n"
fi
}

slave_stop (){
#
# Refresh the PID
#
SLAVE_PID=`pidof $DAEMON`

echo -n "Shutting Down Slave: "
sleep 1
if [ $SLAVE_PID ]
then
kill -SIGTERM $SLAVE_PID
echo -e "done."
else
echo -e "failed.\nSlave wasn't active anymore.\n"
fi
}

create_config (){
#
# Generate etmain/server.cfg
#
TIMESTAMP=`date +"%d/%m/%Y %H:%M:%S"`

echo "//" > $BASEPATH/etmain/server.cfg
echo "// server.cfg generated $TIMESTAMP" >> $BASEPATH/etmain/server.cfg
echo -e "//\n" >> $BASEPATH/etmain/server.cfg

echo "set sv_privateclients $SLAVE_PRIVATE_SLOTS" >> $BASEPATH/etmain/server.cfg
echo "set sv_maxRate 25000" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_hostname \"$SLAVE_HOSTNAME\"\n" >> $BASEPATH/etmain/server.cfg

echo "set g_password \"$SLAVE_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set rconpassword \"$SLAVE_RCON_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_privatepassword \"$SLAVE_PRIVATE_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_allowDownload $ALLOW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwDownload $ALLOW_WWW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwBaseURL \"$WWW_DL_URL\"" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_wwwDlDisconnected 0\n" >> $BASEPATH/etmain/server.cfg

echo "set b_ettv_flags 3" >> $BASEPATH/etmain/server.cfg
echo "set ettv_delay $SLAVE_DELAY" >> $BASEPATH/etmain/server.cfg
echo "set ettv_autorecord $RECORD_GAME" >> $BASEPATH/etmain/server.cfg
echo "set ettv_clientname \"$ETTV_CLIENT\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_maxslaves \"$SLAVE_ETTV_SLAVES\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_password \"$SLAVE_ETTV_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_netblast $ETTV_NETBLAST" >> $BASEPATH/etmain/server.cfg
echo "set ettv_tv_iptos $ETTV_TV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_iptos $ETTV_SV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo -e "set ettv_mtu $ETTV_MTU\n" >> $BASEPATH/etmain/server.cfg

echo "set b_crashlogpath \"$BASEPATH/etpro\"" >> $BASEPATH/etmain/server.cfg
echo "set g_log \"slave.log\"" >> $BASEPATH/etmain/server.cfg
echo -e "set logfile 2\n" >> $BASEPATH/etmain/server.cfg

echo "tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS" >> $BASEPATH/etmain/server.cfg
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

#
# Performing The magic :-)
#

case "$1" in
start)
create_config
slave_start
;;
stop)
slave_stop
clean_up
;;
restart)
$0 stop
sleep 1
$0 start
;;
sim)
create_config
echo -e "\nFollowing config was generated automatically:\n"
cat $BASEPATH/etmain/server.cfg
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop|restart|sim}"
exit 1
;;
esac
exit 0
</pre>

=== Old school record / playback script ===

This is a script to broadcast a game the old-fashioned way. It records a demo and starts playing it back after roughly 60 seconds. There's some symbolic linking stuff done inside to make sure it stores all the logs, otherwise the 'broadcaster' would override the recorder's log, ''which makes broadcasting very hard to debug'' :-)!

Copy / paste this script and save it as <code>broadcast.sh</code> or any other name you prefer. The usual comments on quit and 999 are applicable here as well. This script "should" work with ETTV earlier then b8. However, YMMV.

<pre>#!/bin/bash

#################################################################
# #
# reT!reD.ettv delayed broadcast script #
# - #
# reT!reD.deej #
# #
#################################################################
# #
# This script can be used to start up a delayed ETTV stream #
# where viewers connect directly to the broadcaster. #
# #
# This script creates a subdirectory which represents the #
# date of the match and stores the demos in this subdir. #
# #
# The script launches the daemons in different screens #
# which you can reattach with "screen -r recorder" #
# or "screen -r broadcaster". #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# - aNgel (fragland.org) for debugging Beavis' mistakes ;-) #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################
# #
# http://www.fragland.org #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# START Modifying #
# #
#################################################################
#
# Parameters of the Game Server to Connect to
#
# IMPORTANT: Let the admin of the game server do
# "fdir *.pk3" in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Today's date for creating the subdir
MATCH_HOST="et.fragland.org:27965" # Match server port & address
MATCH_ETTV_PASS="[get_pass_from_admin]" # Match server ETTV password
MATCH_PASS="[get_pass_from_admin]" # Match server password

#
# IPs & Ports For Your Host
#
THISHOST_IP=$PERONI_IP # This host is Webperoni
RECORDER_PORT="44999" # Port of the private recorder
BROADCASTER_PORT="27960" # Port of the public broadcaster

#
# Hostnames & ETTV Client name
#
# - hostname shows up in server browsers
# - ETTV client name shows up as the name
# of your server in the game server.
#
RECORDER_HOSTNAME="^7reT^1!^7reD^1.^7ettv ^7recorder ^1#^71"
BROADCASTER_HOSTNAME="^7reT^1!^7reD^1.^7ettv ^1#^71"

ETTV_CLIENT=$BROADCASTER_HOSTNAME

#
# Passwords
#
RCON_PASS="[put_your_pass_here]"
RECORDER_PASS="[put_your_pass_here]"
BROADCASTER_PRIVATE_PASS="[put_your_pass_here]"
BROADCASTER_ETTV_PASS="[put_your_pass_here]"
BROADCASTER_PASS="[put_your_pass_here]" # Issue /rcon g_password "" for opening it up to the crowd

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_brc" # Path to ettv.x86. Use absolute paths here!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1"
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400"

#
# Other relevant settings
#
SHOUTCAST_DELAY="60" # Delay between live match & broadcasting hub in seconds

BROADCASTER_SLOTS="100"
BROADCASTER_PRIVATE_SLOTS="10"
BROADCASTER_ETTV_SLAVES="0"

ALLOW_DL="1"
ALLOW_WWW_DL="1" # Allow downloading over http?
WWW_DL_URL="http://www.yoursite.org" # No "/" at the end!

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path
# where all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying #
# #
#################################################################
#
# Assembling the Command Line
#
RECORDER_HOMEPATH="$BASEPATH/$MATCH_DATE/recorder"
BROADCASTER_HOMEPATH="$BASEPATH/$MATCH_DATE/broadcaster"

BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"

RECORDER_OPTIONS="\
+set fs_game etpro \
+set dedicated 1 \
+map oasis \
+set net_ip $THISHOST_IP \
+set net_port $RECORDER_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $RECORDER_HOMEPATH \
+set com_hunkMegs 128 \
+set g_password $RECORDER_PASS \
+set rconpassword $RCON_PASS \
+set sv_hostname $RECORDER_HOSTNAME \
+set sv_maxclients 4 \
+set sv_maxRate 25000 \
+set sv_allowDownload 0 \
+set sv_wwwDownload 0 \
+set sv_wwwBaseURL "$WWW_DL_URL" \
+set sv_wwwDlDisconnected 0 \
+set g_log "recorder.log" \
+set logfile 2 \
+set b_ettv_flags 3 \
+set ettv_sv_maxslaves 2 \
+set ettv_clientname $ETTV_CLIENT \
+set ettv_password $BROADCASTER_ETTV_PASS \
+set ettv_netblast $ETTV_NETBLAST \
+set ettv_tv_iptos $ETTV_TV_IPTOS \
+set ettv_sv_iptos $ETTV_SV_IPTOS \
+set ettv_mtu $ETTV_MTU \
+set ettv_autorecord 1 \
+set ettv_delay 1 \
+tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS"

BROADCASTER_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set net_ip $THISHOST_IP \
+set net_port $BROADCASTER_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $BROADCASTER_HOMEPATH \
+set com_hunkMegs 160 \
+set sv_maxclients $BROADCASTER_SLOTS \
+set sv_privateclients $BROADCASTER_PRIVATE_SLOTS \
+set sv_privatepassword $BROADCASTER_PRIVATE_PASS \
+set sv_hostname $BROADCASTER_HOSTNAME \
+set g_password $BROADCASTER_PASS \
+set rconpassword $RCON_PASS \
+set sv_maxRate 18000 \
+set sv_allowDownload $ALLOW_DL \
+set sv_wwwDownload $ALLOW_WWW_DL \
+set sv_wwwBaseURL "$WWW_DL_URL" \
+set sv_wwwDlDisconnected 0 \
+set g_log "broadcaster.log" \
+set logfile 2 \
+set ettv_autoplay 1 \
+set ettv_password $BROADCASTER_ETTV_PASS \
+set b_ettv_flags 3 \
+set ettv_sv_maxslaves $BROADCASTER_ETTV_SLAVES \
+demo demo0000"

#
# Functions
#
broadcast_start (){
#
# FYI'ing the user
#
echo -e "\n"
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $RECORDER_HOMEPATH/etpro/demos/.\n"

echo -n "Starting Recorder: "
screen -dmS recorder su -m -c "$DAEMON $RECORDER_OPTIONS" - $USER
echo "done."

get_pids

echo -n "Recorder has PID "
echo -n $RECORDER_PID

echo -e ".\n\nSleeping for $SHOUTCAST_DELAY seconds."
sleep $SHOUTCAST_DELAY

mkdir "$BROADCASTER_HOMEPATH"
mkdir "$BROADCASTER_HOMEPATH/etpro"
ln -s "$RECORDER_HOMEPATH/etpro/demos" "$BROADCASTER_HOMEPATH/etpro"
chown -R $USER "$BROADCASTER_HOMEPATH"
chmod -R 775 "$BROADCASTER_HOMEPATH"

echo -n "Starting Broadcaster: "
screen -dmS broadcaster su -m -c "$DAEMON $BROADCASTER_OPTIONS" - $USER
echo -e "done.\n"

echo -e "Getting PIDs...\n"
sleep 1

get_pids

echo -n "Recorder has PID "
echo -n $RECORDER_PID
echo -e ".\n\nBroadcaster has PID "
echo -e "$BROADCASTER_PID.\n"
}

broadcast_stop (){

get_pids

echo -n "Shutting Down Broadcaster: "
sleep 1
if [ $BROADCASTER_PID ]
then
kill -3 $BROADCASTER_PID
echo -e "done."
else
echo -e "failed.\nBroadcaster wasn't active anymore.\n"
fi

echo -n "Shutting Down Recorder: "
sleep 1
if [ $RECORDER_PID ]
then
kill -3 $RECORDER_PID
echo -e "done."
else
echo -e "failed.\nRecorder wasn't active anymore.\n"
fi

sleep 1
clean_up
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

get_pids (){
#
# Pulling some very ugly tricks here
#
RECORDER_PID=`ps aux|grep "+set net_port $RECORDER_PORT"|grep -v "su -m -c"|grep -v "SCREEN -dmS"\|awk '{ print $1 $2 }'|tr -d "$USER"`
BROADCASTER_PID=`ps aux|grep "+set net_port $BROADCASTER_PORT"|grep -v "su -m -c"|grep -v "SCREEN -dmS"|awk '{ print $1 $2 }'|tr -d "$USER"`
}

#
# Performing The magic :-)
#

case "$1" in
start)
broadcast_start
;;
stop)
broadcast_stop
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop}"
exit 1
;;
esac
exit 0
</pre>

=== Sanitization script ===

This is a script to restore an ETTV directory to the bare minimum required to broadcast matches or be a hub. It isn't a very advanced script but it gets the job done. Copy / paste this script and save it as <code>sanitize.sh</code> or any other name you prefer. Just do <code>./sanitize.sh</code> do delete all files in etmain & etpro that are not needed anymore.

''Note'': this script deletes '''everything''' it finds in the etmain and etpro directories. If you have stuff that you do not want to delete in there, add it to the ETMAIN_FILES & ETPRO_FILES arrays.

<pre>#!/bin/bash

#################################################################
# #
# ettv clean-up script #
# - #
# deej. #
# #
#################################################################
# #
# This script is used to restore an ETTV directory to the bare #
# minimum in terms of files. #
# #
# Use it to clean up after an ETTV session so you can start the #
# next session with a minimum of PK3s. #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################

ETMAIN_FILES=(\
"description.txt" \
"hunkusage.dat" \
"mp_bin.pk3" \
"pak0.pk3" \
"pak1.pk3" \
"pak2.pk3" \
"et_ice.pk3" \
"braundorf_b4.pk3" \
"supplydepot2.pk3" \
"sw_goldrush_te.pk3" \
"sw_oasis_b3.pk3")

ETPRO_FILES=(\
"etpro-3_2_4.pk3" \
"etpro_cheats.dat" \
"qagame.mp.i386.so" \
"tvgame.mp.i386.so")

SCRIPT_NAME=`basename $0`

case $1 in
hub)
BASEPATH="/srv/et/ETTV/ettv_hub"
;;
slave)
BASEPATH="/srv/et/ETTV/ettv_slave"
;;
*)
echo -e "\nError: $1 is not a valid installation target."
echo -e "Usage: $SCRIPT_NAME {hub|slave}\n"
exit 1
esac

#
# Test for existence of backup directories
#
if [ ! -d "$BASEPATH/etmain/bak/" ]; then
mkdir "$BASEPATH/etmain/bak"
fi

if [ ! -d "$BASEPATH/etpro/bak/" ]; then
mkdir "$BASEPATH/etpro/bak"
fi

#
# Clear etmain
#
for i in ${ETMAIN_FILES[@]}
do
mv "$BASEPATH/etmain/$i" "$BASEPATH/etmain/bak/"
done
rm $BASEPATH/etmain/*

#
# Clear etpro
#
for i in ${ETPRO_FILES[@]}
do
mv "$BASEPATH/etpro/$i" "$BASEPATH/etpro/bak/"
done
rm $BASEPATH/etpro/*

#
# Restore etmain
#
for i in ${ETMAIN_FILES[@]}
do
mv "$BASEPATH/etmain/bak/$i" "$BASEPATH/etmain/"
done

#
# Restore etpro
#
for i in ${ETPRO_FILES[@]}
do
mv "$BASEPATH/etpro/bak/$i" "$BASEPATH/etpro/"
done

#
# Clean the backup directories
#
rm -Rf $BASEPATH/etmain/bak
rm -Rf $BASEPATH/etpro/bak
</pre>

=== Switching beta's script ===

This script allows you to quickly switch between the different beta's Bani has released. Just save it as <code>switchbeta.sh</code> and adapt the directory fields to your setup. Usage example: <code>./switchbeta.sh 9 hub</code> switches the hub to beta 9. <code>./switchbeta.sh 4 all</code> switches hub & slave (or others you can define of course) back to beta 4.

<pre>#!/bin/bash

#################################################################
# #
# switching ettv betas script #
# - #
# deej. #
# #
#################################################################
# #
# This script allows you to easily switch ETTV beta versions. #
# #
# Just put the ettv-beta[x].zip files in directory $REPODIR, #
# adapt settings for hub & slave and start switching! #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################

#
# Paths & files
#
REPODIR="/srv/et" # Where the ettv-betaX.zip files reside
HUB_DIR="/srv/et/ETTV/ettv_hub"
SLAVE_DIR="/srv/et/ETTV/ettv_slave"

#
# Argument check
#
SCRIPT_NAME=`basename $0`
ARGS=2
E_BADARGS=65

if [ $# -lt "$ARGS" ]
then
echo -e "\nError: missing arguments"
echo -e "Usage: $SCRIPT_NAME {beta number} {hub|slave|broadcast|all}\n"
exit $E_BADARGS
fi

FILENAME="ettv-beta$1.zip"

if [ ! -e "$REPODIR/$FILENAME" ]
then
echo -e "\nError: beta version $1 is not present in $REPODIR."
echo -e "Usage: $SCRIPT_NAME {beta number} {hub|slave|all}\n"
exit $E_BADARGS
fi

case $2 in
hub)
unzip -o "$REPODIR/$FILENAME" -d "$HUB_DIR" ettv.x86
chmod +x "$HUB_DIR/ettv.x86"
unzip -o "$REPODIR/$FILENAME" -d "$HUB_DIR/etpro" tvgame.mp.i386.so
;;
slave)
unzip -o "$REPODIR/$FILENAME" -d "$SLAVE_DIR" ettv.x86
chmod +x "$SLAVE_DIR/ettv.x86"
unzip -o "$REPODIR/$FILENAME" -d "$SLAVE_DIR/etpro" tvgame.mp.i386.so
;;
all)
$0 $1 hub
$0 $1 slave
;;
*)
echo -e "\nError: $2 is not a valid installation target."
echo -e "Usage: $SCRIPT_NAME {beta number} {hub|slave|all}\n"
exit $E_BADARGS
esac
exit 0
</pre>

Have fun broadcasting!

[[User:Deej|deej]] 01:46, 3 January 2006 (PST)

[[Category:ETTV]]

Talk:Current events

2006-01-05T16:02:30Z

Deej:

Phase IX should be moved forward IMO -- [[User:Deej|deej]] 08:02, 5 January 2006 (PST)

User:Deej

2006-01-03T09:52:38Z

Deej: goddamn typos! wake up!

http://www.fragland.org/deej/572.gif 
Guilty for founding the [http://www.fragland.org Retired Old Farts] which provide: 
- ETPro servers 
- ETTV servers 
- ETPub servers 
- General annoyance 
- Pub requests for a competition mod 

== My interpretation of ETTV setups ==

Since I'm quite fond of toying around with new developments, I'm always one of the first to test new ETTV / ETPro releases and bug bani with questions about them. Having said that, here's my 'personal' view on a good ETTV broadcast (this is not the Bible!):

=== Terminology ===

There are 5 different "participants" possibly involved in an ETTV broadcast:

* '''Master''' - the gameserver hosting the actual game
* '''Viewer''' - the viewer wanting to view a game (duh)
* '''Broadcaster''' - a server that is directly connected to a gameserver and allows viewer to connect directly to itself
* '''Hub''' - a server that is directly connected to a gameserver and allows other ETTV 'slaves' to connect to itself, but not viewers
* '''Slave''' - a server that connects to a hub or perhaps a broadcaster and and allows viewers to connect to itself

Keep this terminology in mind when you stroll through my text ;-).

=== Today's broadcasts ===

Most ETTV games I see today use this set-up:

:<code>Viewer -> Broadcaster -> Master</code>

If you remember that an ETTV server connects at an ''unlimited rate'' to another server, and as from ETTV b9 the slaves are in fact not limited at all by the original ET netcode, you might see a problem arising when lots of people would like to see a "big match".

The trouble was / is that before ETTV b8 and 'autodelay', we had to do some fancy flying to get a delayed broadcast or delayed hub up. Usually you would start a 'recorder' daemon that recorded demos and a 'playback' daemon from that same directory, so that it started playing back the recorded demo after roughly 60 or 90 seconds. This does require fancy scripting and lots of manual work to sort out demos, connect slaves to hubs etc...

With <code>ettv_autodelay</code>, things have become a lot easier. Ideally the gameserver now only allows 2 or 4 ETTV hubs to connect to it, which delay and relay the signal. The responsibility for the admins of the hub is of course greater as they should not have any PK3s active on their hubs that are not on the pure list of the server. The less PK3s you need, the better!

=== Deej's proposition ===

The best setup IMHO is to have the following:

<pre>Viewers -> Slave 1 |
Viewers -> Slave 2 |
Viewers -> Slave 3 |--> Hub 1 |
|--> Hub 2 | --> Master
Viewers -> Slave ... |--> Hub n |
|
Viewers -> Slave n |</pre>

This alleviates the load on the Master Game Server firmly as only 2 or 4 hubs are required where slaves can then connect to! Furthermore with autodelay all the 'slave' administrators only need to connect their slave to a given hub. No more playing around with delays, demos, symbolic links, PIDs that get screwed up etc...

== Some scripts I use ==

=== Hub script ===

This script launches a hub that delays its feed by x seconds, configurable inside the script. You can safely remove the stuff like PERONI_IP, FRAGLAND_IP etc... at the beginning since those only store the IPs of the root servers we manage (it's easier for me to keep track of them that way).

'''How do you use this script?''' Copy / paste this script and save it as <code>hub.sh</code> or any other name you prefer. Then use <code>./hub.sh start</code> to start and <code>./hub.sh stop</code> to stop your hub. The script generates the server.cfg dynamically every time you start it. If you just want to generate server.cfg do <code>./hub.sh sim</code>.

Be aware that it's much better to actually do "quit" in the console of your hub instead of <code>./hub.sh stop</code> as this cleanly disconnects the hub from a game server. With <code>./hub.sh stop</code> the hub stays with ping 999 on the gameserver and needs to time out. Maybe we should ask Bani to improve POSIX signal interpretation of the ETTV binary :-).

<pre>#!/bin/bash

#################################################################
# #
# ettv delayed hub script #
# - #
# deej. #
# #
#################################################################
# #
# This script can be used to start up a delayed ETTV stream #
# where ETTV slaves connect to the hub to relay the signal. #
# #
# The daemon serves as a hub for other ETTV slaves to connect #
# to and as such alleviate the load on the game server hosting #
# the match. #
# #
# This script creates a subdirectory which represents the #
# date of the match and stores the demos in this subdir. #
# #
# The script generates etmain/server.cfg dynamically. #
# #
# The script launches the daemon in a different screen #
# which you can reattach with "screen -r hub". #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# Start Modifying From Here #
# #
#################################################################
#
# Parameters of the Game Server to Connect to
#
# IMPORTANT: Let the admin of the game server do
# "fdir *.pk3" in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Do NOT modify
MATCH_HOST="et.fragland.org:27965" # Match server port & address
MATCH_ETTV_PASS="[get_pass_from_admin]" # Match server ETTV password
MATCH_PASS="[get_pass_from_admin]" # Match server password

MATCH_HOME_TEAM="uQ" # Making our hostname more fancy ;-)
MATCH_AWAY_TEAM="Logitech"
MATCH_CUP="Warleagues"

#
# IPs & Ports For Your Host
#
HUB_IP="$PERONI_IP" # This host is Webperoni
HUB_PORT="30000" # Port of public hub for ETTV slaves

#
# Hostnames & ETTV Client name
#
# - hostname shows up in server browsers
# - ETTV client name shows up as the name
# of your server in the game server.
#
ETTV_CLIENT="^7reT^1!^7reD^1.^7ettv ^7hub ^1#^71"
HUB_HOSTNAME="$ETTV_CLIENT - ^3$MATCH_CUP^7: $MATCH_HOME_TEAM vs $MATCH_AWAY_TEAM"

#
# Passwords
#
HUB_RCON_PASS="[put_your_pass_here]"
HUB_PRIVATE_PASS="[put_your_pass_here]"
HUB_ETTV_PASS="[put_your_pass_here]"
HUB_PASS="[put_your_pass_here]"

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_hub" # Use absolute paths here!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1"
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400"

#
# Other relevant ETTV settings
#
HUB_DELAY="1" # Delay between live match & hub in seconds
HUB_SLAVES="8" # 1 ETTV slave connects at an UNLIMITED rate!
HUB_PRIVATE_SLOTS="0"

RECORD_GAME="1" # Record the game?

ALLOW_DL="0" # Slaves don't download from the hub
ALLOW_WWW_DL="0"
WWW_DL_URL="http://www.yoursite.com"

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path where
# all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying Here #
# #
#################################################################
#
# Make sure buffers are high enough!
#
echo "524288" > /proc/sys/net/core/rmem_max
echo "524288" > /proc/sys/net/core/wmem_max

#
# Assembling the Command Line
#
BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"
HOMEPATH="$BASEPATH/$MATCH_DATE"

HUB_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set net_ip $HUB_IP \
+set net_port $HUB_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $HOMEPATH \
+set com_hunkMegs 128 \
+set sv_maxclients $HUB_SLAVES \
+exec server.cfg"

#
# Functions
#

hub_start () {
#
# FYI'ing the user
#
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $HOMEPATH/etpro/demos/.\n"

echo -n "Starting Hub: "
screen -dmS hub su -m -c "$DAEMON $HUB_OPTIONS" - $USER
sleep 1
echo -e "done.\n"

echo -e "Getting PID...\n"

get_pids

echo -n "Hub has PID "
echo -e "$HUB_PID\n"

echo "ETTV slaves can now connect to your box by issuing:"
echo -e "tv connect $HUB_IP:$HUB_PORT $HUB_ETTV_PASS $HUB_PASS\n"
}

hub_stop () {
#
# Refresh the PIDs
#
get_pids

echo -n "Shutting Down Hub: "
sleep 1
if [ -n $HUB_PID ]
then
kill -SIGTERM $HUB_PID
echo -e "done."
else
echo -e "failed.\nHub wasn't active anymore.\n"
fi

sleep 1
}

create_config (){
#
# Generate etmain/server.cfg
#
TIMESTAMP=`date +"%d/%m/%Y %H:%M:%S"`

echo "//" > $BASEPATH/etmain/server.cfg
echo "// server.cfg generated $TIMESTAMP" >> $BASEPATH/etmain/server.cfg
echo -e "//\n" >> $BASEPATH/etmain/server.cfg

echo "set sv_privateclients $HUB_PRIVATE_SLOTS" >> $BASEPATH/etmain/server.cfg
echo "set sv_maxRate 25000" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_hostname \"$HUB_HOSTNAME\"\n" >> $BASEPATH/etmain/server.cfg

echo "set g_password \"$HUB_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set rconpassword \"$HUB_RCON_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_privatepassword \"$HUB_PRIVATE_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_allowDownload $ALLOW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwDownload $ALLOW_WWW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwBaseURL \"$WWW_DL_URL\"" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_wwwDlDisconnected 0\n" >> $BASEPATH/etmain/server.cfg

echo "set b_ettv_flags 3" >> $BASEPATH/etmain/server.cfg
echo "set ettv_delay $HUB_DELAY" >> $BASEPATH/etmain/server.cfg
echo "set ettv_autorecord $RECORD_GAME" >> $BASEPATH/etmain/server.cfg
echo "set ettv_clientname \"$ETTV_CLIENT\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_maxslaves \"$HUB_ETTV_SLAVES\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_password \"$HUB_ETTV_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_netblast $ETTV_NETBLAST" >> $BASEPATH/etmain/server.cfg
echo "set ettv_tv_iptos $ETTV_TV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_iptos $ETTV_SV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo -e "set ettv_mtu $ETTV_MTU\n" >> $BASEPATH/etmain/server.cfg

echo "set b_crashlogpath \"$BASEPATH/etpro\"" >> $BASEPATH/etmain/server.cfg
echo "set g_log \"slave.log\"" >> $BASEPATH/etmain/server.cfg
echo -e "set logfile 2\n" >> $BASEPATH/etmain/server.cfg

echo "tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS" >> $BASEPATH/etmain/server.cfg
}

get_pids (){
#
# We used to launch the same binary twice so pidof didn't work.
# As from beta 8 ettv delayed feeds were automatic so
# no more fancy scripting tricks are required :-)
#
HUB_PID=`pidof $DAEMON`
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

#
# Performing The magic :-)
#

case "$1" in
start)
create_config
hub_start
;;
stop)
hub_stop
clean_up
;;
sim)
create_config
echo -e "\nFollowing config was generated automatically:\n"
cat $BASEPATH/etmain/server.cfg
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop|sim}"
exit 1
;;
esac
exit 0
</pre>

=== Slave script ===

This script connects a delayed or undelayed slave to a Hub or directly to a gameserver. The usage of this script is very similar to the Hub script. Copy / paste it and save it as <code>slave.sh</code> or any other name you prefer. Then issue <code>./slave.sh start</code> to start your slave and <code>./slave.sh stop</code> to stop it. Use <code>./slave.sh sim</code> to only create etmain/server.cfg. Like above, it is actually better to do quit in the console instead of just killing the slave with this script.

<pre>#!/bin/bash

#################################################################
# #
# ETTV slave script #
# - #
# deej. #
# #
#################################################################
# #
# This script can be used to start up an ETTV slave to connect #
# to an ETTV HUB or directly to a game server. #
# #
# The script generates etmain/server.cfg dynamically. #
# #
# This script launches the daemon in a different screen which #
# you can reattach with "screen -r slave" #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# #
# Questions? deej@fragland.org or go to #gamestv.org #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# Start Modifying From Here #
# #
#################################################################
#
# Hub Info
#
# IMPORTANT: Let the admin of the hub do a
# fdir *.pk3 in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Do NOT modify
MATCH_HOST="et.fragland.org:27965" # HUB / Match server port & address
MATCH_ETTV_PASS="[get_pass_from_admin]" # HUB / Match server ETTV password
MATCH_PASS="[get_pass_from_admin]" # HUB / Match server password

MATCH_HOME_TEAM="uQ" # Making our hostname more fancy ;-)
MATCH_AWAY_TEAM="Logitech"
MATCH_CUP="Warleagues"

#
# Slave Info
#
SLAVE_IP="$PERONI_IP" # This host is Peroni
SLAVE_PORT="27960" # port of public broadcaster

ETTV_CLIENT="^7reT^1!^7reD^1.^7ettv ^1#^71" # shows up on the Hub
SLAVE_HOSTNAME="$ETTV_CLIENT - ^3$MATCH_CUP^7: $MATCH_HOME_TEAM vs $MATCH_AWAY_TEAM"

SLAVE_SLOTS="100"
SLAVE_PASS="[put_your_pass_here]"

SLAVE_PRIVATE_SLOTS="20"
SLAVE_PRIVATE_PASS="[put_your_pass_here]"

SLAVE_ETTV_SLAVES="5" # Allow chaining?
SLAVE_ETTV_PASS="[put_your_pass_here]"

SLAVE_RCON_PASS="[put_your_pass_here]"

RECORD_GAME="1" # 1 = record game, 0 = don't
SLAVE_DELAY="60" # Time in seconds

REDIRECT="Server is full" # Message displayed when server is full
#REDIRECT="ET://ettv2.fragland.org:27960" # Allows redirecting to other ettv's

#
# Downloading
#
ALLOW_DL="1" # Can clients download stuff?
ALLOW_WWW_DL="1" # Allow downloading over http?
WWW_DL_URL="http://www.yoursite.com" # No "/" at the end!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1"
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400"

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_slave" # Path to ettv.x86
# Use absolute paths here!

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path where
# all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying Here #
# #
#################################################################
#
# Make sure buffers are ok!
#
echo "524288" > /proc/sys/net/core/rmem_max
echo "524288" > /proc/sys/net/core/wmem_max

#
# Assembling the Command Line
#
BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"
HOMEPATH="$BASEPATH/$MATCH_DATE"

SLAVE_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set com_hunkMegs 256 \
+set net_ip $SLAVE_IP \
+set net_port $SLAVE_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $HOMEPATH \
+set sv_maxclients $SLAVE_SLOTS \
+exec server.cfg"

#
# Functions
#

slave_start (){
#
# FYI the user
#
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $HOMEPATH/etpro/demos/.\n"

#
# Start the slave
#
echo -n "Starting Slave: "

screen -dmS slave su -m -c "$DAEMON $SLAVE_OPTIONS" - $USER

echo -e "done.\n"

echo -e "Getting PID...\n"
sleep 1

SLAVE_PID=`pidof $DAEMON`

echo -n "Slave has PID "
echo -e "$SLAVE_PID.\n"

if [ $SLAVE_ETTV_SLAVES != 0 ]
then
echo "ETTV slaves can now connect to your box by issuing:"
echo -e "tv connect $SLAVE_IP:$SLAVE_PORT $SLAVE_ETTV_PASS $SLAVE_PASS\n"
fi
}

slave_stop (){
#
# Refresh the PID
#
SLAVE_PID=`pidof $DAEMON`

echo -n "Shutting Down Slave: "
sleep 1
if [ $SLAVE_PID ]
then
kill -SIGTERM $SLAVE_PID
echo -e "done."
else
echo -e "failed.\nSlave wasn't active anymore.\n"
fi
}

create_config (){
#
# Generate etmain/server.cfg
#
TIMESTAMP=`date +"%d/%m/%Y %H:%M:%S"`

echo "//" > $BASEPATH/etmain/server.cfg
echo "// server.cfg generated $TIMESTAMP" >> $BASEPATH/etmain/server.cfg
echo -e "//\n" >> $BASEPATH/etmain/server.cfg

echo "set sv_privateclients $SLAVE_PRIVATE_SLOTS" >> $BASEPATH/etmain/server.cfg
echo "set sv_maxRate 25000" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_hostname \"$SLAVE_HOSTNAME\"\n" >> $BASEPATH/etmain/server.cfg

echo "set g_password \"$SLAVE_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set rconpassword \"$SLAVE_RCON_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_privatepassword \"$SLAVE_PRIVATE_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_allowDownload $ALLOW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwDownload $ALLOW_WWW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwBaseURL \"$WWW_DL_URL\"" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_wwwDlDisconnected 0\n" >> $BASEPATH/etmain/server.cfg

echo "set b_ettv_flags 3" >> $BASEPATH/etmain/server.cfg
echo "set ettv_delay $SLAVE_DELAY" >> $BASEPATH/etmain/server.cfg
echo "set ettv_autorecord $RECORD_GAME" >> $BASEPATH/etmain/server.cfg
echo "set ettv_clientname \"$ETTV_CLIENT\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_maxslaves \"$SLAVE_ETTV_SLAVES\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_password \"$SLAVE_ETTV_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_netblast $ETTV_NETBLAST" >> $BASEPATH/etmain/server.cfg
echo "set ettv_tv_iptos $ETTV_TV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_iptos $ETTV_SV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo -e "set ettv_mtu $ETTV_MTU\n" >> $BASEPATH/etmain/server.cfg

echo "set b_crashlogpath \"$BASEPATH/etpro\"" >> $BASEPATH/etmain/server.cfg
echo "set g_log \"slave.log\"" >> $BASEPATH/etmain/server.cfg
echo -e "set logfile 2\n" >> $BASEPATH/etmain/server.cfg

echo "tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS" >> $BASEPATH/etmain/server.cfg
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

#
# Performing The magic :-)
#

case "$1" in
start)
create_config
slave_start
;;
stop)
slave_stop
clean_up
;;
restart)
$0 stop
sleep 1
$0 start
;;
sim)
create_config
echo -e "\nFollowing config was generated automatically:\n"
cat $BASEPATH/etmain/server.cfg
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop|restart|sim}"
exit 1
;;
esac
exit 0
</pre>

=== Old school record / playback script ===

This is a script to broadcast a game the old-fashioned way. It records a demo and starts playing it back after roughly 60 seconds. There's some symbolic linking stuff done inside to make sure it stores all the logs, otherwise the 'broadcaster' would override the recorder's log, ''which makes broadcasting very hard to debug'' :-)!

Copy / paste this script and save it as <code>broadcast.sh</code> or any other name you prefer. The usual comments on quit and 999 are applicable here as well. This script "should" work with ETTV earlier then b8. However, YMMV.

<pre>#!/bin/bash

#################################################################
# #
# reT!reD.ettv delayed broadcast script #
# - #
# reT!reD.deej #
# #
#################################################################
# #
# This script can be used to start up a delayed ETTV stream #
# where viewers connect directly to the broadcaster. #
# #
# This script creates a subdirectory which represents the #
# date of the match and stores the demos in this subdir. #
# #
# The script launches the daemons in different screens #
# which you can reattach with "screen -r recorder" #
# or "screen -r broadcaster". #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# - aNgel (fragland.org) for debugging Beavis' mistakes ;-) #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################
# #
# http://www.fragland.org #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# START Modifying #
# #
#################################################################
#
# Parameters of the Game Server to Connect to
#
# IMPORTANT: Let the admin of the game server do
# "fdir *.pk3" in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Today's date for creating the subdir
MATCH_HOST="et.fragland.org:27965" # Match server port & address
MATCH_ETTV_PASS="[get_pass_from_admin]" # Match server ETTV password
MATCH_PASS="[get_pass_from_admin]" # Match server password

#
# IPs & Ports For Your Host
#
THISHOST_IP=$PERONI_IP # This host is Webperoni
RECORDER_PORT="44999" # Port of the private recorder
BROADCASTER_PORT="27960" # Port of the public broadcaster

#
# Hostnames & ETTV Client name
#
# - hostname shows up in server browsers
# - ETTV client name shows up as the name
# of your server in the game server.
#
RECORDER_HOSTNAME="^7reT^1!^7reD^1.^7ettv ^7recorder ^1#^71"
BROADCASTER_HOSTNAME="^7reT^1!^7reD^1.^7ettv ^1#^71"

ETTV_CLIENT=$BROADCASTER_HOSTNAME

#
# Passwords
#
RCON_PASS="[put_your_pass_here]"
RECORDER_PASS="[put_your_pass_here]"
BROADCASTER_PRIVATE_PASS="[put_your_pass_here]"
BROADCASTER_ETTV_PASS="[put_your_pass_here]"
BROADCASTER_PASS="[put_your_pass_here]" # Issue /rcon g_password "" for opening it up to the crowd

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_brc" # Path to ettv.x86. Use absolute paths here!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1"
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400"

#
# Other relevant settings
#
SHOUTCAST_DELAY="60" # Delay between live match & broadcasting hub in seconds

BROADCASTER_SLOTS="100"
BROADCASTER_PRIVATE_SLOTS="10"
BROADCASTER_ETTV_SLAVES="0"

ALLOW_DL="1"
ALLOW_WWW_DL="1" # Allow downloading over http?
WWW_DL_URL="http://www.yoursite.org" # No "/" at the end!

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path
# where all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying #
# #
#################################################################
#
# Assembling the Command Line
#
RECORDER_HOMEPATH="$BASEPATH/$MATCH_DATE/recorder"
BROADCASTER_HOMEPATH="$BASEPATH/$MATCH_DATE/broadcaster"

BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"

RECORDER_OPTIONS="\
+set fs_game etpro \
+set dedicated 1 \
+map oasis \
+set net_ip $THISHOST_IP \
+set net_port $RECORDER_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $RECORDER_HOMEPATH \
+set com_hunkMegs 128 \
+set g_password $RECORDER_PASS \
+set rconpassword $RCON_PASS \
+set sv_hostname $RECORDER_HOSTNAME \
+set sv_maxclients 4 \
+set sv_maxRate 25000 \
+set sv_allowDownload 0 \
+set sv_wwwDownload 0 \
+set sv_wwwBaseURL "$WWW_DL_URL" \
+set sv_wwwDlDisconnected 0 \
+set g_log "recorder.log" \
+set logfile 2 \
+set b_ettv_flags 3 \
+set ettv_sv_maxslaves 2 \
+set ettv_clientname $ETTV_CLIENT \
+set ettv_password $BROADCASTER_ETTV_PASS \
+set ettv_netblast $ETTV_NETBLAST \
+set ettv_tv_iptos $ETTV_TV_IPTOS \
+set ettv_sv_iptos $ETTV_SV_IPTOS \
+set ettv_mtu $ETTV_MTU \
+set ettv_autorecord 1 \
+set ettv_delay 1 \
+tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS"

BROADCASTER_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set net_ip $THISHOST_IP \
+set net_port $BROADCASTER_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $BROADCASTER_HOMEPATH \
+set com_hunkMegs 160 \
+set sv_maxclients $BROADCASTER_SLOTS \
+set sv_privateclients $BROADCASTER_PRIVATE_SLOTS \
+set sv_privatepassword $BROADCASTER_PRIVATE_PASS \
+set sv_hostname $BROADCASTER_HOSTNAME \
+set g_password $BROADCASTER_PASS \
+set rconpassword $RCON_PASS \
+set sv_maxRate 18000 \
+set sv_allowDownload $ALLOW_DL \
+set sv_wwwDownload $ALLOW_WWW_DL \
+set sv_wwwBaseURL "$WWW_DL_URL" \
+set sv_wwwDlDisconnected 0 \
+set g_log "broadcaster.log" \
+set logfile 2 \
+set ettv_autoplay 1 \
+set ettv_password $BROADCASTER_ETTV_PASS \
+set b_ettv_flags 3 \
+set ettv_sv_maxslaves $BROADCASTER_ETTV_SLAVES \
+demo demo0000"

#
# Functions
#
broadcast_start (){
#
# FYI'ing the user
#
echo -e "\n"
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $RECORDER_HOMEPATH/etpro/demos/.\n"

echo -n "Starting Recorder: "
screen -dmS recorder su -m -c "$DAEMON $RECORDER_OPTIONS" - $USER
echo "done."

get_pids

echo -n "Recorder has PID "
echo -n $RECORDER_PID

echo -e ".\n\nSleeping for $SHOUTCAST_DELAY seconds."
sleep $SHOUTCAST_DELAY

mkdir "$BROADCASTER_HOMEPATH"
mkdir "$BROADCASTER_HOMEPATH/etpro"
ln -s "$RECORDER_HOMEPATH/etpro/demos" "$BROADCASTER_HOMEPATH/etpro"
chown -R $USER "$BROADCASTER_HOMEPATH"
chmod -R 775 "$BROADCASTER_HOMEPATH"

echo -n "Starting Broadcaster: "
screen -dmS broadcaster su -m -c "$DAEMON $BROADCASTER_OPTIONS" - $USER
echo -e "done.\n"

echo -e "Getting PIDs...\n"
sleep 1

get_pids

echo -n "Recorder has PID "
echo -n $RECORDER_PID
echo -e ".\n\nBroadcaster has PID "
echo -e "$BROADCASTER_PID.\n"
}

broadcast_stop (){

get_pids

echo -n "Shutting Down Broadcaster: "
sleep 1
if [ $BROADCASTER_PID ]
then
kill -3 $BROADCASTER_PID
echo -e "done."
else
echo -e "failed.\nBroadcaster wasn't active anymore.\n"
fi

echo -n "Shutting Down Recorder: "
sleep 1
if [ $RECORDER_PID ]
then
kill -3 $RECORDER_PID
echo -e "done."
else
echo -e "failed.\nRecorder wasn't active anymore.\n"
fi

sleep 1
clean_up
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

get_pids (){
#
# Pulling some very ugly tricks here
#
RECORDER_PID=`ps aux|grep "+set net_port $RECORDER_PORT"|grep -v "su -m -c"|grep -v "SCREEN -dmS"\|awk '{ print $1 $2 }'|tr -d "$USER"`
BROADCASTER_PID=`ps aux|grep "+set net_port $BROADCASTER_PORT"|grep -v "su -m -c"|grep -v "SCREEN -dmS"|awk '{ print $1 $2 }'|tr -d "$USER"`
}

#
# Performing The magic :-)
#

case "$1" in
start)
broadcast_start
;;
stop)
broadcast_stop
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop}"
exit 1
;;
esac
exit 0
</pre>

=== Sanitization script ===

This is a script to restore an ETTV directory to the bare minimum required to broadcast matches or be a hub. It isn't a very advanced script but it gets the job done. Copy / paste this script and save it as <code>sanitize.sh</code> or any other name you prefer. Just do <code>./sanitize.sh</code> do delete all files in etmain & etpro that are not needed anymore.

''Note'': this script deletes '''everything''' it finds in the etmain and etpro directories. If you have stuff that you do not want to delete in there, add it to the ETMAIN_FILES & ETPRO_FILES arrays.

<pre>#!/bin/bash

#################################################################
# #
# ettv clean-up script #
# - #
# deej. #
# #
#################################################################
# #
# This script is used to restore an ETTV directory to the bare #
# minimum in terms of files. #
# #
# Use it to clean up after an ETTV session so you can start the #
# next session with a minimum of PK3s. #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################

ETMAIN_FILES=(\
"description.txt" \
"hunkusage.dat" \
"mp_bin.pk3" \
"pak0.pk3" \
"pak1.pk3" \
"pak2.pk3" \
"et_ice.pk3" \
"braundorf_b4.pk3" \
"supplydepot2.pk3" \
"sw_goldrush_te.pk3" \
"sw_oasis_b3.pk3")

ETPRO_FILES=(\
"etpro-3_2_4.pk3" \
"etpro_cheats.dat" \
"qagame.mp.i386.so" \
"tvgame.mp.i386.so")

SCRIPT_NAME=`basename $0`

case $1 in
hub)
BASEPATH="/srv/et/ETTV/ettv_hub"
;;
slave)
BASEPATH="/srv/et/ETTV/ettv_slave"
;;
*)
echo -e "\nError: $1 is not a valid installation target."
echo -e "Usage: $SCRIPT_NAME {hub|slave}\n"
exit 1
esac

#
# Test for existence of backup directories
#
if [ ! -d "$BASEPATH/etmain/bak/" ]; then
mkdir "$BASEPATH/etmain/bak"
fi

if [ ! -d "$BASEPATH/etpro/bak/" ]; then
mkdir "$BASEPATH/etpro/bak"
fi

#
# Clear etmain
#
for i in ${ETMAIN_FILES[@]}
do
mv "$BASEPATH/etmain/$i" "$BASEPATH/etmain/bak/"
done
rm $BASEPATH/etmain/*

#
# Clear etpro
#
for i in ${ETPRO_FILES[@]}
do
mv "$BASEPATH/etpro/$i" "$BASEPATH/etpro/bak/"
done
rm $BASEPATH/etpro/*

#
# Restore etmain
#
for i in ${ETMAIN_FILES[@]}
do
mv "$BASEPATH/etmain/bak/$i" "$BASEPATH/etmain/"
done

#
# Restore etpro
#
for i in ${ETPRO_FILES[@]}
do
mv "$BASEPATH/etpro/bak/$i" "$BASEPATH/etpro/"
done

#
# Clean the backup directories
#
rm -Rf $BASEPATH/etmain/bak
rm -Rf $BASEPATH/etpro/bak
</pre>

=== Switching beta's script ===

This script allows you to quickly switch between the different beta's Bani has released. Just save it as <code>switchbeta.sh</code> and adapt the directory fields to your setup. Usage example: <code>./switchbeta.sh 9 hub</code> switches the hub to beta 9. <code>./switchbeta.sh 4 all</code> switches hub & slave (or others you can define of course) back to beta 4.

<pre>#!/bin/bash

#################################################################
# #
# switching ettv betas script #
# - #
# deej. #
# #
#################################################################
# #
# This script allows you to easily switch ETTV beta versions. #
# #
# Just put the ettv-beta[x].zip files in directory $REPODIR, #
# adapt settings for hub & slave and start switching! #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################

#
# Paths & files
#
REPODIR="/srv/et" # Where the ettv-betaX.zip files reside
HUB_DIR="/srv/et/ETTV/ettv_hub"
SLAVE_DIR="/srv/et/ETTV/ettv_slave"

#
# Argument check
#
SCRIPT_NAME=`basename $0`
ARGS=2
E_BADARGS=65

if [ $# -lt "$ARGS" ]
then
echo -e "\nError: missing arguments"
echo -e "Usage: $SCRIPT_NAME {beta number} {hub|slave|broadcast|all}\n"
exit $E_BADARGS
fi

FILENAME="ettv-beta$1.zip"

if [ ! -e "$REPODIR/$FILENAME" ]
then
echo -e "\nError: beta version $1 is not present in $REPODIR."
echo -e "Usage: $SCRIPT_NAME {beta number} {hub|slave|all}\n"
exit $E_BADARGS
fi

case $2 in
hub)
unzip -o "$REPODIR/$FILENAME" -d "$HUB_DIR" ettv.x86
chmod +x "$HUB_DIR/ettv.x86"
unzip -o "$REPODIR/$FILENAME" -d "$HUB_DIR/etpro" tvgame.mp.i386.so
;;
slave)
unzip -o "$REPODIR/$FILENAME" -d "$SLAVE_DIR" ettv.x86
chmod +x "$SLAVE_DIR/ettv.x86"
unzip -o "$REPODIR/$FILENAME" -d "$SLAVE_DIR/etpro" tvgame.mp.i386.so
;;
all)
$0 hub
$0 slave
;;
*)
echo -e "\nError: $2 is not a valid installation target."
echo -e "Usage: $SCRIPT_NAME {beta number} {hub|slave|all}\n"
exit $E_BADARGS
esac
exit 0
</pre>

Have fun broadcasting!

[[User:Deej|deej]] 01:46, 3 January 2006 (PST)

[[Category:ETTV]]

User:Deej

2006-01-03T09:51:23Z

Deej: /* Slave script */

http://www.fragland.org/deej/572.gif 
Guilty for founding the [http://www.fragland.org Retired Old Farts] which provide: 
- ETPro servers 
- ETTV servers 
- ETPub servers 
- General annoyance 
- Pub requests for a competition mod 

== My interpretation of ETTV setups ==

Since I'm quite fond of toying around with new developments, I'm always one of the first to test new ETTV / ETPro releases and bug bani with questions about them. Having said that, here's my 'personal' view on a good ETTV broadcast (this is not the Bible!):

=== Terminology ===

There are 5 different "participants" possibly involved in an ETTV broadcast:

* '''Master''' - the gameserver hosting the actual game
* '''Viewer''' - the viewer wanting to view a game (duh)
* '''Broadcaster''' - a server that is directly connected to a gameserver and allows viewer to connect directly to itself
* '''Hub''' - a server that is directly connected to a gameserver and allows other ETTV 'slaves' to connect to itself, but not viewers
* '''Slave''' - a server that connects to a hub or perhaps a broadcaster and and allows viewers to connect to itself

Keep this terminology in mind when you stroll through my text ;-).

=== Today's broadcasts ===

Most ETTV games I see today use this set-up:

:<code>Viewer -> Broadcaster -> Master</code>

If you remember that an ETTV server connects at an ''unlimited rate'' to another server, and as from ETTV b9 the slaves are in fact not limited at all by the original ET netcode, you might see a problem arising when lots of people would like to see a "big match".

The trouble was / is that before ETTV b8 and 'autodelay', we had to do some fancy flying to get a delayed broadcast or delayed hub up. Usually you would start a 'recorder' daemon that recorded demos and a 'playback' daemon from that same directory, so that it started playing back the recorded demo after roughly 60 or 90 seconds. This does require fancy scripting and lots of manual work to sort out demos, connect slaves to hubs etc...

With <code>ettv_autodelay</code>, things have become a lot easier. Ideally the gameserver now only allows 2 or 4 ETTV hubs to connect to it, which delay and relay the signal. The responsibility for the admins of the hub is of course greater as they should not have any PK3s active on their hubs that are not on the pure list of the server. The less PK3s you need, the better!

=== Deej's proposition ===

The best setup IMHO is to have the following:

<pre>Viewers -> Slave 1 |
Viewers -> Slave 2 |
Viewers -> Slave 3 |--> Hub 1 |
|--> Hub 2 | --> Master
Viewers -> Slave ... |--> Hub n |
|
Viewers -> Slave n |</pre>

This alleviates the load on the Master Game Server firmly as only 2 or 4 hubs are required where slaves can then connect to! Furthermore with autodelay all the 'slave' administrators only need to connect their slave to a given hub. No more playing around with delays, demos, symbolic links, PIDs that get screwed up etc...

== Some scripts I use ==

=== Hub script ===

This script launches a hub that delays its feed by x seconds, configurable inside the script. You can safely remove the stuff like PERONI_IP, FRAGLAND_IP etc... at the beginning since those only store the IPs of the root servers we manage (it's easier for me to keep track of them that way).

'''How do you use this script?''' Copy / paste this script and save it as <code>hub.sh</code> or any other name you prefer. Then use <code>./hub.sh start</code> to start and <code>./hub.sh stop</code> to stop your hub. The script generates the server.cfg dynamically every time you start it. If you just want to generate server.cfg do <code>./hub.sh sim</code>.

Be aware that it's much better to actually do "quit" in the console of your hub instead of <code>./hub.sh stop</code> as this cleanly disconnects the hub from a game server. With <code>./hub.sh stop</code> the hub stays with ping 999 on the gameserver and needs to time out. Maybe we should ask Bani to improve POSIX signal interpretation of the ETTV binary :-).

<pre>#!/bin/bash

#################################################################
# #
# ettv delayed hub script #
# - #
# deej. #
# #
#################################################################
# #
# This script can be used to start up a delayed ETTV stream #
# where ETTV slaves connect to the hub to relay the signal. #
# #
# The daemon serves as a hub for other ETTV slaves to connect #
# to and as such alleviate the load on the game server hosting #
# the match. #
# #
# This script creates a subdirectory which represents the #
# date of the match and stores the demos in this subdir. #
# #
# The script generates etmain/server.cfg dynamically. #
# #
# The script launches the daemon in a different screen #
# which you can reattach with "screen -r hub". #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# Start Modifying From Here #
# #
#################################################################
#
# Parameters of the Game Server to Connect to
#
# IMPORTANT: Let the admin of the game server do
# "fdir *.pk3" in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Do NOT modify
MATCH_HOST="et.fragland.org:27965" # Match server port & address
MATCH_ETTV_PASS="[get_pass_from_admin]" # Match server ETTV password
MATCH_PASS="[get_pass_from_admin]" # Match server password

MATCH_HOME_TEAM="uQ" # Making our hostname more fancy ;-)
MATCH_AWAY_TEAM="Logitech"
MATCH_CUP="Warleagues"

#
# IPs & Ports For Your Host
#
HUB_IP="$PERONI_IP" # This host is Webperoni
HUB_PORT="30000" # Port of public hub for ETTV slaves

#
# Hostnames & ETTV Client name
#
# - hostname shows up in server browsers
# - ETTV client name shows up as the name
# of your server in the game server.
#
ETTV_CLIENT="^7reT^1!^7reD^1.^7ettv ^7hub ^1#^71"
HUB_HOSTNAME="$ETTV_CLIENT - ^3$MATCH_CUP^7: $MATCH_HOME_TEAM vs $MATCH_AWAY_TEAM"

#
# Passwords
#
HUB_RCON_PASS="[put_your_pass_here]"
HUB_PRIVATE_PASS="[put_your_pass_here]"
HUB_ETTV_PASS="[put_your_pass_here]"
HUB_PASS="[put_your_pass_here]"

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_hub" # Use absolute paths here!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1"
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400"

#
# Other relevant ETTV settings
#
HUB_DELAY="1" # Delay between live match & hub in seconds
HUB_SLAVES="8" # 1 ETTV slave connects at an UNLIMITED rate!
HUB_PRIVATE_SLOTS="0"

RECORD_GAME="1" # Record the game?

ALLOW_DL="0" # Slaves don't download from the hub
ALLOW_WWW_DL="0"
WWW_DL_URL="http://www.yoursite.com"

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path where
# all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying Here #
# #
#################################################################
#
# Make sure buffers are high enough!
#
echo "524288" > /proc/sys/net/core/rmem_max
echo "524288" > /proc/sys/net/core/wmem_max

#
# Assembling the Command Line
#
BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"
HOMEPATH="$BASEPATH/$MATCH_DATE"

HUB_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set net_ip $HUB_IP \
+set net_port $HUB_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $HOMEPATH \
+set com_hunkMegs 128 \
+set sv_maxclients $HUB_SLAVES \
+exec server.cfg"

#
# Functions
#

hub_start () {
#
# FYI'ing the user
#
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $HOMEPATH/etpro/demos/.\n"

echo -n "Starting Hub: "
screen -dmS hub su -m -c "$DAEMON $HUB_OPTIONS" - $USER
sleep 1
echo -e "done.\n"

echo -e "Getting PID...\n"

get_pids

echo -n "Hub has PID "
echo -e "$HUB_PID\n"

echo "ETTV slaves can now connect to your box by issuing:"
echo -e "tv connect $HUB_IP:$HUB_PORT $HUB_ETTV_PASS $HUB_PASS\n"
}

hub_stop () {
#
# Refresh the PIDs
#
get_pids

echo -n "Shutting Down Hub: "
sleep 1
if [ -n $HUB_PID ]
then
kill -SIGTERM $HUB_PID
echo -e "done."
else
echo -e "failed.\nHub wasn't active anymore.\n"
fi

sleep 1
}

create_config (){
#
# Generate etmain/server.cfg
#
TIMESTAMP=`date +"%d/%m/%Y %H:%M:%S"`

echo "//" > $BASEPATH/etmain/server.cfg
echo "// server.cfg generated $TIMESTAMP" >> $BASEPATH/etmain/server.cfg
echo -e "//\n" >> $BASEPATH/etmain/server.cfg

echo "set sv_privateclients $HUB_PRIVATE_SLOTS" >> $BASEPATH/etmain/server.cfg
echo "set sv_maxRate 25000" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_hostname \"$HUB_HOSTNAME\"\n" >> $BASEPATH/etmain/server.cfg

echo "set g_password \"$HUB_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set rconpassword \"$HUB_RCON_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_privatepassword \"$HUB_PRIVATE_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_allowDownload $ALLOW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwDownload $ALLOW_WWW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwBaseURL \"$WWW_DL_URL\"" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_wwwDlDisconnected 0\n" >> $BASEPATH/etmain/server.cfg

echo "set b_ettv_flags 3" >> $BASEPATH/etmain/server.cfg
echo "set ettv_delay $HUB_DELAY" >> $BASEPATH/etmain/server.cfg
echo "set ettv_autorecord $RECORD_GAME" >> $BASEPATH/etmain/server.cfg
echo "set ettv_clientname \"$ETTV_CLIENT\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_maxslaves \"$HUB_ETTV_SLAVES\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_password \"$HUB_ETTV_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_netblast $ETTV_NETBLAST" >> $BASEPATH/etmain/server.cfg
echo "set ettv_tv_iptos $ETTV_TV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_iptos $ETTV_SV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo -e "set ettv_mtu $ETTV_MTU\n" >> $BASEPATH/etmain/server.cfg

echo "set b_crashlogpath \"$BASEPATH/etpro\"" >> $BASEPATH/etmain/server.cfg
echo "set g_log \"slave.log\"" >> $BASEPATH/etmain/server.cfg
echo -e "set logfile 2\n" >> $BASEPATH/etmain/server.cfg

echo "tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS" >> $BASEPATH/etmain/server.cfg
}

get_pids (){
#
# We used to launch the same binary twice so pidof didn't work.
# As from beta 8 ettv delayed feeds were automatic so
# no more fancy scripting tricks are required :-)
#
HUB_PID=`pidof $DAEMON`
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

#
# Performing The magic :-)
#

case "$1" in
start)
create_config
hub_start
;;
stop)
hub_stop
clean_up
;;
sim)
create_config
echo -e "\nFollowing config was generated automatically:\n"
cat $BASEPATH/etmain/server.cfg
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop|sim}"
exit 1
;;
esac
exit 0
</pre>

=== Slave script ===

This script connects a delayed or undelayed slave to a Hub or directly to a gameserver. The usage of this script is very similar to the Hub script. Copy / paste it and save it as <code>slave.sh</code> or any other name you prefer. Then issue <code>./slave.sh start</code> to start your slave and <code>./slave.sh stop</code> to stop it. Use <code>./slave.sh sim</code> to only create etmain/server.cfg. Like above, it is actually better to do quit in the console instead of just killing the slave with this script.

<pre>#!/bin/bash

#################################################################
# #
# ETTV slave script #
# - #
# deej. #
# #
#################################################################
# #
# This script can be used to start up an ETTV slave to connect #
# to an ETTV HUB or directly to a game server. #
# #
# The script generates etmain/server.cfg dynamically. #
# #
# This script launches the daemon in a different screen which #
# you can reattach with "screen -r slave" #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# #
# Questions? deej@fragland.org or go to #gamestv.org #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# Start Modifying From Here #
# #
#################################################################
#
# Hub Info
#
# IMPORTANT: Let the admin of the hub do a
# fdir *.pk3 in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Do NOT modify
MATCH_HOST="et.fragland.org:27965" # HUB / Match server port & address
MATCH_ETTV_PASS="[get_pass_from_admin]" # HUB / Match server ETTV password
MATCH_PASS="[get_pass_from_admin]" # HUB / Match server password

MATCH_HOME_TEAM="uQ" # Making our hostname more fancy ;-)
MATCH_AWAY_TEAM="Logitech"
MATCH_CUP="Warleagues"

#
# Slave Info
#
SLAVE_IP="$PERONI_IP" # This host is Peroni
SLAVE_PORT="27960" # port of public broadcaster

ETTV_CLIENT="^7reT^1!^7reD^1.^7ettv ^1#^71" # shows up on the Hub
SLAVE_HOSTNAME="$ETTV_CLIENT - ^3$MATCH_CUP^7: $MATCH_HOME_TEAM vs $MATCH_AWAY_TEAM"

SLAVE_SLOTS="100"
SLAVE_PASS="[put_your_pass_here]"

SLAVE_PRIVATE_SLOTS="20"
SLAVE_PRIVATE_PASS="[put_your_pass_here]"

SLAVE_ETTV_SLAVES="5" # Allow chaining?
SLAVE_ETTV_PASS="[put_your_pass_here]"

SLAVE_RCON_PASS="[put_your_pass_here]"

RECORD_GAME="1" # 1 = record game, 0 = don't
SLAVE_DELAY="60" # Time in seconds

REDIRECT="Server is full" # Message displayed when server is full
#REDIRECT="ET://ettv2.fragland.org:27960" # Allows redirecting to other ettv's

#
# Downloading
#
ALLOW_DL="1" # Can clients download stuff?
ALLOW_WWW_DL="1" # Allow downloading over http?
WWW_DL_URL="http://www.fragland.org/maps" # No "/" at the end!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1"
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400"

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_slave" # Path to ettv.x86
# Use absolute paths here!

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path where
# all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying Here #
# #
#################################################################
#
# Make sure buffers are ok!
#
echo "524288" > /proc/sys/net/core/rmem_max
echo "524288" > /proc/sys/net/core/wmem_max

#
# Assembling the Command Line
#
BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"
HOMEPATH="$BASEPATH/$MATCH_DATE"

SLAVE_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set com_hunkMegs 256 \
+set net_ip $SLAVE_IP \
+set net_port $SLAVE_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $HOMEPATH \
+set sv_maxclients $SLAVE_SLOTS \
+exec server.cfg"

#
# Functions
#

slave_start (){
#
# FYI the user
#
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $HOMEPATH/etpro/demos/.\n"

#
# Start the slave
#
echo -n "Starting Slave: "

screen -dmS slave su -m -c "$DAEMON $SLAVE_OPTIONS" - $USER

echo -e "done.\n"

echo -e "Getting PID...\n"
sleep 1

SLAVE_PID=`pidof $DAEMON`

echo -n "Slave has PID "
echo -e "$SLAVE_PID.\n"

if [ $SLAVE_ETTV_SLAVES != 0 ]
then
echo "ETTV slaves can now connect to your box by issuing:"
echo -e "tv connect $SLAVE_IP:$SLAVE_PORT $SLAVE_ETTV_PASS $SLAVE_PASS\n"
fi
}

slave_stop (){
#
# Refresh the PID
#
SLAVE_PID=`pidof $DAEMON`

echo -n "Shutting Down Slave: "
sleep 1
if [ $SLAVE_PID ]
then
kill -SIGTERM $SLAVE_PID
echo -e "done."
else
echo -e "failed.\nSlave wasn't active anymore.\n"
fi
}

create_config (){
#
# Generate etmain/server.cfg
#
TIMESTAMP=`date +"%d/%m/%Y %H:%M:%S"`

echo "//" > $BASEPATH/etmain/server.cfg
echo "// server.cfg generated $TIMESTAMP" >> $BASEPATH/etmain/server.cfg
echo -e "//\n" >> $BASEPATH/etmain/server.cfg

echo "set sv_privateclients $SLAVE_PRIVATE_SLOTS" >> $BASEPATH/etmain/server.cfg
echo "set sv_maxRate 25000" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_hostname \"$SLAVE_HOSTNAME\"\n" >> $BASEPATH/etmain/server.cfg

echo "set g_password \"$SLAVE_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set rconpassword \"$SLAVE_RCON_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_privatepassword \"$SLAVE_PRIVATE_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_allowDownload $ALLOW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwDownload $ALLOW_WWW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwBaseURL \"$WWW_DL_URL\"" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_wwwDlDisconnected 0\n" >> $BASEPATH/etmain/server.cfg

echo "set b_ettv_flags 3" >> $BASEPATH/etmain/server.cfg
echo "set ettv_delay $SLAVE_DELAY" >> $BASEPATH/etmain/server.cfg
echo "set ettv_autorecord $RECORD_GAME" >> $BASEPATH/etmain/server.cfg
echo "set ettv_clientname \"$ETTV_CLIENT\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_maxslaves \"$SLAVE_ETTV_SLAVES\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_password \"$SLAVE_ETTV_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_netblast $ETTV_NETBLAST" >> $BASEPATH/etmain/server.cfg
echo "set ettv_tv_iptos $ETTV_TV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_iptos $ETTV_SV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo -e "set ettv_mtu $ETTV_MTU\n" >> $BASEPATH/etmain/server.cfg

echo "set b_crashlogpath \"$BASEPATH/etpro\"" >> $BASEPATH/etmain/server.cfg
echo "set g_log \"slave.log\"" >> $BASEPATH/etmain/server.cfg
echo -e "set logfile 2\n" >> $BASEPATH/etmain/server.cfg

echo "tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS" >> $BASEPATH/etmain/server.cfg
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

#
# Performing The magic :-)
#

case "$1" in
start)
create_config
slave_start
;;
stop)
slave_stop
clean_up
;;
restart)
$0 stop
sleep 1
$0 start
;;
sim)
create_config
echo -e "\nFollowing config was generated automatically:\n"
cat $BASEPATH/etmain/server.cfg
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop|restart|sim}"
exit 1
;;
esac
exit 0
</pre>

=== Old school record / playback script ===

This is a script to broadcast a game the old-fashioned way. It records a demo and starts playing it back after roughly 60 seconds. There's some symbolic linking stuff done inside to make sure it stores all the logs, otherwise the 'broadcaster' would override the recorder's log, ''which makes broadcasting very hard to debug'' :-)!

Copy / paste this script and save it as <code>broadcast.sh</code> or any other name you prefer. The usual comments on quit and 999 are applicable here as well. This script "should" work with ETTV earlier then b8. However, YMMV.

<pre>#!/bin/bash

#################################################################
# #
# reT!reD.ettv delayed broadcast script #
# - #
# reT!reD.deej #
# #
#################################################################
# #
# This script can be used to start up a delayed ETTV stream #
# where viewers connect directly to the broadcaster. #
# #
# This script creates a subdirectory which represents the #
# date of the match and stores the demos in this subdir. #
# #
# The script launches the daemons in different screens #
# which you can reattach with "screen -r recorder" #
# or "screen -r broadcaster". #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# - aNgel (fragland.org) for debugging Beavis' mistakes ;-) #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################
# #
# http://www.fragland.org #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# START Modifying #
# #
#################################################################
#
# Parameters of the Game Server to Connect to
#
# IMPORTANT: Let the admin of the game server do
# "fdir *.pk3" in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Today's date for creating the subdir
MATCH_HOST="et.fragland.org:27965" # Match server port & address
MATCH_ETTV_PASS="[get_pass_from_admin]" # Match server ETTV password
MATCH_PASS="[get_pass_from_admin]" # Match server password

#
# IPs & Ports For Your Host
#
THISHOST_IP=$PERONI_IP # This host is Webperoni
RECORDER_PORT="44999" # Port of the private recorder
BROADCASTER_PORT="27960" # Port of the public broadcaster

#
# Hostnames & ETTV Client name
#
# - hostname shows up in server browsers
# - ETTV client name shows up as the name
# of your server in the game server.
#
RECORDER_HOSTNAME="^7reT^1!^7reD^1.^7ettv ^7recorder ^1#^71"
BROADCASTER_HOSTNAME="^7reT^1!^7reD^1.^7ettv ^1#^71"

ETTV_CLIENT=$BROADCASTER_HOSTNAME

#
# Passwords
#
RCON_PASS="[put_your_pass_here]"
RECORDER_PASS="[put_your_pass_here]"
BROADCASTER_PRIVATE_PASS="[put_your_pass_here]"
BROADCASTER_ETTV_PASS="[put_your_pass_here]"
BROADCASTER_PASS="[put_your_pass_here]" # Issue /rcon g_password "" for opening it up to the crowd

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_brc" # Path to ettv.x86. Use absolute paths here!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1"
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400"

#
# Other relevant settings
#
SHOUTCAST_DELAY="60" # Delay between live match & broadcasting hub in seconds

BROADCASTER_SLOTS="100"
BROADCASTER_PRIVATE_SLOTS="10"
BROADCASTER_ETTV_SLAVES="0"

ALLOW_DL="1"
ALLOW_WWW_DL="1" # Allow downloading over http?
WWW_DL_URL="http://www.yoursite.org" # No "/" at the end!

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path
# where all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying #
# #
#################################################################
#
# Assembling the Command Line
#
RECORDER_HOMEPATH="$BASEPATH/$MATCH_DATE/recorder"
BROADCASTER_HOMEPATH="$BASEPATH/$MATCH_DATE/broadcaster"

BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"

RECORDER_OPTIONS="\
+set fs_game etpro \
+set dedicated 1 \
+map oasis \
+set net_ip $THISHOST_IP \
+set net_port $RECORDER_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $RECORDER_HOMEPATH \
+set com_hunkMegs 128 \
+set g_password $RECORDER_PASS \
+set rconpassword $RCON_PASS \
+set sv_hostname $RECORDER_HOSTNAME \
+set sv_maxclients 4 \
+set sv_maxRate 25000 \
+set sv_allowDownload 0 \
+set sv_wwwDownload 0 \
+set sv_wwwBaseURL "$WWW_DL_URL" \
+set sv_wwwDlDisconnected 0 \
+set g_log "recorder.log" \
+set logfile 2 \
+set b_ettv_flags 3 \
+set ettv_sv_maxslaves 2 \
+set ettv_clientname $ETTV_CLIENT \
+set ettv_password $BROADCASTER_ETTV_PASS \
+set ettv_netblast $ETTV_NETBLAST \
+set ettv_tv_iptos $ETTV_TV_IPTOS \
+set ettv_sv_iptos $ETTV_SV_IPTOS \
+set ettv_mtu $ETTV_MTU \
+set ettv_autorecord 1 \
+set ettv_delay 1 \
+tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS"

BROADCASTER_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set net_ip $THISHOST_IP \
+set net_port $BROADCASTER_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $BROADCASTER_HOMEPATH \
+set com_hunkMegs 160 \
+set sv_maxclients $BROADCASTER_SLOTS \
+set sv_privateclients $BROADCASTER_PRIVATE_SLOTS \
+set sv_privatepassword $BROADCASTER_PRIVATE_PASS \
+set sv_hostname $BROADCASTER_HOSTNAME \
+set g_password $BROADCASTER_PASS \
+set rconpassword $RCON_PASS \
+set sv_maxRate 18000 \
+set sv_allowDownload $ALLOW_DL \
+set sv_wwwDownload $ALLOW_WWW_DL \
+set sv_wwwBaseURL "$WWW_DL_URL" \
+set sv_wwwDlDisconnected 0 \
+set g_log "broadcaster.log" \
+set logfile 2 \
+set ettv_autoplay 1 \
+set ettv_password $BROADCASTER_ETTV_PASS \
+set b_ettv_flags 3 \
+set ettv_sv_maxslaves $BROADCASTER_ETTV_SLAVES \
+demo demo0000"

#
# Functions
#
broadcast_start (){
#
# FYI'ing the user
#
echo -e "\n"
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $RECORDER_HOMEPATH/etpro/demos/.\n"

echo -n "Starting Recorder: "
screen -dmS recorder su -m -c "$DAEMON $RECORDER_OPTIONS" - $USER
echo "done."

get_pids

echo -n "Recorder has PID "
echo -n $RECORDER_PID

echo -e ".\n\nSleeping for $SHOUTCAST_DELAY seconds."
sleep $SHOUTCAST_DELAY

mkdir "$BROADCASTER_HOMEPATH"
mkdir "$BROADCASTER_HOMEPATH/etpro"
ln -s "$RECORDER_HOMEPATH/etpro/demos" "$BROADCASTER_HOMEPATH/etpro"
chown -R $USER "$BROADCASTER_HOMEPATH"
chmod -R 775 "$BROADCASTER_HOMEPATH"

echo -n "Starting Broadcaster: "
screen -dmS broadcaster su -m -c "$DAEMON $BROADCASTER_OPTIONS" - $USER
echo -e "done.\n"

echo -e "Getting PIDs...\n"
sleep 1

get_pids

echo -n "Recorder has PID "
echo -n $RECORDER_PID
echo -e ".\n\nBroadcaster has PID "
echo -e "$BROADCASTER_PID.\n"
}

broadcast_stop (){

get_pids

echo -n "Shutting Down Broadcaster: "
sleep 1
if [ $BROADCASTER_PID ]
then
kill -3 $BROADCASTER_PID
echo -e "done."
else
echo -e "failed.\nBroadcaster wasn't active anymore.\n"
fi

echo -n "Shutting Down Recorder: "
sleep 1
if [ $RECORDER_PID ]
then
kill -3 $RECORDER_PID
echo -e "done."
else
echo -e "failed.\nRecorder wasn't active anymore.\n"
fi

sleep 1
clean_up
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

get_pids (){
#
# Pulling some very ugly tricks here
#
RECORDER_PID=`ps aux|grep "+set net_port $RECORDER_PORT"|grep -v "su -m -c"|grep -v "SCREEN -dmS"\|awk '{ print $1 $2 }'|tr -d "$USER"`
BROADCASTER_PID=`ps aux|grep "+set net_port $BROADCASTER_PORT"|grep -v "su -m -c"|grep -v "SCREEN -dmS"|awk '{ print $1 $2 }'|tr -d "$USER"`
}

#
# Performing The magic :-)
#

case "$1" in
start)
broadcast_start
;;
stop)
broadcast_stop
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop}"
exit 1
;;
esac
exit 0
</pre>

=== Sanitization script ===

This is a script to restore an ETTV directory to the bare minimum required to broadcast matches or be a hub. It isn't a very advanced script but it gets the job done. Copy / paste this script and save it as <code>sanitize.sh</code> or any other name you prefer. Just do <code>./sanitize.sh</code> do delete all files in etmain & etpro that are not needed anymore.

''Note'': this script deletes '''everything''' it finds in the etmain and etpro directories. If you have stuff that you do not want to delete in there, add it to the ETMAIN_FILES & ETPRO_FILES arrays.

<pre>#!/bin/bash

#################################################################
# #
# ettv clean-up script #
# - #
# deej. #
# #
#################################################################
# #
# This script is used to restore an ETTV directory to the bare #
# minimum in terms of files. #
# #
# Use it to clean up after an ETTV session so you can start the #
# next session with a minimum of PK3s. #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################

ETMAIN_FILES=(\
"description.txt" \
"hunkusage.dat" \
"mp_bin.pk3" \
"pak0.pk3" \
"pak1.pk3" \
"pak2.pk3" \
"et_ice.pk3" \
"braundorf_b4.pk3" \
"supplydepot2.pk3" \
"sw_goldrush_te.pk3" \
"sw_oasis_b3.pk3")

ETPRO_FILES=(\
"etpro-3_2_4.pk3" \
"etpro_cheats.dat" \
"qagame.mp.i386.so" \
"tvgame.mp.i386.so")

SCRIPT_NAME=`basename $0`

case $1 in
hub)
BASEPATH="/srv/et/ETTV/ettv_hub"
;;
slave)
BASEPATH="/srv/et/ETTV/ettv_slave"
;;
*)
echo -e "\nError: $1 is not a valid installation target."
echo -e "Usage: $SCRIPT_NAME {hub|slave}\n"
exit 1
esac

#
# Test for existence of backup directories
#
if [ ! -d "$BASEPATH/etmain/bak/" ]; then
mkdir "$BASEPATH/etmain/bak"
fi

if [ ! -d "$BASEPATH/etpro/bak/" ]; then
mkdir "$BASEPATH/etpro/bak"
fi

#
# Clear etmain
#
for i in ${ETMAIN_FILES[@]}
do
mv "$BASEPATH/etmain/$i" "$BASEPATH/etmain/bak/"
done
rm $BASEPATH/etmain/*

#
# Clear etpro
#
for i in ${ETPRO_FILES[@]}
do
mv "$BASEPATH/etpro/$i" "$BASEPATH/etpro/bak/"
done
rm $BASEPATH/etpro/*

#
# Restore etmain
#
for i in ${ETMAIN_FILES[@]}
do
mv "$BASEPATH/etmain/bak/$i" "$BASEPATH/etmain/"
done

#
# Restore etpro
#
for i in ${ETPRO_FILES[@]}
do
mv "$BASEPATH/etpro/bak/$i" "$BASEPATH/etpro/"
done

#
# Clean the backup directories
#
rm -Rf $BASEPATH/etmain/bak
rm -Rf $BASEPATH/etpro/bak
</pre>

=== Switching beta's script ===

This script allows you to quickly switch between the different beta's Bani has released. Just save it as <code>switchbeta.sh</code> and adapt the directory fields to your setup. Usage example: <code>./switchbeta.sh 9 hub</code> switches the hub to beta 9. <code>./switchbeta.sh 4 all</code> switches hub & slave (or others you can define of course) back to beta 4.

<pre>#!/bin/bash

#################################################################
# #
# switching ettv betas script #
# - #
# deej. #
# #
#################################################################
# #
# This script allows you to easily switch ETTV beta versions. #
# #
# Just put the ettv-beta[x].zip files in directory $REPODIR, #
# adapt settings for hub & slave and start switching! #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################

#
# Paths & files
#
REPODIR="/srv/et" # Where the ettv-betaX.zip files reside
HUB_DIR="/srv/et/ETTV/ettv_hub"
SLAVE_DIR="/srv/et/ETTV/ettv_slave"

#
# Argument check
#
SCRIPT_NAME=`basename $0`
ARGS=2
E_BADARGS=65

if [ $# -lt "$ARGS" ]
then
echo -e "\nError: missing arguments"
echo -e "Usage: $SCRIPT_NAME {beta number} {hub|slave|broadcast|all}\n"
exit $E_BADARGS
fi

FILENAME="ettv-beta$1.zip"

if [ ! -e "$REPODIR/$FILENAME" ]
then
echo -e "\nError: beta version $1 is not present in $REPODIR."
echo -e "Usage: $SCRIPT_NAME {beta number} {hub|slave|all}\n"
exit $E_BADARGS
fi

case $2 in
hub)
unzip -o "$REPODIR/$FILENAME" -d "$HUB_DIR" ettv.x86
chmod +x "$HUB_DIR/ettv.x86"
unzip -o "$REPODIR/$FILENAME" -d "$HUB_DIR/etpro" tvgame.mp.i386.so
;;
slave)
unzip -o "$REPODIR/$FILENAME" -d "$SLAVE_DIR" ettv.x86
chmod +x "$SLAVE_DIR/ettv.x86"
unzip -o "$REPODIR/$FILENAME" -d "$SLAVE_DIR/etpro" tvgame.mp.i386.so
;;
all)
$0 hub
$0 slave
;;
*)
echo -e "\nError: $2 is not a valid installation target."
echo -e "Usage: $SCRIPT_NAME {beta number} {hub|slave|all}\n"
exit $E_BADARGS
esac
exit 0
</pre>

Have fun broadcasting!

[[User:Deej|deej]] 01:46, 3 January 2006 (PST)

[[Category:ETTV]]

User:Deej

2006-01-03T09:46:26Z

Deej: /* Switching beta's script */

http://www.fragland.org/deej/572.gif 
Guilty for founding the [http://www.fragland.org Retired Old Farts] which provide: 
- ETPro servers 
- ETTV servers 
- ETPub servers 
- General annoyance 
- Pub requests for a competition mod 

== My interpretation of ETTV setups ==

Since I'm quite fond of toying around with new developments, I'm always one of the first to test new ETTV / ETPro releases and bug bani with questions about them. Having said that, here's my 'personal' view on a good ETTV broadcast (this is not the Bible!):

=== Terminology ===

There are 5 different "participants" possibly involved in an ETTV broadcast:

* '''Master''' - the gameserver hosting the actual game
* '''Viewer''' - the viewer wanting to view a game (duh)
* '''Broadcaster''' - a server that is directly connected to a gameserver and allows viewer to connect directly to itself
* '''Hub''' - a server that is directly connected to a gameserver and allows other ETTV 'slaves' to connect to itself, but not viewers
* '''Slave''' - a server that connects to a hub or perhaps a broadcaster and and allows viewers to connect to itself

Keep this terminology in mind when you stroll through my text ;-).

=== Today's broadcasts ===

Most ETTV games I see today use this set-up:

:<code>Viewer -> Broadcaster -> Master</code>

If you remember that an ETTV server connects at an ''unlimited rate'' to another server, and as from ETTV b9 the slaves are in fact not limited at all by the original ET netcode, you might see a problem arising when lots of people would like to see a "big match".

The trouble was / is that before ETTV b8 and 'autodelay', we had to do some fancy flying to get a delayed broadcast or delayed hub up. Usually you would start a 'recorder' daemon that recorded demos and a 'playback' daemon from that same directory, so that it started playing back the recorded demo after roughly 60 or 90 seconds. This does require fancy scripting and lots of manual work to sort out demos, connect slaves to hubs etc...

With <code>ettv_autodelay</code>, things have become a lot easier. Ideally the gameserver now only allows 2 or 4 ETTV hubs to connect to it, which delay and relay the signal. The responsibility for the admins of the hub is of course greater as they should not have any PK3s active on their hubs that are not on the pure list of the server. The less PK3s you need, the better!

=== Deej's proposition ===

The best setup IMHO is to have the following:

<pre>Viewers -> Slave 1 |
Viewers -> Slave 2 |
Viewers -> Slave 3 |--> Hub 1 |
|--> Hub 2 | --> Master
Viewers -> Slave ... |--> Hub n |
|
Viewers -> Slave n |</pre>

This alleviates the load on the Master Game Server firmly as only 2 or 4 hubs are required where slaves can then connect to! Furthermore with autodelay all the 'slave' administrators only need to connect their slave to a given hub. No more playing around with delays, demos, symbolic links, PIDs that get screwed up etc...

== Some scripts I use ==

=== Hub script ===

This script launches a hub that delays its feed by x seconds, configurable inside the script. You can safely remove the stuff like PERONI_IP, FRAGLAND_IP etc... at the beginning since those only store the IPs of the root servers we manage (it's easier for me to keep track of them that way).

'''How do you use this script?''' Copy / paste this script and save it as <code>hub.sh</code> or any other name you prefer. Then use <code>./hub.sh start</code> to start and <code>./hub.sh stop</code> to stop your hub. The script generates the server.cfg dynamically every time you start it. If you just want to generate server.cfg do <code>./hub.sh sim</code>.

Be aware that it's much better to actually do "quit" in the console of your hub instead of <code>./hub.sh stop</code> as this cleanly disconnects the hub from a game server. With <code>./hub.sh stop</code> the hub stays with ping 999 on the gameserver and needs to time out. Maybe we should ask Bani to improve POSIX signal interpretation of the ETTV binary :-).

<pre>#!/bin/bash

#################################################################
# #
# ettv delayed hub script #
# - #
# deej. #
# #
#################################################################
# #
# This script can be used to start up a delayed ETTV stream #
# where ETTV slaves connect to the hub to relay the signal. #
# #
# The daemon serves as a hub for other ETTV slaves to connect #
# to and as such alleviate the load on the game server hosting #
# the match. #
# #
# This script creates a subdirectory which represents the #
# date of the match and stores the demos in this subdir. #
# #
# The script generates etmain/server.cfg dynamically. #
# #
# The script launches the daemon in a different screen #
# which you can reattach with "screen -r hub". #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# Start Modifying From Here #
# #
#################################################################
#
# Parameters of the Game Server to Connect to
#
# IMPORTANT: Let the admin of the game server do
# "fdir *.pk3" in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Do NOT modify
MATCH_HOST="et.fragland.org:27965" # Match server port & address
MATCH_ETTV_PASS="[get_pass_from_admin]" # Match server ETTV password
MATCH_PASS="[get_pass_from_admin]" # Match server password

MATCH_HOME_TEAM="uQ" # Making our hostname more fancy ;-)
MATCH_AWAY_TEAM="Logitech"
MATCH_CUP="Warleagues"

#
# IPs & Ports For Your Host
#
HUB_IP="$PERONI_IP" # This host is Webperoni
HUB_PORT="30000" # Port of public hub for ETTV slaves

#
# Hostnames & ETTV Client name
#
# - hostname shows up in server browsers
# - ETTV client name shows up as the name
# of your server in the game server.
#
ETTV_CLIENT="^7reT^1!^7reD^1.^7ettv ^7hub ^1#^71"
HUB_HOSTNAME="$ETTV_CLIENT - ^3$MATCH_CUP^7: $MATCH_HOME_TEAM vs $MATCH_AWAY_TEAM"

#
# Passwords
#
HUB_RCON_PASS="[put_your_pass_here]"
HUB_PRIVATE_PASS="[put_your_pass_here]"
HUB_ETTV_PASS="[put_your_pass_here]"
HUB_PASS="[put_your_pass_here]"

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_hub" # Use absolute paths here!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1"
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400"

#
# Other relevant ETTV settings
#
HUB_DELAY="1" # Delay between live match & hub in seconds
HUB_SLAVES="8" # 1 ETTV slave connects at an UNLIMITED rate!
HUB_PRIVATE_SLOTS="0"

RECORD_GAME="1" # Record the game?

ALLOW_DL="0" # Slaves don't download from the hub
ALLOW_WWW_DL="0"
WWW_DL_URL="http://www.yoursite.com"

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path where
# all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying Here #
# #
#################################################################
#
# Make sure buffers are high enough!
#
echo "524288" > /proc/sys/net/core/rmem_max
echo "524288" > /proc/sys/net/core/wmem_max

#
# Assembling the Command Line
#
BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"
HOMEPATH="$BASEPATH/$MATCH_DATE"

HUB_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set net_ip $HUB_IP \
+set net_port $HUB_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $HOMEPATH \
+set com_hunkMegs 128 \
+set sv_maxclients $HUB_SLAVES \
+exec server.cfg"

#
# Functions
#

hub_start () {
#
# FYI'ing the user
#
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $HOMEPATH/etpro/demos/.\n"

echo -n "Starting Hub: "
screen -dmS hub su -m -c "$DAEMON $HUB_OPTIONS" - $USER
sleep 1
echo -e "done.\n"

echo -e "Getting PID...\n"

get_pids

echo -n "Hub has PID "
echo -e "$HUB_PID\n"

echo "ETTV slaves can now connect to your box by issuing:"
echo -e "tv connect $HUB_IP:$HUB_PORT $HUB_ETTV_PASS $HUB_PASS\n"
}

hub_stop () {
#
# Refresh the PIDs
#
get_pids

echo -n "Shutting Down Hub: "
sleep 1
if [ -n $HUB_PID ]
then
kill -SIGTERM $HUB_PID
echo -e "done."
else
echo -e "failed.\nHub wasn't active anymore.\n"
fi

sleep 1
}

create_config (){
#
# Generate etmain/server.cfg
#
TIMESTAMP=`date +"%d/%m/%Y %H:%M:%S"`

echo "//" > $BASEPATH/etmain/server.cfg
echo "// server.cfg generated $TIMESTAMP" >> $BASEPATH/etmain/server.cfg
echo -e "//\n" >> $BASEPATH/etmain/server.cfg

echo "set sv_privateclients $HUB_PRIVATE_SLOTS" >> $BASEPATH/etmain/server.cfg
echo "set sv_maxRate 25000" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_hostname \"$HUB_HOSTNAME\"\n" >> $BASEPATH/etmain/server.cfg

echo "set g_password \"$HUB_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set rconpassword \"$HUB_RCON_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_privatepassword \"$HUB_PRIVATE_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_allowDownload $ALLOW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwDownload $ALLOW_WWW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwBaseURL \"$WWW_DL_URL\"" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_wwwDlDisconnected 0\n" >> $BASEPATH/etmain/server.cfg

echo "set b_ettv_flags 3" >> $BASEPATH/etmain/server.cfg
echo "set ettv_delay $HUB_DELAY" >> $BASEPATH/etmain/server.cfg
echo "set ettv_autorecord $RECORD_GAME" >> $BASEPATH/etmain/server.cfg
echo "set ettv_clientname \"$ETTV_CLIENT\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_maxslaves \"$HUB_ETTV_SLAVES\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_password \"$HUB_ETTV_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_netblast $ETTV_NETBLAST" >> $BASEPATH/etmain/server.cfg
echo "set ettv_tv_iptos $ETTV_TV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_iptos $ETTV_SV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo -e "set ettv_mtu $ETTV_MTU\n" >> $BASEPATH/etmain/server.cfg

echo "set b_crashlogpath \"$BASEPATH/etpro\"" >> $BASEPATH/etmain/server.cfg
echo "set g_log \"slave.log\"" >> $BASEPATH/etmain/server.cfg
echo -e "set logfile 2\n" >> $BASEPATH/etmain/server.cfg

echo "tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS" >> $BASEPATH/etmain/server.cfg
}

get_pids (){
#
# We used to launch the same binary twice so pidof didn't work.
# As from beta 8 ettv delayed feeds were automatic so
# no more fancy scripting tricks are required :-)
#
HUB_PID=`pidof $DAEMON`
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

#
# Performing The magic :-)
#

case "$1" in
start)
create_config
hub_start
;;
stop)
hub_stop
clean_up
;;
sim)
create_config
echo -e "\nFollowing config was generated automatically:\n"
cat $BASEPATH/etmain/server.cfg
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop|sim}"
exit 1
;;
esac
exit 0
</pre>

=== Slave script ===

This script connects a delayed or undelayed slave to a Hub or directly to a gameserver. The usage of this script is very similar to the Hub script. Copy / paste it and save it as <code>slave.sh</code> or any other name you prefer. Then issue <code>./slave.sh start</code> to start your slave and <code>./slave.sh stop</code> to stop it. Use <code>./slave.sh sim</code> to only create etmain/server.cfg. Like above, it is actually better to do quit in the console instead of just killing the slave with this script.

<pre>#!/bin/bash

#################################################################
# #
# ETTV slave script #
# - #
# deej. #
# #
#################################################################
# #
# This script can be used to start up an ETTV slave to connect #
# to an ETTV HUB or directly to a game server. #
# #
# The script generates etmain/server.cfg dynamically. #
# #
# This script launches the daemon in a different screen which #
# you can reattach with "screen -r slave" #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# #
# Questions? deej@fragland.org or go to #gamestv.org #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# Start Modifying From Here #
# #
#################################################################
#
# Hub Info
#
# IMPORTANT: Let the admin of the hub do a
# fdir *.pk3 in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Do NOT modify
MATCH_HOST="et.fragland.org:27965" # HUB / Match server port & address
MATCH_ETTV_PASS="[put_pass]" # HUB / Match server ETTV password
MATCH_PASS="[put_pass]" # HUB / Match server password

MATCH_HOME_TEAM="uQ" # Making our hostname more fancy ;-)
MATCH_AWAY_TEAM="Logitech"
MATCH_CUP="Warleagues"

#
# Slave Info
#
SLAVE_IP="$PERONI_IP" # This host is Peroni
SLAVE_PORT="27960" # port of public broadcaster

ETTV_CLIENT="^7reT^1!^7reD^1.^7ettv ^1#^71" # shows up on the Hub
SLAVE_HOSTNAME="$ETTV_CLIENT - ^3$MATCH_CUP^7: $MATCH_HOME_TEAM vs $MATCH_AWAY_TEAM"

SLAVE_SLOTS="100"
SLAVE_PASS="fudiwudi"

SLAVE_PRIVATE_SLOTS="20"
SLAVE_PRIVATE_PASS="[put_your_pass_here]"

SLAVE_ETTV_SLAVES="5" # Allow chaining?
SLAVE_ETTV_PASS="[put_your_pass_here]"

SLAVE_RCON_PASS="[put_your_pass_here]"

RECORD_GAME="1" # 1 = record game, 0 = don't
SLAVE_DELAY="60" # Time in seconds

REDIRECT="Server is full" # Message displayed when server is full
#REDIRECT="ET://ettv2.fragland.org:27960" # Allows redirecting to other ettv's

#
# Downloading
#
ALLOW_DL="1" # Can clients download stuff?
ALLOW_WWW_DL="1" # Allow downloading over http?
WWW_DL_URL="http://www.fragland.org/maps" # No "/" at the end!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1"
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400"

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_slave" # Path to ettv.x86
# Use absolute paths here!

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path where
# all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying Here #
# #
#################################################################
#
# Make sure buffers are ok!
#
echo "524288" > /proc/sys/net/core/rmem_max
echo "524288" > /proc/sys/net/core/wmem_max

#
# Assembling the Command Line
#
BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"
HOMEPATH="$BASEPATH/$MATCH_DATE"

SLAVE_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set com_hunkMegs 256 \
+set net_ip $SLAVE_IP \
+set net_port $SLAVE_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $HOMEPATH \
+set sv_maxclients $SLAVE_SLOTS \
+exec server.cfg"

#
# Functions
#

slave_start (){
#
# FYI the user
#
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $HOMEPATH/etpro/demos/.\n"

#
# Start the slave
#
echo -n "Starting Slave: "

screen -dmS slave su -m -c "$DAEMON $SLAVE_OPTIONS" - $USER

echo -e "done.\n"

echo -e "Getting PID...\n"
sleep 1

SLAVE_PID=`pidof $DAEMON`

echo -n "Slave has PID "
echo -e "$SLAVE_PID.\n"

if [ $SLAVE_ETTV_SLAVES != 0 ]
then
echo "ETTV slaves can now connect to your box by issuing:"
echo -e "tv connect $SLAVE_IP:$SLAVE_PORT $SLAVE_ETTV_PASS $SLAVE_PASS\n"
fi
}

slave_stop (){
#
# Refresh the PID
#
SLAVE_PID=`pidof $DAEMON`

echo -n "Shutting Down Slave: "
sleep 1
if [ $SLAVE_PID ]
then
kill -SIGTERM $SLAVE_PID
echo -e "done."
else
echo -e "failed.\nSlave wasn't active anymore.\n"
fi
}

create_config (){
#
# Generate etmain/server.cfg
#
TIMESTAMP=`date +"%d/%m/%Y %H:%M:%S"`

echo "//" > $BASEPATH/etmain/server.cfg
echo "// server.cfg generated $TIMESTAMP" >> $BASEPATH/etmain/server.cfg
echo -e "//\n" >> $BASEPATH/etmain/server.cfg

echo "set sv_privateclients $SLAVE_PRIVATE_SLOTS" >> $BASEPATH/etmain/server.cfg
echo "set sv_maxRate 25000" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_hostname \"$SLAVE_HOSTNAME\"\n" >> $BASEPATH/etmain/server.cfg

echo "set g_password \"$SLAVE_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set rconpassword \"$SLAVE_RCON_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_privatepassword \"$SLAVE_PRIVATE_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_allowDownload $ALLOW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwDownload $ALLOW_WWW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwBaseURL \"$WWW_DL_URL\"" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_wwwDlDisconnected 0\n" >> $BASEPATH/etmain/server.cfg

echo "set b_ettv_flags 3" >> $BASEPATH/etmain/server.cfg
echo "set ettv_delay $SLAVE_DELAY" >> $BASEPATH/etmain/server.cfg
echo "set ettv_autorecord $RECORD_GAME" >> $BASEPATH/etmain/server.cfg
echo "set ettv_clientname \"$ETTV_CLIENT\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_maxslaves \"$SLAVE_ETTV_SLAVES\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_password \"$SLAVE_ETTV_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_netblast $ETTV_NETBLAST" >> $BASEPATH/etmain/server.cfg
echo "set ettv_tv_iptos $ETTV_TV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_iptos $ETTV_SV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo -e "set ettv_mtu $ETTV_MTU\n" >> $BASEPATH/etmain/server.cfg

echo "set b_crashlogpath \"$BASEPATH/etpro\"" >> $BASEPATH/etmain/server.cfg
echo "set g_log \"slave.log\"" >> $BASEPATH/etmain/server.cfg
echo -e "set logfile 2\n" >> $BASEPATH/etmain/server.cfg

echo "tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS" >> $BASEPATH/etmain/server.cfg
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

#
# Performing The magic :-)
#

case "$1" in
start)
create_config
slave_start
;;
stop)
slave_stop
clean_up
;;
restart)
$0 stop
sleep 1
$0 start
;;
sim)
create_config
echo -e "\nFollowing config was generated automatically:\n"
cat $BASEPATH/etmain/server.cfg
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop|restart|sim}"
exit 1
;;
esac
exit 0
</pre>

=== Old school record / playback script ===

This is a script to broadcast a game the old-fashioned way. It records a demo and starts playing it back after roughly 60 seconds. There's some symbolic linking stuff done inside to make sure it stores all the logs, otherwise the 'broadcaster' would override the recorder's log, ''which makes broadcasting very hard to debug'' :-)!

Copy / paste this script and save it as <code>broadcast.sh</code> or any other name you prefer. The usual comments on quit and 999 are applicable here as well. This script "should" work with ETTV earlier then b8. However, YMMV.

<pre>#!/bin/bash

#################################################################
# #
# reT!reD.ettv delayed broadcast script #
# - #
# reT!reD.deej #
# #
#################################################################
# #
# This script can be used to start up a delayed ETTV stream #
# where viewers connect directly to the broadcaster. #
# #
# This script creates a subdirectory which represents the #
# date of the match and stores the demos in this subdir. #
# #
# The script launches the daemons in different screens #
# which you can reattach with "screen -r recorder" #
# or "screen -r broadcaster". #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# - aNgel (fragland.org) for debugging Beavis' mistakes ;-) #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################
# #
# http://www.fragland.org #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# START Modifying #
# #
#################################################################
#
# Parameters of the Game Server to Connect to
#
# IMPORTANT: Let the admin of the game server do
# "fdir *.pk3" in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Today's date for creating the subdir
MATCH_HOST="et.fragland.org:27965" # Match server port & address
MATCH_ETTV_PASS="[get_pass_from_admin]" # Match server ETTV password
MATCH_PASS="[get_pass_from_admin]" # Match server password

#
# IPs & Ports For Your Host
#
THISHOST_IP=$PERONI_IP # This host is Webperoni
RECORDER_PORT="44999" # Port of the private recorder
BROADCASTER_PORT="27960" # Port of the public broadcaster

#
# Hostnames & ETTV Client name
#
# - hostname shows up in server browsers
# - ETTV client name shows up as the name
# of your server in the game server.
#
RECORDER_HOSTNAME="^7reT^1!^7reD^1.^7ettv ^7recorder ^1#^71"
BROADCASTER_HOSTNAME="^7reT^1!^7reD^1.^7ettv ^1#^71"

ETTV_CLIENT=$BROADCASTER_HOSTNAME

#
# Passwords
#
RCON_PASS="[put_your_pass_here]"
RECORDER_PASS="[put_your_pass_here]"
BROADCASTER_PRIVATE_PASS="[put_your_pass_here]"
BROADCASTER_ETTV_PASS="[put_your_pass_here]"
BROADCASTER_PASS="[put_your_pass_here]" # Issue /rcon g_password "" for opening it up to the crowd

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_brc" # Path to ettv.x86. Use absolute paths here!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1"
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400"

#
# Other relevant settings
#
SHOUTCAST_DELAY="60" # Delay between live match & broadcasting hub in seconds

BROADCASTER_SLOTS="100"
BROADCASTER_PRIVATE_SLOTS="10"
BROADCASTER_ETTV_SLAVES="0"

ALLOW_DL="1"
ALLOW_WWW_DL="1" # Allow downloading over http?
WWW_DL_URL="http://www.yoursite.org" # No "/" at the end!

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path
# where all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying #
# #
#################################################################
#
# Assembling the Command Line
#
RECORDER_HOMEPATH="$BASEPATH/$MATCH_DATE/recorder"
BROADCASTER_HOMEPATH="$BASEPATH/$MATCH_DATE/broadcaster"

BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"

RECORDER_OPTIONS="\
+set fs_game etpro \
+set dedicated 1 \
+map oasis \
+set net_ip $THISHOST_IP \
+set net_port $RECORDER_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $RECORDER_HOMEPATH \
+set com_hunkMegs 128 \
+set g_password $RECORDER_PASS \
+set rconpassword $RCON_PASS \
+set sv_hostname $RECORDER_HOSTNAME \
+set sv_maxclients 4 \
+set sv_maxRate 25000 \
+set sv_allowDownload 0 \
+set sv_wwwDownload 0 \
+set sv_wwwBaseURL "$WWW_DL_URL" \
+set sv_wwwDlDisconnected 0 \
+set g_log "recorder.log" \
+set logfile 2 \
+set b_ettv_flags 3 \
+set ettv_sv_maxslaves 2 \
+set ettv_clientname $ETTV_CLIENT \
+set ettv_password $BROADCASTER_ETTV_PASS \
+set ettv_netblast $ETTV_NETBLAST \
+set ettv_tv_iptos $ETTV_TV_IPTOS \
+set ettv_sv_iptos $ETTV_SV_IPTOS \
+set ettv_mtu $ETTV_MTU \
+set ettv_autorecord 1 \
+set ettv_delay 1 \
+tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS"

BROADCASTER_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set net_ip $THISHOST_IP \
+set net_port $BROADCASTER_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $BROADCASTER_HOMEPATH \
+set com_hunkMegs 160 \
+set sv_maxclients $BROADCASTER_SLOTS \
+set sv_privateclients $BROADCASTER_PRIVATE_SLOTS \
+set sv_privatepassword $BROADCASTER_PRIVATE_PASS \
+set sv_hostname $BROADCASTER_HOSTNAME \
+set g_password $BROADCASTER_PASS \
+set rconpassword $RCON_PASS \
+set sv_maxRate 18000 \
+set sv_allowDownload $ALLOW_DL \
+set sv_wwwDownload $ALLOW_WWW_DL \
+set sv_wwwBaseURL "$WWW_DL_URL" \
+set sv_wwwDlDisconnected 0 \
+set g_log "broadcaster.log" \
+set logfile 2 \
+set ettv_autoplay 1 \
+set ettv_password $BROADCASTER_ETTV_PASS \
+set b_ettv_flags 3 \
+set ettv_sv_maxslaves $BROADCASTER_ETTV_SLAVES \
+demo demo0000"

#
# Functions
#
broadcast_start (){
#
# FYI'ing the user
#
echo -e "\n"
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $RECORDER_HOMEPATH/etpro/demos/.\n"

echo -n "Starting Recorder: "
screen -dmS recorder su -m -c "$DAEMON $RECORDER_OPTIONS" - $USER
echo "done."

get_pids

echo -n "Recorder has PID "
echo -n $RECORDER_PID

echo -e ".\n\nSleeping for $SHOUTCAST_DELAY seconds."
sleep $SHOUTCAST_DELAY

mkdir "$BROADCASTER_HOMEPATH"
mkdir "$BROADCASTER_HOMEPATH/etpro"
ln -s "$RECORDER_HOMEPATH/etpro/demos" "$BROADCASTER_HOMEPATH/etpro"
chown -R $USER "$BROADCASTER_HOMEPATH"
chmod -R 775 "$BROADCASTER_HOMEPATH"

echo -n "Starting Broadcaster: "
screen -dmS broadcaster su -m -c "$DAEMON $BROADCASTER_OPTIONS" - $USER
echo -e "done.\n"

echo -e "Getting PIDs...\n"
sleep 1

get_pids

echo -n "Recorder has PID "
echo -n $RECORDER_PID
echo -e ".\n\nBroadcaster has PID "
echo -e "$BROADCASTER_PID.\n"
}

broadcast_stop (){

get_pids

echo -n "Shutting Down Broadcaster: "
sleep 1
if [ $BROADCASTER_PID ]
then
kill -3 $BROADCASTER_PID
echo -e "done."
else
echo -e "failed.\nBroadcaster wasn't active anymore.\n"
fi

echo -n "Shutting Down Recorder: "
sleep 1
if [ $RECORDER_PID ]
then
kill -3 $RECORDER_PID
echo -e "done."
else
echo -e "failed.\nRecorder wasn't active anymore.\n"
fi

sleep 1
clean_up
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

get_pids (){
#
# Pulling some very ugly tricks here
#
RECORDER_PID=`ps aux|grep "+set net_port $RECORDER_PORT"|grep -v "su -m -c"|grep -v "SCREEN -dmS"\|awk '{ print $1 $2 }'|tr -d "$USER"`
BROADCASTER_PID=`ps aux|grep "+set net_port $BROADCASTER_PORT"|grep -v "su -m -c"|grep -v "SCREEN -dmS"|awk '{ print $1 $2 }'|tr -d "$USER"`
}

#
# Performing The magic :-)
#

case "$1" in
start)
broadcast_start
;;
stop)
broadcast_stop
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop}"
exit 1
;;
esac
exit 0
</pre>

=== Sanitization script ===

This is a script to restore an ETTV directory to the bare minimum required to broadcast matches or be a hub. It isn't a very advanced script but it gets the job done. Copy / paste this script and save it as <code>sanitize.sh</code> or any other name you prefer. Just do <code>./sanitize.sh</code> do delete all files in etmain & etpro that are not needed anymore.

''Note'': this script deletes '''everything''' it finds in the etmain and etpro directories. If you have stuff that you do not want to delete in there, add it to the ETMAIN_FILES & ETPRO_FILES arrays.

<pre>#!/bin/bash

#################################################################
# #
# ettv clean-up script #
# - #
# deej. #
# #
#################################################################
# #
# This script is used to restore an ETTV directory to the bare #
# minimum in terms of files. #
# #
# Use it to clean up after an ETTV session so you can start the #
# next session with a minimum of PK3s. #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################

ETMAIN_FILES=(\
"description.txt" \
"hunkusage.dat" \
"mp_bin.pk3" \
"pak0.pk3" \
"pak1.pk3" \
"pak2.pk3" \
"et_ice.pk3" \
"braundorf_b4.pk3" \
"supplydepot2.pk3" \
"sw_goldrush_te.pk3" \
"sw_oasis_b3.pk3")

ETPRO_FILES=(\
"etpro-3_2_4.pk3" \
"etpro_cheats.dat" \
"qagame.mp.i386.so" \
"tvgame.mp.i386.so")

SCRIPT_NAME=`basename $0`

case $1 in
hub)
BASEPATH="/srv/et/ETTV/ettv_hub"
;;
slave)
BASEPATH="/srv/et/ETTV/ettv_slave"
;;
*)
echo -e "\nError: $1 is not a valid installation target."
echo -e "Usage: $SCRIPT_NAME {hub|slave}\n"
exit 1
esac

#
# Test for existence of backup directories
#
if [ ! -d "$BASEPATH/etmain/bak/" ]; then
mkdir "$BASEPATH/etmain/bak"
fi

if [ ! -d "$BASEPATH/etpro/bak/" ]; then
mkdir "$BASEPATH/etpro/bak"
fi

#
# Clear etmain
#
for i in ${ETMAIN_FILES[@]}
do
mv "$BASEPATH/etmain/$i" "$BASEPATH/etmain/bak/"
done
rm $BASEPATH/etmain/*

#
# Clear etpro
#
for i in ${ETPRO_FILES[@]}
do
mv "$BASEPATH/etpro/$i" "$BASEPATH/etpro/bak/"
done
rm $BASEPATH/etpro/*

#
# Restore etmain
#
for i in ${ETMAIN_FILES[@]}
do
mv "$BASEPATH/etmain/bak/$i" "$BASEPATH/etmain/"
done

#
# Restore etpro
#
for i in ${ETPRO_FILES[@]}
do
mv "$BASEPATH/etpro/bak/$i" "$BASEPATH/etpro/"
done

#
# Clean the backup directories
#
rm -Rf $BASEPATH/etmain/bak
rm -Rf $BASEPATH/etpro/bak
</pre>

=== Switching beta's script ===

This script allows you to quickly switch between the different beta's Bani has released. Just save it as <code>switchbeta.sh</code> and adapt the directory fields to your setup. Usage example: <code>./switchbeta.sh 9 hub</code> switches the hub to beta 9. <code>./switchbeta.sh 4 all</code> switches hub & slave (or others you can define of course) back to beta 4.

<pre>#!/bin/bash

#################################################################
# #
# switching ettv betas script #
# - #
# deej. #
# #
#################################################################
# #
# This script allows you to easily switch ETTV beta versions. #
# #
# Just put the ettv-beta[x].zip files in directory $REPODIR, #
# adapt settings for hub & slave and start switching! #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################

#
# Paths & files
#
REPODIR="/srv/et" # Where the ettv-betaX.zip files reside
HUB_DIR="/srv/et/ETTV/ettv_hub"
SLAVE_DIR="/srv/et/ETTV/ettv_slave"

#
# Argument check
#
SCRIPT_NAME=`basename $0`
ARGS=2
E_BADARGS=65

if [ $# -lt "$ARGS" ]
then
echo -e "\nError: missing arguments"
echo -e "Usage: $SCRIPT_NAME {beta number} {hub|slave|broadcast|all}\n"
exit $E_BADARGS
fi

FILENAME="ettv-beta$1.zip"

if [ ! -e "$REPODIR/$FILENAME" ]
then
echo -e "\nError: beta version $1 is not present in $REPODIR."
echo -e "Usage: $SCRIPT_NAME {beta number} {hub|slave|all}\n"
exit $E_BADARGS
fi

case $2 in
hub)
unzip -o "$REPODIR/$FILENAME" -d "$HUB_DIR" ettv.x86
chmod +x "$HUB_DIR/ettv.x86"
unzip -o "$REPODIR/$FILENAME" -d "$HUB_DIR/etpro" tvgame.mp.i386.so
;;
slave)
unzip -o "$REPODIR/$FILENAME" -d "$SLAVE_DIR" ettv.x86
chmod +x "$SLAVE_DIR/ettv.x86"
unzip -o "$REPODIR/$FILENAME" -d "$SLAVE_DIR/etpro" tvgame.mp.i386.so
;;
all)
$0 hub
$0 slave
;;
*)
echo -e "\nError: $2 is not a valid installation target."
echo -e "Usage: $SCRIPT_NAME {beta number} {hub|slave|all}\n"
exit $E_BADARGS
esac
exit 0
</pre>

Have fun broadcasting!

[[User:Deej|deej]] 01:46, 3 January 2006 (PST)

[[Category:ETTV]]

User talk:Deej

2006-01-02T17:24:56Z

Deej:

You might want to use the preview button more often. ("<[NW]reyalP> someone needs to hit deej with the preview stick") --[[User:WeblionX|WeblionX]] 13:36, 5 November 2005 (PST)

I plead guilty to being a total Wikinub [[User:Deej|deej]] 14:14, 5 November 2005 (PST)

I'm getting better at this preview stuff :D.

Thanks for a better image with the colour codes. :) --[[User:Rookie One|Rookie One]] 23:29, 11 November 2005 (CET)

Scripts updated. Now generate server.cfg automatically so no need for those mile-long command lines anymore! -- [[User:Deej|deej]] 09:24, 2 January 2006 (PST)

User:Deej

2006-01-02T17:19:18Z

Deej:

http://www.fragland.org/deej/572.gif 
Guilty for founding the [http://www.fragland.org Retired Old Farts] which provide: 
- ETPro servers 
- ETTV servers 
- ETPub servers 
- General annoyance 
- Pub requests for a competition mod 

== My interpretation of ETTV setups ==

Since I'm quite fond of toying around with new developments, I'm always one of the first to test new ETTV / ETPro releases and bug bani with questions about them. Having said that, here's my 'personal' view on a good ETTV broadcast (this is not the Bible!):

=== Terminology ===

There are 5 different "participants" possibly involved in an ETTV broadcast:

* '''Master''' - the gameserver hosting the actual game
* '''Viewer''' - the viewer wanting to view a game (duh)
* '''Broadcaster''' - a server that is directly connected to a gameserver and allows viewer to connect directly to itself
* '''Hub''' - a server that is directly connected to a gameserver and allows other ETTV 'slaves' to connect to itself, but not viewers
* '''Slave''' - a server that connects to a hub or perhaps a broadcaster and and allows viewers to connect to itself

Keep this terminology in mind when you stroll through my text ;-).

=== Today's broadcasts ===

Most ETTV games I see today use this set-up:

:<code>Viewer -> Broadcaster -> Master</code>

If you remember that an ETTV server connects at an ''unlimited rate'' to another server, and as from ETTV b9 the slaves are in fact not limited at all by the original ET netcode, you might see a problem arising when lots of people would like to see a "big match".

The trouble was / is that before ETTV b8 and 'autodelay', we had to do some fancy flying to get a delayed broadcast or delayed hub up. Usually you would start a 'recorder' daemon that recorded demos and a 'playback' daemon from that same directory, so that it started playing back the recorded demo after roughly 60 or 90 seconds. This does require fancy scripting and lots of manual work to sort out demos, connect slaves to hubs etc...

With <code>ettv_autodelay</code>, things have become a lot easier. Ideally the gameserver now only allows 2 or 4 ETTV hubs to connect to it, which delay and relay the signal. The responsibility for the admins of the hub is of course greater as they should not have any PK3s active on their hubs that are not on the pure list of the server. The less PK3s you need, the better!

=== Deej's proposition ===

The best setup IMHO is to have the following:

<pre>Viewers -> Slave 1 |
Viewers -> Slave 2 |
Viewers -> Slave 3 |--> Hub 1 |
|--> Hub 2 | --> Master
Viewers -> Slave ... |--> Hub n |
|
Viewers -> Slave n |</pre>

This alleviates the load on the Master Game Server firmly as only 2 or 4 hubs are required where slaves can then connect to! Furthermore with autodelay all the 'slave' administrators only need to connect their slave to a given hub. No more playing around with delays, demos, symbolic links, PIDs that get screwed up etc...

== Some scripts I use ==

=== Hub script ===

This script launches a hub that delays its feed by x seconds, configurable inside the script. You can safely remove the stuff like PERONI_IP, FRAGLAND_IP etc... at the beginning since those only store the IPs of the root servers we manage (it's easier for me to keep track of them that way).

'''How do you use this script?''' Copy / paste this script and save it as <code>hub.sh</code> or any other name you prefer. Then use <code>./hub.sh start</code> to start and <code>./hub.sh stop</code> to stop your hub. The script generates the server.cfg dynamically every time you start it. If you just want to generate server.cfg do <code>./hub.sh sim</code>.

Be aware that it's much better to actually do "quit" in the console of your hub instead of <code>./hub.sh stop</code> as this cleanly disconnects the hub from a game server. With <code>./hub.sh stop</code> the hub stays with ping 999 on the gameserver and needs to time out. Maybe we should ask Bani to improve POSIX signal interpretation of the ETTV binary :-).

<pre>#!/bin/bash

#################################################################
# #
# ettv delayed hub script #
# - #
# deej. #
# #
#################################################################
# #
# This script can be used to start up a delayed ETTV stream #
# where ETTV slaves connect to the hub to relay the signal. #
# #
# The daemon serves as a hub for other ETTV slaves to connect #
# to and as such alleviate the load on the game server hosting #
# the match. #
# #
# This script creates a subdirectory which represents the #
# date of the match and stores the demos in this subdir. #
# #
# The script generates etmain/server.cfg dynamically. #
# #
# The script launches the daemon in a different screen #
# which you can reattach with "screen -r hub". #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# Start Modifying From Here #
# #
#################################################################
#
# Parameters of the Game Server to Connect to
#
# IMPORTANT: Let the admin of the game server do
# "fdir *.pk3" in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Do NOT modify
MATCH_HOST="et.fragland.org:27965" # Match server port & address
MATCH_ETTV_PASS="[get_pass_from_admin]" # Match server ETTV password
MATCH_PASS="[get_pass_from_admin]" # Match server password

MATCH_HOME_TEAM="uQ" # Making our hostname more fancy ;-)
MATCH_AWAY_TEAM="Logitech"
MATCH_CUP="Warleagues"

#
# IPs & Ports For Your Host
#
HUB_IP="$PERONI_IP" # This host is Webperoni
HUB_PORT="30000" # Port of public hub for ETTV slaves

#
# Hostnames & ETTV Client name
#
# - hostname shows up in server browsers
# - ETTV client name shows up as the name
# of your server in the game server.
#
ETTV_CLIENT="^7reT^1!^7reD^1.^7ettv ^7hub ^1#^71"
HUB_HOSTNAME="$ETTV_CLIENT - ^3$MATCH_CUP^7: $MATCH_HOME_TEAM vs $MATCH_AWAY_TEAM"

#
# Passwords
#
HUB_RCON_PASS="[put_your_pass_here]"
HUB_PRIVATE_PASS="[put_your_pass_here]"
HUB_ETTV_PASS="[put_your_pass_here]"
HUB_PASS="[put_your_pass_here]"

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_hub" # Use absolute paths here!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1"
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400"

#
# Other relevant ETTV settings
#
HUB_DELAY="1" # Delay between live match & hub in seconds
HUB_SLAVES="8" # 1 ETTV slave connects at an UNLIMITED rate!
HUB_PRIVATE_SLOTS="0"

RECORD_GAME="1" # Record the game?

ALLOW_DL="0" # Slaves don't download from the hub
ALLOW_WWW_DL="0"
WWW_DL_URL="http://www.yoursite.com"

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path where
# all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying Here #
# #
#################################################################
#
# Make sure buffers are high enough!
#
echo "524288" > /proc/sys/net/core/rmem_max
echo "524288" > /proc/sys/net/core/wmem_max

#
# Assembling the Command Line
#
BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"
HOMEPATH="$BASEPATH/$MATCH_DATE"

HUB_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set net_ip $HUB_IP \
+set net_port $HUB_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $HOMEPATH \
+set com_hunkMegs 128 \
+set sv_maxclients $HUB_SLAVES \
+exec server.cfg"

#
# Functions
#

hub_start () {
#
# FYI'ing the user
#
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $HOMEPATH/etpro/demos/.\n"

echo -n "Starting Hub: "
screen -dmS hub su -m -c "$DAEMON $HUB_OPTIONS" - $USER
sleep 1
echo -e "done.\n"

echo -e "Getting PID...\n"

get_pids

echo -n "Hub has PID "
echo -e "$HUB_PID\n"

echo "ETTV slaves can now connect to your box by issuing:"
echo -e "tv connect $HUB_IP:$HUB_PORT $HUB_ETTV_PASS $HUB_PASS\n"
}

hub_stop () {
#
# Refresh the PIDs
#
get_pids

echo -n "Shutting Down Hub: "
sleep 1
if [ -n $HUB_PID ]
then
kill -SIGTERM $HUB_PID
echo -e "done."
else
echo -e "failed.\nHub wasn't active anymore.\n"
fi

sleep 1
}

create_config (){
#
# Generate etmain/server.cfg
#
TIMESTAMP=`date +"%d/%m/%Y %H:%M:%S"`

echo "//" > $BASEPATH/etmain/server.cfg
echo "// server.cfg generated $TIMESTAMP" >> $BASEPATH/etmain/server.cfg
echo -e "//\n" >> $BASEPATH/etmain/server.cfg

echo "set sv_privateclients $HUB_PRIVATE_SLOTS" >> $BASEPATH/etmain/server.cfg
echo "set sv_maxRate 25000" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_hostname \"$HUB_HOSTNAME\"\n" >> $BASEPATH/etmain/server.cfg

echo "set g_password \"$HUB_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set rconpassword \"$HUB_RCON_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_privatepassword \"$HUB_PRIVATE_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_allowDownload $ALLOW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwDownload $ALLOW_WWW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwBaseURL \"$WWW_DL_URL\"" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_wwwDlDisconnected 0\n" >> $BASEPATH/etmain/server.cfg

echo "set b_ettv_flags 3" >> $BASEPATH/etmain/server.cfg
echo "set ettv_delay $HUB_DELAY" >> $BASEPATH/etmain/server.cfg
echo "set ettv_autorecord $RECORD_GAME" >> $BASEPATH/etmain/server.cfg
echo "set ettv_clientname \"$ETTV_CLIENT\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_maxslaves \"$HUB_ETTV_SLAVES\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_password \"$HUB_ETTV_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_netblast $ETTV_NETBLAST" >> $BASEPATH/etmain/server.cfg
echo "set ettv_tv_iptos $ETTV_TV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_iptos $ETTV_SV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo -e "set ettv_mtu $ETTV_MTU\n" >> $BASEPATH/etmain/server.cfg

echo "set b_crashlogpath \"$BASEPATH/etpro\"" >> $BASEPATH/etmain/server.cfg
echo "set g_log \"slave.log\"" >> $BASEPATH/etmain/server.cfg
echo -e "set logfile 2\n" >> $BASEPATH/etmain/server.cfg

echo "tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS" >> $BASEPATH/etmain/server.cfg
}

get_pids (){
#
# We used to launch the same binary twice so pidof didn't work.
# As from beta 8 ettv delayed feeds were automatic so
# no more fancy scripting tricks are required :-)
#
HUB_PID=`pidof $DAEMON`
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

#
# Performing The magic :-)
#

case "$1" in
start)
create_config
hub_start
;;
stop)
hub_stop
clean_up
;;
sim)
create_config
echo -e "\nFollowing config was generated automatically:\n"
cat $BASEPATH/etmain/server.cfg
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop|sim}"
exit 1
;;
esac
exit 0
</pre>

=== Slave script ===

This script connects a delayed or undelayed slave to a Hub or directly to a gameserver. The usage of this script is very similar to the Hub script. Copy / paste it and save it as <code>slave.sh</code> or any other name you prefer. Then issue <code>./slave.sh start</code> to start your slave and <code>./slave.sh stop</code> to stop it. Use <code>./slave.sh sim</code> to only create etmain/server.cfg. Like above, it is actually better to do quit in the console instead of just killing the slave with this script.

<pre>#!/bin/bash

#################################################################
# #
# ETTV slave script #
# - #
# deej. #
# #
#################################################################
# #
# This script can be used to start up an ETTV slave to connect #
# to an ETTV HUB or directly to a game server. #
# #
# The script generates etmain/server.cfg dynamically. #
# #
# This script launches the daemon in a different screen which #
# you can reattach with "screen -r slave" #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# #
# Questions? deej@fragland.org or go to #gamestv.org #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# Start Modifying From Here #
# #
#################################################################
#
# Hub Info
#
# IMPORTANT: Let the admin of the hub do a
# fdir *.pk3 in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Do NOT modify
MATCH_HOST="et.fragland.org:27965" # HUB / Match server port & address
MATCH_ETTV_PASS="[put_pass]" # HUB / Match server ETTV password
MATCH_PASS="[put_pass]" # HUB / Match server password

MATCH_HOME_TEAM="uQ" # Making our hostname more fancy ;-)
MATCH_AWAY_TEAM="Logitech"
MATCH_CUP="Warleagues"

#
# Slave Info
#
SLAVE_IP="$PERONI_IP" # This host is Peroni
SLAVE_PORT="27960" # port of public broadcaster

ETTV_CLIENT="^7reT^1!^7reD^1.^7ettv ^1#^71" # shows up on the Hub
SLAVE_HOSTNAME="$ETTV_CLIENT - ^3$MATCH_CUP^7: $MATCH_HOME_TEAM vs $MATCH_AWAY_TEAM"

SLAVE_SLOTS="100"
SLAVE_PASS="fudiwudi"

SLAVE_PRIVATE_SLOTS="20"
SLAVE_PRIVATE_PASS="[put_your_pass_here]"

SLAVE_ETTV_SLAVES="5" # Allow chaining?
SLAVE_ETTV_PASS="[put_your_pass_here]"

SLAVE_RCON_PASS="[put_your_pass_here]"

RECORD_GAME="1" # 1 = record game, 0 = don't
SLAVE_DELAY="60" # Time in seconds

REDIRECT="Server is full" # Message displayed when server is full
#REDIRECT="ET://ettv2.fragland.org:27960" # Allows redirecting to other ettv's

#
# Downloading
#
ALLOW_DL="1" # Can clients download stuff?
ALLOW_WWW_DL="1" # Allow downloading over http?
WWW_DL_URL="http://www.fragland.org/maps" # No "/" at the end!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1"
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400"

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_slave" # Path to ettv.x86
# Use absolute paths here!

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path where
# all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying Here #
# #
#################################################################
#
# Make sure buffers are ok!
#
echo "524288" > /proc/sys/net/core/rmem_max
echo "524288" > /proc/sys/net/core/wmem_max

#
# Assembling the Command Line
#
BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"
HOMEPATH="$BASEPATH/$MATCH_DATE"

SLAVE_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set com_hunkMegs 256 \
+set net_ip $SLAVE_IP \
+set net_port $SLAVE_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $HOMEPATH \
+set sv_maxclients $SLAVE_SLOTS \
+exec server.cfg"

#
# Functions
#

slave_start (){
#
# FYI the user
#
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $HOMEPATH/etpro/demos/.\n"

#
# Start the slave
#
echo -n "Starting Slave: "

screen -dmS slave su -m -c "$DAEMON $SLAVE_OPTIONS" - $USER

echo -e "done.\n"

echo -e "Getting PID...\n"
sleep 1

SLAVE_PID=`pidof $DAEMON`

echo -n "Slave has PID "
echo -e "$SLAVE_PID.\n"

if [ $SLAVE_ETTV_SLAVES != 0 ]
then
echo "ETTV slaves can now connect to your box by issuing:"
echo -e "tv connect $SLAVE_IP:$SLAVE_PORT $SLAVE_ETTV_PASS $SLAVE_PASS\n"
fi
}

slave_stop (){
#
# Refresh the PID
#
SLAVE_PID=`pidof $DAEMON`

echo -n "Shutting Down Slave: "
sleep 1
if [ $SLAVE_PID ]
then
kill -SIGTERM $SLAVE_PID
echo -e "done."
else
echo -e "failed.\nSlave wasn't active anymore.\n"
fi
}

create_config (){
#
# Generate etmain/server.cfg
#
TIMESTAMP=`date +"%d/%m/%Y %H:%M:%S"`

echo "//" > $BASEPATH/etmain/server.cfg
echo "// server.cfg generated $TIMESTAMP" >> $BASEPATH/etmain/server.cfg
echo -e "//\n" >> $BASEPATH/etmain/server.cfg

echo "set sv_privateclients $SLAVE_PRIVATE_SLOTS" >> $BASEPATH/etmain/server.cfg
echo "set sv_maxRate 25000" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_hostname \"$SLAVE_HOSTNAME\"\n" >> $BASEPATH/etmain/server.cfg

echo "set g_password \"$SLAVE_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set rconpassword \"$SLAVE_RCON_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_privatepassword \"$SLAVE_PRIVATE_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set sv_allowDownload $ALLOW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwDownload $ALLOW_WWW_DL" >> $BASEPATH/etmain/server.cfg
echo "set sv_wwwBaseURL \"$WWW_DL_URL\"" >> $BASEPATH/etmain/server.cfg
echo -e "set sv_wwwDlDisconnected 0\n" >> $BASEPATH/etmain/server.cfg

echo "set b_ettv_flags 3" >> $BASEPATH/etmain/server.cfg
echo "set ettv_delay $SLAVE_DELAY" >> $BASEPATH/etmain/server.cfg
echo "set ettv_autorecord $RECORD_GAME" >> $BASEPATH/etmain/server.cfg
echo "set ettv_clientname \"$ETTV_CLIENT\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_maxslaves \"$SLAVE_ETTV_SLAVES\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_password \"$SLAVE_ETTV_PASS\"" >> $BASEPATH/etmain/server.cfg
echo "set ettv_netblast $ETTV_NETBLAST" >> $BASEPATH/etmain/server.cfg
echo "set ettv_tv_iptos $ETTV_TV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo "set ettv_sv_iptos $ETTV_SV_IPTOS" >> $BASEPATH/etmain/server.cfg
echo -e "set ettv_mtu $ETTV_MTU\n" >> $BASEPATH/etmain/server.cfg

echo "set b_crashlogpath \"$BASEPATH/etpro\"" >> $BASEPATH/etmain/server.cfg
echo "set g_log \"slave.log\"" >> $BASEPATH/etmain/server.cfg
echo -e "set logfile 2\n" >> $BASEPATH/etmain/server.cfg

echo "tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS" >> $BASEPATH/etmain/server.cfg
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

#
# Performing The magic :-)
#

case "$1" in
start)
create_config
slave_start
;;
stop)
slave_stop
clean_up
;;
restart)
$0 stop
sleep 1
$0 start
;;
sim)
create_config
echo -e "\nFollowing config was generated automatically:\n"
cat $BASEPATH/etmain/server.cfg
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop|restart|sim}"
exit 1
;;
esac
exit 0
</pre>

=== Old school record / playback script ===

This is a script to broadcast a game the old-fashioned way. It records a demo and starts playing it back after roughly 60 seconds. There's some symbolic linking stuff done inside to make sure it stores all the logs, otherwise the 'broadcaster' would override the recorder's log, ''which makes broadcasting very hard to debug'' :-)!

Copy / paste this script and save it as <code>broadcast.sh</code> or any other name you prefer. The usual comments on quit and 999 are applicable here as well. This script "should" work with ETTV earlier then b8. However, YMMV.

<pre>#!/bin/bash

#################################################################
# #
# reT!reD.ettv delayed broadcast script #
# - #
# reT!reD.deej #
# #
#################################################################
# #
# This script can be used to start up a delayed ETTV stream #
# where viewers connect directly to the broadcaster. #
# #
# This script creates a subdirectory which represents the #
# date of the match and stores the demos in this subdir. #
# #
# The script launches the daemons in different screens #
# which you can reattach with "screen -r recorder" #
# or "screen -r broadcaster". #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# - aNgel (fragland.org) for debugging Beavis' mistakes ;-) #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################
# #
# http://www.fragland.org #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# START Modifying #
# #
#################################################################
#
# Parameters of the Game Server to Connect to
#
# IMPORTANT: Let the admin of the game server do
# "fdir *.pk3" in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Today's date for creating the subdir
MATCH_HOST="et.fragland.org:27965" # Match server port & address
MATCH_ETTV_PASS="[get_pass_from_admin]" # Match server ETTV password
MATCH_PASS="[get_pass_from_admin]" # Match server password

#
# IPs & Ports For Your Host
#
THISHOST_IP=$PERONI_IP # This host is Webperoni
RECORDER_PORT="44999" # Port of the private recorder
BROADCASTER_PORT="27960" # Port of the public broadcaster

#
# Hostnames & ETTV Client name
#
# - hostname shows up in server browsers
# - ETTV client name shows up as the name
# of your server in the game server.
#
RECORDER_HOSTNAME="^7reT^1!^7reD^1.^7ettv ^7recorder ^1#^71"
BROADCASTER_HOSTNAME="^7reT^1!^7reD^1.^7ettv ^1#^71"

ETTV_CLIENT=$BROADCASTER_HOSTNAME

#
# Passwords
#
RCON_PASS="[put_your_pass_here]"
RECORDER_PASS="[put_your_pass_here]"
BROADCASTER_PRIVATE_PASS="[put_your_pass_here]"
BROADCASTER_ETTV_PASS="[put_your_pass_here]"
BROADCASTER_PASS="[put_your_pass_here]" # Issue /rcon g_password "" for opening it up to the crowd

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_brc" # Path to ettv.x86. Use absolute paths here!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1"
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400"

#
# Other relevant settings
#
SHOUTCAST_DELAY="60" # Delay between live match & broadcasting hub in seconds

BROADCASTER_SLOTS="100"
BROADCASTER_PRIVATE_SLOTS="10"
BROADCASTER_ETTV_SLAVES="0"

ALLOW_DL="1"
ALLOW_WWW_DL="1" # Allow downloading over http?
WWW_DL_URL="http://www.yoursite.org" # No "/" at the end!

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path
# where all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying #
# #
#################################################################
#
# Assembling the Command Line
#
RECORDER_HOMEPATH="$BASEPATH/$MATCH_DATE/recorder"
BROADCASTER_HOMEPATH="$BASEPATH/$MATCH_DATE/broadcaster"

BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"

RECORDER_OPTIONS="\
+set fs_game etpro \
+set dedicated 1 \
+map oasis \
+set net_ip $THISHOST_IP \
+set net_port $RECORDER_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $RECORDER_HOMEPATH \
+set com_hunkMegs 128 \
+set g_password $RECORDER_PASS \
+set rconpassword $RCON_PASS \
+set sv_hostname $RECORDER_HOSTNAME \
+set sv_maxclients 4 \
+set sv_maxRate 25000 \
+set sv_allowDownload 0 \
+set sv_wwwDownload 0 \
+set sv_wwwBaseURL "$WWW_DL_URL" \
+set sv_wwwDlDisconnected 0 \
+set g_log "recorder.log" \
+set logfile 2 \
+set b_ettv_flags 3 \
+set ettv_sv_maxslaves 2 \
+set ettv_clientname $ETTV_CLIENT \
+set ettv_password $BROADCASTER_ETTV_PASS \
+set ettv_netblast $ETTV_NETBLAST \
+set ettv_tv_iptos $ETTV_TV_IPTOS \
+set ettv_sv_iptos $ETTV_SV_IPTOS \
+set ettv_mtu $ETTV_MTU \
+set ettv_autorecord 1 \
+set ettv_delay 1 \
+tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS"

BROADCASTER_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set net_ip $THISHOST_IP \
+set net_port $BROADCASTER_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $BROADCASTER_HOMEPATH \
+set com_hunkMegs 160 \
+set sv_maxclients $BROADCASTER_SLOTS \
+set sv_privateclients $BROADCASTER_PRIVATE_SLOTS \
+set sv_privatepassword $BROADCASTER_PRIVATE_PASS \
+set sv_hostname $BROADCASTER_HOSTNAME \
+set g_password $BROADCASTER_PASS \
+set rconpassword $RCON_PASS \
+set sv_maxRate 18000 \
+set sv_allowDownload $ALLOW_DL \
+set sv_wwwDownload $ALLOW_WWW_DL \
+set sv_wwwBaseURL "$WWW_DL_URL" \
+set sv_wwwDlDisconnected 0 \
+set g_log "broadcaster.log" \
+set logfile 2 \
+set ettv_autoplay 1 \
+set ettv_password $BROADCASTER_ETTV_PASS \
+set b_ettv_flags 3 \
+set ettv_sv_maxslaves $BROADCASTER_ETTV_SLAVES \
+demo demo0000"

#
# Functions
#
broadcast_start (){
#
# FYI'ing the user
#
echo -e "\n"
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $RECORDER_HOMEPATH/etpro/demos/.\n"

echo -n "Starting Recorder: "
screen -dmS recorder su -m -c "$DAEMON $RECORDER_OPTIONS" - $USER
echo "done."

get_pids

echo -n "Recorder has PID "
echo -n $RECORDER_PID

echo -e ".\n\nSleeping for $SHOUTCAST_DELAY seconds."
sleep $SHOUTCAST_DELAY

mkdir "$BROADCASTER_HOMEPATH"
mkdir "$BROADCASTER_HOMEPATH/etpro"
ln -s "$RECORDER_HOMEPATH/etpro/demos" "$BROADCASTER_HOMEPATH/etpro"
chown -R $USER "$BROADCASTER_HOMEPATH"
chmod -R 775 "$BROADCASTER_HOMEPATH"

echo -n "Starting Broadcaster: "
screen -dmS broadcaster su -m -c "$DAEMON $BROADCASTER_OPTIONS" - $USER
echo -e "done.\n"

echo -e "Getting PIDs...\n"
sleep 1

get_pids

echo -n "Recorder has PID "
echo -n $RECORDER_PID
echo -e ".\n\nBroadcaster has PID "
echo -e "$BROADCASTER_PID.\n"
}

broadcast_stop (){

get_pids

echo -n "Shutting Down Broadcaster: "
sleep 1
if [ $BROADCASTER_PID ]
then
kill -3 $BROADCASTER_PID
echo -e "done."
else
echo -e "failed.\nBroadcaster wasn't active anymore.\n"
fi

echo -n "Shutting Down Recorder: "
sleep 1
if [ $RECORDER_PID ]
then
kill -3 $RECORDER_PID
echo -e "done."
else
echo -e "failed.\nRecorder wasn't active anymore.\n"
fi

sleep 1
clean_up
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

get_pids (){
#
# Pulling some very ugly tricks here
#
RECORDER_PID=`ps aux|grep "+set net_port $RECORDER_PORT"|grep -v "su -m -c"|grep -v "SCREEN -dmS"\|awk '{ print $1 $2 }'|tr -d "$USER"`
BROADCASTER_PID=`ps aux|grep "+set net_port $BROADCASTER_PORT"|grep -v "su -m -c"|grep -v "SCREEN -dmS"|awk '{ print $1 $2 }'|tr -d "$USER"`
}

#
# Performing The magic :-)
#

case "$1" in
start)
broadcast_start
;;
stop)
broadcast_stop
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop}"
exit 1
;;
esac
exit 0
</pre>

=== Sanitization script ===

This is a script to restore an ETTV directory to the bare minimum required to broadcast matches or be a hub. It isn't a very advanced script but it gets the job done. Copy / paste this script and save it as <code>sanitize.sh</code> or any other name you prefer. Just do <code>./sanitize.sh</code> do delete all files in etmain & etpro that are not needed anymore.

''Note'': this script deletes '''everything''' it finds in the etmain and etpro directories. If you have stuff that you do not want to delete in there, add it to the ETMAIN_FILES & ETPRO_FILES arrays.

<pre>#!/bin/bash

#################################################################
# #
# ettv clean-up script #
# - #
# deej. #
# #
#################################################################
# #
# This script is used to restore an ETTV directory to the bare #
# minimum in terms of files. #
# #
# Use it to clean up after an ETTV session so you can start the #
# next session with a minimum of PK3s. #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################

ETMAIN_FILES=(\
"description.txt" \
"hunkusage.dat" \
"mp_bin.pk3" \
"pak0.pk3" \
"pak1.pk3" \
"pak2.pk3" \
"et_ice.pk3" \
"braundorf_b4.pk3" \
"supplydepot2.pk3" \
"sw_goldrush_te.pk3" \
"sw_oasis_b3.pk3")

ETPRO_FILES=(\
"etpro-3_2_4.pk3" \
"etpro_cheats.dat" \
"qagame.mp.i386.so" \
"tvgame.mp.i386.so")

SCRIPT_NAME=`basename $0`

case $1 in
hub)
BASEPATH="/srv/et/ETTV/ettv_hub"
;;
slave)
BASEPATH="/srv/et/ETTV/ettv_slave"
;;
*)
echo -e "\nError: $1 is not a valid installation target."
echo -e "Usage: $SCRIPT_NAME {hub|slave}\n"
exit 1
esac

#
# Test for existence of backup directories
#
if [ ! -d "$BASEPATH/etmain/bak/" ]; then
mkdir "$BASEPATH/etmain/bak"
fi

if [ ! -d "$BASEPATH/etpro/bak/" ]; then
mkdir "$BASEPATH/etpro/bak"
fi

#
# Clear etmain
#
for i in ${ETMAIN_FILES[@]}
do
mv "$BASEPATH/etmain/$i" "$BASEPATH/etmain/bak/"
done
rm $BASEPATH/etmain/*

#
# Clear etpro
#
for i in ${ETPRO_FILES[@]}
do
mv "$BASEPATH/etpro/$i" "$BASEPATH/etpro/bak/"
done
rm $BASEPATH/etpro/*

#
# Restore etmain
#
for i in ${ETMAIN_FILES[@]}
do
mv "$BASEPATH/etmain/bak/$i" "$BASEPATH/etmain/"
done

#
# Restore etpro
#
for i in ${ETPRO_FILES[@]}
do
mv "$BASEPATH/etpro/bak/$i" "$BASEPATH/etpro/"
done

#
# Clean the backup directories
#
rm -Rf $BASEPATH/etmain/bak
rm -Rf $BASEPATH/etpro/bak
</pre>

=== Switching beta's script ===

This script allows you to quickly switch between the different beta's Bani has released. Just save it as <code>switchbeta.sh</code> and adapt the directory fields to your setup.

<pre>#!/bin/bash

#################################################################
# #
# switching ettv betas script #
# - #
# deej. #
# #
#################################################################
# #
# This script allows you to easily switch ETTV beta versions. #
# #
# Just put the ettv-beta[x].zip files in directory $REPODIR, #
# adapt settings for hub & slave and start switching! #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################

#
# Paths & files
#
REPODIR="/srv/et" # Where the ettv-betaX.zip files reside
HUB_DIR="/srv/et/ETTV/ettv_hub"
SLAVE_DIR="/srv/et/ETTV/ettv_slave"

#
# Argument check
#
SCRIPT_NAME=`basename $0`
ARGS=2
E_BADARGS=65

if [ $# -lt "$ARGS" ]
then
echo -e "\nError: missing arguments"
echo -e "Usage: $SCRIPT_NAME {beta number} {hub|slave|broadcast|all}\n"
exit $E_BADARGS
fi

FILENAME="ettv-beta$1.zip"

if [ ! -e "$REPODIR/$FILENAME" ]
then
echo -e "\nError: beta version $1 is not present in $REPODIR."
echo -e "Usage: $SCRIPT_NAME {beta number} {hub|slave|all}\n"
exit $E_BADARGS
fi

case $2 in
hub)
unzip -o "$REPODIR/$FILENAME" -d "$HUB_DIR" ettv.x86
chmod +x "$HUB_DIR/ettv.x86"
unzip -o "$REPODIR/$FILENAME" -d "$HUB_DIR/etpro" tvgame.mp.i386.so
;;
slave)
unzip -o "$REPODIR/$FILENAME" -d "$SLAVE_DIR" ettv.x86
chmod +x "$SLAVE_DIR/ettv.x86"
unzip -o "$REPODIR/$FILENAME" -d "$SLAVE_DIR/etpro" tvgame.mp.i386.so
;;
all)
$0 hub
$0 slave
;;
*)
echo -e "\nError: $2 is not a valid installation target."
echo -e "Usage: $SCRIPT_NAME {beta number} {hub|slave|all}\n"
exit $E_BADARGS
esac
exit 0
</pre>

Have fun broadcasting!

[[User:Deej|deej]]

[[Category:ETTV]]

User talk:RoadKillPuppy

2005-12-02T22:33:27Z

Deej:

Nice mod Puppy, I shall come and spree some more on your server ^^ - [[User:Deej|deej]]

Just FYI - this -1 is actually the client number the sound should be played to, and -1 means broadcasting to all. ;) --Rookie One 11:35, 2 December 2005 (PST)

Yep. RKP had to do it this way since ETPro doesn't have a command to send the sound to only 1 specific player. [[User:Deej|deej]]

User talk:RoadKillPuppy

2005-12-02T16:34:50Z

Deej:

Nice mod Puppy, I shall come and spree some more on your server ^^ - [[User:Deej|deej]]

WolfWiki:Community Portal

2005-11-11T22:32:28Z

Deej: Added Ifurita's site

== News Sites ==

* [http://www.et-center.com/ ET-Center]
* [http://www.xfire.be/ Xfire.be]
* [http://www.gamestv.org/ GAMESTV.ORG]
* [http://www.swertcw.com/ sweRTCW]
* [http://www.planetwolfenstein.com/ Planet Wolfenstein]
* [http://www.etnation.co.uk/ ETNation.co.uk]
* [http://www.splashdamage.com/ SplashDamage.com]
* [http://www.planetwolfenstein.de/ PlanetWolfenstein.de]
* [http://www.rtcw.co.uk/ rtcw.co.uk]
* [http://velocity.lunarpages.com/index.html Unofficial Enemy Territory Strategy Guide]
* [http://www.planetwolfenstein.com/4newbies/ RTCW 4 Newbies]
* [http://www.enemy-territory.com Enemy Territory Resource Site]

== Leagues / Competitions ==

* [http://www.clanbase.com/ Clanbase]
* [http://www.teamwarfare.com/ TeamWarfare League]
* [http://www.sta-league.org/ Stronger Than All]
* [http://www.et-cup.net/ ET-Cup]
* [http://www.warleagues.com/ Warleagues]

== Mods ==

* [http://stealthy.foolishgames.net/ FalckonET]
* [http://www.truecombat.com/intro.php TC:Elite]
* [http://www.omni-bot.com/ Omni-Bot]
* [http://www.priceofpeace.net/ The Price of Peace]
* [http://www.etpub.org/news.php ETPub]
* [http://jaymod.clanfu.org/ Jaymod]
* [http://www.splashdamage.com/index.php?name=pnPHPbb2&file=viewtopic&t=7522 ET-Mod-Project-List]

WolfWiki:Community Portal

2005-11-11T22:03:47Z

Deej: more sites

== News Sites ==

* [http://www.et-center.com/ ET-Center]
* [http://www.xfire.be/ Xfire.be]
* [http://www.gamestv.org/ GAMESTV.ORG]
* [http://www.swertcw.com/ sweRTCW]
* [http://www.planetwolfenstein.com/ Planet Wolfenstein]
* [http://www.etnation.co.uk/ ETNation.co.uk]
* [http://www.splashdamage.com/ SplashDamage.com]
* [http://www.planetwolfenstein.de/ PlanetWolfenstein.de]
* [http://www.rtcw.co.uk/ rtcw.co.uk]
* [http://velocity.lunarpages.com/index.html Unofficial Enemy Territory Strategy Guide]
* [http://www.enemy-territory.com Enemy Territory Resource Site]

== Leagues / Competitions ==

* [http://www.clanbase.com/ Clanbase]
* [http://www.teamwarfare.com/ TeamWarfare League]
* [http://www.sta-league.org/ Stronger Than All]
* [http://www.et-cup.net/ ET-Cup]
* [http://www.warleagues.com/ Warleagues]

== Mods ==

* [http://stealthy.foolishgames.net/ FalckonET]
* [http://www.truecombat.com/intro.php TC:Elite]
* [http://www.omni-bot.com/ Omni-Bot]
* [http://www.priceofpeace.net/ The Price of Peace]
* [http://www.etpub.org/news.php ETPub]
* [http://jaymod.clanfu.org/ Jaymod]
* [http://www.splashdamage.com/index.php?name=pnPHPbb2&file=viewtopic&t=7522 ET-Mod-Project-List]

Color Codes

2005-11-11T21:59:25Z

Deej: even more colours

==What are they?==
Colour codes, as the name suggests, are used to add colour to texts. They have been introduced in Quake III Arena and are available in most Q3-based games, including Enemy Territory. They can be used in most texts that get displayed ingame, such as player names, chat or notices.

'''Usage:''' a dash character ('''^''') followed by another character. Each character produces a different colour. 
'''Example:''' ^1red ^2green ^4blue 
'''Produces:''' red green blue 
==Codes list==
The image below depicts the colours the characters produce, except '''^0''' which, stands for black. Notice that some letters and digits produce the same colour. 
http://velocity.lunarpages.com/images/colors.jpg

User:Deej

2005-11-10T09:19:51Z

Deej: typo

http://www.fragland.org/deej/572.gif 
Guilty for founding the [http://www.fragland.org Retired Old Farts] which provide: 
- ETPro servers 
- ETTV servers 
- ETPub servers 
- General annoyance 
- Pub requests for a competition mod 

== My interpretation of ETTV setups ==

Since I'm quite fond of toying around with new developments, I'm always one of the first to test new ETTV / ETPro releases and bug bani with questions about them. Having said that, here's my 'personal' view on a good ETTV broadcast (this is not the Bible!):

=== Terminology ===

There are 5 different "participants" possibly involved in an ETTV broadcast:

* '''Master''' - the gameserver hosting the actual game
* '''Viewer''' - the viewer wanting to view a game (duh)
* '''Broadcaster''' - a server that is directly connected to a gameserver and allows viewer to connect directly to itself
* '''Hub''' - a server that is directly connected to a gameserver and allows other ETTV 'slaves' to connect to itself, but not viewers
* '''Slave''' - a server that connects to a hub or perhaps a broadcaster and and allows viewers to connect to itself

Keep this terminology in mind when you stroll through my text ;-).

=== Today's broadcasts ===

Most ETTV games I see today use this set-up:

:<code>Viewer -> Broadcaster -> Master</code>

If you remember that an ETTV server connects at an ''unlimited rate'' to another server, you might see a problem arising when lots of people would like to see a "big match".

The trouble was / is that before ETTV b8 and 'autodelay', we had to do some fancy flying to get a delayed broadcast or delayed hub up. Usually you would start a 'recorder' daemon that recorded demos and a 'playback' daemon from that same directory, so that it started playing back the recorded demo after roughly 60 or 90 seconds. This does require fancy scripting and lots of manual work to sort out demos, connect slaves to hubs etc...

With <code>ettv_autodelay</code>, things have become a lot easier. Ideally the gameserver now only allows 2 or 4 ETTV hubs to connect to it, which delay and relay the signal. The responsibility for the admins of the hub is of course greater as they should not have any PK3s active on their hubs that are not on the pure list of the server. The less PK3s you need, the better!

=== Deej's proposition ===

The best setup IMHO is to have the following:

<pre>Viewers -> Slave 1 |
Viewers -> Slave 2 |
Viewers -> Slave 3 |--> Hub 1 |
|--> Hub 2 | --> Master
Viewers -> Slave ... |--> Hub n |
|
Viewers -> Slave n |</pre>

This alleviates the load on the Master Game Server firmly as only 2 or 4 hubs are required where slaves can then connect to! Furthermore with autodelay all the 'slave' administrators only need to connect their slave to a given hub. No more playing around with delays, demos, symbolic links, PIDs that get screwed up etc...

== Some scripts I use ==

=== Hub script ===

This script launches a hub that delays its feed by x seconds, configurable inside the script. You can safely remove the stuff like PERONI_IP, FRAGLAND_IP etc... at the beginning since those only store the IPs of the root servers we manage (it's easier for me to keep track of them that way).

'''How do you use this script?''' Copy / paste this script and save it as <code>hub.sh</code> or any other name you prefer. Then use <code>./hub.sh start</code> to start and <code>./hub.sh stop</code> to stop your hub.

Be aware that it's much better to actually do "quit" in the console of your hub instead of <code>./hub.sh stop</code> as this cleanly disconnects the hub from a game server. With <code>./hub.sh stop</code> the hub stays with ping 999 on the gameserver and needs to time out. Maybe we should ask Bani to improve POSIX signal interpretation of the ETTV binary :-).

<pre>#!/bin/bash

#################################################################
# #
# reT!reD.ettv delayed hub script #
# - #
# reT!reD.deej #
# #
#################################################################
# #
# This script can be used to start up a delayed ETTV stream #
# where ETTV slaves connect to the hub to relay the signal. #
# #
# The daemon serves as a hub for other ETTV slaves to connect #
# to and as such alleviate the load on the game server hosting #
# the match. #
# #
# This script creates a subdirectory which represents the #
# date of the match and stores the demos in this subdir. #
# #
# The script launches the daemon in a different screen #
# which you can reattach with "screen -r hub". #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# - aNgel (fragland.org) for debugging Beavis' mistakes ;-) #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################
# #
# http://www.fragland.org #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# WServer2.ath.cx IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# Start Modifying From Here #
# #
#################################################################
#
# Parameters of the Game Server to Connect to
#
# IMPORTANT: Let the admin of the game server do
# "fdir *.pk3" in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Do NOT modify
MATCH_HOST="et.fragland.org:27965" # Match server port & address
MATCH_ETTV_PASS="[get_pass_from_admin]" # Match server ETTV password
MATCH_PASS="[get_pass_from_admin]" # Match server password

#
# IPs & Ports For Your Host
#
THISHOST_IP=$PERONI_IP # Replace with your IP
HUB_PORT="50000" # Port of the public hub for ETTV slaves

#
# Hostnames & ETTV Client name
#
# - hostname shows up in server browsers
# - ETTV client name shows up as the name
# of your server in the game server.
#
HUB_HOSTNAME="^7reT^1!^7reD^1.^7ettv ^7hub ^1#^71"
ETTV_CLIENT=$HUB_HOSTNAME

#
# Passwords
#
HUB_RCON_PASS="[put_your_pass_here]"
HUB_PRIVATE_PASS="[put_your_pass_here]"
HUB_ETTV_PASS="[put_your_pass_here]"
HUB_PASS="[put_your_pass_here]"

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_hub" # Path to ettv.x86. Use absolute paths!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1" # Sends all packets as one big one
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400" # Can be increased to avoid fragmentation

#
# Other relevant ETTV settings
#
SHOUTCAST_DELAY="60" # Delay between live match & broadcasting hub in seconds
HUB_SLAVES="8" # 1 ETTV slave connects at an UNLIMITED rate to the hub!
ALLOW_DL="0" # Allow downloading (only works for viewers on slaves)
ALLOW_WWW_DL="0" # Allow downloading over http?
WWW_DL_URL="http://www.yoursite.com" # Do not append a "/" at the end!

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed can not log in. His homedir is equal to the path
# where all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying Here #
# #
#################################################################
#
# Assembling the Command Line
#
HOMEPATH="$BASEPATH/$MATCH_DATE"

BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"

HUB_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set net_ip $THISHOST_IP \
+set net_port $HUB_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $HOMEPATH \
+set com_hunkMegs 128 \
+set g_password $HUB_PASS \
+set rconpassword $HUB_RCON_PASS \
+set sv_hostname $HUB_HOSTNAME \
+set sv_maxclients $((HUB_SLAVES+2)) \
+set sv_maxRate 25000 \
+set sv_allowDownload $ALLOW_DL \
+set sv_wwwDownload $ALLOW_WWW_DL \
+set sv_wwwBaseURL "$WWW_DL_URL" \
+set sv_wwwDlDisconnected 0 \
+set g_log "hub.log" \
+set logfile 2 \
+set b_ettv_flags 3 \
+set ettv_autorecord 1 \
+set ettv_clientname $ETTV_CLIENT \
+set ettv_sv_maxslaves $HUB_SLAVES \
+set ettv_password $HUB_ETTV_PASS \
+set ettv_netblast $ETTV_NETBLAST \
+set ettv_tv_iptos $ETTV_TV_IPTOS \
+set ettv_sv_iptos $ETTV_SV_IPTOS \
+set ettv_mtu $ETTV_MTU \
+set ettv_delay $SHOUTCAST_DELAY \
+tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS"

#
# Functions
#

hub_start () {
#
# FYI'ing the user
#
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $HOMEPATH/etpro/demos/.\n"

echo -n "Starting Hub: "
screen -dmS hub su -m -c "$DAEMON $HUB_OPTIONS" - $USER
sleep 1
echo -e "done.\n"

echo -e "Getting PID...\n"

get_pids

echo -n "Hub has PID "
echo -e "$HUB_PID\n"

echo "ETTV slaves can now connect to your box by issuing:"
echo -e "tv connect $THISHOST_IP:$HUB_PORT $HUB_ETTV_PASS $HUB_PASS\n"
}

hub_stop () {
#
# Refresh the PIDs
#
get_pids

echo -n "Shutting Down Hub: "
sleep 1
if [ $HUB_PID ]
then
kill -3 $HUB_PID
echo -e "done."
else
echo -e "failed.\nHub wasn't active anymore.\n"
fi

sleep 1
}

get_pids (){
#
# We used to launch the same binary twice so pidof didn't work.
# As from beta 8 ettv delayed feeds were automatic so
# no more fancy scripting tricks are required :-)
#
HUB_PID=`pidof $DAEMON`
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

#
# Performing The magic :-)
#

case "$1" in
start)
hub_start
;;
stop)
hub_stop
clean_up
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop}"
exit 1
;;
esac
exit 0
</pre>

=== Slave script ===

This script connects an undelayed slave to a hub (that hopefully delays the signal ;-)). The usage of this script is very similar to the Hub script. Copy / paste it and save it as <code>slave.sh</code> or any other name you prefer. THen issue <code>./slave.sh start</code> to start your slave and <code>./slave.sh stop</code> to stop it. Like above, it is actually better to do quit in the console instead of just killing the slave with this script.

<pre>#!/bin/bash

#################################################################
# #
# reT!reD.ettv slave script #
# - #
# reT!reD.deej #
# #
#################################################################
# #
# This script can be used to start up an ETTV slave to connect #
# to a HUB provided by another server. #
# #
# This script launches the daemon in a different screen which #
# you can reattach with "screen -r slave" #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# - aNgel (fragland.org) for debugging Beavis' mistakes ;-) #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################
# #
# http://www.fragland.org #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# WServer2.ath.cx IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# Start Modifying From Here #
# #
#################################################################
#
# Hub Info
#
# IMPORTANT: Let the admin of the hub do a
# fdir *.pk3 in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#

HUB_IP=$PERONI_IP # Hub runs on Webperoni
HUB_PORT="50000"
HUB_ETTV_PASS="[get_pass_from_hub_admin]"
HUB_PASS="[get_pass_from_hub_admin]"
HUB_HOST="$HUB_IP:$HUB_PORT"

#
# Slave Info
#

SLAVE_IP=$FRAGLAND_IP # select from list above
SLAVE_PORT="27960" # port of the public broadcaster
SLAVE_HOSTNAME="^7reT^1!^7reD^1.^7ettv ^1#^72"

ETTV_CLIENT=$SLAVE_HOSTNAME # Shows up on Hub

SLAVE_SLOTS="100"
SLAVE_PASS="[put_your_pass_here]"

SLAVE_PRIVATE_SLOTS="10"
SLAVE_PRIVATE_PASS="[put_your_pass_here]"

SLAVE_ETTV_SLAVES="0"
SLAVE_ETTV_PASS="[put_your_pass_here]"

RCON_PASS="[put_your_pass_here]"

ALLOW_DL="1"
ALLOW_WWW_DL="1" # Allow downloading over http?
WWW_DL_URL="http://www.yoursite.com" # No "/" at the end!

RECORD_GAME="0" # 1 = record the game, 0 = don't

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_slave" # Path to ettv.x86. Use absolute paths here!

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path where
# all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying Here #
# #
#################################################################
#
# Assembling the Command Line
#
BINARY="ettv.x86"

DAEMON="$BASEPATH/$BINARY"
HOMEPATH="$BASEPATH"

SLAVE_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set net_ip $SLAVE_IP \
+set net_port $SLAVE_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $HOMEPATH \
+set com_hunkMegs 128 \
+set sv_maxclients $SLAVE_SLOTS \
+set sv_privateclients $SLAVE_PRIVATE_SLOTS \
+set sv_privatepassword $SLAVE_PRIVATE_PASS \
+set sv_hostname $SLAVE_HOSTNAME \
+set ettv_delay 0 \
+set ettv_autorecord $RECORD_GAME \
+set ettv_clientname $ETTV_CLIENT \
+set g_password $SLAVE_PASS \
+set rconpassword $RCON_PASS \
+set sv_maxRate 18000 \
+set sv_allowDownload $ALLOW_DL \
+set sv_wwwDownload $ALLOW_WWW_DL \
+set sv_wwwBaseURL "$WWW_DL_URL" \
+set sv_wwwDlDisconnected 0 \
+set g_log "slave.log" \
+set logfile 2 \
+tv connect $HUB_HOST $HUB_ETTV_PASS $HUB_PASS"

#
# Functions
#

slave_start (){
#
# FYI'ing the user
#
echo -n "Starting Slave: "

screen -dmS slave su -m -c "$DAEMON $SLAVE_OPTIONS" - $USER

echo -e "done.\n"

echo -e "Getting PID...\n"
sleep 1

SLAVE_PID=`pidof $DAEMON`

echo -n "Slave has PID "
echo -e "$SLAVE_PID.\n"
}

slave_stop (){
#
# Refresh the PID
#
SLAVE_PID=`pidof $DAEMON`

echo -n "Shutting Down Slave: "
sleep 1
if [ $SLAVE_PID ]
then
kill -3 $SLAVE_PID
echo -e "done."
else
echo -e "failed.\nSlave wasn't active anymore.\n"
fi
}

#
# Performing The magic :-)
#

case "$1" in
start)
slave_start
;;
stop)
slave_stop
;;
restart)
slave_stop
sleep 1
slave_start
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop|restart}"
exit 1
;;
esac
exit 0
</pre>

=== Old school record / playback script ===

This is a script to broadcast a game the old-fashioned way. It records a demo and starts playing it back after roughly 60 seconds. There's some symbolic linking stuff done inside to make sure it stores all the logs, otherwise the 'broadcaster' would override the recorder's log, ''which makes broadcasting very hard to debug'' :-)!

Copy / paste this script and save it as <code>broadcast.sh</code> or any other name you prefer. The usual comments on quit and 999 are applicable here as well. This script "should" work with ETTV earlier then b8. However, YMMV.

<pre>#!/bin/bash

#################################################################
# #
# reT!reD.ettv delayed broadcast script #
# - #
# reT!reD.deej #
# #
#################################################################
# #
# This script can be used to start up a delayed ETTV stream #
# where viewers connect directly to the broadcaster. #
# #
# This script creates a subdirectory which represents the #
# date of the match and stores the demos in this subdir. #
# #
# The script launches the daemons in different screens #
# which you can reattach with "screen -r recorder" #
# or "screen -r broadcaster". #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# - aNgel (fragland.org) for debugging Beavis' mistakes ;-) #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################
# #
# http://www.fragland.org #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# WServer2.ath.cx IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# START Modifying #
# #
#################################################################
#
# Parameters of the Game Server to Connect to
#
# IMPORTANT: Let the admin of the game server do
# "fdir *.pk3" in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Today's date for creating the subdir
MATCH_HOST="et.fragland.org:27965" # Match server port & address
MATCH_ETTV_PASS="[get_pass_from_admin]" # Match server ETTV password
MATCH_PASS="[get_pass_from_admin]" # Match server password

#
# IPs & Ports For Your Host
#
THISHOST_IP=$PERONI_IP # This host is Webperoni
RECORDER_PORT="44999" # Port of the private recorder
BROADCASTER_PORT="27960" # Port of the public broadcaster

#
# Hostnames & ETTV Client name
#
# - hostname shows up in server browsers
# - ETTV client name shows up as the name
# of your server in the game server.
#
RECORDER_HOSTNAME="^7reT^1!^7reD^1.^7ettv ^7recorder ^1#^71"
BROADCASTER_HOSTNAME="^7reT^1!^7reD^1.^7ettv ^1#^71"

ETTV_CLIENT=$BROADCASTER_HOSTNAME

#
# Passwords
#
RCON_PASS="[put_your_pass_here]"
RECORDER_PASS="[put_your_pass_here]"
BROADCASTER_PRIVATE_PASS="[put_your_pass_here]"
BROADCASTER_ETTV_PASS="[put_your_pass_here]"
BROADCASTER_PASS="[put_your_pass_here]" # Issue /rcon g_password "" for opening it up to the crowd

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_brc" # Path to ettv.x86. Use absolute paths here!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1"
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400"

#
# Other relevant settings
#
SHOUTCAST_DELAY="60" # Delay between live match & broadcasting hub in seconds

BROADCASTER_SLOTS="100"
BROADCASTER_PRIVATE_SLOTS="10"
BROADCASTER_ETTV_SLAVES="0"

ALLOW_DL="1"
ALLOW_WWW_DL="1" # Allow downloading over http?
WWW_DL_URL="http://www.yoursite.org" # No "/" at the end!

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path
# where all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying #
# #
#################################################################
#
# Assembling the Command Line
#
RECORDER_HOMEPATH="$BASEPATH/$MATCH_DATE/recorder"
BROADCASTER_HOMEPATH="$BASEPATH/$MATCH_DATE/broadcaster"

BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"

RECORDER_OPTIONS="\
+set fs_game etpro \
+set dedicated 1 \
+map oasis \
+set net_ip $THISHOST_IP \
+set net_port $RECORDER_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $RECORDER_HOMEPATH \
+set com_hunkMegs 128 \
+set g_password $RECORDER_PASS \
+set rconpassword $RCON_PASS \
+set sv_hostname $RECORDER_HOSTNAME \
+set sv_maxclients 4 \
+set sv_maxRate 25000 \
+set sv_allowDownload 0 \
+set sv_wwwDownload 0 \
+set sv_wwwBaseURL "$WWW_DL_URL" \
+set sv_wwwDlDisconnected 0 \
+set g_log "recorder.log" \
+set logfile 2 \
+set b_ettv_flags 3 \
+set ettv_sv_maxslaves 2 \
+set ettv_clientname $ETTV_CLIENT \
+set ettv_password $BROADCASTER_ETTV_PASS \
+set ettv_netblast $ETTV_NETBLAST \
+set ettv_tv_iptos $ETTV_TV_IPTOS \
+set ettv_sv_iptos $ETTV_SV_IPTOS \
+set ettv_mtu $ETTV_MTU \
+set ettv_autorecord 1 \
+set ettv_delay 1 \
+tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS"

BROADCASTER_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set net_ip $THISHOST_IP \
+set net_port $BROADCASTER_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $BROADCASTER_HOMEPATH \
+set com_hunkMegs 160 \
+set sv_maxclients $BROADCASTER_SLOTS \
+set sv_privateclients $BROADCASTER_PRIVATE_SLOTS \
+set sv_privatepassword $BROADCASTER_PRIVATE_PASS \
+set sv_hostname $BROADCASTER_HOSTNAME \
+set g_password $BROADCASTER_PASS \
+set rconpassword $RCON_PASS \
+set sv_maxRate 18000 \
+set sv_allowDownload $ALLOW_DL \
+set sv_wwwDownload $ALLOW_WWW_DL \
+set sv_wwwBaseURL "$WWW_DL_URL" \
+set sv_wwwDlDisconnected 0 \
+set g_log "broadcaster.log" \
+set logfile 2 \
+set ettv_autoplay 1 \
+set ettv_password $BROADCASTER_ETTV_PASS \
+set b_ettv_flags 3 \
+set ettv_sv_maxslaves $BROADCASTER_ETTV_SLAVES \
+demo demo0000"

#
# Functions
#
broadcast_start (){
#
# FYI'ing the user
#
echo -e "\n"
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $RECORDER_HOMEPATH/etpro/demos/.\n"

echo -n "Starting Recorder: "
screen -dmS recorder su -m -c "$DAEMON $RECORDER_OPTIONS" - $USER
echo "done."

get_pids

echo -n "Recorder has PID "
echo -n $RECORDER_PID

echo -e ".\n\nSleeping for $SHOUTCAST_DELAY seconds."
sleep $SHOUTCAST_DELAY

mkdir "$BROADCASTER_HOMEPATH"
mkdir "$BROADCASTER_HOMEPATH/etpro"
ln -s "$RECORDER_HOMEPATH/etpro/demos" "$BROADCASTER_HOMEPATH/etpro"
chown -R $USER "$BROADCASTER_HOMEPATH"
chmod -R 775 "$BROADCASTER_HOMEPATH"

echo -n "Starting Broadcaster: "
screen -dmS broadcaster su -m -c "$DAEMON $BROADCASTER_OPTIONS" - $USER
echo -e "done.\n"

echo -e "Getting PIDs...\n"
sleep 1

get_pids

echo -n "Recorder has PID "
echo -n $RECORDER_PID
echo -e ".\n\nBroadcaster has PID "
echo -e "$BROADCASTER_PID.\n"
}

broadcast_stop (){

get_pids

echo -n "Shutting Down Broadcaster: "
sleep 1
if [ $BROADCASTER_PID ]
then
kill -3 $BROADCASTER_PID
echo -e "done."
else
echo -e "failed.\nBroadcaster wasn't active anymore.\n"
fi

echo -n "Shutting Down Recorder: "
sleep 1
if [ $RECORDER_PID ]
then
kill -3 $RECORDER_PID
echo -e "done."
else
echo -e "failed.\nRecorder wasn't active anymore.\n"
fi

sleep 1
clean_up
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

get_pids (){
#
# Pulling some very ugly tricks here
#
RECORDER_PID=`ps aux|grep "+set net_port $RECORDER_PORT"|grep -v "su -m -c"|grep -v "SCREEN -dmS"\|awk '{ print $1 $2 }'|tr -d "$USER"`
BROADCASTER_PID=`ps aux|grep "+set net_port $BROADCASTER_PORT"|grep -v "su -m -c"|grep -v "SCREEN -dmS"|awk '{ print $1 $2 }'|tr -d "$USER"`
}

#
# Performing The magic :-)
#

case "$1" in
start)
broadcast_start
;;
stop)
broadcast_stop
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop}"
exit 1
;;
esac
exit 0
</pre>

=== Sanitization script ===

This is a script to restore an ETTV directory to the bare minimum required to broadcast matches or be a hub. It isn't a very advanced script but it gets the job done. Copy / paste this script and save it as <code>sanitize.sh</code> or any other name you prefer. Just do <code>./sanitize.sh</code> do delete all files in etmain & etpro that are not needed anymore.

''Note'': this script deletes '''everything''' it finds in the etmain and etpro directories. If you have stuff that you do not want to delete in there, add it to the ETMAIN_FILES & ETPRO_FILES arrays.

<pre>#!/bin/bash

#################################################################
# #
# reT!reD.ettv clean-up script #
# - #
# reT!reD.deej #
# #
#################################################################
# #
# This script is used to restore an ETTV directory to the bare #
# minimum in terms of files. #
# #
# Use it to clean up after an ETTV session so you can start the #
# next session with a minimum of PK3s. #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################
# #
# http://www.fragland.org #
# #
#################################################################

ETMAIN_FILES=("description.txt" "hunkusage.dat" "mp_bin.pk3" "pak0.pk3" "pak1.pk3" "pak2.pk3" "qagame.mp.i386.so")
ETPRO_FILES=("etpro-3_2_0.pk3" "etpro_cheats.dat" "qagame.mp.i386.so" "tvgame.mp.i386.so" "animations" "configs" "maps" "etpromapscripts")

BASEPATH="/srv/et/ETTV/ettv_hub"

#
# Test for existence of backup directories
#
if [ ! -d "$BASEPATH/etmain/bak/" ]; then
mkdir "$BASEPATH/etmain/bak"
fi

if [ ! -d "$BASEPATH/etpro/bak/" ]; then
mkdir "$BASEPATH/etpro/bak"
fi

#
# Clear etmain
#
for i in ${ETMAIN_FILES[@]}
do
mv "$BASEPATH/etmain/$i" "$BASEPATH/etmain/bak/"
done
rm $BASEPATH/etmain/*

#
# Clear etpro
#
for i in ${ETPRO_FILES[@]}
do
mv "$BASEPATH/etpro/$i" "$BASEPATH/etpro/bak/"
done
rm $BASEPATH/etpro/*

#
# Restore etmain
#
for i in ${ETMAIN_FILES[@]}
do
mv "$BASEPATH/etmain/bak/$i" "$BASEPATH/etmain/"
done

#
# Restore etpro
#
for i in ${ETPRO_FILES[@]}
do
mv "$BASEPATH/etpro/bak/$i" "$BASEPATH/etpro/"
done

#
# Clean the backup directories
#
rm -Rf $BASEPATH/etmain/bak
rm -Rf $BASEPATH/etpro/bak
</pre>

Have fun broadcasting!

[[User:Deej|deej]] 01:18, 10 November 2005 (PST)

[[Category:ETTV]]

User:Deej

2005-11-10T09:18:34Z

Deej:

http://www.fragland.org/deej/572.gif 
Guilty for founding the [http://www.fragland.org Retired Old Farts] which provide: 
- ETPro servers 
- ETTV servers 
- ETPub servers 
- General annoyance 
- Pub requests for a competition mod 

== My interpretation of ETTV setups ==

Since I'm quite fond of toying around with new developments, I'm always one of the first to test new ETTV / ETPro releases and bug bani with questions about them. Having said that, here's my 'personal' view on a good ETTV broadcast (this is not the Bible!):

=== Terminology ===

There are 5 different "participants" possibly involved in an ETTV broadcast:

* '''Master''' - the gameserver hosting the actual game
* '''Viewer''' - the viewer wanting to view a game (duh)
* '''Broadcaster''' - a server that is directly connected to a gameserver and allows viewer to connect directly to itself
* '''Hub''' - a server that is directly connected to a gameserver and allows other ETTV 'slaves' to connect to itself, but not viewers
* '''Slave''' - a server that connects to a hub or perhaps a broadcaster and and allows viewers to connect to itself

Keep this terminology in mind when you stroll through my text ;-).

=== Today's broadcasts ===

Most ETTV games I see today use this set-up:

:<code>Viewer -> Broadcaster -> Master</code>

If you remember that an ETTV server connects at an ''unlimited rate'' to another server, you might see a problem arising when lots of people would like to see a "big match".

The trouble was / is that before ETTV b8 and 'autodelay', we had to do some fancy flying to get a delayed broadcast or delayed hub up. Usually you would start a 'recorder' daemon that recorded demos and a 'playback' daemon from that same directory, so that it started playing back the recorded demo after roughly 60 or 90 seconds. This does require fancy scripting and lots of manual work to sort out demos, connect slaves to hubs etc...

With <code>ettv_autodelay</code>, things have become a lot easier. Ideally the gameserver now only allows 2 or 4 ETTV hubs to connect to it, which delay and relay the signal. The responsibility for the admins of the hub is of course greater as they should not have any PK3s active on their hubs that are not on the pure list of the server. The less PK3s you need, the better!

=== Deej's proposition ===

The best setup IMHO is to have the following:

<pre>Viewers -> Slave 1 |
Viewers -> Slave 2 |
Viewers -> Slave 3 |--> Hub 1 |
|--> Hub 2 | --> Master
Viewers -> Slave ... |--> Hub n |
|
Viewers -> Slave n |</pre>

This alleviates the load on the Master Game Server firmly as only 2 or 4 hubs are required where slaves can then connect to! Furthermore with autodelay all the 'slave' administrators only need to connect their slave to a given hub. No more playing around with delays, demos, symbolic links, PIDs that get screwed up etc...

== Some scripts I use ==

=== Hub script ===

This script launches a hub that delays its feed by x seconds, configurable inside the script. You can safely remove the stuff like PERONI_IP, FRAGLAND_IP etc... at the beginning since those only store the IPs of the root servers we manage (it's easier for me to keep track of them that way).

'''How do you use this script?''' Copy / paste this script and save it as <code>hub.sh</code> or any other name you prefer. Then use <code>./hub.sh start</code> to start and <code>./hub.sh stop</code> to stop your hub.

Be aware that it's much better to actually do "quit" in the console of your hub instead of <code>./hub.sh stop</code> as this cleanly disconnects the hub from a game server. With <code>./hub.sh stop</code> the hub stays with ping 999 on the gameserver and needs to time out. Maybe we should ask Bani to improve POSIX signal interpretation of the ETTV binary :-).

<pre>#!/bin/bash

#################################################################
# #
# reT!reD.ettv delayed hub script #
# - #
# reT!reD.deej #
# #
#################################################################
# #
# This script can be used to start up a delayed ETTV stream #
# where ETTV slaves connect to the hub to relay the signal. #
# #
# The daemon serves as a hub for other ETTV slaves to connect #
# to and as such alleviate the load on the game server hosting #
# the match. #
# #
# This script creates a subdirectory which represents the #
# date of the match and stores the demos in this subdir. #
# #
# The script launches the daemon in a different screen #
# which you can reattach with "screen -r hub". #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# - aNgel (fragland.org) for debugging Beavis' mistakes ;-) #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################
# #
# http://www.fragland.org #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# WServer2.ath.cx IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# Start Modifying From Here #
# #
#################################################################
#
# Parameters of the Game Server to Connect to
#
# IMPORTANT: Let the admin of the game server do
# "fdir *.pk3" in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Do NOT modify
MATCH_HOST="et.fragland.org:27965" # Match server port & address
MATCH_ETTV_PASS="[get_pass_from_admin]" # Match server ETTV password
MATCH_PASS="[get_pass_from_admin]" # Match server password

#
# IPs & Ports For Your Host
#
THISHOST_IP=$PERONI_IP # Replace with your IP
HUB_PORT="50000" # Port of the public hub for ETTV slaves

#
# Hostnames & ETTV Client name
#
# - hostname shows up in server browsers
# - ETTV client name shows up as the name
# of your server in the game server.
#
HUB_HOSTNAME="^7reT^1!^7reD^1.^7ettv ^7hub ^1#^71"
ETTV_CLIENT=$HUB_HOSTNAME

#
# Passwords
#
HUB_RCON_PASS="[put_your_pass_here]"
HUB_PRIVATE_PASS="[put_your_pass_here]"
HUB_ETTV_PASS="[put_your_pass_here]"
HUB_PASS="[put_your_pass_here]"

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_hub" # Path to ettv.x86. Use absolute paths!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1" # Sends all packets as one big one
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400" # Can be increased to avoid fragmentation

#
# Other relevant ETTV settings
#
SHOUTCAST_DELAY="60" # Delay between live match & broadcasting hub in seconds
HUB_SLAVES="8" # 1 ETTV slave connects at an UNLIMITED rate to the hub!
ALLOW_DL="0" # Allow downloading (only works for viewers on slaves)
ALLOW_WWW_DL="0" # Allow downloading over http?
WWW_DL_URL="http://www.yoursite.com" # Do not append a "/" at the end!

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed can not log in. His homedir is equal to the path
# where all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying Here #
# #
#################################################################
#
# Assembling the Command Line
#
HOMEPATH="$BASEPATH/$MATCH_DATE"

BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"

HUB_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set net_ip $THISHOST_IP \
+set net_port $HUB_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $HOMEPATH \
+set com_hunkMegs 128 \
+set g_password $HUB_PASS \
+set rconpassword $HUB_RCON_PASS \
+set sv_hostname $HUB_HOSTNAME \
+set sv_maxclients $((HUB_SLAVES+2)) \
+set sv_maxRate 25000 \
+set sv_allowDownload $ALLOW_DL \
+set sv_wwwDownload $ALLOW_WWW_DL \
+set sv_wwwBaseURL "$WWW_DL_URL" \
+set sv_wwwDlDisconnected 0 \
+set g_log "hub.log" \
+set logfile 2 \
+set b_ettv_flags 3 \
+set ettv_autorecord 1 \
+set ettv_clientname $ETTV_CLIENT \
+set ettv_sv_maxslaves $HUB_SLAVES \
+set ettv_password $HUB_ETTV_PASS \
+set ettv_netblast $ETTV_NETBLAST \
+set ettv_tv_iptos $ETTV_TV_IPTOS \
+set ettv_sv_iptos $ETTV_SV_IPTOS \
+set ettv_mtu $ETTV_MTU \
+set ettv_delay $SHOUTCAST_DELAY \
+tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS"

#
# Functions
#

hub_start () {
#
# FYI'ing the user
#
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $HOMEPATH/etpro/demos/.\n"

echo -n "Starting Hub: "
screen -dmS hub su -m -c "$DAEMON $HUB_OPTIONS" - $USER
sleep 1
echo -e "done.\n"

echo -e "Getting PID...\n"

get_pids

echo -n "Hub has PID "
echo -e "$HUB_PID\n"

echo "ETTV slaves can now connect to your box by issuing:"
echo -e "tv connect $THISHOST_IP:$HUB_PORT $HUB_ETTV_PASS $HUB_PASS\n"
}

hub_stop () {
#
# Refresh the PIDs
#
get_pids

echo -n "Shutting Down Hub: "
sleep 1
if [ $HUB_PID ]
then
kill -3 $HUB_PID
echo -e "done."
else
echo -e "failed.\nHub wasn't active anymore.\n"
fi

sleep 1
}

get_pids (){
#
# We used to launch the same binary twice so pidof didn't work.
# As from beta 8 ettv delayed feeds were automatic so
# no more fancy scripting tricks are required :-)
#
HUB_PID=`pidof $DAEMON`
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

#
# Performing The magic :-)
#

case "$1" in
start)
hub_start
;;
stop)
hub_stop
clean_up
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop}"
exit 1
;;
esac
exit 0
</pre>

=== Slave script ===

This script connects an undelayed slave to a hub (that hopefully delays the signal ;-)). The usage of this script is very similar to the Hub script. Copy / paste it and save it as <code>slave.sh</code> or any other name you prefer. THen issue <code>./slave.sh start</code> to start your slave and <code>./slave.sh stop</code> to stop it. Like above, it is actually better to do quit in the console instead of just killing the slave with this script.

<pre>#!/bin/bash

#################################################################
# #
# reT!reD.ettv slave script #
# - #
# reT!reD.deej #
# #
#################################################################
# #
# This script can be used to start up an ETTV slave to connect #
# to a HUB provided by another server. #
# #
# This script launches the daemon in a different screen which #
# you can reattach with "screen -r slave" #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# - aNgel (fragland.org) for debugging Beavis' mistakes ;-) #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################
# #
# http://www.fragland.org #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# WServer2.ath.cx IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# Start Modifying From Here #
# #
#################################################################
#
# Hub Info
#
# IMPORTANT: Let the admin of the hub do a
# fdir *.pk3 in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#

HUB_IP=$PERONI_IP # Hub runs on Webperoni
HUB_PORT="50000"
HUB_ETTV_PASS="[get_pass_from_hub_admin]"
HUB_PASS="[get_pass_from_hub_admin]"
HUB_HOST="$HUB_IP:$HUB_PORT"

#
# Slave Info
#

SLAVE_IP=$FRAGLAND_IP # select from list above
SLAVE_PORT="27960" # port of the public broadcaster
SLAVE_HOSTNAME="^7reT^1!^7reD^1.^7ettv ^1#^72"

ETTV_CLIENT=$SLAVE_HOSTNAME # Shows up on Hub

SLAVE_SLOTS="100"
SLAVE_PASS="[put_your_pass_here]"

SLAVE_PRIVATE_SLOTS="10"
SLAVE_PRIVATE_PASS="[put_your_pass_here]"

SLAVE_ETTV_SLAVES="0"
SLAVE_ETTV_PASS="[put_your_pass_here]"

RCON_PASS="[put_your_pass_here]"

ALLOW_DL="1"
ALLOW_WWW_DL="1" # Allow downloading over http?
WWW_DL_URL="http://www.yoursite.com" # No "/" at the end!

RECORD_GAME="0" # 1 = record the game, 0 = don't

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_slave" # Path to ettv.x86. Use absolute paths here!

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path where
# all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying Here #
# #
#################################################################
#
# Assembling the Command Line
#
BINARY="ettv.x86"

DAEMON="$BASEPATH/$BINARY"
HOMEPATH="$BASEPATH"

SLAVE_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set net_ip $SLAVE_IP \
+set net_port $SLAVE_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $HOMEPATH \
+set com_hunkMegs 128 \
+set sv_maxclients $SLAVE_SLOTS \
+set sv_privateclients $SLAVE_PRIVATE_SLOTS \
+set sv_privatepassword $SLAVE_PRIVATE_PASS \
+set sv_hostname $SLAVE_HOSTNAME \
+set ettv_delay 0 \
+set ettv_autorecord $RECORD_GAME \
+set ettv_clientname $ETTV_CLIENT \
+set g_password $SLAVE_PASS \
+set rconpassword $RCON_PASS \
+set sv_maxRate 18000 \
+set sv_allowDownload $ALLOW_DL \
+set sv_wwwDownload $ALLOW_WWW_DL \
+set sv_wwwBaseURL "$WWW_DL_URL" \
+set sv_wwwDlDisconnected 0 \
+set g_log "slave.log" \
+set logfile 2 \
+tv connect $HUB_HOST $HUB_ETTV_PASS $HUB_PASS"

#
# Functions
#

slave_start (){
#
# FYI'ing the user
#
echo -n "Starting Slave: "

screen -dmS slave su -m -c "$DAEMON $SLAVE_OPTIONS" - $USER

echo -e "done.\n"

echo -e "Getting PID...\n"
sleep 1

SLAVE_PID=`pidof $DAEMON`

echo -n "Slave has PID "
echo -e "$SLAVE_PID.\n"
}

slave_stop (){
#
# Refresh the PID
#
SLAVE_PID=`pidof $DAEMON`

echo -n "Shutting Down Slave: "
sleep 1
if [ $SLAVE_PID ]
then
kill -3 $SLAVE_PID
echo -e "done."
else
echo -e "failed.\nSlave wasn't active anymore.\n"
fi
}

#
# Performing The magic :-)
#

case "$1" in
start)
slave_start
;;
stop)
slave_stop
;;
restart)
slave_stop
sleep 1
slave_start
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop|restart}"
exit 1
;;
esac
exit 0
</pre>

=== Old school record / playback script ===

This is a script to broadcast a game the old-fashioned way. It records a demo and starts playing it back after roughly 60 seconds. There's some symbolic linking stuff done inside to make sure it stores all the logs, otherwise the 'broadcaster' would override the recorder's log, ''which makes broadcasting very hard to debug'' :-)!

Copy / paste this script and save it as <code>broadcast.sh</code> or any other name you prefer. The usual comments on quit and 999 are applicable here as well. This script "should" work with ETTV earlier then b8. However, YMMV.

<pre>#!/bin/bash

#################################################################
# #
# reT!reD.ettv delayed broadcast script #
# - #
# reT!reD.deej #
# #
#################################################################
# #
# This script can be used to start up a delayed ETTV stream #
# where viewers connect directly to the broadcaster. #
# #
# This script creates a subdirectory which represents the #
# date of the match and stores the demos in this subdir. #
# #
# The script launches the daemons in different screens #
# which you can reattach with "screen -r recorder" #
# or "screen -r broadcaster". #
# #
# Credits: #
# - Daita (pourix.net) for the original idea & script #
# - Tony J. White (et.tjw.org) for his ETDED on Linux guide #
# - aNgel (fragland.org) for debugging Beavis' mistakes ;-) #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################
# #
# http://www.fragland.org #
# #
#################################################################

# Webperoni Game Server IP
# ettv.fragland.org
PERONI_IP="83.133.81.192"

# Deinprovider WebServer IP
# ettv2.fragland.org
FRAGLAND_IP="217.20.115.116"

# Ionmedia Game Server IP
# ettv3.fragland.org
IONMEDIA_IP="62.216.174.68"

# Hetzner Game Server IP
# WServer2.ath.cx IP
# ettv4.fragland.org
HETZNER_IP="213.239.207.195"

# Planet Hosting Game Server IP
# ettv5.fragland.org
PLANET_IP="85.190.1.13"

#################################################################
# #
# START Modifying #
# #
#################################################################
#
# Parameters of the Game Server to Connect to
#
# IMPORTANT: Let the admin of the game server do
# "fdir *.pk3" in his console and give you the output!
#
# PK3 mismatches between game server and ETTV hosts
# account for the majority of crashes of ETTV.
#
MATCH_DATE=`date +%Y%m%d` # Today's date for creating the subdir
MATCH_HOST="et.fragland.org:27965" # Match server port & address
MATCH_ETTV_PASS="[get_pass_from_admin]" # Match server ETTV password
MATCH_PASS="[get_pass_from_admin]" # Match server password

#
# IPs & Ports For Your Host
#
THISHOST_IP=$PERONI_IP # This host is Webperoni
RECORDER_PORT="44999" # Port of the private recorder
BROADCASTER_PORT="27960" # Port of the public broadcaster

#
# Hostnames & ETTV Client name
#
# - hostname shows up in server browsers
# - ETTV client name shows up as the name
# of your server in the game server.
#
RECORDER_HOSTNAME="^7reT^1!^7reD^1.^7ettv ^7recorder ^1#^71"
BROADCASTER_HOSTNAME="^7reT^1!^7reD^1.^7ettv ^1#^71"

ETTV_CLIENT=$BROADCASTER_HOSTNAME

#
# Passwords
#
RCON_PASS="[put_your_pass_here]"
RECORDER_PASS="[put_your_pass_here]"
BROADCASTER_PRIVATE_PASS="[put_your_pass_here]"
BROADCASTER_ETTV_PASS="[put_your_pass_here]"
BROADCASTER_PASS="[put_your_pass_here]" # Issue /rcon g_password "" for opening it up to the crowd

#
# Directories
#
BASEPATH="/srv/et/ETTV/ettv_brc" # Path to ettv.x86. Use absolute paths here!

#
# ETTV Net settings for ETTV b8 & up
#
ETTV_NETBLAST="1"
ETTV_TV_IPTOS="0"
ETTV_SV_IPTOS="0"
ETTV_MTU="1400"

#
# Other relevant settings
#
SHOUTCAST_DELAY="60" # Delay between live match & broadcasting hub in seconds

BROADCASTER_SLOTS="100"
BROADCASTER_PRIVATE_SLOTS="10"
BROADCASTER_ETTV_SLAVES="0"

ALLOW_DL="1"
ALLOW_WWW_DL="1" # Allow downloading over http?
WWW_DL_URL="http://www.yoursite.org" # No "/" at the end!

#
# User To Launch Daemon
#
# Good practice:
# What doesn't need root priviliges doesn't get them!
#
# User gamed mentioned here under is not a standard linux user,
# he was created on our systems by us.
#
# gamed cannot log in. His homedir is equal to the path
# where all our servers are installed.
#
USER="gamed"

#################################################################
# #
# STOP Modifying #
# #
#################################################################
#
# Assembling the Command Line
#
RECORDER_HOMEPATH="$BASEPATH/$MATCH_DATE/recorder"
BROADCASTER_HOMEPATH="$BASEPATH/$MATCH_DATE/broadcaster"

BINARY="ettv.x86"
DAEMON="$BASEPATH/$BINARY"

RECORDER_OPTIONS="\
+set fs_game etpro \
+set dedicated 1 \
+map oasis \
+set net_ip $THISHOST_IP \
+set net_port $RECORDER_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $RECORDER_HOMEPATH \
+set com_hunkMegs 128 \
+set g_password $RECORDER_PASS \
+set rconpassword $RCON_PASS \
+set sv_hostname $RECORDER_HOSTNAME \
+set sv_maxclients 4 \
+set sv_maxRate 25000 \
+set sv_allowDownload 0 \
+set sv_wwwDownload 0 \
+set sv_wwwBaseURL "$WWW_DL_URL" \
+set sv_wwwDlDisconnected 0 \
+set g_log "recorder.log" \
+set logfile 2 \
+set b_ettv_flags 3 \
+set ettv_sv_maxslaves 2 \
+set ettv_clientname $ETTV_CLIENT \
+set ettv_password $BROADCASTER_ETTV_PASS \
+set ettv_netblast $ETTV_NETBLAST \
+set ettv_tv_iptos $ETTV_TV_IPTOS \
+set ettv_sv_iptos $ETTV_SV_IPTOS \
+set ettv_mtu $ETTV_MTU \
+set ettv_autorecord 1 \
+set ettv_delay 1 \
+tv connect $MATCH_HOST $MATCH_ETTV_PASS $MATCH_PASS"

BROADCASTER_OPTIONS="\
+set fs_game etpro \
+set dedicated 2 \
+set net_ip $THISHOST_IP \
+set net_port $BROADCASTER_PORT \
+set fs_basepath $BASEPATH \
+set fs_homepath $BROADCASTER_HOMEPATH \
+set com_hunkMegs 160 \
+set sv_maxclients $BROADCASTER_SLOTS \
+set sv_privateclients $BROADCASTER_PRIVATE_SLOTS \
+set sv_privatepassword $BROADCASTER_PRIVATE_PASS \
+set sv_hostname $BROADCASTER_HOSTNAME \
+set g_password $BROADCASTER_PASS \
+set rconpassword $RCON_PASS \
+set sv_maxRate 18000 \
+set sv_allowDownload $ALLOW_DL \
+set sv_wwwDownload $ALLOW_WWW_DL \
+set sv_wwwBaseURL "$WWW_DL_URL" \
+set sv_wwwDlDisconnected 0 \
+set g_log "broadcaster.log" \
+set logfile 2 \
+set ettv_autoplay 1 \
+set ettv_password $BROADCASTER_ETTV_PASS \
+set b_ettv_flags 3 \
+set ettv_sv_maxslaves $BROADCASTER_ETTV_SLAVES \
+demo demo0000"

#
# Functions
#
broadcast_start (){
#
# FYI'ing the user
#
echo -e "\n"
echo -n "Match Date is "
echo -n "$MATCH_DATE"

echo -e ".\nDemos are stored in $RECORDER_HOMEPATH/etpro/demos/.\n"

echo -n "Starting Recorder: "
screen -dmS recorder su -m -c "$DAEMON $RECORDER_OPTIONS" - $USER
echo "done."

get_pids

echo -n "Recorder has PID "
echo -n $RECORDER_PID

echo -e ".\n\nSleeping for $SHOUTCAST_DELAY seconds."
sleep $SHOUTCAST_DELAY

mkdir "$BROADCASTER_HOMEPATH"
mkdir "$BROADCASTER_HOMEPATH/etpro"
ln -s "$RECORDER_HOMEPATH/etpro/demos" "$BROADCASTER_HOMEPATH/etpro"
chown -R $USER "$BROADCASTER_HOMEPATH"
chmod -R 775 "$BROADCASTER_HOMEPATH"

echo -n "Starting Broadcaster: "
screen -dmS broadcaster su -m -c "$DAEMON $BROADCASTER_OPTIONS" - $USER
echo -e "done.\n"

echo -e "Getting PIDs...\n"
sleep 1

get_pids

echo -n "Recorder has PID "
echo -n $RECORDER_PID
echo -e ".\n\nBroadcaster has PID "
echo -e "$BROADCASTER_PID.\n"
}

broadcast_stop (){

get_pids

echo -n "Shutting Down Broadcaster: "
sleep 1
if [ $BROADCASTER_PID ]
then
kill -3 $BROADCASTER_PID
echo -e "done."
else
echo -e "failed.\nBroadcaster wasn't active anymore.\n"
fi

echo -n "Shutting Down Recorder: "
sleep 1
if [ $RECORDER_PID ]
then
kill -3 $RECORDER_PID
echo -e "done."
else
echo -e "failed.\nRecorder wasn't active anymore.\n"
fi

sleep 1
clean_up
}

clean_up (){
#
# Clean up prompt
#
echo -n "Clean up demos directory [y/n]? "
read ANSWER
case "$ANSWER" in
y)
rm -Rf $BASEPATH/$MATCH_DATE
ls -l --color=always $BASEPATH
;;
*)
echo "Following demos still exist:"
ls -l --color=always $BASEPATH/$MATCH_DATE/etpro/demos/
;;
esac
}

get_pids (){
#
# Pulling some very ugly tricks here
#
RECORDER_PID=`ps aux|grep "+set net_port $RECORDER_PORT"|grep -v "su -m -c"|grep -v "SCREEN -dmS"\|awk '{ print $1 $2 }'|tr -d "$USER"`
BROADCASTER_PID=`ps aux|grep "+set net_port $BROADCASTER_PORT"|grep -v "su -m -c"|grep -v "SCREEN -dmS"|awk '{ print $1 $2 }'|tr -d "$USER"`
}

#
# Performing The magic :-)
#

case "$1" in
start)
broadcast_start
;;
stop)
broadcast_stop
;;
*)
SCRIPT_NAME=`basename $0`
echo "Usage: $SCRIPT_NAME {start|stop}"
exit 1
;;
esac
exit 0
</pre>

=== Sanitization script ===

This is a script to restore an ETTV directory to the bare minimum required to broadcast matches or be a hub. It isn't a very advanced script but it gets the job done. Copy / paste this script and save it as <code>sanitize.sh</code> or any other name you prefer. Just do <code>./sanitize.sh</code> do delete all files in etmain & etpro that are not needed anymore.

''Note'': this script deletes '''everything''' it finds in the etmain and etpro directories. If you have stuff that you don't want to delete in their, add it to the ETMAIN_FILES & ETPRO_FILES arrays.

<pre>#!/bin/bash

#################################################################
# #
# reT!reD.ettv clean-up script #
# - #
# reT!reD.deej #
# #
#################################################################
# #
# This script is used to restore an ETTV directory to the bare #
# minimum in terms of files. #
# #
# Use it to clean up after an ETTV session so you can start the #
# next session with a minimum of PK3s. #
# #
# Questions? Contact me on deej@fragland.org or go to #r0f.et #
# #
#################################################################
# #
# http://www.fragland.org #
# #
#################################################################

ETMAIN_FILES=("description.txt" "hunkusage.dat" "mp_bin.pk3" "pak0.pk3" "pak1.pk3" "pak2.pk3" "qagame.mp.i386.so")
ETPRO_FILES=("etpro-3_2_0.pk3" "etpro_cheats.dat" "qagame.mp.i386.so" "tvgame.mp.i386.so" "animations" "configs" "maps" "etpromapscripts")

BASEPATH="/srv/et/ETTV/ettv_hub"

#
# Test for existence of backup directories
#
if [ ! -d "$BASEPATH/etmain/bak/" ]; then
mkdir "$BASEPATH/etmain/bak"
fi

if [ ! -d "$BASEPATH/etpro/bak/" ]; then
mkdir "$BASEPATH/etpro/bak"
fi

#
# Clear etmain
#
for i in ${ETMAIN_FILES[@]}
do
mv "$BASEPATH/etmain/$i" "$BASEPATH/etmain/bak/"
done
rm $BASEPATH/etmain/*

#
# Clear etpro
#
for i in ${ETPRO_FILES[@]}
do
mv "$BASEPATH/etpro/$i" "$BASEPATH/etpro/bak/"
done
rm $BASEPATH/etpro/*

#
# Restore etmain
#
for i in ${ETMAIN_FILES[@]}
do
mv "$BASEPATH/etmain/bak/$i" "$BASEPATH/etmain/"
done

#
# Restore etpro
#
for i in ${ETPRO_FILES[@]}
do
mv "$BASEPATH/etpro/bak/$i" "$BASEPATH/etpro/"
done

#
# Clean the backup directories
#
rm -Rf $BASEPATH/etmain/bak
rm -Rf $BASEPATH/etpro/bak
</pre>

Have fun broadcasting!

[[User:Deej|deej]] 01:18, 10 November 2005 (PST)

[[Category:ETTV]]

B placebo

2005-11-08T17:09:10Z

Deej: Links

== Magical Beginning ==

Strangely, when this cvar was found in the CVS tree for ETPro, there wasn't a name for the contributor next to it and to this day the [[ETPro_Developer|ETPro devs]] don't know where it came from.

== Description ==

When using this cvar anything is possible. As an example, you will be given the sticky bullet syndrome and will be able to shoot people through the corner of walls when they run away.

Features include:

* You will not be as easily damaged by explosions ''(as long as you aren't too close to the explosion)''

* Your team will win every game ''(as long as your team is better than your enemy)''

* When defusing dynamite, it won't matter how far into the 30 seconds it is, you will always be able to defuse it on time. ''(as long as you start defusing before 5 seconds is left on the clock)''

* You can now jump twice as far as normal ''(Only works if you have 333fps)''

* Your grenades will hit the target with 100% damage ''(Depends if your grenade is actually close to the target)''

== Why keep it? ==

The cvar can't be removed as it has been hidden within the deepest parts of the ET source; it is so deep that even the magical [[User:Rain|Rain]] cannot find it.

== I Can't Find it ==

The cvar does not show up when you try to tab complete it within the console. You just have to insert it in your config and then you can rest assured that it is working.

B placebo

2005-11-08T17:07:14Z

Deej: typo

== Magical Beginning ==

Strangely, when this cvar was found in the CVS tree for ETPro, there wasn't a name for the contributor next to it and to this day the ETPro devs don't know where it came from.

== Description ==

When using this cvar anything is possible. As an example, you will be given the sticky bullet syndrome and will be able to shoot people through the corner of walls when they run away.

Features include:

* You will not be as easily damaged by explosions ''(as long as you aren't too close to the explosion)''

* Your team will win every game ''(as long as your team is better than your enemy)''

* When defusing dynamite, it won't matter how far into the 30 seconds it is, you will always be able to defuse it on time. ''(as long as you start defusing before 5 seconds is left on the clock)''

* You can now jump twice as far as normal ''(Only works if you have 333fps)''

* Your grenades will hit the target with 100% damage ''(Depends if your grenade is actually close to the target)''

== Why keep it? ==

The cvar can't be removed as it has been hidden within the deepest parts of the ET source; it is so deep that even the magical Rain cannot find it.

== I Can't Find it ==

The cvar does not show up when you try to tab complete it within the console. You just have to insert it in your config and then you can rest assured that it is working.

ETTV:Server Configuration

2005-11-08T08:52:05Z

Deej: /* Setting up your slave to allow connections from other slaves */

<dot_graph>
digraph ettv {
master -> slave1
master -> slave2
slave1 -> "client1.."
slave1 -> "..client50"
slave2 -> "client51.."
slave2 -> "..client100"
}
</dot_graph>

==Installation - "Master" (gameserver)==

Copy ettv.x86 to the same directory your etded.x86 is located.
Start your gameserver as normal, but run ettv.x86 instead of etded.x86.

===Set some cvars===

'''ettv_sv_maxslaves''' (default 0, no slave connections allowed)
:Number of ettv slaves allowed to connect.
:''Note:'' Slave slots are always reserved, like private slots.
'''ettv_password''' (default "", no slave connections allowed)
:Password for ettv slaves.
:Must be set, or no slaves will be able to connect!
'''b_ettv_flags''' (default 1)
:1 = prevent slaves from being callvote kicked
:2 = grant shoutcaster status to slaves
:values can be added together, eg 3 for both features.

===Playing on the master===
Players may now connect to your gameserver as normal.

==Installation - "Slave" (broadcast server)==

Copy ettv.x86 to the same directory your etded.x86 is located.
Copy tvgame.mp.i386.so to the same directory as your etpro/qagame.mp.i386.so is located.

===Set some cvars===
'''sv_maxclients'''
:Number of spectator clients to allow. This number is only limited by available cpu and memory.
:Some guidelines when provisioning a broadcast server:
:*100 spectator slots will require ~ 128mb ram. Use com_hunkmegs to set this.
:*100 spectator slots will require ~ 768kbyte/sec (6mbits), roughly 6kbyte/sec per client
:*100 spectator slots will take ~ 80% cpu of a Xeon 2.2ghz
:*Each slave will require ~20-40kbyte/sec from the master.

'''ettv_clientname''' (default "ETTV")
:Playername the slave will use when connecting to the master, eg "ETTV-xyz"

'''ettv_delay''' (default 0, disabled)
:number of seconds for slave to delay the master feed. Recording/playback chains should no longer be needed, and slaves should always maintain an exact delay from the master server.
:''note'': this should ONLY be set on the slave.
:''note'': only supported in ettv beta8 and later

===Chat passwords===
In order to curb the rampant abuse of ettv chat, admins may set "chat passwords" on their servers. If enabled, viewers are not allowed to chat unless they have a password. You can define as many passwords as you like, so you can easily track down individual abusers and limit the damage of stolen passwords.

'''ettv_chatpasswords''' (default 0, disabled)
:number of chat passwords defined.
'''ettv_chatpassword'''(1-99999)
:individual chat passwords.

viewers use <tt>/chatpassword <password></tt> to login.

if logged in, ettv chats will be tagged with a number in parentheses identifying which chat password the viewer is using.
===Misc commands for viewers===
;For ettv beta 4 and above
* spectators may <tt>/ignore</tt> and <tt>/unignore</tt> other spectators
* semiadmin functionality now works for slaves
* rcon may now mute/unmute specs

===Connect the slave===
Now start your slave server by running ettv.x86

Tell the slave server to connect up to the master server:
:<tt>tv connect master.ip.address:port ettv_password(required) g_password(if the master has a g_password set)</tt>

If you have configured everything correctly, the slave should connect to the master.
Clients should now be able to connect to the slave and spectate the game in progress.

This is a "live broadcast" with no delay.

===Disconnect the slave===
To tell the slave to disconnect from the master:
:<tt>tv disconnect</tt>

===Slave Chaining===

==== What is chaining and why chain slaves? ====

ETTV allows chaining slaves together. This very neat feature lets you connect one ETTV slave to another ETTV slave that is broadcasting a match instead of directly to the game server hosting the match. Apart from the "w00t this is very cool" factor, why is this feature so important for admins? Basicly, working in a chained model allows to broadcast a match to a large number of spectators without too much hastle and too many risks for the master server.

Chaining was developped for a simple reason: if you take into account that one ETTV slave connects at an '''unlimited''' rate to a master, you really don't want to connect 15 or 20 slaves to a game server to broadcast let's say the ''Atlantic Battle''. Chances are you will bring down the master game server and thus the game. Chaining slaves firmly alleviates the load on the master game server. 2 or 4 of these ''Hubs'' can do the job of delaying the signal and feeding it to other slaves.

Other benefits might include better network performance. If you can choose to either connect your slave to the game server where your connection is not optimal or to a nearby slave who is on a better connection to the master, it might help the quality of your broadcast. Plus you don't need to record anything when connecting to a delayed slave.

==== Setting up your slave to allow connections from other slaves ====

This part is actually pretty easy. You need to set up your slave as if you were setting up a master game server. This means that, next to the normal slave parameters, you have to set up the following:

* '''b_ettv_flags''': set this to at least 1
* '''ettv_sv_maxslaves''': set this to at least 1. Depending on how powerful your machine is you can set this number higher. Don't set it too high though, a slave still connects at an unlimited rate
* '''ettv_password''': set to something else than "". This password is needed by the slaves connecting to your slave (together with g_password of course)

Other settings such as ettv_netblast, ettv_tv_iptos etc... can be set as well. You can even use autorecord if you wish, or just add an extra delay.

==== Pitfalls ====

There are however a few risks associated with slave chaining. One of the biggest issues is '''PK3 dependancies'''.

As you know, a slave needs to have at least all the PK3s of the server it connects too. But a slave can have more PK3s installed, as long as it has the ones on the server's pure list. This is what complicates things! The further you go down the "chain", the more the chances exist of PK3 pollution, which makes the job of the last slave very hard. And the viewers connecting to that slave will not be very happy either.

So for those of you venturing into chaining slaves here's a rule of thumb: '''always keep the installed PK3s to the bare minimum'''! Do not add stuff you do not need. If you want to know what PK3s you need and not need, connect your slave to the master or the hub, see which PK3s are on the pure list and rename or remove the PK3s that are not on the list. You will make your viewers and other admins connecting to your slave very happy.

Another risk could be '''chained lag'''. If one of the slaves that is higher in the chain starts lagging, the consequenses for the slaves depending on it will be seen immedeatily. So if you offer to be one of the higher slaves in the chain, make sure your machine can handle it! An ETTV chain is much like the food chain ;-).

==== Admin contributions ====

If by now you feel like getting your hands dirty in ETTV chaining madness and you want to see some example of hubs, slaves, broadcasters and scripts to get it all working, you can already start by checking out [[User:Deej|deej's page]].

==ETTV Demos==
You may record the match in progress to a file, with the command:
:<tt>record <'''demo name'''></tt>
If you omit the demo name, ettv will start recording using a filename of demoXXXX where XXXX is the first available number starting from 0000.

Demos will stop recording when a map changes.

To stop recording a demo:
:<tt>stoprecord</tt>

To play back a recorded demo:
:<tt>demo <'''demo name'''></tt>

To check the status of an ettv slave:
:<tt>tv status</tt>
This will tell you if the slave is connected to a master, or if it is currently playing back a demo.

To fastforward a demo:
:<tt>ff <seconds></tt>
Eg <tt>ff 30</tt> will fast foward 30 seconds. Fast forward stops at map restarts, so you can safely ff 999 to fast forward through a warmup.
:''note'': requires ettv beta 7 or later

===Autorecording demos===
ettv is able to automatically continuously record demos, creating new demofiles when the map changes. To do this, set the cvar ettv_autorecord to 1. ettv will start recording demos with the name demoXXXX where XXXX is a number starting at 0000 and incrementing on each map change.

Server admins may find it useful to use the demo recording feature of ettv to record matches, instead of requiring individual players to record them. An ettv demo records everything that happens on a server, including all player viewpoints.

===How to create demo based delayed feeds===
Autorecording demos is the first half of the process for delayed feeds. Typically you would run a passworded slave server with the smallest number of sv_maxclients possible. No spectators should connect to this server. The only purpose of this slave is to connect up to the master and record the match to sequentially numbered demofiles.

Now start up a slave, and tell it to broadcast the demo being recorded.

:<tt>demo demo0000</tt>

If you wait approx. 60 seconds after the master begins recording before issuing this command to your slaves, then you have a 60 second delay on your broadcast.

If you want slaves to automatically switch to the next demo when the end of the demo is reached (eg on a map change), you would set the cvar ettv_autoplay to 1. If a slave is playing demo0000 and it reaches the end, it will then try to play demo0001 and so on.

Disadvantage of this method: It is not automated in ettv itself, though admins can script it.
Advantage of this method: You may run multiple broadcast servers from the same single demo stream.

Automated delayed feeds are supported in ettv beta 8. See the above.

==Troubleshooting==

* The slave server must be running the same fs_game setting as the master server.
* The slave server must have a copy of every map pk3 the master server is using.
* If the master server loads a map the slave server doesn't have, the slave will get stuck.
* Spectators will be forced to download any custom pk3 you are using.
* It is a good idea to keep the master server pk3 list to a minimum.
* If you are using the autorecord/autoplay feature for running delayed feeds, you will usually want to make sure you clear out the demos directory first. Autorecording will start numbering demofiles using the first available number, so if you have old recorded demos then ettv might start recording from eg demo0017. If your scripts expect to start playback from demo0000 then you might end up broadcasting a game recorded at some earlier date...

==Miscellaneous==

Slaves may send chats to the master with the command msay
Slaves may list players on the master with the command players

==Performance tuning==

Spectator servers with large numbers of clients (eg >100) will push the OS very hard with huge amounts of UDP traffic. The default OS buffer settings for Linux are inadequate and can hurt performance, causing lag and/or disconnects.

If you get messages like
:<tt>NET_SendPacket ERROR: No buffer space available to 192.168.120.142:27960</tt>

Then you definitely need to increase your kernel network buffers.

Large spectator servers should increase the kernel buffers.

The following commands should be issued as root on linux:
:<tt>echo "524288" > /proc/sys/net/core/rmem_max</tt>
:<tt>echo "524288" > /proc/sys/net/core/wmem_max</tt>

FreeBSD can try this:
:<tt>sysctl -w net.inet.udp.recvspace=65535</tt>
:<tt>sysctl -w net.inet.udp.maxdgram=57344</tt>
:<tt>sysctl -w kern.ipc.maxsockbuf=8388608</tt>

===Network tuning cvars===
;The following are only available in ettv beta 7 and later.
By default, et uses small packets of 1400 bytes or less to send to clients. If messages need to be larger, they are 'fragmented' and sent over several server frames. ettv slave messages tend to be large and often fragment. ettv normally tries to send slaves all fragments at once to avoid jittery playback, but some networks / OSes handle this badly. ettv beta 7 introduces new controls so admins can optimize ettv for their individual network.

'''ettv_netblast''' (default 1)
:by default, ettv tries to send all fragments at once. some networks may handle this badly. setting this to 0 disables. warning: setting this to 0 without increasing ettv_mtu will result in severely laggy slave playback.

'''ettv_mtu''' (default 1400)
:; master only
:if your network / os supports it, you can set this to large values (eg 16000) to prevent message fragmentation and provide smoother ettv links. this cvar has no effect on normal ET clients.
:''note'': ettv_mtu must currently be set from commandline, it cannot be changed on the fly (yet).

'''ettv_tv_iptos''' (default 0)
:you can set the ip type of service field of ettv link packets. if your network/ISP supports it, you can use a value like 16 ("minimize delay") to prioritize ettv link packets over others on the network.

'''ettv_sv_iptos''' (default 0)
:same as ettv_tv_iptos, but affects packets for normal ET clients.

[[Category:ETTV]]

User talk:Deej

2005-11-07T19:38:01Z

Deej:

ETTV:Server Configuration

2005-11-07T19:36:13Z

Deej: clarity and typos

<dot_graph>
digraph ettv {
master -> slave1
master -> slave2
slave1 -> "client1.."
slave1 -> "..client50"
slave2 -> "client51.."
slave2 -> "..client100"
}
</dot_graph>

==Installation - "Master" (gameserver)==

Copy ettv.x86 to the same directory your etded.x86 is located.
Start your gameserver as normal, but run ettv.x86 instead of etded.x86.

===Set some cvars===

'''ettv_sv_maxslaves''' (default 0, no slave connections allowed)
:Number of ettv slaves allowed to connect.
:''Note:'' Slave slots are always reserved, like private slots.
'''ettv_password''' (default "", no slave connections allowed)
:Password for ettv slaves.
:Must be set, or no slaves will be able to connect!
'''b_ettv_flags''' (default 1)
:1 = prevent slaves from being callvote kicked
:2 = grant shoutcaster status to slaves
:values can be added together, eg 3 for both features.

===Playing on the master===
Players may now connect to your gameserver as normal.

==Installation - "Slave" (broadcast server)==

Copy ettv.x86 to the same directory your etded.x86 is located.
Copy tvgame.mp.i386.so to the same directory as your etpro/qagame.mp.i386.so is located.

===Set some cvars===
'''sv_maxclients'''
:Number of spectator clients to allow. This number is only limited by available cpu and memory.
:Some guidelines when provisioning a broadcast server:
:*100 spectator slots will require ~ 128mb ram. Use com_hunkmegs to set this.
:*100 spectator slots will require ~ 768kbyte/sec (6mbits), roughly 6kbyte/sec per client
:*100 spectator slots will take ~ 80% cpu of a Xeon 2.2ghz
:*Each slave will require ~20-40kbyte/sec from the master.

'''ettv_clientname''' (default "ETTV")
:Playername the slave will use when connecting to the master, eg "ETTV-xyz"

'''ettv_delay''' (default 0, disabled)
:number of seconds for slave to delay the master feed. Recording/playback chains should no longer be needed, and slaves should always maintain an exact delay from the master server.
:''note'': this should ONLY be set on the slave.
:''note'': only supported in ettv beta8 and later

===Chat passwords===
In order to curb the rampant abuse of ettv chat, admins may set "chat passwords" on their servers. If enabled, viewers are not allowed to chat unless they have a password. You can define as many passwords as you like, so you can easily track down individual abusers and limit the damage of stolen passwords.

'''ettv_chatpasswords''' (default 0, disabled)
:number of chat passwords defined.
'''ettv_chatpassword'''(1-99999)
:individual chat passwords.

viewers use <tt>/chatpassword <password></tt> to login.

if logged in, ettv chats will be tagged with a number in parentheses identifying which chat password the viewer is using.
===Misc commands for viewers===
;For ettv beta 4 and above
* spectators may <tt>/ignore</tt> and <tt>/unignore</tt> other spectators
* semiadmin functionality now works for slaves
* rcon may now mute/unmute specs

===Connect the slave===
Now start your slave server by running ettv.x86

Tell the slave server to connect up to the master server:
:<tt>tv connect master.ip.address:port ettv_password(required) g_password(if the master has a g_password set)</tt>

If you have configured everything correctly, the slave should connect to the master.
Clients should now be able to connect to the slave and spectate the game in progress.

This is a "live broadcast" with no delay.

===Disconnect the slave===
To tell the slave to disconnect from the master:
:<tt>tv disconnect</tt>

===Slave Chaining===

==== What is chaining and why chain slaves? ====

ETTV allows chaining slaves together. This very neat feature lets you connect one ETTV slave to another ETTV slave that is broadcasting a match instead of directly to the game server hosting the match. Apart from the "w00t this is very cool" factor, why is this feature so important for admins? Basicly, working in a chained model allows to broadcast a match to a large number of spectators without too much hastle and too many risks for the master server.

Chaining was developped for a simple reason: if you take into account that one ETTV slave connects at an '''unlimited''' rate to a master, you really don't want to connect 15 or 20 slaves to a game server to broadcast let's say the ''Atlantic Battle''. Chances are you will bring down the master game server and thus the game. Chaining slaves firmly alleviates the load on the master game server. 2 or 4 of these ''Hubs'' can do the job of delaying the signal and feeding it to other slaves.

Other benefits might include better network performance. If you can choose to either connect your slave to the game server where your connection is not optimal or to a nearby slave who is on a better connection to the master, it might help the quality of your broadcast. Plus you don't need to record anything when connecting to a delayed slave.

==== Setting up your slave to allow connections from other slaves ====

This part is actually pretty easy. You need to set up your slave as if you were setting up a master game server. This means that, next to the normal slave parameters, you have to set up the following:

* '''b_ettv_flags''': set this to at least 1
* '''ettv_sv_maxslaves''': set this to at least 1. Depending on how powerful your machine is you can set this number higher. Don't set it too high though, a slave still connects at an unlimited rate
* '''set ettv_password''': set to something else than "". This password is needed by the slaves connecting to your slave (together with g_password of course)

Other settings such as ettv_netblast, ettv_tv_iptos etc... can be set as well. You can even use autorecord if you wish, or just add an extra delay.

==== Pitfalls ====

There are however a few risks associated with slave chaining. One of the biggest issues is '''PK3 dependancies'''.

As you know, a slave needs to have at least all the PK3s of the server it connects too. But a slave can have more PK3s installed, as long as it has the ones on the server's pure list. This is what complicates things! The further you go down the "chain", the more the chances exist of PK3 pollution, which makes the job of the last slave very hard. And the viewers connecting to that slave will not be very happy either.

So for those of you venturing into chaining slaves here's a rule of thumb: '''always keep the installed PK3s to the bare minimum'''! Do not add stuff you do not need. If you want to know what PK3s you need and not need, connect your slave to the master or the hub, see which PK3s are on the pure list and rename or remove the PK3s that are not on the list. You will make your viewers and other admins connecting to your slave very happy.

Another risk could be '''chained lag'''. If one of the slaves that is higher in the chain starts lagging, the consequenses for the slaves depending on it will be seen immedeatily. So if you offer to be one of the higher slaves in the chain, make sure your machine can handle it! An ETTV chain is much like the food chain ;-).

==== Admin contributions ====

If by now you feel like getting your hands dirty in ETTV chaining madness and you want to see some example of hubs, slaves, broadcasters and scripts to get it all working, you can already start by checking out [[User:Deej|deej's page]].

==ETTV Demos==
You may record the match in progress to a file, with the command:
:<tt>record <'''demo name'''></tt>
If you omit the demo name, ettv will start recording using a filename of demoXXXX where XXXX is the first available number starting from 0000.

Demos will stop recording when a map changes.

To stop recording a demo:
:<tt>stoprecord</tt>

To play back a recorded demo:
:<tt>demo <'''demo name'''></tt>

To check the status of an ettv slave:
:<tt>tv status</tt>
This will tell you if the slave is connected to a master, or if it is currently playing back a demo.

To fastforward a demo:
:<tt>ff <seconds></tt>
Eg <tt>ff 30</tt> will fast foward 30 seconds. Fast forward stops at map restarts, so you can safely ff 999 to fast forward through a warmup.
:''note'': requires ettv beta 7 or later

===Autorecording demos===
ettv is able to automatically continuously record demos, creating new demofiles when the map changes. To do this, set the cvar ettv_autorecord to 1. ettv will start recording demos with the name demoXXXX where XXXX is a number starting at 0000 and incrementing on each map change.

Server admins may find it useful to use the demo recording feature of ettv to record matches, instead of requiring individual players to record them. An ettv demo records everything that happens on a server, including all player viewpoints.

===How to create demo based delayed feeds===
Autorecording demos is the first half of the process for delayed feeds. Typically you would run a passworded slave server with the smallest number of sv_maxclients possible. No spectators should connect to this server. The only purpose of this slave is to connect up to the master and record the match to sequentially numbered demofiles.

Now start up a slave, and tell it to broadcast the demo being recorded.

:<tt>demo demo0000</tt>

If you wait approx. 60 seconds after the master begins recording before issuing this command to your slaves, then you have a 60 second delay on your broadcast.

If you want slaves to automatically switch to the next demo when the end of the demo is reached (eg on a map change), you would set the cvar ettv_autoplay to 1. If a slave is playing demo0000 and it reaches the end, it will then try to play demo0001 and so on.

Disadvantage of this method: It is not automated in ettv itself, though admins can script it.
Advantage of this method: You may run multiple broadcast servers from the same single demo stream.

Automated delayed feeds are supported in ettv beta 8. See the above.

==Troubleshooting==

* The slave server must be running the same fs_game setting as the master server.
* The slave server must have a copy of every map pk3 the master server is using.
* If the master server loads a map the slave server doesn't have, the slave will get stuck.
* Spectators will be forced to download any custom pk3 you are using.
* It is a good idea to keep the master server pk3 list to a minimum.
* If you are using the autorecord/autoplay feature for running delayed feeds, you will usually want to make sure you clear out the demos directory first. Autorecording will start numbering demofiles using the first available number, so if you have old recorded demos then ettv might start recording from eg demo0017. If your scripts expect to start playback from demo0000 then you might end up broadcasting a game recorded at some earlier date...

==Miscellaneous==

Slaves may send chats to the master with the command msay
Slaves may list players on the master with the command players

==Performance tuning==

Spectator servers with large numbers of clients (eg >100) will push the OS very hard with huge amounts of UDP traffic. The default OS buffer settings for Linux are inadequate and can hurt performance, causing lag and/or disconnects.

If you get messages like
:<tt>NET_SendPacket ERROR: No buffer space available to 192.168.120.142:27960</tt>

Then you definitely need to increase your kernel network buffers.

Large spectator servers should increase the kernel buffers.

The following commands should be issued as root on linux:
:<tt>echo "524288" > /proc/sys/net/core/rmem_max</tt>
:<tt>echo "524288" > /proc/sys/net/core/wmem_max</tt>

FreeBSD can try this:
:<tt>sysctl -w net.inet.udp.recvspace=65535</tt>
:<tt>sysctl -w net.inet.udp.maxdgram=57344</tt>
:<tt>sysctl -w kern.ipc.maxsockbuf=8388608</tt>

===Network tuning cvars===
;The following are only available in ettv beta 7 and later.
By default, et uses small packets of 1400 bytes or less to send to clients. If messages need to be larger, they are 'fragmented' and sent over several server frames. ettv slave messages tend to be large and often fragment. ettv normally tries to send slaves all fragments at once to avoid jittery playback, but some networks / OSes handle this badly. ettv beta 7 introduces new controls so admins can optimize ettv for their individual network.

'''ettv_netblast''' (default 1)
:by default, ettv tries to send all fragments at once. some networks may handle this badly. setting this to 0 disables. warning: setting this to 0 without increasing ettv_mtu will result in severely laggy slave playback.

'''ettv_mtu''' (default 1400)
:; master only
:if your network / os supports it, you can set this to large values (eg 16000) to prevent message fragmentation and provide smoother ettv links. this cvar has no effect on normal ET clients.
:''note'': ettv_mtu must currently be set from commandline, it cannot be changed on the fly (yet).

'''ettv_tv_iptos''' (default 0)
:you can set the ip type of service field of ettv link packets. if your network/ISP supports it, you can use a value like 16 ("minimize delay") to prioritize ettv link packets over others on the network.

'''ettv_sv_iptos''' (default 0)
:same as ettv_tv_iptos, but affects packets for normal ET clients.

[[Category:ETTV]]

ETTV:Server Configuration

2005-11-07T19:32:42Z

Deej: /* Slave Chaining */

<dot_graph>
digraph ettv {
master -> slave1
master -> slave2
slave1 -> "client1.."
slave1 -> "..client50"
slave2 -> "client51.."
slave2 -> "..client100"
}
</dot_graph>

==Installation - "Master" (gameserver)==

Copy ettv.x86 to the same directory your etded.x86 is located.
Start your gameserver as normal, but run ettv.x86 instead of etded.x86.

===Set some cvars===

'''ettv_sv_maxslaves''' (default 0, no slave connections allowed)
:Number of ettv slaves allowed to connect.
:''Note:'' Slave slots are always reserved, like private slots.
'''ettv_password''' (default "", no slave connections allowed)
:Password for ettv slaves.
:Must be set, or no slaves will be able to connect!
'''b_ettv_flags''' (default 1)
:1 = prevent slaves from being callvote kicked
:2 = grant shoutcaster status to slaves
:values can be added together, eg 3 for both features.

===Playing on the master===
Players may now connect to your gameserver as normal.

==Installation - "Slave" (broadcast server)==

Copy ettv.x86 to the same directory your etded.x86 is located.
Copy tvgame.mp.i386.so to the same directory as your etpro/qagame.mp.i386.so is located.

===Set some cvars===
'''sv_maxclients'''
:Number of spectator clients to allow. This number is only limited by available cpu and memory.
:Some guidelines when provisioning a broadcast server:
:*100 spectator slots will require ~ 128mb ram. Use com_hunkmegs to set this.
:*100 spectator slots will require ~ 768kbyte/sec (6mbits), roughly 6kbyte/sec per client
:*100 spectator slots will take ~ 80% cpu of a Xeon 2.2ghz
:*Each slave will require ~20-40kbyte/sec from the master.

'''ettv_clientname''' (default "ETTV")
:Playername the slave will use when connecting to the master, eg "ETTV-xyz"

'''ettv_delay''' (default 0, disabled)
:number of seconds for slave to delay the master feed. Recording/playback chains should no longer be needed, and slaves should always maintain an exact delay from the master server.
:''note'': this should ONLY be set on the slave.
:''note'': only supported in ettv beta8 and later

===Chat passwords===
In order to curb the rampant abuse of ettv chat, admins may set "chat passwords" on their servers. If enabled, viewers are not allowed to chat unless they have a password. You can define as many passwords as you like, so you can easily track down individual abusers and limit the damage of stolen passwords.

'''ettv_chatpasswords''' (default 0, disabled)
:number of chat passwords defined.
'''ettv_chatpassword'''(1-99999)
:individual chat passwords.

viewers use <tt>/chatpassword <password></tt> to login.

if logged in, ettv chats will be tagged with a number in parentheses identifying which chat password the viewer is using.
===Misc commands for viewers===
;For ettv beta 4 and above
* spectators may <tt>/ignore</tt> and <tt>/unignore</tt> other spectators
* semiadmin functionality now works for slaves
* rcon may now mute/unmute specs

===Connect the slave===
Now start your slave server by running ettv.x86

Tell the slave server to connect up to the master server:
:<tt>tv connect master.ip.address:port ettv_password(required) g_password(if the master has a g_password set)</tt>

If you have configured everything correctly, the slave should connect to the master.
Clients should now be able to connect to the slave and spectate the game in progress.

This is a "live broadcast" with no delay.

===Disconnect the slave===
To tell the slave to disconnect from the master:
:<tt>tv disconnect</tt>

===Slave Chaining===

==== What is chaining and why chain slaves? ====

ETTV allows chaining slaves together. This very neat feature let's you connect one ETTV slave to another ETTV slave that is broadcasting a match instead of directly to the game server hosting the match. Apart from the "wow this is very cool" factor, why is this feature so important for admins? Basicly, working in a chained model allows to broadcast a match to a large number of spectators without too much hastle and too many risks for the master server.

If you take into account that one ETTV slave connects at an '''unlimited''' rate to a master, you really don't want to connect 15 or 20 slaves to a game server to broadcast let's say the Atlantic Battle. Chances are you will bring down the master game server and thus the game. Chaining slaves firmly alleviates the load on the master game server. 2 or 4 of these ''Hubs'' can do the job of delaying the signal and feeding it to other slaves.

Other benefits might include better network performance. If you can choose to either connect your slave to the game server where your connection is not optimal or to a nearby slave who is on a better connection to the master, it might help the quality of your broadcast. Plus you don't need to record anything when connecting to a delayed slave.

==== Setting up your slave to allow connections from other slaves ====

This part is actually pretty easy. You need to set up your slave as if you were setting up a master game server. This means that, next to the normal slave parameters, you have to set up the following:

* '''b_ettv_flags''': set this to at least 1
* '''ettv_sv_maxslaves''': set this to at least 1. Depending on how powerful your machine is you can set this number higher. Don't set it too high though, a slave still connects at an unlimited rate
* '''set ettv_password''': set to something else than "". This password is needed by the slaves connecting to your slave (together with g_password of course)

Other settings such as ettv_netblast, ettv_tv_iptos etc... can be set as well. You can even use autorecord if you wish, or just add an extra delay.

==== Pitfalls ====

There are however a few risks associated with slave chaining. One of the biggest issues is '''PK3 dependancies'''.

As you know, a slave needs to have at least all the PK3s of the server it connects too. But a slave can have more PK3s installed, as long as it has the ones on the server's pure list. This is what complicates things! The further you go down the "chain", the more the chances exist of PK3 pollution, which makes the job of the last slave very hard. And the viewers connecting to that slave will not be very happy either.

So for those of you venturing into chaining slaves here's a rule of thumb: '''always keep the installed PK3s to the bare minimum'''! Do not add stuff you do not need. If you want to know what PK3s you need and not need, connect your slave to the master or the hub, see which PK3s are on the pure list and rename or remove the PK3s that are not on the list. You will make your viewers and other admins connecting to your slave very happy.

Another risk could be '''chained lag'''. If one of the slaves that is higher in the chain starts lagging, the consequenses for the slaves depending on it will be seen immedeatily. So if you offer to be one of the higher slaves in the chain, make sure your machine can handle it! An ETTV chain is much like the food chain ;-).

==== Admin contributions ====

If by now you feel like getting your hands dirty in ETTV chaining madness and you want to see some example of hubs, slaves, broadcasters and scripts to get it all working, you can already start by checking out [[User:Deej|deej's page]].

==ETTV Demos==
You may record the match in progress to a file, with the command:
:<tt>record <'''demo name'''></tt>
If you omit the demo name, ettv will start recording using a filename of demoXXXX where XXXX is the first available number starting from 0000.

Demos will stop recording when a map changes.

To stop recording a demo:
:<tt>stoprecord</tt>

To play back a recorded demo:
:<tt>demo <'''demo name'''></tt>

To check the status of an ettv slave:
:<tt>tv status</tt>
This will tell you if the slave is connected to a master, or if it is currently playing back a demo.

To fastforward a demo:
:<tt>ff <seconds></tt>
Eg <tt>ff 30</tt> will fast foward 30 seconds. Fast forward stops at map restarts, so you can safely ff 999 to fast forward through a warmup.
:''note'': requires ettv beta 7 or later

===Autorecording demos===
ettv is able to automatically continuously record demos, creating new demofiles when the map changes. To do this, set the cvar ettv_autorecord to 1. ettv will start recording demos with the name demoXXXX where XXXX is a number starting at 0000 and incrementing on each map change.

Server admins may find it useful to use the demo recording feature of ettv to record matches, instead of requiring individual players to record them. An ettv demo records everything that happens on a server, including all player viewpoints.

===How to create demo based delayed feeds===
Autorecording demos is the first half of the process for delayed feeds. Typically you would run a passworded slave server with the smallest number of sv_maxclients possible. No spectators should connect to this server. The only purpose of this slave is to connect up to the master and record the match to sequentially numbered demofiles.

Now start up a slave, and tell it to broadcast the demo being recorded.

:<tt>demo demo0000</tt>

If you wait approx. 60 seconds after the master begins recording before issuing this command to your slaves, then you have a 60 second delay on your broadcast.

If you want slaves to automatically switch to the next demo when the end of the demo is reached (eg on a map change), you would set the cvar ettv_autoplay to 1. If a slave is playing demo0000 and it reaches the end, it will then try to play demo0001 and so on.

Disadvantage of this method: It is not automated in ettv itself, though admins can script it.
Advantage of this method: You may run multiple broadcast servers from the same single demo stream.

Automated delayed feeds are supported in ettv beta 8. See the above.

==Troubleshooting==

* The slave server must be running the same fs_game setting as the master server.
* The slave server must have a copy of every map pk3 the master server is using.
* If the master server loads a map the slave server doesn't have, the slave will get stuck.
* Spectators will be forced to download any custom pk3 you are using.
* It is a good idea to keep the master server pk3 list to a minimum.
* If you are using the autorecord/autoplay feature for running delayed feeds, you will usually want to make sure you clear out the demos directory first. Autorecording will start numbering demofiles using the first available number, so if you have old recorded demos then ettv might start recording from eg demo0017. If your scripts expect to start playback from demo0000 then you might end up broadcasting a game recorded at some earlier date...

==Miscellaneous==

Slaves may send chats to the master with the command msay
Slaves may list players on the master with the command players

==Performance tuning==

Spectator servers with large numbers of clients (eg >100) will push the OS very hard with huge amounts of UDP traffic. The default OS buffer settings for Linux are inadequate and can hurt performance, causing lag and/or disconnects.

If you get messages like
:<tt>NET_SendPacket ERROR: No buffer space available to 192.168.120.142:27960</tt>

Then you definitely need to increase your kernel network buffers.

Large spectator servers should increase the kernel buffers.

The following commands should be issued as root on linux:
:<tt>echo "524288" > /proc/sys/net/core/rmem_max</tt>
:<tt>echo "524288" > /proc/sys/net/core/wmem_max</tt>

FreeBSD can try this:
:<tt>sysctl -w net.inet.udp.recvspace=65535</tt>
:<tt>sysctl -w net.inet.udp.maxdgram=57344</tt>
:<tt>sysctl -w kern.ipc.maxsockbuf=8388608</tt>

===Network tuning cvars===
;The following are only available in ettv beta 7 and later.
By default, et uses small packets of 1400 bytes or less to send to clients. If messages need to be larger, they are 'fragmented' and sent over several server frames. ettv slave messages tend to be large and often fragment. ettv normally tries to send slaves all fragments at once to avoid jittery playback, but some networks / OSes handle this badly. ettv beta 7 introduces new controls so admins can optimize ettv for their individual network.

'''ettv_netblast''' (default 1)
:by default, ettv tries to send all fragments at once. some networks may handle this badly. setting this to 0 disables. warning: setting this to 0 without increasing ettv_mtu will result in severely laggy slave playback.

'''ettv_mtu''' (default 1400)
:; master only
:if your network / os supports it, you can set this to large values (eg 16000) to prevent message fragmentation and provide smoother ettv links. this cvar has no effect on normal ET clients.
:''note'': ettv_mtu must currently be set from commandline, it cannot be changed on the fly (yet).

'''ettv_tv_iptos''' (default 0)
:you can set the ip type of service field of ettv link packets. if your network/ISP supports it, you can use a value like 16 ("minimize delay") to prioritize ettv link packets over others on the network.

'''ettv_sv_iptos''' (default 0)
:same as ettv_tv_iptos, but affects packets for normal ET clients.

[[Category:ETTV]]

Server Configuration

2005-11-07T18:51:31Z

2005-11-05T20:01:41Z

Deej: /* Some scripts I use */

User:Deej

2005-11-05T20:00:41Z

Deej: /* Deej's proposition */