The launcher is a new program developed to make running a server with lots of zones less of a hassle. The launcher also dramatically simplifies remote administration and log collection by allowing an administrator to properly start, restart, and stop zones from the world HTTP interface.
The launcher itself has very little user interface, it is a simple command line application. All of the launcher configuration and status information is avaliable in the world HTTP interface.
The overall position of the launcher can be seen in this diagram:
(more details about this diagram are avaliable on the DevArch
As this diagram points out, you can have many different servers in your network, each of which runs a single instance of the launcher, and one of which runs the world process. All of these need direct access to the database however (should be a low latency link).
Configuring A Launcher
A launcher cannot successfully connection to world until world is told it exists.
- The launcher is configured using the world HTTP interface. For information about how to log into this interface, see ServerWorldLogin. Under the World menu, there is a launchers option.
- The first thing you need to do is to add a new launcher. The launcher name should be short and should not contain spaces or special characters. Dynamic Count is the number of dynamic zones you want to boot on this launcher. (if you get errors on creation, hit the reload link)
- Now you will get a rather empty launcher configuration screen. From this screen, you can configure all the zones you want your launcher to boot. You can boot static zones by specifying a valid zone short name, and an optional port if you want the zone to use a specific port (0 means dynamic assignment).
Running A Launcher
To run a launcher, you simply execute the eqlaunch binary, specifying the launcher name you configured above as the only argument on the command line.
In theory, you could run two different launchers on the same machine, with different launcher names, but there is little reason to do this...