Oracle Video Client Software Guide Release 2.1.8 A42334_4

Library Product Contents Index

Chapter 2
Installing the Oracle Video Client: Windows 95

The Oracle Video Client software allows you to develop interactive, video-based multimedia applications for such uses as computer-based training (CBT), interactive kiosks, and corporate repositories that receive and control networked Motion Picture Experts Groups (MPEG) streams. The Oracle Video Custom Control software allow multimedia applications to start, stop, and seek MPEG video streams from the Oracle Video Server. The Oracle Video Server allows many different clients to concurrently access MPEG video streams.

Note that while the Oracle Video Client can work with many other Oracle products (such as Oracle Power Objects and Oracle Forms), not all those products are currently supported for Windows 95. The product's release notes will describe the platforms it is supported on.

This chapter explains how to install and configure the Oracle Video Client software for Microsoft Windows 95. (If you are installing on a Windows for Workgroups client, see Chapter 1, Installing the Oracle Video Client: Windows for Workgroups.) It also explains how to test the software with local and networked MPEG streams. This chapter contains these sections:

• Oracle Video Client Overview
• Before You Install
• Installation
• The Oracle Installer
• Testing the Installation

Oracle Video Client Overview

The Oracle Video Client software includes:

• A web browser plug-in that enables web pages to access MPEG videos from the Oracle Video Server. The Oracle Video Plug-in is compatible with Internet browsers that support Netscape plug-ins.
• An Oracle Video Custom Control, an OLE2 Custom Extension (OCX) that enables 32-bit OLE2 applications to access MPEG videos locally and from the Oracle Video Server. Currently the Oracle Video Custom Control supports the Windows 95 releases of:
• Oracle Power Objects v2.0, 2.1
• Microsoft Visual Basic v4.0, 5.0
• Oracle Forms v4.5.7, 4.5.8

The software also includes:

• Sample applications (with source code) that demonstrate how applications can work with the Oracle Video Client and the Oracle database. Appendix A in this manual describes the sample code in more detail.

System Requirements

Before installing the Oracle Video Client software, ensure that the client PC meets these minimum hardware and software requirements.

• Intel based-PC with minimum processor requirements:
• 80486/66 for hardware MPEG decoding
• Pentium 90 for software MPEG decoding
• 16 MB RAM (minimum)
• Sufficient disk space for your development environment. Oracle Video Client software requires 20MB (including documentation)
• PCI (recommended) or EISA bus
• Ethernet LAN card for PCI (recommended) or EISA bus

You may also use SMC Elite Ultra 16 ISA cards within a PCI/ISA client machine.

• MPEG-1 decoder (see MPEG-1 Hardware and Software Decoder Details for more information about hardware and software decoders)
• Graphics accelerator with 640x480 resolution and 256 colors
• 8-bit or 16-bit audio output
• Local CD-ROM drive or access to a networked CD-ROM drive
• VGA/SVGA monitor
• Windows 95
• A Windows VxD-based TCP/IP stack (with UDP). You must use a 32-bit network interface card driver.

MPEG-1 Hardware and Software Decoder Details

The Oracle Video Client provides support for two MPEG-1 decoding solutions:

• Sigma Designs RealMagic Maxima, Pro, and Ultra MPEG-1 Accelerator Cards. The software for these cards is available by FTP from http://www.SigmaDesigns.com.
• CompCore Multimedia, Inc. software MPEG decoder v2.1. For more information about this decoder, contact CompCore at http://www.CompCore.com. This decoder is included on the Oracle Video Client CD. To install the Compcore library, execute the command D:\compcore\setup.exe from the CD.

MPEG-1 decoding on the client is best performed by a hardware accelerator card that is capable of providing full-screen, full-motion digital video at 30 frames per second (fps) with CD-quality audio. Software decoding, even on high-end CPUs (such as a Pentium 133) will most likely have reduced performance, perhaps as low as 15 fps, with lower motion quality. Oracle does not recommend software MPEG-1 decoding for production applications. Instead, software decoding is best used for system testing or application development.

Before You Install

Before you install the Oracle Video Client, make sure you complete the following:

• Review the accompanying Oracle Video Client Software Release Notes.
• Make sure Windows 95 is properly installed on the client PC.
• Make sure you have the Oracle Media Net address (the IP address and UDP port number of the Oracle Video Server). You can get this from your System Administrator.)
• Make sure the Oracle Video Server is correctly installed and running on the server machine.(See the Oracle Video Server Installation and Administrator Guides for your server platform, or call your system administrator for more information.)
• Make sure the client PC CD-ROM drive that you will use for installation is working correctly.

Using the CD-ROM Drive

Any CD-ROM drive that can be attached as a logical drive (for example, the D: drive) can be used to install the Oracle Video Client software. Refer to the CD-ROM drive documentation for instructions on its use.

Drive Letter

In general, the instructions in this chapter assume that your CD-ROM drive is recognized as the logical drive D. If the PC CD-ROM drive letter differs, substitute the correct logical letter.

Installation

This section explains how to install the Oracle Video Client software on a client PC.

How the Installation Process Works

The installation process uses the Oracle Installer, a Windows 95 application that is supplied on the Oracle Video Client CD-ROM.

Set up the Oracle Installer in the Windows 95 Start Menu by starting the Oracle Installer application from the CD-ROM, as described in the section "Running the Oracle Installer." After you start the Oracle Installer, it performs the following tasks:

• Creates the Oracle Home directory and subdirectories. You can select the default directory (recommended, particularly if you have installed other Oracle products), or you can specify your own custom path.

Note

If you have previously installed other Oracle Windows 95 products, the Oracle Installer does not re-create directories.

• Copies Oracle Video Client files to the subdirectories of the Oracle Home directory. The default Oracle Home directory is C:\orawin95 for Windows 95 clients.
• Creates the Oracle Video Client for Windows 95 Program Group with icons for the OVS Player (a movie player) and Windows Notepad icon for editing the oravideo.ini configuration file and an icon for the Oracle Video Client Configuration Utility.

The Oracle Installer

The Oracle Installer provides a common interface for the installation of all Oracle products. A complete installation of the Oracle Video Client requires three components:

• Oracle Video Client 2.1.8 - the software that requests and displays the streaming MPEG video.
• Oracle Media Net 3.0 - a software abstraction layer that provides communication among components of the Oracle Video Server and the Oracle Video Client.
• Oracle Installer - used as part of the Oracle Video Client Configuration Utility.

Running the Oracle Installer

Run the Oracle Installer by following the steps in this section.

Note

If you have previously installed another Oracle product for Windows 95, the Oracle Installer may already be installed on the hard disk. However, you should follow these steps to ensure that you have the latest Installer software available.

To begin the installation process:

1. Start Windows 95. No other applications should be running.
2. Insert the Oracle Video Client CD-ROM installation disk in the CD-ROM drive.
3. Choose Run... from the Start menu.
4. Type D:\win95\install\orainst where D stands for the logical drive letter of the CD-ROM drive (Figure 2-1). The installation screen appears.

Figure 2-1: Running the Oracle Installer from a CD



5. If the language has not been established by a previous Oracle Software installation, the Language dialog windows appears (Figure 2-2). Choose the language to use when working with the Oracle Video Client software. If you select a language that is not supported by the Oracle Video Client, the language defaults to English. Click OK.

Figure 2-2: The Language dialog window



6. Enter the name of the Company to which the product is registered and the location of the Oracle home directory (Figure 2-3). Modify the location if desired. Click OK.

Figure 2-3: The Installation Settings Dialog Window

Note

The Oracle Installer's default location for all Oracle Products is the c:\orawin95 directory. Choosing a different directory can disable currently installed Oracle products. Products installed in the previously active Oracle Home directory will no longer be available until you switch back to the that directory.

The Software Asset Manager dialog window appears. This dialog window itemizes installed Oracle software on the right side, and installable products on the left side. Choose the products to install by clicking on them. To make multiple selections, click and hold the primary mouse button while dragging the mouse.

For the Oracle Video Client to operate properly, these two items must be installed:

• Oracle Video Client
• Oracle Media Net

Choosing Oracle Video Client automatically installs Oracle Media Net and Oracle Installer.

Options

Before you continue with the installation, click on the Options button and choose the level of installation reporting (Figure 2-4). The reports are written to the orainst.log file which is stored in the C:\orawin95\orainst directory.

Figure 2-4: The Installer Options dialog window

The Options provided in this dialog window set the level of confirmation prompts and information messages you can receive during the installation process.

• Display Before Installing - displays an additional confirmation dialog window before installing products. If this checkbox is unchecked, the installer begins installing products on your hard disk when you click Install.
• Display Before Removing - displays an additional confirmation dialog window before removing any items. If this option is not selected, items will be removed immediately upon clicking OK.
• Display Additional Messages or Prompts - displays an additional confirmation dialog window before committing changes required by normal operating conditions. Notifications and questions regarding unusual changes or conditions are always posted, regardless of the setting for this option.
• Log Installer Action - writes all of the installer's actions to a log file located in the C:\orawin95\orainst directory.
• Remember Location of Available Products - remembers and scans the "remembered" directory for available products. Deselect this option if you do not want the Installer to remember the last available products directory next time you run the Oracle Installer.

When you are ready to continue the installation, click Install. Click Yes on the Confirmation dialog, unless you have disabled it, to confirm that you want to install the selected products.

Installing the Oracle Video Client

After you have confirmed that you wish to install the Oracle Video Client software, the Choose Directory dialog window displays the subdirectory into which the Oracle Video Client software will be installed. The Installer will create the vc21 subdirectory underneath the C:\orawin95 directory (Figure 2-5).

Figure 2-5: The Choose Directory dialog window

.

1. Click OK to confirm your Oracle Video Client home directory. The MPEG Choice dialog window appears.

2. The MPEG Choice dialog asks which MPEG decoder you are using:
• Sigma Designs RealMagic Maxima, Pro, or Ultra hardware MPEG decoder
• CompCore SoftPeg software MPEG decoder

Choose only one. Support files for your choice are copied into the installation directory, and the oravideo.ini file is created to reflect the MPEG decoder you choose. You can choose support for one of the decoders now and install the actual MPEG decoder at a later time.

3. The Oracle Video Client support dialog window asks you to select which application development tools you will be using with the Oracle Video Client software.

The list includes support for:
• Oracle Forms v4.5.7
• Oracle Power Objects v2.0, 2.1
• Microsoft Visual Basic 4.0
• Oracle Video Web Plug-in

You use the Oracle Video Client software with these application development tools to develop applications that use MPEG video from the Oracle Video Server. Choose the application development tools that you will use. The installer copies files for the tools you choose onto the hard disk. If you choose support for Visual Basic, the Installer automatically registers the Oracle Video Custom Control with the Windows 95 registry.

If you choose the Oracle Video Web Plug-in, the Installer prompts you for the location of the directory in which to put the plug-in. The default is C:\program files\netscape\navigator\program\plugins.

Note

If the C:\program files\netscape\navigator\program\plugins directory does not exist on your machine, a dialog box prompts you for the name of the appropriate Netscape plug-in directory. If necessary, the Installer updates the Windows 95 system files on your machine and installs Microsoft Re-Distributable Support files. These enable your machine to run applications that take advantage of OLE2 features.

1. The Text Entry/IP address window begins the process of installing Oracle Media Net. The Oracle Video Server IP address and Oracle Video Server UDP port number define the Oracle Media Net Address. Oracle Media Net is the component responsible for establishing communication among the components of the Oracle Video Server and the Oracle Video Client.

The Text Entry/IP address window asks for the IP address of the Oracle Video Server. Enter the IP address and click OK.

2. The Text Entry/UDP Port number dialog window appears next. Add the UDP port number. Click OK.

(Refer to Chapter 3 of the Oracle Video Server Administrator's Guide for your system or contact your System Administrator for more information on Oracle Media Net addresses, IP addresses and UDP port numbers.)

3. An information dialog window appears confirming the Oracle Media Net address. Confirm that the IP address and UDP port number are correct and click OK.

Once the installation completes, you will see a Windows 95 Program Group named "Oracle Video Client for Windows 95" (Figure 2-6); that group will contain the OVS Player icon, Notepad icon for the oravideo.ini file, and the Video Client Configuration Utility.

Figure 2-6: The Oracle Video Client program group

Testing the Installation

The Oracle Installer makes the necessary modifications to the Windows 95 registry. If necessary, use the Oracle Video Client configuration utility to alter the Media Net Address, Media Net Trace Option, and the Media Net Trace filename. This utility is provided as part of the Oracle Video Client installation.

Verify the Installation

Before the Oracle Video Client installation can be verified, one of the two MPEG decoding solutions must installed:

• Sigma Designs RealMagic hardware decoder
• CompCore SoftPeg software decoder

The Sigma Designs decoder installs a media player to view MPEG files. The media player can be found as an icon in the Windows 95 Program Group created by the installation of the decoder. Use the media player to test that the client software can decode local MPEG files from the CD-ROM or local hard disk.

The CompCore decoder does not come with a video player. However, you may use the OVS Player to test your installation.

Test streaming a local MPEG file

After you have tested using the media player installed with your MPEG solution, test using OVS Player, which is installed with the Oracle Video Client software. OVS Player can be found as an icon in the Windows 95 Program Group created by the installation of the Oracle Video Client.

To use OVS Player, perform the following steps:

1. Select OVS Player from the Oracle Video Client entry on the Start Menu.

2. Click on the Local button to view a list of files on the hard disk or CD-ROM.

Note: You may have to transfer an MPEG file to the client PC in order to verify that OVS Player works with the installed decoder. See your system administrator for assistance in transferring files.

3. Locate a video file, select it, and click OK.

4. Choose Play from the Video menu to view the video.

If local MPEG files do not play, see your system administrator for assistance.

After you have successfully viewed video from a local file, you can test using a network MPEG stream. Use OVS Player to test viewing MPEG streams from an Oracle Video Server over a network.

Test streaming a network MPEG file

Before testing streamed MPEG over the network, you should verify:

• that the network is operational
• that the Oracle Video Server is running

Network Verification

Use the Ping utility that accompanies the TCP/IP stack software installed on your system to verify that the network is capable of delivering video. This example shows a generic ping utility.

1. Start the Ping utility accompanying the TCP/IP stack installed on the client PC.
2. Enter the IP address, (or IP address alias) of the Oracle Video Server.
3. Set your ping utility to use 8K (8192 byte) packets. Check the ping utility's Options settings for this parameter. Check with your system administrator for more information about pinging the Oracle Video Server.
4. Ping the server using 8K (8192 bytes) packets.

Note:

If the network is not capable of using 8K packets, you will be notified that the data length is too long for your network's MTU (maximum transfer unit). If this happens, call your network administrator to resolve this problem. Video will not work with packet sizes smaller than 8K. You can still query the Oracle Video Server for a list of videos, but you cannot play them.

Test streaming a network MPEG file

Verifying the network stream is similar to verifying the local stream, except that the MPEG stream comes from the Oracle Video Server over a network instead of from an MPEG file on a local hard disk.

Use the following procedure to test viewing MPEG streams from an Oracle Video Server:

1. Choose OVS Player from the Start menu.
2. Click Server. A list of files located in the Media Data Store of the Oracle Video Server is displayed. The files displayed are "tag" files, with the extension .mpi, that contain information about the video MPEG content files, such as encoding rate and time length of the video.

Note:

If nothing appears in the Network list, contact your system administrator.

1. Select one of the MPEG tag files and click OK.

   When the OVS Player loads a video it first "prepares" it. Preparing it means linking the video pump on the Oracle Video Server with the Oracle Media Net address of the client. When the preparation is successful, the movie controls are returned to you and you can play the video.

2. Choose Play from the Video menu to view the video.

Prev Next

Copyright © 1997 Oracle Corporation. All Rights Reserved.

Library Product Contents Index