[cobalt-users] How To Install RealServer on a RaQ4

[Carrie Bartkowiak <ravencarrie@xxxxxxxx>]

Installing RealServer on a RaQ4i

1. Go through the process to download the RealServer program from the Real website. This will have a license file sent to you that will allow the server to run.
This page (at the time of this writing) is at: http://proforma.real.com/rn/servers/univdwnld/index.html?ulf=bas
When you're done registering, copy the URL of the download file and paste it into a notepad file so you can grab it later.
2. Shell into your machine, su to root. 
Create a directory for RealServer to run from. I chose /home/installs/realserver. /home has more room than /usr.
# mkdir /home/installs/realserver
3. CD into that directory.
# cd /home/installs/realserver
4. Check your email. You should have the Real license by now. Open the file they sent you in a plain-text editor (like Ultra-Edit). Make a note of the file name and paste it into the little notepad file you created earlier with the URL for the file download. This will make it easier to just paste things rather than typing out long names over and over.
5. Create the license file and copy the text of the license into it. You have to do this by copying sections at a time from the file sent to you by Real. (Sections at a time so you don't overload your shell buffer.) Open the license file that Real sent you in a PLAIN-TEXT editor, like Ultra-Edit. Highlight a large chunk of it and copy it.
Now, create the file and open it so that you can write to it (you must use the name of YOUR file that Real sent you):
# pico <name of file Real sent you.lic>
The file is now open. Right-click on the screen and the section you copied will write itself to the screen, pasting into the file. Continue doing this until you've copied and pasted the entire contents of the license file.
When you are finished, hit CTRL-X, type Y for yes, and hit enter. The license file is now written and waiting for you to use it.
6. Download the RealServer file (copy and paste the URL from your notepad file to make it easy):
# wget <URL of download file>
When the download is finished, it will echo the filename to the screen. Highlight this (in effect, copying it) so you can just paste it (by right-clicking) in the next two steps.
7. Set the permissions so that we can execute the file:
# chmod +x <filename>
8. Open the bin file:
# ./<filename>
9. Now the install will run you through a series of questions.
You'll be asked for a username and password to administrate the server. Make sure you write these down somewhere! You will need them.
It is very important that when it asks for the location of the license file, you give it the full directory path *including* the name of the license file. Again, use your little notepad file for copy/paste ease. The path you give it should look something like this:
/home/installs/realserver/1234-12-12-54843875387.lic
You'll know you've done it right if the install then forces you to read all of the license garbage and agree to it.
When the install program asks you where to install the realserver files, give it the full path of the directory you created earlier:
/home/installs/realserver
At the end of the install, it will list off a set of ports. Most of these are defaults and won't need to be changed. If you do have something running on those ports though, you'll need to change them. It will also randomly generate a port for the administration pages. Write this port down. 
Once it's finished, it will ask you if you want to start the server. Tell it yes. Copy the URL of the administration page, paste it into a browser, and open that page up. Bookmark it for later. You'll need the admin username/password that you created earlier.
10. To get the RealServer to start when the machine reboots, drop these three lines into your /etc/rc.d/rc.local file at the end:
#Start RealServer
/home/installs/realserver/Bin/rmserver
/home/installs/realserver/rmserver.cfg &
Note that if you changed the directory that you installed realserver to, you'll need to change the path in the above lines.

You're all done! Go back over to your browser and cruise through the RealServer administration documentation and settings, and proceed to be hopelessly lost.  ;)
Just rest assured that RealServer is running on your machine.

Note: if your admin page won't open up, you've done something wrong. Go back and do it again and make sure you don't miss anything.
--
CarrieB
"I do believe that where there is a choice only between cowardice and violence, I would advise violence." --Mahatma Ghandi