RealNetworks Products for UnixWare Release and Installation Notes

About RealNetworks products

Installing RealNetworks products

RealNetworks documentation

Known limitations
About RealNetworks products

About RealNetworks products

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

RealServer(TM) G2 uses a client/server architecture to support large numbers of concurrent users. The server delivers encoded media over a network to RealPlayer(TM), 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.

The RealAdministrator is included with RealServer, 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).

For additional and more up-to-date information about RealNetworks, Inc. products, see their web site: http://www.real.com.

What's new in this release

RealServer G2 includes the following new features in this release:

See "Chapter 1: What's New in RealServer G2?" in the RealServer Administration Guide for details about these features.

The RealPlayer Release 5 and RealAudio Encoder Release 3.1 have not been updated for this release. For information concerning updates to these products on SCO platforms, see the SCO UnixWare Optional Services site (http://www.sco.com/unixware/optional_services).

RealNetworks' Year 2000 Readiness Statement is available from their website:

http://www.real.com/company/y2k.html

System requirements

If you are installing RealNetworks products on UnixWare 7 releases earlier than Release 7.1.1, you must install one of the following Support Level Supplements (SLS) to ensure correct functioning:

on UnixWare 7 Release 7.0.1
ptf7051d (UnixWare 7.0.1 libc Patch)

on UnixWare 7 Release 7.1.0
ptf7401c (In-Kernel Sockets Supplement)
You can obtain these from the SCO SLS download site, ftp://ftp.sco.com/SLS/.

No additional patches are currently required for RealNetworks products on UnixWare 7 Release 7.1.1.

RealServer G2 requirements

Software: UnixWare 7 Release 7.0.1 or higher
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


NOTE: You should configure swap space equal to your RAM size.

RealPlayer Release 5 requirements

Software: UnixWare 7 Release 7.0.1 or higher
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 the SCO Open License Software Supplement site:

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


RealAudio Encoder Release 3.1 requirements

Software: UnixWare 7 Release 7.0.1 or higher
RAM: 32MB (64MB recommended)
Disk space: 4MB free disk space
Sound card: 16-bit sound card with Open Sound System sound driver

RealNetworks licenses

The RealNetworks RealServer G2 product is licensed with all networked versions of the UnixWare 7 operating system for 10 streams OR seats. It is provided for free use in accordance with the product license agreement and does not require an additional license.

The RealPlayer and RealAudio Encoder products do not require licensing.


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).

Additional licenses can be purchased to increase connections and functionality:

To purchase additional licenses, call RealNetworks at 800-444-8011, or see their web site:

http://www.real.com

See also:

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.



Installing RealNetworks products

Installing RealNetworks products

Before installing RealNetworks products, make sure the appropriate required software is installed on your system:

TCP/IP
required for all RealNetworks products

X graphical environment with browser


NOTE: If you are upgrading RealServer from Release 5, see ``Removing RealServer G2'' before installing the G2 server.

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''.


General installation procedures

Follow these procedures to install RealNetworks products using pkgadd or Application Installer. If you are installing or upgrading RealServer, you should be familiar with the material in ``RealServer installation procedures'' before proceeding.


NOTE: These packages can also be installed as part of an overall system upgrade using the new Upgrade Wizard. See the Installation Roadmap you received with your operating system media for more information.

pkgadd procedures

To install the package from downloaded files:

  1. Log in as root.

  2. Download the package to an installation directory; for example, /tmp.

  3. Use the pkgadd(1M) command to install it by entering:

    pkgadd -d /tmp/package_name

To install the package from media distribution:

  1. Log in as root.

  2. Insert the CD-ROM in the drive if you have not already done so.

  3. You can use the pkgadd(1M) command to install with the distribution CD mounted or unmounted (you may have mounted the CD to read these Release Notes from the distribution media):

These packages are currently provided on the UnixWare 7 Release 7.1.1 Optional Services distribution media:

  RealServer RealPlayer Encoder
complete set (software and documentation) RNg2serv RNplayer5 RNenc31
software only rng2serv rnplayer rnenc31
documentation only rng2servD rnplayerD rnenc31D

                             |  RealServer   RealPlayer   Encoder
 ----------------------------|-------------------------------------
 complete set                |  RNg2serv     RNplayer5    RNenc31
 (software and documentation)|
 software only               |  rng2serv     rnplayer     rnenc31
 documentation only          |  rng2servD    rnplayerD    rnenc31D

Application Installer procedures

If you are using the Application Installer:

  1. Start the Application Installer by clicking on the Application Installer icon in the SCOadmin folder on the UnixWare 7 desktop.

  2. Select the correct device from which to install (for example, CD-ROM_1).

  3. Click on Update View to see the products that are available to install.

  4. Select the product set and click on Install.

    Depending on the product you are installing, you may need to respond to some additional prompts; for RealServer installation prompts, see ``RealServer installation prompts''. Answer these prompts as appropriate for your installation.

    Repeat this step for each product you want to install.

  5. When you have installed all desired products, select Actions->Exit.

RealServer installation procedures

RealServer G2 installs into the directory /usr/lib/rng2server. Previous Release 5 servers installed in /usr/lib/pnserver.


NOTE: You might receive the following error message about the G2 Server installation not completing if you abort out of the installation, of if you install a G2 Server on top of an existing G2 Server installation:
   "UX:pjkginstall:ERROR: request script did not complete successfully"
This is a harmless error message; you can safely restart the installation process.

RealServer installation prompts

Choose automatic or custom installation:

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

``Enabling'' means that the server will be restarted automatically upon system reboot. 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

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''.

    In particular, you may encounter this problem on a UnixWare 7 Release 7.1.0 system when the server is running. If so, you must install ptf7401c (In-Kernel Sockets Supplement) as described in ``System requirements''.


  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 from the:

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 RealServer G2

Remove RealNetworks servers using the pkgrm(1M) command or the Application Installer


WARNING: 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 Release 5, do so before beginning the RealServer G2 installation, but first preserve your configuration and content (if desired):

  1. If you've done any customized server configuration, save aside the the file /usr/lib/pnserver/server.cfg (for RealServer 5.0 or Basic Server Plus 5.0). The format of this file is not compatible with the comparable RealServer G2 server configuration file, /usr/lib/rng2server/rmserver.cfg, but it may be useful for reconfiguration, particularly of port numbers.

  2. If you've modified or added any content files, save aside the directory /usr/lib/pnserver/content (for RealServer 5.0 or Basic Server Plus 5.0). Files from this directory can be copied directly into the comparable RealServer G2 directory, /usr/lib/rng2server/Content

  3. Remove the existing server product using the pkgrm(1M) command or the Application Installer, selecting the product to be removed from the list of installed software.

If you do not want to remove an existing RealServer Release, 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 RealServer Release 5. However, although both servers can be installed on a system, you cannot run both servers at the same time.

If you want to reinstall RealServer G2, save aside any existing RealServer G2 server configuration file (/usr/lib/rng2server/rmserver.cfg) and contents files in the /usr/lib/rng2server/Content directory. These files can be copied back to their original locations after removing the original RealServer G2 using pkgrm(1M) or the Application Installer.



RealNetworks documentation

RealNetworks documentation

You can view RealNetworks documentation using:

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.

Accessing the RealEncoder manual page

The RealEncoder package includes the rmenc(1) manual page, which is available using the man(1) command. To access this manual page, you must first edit /etc/default/man and ensure that /usr/local/man is in the MANPATH setting.

The rmenc(1) manual page is not available using SCOhelp.



Known limitations

Known limitations

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

RealServer G2 limitations

RealPlayer Release 5 limitations



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

©1998 RealNetworks, Inc.

This publication is protected under copyright laws and international treaties.

©1992-1994 AT&T Global Information Solutions Company; ©1987-1989 Computer Associates, Inc.; ©1987 Convergent Technologies, Inc.; ©1989 Digital Equipment Corporation; ©1987-1989 Hewlett-Packard Company; ©1994-1996 Netscape Communications Corporation; ©1993-1994 Platinum Technologies; ©1988 Massachusetts Institute of Technology; ©1985-1989 Metagraphics Software Corporation; ©1980-1989 Microsoft Corporation; ©1989 Open Software Foundation, Inc.; ©1993-1994 Programmed Logic Corporation; ©1994-1997 Sun Microsystems, Inc.; ©1988 UNIX Systems Laboratories, Inc.; ©1997 VERITAS Software Corporation.

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 Vision 97, SCO VisionFS, SCO Visual Tcl, Skunkware, Tarantella, 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 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 of Netscape Communications Corporation. NFS was developed by Legent Corporation (formerly Lachman Associates, Inc.) 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 Legent Corporation (formerly Lachman Associates, Inc.) 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. Java is a trademark of Sun Microsystems, Inc. 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). RealAudio and RealVideo are registered trademarks of RealNetworks, Inc. The Real logo, RealServer, RealPlayer, RealEncoder, RealPublisher, RealSystem, Basic Server Plus, and RealNetworks are 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. reserves the right to change or modify any of the product or service specifications or features described herein without notice. This document is for information only. SCO makes no express or implied representations or warranties in this document.

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, Venturestar(TM), Darkstar(TM), 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, California 95060.

The copyrighted software that accompanies this manual is licensed to the End User only for use in strict accordance with the two End User License Agreements. All such Agreements should be read carefully before commencing use of the software.

Document Version: G2 1.0c
03 September 1999