rld 1.0 documentation

Quickstart

Follow these steps to get you up and running:

  1. Follow the download instructions.
  2. Start rld. If successfull, you will see something like this:
    
                Welcome to rld.
                Type 'help' for help.
    
                >
    
    
  3. Create an administrator account for yourself (-1 means: all privileges):
    
                adduser mylogin mypassword -1 mynick
    
    
  4. Create a guest account for other users (with no privileges whatsoever):
    
                adduser guest
    
    
  5. Put the files that you want to serve in the files directory.
  6. People should be able to connect to your server now. Now is the time to fine tune the permissions for the guest account. The easiest way to do that is of course by simply using rl to login to your server using your admin account.
  7. Give your server a name and a description, by typing the following lines at the console:
    
                set server.name My server
                set server.description All my stuff.
    
    
  8. To register your server with a tracker, create a textfile called trackertable in the ~/.redlight directory. For example, to track your server on dmp.fimble.com and darksidetracker.dhs.org, put the following lines in the trackertable file:
    
                dmp.fimble.com
                darksidetracker.dhs.org
    
    
    After a few minutes, your server should start to appear on those trackers.
  9. If you run into problems, see if the messages in ~/.redlight/rld.log are any use.

Starting rld

How to start rld depends on your operating system. If you are on Unix and have done 'make install' from source (or installed a binary .rpm package), a simple


            $ rld

should suffice. On Windows / MacOS X, you should get the .jar file and open a Command Prompt / Terminal:

            java -classpath location of .jar file redlight.server.Main

You can do this on Unix derivatives, too, of course, should the rld wrapper script fail.

If none of this works, then most likely you need to install a Java runtime (sun.com). You may want to make sure that java is in your PATH.

25 october 2001