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.
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
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:
No additional patches are currently required for RealNetworks products on UnixWare 7 Release 7.1.1.
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
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
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
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.
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:
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.
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''.
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.
To install the package from downloaded files:
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 |
If you are using the Application Installer:
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.
RealServer G2 installs into the directory /usr/lib/rng2server. Previous Release 5 servers installed in /usr/lib/pnserver.
"UX:pjkginstall:ERROR: request script did not complete successfully"This is a harmless error message; you can safely restart the installation process.
Choose automatic or custom installation:
If you have a license to enter, you must do a custom installation. If you don't have a license, there is no more mandatory input, so you can select automatic if you prefer and go to ``After installing the RealNetworks server''.
If you choose to install manually, you will need to provide information for some or all of the following topics (depending on the specific server you are installing):
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.
Port numbers must be unique across all applications on your platform, not just RealNetworks.
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''.
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:
``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:
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.)
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''.
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 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.
Remove RealNetworks servers using the pkgrm(1M) command or the Application Installer
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):
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.
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.
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.
Netscape's network connection was refused by the server: machinename.com:oldportnumberTo work around this problem, enter the new port number in your current session. The new port number will take effect and be recognized the next time you start RealAdministrator.
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.
Under some circumstances, you can improve audio/video reproduction quality by:
©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