© 1999 The Santa Cruz Operation, Inc. All rights reserved.
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.
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).
The Optional Services CD contains the following RealNetworks products that are licensed with all networked versions of the SCO operating system:
Other RealNetworks products on the CD available for separate licensing are:
See also:
The RealNetworks server installs into the directory /usr/lib/rng2server.
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.
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.
Before installing the RealNetworks server, make sure the following required software is installed on your system:
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.
LICENSE
If you have an upgrade or separate license, enter the path to the license file. If you don't have a separate license, press <Enter> to accept the default license for Basic Server Plus, which is included with your operating system license -- see ``RealNetworks licenses''. You can add other licenses at any time after installation -- see ``Licensing the RealNetworks server''.
USERNAME and PASSWORD
Enter an administrative username and password
or
press <Enter> to accept the default
of admin.
PNA, RTSP, HTTP PORTS
If you change your server's port numbers from the defaults, you must include port numbers in the URLs that link to your content. Failure to include non-default port numbers might result in Players receiving streams via HTTP or not receiving them at all.
PNA PORT
Enter a port on which RealServer will listen for PNA Connections (begin with pnm://) or press <Enter> to accept the default of 7070.
RTSP PORT
Enter a port on which RealServer will listen for RTSP Connections (begin with rtsp://) or press <Enter> to accept the default of 554.
HTTP PORT
Enter a port on which RealServer will listen for HTTP Connections (begin with http://) or press <Enter> to accept the default of 8080.
REALADMINISTRATOR PORT
Enter a port on which RealServer will listen for RealAdministrator requests. The default has been initialized to a random value for security. Verify that the pre-assigned port will not interfere with ports already in use on your system. Press <Enter> to accept the default or change it if necessary.
ENABLE SERVER
Answer y to have the server run automatically upon system reboot.
If you answer n, you can enable the server at any time after installation -- see ``Enabling and disabling the RealNetworks server''.
START SERVER
Answer y to start the server immediately after installation is complete.
If you answer n, you can start the server at any time after installation -- see ``Starting and stopping the RealNetworks server''.
START REALADMINISTRATOR
Answer y to start the administrative utility after installation is complete.
If you answer n, you can start RealAdministrator at any time after installation -- see ``Testing the RealNetworks server''.
When the installation is complete, see ``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:
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:
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
If the server wasn't started as part of the installation, you can manually start the server at any time:
To manually stop the server from running,
enter:
/etc/realserver stop
To find out if the server is running,
enter:
/etc/realserver query
Make sure the server has been started.
To test that RealServer is installed properly:
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.)
See also:
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.
See also:
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.
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):
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.
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.
See also:
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:
If you prefer to read printed documentation, you can download the PostScript® from the SCO web site to print the RealServer Administration Guide:
If you don't already have the gunzip utility:
Substitute the name of a PostScript printer for printerName and, if necessary depending on your printer model script, change the -opost option.
On SCO OpenServer Release 5 systems, RealAdministrator displays ``sco_sv3'' as the operating system release number. Use the command uname -X to display the correct operating system release number.
On UnixWare 7 systems, RealAdministrator displays ``unixware 5'' as the operating system release number. Use the command uname -v to display the correct operating system release number.
Whenever the server is started,
the following message appears in the server's error log file:
Scalable Multicast: Could not find Config entry -- Initialization failed.
This message is incorrect and should be ignored; the server does start successfully.
By default, RealServer uses 64MB of RAM. When trying to execute a new program, you will see this error message if swap space is not available.
You can either
add more swap space to your system
using the swap -a command
or
you can limit the amount of memory RealServer uses
by starting RealServer with the -m parameter:
rmserver rmserver.cfg -m 32
The number after -m can be any amount of memory in megabytes, 32 or greater. Each megabyte of RealServer memory accommodates 3 - 4 simultaneous connected users. To allow 200 users to connect, specify 50 megabytes of memory instead of 32.
For more information, see /usr/lib/rng2server/RealAdministrator/Docs/readme.htm.
©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