Installing RealServer on UNIX Platforms

Server installation files are available for several UNIX platforms. After selecting the appropriate installation file, you need to launch the setup program. Detailed instructions follow.

Accessing the RealServer Distribution File from the Web

RealServer is available from the RealNetworks Web site. Follow the instructions on the download page.

Uncompress the file with the following command, then refer to Running the Setup Program:

gunzip -c <filename>.tar.gz | tar xfv -

RealNetworks may send your Customer Name and License Key via e-mail, depending on the server package you've chosen. If so, cut and paste these values from the email to avoid typographical errors.

Accessing the RealServer Installation Files on CD-ROM

UNIX-based operating systems require you to mount a new file system or device before running the Setup program. The commands needed to mount a CD-ROM differ slightly depending on the system. Follow the appropriate mounting instructions below and then start the setup program.

To mount the CD-ROM on Sun Solaris

  1. Insert the CD-ROM and wait for the operating system to mount the CD-ROM.
  2. If you are running File Manager, a window displays the disk contents.
  3. If you are not running File Manager, in a shell type:

    cd /cdrom/pn_server

To mount the CD-ROM on all other UNIX-based systems

  1. Insert the CD-ROM in the drive.
  2. Log in as super-user.
  3. From a shell, check for a /cdrom directory to mount the CD on. If one does not already exist, type:
    mkdir /cdrom
  4. Type the appropriate command to mount the CD-ROM:

Operating System Command
Sun OS mount -rt hsfs /dev/sr0 /cdrom
DEC UNIX mount -t cdfs -o noversion /dev/rz3c /cdrom
SGI IRIX mount -rt iso9660 /dev/scsi/sc0d7l0 /cdrom
IBM AIX mount -rv cdrfs /dev/cd0 /cdrom
Hewlett-Packard HP-UX mount -rF cdfs /dev/dsk/c0t2d0 /cdrom
FreeBSD mount -rt cd9660 /dev/cd0a /cdrom
BSD/OS mount -rt cd9660 /dev/sd1 /cdrom
Linux mount -rt iso9660 /dev/hdc /cdrom


Running the Setup Program

After mounting the CD-ROM and uncompressing the distribution file, you need to launch it as an install program. During installation, the setup program can set some default options, such as passwords and default ports, for you or you can customize these configuration settings.

To start the install program

  1. Change directory to the CD-ROM:

    cd /cdrom

    Sun Solaris only: Change directory to the pn_server directory: cd /cdrom/pn_server

  2. Change directory to the server directory: cd server
  3. HP-UX only: HP-UX computers cannot run setup from the CD-ROM. Copy the server.tgz file to a directory on the computer and uncompress it, then extract the resulting file using the following commands: gunzip -c <filename>.tar.gz | tar xfv -
  4. From the directory in which you untarred the distribution file, run the ./setup program. The following list of navigational controls are displayed:
  5. Key Behavior
    N Next
    P Previous
    X Exit
    F Finish (Express Installation)
    H Help
  6. Type the Customer Name as provided (via e-mail or in the application packaging) by RealNetworks or your RealNetworks reseller.
  7. Type [N]ext to continue.
  8. Type the License Key exactly as provided (via e-mail or in the application packaging) by RealNetworks or your RealNetworks reseller. Use cut and paste if possible to avoid typographical errors.
  9. Type [N]ext to continue.
  10. Read the Server License agreement. Type [N]ext to accept the terms of the license, or any other key to cancel the installation.
  11. The setup program displays information about your server license. Type [N]ext to continue.
  12. All the information necessary for installation has been provided.
  13. Press Express [F]inish to accept the default installation options or press [N]ext to set the options yourself.

If you are setting the options yourself:

  1. Type a monitor password, or accept the default (letmein).
  2. Type [N]ext to continue.
  3. Type a Live Encoder password, or accept the default (letmein).
  4. Type [N]ext to continue.
  5. Type a Live File Archive password, or accept the default (letmein).
  6. Type [N]ext to continue.
  7. Type the TCP port on which the RealServer should listen, or accept the default (7070).
  8. Type [N]ext to continue.
  9. Type the e-mail address to which the RealServer should send system error messages.
  10. Type [N]ext to continue.
  11. Type the e-mail server hostname that RealServer should use for e-mail messaging service.
  12. Type [N]ext to continue.
  13. Type [Y]es to enable Smart Networking. For more information, see "Smart Networking" on page 13.
  14. Type [N]ext to continue.
  15. Type the user ID for running the server.
  16. Type [N]ext to continue.
  17. Type the group ID for running the server.
  18. Type [N]ext to continue.
  19. A screen displays the configuration settings you selected.
  20. Verify the RealServer configuration settings you chose.
  21. Type [N]ext to begin copying files to your directory.
  22. A screen displays information about how to contact RealNetworks for help.
  23. Type [N]ext to continue.
  24. Type E [X]it to complete the installation.

After installing RealServer, it is recommended that you test your installation by playing a sample media clip. For instructions, see Testing RealServer with a Sample Media Clip.

Setup asks you to register online. RealServer will not start unless you register.


RealServer License Agreement

The setup program displays information about your server license. For example:

Your License has the following features:

Valid License
Version: 2
Platform: UNIX

Start Date: 5/23/1997
Expiration Date: 5/23/1999
Licensed Streams: 10
User Streams: 0
Multi-Media: Enabled
Live: Enabled
ISP Hosting: Disabled
ISP Only: Disabled
User Max Limit: Disabled
Platform Checking: Disabled
Intranet Only: Disabled
Remote License: Disabled
Remote Streams w/ Local Lic: Disabled
Local Streams: Enabled
Remote Streams w/ Remote Lic: Disabled
Dynamic ISP licensing: Disabled

Restricted IP Access: Disabled
Ad Insertion: Disabled
Client Authentication: Disabled
RealFlash: Disabled


RealServer Directories and Files on UNIX Platforms

The RealServer setup program creates the following directories and copies files into them.

pnserver (default root directory)
        /bin
        /commerce
        /content
        /docs
        /logs
        /plugins

Refer to the following sections for descriptions of the files that are copied to each of these directories during installation.

The Root Installation Directory

The default root installation directory contains the following ASCII text files:

File Description
server.cfg The configuration settings for the server.

The bin Directory

The bin directory contains the following executable files:

File Description
adlist.so.5.0 The Ad InsertionAd Insertionexecutable executable.
pnserver The RealServer executable.
raconv The bandwidth negotiation file converter, which converts RealAudio files to a bandwidth negotiation naming scheme.
rainfo Utility that displays header information (title, author, copyright) about a clip.
rmcut Cuts a specific portion of a RealVideo file without changing the original source.
rmedit Modifies the title, author, copyright, comment, MIME type, or stream name. It can also be used to print the current values for the file or stream.
rmfiler The live RealMedia file creation utility, which creates (archives) files from live broadcasts.
rmpaste Combines two or more RealVideo files.
rssm The System Manager executable.
swftune A command-line utility for altering the bit rate of a RealFlash file.

The commerce Directory

The commerce directory contains the Authentication files and directories.

The content Directory

The content directory contains sample media files. This directory is also the location in which you should save content files you create.

You should not store media files in directories on your Web server. The RealServer is independent of and does not communicate with the Web server.

The content directory also contains the Admin directory, which contains files for administering the RealServer. Also in this directory is the JavaMonitor directory, which contains all the Java classes you need to run the Java Performance Monitor.

The docs Directory

The docs directory contains the following ASCII files:

File Description
PROBLEM A list of known server problems.
README Information about server installation and operation.
License.txt Server license agreement

The logs Directory

Until you launch the RealServer, this directory is empty. The logs directory contains the log files in ASCII text format. These files are dynamically created when you launch the RealServer.

File Description
pnaccess The access log contains information about clients that have connected to the server.
pnerror The error log lists information and error messages about server operation.
pnserver.pid When the server is running, this file contains the server's current process ID (PID) When the server is not running, this file contains the server's last-used PID.

The plugins Directory

The plugins directory stores any plug-in libraries used by RealServer.

File Description
swf3250.dll RealFlash plug-in library.
ppvbasic.so.5.0 Authentication data text file
ppvmsql.so.5.0 Authentication mSQL database
jmonfs.so.5.0 Java Performance Monitor page
ppvfs.so.5.0 Administration page
statfs.so.5.0 Status page
tstfs.so.5.0 Test sample content page

© 1997 RealNetworks, Inc.