About QuickTime Streaming Server 3 and Darwin Streaming Server 3

Contents

What's New With QuickTime Streaming Server 3
What's New With Darwin Streaming Server 3
System Requirements
Installing QuickTime Streaming Server
Installing Darwin Streaming Server (UNIX-based platforms)
Installing Darwin Streaming Server (Windows 2000/NT)
Setting Up QuickTime Streaming Server and Darwin Streaming Server
Troubleshooting
Support


What's New With QuickTime Streaming Server 3

QuickTime Streaming Server 3 provides a number of new product enhancements and addresses several issues. Key enhancements include:

-Skip Protection: Skip Protection protects streams from disruptions in the Internet, resulting in high-quality streamed content in even congested environments.

-Web-based Administration: Configuring QuickTime Streaming Server is easy and straightforward with a new customizable, web-based interface which allows you to monitor and configure your streaming server from anywhere on the Internet, on any platform.

-Strong Authentication: Two different kinds of authentication methods allow customized control access to live streaming or media files on the server.

-Enhanced broadcasting support: QuickTime Streaming Server can now receive broadcast signals via TCP for a more reliable, and higher quality result. It also supports automatic announcement of broadcasts, meaning you no longer have to manipulate SDP files. (Requires third-party support)


What's New With Darwin Streaming Server 3

The Darwin Streaming Server, which is the complete Open Source code for the QuickTime Streaming Server, allows you to stream QuickTime media to clients across the Internet using industry-standard RTP and RTSP protocols. Darwin Streaming Server 3 includes all QuickTime Streaming Server 3 features.

Darwin Streaming Server allows the highest level of customizability and community involvement.

Darwin Streaming Server pre-built binaries and source code is available for the following platforms:

* Mac OS X Server (version 10.0 or later; source only; binary available as QuickTime Streaming Server 3)
* Linux (RedHat 6.2, Intel)
* Solaris 7 (SunOS 5.7, SPARC)
* FreeBSD 3.5 (Intel)
* Windows 2000 Server/NT(Service Pack 5)

It can be ported to other platforms by modifying a handful of platform-specific source files. For more information about the source code and how to port to other platforms, see the files AboutTheSource.html and SourceFAQ.html provided with the Darwin Streaming Server source code.

For more information about the Darwin Streaming Server project and to obtain the Darwin Streaming Server 3 release, see Apple's Open Source Web site at: www.publicsource.apple.com.


System Requirements

QuickTime Streaming Server:

QuickTime Streaming Server is supported on the following software and hardware systems:

System Software: latest version of Mac OS X Server, version 10.0 or later

Hardware: Macintosh Server G4, Power Mac G4, Power Mac G4 Cube, iMac, Macintosh Server G3, or Power Macintosh G3 with at least 128 MB of RAM and a 4GB hard disk (operating system fault tolerance requires a Macintosh Server G4 or a Power Mac G4 released in January 2001 or later).

For high-demand servers running QuickTime Streaming Server, at least 512MB RAM is recommended.

Darwin Streaming Server:

Darwin Streaming Server is currently available on the following platforms:

* Mac OS X Server (Version 10.0 or later; source only; binary available as QuickTime Streaming Server 3)
* Linux (RedHat 6.2, Intel)
* Solaris 7 (SunOS 5.7, SPARC)
* FreeBSD 3.5 (Intel)
* Windows 2000 Server/NT (Service Pack 5)

Both QuickTime Streaming Server and Darwin Streaming Server are compatible with QuickTime 4 or later client software. Digest mode Authentication and Skip Protection require QuickTime 5 or later client software.


Installing QuickTime Streaming Server

To install QuickTime Streaming Server software, follow these
steps:

1. After downloading QuickTime Streaming Server 3, from the Finder, double-click the QTSS_3.0.tar file. Stuffit Expander automatically launches and expands the archive into a QTSS3. pkg file. If you are prompted to select an application to open the QTSS_3.0.tar file, then navigate to the Applications/Utilities/Aladdin/ directory and then select Stuffit Expander to open the .tar file.

Note: Do not unstuff this file on a machine running system software Mac OS 9 or earlier.

2. Double-click the QTSS3.pkg file. This will launch the installer.

3. Click on the "lock" icon to make changes when prompted during installation. You will need to authenticate with the administrator username and password.

4. Follow the onscreen instructions. After you have read and agreed to the license, you can proceed with the installation.

5. During the install, the streamingadminserver.pl application will automatically be launched.


Installing Darwin Streaming Server (Linux, Solaris, FreeBSD)

To install Darwin Streaming Server 3 software, follow these steps on the server computer:

1. IMPORTANT: Installing Darwin Streaming Server will remove older versions of Darwin Streaming Server.


2. Expand the compressed (.gz) tar file and "cd" into one of the following directories, depending on the platform:

DarwinStreamingSrvr3-Linux
DarwinStreamingSrvr3-FreeBSD
DarwinStreamingSrvr3-SunOS


3. Then type:

./Install

4. During the install, the streamingadminserver.pl application will automatically launch. To avoid the need to manually relaunch streamingadminserver.pl following reboots, you may want to configure your server machine to launch it automatically at boot time.


Installing Darwin Streaming Server (Windows 2000/NT)

The Streaming Admin requires Perl 5 (or later) to be running on the server machine. You must install a Perl 5 interpreter in order to use the web-based administration software.

Darwin Streaming Server 3 has been tested only with the nsPerl interpreter, which can be downloaded from the Darwin Streaming Server main page at http://www.apple.com/quicktime/products/qtss/
. Follow all instructions and be sure that the perl binary is located in one of your PATH directories as mentioned in the perl install documentation.

To install Darwin Streaming Server 3 software, follow these steps on the server computer:

When the Server package is unzipped, a folder with Darwin Streaming Server and associated files will be created. Inside this folder is an Install script, named "Install.bat". Double-click this file to install the server and its components on the server machine. The installer also starts up the Streaming Server Admin, so keep the command prompt window open.

The Install script will create the following directory:

c:\Program Files\Darwin Streaming Server\

Inside this directory you will find:

DarwinStreamingServer.exe - Server executable
PlaylistBroadcaster.exe - PlaylistBroadcaster executable
qtpasswd.exe - Command-line utility for generating password files for access control
streamingadminserver.pl - Admin Server that is used for administering the Streaming Server
streamingserver.cfg - Default server configuration file
streamingrelay.cfg - Default relay configuration file
QTSSModules\- Folder containing QTSS API modules
Movies\- Media folder
Logs\- Folder containing access and error logs
AdminHtml\- Folder containing the CGIs and the HTMl files required by the Admin Server
Documentation\ - Documentation folder

The Install script also installs Darwin Streaming Server as a service in the Service Manager. It is possible to start, stop, and check server status from the Service control panel.


Setting Up QuickTime Streaming Server and Darwin Streaming Server

1. To configure and administer your server from either the server machine or a remote client machine, follow these steps.1. From the Mac OS X Server, click on the Streaming Server Admin icon in the dock

OR

From a server machine with QuickTime Streaming Server installed, launch your web browser.

OR

From a remote machine launch Microsoft Internet Explorer, versions 4.5 or later, Netscape Navigator or Netscape Communicator.

2. Enter the URL for your Streaming Server Admin:
http://myserver.com:1220
Replace "myserver.com" with the name of your Streaming Server computer. 1220 is the port number.

3. Follow the onscreen instructions to log into the server as user "streamingadmin". The first time you log in, the "streamingadmin" password will be "default".

Note: Immediately after installing, you should reset the "streamingadmin" password. The "streamingadmin" password may be set from a web browser running on the local server machine using the following URL:

http://127.0.0.1:1220/

Go to the QuickTime Streaming Server Support web site (www.info.apple.com/qtss) and select the Get Help with popup menu to locate the article on SecureSSL.


4. Choose the Settings tab to start configuring your server.

For help on using Streaming Server Admin and setting up your server to stream hinted media, refer to the online Help by selecting the Question Mark button from the Streaming Server Admin.

To configure and administer your server from either the server machine or a remote client machine, follow the steps in above section, Installing & Setting Up QuickTime Streaming Server.


Troubleshooting

QuickTime Streaming
If you have used previous versions of QuickTime Streaming Server, note that some of the file locations have changed with the QuickTime Streaming Server 3 release. You may find it helpful to know these locations for troubleshooting problems.

/usr/local/sbin/QuickTimeStreamingServer - Streaming Server
/usr/local/sbin/streamingadminserver.pl - QTSS Web Admin server
/usr/local/sbin/StreamingServerModules/ - QTSS plugins
/etc/streaming/ - QTSS config files
/Library/QuickTimeStreaming/Movies/ - Media files
/Library/QuickTimeStreaming/Logs/ - Logs
/Library/QuickTimeStreaming/Playlists/ - Web Admin Playlist files

Darwin Streaming Server (Unix)

/usr/local/sbin/QuickTimeStreamingServer - Streaming Server app
/usr/local/sbin/streamingadminserver.pl - QTSS Web Admin server
/usr/local/sbin/StreamingServerModules/ - QTSS plugins
/usr/local/bin/PlaylistBroadcaster - The PlaylistBroadcaster
/usr/local/bin/qtpasswd - Generates password files for access control
/usr/local/bin/SpamPro - RTSP simulated client stress tool
/etc/streaming/ - QTSS config files
/usr/local/Movies/ - Media files
/var/streaming/ - readme.html & usermanual.pdf files
/var/streaming/logs - Logs
/var/streaming/playlists - Web Admin Playlist files

Darwin Streaming Server (Windows)

C:\Program Files\Darwin Streaming Server\
C:\Program Files\Darwin Streaming Server\Movies
C:\Program Files\Darwin Streaming Server\Logs
C:\Program Files\Darwin Streaming Server\QTSSModules
C:\Program Files\Darwin Streaming Server\AdminHtml

Support

QuickTime Streaming Server:

Late Breaking News can be found in the QTSS Help.

Web Sites

Check these Web sites for tips, solutions to problems, or any update that may become available after the release of the software:

QuickTime Streaming Server Web site: www.apple.com/quicktime/servers
Apple Support Web site: www.apple.com/support
QuickTime Streaming Server Support Web site: http://www.info.apple.com/qtss

Go to the QuickTime Streaming Server Support web site (www.info.apple.com/qtss) and select the Get Help with popup menu to locate the article on QuickTime Proxy Server.


Public Mailing Lists

Through the Apple public mailing lists you can share experiences, questions, and comments with others who use the software. Apple employees may monitor the list, but Apple does not guarantee that questions sent to this list will be answered. For more information about joining the mailing lists, see the Apple mailing lists Web site at www.lists.apple.com.

For QuickTime Streaming Server and Darwin Streaming Server administration, join the Streaming Server mailing list, streaming-server-users.

If you are interested in plugin API or Open Source development, join the Streaming Server developer public mailing list, streaming-server-developers.

The Darwin Streaming Server release is not supported by Apple computer.

© 2001 Apple Computer, Inc. All rights reserved. Apple, Mac, Macintosh, PowerBook, Power Macintosh, and QuickTime are trademarks of Apple Computer, Inc., registered in the United States and other countries. iBook, iMac, and Power Mac are trademarks of Apple Computer, Inc. All other product names are trademarks or registered trademarks of their respective holders.