Installing RealServer G2

1. Connect to your Virtual Server using Telnet or SSH
2. Create an install directory for your Real Server. Type:

   % cd
% mkdir usr/local/realserverg2

3. Download the Real Server free software from Real Audio (make sure to select the FreeBSD version) to your newly created installation directory (~/usr/local/realserverg2). Upload this file to your Virtual Server in binary format.
4. If you have purchased a license from Real Networks you will need to upload this to your server as well. This most likely will have been sent to you as an e-mail attachment.
5. Run the RealServer setup utility. Type:

   % cd ~/usr/local/realserverg2
% chmod 755 g2p3-freebsd-3_0.bin
% ./g2p3-freebsd-3_0.bin


Setup Guidelines

• When the setup utility prompts you for a directory path you must enter the full path name to your Virtual Server, like /usr/home/LOGIN/usr/local/realserverg2. Do not use virtual paths such as ~/usr/local/realserverg2.
• When prompted for username and password we suggest you use your virtual server login and password.
• You can accept the default port for RealServer PNA (7070) and HTTP (8080) requests. A RealSystem Administrator port number will be randomly generated. Just make sure you don't introduce any port conflicts. For all of the ports, you must choose a port number greater than 1024. Here are some suggestions:    

  RTSP Port: 5540
Admin Port: 4574

• When setup prompts you to start your server select no, one change must be made in your rmserver.cfg file (~/usr/local/realserverg2/rmserver.cfg) before your Real Server will run correctly. Add the following lines substituting your IP address.

  <List Name="IPBindings">
  < Var Address_01="YOUR.IP.ADD.RESS"/>
</List>

Starting Real Server

To start Basic Server G2 type:

% cd ~/usr/local/realserverg2
% Bin/rmserver rmserver.cfg &

To make sure your Real Server is running correctly use the following URL in your browser:

http://YOUR-DOMAIN.NAME:4574/admin/index.html

"4574" is the default setting for the RealSystem Administrator port. If you chose a different port number while running the setup utility, you will need to substitute that number.

From the menu you should see on the left, choose "Samples". If you have already installed a RealPlayer G2 on your own computer, you can then attempt to play one of the sample Real Media clips.

You should add Basic Server G2 to your Rc file (~/etc/rc) so that it will automatically start in case of a host machine reboot.

~/usr/local/realserverg2/Bin/rmserver ~/usr/local/realserverg2/rmserver.cfg &

Serving Real Media

1. Make sure that your Virtual Server is set up to handle Real Media file extensions such as .rm, .ra, .ram.

   Telnet to your server and view your MIME types file located at ~/www/conf/mime.types. Check to see if the two following line are in the file, if not you will need to add them. If you add these files make sure to restart apache using the restart_apache command.

   audio/x-pn-realaudio    ram rm ra audio/x-pn-realaudio-plugin   rpm

2. FTP your encoded files to the ~/usr/local/realserverg2/Content directory making sure that you are transferring your files in binary format. This is the default path that Real Server looks for media. You can change this default path by either editing your server.cfg file or through you administrative interface.
3. Next through any simple text editor create a metafile with the following syntax:

   pnm://YOUR-DOMAIN.NAME/MEDIAFILE.rm

   Change YOUR-DOMAIN.NAME to the domain name of your Virtual Server and MEDIAFILE to the name of the Real media file you uploaded to your content directory in the previous step.
4. Save the above file with any name with the extension .ram. This and all metafiles should be saved in the hierarchy of your ~/www/htdocs directory.
5. Finally, reference the metafile as a hyperlink in your HTML document. For example:

   <a href="mediafile.ram"> <a href="/support/addonhelp/multimedia/realserver/media/sampleaudio.ram">

   Working Examples

   The following links are actual examples which implement the instructions included on this page. Go ahead and try them out! (Note: the video clip example takes a little bit longer to start).

   Audio Clip Example

   Video Clip Example