RealNetworks Products for

SCO OpenServer Release and Installation Notes


Table of Contents



© 1999 The Santa Cruz Operation, Inc. All rights reserved.


Chapter 1: About RealNetworks products

RealNetworksTM software (including servers, encoders, and players) provides a complete solution for streaming media and allows Internet or intranet users to easily access multimedia content in real time.

RealServerTM G2 uses a client/server architecture to support large numbers of concurrent users. The server delivers encoded media over a network to RealPlayerTM, the client program that enables users to view and listen to RealAudio® and RealVideo® clips. You can encode media from live input or an existing digitized content file.


NOTE: Encoding cannot be done on SCO OpenServerTM, but can be done on a UnixWare® 7 from SCO® system or on a Windows client.

The RealAdministrator is included, which allows you to configure your server and monitor server status through a web browser via the Internet or your intranet (see the chapters on customizing RealServer and on monitoring activity in the Administration Guide).

System requirements

RealServer G2


Software: SCO OpenServer Release 5 (with TCP/IP networking)
RAM:
32MB (64MB recommended) for light server traffic
128MB for medium traffic
256MB for heavy traffic
Disk space: 12MB free disk space
Other: Web server with configurable MIME types

RealPlayer Release 5


Software: SCO OpenServer Release 5.0.4 or later
Supplement: Audio Configuration Manager Supplement --
including Audio configuration manager, utilities, and drivers
as well as the ISA Plug and Play component specific to
the operating system
RAM: 32MB (64MB recommended)
Disk space: 2MB free disk space
Video card: 256 colors required (24-bit color recommended)
Sound card: 16-bit sound card with Open Sound System sound driver


NOTE: RealPlayer is also available for SCO OpenServer Release 5.0.0 and 5.0.2, but is supported only through the Open Sound System driver package, Release 3.7.1 or later. You can download the driver package from:

http://www.sco.com/skunkware/audiovis/#4front



RealNetworks licenses

The Optional Services CD contains the following RealNetworks products that are licensed with all networked versions of the SCO operating system:

These products do not require an additional license. They are provided for free use in accordance with the product license agreement.


NOTE: A server licensed for streams can only be used on the Internet where the content is not primarily accessed from an intranet. A server licensed for seats can only be used on an intranet (for example, inside a company firewall).

Other RealNetworks products on the CD available for separate licensing are:

See also:

Installation directory

The RealNetworks server installs into the directory /usr/lib/rng2server.

Commerce Server not supported on SCO platforms

The RealNetworks manuals occasionally make reference to a Commerce Server or ``the (optional) commercial database''. This product is not part of SCO's distribution of RealNetworks software, but can be purchased separately from RealNetworks, Inc. to run on another platform.

RealPlayer G2 available free

When ready for distribution, RealPlayer G2 for SCO platforms will be available for free download from the SCO web site at:

http://www.sco.com/download

For more about RealPlayer G2, see the RealNetworks, Inc. web site at http://www.real.com.

Chapter 2: Installing RealNetworks products

Before installing the RealNetworks server, make sure the following required software is installed on your system:

Installing the RealNetworks server


NOTE: To add more streams or seats to an existing G2 server or to upgrade server functionality (from Basic Server Plus to Internet or Enterprise Server), you need a separate license -- see ``Licensing the RealNetworks server''.

  1. Start the Software Manager (custom).

  2. From the Software menu, select Install New.

  3. Select the machine to install from. Then, identify the media device and insert your CD.

  4. Select the software to install, then click on Install.


    NOTE: If you have RealServer 5.0 installed when you try to install RealServer G2, you will be asked if you want to remove it.

    If you answer yes to removing RealServer 5.0, you must exit from the Software Manager and follow the procedures in ``Removing RealNetworks products''.

    If you answer no to removing RealServer 5.0, you will be asked if you want to preserve relevant preferences from your RealServer 5.0 configuration.

    If you answer no to preserving preferences from RealServer 5.0, your RealServer 5.0 installation directory (including any custom configuration and content files) will remain on the system in /usr/lib/pnserver, while RealServer G2 installs in /usr/lib/rng2server. (Although both servers can be installed on a system, you cannot run both servers at the same time.)

    If you answer yes to preserving preferences from RealServer 5.0, your custom configuration and content files can be brought forward to your RealServer G2 installation in response to the prompts in the next step.


  5. You will need to provide information for the following topics:

When the installation is complete, see ``After installing the RealNetworks server''.

After installing the RealNetworks server

If you chose not to enable or start the server automatically during installation, you can do it now. See:

Be sure to also test the server.

You can add a license or modify the server configuration. See:

Enabling and disabling the RealNetworks server

If the server wasn't enabled as part of the installation, you can enable the server at any time to have it run automatically upon system reboot:

  1. Log in as root.

  2. At the command line, enter:

    /etc/realserver enable

After the server is enabled, you can reboot the system to automatically start the server or you can manually start the server.

At any time, you can disable the server so it no longer starts on reboot:

/etc/realserver disable

To find out if the server is enabled, enter:

/etc/realserver query

Starting and stopping the RealNetworks server

If the server wasn't started as part of the installation, you can manually start the server at any time:

  1. Log in as root.

  2. At the command line, enter:

    /etc/realserver start

If you want the server to start on system reboot, you can enable the server.

To manually stop the server from running, enter:

/etc/realserver stop

To find out if the server is running, enter:

/etc/realserver query

Testing the RealNetworks server

Make sure the server has been started.

To test that RealServer is installed properly:

  1. Access RealAdministrator through a web browser by opening:

    http://serverName:port/admin/index.html

    serverName is the name of the system on which RealServer is running. port is the RealAdministrator port number you entered during installation.

    When prompted for a username and password, use the values you entered during installation. (These values are also defined in the rmserver.cfg file. For information on the rmserver.cfg file, see Appendix A, B, and C in the Administration Guide.)


    NOTE: If you're not prompted for a username and password and can't access RealAdministrator, the server might be installed properly, but isn't running -- see ``Starting and stopping the RealNetworks server''.

  2. From the RealAdministrator, use the monitor to check the status of the server.

See also:

Licensing the RealNetworks server

Server licenses are cumulative. Starting with the free RealSystem G2 Basic Server Plus license, you can add more connections or functionality by obtaining and applying additional licenses.

When you purchase a license, you are provided with a license file. Simply copy the new license file to the /usr/lib/rng2server/License directory and restart the server. The server will then have the newly licensed capabilities.


NOTE: License details for the RealNetworks server cannot be applied with the SCOadmin License Manager.

See also:

Configuring the RealNetworks server

You can customize the various server settings with RealAdministrator (see the chapter on customizing RealServer in the Administration Guide) or by editing the file /usr/lib/rng2server/rmserver.cfg (see Appendix A, B, and C in the Administration Guide).

Changes you make through RealAdministrator are reflected in the server's configuration file. Each time this file is written to from RealAdministrator, a backup of the rmserver.cfg file is made with the name rmserver.cfg.bak. If you encounter problems with your system and must resort to your original server configuration file, copy your backup file and restart your server.

Removing RealNetworks products

Be aware that no server configuration or content data is preserved if you simply remove the server product.

If you want to remove an existing RealServer, do so before beginning the RealSystem G2 server installation, but first preserve your configuration and content (if desired):

  1. If you've done any customized server configuration, save aside the file /usr/lib/rng2server/rmserver.cfg (for RealServer G2) or the file /usr/lib/pnserver/server.cfg (for RealServer 5.0 or Basic Server Plus 5.0).

  2. If you've modified or added any content files, save aside the directory /usr/lib/rng2server/Content (for RealServer G2) or /usr/lib/pnserver/content (for RealServer 5.0 or Basic Server Plus 5.0).

  3. Remove the existing server product by starting the Software Manager (custom) and selecting the product to be removed from the list of installed software. From the Software menu, select Remove Software.

If you do not want to remove an existing RealServer, simply follow the installation steps and respond to the prompts about removing the previous server and preserving configuration and content. When installing RealSystem G2 server, you are not required to first remove the previous release of RealServer. Although both servers can be installed on a system, you cannot run both servers at the same time.

Chapter 3: RealNetworks documentation

After the RealNetworks software is installed, you can view the RealNetworks documentation with a browser capable of displaying frames.

If you don't already have a suitable browser, install a free version of Netscape CommunicatorTM from the Optional Services CD (see Release and Installation Notes for SCO Internet products on the CD in /info/nscomm/relnotes/relnotes.htm).

On the RealNetworks server, start the Netscape browser and open:

file:/usr/lib/rng2server/RealAdministrator/Docs/Manual/realsrvr.htm
(for RealServer Administration Guide)
file:/usr/lib/rnplayer/index.htm
(for RealPlayer Guide)

RealServer Administration Guide documents all of the RealNetworks G2 servers. Depending on which RealServer product you purchased, some of the features described in this manual may not be available to you or may be limited in some way (such as the number of streams you can transmit simultaneously). Consult your license file for a list of which features are enabled on your RealServer. If you would like to add to your RealServer's capabilities, contact SCO, RealNetworks, or your reseller. (To review the new features, see Chapter 1, ``What's New in RealServer G2'' of the RealServer Administration Guide.)

Because the RealNetworks products are supported by several operating systems, their documentation includes information specific to other operating systems. You can ignore such information.


NOTE: These Release and Installation Notes supercede the RealNetworks documentation, particularly for installation and other platform-specific information.

See also:

Setting up push splitting

The instructions for setting up push splitting in the chapter on splitting and multicasting in the Administration Guide are not correct. Follow these instructions instead.

To connect two machines for push splitting (for example, source.server.com and splitter.server.com), do the following:

Printing PostScript documentation

If you prefer to read printed documentation, you can download the PostScript® from the SCO web site to print the RealServer Administration Guide:

  1. Download the PostScript files into a temporary directory (for example, /tmp1) by pointing your browser at:

    http://www.sco.com/documentation/postscript

  2. Change to the download directory, for example:

    cd /tmp1

  3. The PostScript is provided in gzip (.gz) compressed format. You must use the gunzip utility to uncompress these files.

    If you don't already have the gunzip utility:

    1. Download gunzip_osr5.tar to the temporary directory from:

      http://www.sco.com/documentation/postscript/bin/gunzip_osr5.tar

    2. Extract the gunzip binary into the file /usr/bin/gunzip with:

      tar xvf gunzip_osr5.tar

  4. From the download directory, uncompress and print the files:

    /usr/bin/gunzip *.gz | lp -opost -dprinterName

    Substitute the name of a PostScript printer for printerName and, if necessary depending on your printer model script, change the -opost option.

Chapter 4: Known limitations

General limitations

For more information, see /usr/lib/rng2server/RealAdministrator/Docs/readme.htm.


Copyright

©1983-1999 The Santa Cruz Operation, Inc. All rights reserved.

This publication is protected under copyright laws and international treaties.

© 1976-1998 The Santa Cruz Operation, Inc.; © 1989-1994 Acer Incorporated; © 1989-1994 Acer America Corporation; © 1990-1994 Adaptec, Inc.; © 1993 Advanced Micro Devices, Inc.; © 1990 Altos Computer Systems; © 1992-1994 American Power Conversion, Inc.; © 1988 Archive Corporation; © 1990 ATI Technologies, Inc.; © 1976-1992 AT&T; © 1992-1994 AT&T Global Information Solutions Company; © 1993 Berkeley Network Software Consortium; © 1985-1986 Bigelow & Holmes; © 1988-1991 Carnegie Mellon University; © 1989-1990 Cipher Data Products, Inc.; © 1985-1992 Compaq Computer Corporation; © 1987-1994 Computer Associates, Inc.; © 1986-1987 Convergent Technologies, Inc.; © 1990-1993 Cornell University; © 1985-1994 Corollary, Inc.; © 1990-1994 Distributed Processing Technology; © 1991 D.L.S. Associates; © 1990 Free Software Foundation, Inc.; © 1989-1991 Future Domain Corporation; © 1994 Isogon Corporation; © 1991 Hewlett-Packard Company; © 1994 IBM Corporation; © 1990-1993 Intel Corporation; © 1989 Irwin Magnetic Systems, Inc.; © 1988-1991 JSB Computer Systems Ltd.; © 1989-1994 Dirk Koeppen EDV-Beratungs-GmbH; © 1989-1991 Massachusetts Institute of Technology; © 1985-1992 Metagraphics Software Corporation; © 1980-1994 Microsoft Corporation; © 1984-1989 Mouse Systems Corporation; © 1989 Multi-Tech Systems, Inc.; © 1991 National Semiconductor Corporation; © 1990 NEC Technologies, Inc.; © 1989-1992 Novell, Inc.; © 1989 Ing. C. Olivetti & C. SpA; © 1989-1992 Open Software Foundation, Inc.; © 1988-1994 Platinum Technology, Inc.; © 1993-1994 Programmed Logic Corporation; © 1989 Racal InterLan, Inc.; © 1998 RealNetworks, Inc. © 1990-1992 RSA Data Security, Inc.; © 1987-1994 Secureware, Inc.; © 1990 Siemens Nixdorf Informationssysteme AG; © 1991-1992 Silicon Graphics, Inc.; © 1987-1991 SMNP Research, Inc.; © 1987-1994 Standard Microsystems Corporation; © 1984-1994 Sun Microsystems, Inc.; © 1987 Tandy Corporation; © 1992-1994 3COM Corporation; © 1987 United States Army; © 1979-1993 Regents of the University of California; © 1993 Board of Trustees of the University of Illinois; © 1989-1991 University of Maryland; © 1986 University of Toronto; © 1988 Wyse Technology; © 1992-1993 Xware; © 1983-1992 Eric P. Allman; © 1987-1989 Jeffery D. Case and Kenneth W. Key; © 1985 Andrew Cherenson; © 1989 Mark H. Colburn; © 1993 Michael A. Cooper; © 1982 Pavel Curtis; © 1987 Owen DeLong; © 1989-1993 Frank Kardel; © 1993 Carlos Leandro and Rui Salgueiro; © 1986-1988 Larry McVoy; © 1992 David L. Mills; © 1992 Ranier Pruy; -169; 1986-1988 Larry Wall; © 1992 Q. Frank Xia. All rights reserved.

Information in this document is subject to change without notice and does not represent a commitment on the part of The Santa Cruz Operation, Inc.

Business/21, dbXtra, DiSCOver, Internet Way of Computing, IWoC, Multiscreen, ODT, Open Desktop, Optimized For Internet Computing and its logo, Panner, SCO, SCO ACE, SCO CIFS Bridge, SCO Doctor, SCO Doctor for Networks, SCO Doctor Lite, SCO Global Access, the SCO logos, SCO MPX, SCO MultiView, SCO Nihongo OpenServer, SCO OK, the SCO OK logo, SCO OpenServer, SCO Open Server, SCO Portfolio, SCO POS System, SCO Premier Motif, SCO TermLite, SCO ToolWare, SCOtopia, SCO Vision97, SCO VisionFS, SCO Visual Tcl, Skunkware, Tarantella, the Tarantella logo, The Business Choice, The Santa Cruz Operation, UnixWare, Universal Server, VP/ix and Zones are trademarks or registered trademarks of The Santa Cruz Operation, Inc. in the USA and other countries. APC, SoftCare and SoftTech are service marks of The Santa Cruz Operation, Inc. Deskterm, Deskworks, IXI, IXI Desktop, the IXI logo, IXI Panorama, Wintif, and X.desktop are trademarks or registered trademarks of IXI Limited, a subsidiary of The Santa Cruz Operation, Inc. X.tra is a service mark of IXI Limited. Codon, Devkit.Vision, Esprit, Kodon, PC-Connect, SQL-Retriever, SuperVision, Super.Vision, TermVision, Term.Vision, Vision Builder, Visionware, Visionware Direction, the Visionware logo, Visionware SQL-Retriever, Visionware Super.Vision, the XV logo, XVision, and X-Visionware are trademarks or registered trademarks of Visionware Limited, a subsidiary of The Santa Cruz Operation, Inc. X/Open and UNIX are registered trademarks and the X Device is a trademark of The Open Group in the United States and other countries. Cheyenne and ARCserve are registered trademarks of Cheyenne Software, Inc. Netscape, Netscape Navigator, Netscape Communications Server, Netscape Commerce Server, Netscape LiveWire, Netscape Proxy Server, Netscape FastTrack Server, Netscape Enterprise Server, Netscape SuiteSpot, Netscape Catalog Server, Netscape News Server, Netscape Mail Server, and Netscape Navigator Gold are trademarks or registered trademarks of Netscape Communications Corporation. NFS was developed by Computer Associates, Inc. (formerly Lachman Associates, Inc. and Legent Corporation) based on LACHMAN SYSTEM V NFS. LACHMAN is a trademark of Legent Corporation. NFS is a trademark of Sun Microsystems, Inc. TCP/IP was developed by Computer Associates, Inc. (formerly Lachman Associates, Inc. and Legent Corporation) based on LACHMAN SYSTEM V STREAMS TCP, a joint development of Lachman Associates and Convergent Technologies. MPX was developed by Corollary, Inc. VP/ix is a product developed and licensed by Phoenix Technologies, Ltd/INTERACTIVE Systems Corporation. XRemote is a registered trademark of Network Computing Devices, Inc. Oracle is a registered trademark of Oracle Corporation, Redwood City, California. Sun, Sun Microsystems, Java, Java Workshop, and Java Studio are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries, and are used under license. Adobe is a trademark of Adobe Systems Incorporated and is registered in the U.S. Patent and Trademark Office. Reliant is a registered trademark of Siemens Pyramid Information Systems, Inc. (formerly Pyramid Technology Corporation). Real bubble logo, RealNetworks, RealSystem, RealAudio, RealVideo, RealPlayer, Basic Server Plus, RealEncoder, and RealPublisher are trademarks or registered trademarks of RealNetworks, Inc. All other brand and product names are or may be trademarks of, and are used to identify products or services of, their respective owners.

The Santa Cruz Operation, Inc. and SCO Skunkware are not related to, affiliated with or licensed by the famous Lockheed Martin Skunk Works®, the creator of the F-117 Stealth Fighter, SR-71, U-2, VenturestarTM, DarkstarTM, and other pioneering air and spacecraft.

The SCO software that accompanies this publication is commercial computer software and, together with any related documentation, is subject to the restrictions on US Government use as set forth below. If this procurement is for a DOD agency, the following DFAR Restricted Rights Legend applies:

RESTRICTED RIGHTS LEGEND: When licensed to a U.S., State, or Local Government, all Software produced by SCO is commercial computer software as defined in FAR 12.212, and has been developed exclusively at private expense. All technical data, or SCO commercial computer software/documentation is subject to the provisions of FAR 12.211 - "Technical Data", and FAR 12.212 - "Computer Software" respectively, or clauses providing SCO equivalent protections in DFARS or other agency specific regulations. Manufacturer: The Santa Cruz Operation, Inc., 400 Encinal Street, Santa Cruz, CA 95060.

The copyrighted software that accompanies this publication is licensed to the End User only for use in strict accordance with the End User License Agreement, which should be read carefully before commencing use of the software.

Document Version: G2 1.0
23 Apr 1999